An interface for the RAMSES RF protocol, as used by Honeywell-compatible HVAC & CH/DHW systems.
Project description
Overview
ramses_rf is a client library/CLI utility used to interface with some Honeywell-compatible HVAC & CH/DHW systems that use 868MHz RF, such as:
- (Heat) evohome, Sundial, Hometronic, Chronotherm
- (HVAC) Itho, Orcon, Nuaire
It requires a USB-to-RF device, either a Honeywell HGI80 (somewhat rare, expensive) or something running the evofw3 firmware, such as the one from here.
It does three things:
- decodes RAMSES II-compatible packets and converts them into useful JSON
- builds a picture (schema, config & state) of an evohome-compatible system - either passively (by eavesdropping), or actively (probing)
- allows you to send commands to evohome, or monitor for state changes
- allows you to emulate some hardware devices
For CH/DHW, the simplest way to know if it will work with your system is to identify the box connected to your boiler/HVAC appliance as one of:
- R8810A: OpenTherm Bridge
- BDR91A: Wireless Relay (also BDR91T)
- HC60NG: Wireless Relay (older hardware)
Other systems may well work, such as some Itho Dallderop HVAC systems, use this protocol, YMMV.
It includes a CLI and can be used as a standalone tool, but also is used as a client library by:
- evohome_cc, a Home Assistant integration
- evohome-Listener, an MQTT gateway
Installation
git clone https://github.com/zxdavb/ramses_rf
cd ramses_rf
pip install -r requirements.txt
The CLI is called client.py:
python client.py monitor /dev/ttyUSB0 -o packet.log
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for ramses_rf-0.20.18-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2b694174c1df1b6c03f42e3c5c4093d8e250a5ae2c0220c77a3f9f89546d08e0 |
|
MD5 | a8295b968d63c30f7bba92ae3862c500 |
|
BLAKE2b-256 | 0c78092c09d8d092af76d5d7084c3373f5484770c95da5a783c6f17a6d19080e |