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.
- RuuviTag Bluetooth sensor
- Linux with BlueZ Bluetooth stack
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 |
ruuvitag-listenerRunning 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=Outdoorruuvi,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.
Use cargo to build the project to target/debug directory:
cargo buildTests can be run with
cargo testMIT