{"id":16148811,"url":"https://github.com/zxdavb/ramses_rf","last_synced_at":"2025-05-08T05:55:25.693Z","repository":{"id":37578745,"uuid":"223912799","full_name":"zxdavb/ramses_rf","owner":"zxdavb","description":"An interface for the RAMSES RF protocol, as used by Honeywell-compatible HVAC \u0026 CH/DHW systems.","archived":false,"fork":false,"pushed_at":"2025-04-18T07:59:58.000Z","size":5670,"stargazers_count":68,"open_issues_count":30,"forks_count":19,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-05-08T05:55:19.555Z","etag":null,"topics":["airios","bdr91a","chronotherm","evohome","evohome-rf","hgi80","hometronics","itho","orcon","ramses","ramses-rf","resideo","sundial","valsir"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zxdavb.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"buy_me_a_coffee":"zxdavb"}},"created_at":"2019-11-25T09:42:01.000Z","updated_at":"2025-04-18T08:00:02.000Z","dependencies_parsed_at":"2024-01-17T12:34:58.202Z","dependency_job_id":"6be01ba3-66d4-4f22-8d6e-5dfa49f86c62","html_url":"https://github.com/zxdavb/ramses_rf","commit_stats":{"total_commits":3197,"total_committers":9,"mean_commits":"355.22222222222223","dds":"0.31091648420394125","last_synced_commit":"e43119c6d041e8d7ac831a5e234b7f947232b1e6"},"previous_names":["zxdavb/evohome","zxdavb/evohome_rf"],"tags_count":225,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zxdavb%2Framses_rf","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zxdavb%2Framses_rf/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zxdavb%2Framses_rf/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zxdavb%2Framses_rf/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zxdavb","download_url":"https://codeload.github.com/zxdavb/ramses_rf/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253009852,"owners_count":21839713,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["airios","bdr91a","chronotherm","evohome","evohome-rf","hgi80","hometronics","itho","orcon","ramses","ramses-rf","resideo","sundial","valsir"],"created_at":"2024-10-10T00:34:57.108Z","updated_at":"2025-05-08T05:55:25.686Z","avatar_url":"https://github.com/zxdavb.png","language":"Python","funding_links":["https://buymeacoffee.com/zxdavb"],"categories":[],"sub_categories":[],"readme":"![ruff](https://github.com/zxdavb/ramses_rf/actions/workflows/check-lint.yml/badge.svg)\n![mypy](https://github.com/zxdavb/ramses_rf/actions/workflows/check-type.yml/badge.svg)\n![pytest](https://github.com/zxdavb/ramses_rf/actions/workflows/check-test.yml/badge.svg)\n\n# New code owner wanted\nI no longer am able to work on this project and active development has ceased.\n\nPlease 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.\n\n## Overview\n**ramses_rf** is a client library/CLI utility used to interface with some Honeywell-compatible HVAC \u0026 CH/DHW systems that use 868MHz RF, such as:\n - (Heat) **evohome**, **Sundial**, **Hometronic**, **Chronotherm**\n - (HVAC) **Itho**, **Orcon**, **Nuaire**\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/).\n\nIt does three things:\n - decodes RAMSES II-compatible packets and converts them into useful JSON\n - builds a picture (schema, config \u0026 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\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/zxdavb/ramses_cc), a Home Assistant integration\n - [evohome-Listener](https://github.com/smar000/evohome-Listener), an MQTT gateway\n\n## Installation\n\n```\ngit clone https://github.com/zxdavb/ramses_rf\ncd ramses_rf\npip install -r requirements.txt\n```\n\nThe CLI is called `client.py`.\n\nFor example, to monitor ramses_rf messages picked up by a dongle connected to port USB0, and log them in `packet.log`:\n```\npython client.py monitor /dev/ttyUSB0 -o packet.log\n```\nTo view the `client.py` help:\n```\npython client.py --help\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzxdavb%2Framses_rf","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzxdavb%2Framses_rf","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzxdavb%2Framses_rf/lists"}