Skip to main content

An interface for the RAMSES RF protocol, as used by Honeywell-compatible HVAC & CH/DHW systems.

Project description

Code style: black CircleCI Join the chat at https://gitter.im/evohome_rf/community

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 evohome, Sundial, Hometronic, Chronotherm and many others.

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

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:

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

ramses-rf-0.18.2.tar.gz (141.3 kB view hashes)

Uploaded Source

Built Distribution

ramses_rf-0.18.2-py3-none-any.whl (155.0 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page