python-duco ============================================================= Python API and command line tool for communicating to the Duco™ Ventilation System.

The Duco™ Ventilation System supports the option for an external unit to communicate via the ModBus interface. A Duco™ 'master' with ModBus interface (e.g. DucoBox Focus or IQ-unit) exposes all information of the Duco-network and allows external units to control the Duco-network and change settings over ModBus.

python-duco is based on publicly available documentation of the Ducobox and ModBus interface (https://www.duco.eu/Wes/CDN/1/Attachments/L8000009-information-sheet-ModBus-(en)_636336417347448032.pdf).

• Communication via ModBus RTU and ModBus TCP
• Automatic discovery of Duco-network topology
• Provide read and write access to all modules in Duco-network (master, valves, sensors, ...)
• Synchronous API
• Caching of module information and settings, ModBus access via asynchronous queue

The project is currently in alpha status and not ready for integration.

[sudo] pip install python-duco

You can import the module as duco.

import duco

with DucoBox(args.modbus_type, args.modbus_port) as duco_box:
    for node in duco_box.node_list:
        print(node)

Contributing ===== Just fork the repo and raise your PR against dev branch.

License Information ===== Python-duco is not developed by Duco™ and therefore has no affiliation with Duco™. As a result no support can be claimed from Duco™.

Released under the MIT License.