Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/thomasdelaet/python-velbus
A python library to control the Velbus home automation system
https://github.com/thomasdelaet/python-velbus
automation domotics home home-assistant velbus
Last synced: about 1 month ago
JSON representation
A python library to control the Velbus home automation system
- Host: GitHub
- URL: https://github.com/thomasdelaet/python-velbus
- Owner: thomasdelaet
- License: mit
- Created: 2017-11-19T09:03:19.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2023-11-11T12:48:41.000Z (about 1 year ago)
- Last Synced: 2024-09-29T19:20:58.250Z (about 2 months ago)
- Topics: automation, domotics, home, home-assistant, velbus
- Language: Python
- Homepage:
- Size: 432 KB
- Stars: 17
- Watchers: 6
- Forks: 8
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## python-velbus: A python library to control the Velbus home automation system
| :warning: WARNING |
|:----------------------------------------------------------------------------------------------------------------------------------------------------------|
| This Library was used as the backend for home-assistant, but it has been replaced with the [velbus-aio](https://github.com/Cereal2nd/velbus-aio) library. |
This library was created to support the Velbus protocol in my home automation efforts.
The latest version of the library is published as a python package on [pypi](https://pypi.python.org/pypi/python-velbus)
I would like to extend this module to support all Velbus modules, so feel free to submit pull requests or log issues through [github](http://www.github.com/thomasdelaet/python-velbus) for functionality you like to have included.
API documentation is available [here](http://python-velbus.readthedocs.io/en/latest/)
# Port format
There are 3 possible port formats:
- /dev/ttyACME0 = A direct connection to a serial device (for vmbusb for example)
- ip:port = A connection to a TCP/IP port
- tls://signum ip:27015 = A connection to a signum ip
# Installation
You can install the library with pip (*pip install python-velbus*) or by checking out the [github](https://github.com/thomasdelaet/python-velbus) repository and running *python setup.py install* at the root of the repository.
# Supported modules
The following Velbus modules are currently supported by this library:
| Module name | Description | Comments |
| ----------- | ----------- | -------- |
| VMB1BL | 1 channel blind module | All messages are supported |
| VMB1BLS | 1 channel blind module | All messages are supported |
| VMB1LED | 1 channel LED dimmer module | All messages are supported |
| VMB1RS | Serial interface | All messages are supported |
| VMB1RY | 1 channel relay module | All messages are supported |
| VMB1RYS | 1 channel relay module | All messages are supported |
| VMB1RYNO | 1 channel relay module | All messages are supported |
| VMB1RYNOS | 1 channel relay module | All messages are supported |
| VMB1TS | 1 channel temperatue sensor | Temperature supported |
| VMB1USB | USB configuration module | All messages are supported |
| VMB2BL | 2 channel blind module | All messages are supported |
| VMB2BLE | 2 channel blind module | All messages are supported |
| VMB2PBN | 2 channel input module | All messages are supported |
| VMB4DC | 4 channel 0-10 dimmer module |All messages are supported |
| VMB4RY | 4 channel relay module | All messages are supported |
| VMB4RYLD | 4 channel relay module | All messages are supported |
| VMB4RYNO | 4 channel relay module | All messages are supported |
| VMB6IN | 6 channel input module | All messages are supported |
| VMB6PBN | 6 channel input module | All messages are supported |
| VMB7IN | 7 channel input module | All messages are supported |
| VMB8PBU | 8 channel input module | All messages are supported |
| VMBDME | 1 channel dimmer module | All messages are supported |
| VMBDMI | 1 channel dimmer module | All messages are supported |
| VMBDMI-R | 1 channel dimmer module | All messages are supported |
| VMBGP1 | 1 channel glass panel | Input and Temperature supported |
| VMBGP1-2 | 1 channel glass panel | Input and Temperature supported |
| VMBGP2 | 2 channel glass panel | Input and Temperature supported |
| VMBGP2-2 | 2 channel glass panel | Input and Temperature supported |
| VMBGP4 | 4 channel glass panel | Input and Temperature supported |
| VMBGP4-2 | 4 channel glass panel | Input and Temperature supported |
| VMBGPO | 72 channel glass panel with oled | Input and Temperature supported |
| VMBGPOD | 72 channel glass panel with oled and thermostat | Input and Temperature supported |
| VMBMETEO | meteo modules | Temperature, wind, rain and light sensor supported |
| VMBRSUSB | Configuration module with USB and RS-232 interface | All messages are supported |
| VMBEL1 | 1 channel glass panel Edge Lit | Input and Temperature supported |
| VMBEL2 | 2 channel glass panel Edge Lit | Input and Temperature supported |
| VMBEL2 | 2 channel glass panel Edge Lit | Input and Temperature supported |
| VMBEL4 | 4 channel glass panel Edge Lit | Input and Temperature supported |
| VMBELO | 72 channel glass panel Edge Lit with thermostat and oled screen | Input and Temperature supported |
# Adding support for other modules
The [velbus website](http://www.velbus.eu) contains an overview of the different available modules and their protocol documentation. In order to add support for an additional module, read through the protocol documemntation and add support for missing messages (many messages are shared between modules so make sure to check if a message already exists or not)
Steps to add support for an additional module:
- [ ] Look up the protocol documentation of the module you want to include at the [velbus website](https://www.velbus.eu/products/): Select the module, go to *Downloads* and search for the info sheet with protocol information.
- [ ] Go through the messages directory and look for messages in the protocol information sheet that are not yet supported. Create a new file in the *messages* folder for each unsupported message. Every new message should inherit from the *Message* object and reuse common functionality.
- [ ] Implement constructor method for each new message
- [ ] Implement the *populate* and *data_to_binary* methods for each new message
- [ ] If the message has other than low priority or no RTR set (which are defaults), then re-implement *set_defaults* method
- [ ] Add new messages to the *__init__.py* file in the *messages* folder
- [ ] Test and iterate
- [ ] Update the Supported modules section of the *README.md* file
- [ ] Submit a pull request on Github
# Further development
The library currently offers only the lowest level of functionality: sending and receiving messages to modules. I plan to extend this library with more higher-level functionality such as:
- [x] Modeling modules and their supported functions as entities
- [ ] Only allowing to send supported messages to modules
- [x] Auto-discovery of modules
- [ ] Exposing the velbus controller as an external API so it can be shared between different consumers