Important
This project is deprecated and superseded by https://github.com/Rocka84/esphome_components/tree/master/components/jiecang_desk_controller
Sensors and Actors for Jiecang Desk controle boxes using ESPHome.
Attention: I only have a RJ12 desk controller to test this but chances are very high that all Jiecang controllers will work as they all use more or less the same serial protocol.
- ESPHome compatible microcontroller
- depending on your model of desk controller
- cable with RJ12 connector (phone cable, RJ11 may also work)
- cable with RJ45 connector (network cable)
| pin | function |
|---|---|
| 1 | NC (pulled up) |
| 2 | GND |
| 3 | TX |
| 4 | VCC |
| 5 | GND |
| 6 | NC (pulled up) |
| pin | function |
|---|---|
| 1 | HS3 1 |
| 2 | TX |
| 3 | GND |
| 4 | RX |
| 5 | VCC |
| 6 | HS2 1 |
| 7 | HS1 1 |
| 8 | HS0 1 |
| ESP | desk |
|---|---|
| GND | GND |
| 5V | VCC |
| RX | TX |
| TX | RX |
Before installing the config, you need to copy jiecang_desk_sensor.h to your ESPHome sketch folder
For example: scp jiecang_desk_sensor.h hassio@homeassistant:config/esphome/
The default/minimal version only contains basic functionality. This should cover most daily needs and is what I use myself.
The full version contains most known functions of the serial protocol. Many if them are commented out by default, you can uncomment what you need and/or copy paste it to the simple sketch. It also implements an experimental continuous movement mode which basicly simulates holding the up/down buttons.
Caution
Continous movement can only be stopped via this controller! The buttons of the original controller will not stop the movement!
This can cause damage or even hurt someone, use at own risk!
If you only need some of the extended functionality I recommend to copy only those part to the minimal version.
Thanks to phord/Jarvis for reverse engineering the UART interface and most control messages