Radon Eye Measurement script
Radon FTLab have created a detector of radon in the environment. The model RD200 http://radonftlab.com/radon-sensor-product/radon-detector/rd200/ has bluetooth capability and an application that communicates with it. It is possible to communicate with it with any bluetooth enabled device.
We are connecting to the following GATT service:
UUID_SERVICE = "00001523-1212-efde-1523-785feabcd123"
It is possible to communicate with the device via bluetooth and the following GATT characteristic UUIDs:
UUID_CONTROL = "00001524-1212-EFDE-1523-785FEABCD123"
UUID_MEASUREMENT = "00001525-1212-EFDE-1523-785FEABCD123"
All you have to do is write 0x50 to the UUID_CONTROL service and you will get a measurement by reading GATT UUID_MEASUREMENT.
The data that is returned to UUID_MEASUREMENT is in the following format:
| Offset | length bytes | Description | Type |
|---|---|---|---|
| 0x0 | 1 | command | int |
| 0x1 | 1 | message total length | int |
| 0x2 | 4 | current measurement | float |
| 0x6 | 4 | average day measurement | float |
| 0xA | 4 | average month measurement | float |
| 0xE | 2 | pulse | int |
| 0x10 | 2 | pulse 10 min | int |
The command should read 0x50 (this is now the reply to the command 0x50 sent). So for example, the current measurement is a float (4 bytes). The currrent measurement is then calculated by multiplying the float reading by 37 (for Bq/m^3, which is what I have it set it).
I provide a 010 Editor Template radon-measure.bt
Example
Example reply data :
50 10 71 3D 8A 3F 71 3D AA 3F E1 7A B4 3F 03 00 06 00
| Offset | Value (hex) | Description | Type | Converted* (Bq/m^3) |
|---|---|---|---|---|
| 0x0 | 50 | command | 80 int | - |
| 0x1 | 10 | message total length | 16 int | - |
| 0x2 | 71 3D 8A 3F | current measurement | 1.08 float | 39.96 |
| 0x6 | 71 3D AA 3F | average day measurement | 1.33 float | 49.21 |
| 0xA | E1 7A B4 3F | average month measurement | 1.41 float | 52.17 |
| 0xE | 03 00 | pulse | 3 int | - |
| 0x10 | 06 00 | pulse 10 min | 6 int | - |
* Keep in mind the device may round down or cut decimal points.
Python Script
The script I provide makes use of the bleak and construct Python libraries. Check the requirements.txt file.
How to get started:
$ git clone https://github.com/kxynos/radon_eye_measurement
$ cd radon_eye_measurement
$ virtualenv pyenv
$ source pyenv/bin/activate
(pyenv)$ pip3 install -r requirements.txt
(pyenv)$ python3 radon_eye_measurement.py
Scan mode (when get_device = True, this is the default initial state of the script)
[+] Running scan
Address: Description
XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX: FR:R20:SNXXXX
Open radon_eye_measurement.py with your favourit editor and paste this value XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX into the variable address. Look for the FR:R20:SNXXX string at the end of the each line; this is the device name(address)(ini MS Windows it will have a different format) and serial number (you can match it with the one on the device). Also set get_device = False (we don't need it anymore, you might need it again if you change devices or get another one).
Example changes to radon_eye_measurement.py to get it connecting to the RadonEye device:
def main():
print_debug = False
command_line = True
get_device = False # can be True or False
address = "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" # copy the address here