Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

Read current radon level from RadonEye RD200 - modified to support RD200 v2

License

Notifications You must be signed in to change notification settings

programmdesign/radonreader

Open more actions menu
 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

59 Commits
59 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

RadonReader 2022 RD200 v2 (=>2022)

This project provides a tool which allows users collect current radon data from FTLab Radon Eye RD200 v1 and V2 (2022+) (Bluetooth only versions).

EtoTen v0.4 - 07/05/2022

  • Forked Project
  • Changed compatability to Python3
  • Added support for new RD200 models made in 2022
  • Added auto-scan ability
  • Change the read function to call the handler directly, instead of interacting with the UUIDs

Note: if specifying an (-a) MAC address, you now also have to specify a device type (-t) (either 0 for original RD200 or 1 for RD200 v2)

Pre-req install steps:

sudo apt install libglib2.0-dev
pip3 install bluepy
pip3 install paho-mqtt
sudo setcap cap_net_raw+e /home/pi/.local/lib/python3.7/site-packages/bluepy/bluepy-helper
sudo setcap cap_net_admin+eip /home/pi/.local/lib/python3.7/site-packages/bluepy/bluepy-helper

Home assistant integration via MQTT:

  • Install mosquitto MQTT add-on in HA, configure it with a local user and password

  • Install mosquitto MQTT integration in HA

  • On the host machine run:

    python3 radon_reader.py -v -ms localhost -mu radonuser -mw radon123  -ma -m
    and listen to: "environment/RADONEYE/#" in the MQTT integration in HA to verify messages are being sent

  • Now make the app send automatic updates to HA every 3 minutes

crontab -e
*/3 * * * * /usr/bin/python3 /home/pi/radonreader/radon_reader.py -v -a 94:3c:c6:dd:42:ce -t 1 -ms localhost -mu radonuser -mw radon123  -mw radon123  -ma -m #update radon reading via MQTT every 3 minutes
  • Add this to configuration.yaml:

mqtt:
  sensor:
    - state_topic: "environment/RADONEYE/#"
      name: 'Radon Level'
      unit_of_measurement: 'pCi/L'
      value_template: "{{ value_json.radonvalue }}"
  • Now you cam add a sensor card to your HA view

Hardware Requirements

  • FTLabs RadonEye RD200 v1 or v2
  • Raspberry Pi w/Bluetooth LE (Low Energy) support (RPi 3B/4/etc...)

Software Requirements

  • Python 3.7
  • bluepy Python library
  • paho-mqtt Python library

History

  • 0.4 - Forked and modified extensively
  • 0.3 - Added MQTT support

Usage

usage: radon_reader.py [-h] [-a] ADDRESS [-t] DEVICE_TYPE [-b] [-v] [-s] [-m] [-ms MQTT_SRV]
                       [-mp MQTT_PORT] [-mu MQTT_USER] [-mw MQTT_PW] [-ma]

RadonEye RD200 (Bluetooth/BLE) Reader

optional arguments:
  -h, --help       show this help message and exit
  -a ADDRESS       Bluetooth Address (AA:BB:CC:DD:EE:FF format)
  -t TYPE          0 for original RD200, 1 for RD200 v2 (=>2022)
  -b, --becquerel  Display radon value in Becquerel (Bq/m^3) unit
  -v, --verbose    Verbose mode
  -s, --silent     Only output radon value (without unit and timestamp)
  -m, --mqtt       Enable send output to MQTT server
  -ms MQTT_SRV     MQTT server URL or IP address
  -mp MQTT_PORT    MQTT server service port (Default: 1883)
  -mu MQTT_USER    MQTT server username
  -mw MQTT_PW      MQTT server password
  -ma              Enable Home Assistant MQTT output (Default: EmonCMS)

Example usage:

python3 radon_reader.py -a 94:3c:c6:dd:42:ce -t 1 -v #verbose output/ specific device MAC
python3 radon_reader.py -v #verbose output, auto scan
python3 radon_reader.py -v -a 94:3c:c6:dd:42:ce -t 1 -ms localhost -mu radonuser -mw radon123  -ma -m #verbose output, specific device MAC, mqtt to home assistant

About

Read current radon level from RadonEye RD200 - modified to support RD200 v2

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 88.1%
  • Shell 11.9%
Morty Proxy This is a proxified and sanitized view of the page, visit original site.