Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/adfinis/muuvctl
Control muuv tables with a command line tool
https://github.com/adfinis/muuvctl
furniture iot muuv
Last synced: about 2 hours ago
JSON representation
Control muuv tables with a command line tool
- Host: GitHub
- URL: https://github.com/adfinis/muuvctl
- Owner: adfinis
- License: agpl-3.0
- Created: 2019-08-28T13:04:15.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2024-03-20T16:35:03.000Z (8 months ago)
- Last Synced: 2024-05-21T01:49:53.920Z (6 months ago)
- Topics: furniture, iot, muuv
- Language: Python
- Homepage:
- Size: 2.29 MB
- Stars: 18
- Watchers: 16
- Forks: 4
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# muuvctl
Control muuv tables with a command line tool
## Wiring
### Basics
* Open the frontend controller
* Solder a 3-Pin cable to `RX`,`TX` and `GND`
* Connect `RX`,`TX` and `GND` to a USB-> UART controller
### Using controller while USB plugged in
The basic wiring has the disadvantage that only the UART-Controller can control the table and the muuv-device is disfunctional. It can be fixed with a relay connected to `RTS` line of the UART which breaks the `RX` line. It is important that the relay is high trigger.
## Installing
### System wide:
```
pip install .
```
### For current user:
```
pip install --user .
```
In order to run `muuvctl` from commandline, make sure that `/home/$USER/.local/bin` is in your `$PATH`
### Bash completion
Add the following to your `.bashrc`:
```
complete -W "--debug --port get goto --follow" muuvctl
```
## Usage
Move the table to position 80:
```
muuvctl goto 80
```
Get current position of the table:
```
muuvctl get
```
Get live position of the table:
```
muuvctl get --follow
```
## Serial protocol
The protocol seems to be called TiMOTION F-Bus.
Baudrate is: `9600`
The following is known (possibly not everything that the controller can do):
### RX
The controller in the table sends the following:
```c
uint8_t StartByte = 0x98;
uint8_t StartByte = 0x98;
uint8_t Param;
uint8_t Param;
uint8_t Data;
uint8_t Data;
```
`Param` is the following:
```c
STOPPED = 0x00;
SAVE_TRIGGED = 0x01;
MOVING = 0x03;
```
`Data` is normally the position of the table.
### TX
You need to send the following struct to control it
```c
uint8_t StartByte = 0xD8;
uint8_t StartByte = 0xD8;
uint8_t Param;
uint8_t Command;
uint8_t Command;
```
Only known value for `Param` is `0x66` which is used in all commands.
`Command` is the following:
```c
STOP = 0x00;
DOWN = 0x01;
UP = 0x02;
RESET = 0x03;
POS1 = 0x04;
POS2 = 0x08;
POS3 = 0x10;
POS4 = 0x20;
SAVE = 0x40;
```
#### TX Examples
* Move up: `0xD8, 0xD8, 0x66, 0x02, 0x02`
* Move down: `0xD8, 0xD8, 0x66, 0x01, 0x01`
* Stop: `0xD8, 0xD8, 0x66, 0x00, 0x00`
* Goto POS1: `0xD8, 0xD8, 0x66, 0x04, 0x04`
* Goto POS4: `0xD8, 0xD8, 0x66, 0x20, 0x20`
* Reset: `0xD8, 0xD8, 0x66, 0x03, 0x03`
##### Save
* Send min. 32x SAFE: `0xD8, 0xD8, 0x66, 0x40, 0x40`
* Optional: wait until table sends: `0x98, 0x98, 0x01, 0x01, POS, POS `
* Send 4x wanted POS, for POS1: `0xD8, 0xD8, 0x66, 0x04, 0x04`
* Send 1x STOP: `0xD8, 0xD8, 0x66, 0x00, 0x00`
#### Notes
There seems to be no way to move the table to a specific position. You need to send up or down until the table reaches the desired position, then send stop.
## Contributing
Please let us know what you would like to contribute before you get invested! This is really just a proof of concept at this stage.
### pre-commit hook
```bash
pip install pre-commit
pip install -r requirements-dev.txt -U
pre-commit install
```