## Overview
**ramses_rf** is a Python 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) or something running the [evofw3](https://github.com/ghoti57/evofw3) firmware, such as the one from [here](https://indalo-tech.onlineweb.shop/) or your own ESP32-S3-WROOM-1 N16R8 with a CC1100 transponder.
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 for state changes
- allows you to emulate some hardware devices
> [!WARNING]
> This library is not affiliated with Honeywell, Airios nor any final manufacturer. The developers take no responsibility for anything that may happen to your devices because of this library.
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/ramses-rf/ramses_cc), a Home Assistant integration
- [evohome-Listener](https://github.com/smar000/evohome-Listener), an MQTT gateway
## Installation
To use the `ramses_cc` Integration in Home Assistant, just install `Ramses RF` from HACS. It will take care of installing this library. See the [`Ramses_cc wiki`](https://github.com/ramses-rf/ramses_cc/wiki/1.-Installation) 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.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](https://github.com/ramses-rf/ramses_rf/wiki/The-client.py-command-line) for instructions.
For code development, some more setup is required. Please follow the steps in our [Developer's Resource](README-developers.md)
Raw data
{
"_id": null,
"home_page": null,
"name": "ramses-rf",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": "Egbert Broerse <dcc2@ebroerse.nl>",
"keywords": "airios, chronotherm, climarad, evohome, hometronics, honeywell, itho, nuaire, orcon, ramses, resideo, round thermostat, sundial, vasco",
"author": null,
"author_email": "David Bonnes <zxdavb@bonnes.me>, Egbert Broerse <dcc2@ebroerse.nl>",
"download_url": "https://files.pythonhosted.org/packages/e5/07/b58f426c334f8c3a58cf5073746781b8c3512ee22e9cf3a02b7134f9f3b1/ramses_rf-0.51.5.tar.gz",
"platform": null,
"description": "\n\n\n\n## Overview\n\n**ramses_rf** is a Python client library/CLI utility used to interface with some Honeywell-compatible HVAC & CH/DHW systems that use 868MHz RF, such as:\n - (Heat) **evohome**, **Sundial**, **Hometronic**, **Chronotherm**\n - (HVAC) **Itho**, **Orcon**, **Nuaire**, **Vasco**, **ClimaRad**\n\nIt 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/) or your own ESP32-S3-WROOM-1 N16R8 with a CC1100 transponder.\n\nIt does four things:\n - decodes RAMSES II-compatible packets and converts them into useful JSON\n - builds a picture (schema, config & state) of evohome-compatible CH/DHW systems - either passively (by eavesdropping), or actively (probing)\n - allows you to send commands to CH/DHW and HVAC systems, or monitor for state changes\n - allows you to emulate some hardware devices\n\n> [!WARNING]\n> This library is not affiliated with Honeywell, Airios nor any final manufacturer. The developers take no responsibility for anything that may happen to your devices because of this library.\n\nFor 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:\n - **R8810A**: OpenTherm Bridge\n - **BDR91A**: Wireless Relay (also BDR91T)\n - **HC60NG**: Wireless Relay (older hardware)\n\nOther systems may well work, such as some Itho Daalderop HVAC systems, use this protocol, YMMV.\n\nIt includes a CLI and can be used as a standalone tool, but also is used as a client library by:\n - [ramses_cc](https://github.com/ramses-rf/ramses_cc), a Home Assistant integration\n - [evohome-Listener](https://github.com/smar000/evohome-Listener), an MQTT gateway\n\n## Installation\n\nTo use the `ramses_cc` Integration in Home Assistant, just install `Ramses RF` from HACS. It will take care of installing this library. See the [`Ramses_cc wiki`](https://github.com/ramses-rf/ramses_cc/wiki/1.-Installation) for details.\n\n### Ramses_rf CLI\n\nTo install the `ramses_rf` command line client:\n```\ngit clone https://github.com/ramses-rf/ramses_rf\ncd ramses_rf\npip install -r requirements.txt\npip install -e .\n```\n\nThe CLI is called ``client.py`` and is included in the code root.\nIt 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.\nSee the [client.py CLI wiki page](https://github.com/ramses-rf/ramses_rf/wiki/The-client.py-command-line) for instructions.\n\nFor code development, some more setup is required. Please follow the steps in our [Developer's Resource](README-developers.md)\n",
"bugtrack_url": null,
"license": null,
"summary": "A stateful RAMSES-II protocol decoder & analyser.",
"version": "0.51.5",
"project_urls": {
"Bug Tracker": "https://github.com/ramses-rf/ramses_rf/issues",
"Homepage": "https://github.com/ramses-rf/ramses_rf",
"Wiki": "https://github.com/ramses-rf/ramses_rf/wiki"
},
"split_keywords": [
"airios",
" chronotherm",
" climarad",
" evohome",
" hometronics",
" honeywell",
" itho",
" nuaire",
" orcon",
" ramses",
" resideo",
" round thermostat",
" sundial",
" vasco"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "5fd8f9a1d3f227b19e00dfc85b3f7e43a4659918b2906b12fdaed408b133d647",
"md5": "aa753d70a973fcd3d7fa1461ada79bb4",
"sha256": "bad18c866d61ed1d3e664d148434dc8103f62ff9b3972b0f7aa66d998c11e3c6"
},
"downloads": -1,
"filename": "ramses_rf-0.51.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "aa753d70a973fcd3d7fa1461ada79bb4",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 260169,
"upload_time": "2025-09-07T19:26:38",
"upload_time_iso_8601": "2025-09-07T19:26:38.626230Z",
"url": "https://files.pythonhosted.org/packages/5f/d8/f9a1d3f227b19e00dfc85b3f7e43a4659918b2906b12fdaed408b133d647/ramses_rf-0.51.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "e507b58f426c334f8c3a58cf5073746781b8c3512ee22e9cf3a02b7134f9f3b1",
"md5": "7382a635215e2117d7cc4417cf5bf01f",
"sha256": "da3f177691d89847264ca3841fe3ecdd5f31c1566286e9fc467e0532e5d8765d"
},
"downloads": -1,
"filename": "ramses_rf-0.51.5.tar.gz",
"has_sig": false,
"md5_digest": "7382a635215e2117d7cc4417cf5bf01f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 465213,
"upload_time": "2025-09-07T19:26:40",
"upload_time_iso_8601": "2025-09-07T19:26:40.207104Z",
"url": "https://files.pythonhosted.org/packages/e5/07/b58f426c334f8c3a58cf5073746781b8c3512ee22e9cf3a02b7134f9f3b1/ramses_rf-0.51.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-07 19:26:40",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ramses-rf",
"github_project": "ramses_rf",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "click",
"specs": [
[
">=",
"8.2.1"
]
]
},
{
"name": "colorama",
"specs": [
[
">=",
"0.4.6"
]
]
},
{
"name": "debugpy",
"specs": [
[
">=",
"1.8.13"
]
]
}
],
"lcname": "ramses-rf"
}
JSON
