ramses-rf 0.61.3

Overview

ramses_rf is a Python 3.13-3.14 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, Vasco, ClimaRad

It requires a USB-to-RF device, either a Honeywell HGI80 (somewhat rare, expensive), a USB/MQTT dongle running the ramses_esp, evofw3 firmware, such as the one from here, your own ESP32-S3-WROOM-1 N16R8 with a CC1100 transponder or a combination of dongles for better RF coverage.

It does four 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 them for state changes
• allows you to emulate some hardware devices (remotes)

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.

This library includes a CLI and can be used as a standalone tool, but also is used as a client library by:

• ramses_cc, a Home Assistant integration
• evohome-Listener, an MQTT gateway

Our Code of Conduct applies to all use of this repository and the code it creates.

Installation

To use the ramses_cc Integration in Home Assistant, just install Ramses RF using HACS. It will take care of installing this library. See the Ramses_cc wiki for details.

Ramses_rf CLI

To install the ramses_rf command line client:

git clone https://github.com/ramses-rf/ramses_rf
cd ramses_rf
pip install -r requirements/requirements.txt
pip install -e .

The CLI is called client.py and is included in the code root. It has options to monitor and parse Ramses-II traffic to screen or a log file, and to parse a file containing Ramses-II messages to the screen. See the client.py CLI wiki page for instructions.

For code development, some more setup is required. Please follow the steps in our Developer's Resource