Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ole1986/centronic-py
Centronic USB Stick to control Becker Shutter CC31/CC51
https://github.com/ole1986/centronic-py
Last synced: 21 days ago
JSON representation
Centronic USB Stick to control Becker Shutter CC31/CC51
- Host: GitHub
- URL: https://github.com/ole1986/centronic-py
- Owner: ole1986
- Created: 2019-05-28T19:19:40.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2021-09-24T09:52:27.000Z (about 3 years ago)
- Last Synced: 2023-02-27T22:45:35.822Z (over 1 year ago)
- Language: Python
- Homepage:
- Size: 1.59 MB
- Stars: 32
- Watchers: 12
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
[](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=TDSRUDJ9EL98J&source=url)
This project automates "Becker Antriebe" shutter also known as CC31/CC51 using the Centronic USB Stick V2
```
./centronic-stick.py [-hlst] [--checksum ] [--device ] [--add ] [--mod ] [--remove ] [--send |UP:|CLEARPOS|TRAIN|TRAINMASTER|REMOVE> --channel <[unit:]channel>]
This script is used send command codes to CC11/CC51 compatible receivers through the CentronicControl USB Stick
It is necessary to own such USB device and to PAIR it first, before using commands like UP and DOWN
-h: shows this help
-l: listen on the centronic USB device to fetch the codes
-s: display the current db stats (incl. last run of a unit)
-t: test mode - no codes will be send and no numbers consumed / works only with '--send'
--send : submit a completely generated code for UP/UP2/DOWN/DOWN2/HALT/DOWN:/UP:/CLEARPOS/TRAIN/REMOVE commands / requires '--channel'
While UP2 and DOWN2 are the intermediate position (E.g. sun protection)
--device : set the device if it differs from the default, also host:port possible (ser2net)
--channel <[unit:]channel>: define the unit (1-5) and channel (1-7) being used for '--send'. Example: 2:15 will close shutter for unit 2 on all channels
--checksum : add a checksum to the given 40 char code and output (without STX, ETX)
--mod : used to manipulate the db entries
--add : used to add a db entry
--remove : used to remove an entry from db
```
### INSTALLATION
Run the `install.sh` script to install all necessary dependencies.
The installer will also configure sudo to allow FHEM the execution of `centronic-stick.py`.
For those who are familar with the installation routine, the following steps are required
* Install python3 pip
* Install python3 module `pyserial` using python3 pip
* Add `fhem` user into sudoers file to allow executing `centronic-stick.py` from the FHEM website
### PROGRAM RECEIVER
To make recievers listening to the Centronic USB Stick, the "master sender" is required to add additional senders. The "master sender" can either be the wall-mounted transmitter or a remote.
To program another sender, please follow the below instruction
**1) Press and hold the programming button on the MASTER SENDER for ~3 seconds**
The receiver should confirm with a single "Klack" noise
**2) Run the below command to TRAIN the receiver**
The receiver should confirm with a single "Klack" noise followed by a "Klack - Klack" once the training succeeded
```
./centronic-stick.py --send TRAIN --channel 1
```
Repeat the steps for all the receivers using different channels (E.g. `--channel 2`, `--channel 3`, [...])
*You have successfully paired the Centronic Stick with your shutter(s)*
### ADD MORE CHANNELS
By default the `--channel` argument uses the first known unit (registered in the database file) for a maximum of **7 channels**.
If more channels are required, the `--channel` argument can be used to choose different units (maximum 5)
Example:
```
# program another unit on channel 1
./centronic-stick.py --send TRAIN --channel 2:1
```
```
# program a third unit on channel 7
./centronic-stick.py --send TRAIN --channel 3:7
```
### EXAMPLE USAGE
To move down the shutter, run the below command (amend the channel if neccessary)
```
# move down the shutter programmed on channel 1 for unit 1
./centronic-stick.py --send DOWN --channel 1
```
To move up the shutter on unit 2 and channel, run the below command
```
# move up the shutter programmed on channel 1 for unit 2
./centronic-stick.py --send UP --channel 2:1
```
To pause the movement on unit 3 and channel 1 (which is not the same as unit 1 and channel 1), run the command
```
# stop shutter on unit 3 channel 1
./centronic-stick.py --send HALT --channel 3:1
```
To move down all shutters per explicit unit, run the below command
```
# --channel 15 and --channel 1:15 is the same
./centronic-stick.py --send HALT --channel 1:15
```
To move down all shutters on ALL configured units, run the below command (check `-s` argument to see which unit is configured)
```
# move down shutter on all configured units and all channels (15 = broadcast)
./centronic-stick.py --send DOWN --channel 0:15
```
### REMOVE SENDER
To unpair the centronic-stick.py the following steps can be achieved
**1) Press and hold the programming button on the MASTER SENDER for 3 seconds**
The receiver should confirm with a single "Klack" noise
**2) Run the below commands to REMOVE the sender from its receiver**
The receiver should confirm with a single "Klack" noise followed by a "Klack - Klack"
```
# remove unit 1 with channel 1 from the shutter
./centronic-stick.py --send REMOVE --channel 1
```
**Please note that this command is per channel*
Once ALL SENDERS for a specific unit are removed from ALL RECEIVERS it is safe to reset the increment counter using `--mod` argument.
### DATABASE OUTPUT
Below is an example output of the sqlite3 database
```
code increment configured last run
1737b 825 1 2020-04-01 17:26
1737c 0 0 (unknown)
1737d 0 0 (unknown)
1737e 0 0 (unknown)
1737f 0 0 (unknown)
```
### TROUBLESHOOTING
Since this script requires to store the incremental numbers for any unit being configured, the database file `centronic-stick.db` is used.
It might be necessary to manually change or increase the number to match with the receiver.
Use the argument `--mod "::"` (CAREFULLY) to set the unit properties
Further technical details can be found in the [TECHNICAL.md](TECHNICAL.md) document