Skip to main content

Read parameters from DucoBox.

Project description

GPL v3 License Build status Code Coverage Code Climate Status Issue Count Requirements Status Contributions welcome


Script to monitor a Duco ventilation system.


Every release is uploaded to pip so it can be installed simply by using pip.

# Python2
pip2 install duco.ducobox

# Python3
pip3 install duco.ducobox


After installation, the python module is available

  • as executable, to launch from terminal:
ducobox --help
  • as python module, to launch from terminal:
python -m duco.ducobox --help
  • as python module, to import in your script:
import duco.ducobox as duco

Stored configuration

The network configuration of your setup is stored in an ini-file. If the network configuration file is not found, it is created.

The script first tries to find all of the nodes in the network, by executing the network command. It creates objects for all of the found nodes. If nodes are found, the network configuration is saved to the provided network configuration file.

The network configuration file gives an overview of all the nodes with their specific parameters. The name of every node can be adapted by the user, in order to easily recognize the nodes. The rest of the fields should not be adapted outside the script.


Serial cable details

TODO: provide serial cable details

Allowing non-root user to access serial port (Ubuntu, Linux)

  1. Add user to dialout group:
adduser <username> dialout
  1. Use udev to allow users of dialout group to serial device

Content for /etc/udev/rules.d/50-ttyusb.rules

SUBSYSTEM=="tty", KERNEL=="ttyUSB0", GROUP="dialout", MODE="0660"
  1. Reboot


The main contributor to this project has a limited Duco ventilation system, with not too much devices:

  • DucoBox Silent
  • Humidity box sensor
  • Remote control on battery

The python module was not tested on other devices, allthough some effort was done in order to support them.

Issues and new Features

In case you have any problems with usage of the plugin, please open an issue on GitHub. Provide as many valid information as possible, as this will help us to resolve Issues faster. We would also like to hear your suggestions about new features which would help your Continuous Integration run better.


There is a Contribution guide available if you would like to get involved in development of the plugin. We encourage anyone to contribute to our repository. Missing a feature or node, but you’re not sure how to start with it? Create an issue.

Project details

Release history Release notifications

History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


This version
History Node


History Node


History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
duco.ducobox-0.0.4-py2.py3-none-any.whl (10.6 kB) Copy SHA256 hash SHA256 Wheel py2.py3 Oct 12, 2017
duco.ducobox-0.0.4.tar.gz (28.5 kB) Copy SHA256 hash SHA256 Source None Oct 12, 2017

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page