Read parameters from DucoBox.
Project description
DucoBox
Script to monitor a Duco ventilation system.
Installation
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
Usage
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. These fields can be adapted for each node:
name: convenience name for the node (any string)
blacklist: flag to blacklist (don’t use this node) from the network (True, or False)
The rest of the fields should not be adapted outside the script.
Hints
Serial cable details
TODO: provide serial cable details
Allowing non-root user to access serial port (Ubuntu, Linux)
Add user to dialout group:
adduser <username> dialout
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"
Reboot
reboot
Limitations
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.
Contribute
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 | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for duco.ducobox-0.0.16-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | f4787ad93588134eba98fcbd8a05b4f0fdbc58ebeae3986d5e04c082e666873d |
|
MD5 | 025d604e965054ed60b286964f7a9828 |
|
BLAKE2b-256 | 31dc96c292c92f0579ce7d4288396b4017bc203674a3f87dc8dd18f729d16e9d |