Adds support for Ruuvi Bluetooth Sensors
Ruuvi is an advanced open-source sensor platform designed for business, developers, makers, students, and home automation. See https://ruuvi.com/ for more information.
Compact environmental sensor powered by CR2477 battery.
Supported formats:
- Format 3 (RAWv1) - Bluetooth 4
- Format 5 (RAWv2) - Bluetooth 4
Capabilities:
- Temperature
- Humidity
- Pressure
- Acceleration
- Battery level
- RSSI (signal strength)
- Movement detection (RAWv2 only)
- Entering/leaving range triggers
Air quality monitor powered by wall adapter.
Supported formats:
- Format 6 - Bluetooth 4
- Format E1 (Extended) - Bluetooth 5
Capabilities:
- Temperature
- Humidity
- Pressure
- Air quality: CO2, PM1.0, PM2.5, PM4.0, PM10, NOx index, TVOC index, AQI
- Luminosity
- RSSI (signal strength)
- Entering/leaving range triggers
Note: No battery capability (powered device)
Polling interval (time between scans) can be configured in app settings.
Presence detection uses a configurable TTL system - number of scan attempts can be set per device in device settings.
This apps allows integration of RuuviTag Gateway in Homey. You need first to activate API-key (bearer token) in Ruuvi Gateway ; see https://docs.ruuvi.com/gw-examples/polling-mode for more information. After that Homey will poll the latest data with timestamps from the gateway. Gateway IP adress should be auto-detected ; you need to enter the bearer token in the next screen, and then choose Ruuvitag to add in Homey.
The driver offers the same capabilities as the Ruuvitag driver. Polling interval can be setup for each device independently.
If you want to use several Ruuvi gateway, you should plug only one at a time during setup.
The app also allows Homey to act as a Ruuvi Station gateway.
- Before v0.2 : You have to allow public access in the app settings (default is private) ;
- In v0.2 : gateway is public by default ; due to changes in SDKv3, access is public and cannot be changed.
Then in Ruuvi Station, in gateway settings, use :
- http://<your_ip>/api/app/com.thomashoussin.ruuvitag for local access only
- https://.connect.athom.com/api/app/com.thomashoussin.ruuvitag (cloudId can be found on http://developer.athom.com/tools/system)
Device must have been locally added in Homey ; after that, data received through API updates Ruuvitag device (if device is unknown, data is discarded). Presence is not modified when receiving data through gateway.
Feel free to donate to support the project !
- Fix readSequenceNumber for format 6 (readUInt8BE → readUInt8)
- Add comprehensive test suite with Vitest
- Add CI workflow for automated testing
- Update CodeQL actions to v4
- Fix deprecated BLE scan duration parameter
- Fix empty UUID array parameter in BLE discover call
- Add support for Ruuvi Air (formats 6 and E1)
- Detects if hostname ends with .local in gateway autodiscovery
- Typo in import
- Bugfixes in gateway
- Code factoring
- First version with gateway support (WIP), ruuvipro improvments, trigger fix
- Test version for cloud support
- Improve memory usage
- Update to SDKv3
- Bug fix, updated y18n
- Add reset in sequence number detection : low bat warning. This adds alarm_battery capability for Ruuvitag in RAWv2 format and a maintenance action to reset alarm
- Add preference to show / hide notification messages
- Add API for Ruuvi Station gateway
- Fixed pressure unit, updated trigger title
- Add triggers when RuuviTag enters/leaves, fixed bug with acceleratio with RAWv1
- Add app settings, acceleration capability, icons
- Initial version