https://github.com/zxdavb/ramses_rf
An interface for the RAMSES RF protocol, as used by Honeywell-compatible HVAC & CH/DHW systems.
https://github.com/zxdavb/ramses_rf
airios bdr91a chronotherm evohome evohome-rf hgi80 hometronics itho orcon ramses ramses-rf resideo sundial valsir
Last synced: about 1 year ago
JSON representation
An interface for the RAMSES RF protocol, as used by Honeywell-compatible HVAC & CH/DHW systems.
- Host: GitHub
- URL: https://github.com/zxdavb/ramses_rf
- Owner: zxdavb
- License: mit
- Created: 2019-11-25T09:42:01.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2025-04-18T07:59:58.000Z (about 1 year ago)
- Last Synced: 2025-05-08T05:55:19.555Z (about 1 year ago)
- Topics: airios, bdr91a, chronotherm, evohome, evohome-rf, hgi80, hometronics, itho, orcon, ramses, ramses-rf, resideo, sundial, valsir
- Language: Python
- Homepage:
- Size: 5.41 MB
- Stars: 68
- Watchers: 8
- Forks: 19
- Open Issues: 30
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# New code owner wanted
I no longer am able to work on this project and active development has ceased.
Please reach out to me if you feel able to take over. I will hand over the entire repo to the right person, and would be prepared to provide help during a transition period.
## 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](https://github.com/ghoti57/evofw3) firmware, such as the one from [here](https://indalo-tech.onlineweb.shop/).
It does three things:
- decodes RAMSES II-compatible packets and converts them into useful JSON
- builds a picture (schema, config & state) of evohome-compatible CH/DHW systems - either passively (by eavesdropping), or actively (probing)
- allows you to send commands to CH/DHW and HVAC systems, 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 Daalderop 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:
- [ramses_cc](https://github.com/zxdavb/ramses_cc), a Home Assistant integration
- [evohome-Listener](https://github.com/smar000/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`.
For example, to monitor ramses_rf messages picked up by a dongle connected to port USB0, and log them in `packet.log`:
```
python client.py monitor /dev/ttyUSB0 -o packet.log
```
To view the `client.py` help:
```
python client.py --help
```