Metadata-Version: 2.1
Name: ramses-rf
Version: 0.9.13
Summary: An interface for the RAMSES RF protocol,         as used by Honeywell-compatible HVAC & CH/DHW systems.     
Home-page: https://github.com/zxdavb/ramses_rf
Author: David Bonnes
Author-email: zxdavb@gmail.com
License: MIT
Download-URL: https://github.com/zxdavb/ramses_rf/archive/0.9.13.tar.gz
Description: [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black) [![CircleCI](https://circleci.com/gh/zxdavb/ramses_rf.svg?style=svg)](https://circleci.com/gh/zxdavb/ramses_rf) [![Join the chat at https://gitter.im/evohome_rf/community](https://badges.gitter.im/evohome_rf/community.svg)](https://gitter.im/evohome_rf/community?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
        
        ## 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](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 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:
         - [evohome_cc](https://github.com/zxdavb/evohome_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:
        ```
        python client.py monitor /dev/ttyUSB0 -o packet.log
        ```
        
        
Keywords: ramses,evohome,sundial,chronotherm,hometronics
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.7
Classifier: Topic :: Home Automation
Requires-Python: >=3.7
Description-Content-Type: text/markdown
