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

techrick / ruuvitag-listener Goto Github PK