Skip to content

Listen to RuuviTag measurements and output in Telegraf compatible format

License

Notifications You must be signed in to change notification settings

mjknoxie/ruuvitag-listener

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

RuuviTag Listener

A command-line client to listen to RuuviTag sensor measurements over Bluetooth LE and output as InfluxDB line protocol.

The output can be used in e.g. Telegraf Execd Input. For an example setup, check out examples/telegraf.

Requirements

  • RuuviTag Bluetooth sensor
  • Linux with BlueZ Bluetooth stack

Installation

Download binary from releases to your $PATH. Then, set file capabilities to allow access to Bluetooth with

sudo setcap 'cap_net_raw,cap_net_admin+eip' `which ruuvitag-listener`

Alternatively, install ruuvitag-listener using any of the following package managers:

Distribution Repository Instructions
Any Crates.io cargo install ruuvitag-listener --locked (note: does not run setcap)
Arch Linux AUR yay -S ruuvitag-listener or yay -S ruuvitag-listener-bin

Usage

ruuvitag-listener

Running ruuvitag-listener will output measurements to STDOUT until interrupted.

Example output:

ruuvi_measurement,name=F7:2A:60:0D:6E:1E acceleration_x=-0.055,acceleration_y=-0.032,acceleration_z=0.998,battery_potential=3.007,humidity=19.5,pressure=101.481,temperature=19.63 1546681652675044272
ruuvi_measurement,name=F1:FC:AA:80:4E:59 acceleration_x=0.005,acceleration_y=0.015,acceleration_z=1.036,battery_potential=2.989,humidity=17.5,pressure=101.536,temperature=21.97 1546681653451240083
ruuvi_measurement,name=F1:FC:AA:80:4E:59 acceleration_x=0.002,acceleration_y=0.017,acceleration_z=1.032,battery_potential=2.977,humidity=17.5,pressure=101.536,temperature=21.97 1546681654458923308
ruuvi_measurement,name=F7:2A:60:0D:6E:1E acceleration_x=-0.052,acceleration_y=-0.032,acceleration_z=1,battery_potential=3.013,humidity=19.5,pressure=101.481,temperature=19.63 1546681655691300729

You can also define the InfluxDB measurement name or aliases using command line arguments. For example

ruuvitag-listener --influxdb-measurement=ruuvi --alias F1:FC:AA:80:4E:59=Indoor --alias F7:2A:60:0D:6E:1E=Outdoor
ruuvi,name=Indoor acceleration_x=0,acceleration_y=0.017,acceleration_z=1.027,battery_potential=2.989,humidity=17.5,pressure=101.54,temperature=21.97 1546681957964524841
ruuvi,name=Outdoor acceleration_x=-0.054,acceleration_y=-0.032,acceleration_z=1.005,battery_potential=3.013,humidity=83.5,pressure=101.487,temperature=-5.63 1546681958085455294

All options can be listed with ruuvitag-listener --help.

Development

Use cargo to build the project to target/debug directory:

cargo build

Tests can be run with

cargo test

License

MIT

About

Listen to RuuviTag measurements and output in Telegraf compatible format

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Rust 100.0%