bekantfirmware

BEKANT Firmware

Control firmware with position memory for IKEA BEKANT adjustable-height desk. Can be flashed onto the OEM microcontroller, on its OEM circuit board, without changing any hardware.

Background

The stock configuration of the IKEA BEKANT adjustable-height sit/stand desk is controlled by a minimal two-button interface: hold one button to move up, hold the other button to move down. Releasing the button stops moving the desk, which means you have to hold a button while the table steadily moves into position, perhaps while you watch for it to line up with a mark on the wall at the perfect height.

If you switch the height of the desk often, standing there holding a button gives you plenty of time to wonder why a position memory feature wasn’t originally built in. A single button press should be able to move it to a pre-programmed height.

Several IKEA hackers with the same thoughts have reverse engineered the signaling protocol, built replacement hardware, and added more automation to the the control system. But these implementations have either treated the OEM control board as a black box or replaced it outright, meaning their modifications all require new hardware.

This firmware adds position memory with no new hardware.

Images

PIC programmer and logic analyzer connected to OEM BEKANT control board

Circuitboard traces

TX, RX, and GND connections

LIN logic trace in PulseView

Curcuitboard connections annotated

Build & Flash

The firmware image was built in MPLAB X with the XC8 compiler. The microcontroller (PIC16LF1938) can be programmed through ICSP using a PICKit or other PIC programmer.

User’s Guide

Button Action
Move up
+ Move up to upper memory position
Move down
+ Move down to lower memory position
(hold 3 sec) Save current position

”+” means press the first button, and while holding it, press the second button, then release both. Just like Ctrl + X.

Automatic movement to a stored position can be canceled by pressing either button or cutting power.

For the Save gesture, press both buttons at the same time and hold for 3 seconds. The firmware will overwrite either the lower or upper stored position, whichever is closer to the current position. The table should not be moving during the hold, otherwise one of the other gestures was triggered. Both buttons must be pressed within the software debounce interval.

Memory Positions

Memory positions are stored in the PIC EEPROM. These are 16-bit little-endian integers for the encoder values of the motorized table legs.

Offset Length Default Description
0x00 2 bytes 0x0636 Lower position encoder value, default about 70cm
0x02 2 bytes 0x1600 Upper position encoder value, default about 110cm

Disclaimer

Use at your own risk.

The real reason that position memory is not built into the stock firmware is probably for safety and liability. Requiring a human to hold a button while the table is moving keeps a human in the control loop.

Ensure that the path of the table is clear during all movement.

References

  1. https://web.archive.org/web/20190116092248/https://blog.rnix.de/hacking-ikea-bekant/
  2. https://github.com/trainman419/bekant
  3. https://github.com/robin7331/IKEA-Hackant
  4. https://github.com/diodenschein/TableMem
  5. https://en.wikipedia.org/wiki/Local_Interconnect_Network