A Python library to interface with Airios RF bridges.
Airios develop and produce several components for residential ventilation systems that final manufacturers use to build their products upon, from controller boards to remote controls or sensors.
All of these components communicate over a proprietary RF protocol from Honeywell called Ramses II in the 868Mhz band. The RF bridge allows third party applications to access the nodes in the RF network over standard Modbus protocol.
There are two bridge models with different interfaces. The BRDG-02R13 has a RS485 serial interface (Modbus-RTU) and the BRDG-02EM23 is an Ethernet device (Modbus-TCP).
This library supports both models.
Warning
Performing a hard reset on the Ethernet bridge will restore factory default settings and erase the configuration required to connect to the manufacturer cloud. Please ensure you back up your settings before proceeding.
Each device in the RF network is called a node and nodes must be bound together to be able to communicate. There are two classes of nodes:
- Controllers (typically ventilation units). Binding mode is enabled for a fixed period after power cycle.
- Accessories (remote controls or sensors). They bind to a controller in a device-specific way, e.g., pressing a combination of buttons.
The bridge is an accessory with special features. It can bind to multiple controllers and at the same time it can "intercept" the accessories binding procedure so they are bound to the controller and the bridge at the same time. Each bound device to the bridge creates a new virtual Modbus server with its own address and register set. The register set depends on the bounded product.
NOTE: Binding is only possible when products have the same OEM code. The RF bridge has a registry to change it if necessary.
These are the OEM codes used by the different manufacturers. The value is hexadecimal.
| Manufacturer | OEM code (hex) |
|---|---|
| Vasco | 0x66 |
| Orcon | 0x67 |
| Siber | 0x6A |
This library has been tested with the following devices.
- Siber DFEVORFETH Ethernet bridge (Airios BRDG-02EM23)
- Siber DFEVORFRS485 RS485 bridge (Airios BRDG-02R13)
- Siber DF Evo 2 / DF Optima 2 (Airios VMD-02RPS78)
- ClimaRad Ventura V1X HRU (Airios VMD-07RPS13)
- Orcon generic (Airios VMD-15RMS86-2)
python -m pip install pyairiosThe library offers a high level and easy to use API:
transport = AiriosModbusRTUTransport(device="/dev/ttyACM0")
api = Airios(transport)
vmd = api.node(<Modbus device id>)
A command line interface is also included in the library for testing purposes. Use the help or ? command to get the list of available commands in each context.
- Siber for providing the documentation and an outstanding support.