#ruuvi #ruuvitag #telegraf

app ruuvitag-listener

Print RuuviTag measurements in Telegraf compatible format

10 releases

0.5.4 Jan 30, 2021
0.5.3 Nov 13, 2020
0.5.1 May 23, 2020
0.4.1 Feb 29, 2020
0.1.0 Dec 16, 2018

#98 in Hardware support

Download history 11/week @ 2021-08-15 2/week @ 2021-08-29 1/week @ 2021-09-05 10/week @ 2021-09-26 10/week @ 2021-10-10 1/week @ 2021-10-17 2/week @ 2021-10-24 6/week @ 2021-10-31 12/week @ 2021-11-07 7/week @ 2021-11-14 13/week @ 2021-11-21

51 downloads per month

MIT license

17KB
401 lines

RuuviTag Listener

A command-line client to listen to RuuviTag Bluetooth LE sensor measurements and output as InfluxDB line protocol. Binary downloads for x86 and ARM are available for releases.

The output could be e.g. piped to Telegraf Socket Listener with netcat. For an example setup, check out examples/telegraf.

Requirements

  • 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`

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

Dependencies

~12MB
~226K SLoC

`