Fork of esphome-idasen-desk-controller for TiMOTION TWD1 Series controller bluetooth module.
Alternative for Stand Up Pls. android app.

BT communication protocol - reverse engineering

# example module notifications
                                   | value part
02 03 20 0c 00 08 00 04 00 1b 0b 00 99 42 01 60 3c
02 03 20 0c 00 08 00 04 00 1b 0b 00 99 41 01 60 3b
02 03 20 0c 00 08 00 04 00 1b 0b 00 99 40 01 73 4d
                                   |            /\ checksum(?)
                                             /\ desk height in hex
                                       /\ move status: 40 idle, 41 down, 42 up

# example commands send by mobile app
                                   | value part
02 03 00 0c 00 08 00 04 00 52 0e 00 d9 ff 01 60 39
02 03 00 0c 00 08 00 04 00 52 0e 00 d9 ff 02 60 3a
                                   |            /\ checksum
                                             /\ last recaived height
                                          /\ command: 01 up, 02 down, 04 target
Command 0x04: target_height        |
02 01 02 0c 00 08 00 04 00 52 0e 00 d9 ff 04 50 2c # target_height=90cm (0x50), checksum: 90-36=54 (0x2c)
02 01 02 0c 00 08 00 04 00 52 0e 00 d9 ff 04 5a 36 # target_height=80cm (0x5a), checksum: 80-36=44 (0x36)
                                   |            /\ checksum 'target_height - 36' in hex
                                             /\ target_height in hex
                                          /\ command

Reading status is quite simple, just decode height and move status value from notification.
Sending command seems complicated due to previous height and checksum calculated from the entire packet, but on the end module is validating only checksum, without checking whether height is correct, so we can always send the same command value for UP and DOWN command, eg. UP (0x01): 0xd9ff01633c, DOWN (0x02): 0xd9ff02603a.
There is also command 0x04 with TARGET height, that one needs little calculations for checksum.

Dependencies

• This component requires an ESP32 device.
• ESPHome 2021.10.0 or higher.
• standing desk controller TiMOTION TDH18P
• bluetooth module TiMOTION TWD1.

Installation

! If necessary, just follow original instruction of esphome-idasen-desk-controller

You can install this component with ESPHome external components feature like this:

external_components:
  - source: github://duchu-net/esphome-timotion-desk-controller@v0.0.2
  # or clone, and serve from locally
  - source:
      type: local
      path: components/esphome-timotion-desk-controller/components

Configuration

ESPHome yaml example: esphome-timotion-desk-controller.yaml.

TiMOTION Trademark Notice

The TiMOTION name and logo are trademarks of TiMOTION Technology Co. Ltd. All Rights Reserved. Is not part of the licensing for this project.