Based Heavily on: https://github.com/sgoadhouse/tilt2mqtt Which was originally from: https://github.com/LinuxChristian/tilt2mqtt
- Inroduction
- How to run
- Running as a service
- Integrate with Home Assistant
- Integrate with Brewers Friend
Note: This package requires a MQTT server. To get one read here.
Wrapper for reading messages from RAPT Pill wireless hydrometer and forwarding them to MQTT topics.
The device acts as a simple Bluetooth Low Energy (BLE) beacon sending its data encoded within the Manufacturing Data. Details of RAPT Pill data format can be found here: https://gitlab.com/rapt.io/public/-/wikis/Pill-Hydrometer-Bluetooth-Transmissions
The raw values read from the RAPT Pill are (possibly) uncalibrated and should be calibrated before use. The script works a follows,
- Listen for local BLE devices
- If found the callback is triggered
- Use Manufacturer ID "5241" (0x4152) to determine that it is from a RAPT Pill (cannot yet distinguish multiple Pills)
- Extract and convert measurements from the device
- Construct a JSON payload
- Send payload to the MQTT server
- Stop listening and sleep for X minutes before getting a new measurement
This script has been tested on Linux.
If you are on Linux first install the bluetooth packages,
sudo apt-get install libbluetooth-devThen install Python dependencies
pip install bleson paho-mqtt requests pybluez
Run the script,
python raptpill2mqtt.py
Note: If you get a permission error try running the script as root.
The code should now listen for your RAPT Pill device and report values on the MQTT topic that matches your RAPT Pill color.
You can use the mosquitto commandline tool (on Linux) to listen for colors or the build-in MQTT client in Home Assistant,
mosquitto_sub -t 'rapt/pill/#'To listen for measurements only from Orange devices run,
mosquitto_sub -t 'rapt/pill/Orange/#'If your MQTT server is not running on the localhost you can set the following environmental variables,
| Varable name | Default value |
|---|---|
| MQTT_IP | 127.0.0.1 |
| MQTT_PORT | 1883 |
| MQTT_AUTH | NONE |
| MQTT_DEBUG | TRUE |
If you would like to run raptpill2MQTT as a service on Linux using systemd add this file to a systemd path (Normally /lib/systemd/system/raptpill2mqtt.service or /etc/systemd/system/raptpill2mqtt.service)
# On debian Linux add this file to /lib/systemd/system/raptpill2mqtt.service
[Unit]
Description=RAPT Pill Hydrometer Service
After=multi-user.target
Conflicts=getty@tty1.service
[Service]
Type=simple
Environment="MQTT_IP=192.168.1.2"
Environment="MQTT_AUTH={'username':\"my_username\", 'password':\"my_password\"}"
Environment="TILT_CAL_YELLOW={'sg':0.024, 'temp':0.0}"
ExecStart=/usr/bin/python3 <PATH TO YOUR FILE>/raptpill2mqtt.py
StandardInput=tty-force
[Install]
WantedBy=multi-user.targetRemember to update MQTT_IP, my_username, my_password, calibration constants and change the PATH variable in the script above. Then update your service,
sudo systemctl reload-daemon
OR
sudo systemctl --system daemon-reload
Will also need to enable and start the service:
sudo systemctl enable raptpill2mqtt
sudo systemctl start raptpill2mqtt
Using the MQTT sensor in home assistant you can now listen for new values and create automations rules based on the values (e.g. start a heater if the temperature is too low).
- platform: mqtt
name: "RAPT Pill Orange - Temperature"
state_topic: "rapt/pill/Orange"
value_template: "{{ value_json.temperature_celsius_uncali | float + 0.5 | float | round(2) }}"
unit_of_measurement: "\u2103"
- platform: mqtt
name: "RAPT Pill Orange - Gravity"
state_topic: "rapt/pill/Orange"
value_template: "{{ value_json.specific_gravity_uncali | float + 0.002 | float | round(3) }}"Notice that here the calibration value is added directly to the value template in home assistant.
Using the following gist it is possible to stream the calibrated values from home assistant to the brewers friend API via a simple Python script. After this you can add the raptpill2mqtt.service to
