Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/imicknl/loctekmotion_iot
Learn how to connect your Flexispot (LoctekMotion) desk to the internet. This repository contains a collection of scripts to get your started, combined with research and instructions.
https://github.com/imicknl/loctekmotion_iot
esp32 esp8266 flexispot flexispot-desks home-assistant loctek loctekmotion smart-desk standing-desk
Last synced: 6 days ago
JSON representation
Learn how to connect your Flexispot (LoctekMotion) desk to the internet. This repository contains a collection of scripts to get your started, combined with research and instructions.
- Host: GitHub
- URL: https://github.com/imicknl/loctekmotion_iot
- Owner: iMicknl
- License: mit
- Created: 2021-03-04T21:59:35.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2024-12-26T23:35:49.000Z (28 days ago)
- Last Synced: 2025-01-10T21:02:28.865Z (13 days ago)
- Topics: esp32, esp8266, flexispot, flexispot-desks, home-assistant, loctek, loctekmotion, smart-desk, standing-desk
- Language: C++
- Homepage:
- Size: 1.37 MB
- Stars: 651
- Watchers: 21
- Forks: 68
- Open Issues: 56
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
(*image source: [Windows Central](https://www.windowscentral.com/flexispot-e5-standing-desk-review)*)
## Turn your LoctekMotion/FlexiSpot desk into a smart desk
Recently I acquired a new standing desk from FlexiSpot. During assembly I noticed that the control panel had a RJ45 cable and a second RJ45 port, which sparked my interest. Can we connect my desk to the internet?
Most of the models Flexispot sells are using components from LoctekMotion. [LoctekMotion](https://www.loctekmotion.com/) is a manufacturer of lifting columns for height adjustable standing desks. On their website they mention a [bluetooth receiver](https://www.loctekmotion.com/shop/accessories/bt-desk-app/) that can be inserted to the control box, but I haven't been able to find this.
This repository will help you to connect your desk to the internet via the serial communication ports (RJ45), for example for use with [Home Assistant](https://www.home-assistant.io/). Think of scenarios like controlling your desk via voice or creating notifications when you sit for too long.
(or just because it is cool 🤓)
## Packages
> Use the information in this repository at your own risk and with caution. Tinkering with electronics always has risks.
| Name | Description |
| ------------------------------------ | -------------------------------------------------------------------------------------------------------------------- |
| [ESPHome](packages/office-desk.yaml) | Control your desk via an ESP32 module connected to Home Assistant. Can be adapted to ESP8266 or other ESP32 variant. |
The v1 packages, including the Arduino and Raspberry Pi ones, can be found in the [`archive`](./archive/) directory.
For more packaged solutions, see [similar projects](#similar-projects--research). Pull requests are welcome.
## Getting started
Please follow the [ESPHome documentation](https://esphome.io/guides/getting_started_command_line.html) for the basics of ESPHome. You can use the provided [`office-desk-esp32.yaml`](https://github.com/iMicknl/LoctekMotion_IoT/blob/main/packages/office-desk-esp32.yaml) as a boilerplate for your own implementation. This implementation has been created for the ESP32 nodemcu, but can easily be adopted for other platforms and boards.
If you don't have an extra RJ45 port on your desk controller, you will need to use a pass-through solution. At the moment this hasn't been implemented in the latest version, but you can look at the [archive](./archive/esphome/README.md) for the v1 implementation.
## Pin-out
| RJ45 pin | Name | ESP32 |
| -------- | --------- | --------- |
| 8 | +5V (VDD) | VIN |
| 7 | GND | GND |
| 6 | TX | TX2 (GPIO17) |
| 5 | RX | RX2 (GPIO16) |
| 4 | PIN 20 | D23 (GPIO23) |
| 3 | (unknown) | |
| 2 | SWIM | |
| 1 | RES | |
## Known issues
- Number entity may overshoot. For more accurate positioning, use the provided presets.
## Research
If you are interested in the internals of the LoctecMotion desk system, have a look at the research below which is composed of my own findings combined with findings of [similar projects](#similar-projects--research).
### Control Panels
At the time of writing, LoctekMotion sells [11 different control panels](https://www.loctekmotion.com/product/control-panel/). The features can differ per model, but it looks like the serial interface is pretty similar for the more advanced models.
The tables below will show a mapping of the RJ45 pinout to the pinout used by the control panel. Please note that all RJ45 pins are described in the following way:
The most common [color convention](https://www.showmecables.com/blog/post/rj45-pinout)
for wiring RJ45 for network cables is:
In order to connect the control box to a Raspberry Pi and ESP32/ESP8266 chip I used a [RJ45 to RS232 adapter](https://www.allekabels.nl/rs232-kabel/4568/1041186/rj45-naar-rs232.html) with DuPont cables (jump wires), but you simply can cut and split an ethernet cable as well.
#### Supported Control Panels
If your control panel is missing, feel free to [create an issue](https://github.com/iMicknl/LoctekMotion_IoT/issues/new) to discuss the possibilities or create a PR to add your research to this overview.
#### HS13B-1
- **Desk model**: Flexispot E7
- **Tested with control box**: CB38M2J(IB)-1
- **Source**: Printed on the PCB of the control box.
| RJ45 pin | Name | Original Cable Color | Ethernet cable color (T568B) |
| -------- | ---------- | -------------------- | ---------------------------- |
| 1 | RESET | Brown | White-Orange |
| 2 | SWIM | White | Orange |
| 3 | EMPTY | Purple | White-Green |
| 4 | PIN 20 | Red | Blue |
| 5 | RX | Green | White-Blue |
| 6 | TX | Black | Green |
| 7 | GND | Blue | White-Brown |
| 8 | +5V (VDD) | Yellow | Brown |
Note that RX and TX is defined like this on receiver (control panel) side.
So the custom controller also uses RX to receive data and TX to send data.
#### HS13A-1
- **Desk model**: Flexispot EK5
- **Tested with control box**: CB38M2B(IB)-1
- **Source**: Printed on the PCB of the control box.
| RJ45 pin | Name | Original Cable Color | Ethernet cable color (T568B) |
| -------- | ---------- | -------------------- | ---------------------------- |
| 1 | RESET SWIM | Brown | White-Orange |
| 2 | PIN 20 | White | Orange |
| 3 | RX | Purple | White-Green |
| 4 | TX | Red | Blue |
| 5 | GND1 | Green | White-Blue |
| 6 | +5V (VDD) | Black | Green |
| 7 | 29V+ | Blue | White-Brown |
| 8 | 29V- | Yellow | Brown |
Note that RX and TX is defined like this on receiver (control panel) side.
So the custom controller also uses RX to receive data and TX to send data.
#### HS01B-1
- **Desk model**: Flexispot E5B
- **Tested with control box**: CB38M2A-1
- **Source**: [nv1t/standing-desk-interceptor](https://github.com/nv1t/standing-desk-interceptor)
| RJ45 pin | Name |
| -------- | --------- |
| 8 | +5V (VDD) |
| 7 | GND |
| 6 | TX |
| 5 | RX |
| 4 | PIN 20 |
| 3 | (unknown) |
| 2 | SWIM |
| 1 | RES |
Note that RX and TX is defined like this on receiver (control panel) side.
So the custom controller also uses RX to receive data and TX to send data.
Other control panels / control boxes could be supported in the same way, but you would need to figure the RJ45 pinout mapping. Most control boxes have an extra RJ45 port for serial communication, but otherwise you would need to place your device in between the control panel and the control box.
### Retrieve current height
Based upon the great work of [minifloat](https://www.mikrocontroller.net/topic/493524), it became clear that the control panel utilises a [7-segment display](https://en.wikipedia.org/wiki/Seven-segment_display). Fortunately, this is very common in such devices and thus there is a lot of [documentation](https://lastminuteengineers.com/seven-segment-arduino-tutorial/) on this topic.
The control box sends the height as 4-bit hexadecimal, which is decoded in the control panel to drive the 7-segment display. The second number on the display also supports an optional decimal point ("8 segment").
Make sure you set the baud rate to 9600. For most LoctekMotion desks, the control box only broadcasts the current height for x seconds after you sent the Wake Up command. Otherwise you will receive `0x00` `0x00` `0x00` as payload.
source: [alselectro](https://alselectro.wordpress.com/2015/03/03/8051-tutorials-3-interfacing-7-segment-display/)
### Execute a command
The control box only accepts commands when the 'screen is active'. To activate the screen, `PIN 20` needs to be set to HIGH for about 1 second. The screen gets disabled automatically again after some amount of time receiving no commands.
#### Command list
| Command name | Start | Length | Type | Payload | Checksum | End |
| ----------------- | ----- | ------ | ---- | --------- | --------- | ---- |
| Wake Up | `9b` | `06` | `02` | `00` `00` | `6c` `a1` | `9d` |
| Up | `9b` | `06` | `02` | `01` `00` | `fc` `a0` | `9d` |
| Down | `9b` | `06` | `02` | `02` `00` | `0c` `a0` | `9d` |
| M | `9b` | `06` | `02` | `20` `00` | `ac` `b8` | `9d` |
| Preset 1 | `9b` | `06` | `02` | `04` `00` | `ac` `a3` | `9d` |
| Preset 2 | `9b` | `06` | `02` | `08` `00` | `ac` `a6` | `9d` |
| Preset 3 (stand) | `9b` | `06` | `02` | `10` `00` | `ac` `ac` | `9d` |
| Preset 4 (sit) | `9b` | `06` | `02` | `00` `01` | `ac` `60` | `9d` |
All bytes combined will become the command to send to the control box. See the [packages](#packages) for sample code.
## Similar projects / research
While working on this project, I found out that I am not the only one with this idea. There are a few repositories on GitHub with great research which helped me kickstart this project. ❤️
- [grssmnn / ha-flexispot-standing-desk](https://github.com/grssmnn/ha-flexispot-standing-desk) - Home Assistant integration via MQTT (micropython)
- [Dude88 / loctek_IOT_box](https://github.com/Dude88/loctek_IOT_box) - Arduino code to control via Alexa and MQTT
- [nv1t / standing-desk-interceptor](https://github.com/nv1t/standing-desk-interceptor) - Research on intercepting commands from Flexispot desks
- [VinzSpring / LoctekReverseengineering](https://github.com/VinzSpring/LoctekReverseengineering#assumptions) - Research and Python samples
and a huge thanks to the [Tweakers.net](https://gathering.tweakers.net) community (Dutch), whom helped me to kickstart this project.
## Support
Join our [Discord channel](https://discord.gg/C7TNzUZ9Xf)