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:

uint8_t StartByte =  0x98;
uint8_t StartByte =  0x98;
uint8_t Param;
uint8_t Param;
uint8_t Data;
uint8_t Data;

Param is the following:

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

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:

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

pip install pre-commit
pip install -r requirements-dev.txt -U
pre-commit install

adfinis/muuvctl