README.md

SKARSTA - motorized table

Introduction

Quite some time ago, I have bought one of Skarsta tables. As its electric alternative Bekant seemed to me overpriced and it doesn't have many presets for custom positions. After testing quite a few DC motors from Ebay, Aliexpress and Banggood, I stuck with DC-12V-180RPM Motor, that satisfies my needs at the moment. But basically, you can use any motor that you have... All you have to do is update case sizing for that motor. Other electronics can remain the same...

Features

• display showing current position and feedback
• 3 customizable height positions with auto home
• calibration of MIN and MAX table position to avoid destroying mechanism and limiting travel range of table
• ESPHome / Home Assistant integration via serial-control

• While display is flashing with dashes, set table to the lowest position
• Manual calibration
  • Press "tilde" button for 3s or until message '-rst' shows to confirm the lowest position and afterwards set table to the highest position
  • Press "tilde" button for 3s or until message '-rst' shows once more to confirm max position
• NOTE Automatic calibration is currently disabled by default as it may damage motor/electronics on failure (it can be enabled via __EXPERIMENTAL__ build flag)
  • Press "tilde" button for 5s to initiate to automatic calibration procedure (table will try to determine its highest/lowest position based on the deadlock detection)
• Afterwards you can use table with min/max soft. limits and custom positions
• To set new position just press one of 1, 2, 3 buttons until display shows "set" message
• To "goto" preset position just press 1, 2, 3 buttons
• To reset min/max bounds and custom positions, press "tilde" once more as previously it was calibrated

How-to

• NOTE your table needs to be leveled and manual adjustment shouldn't feel jerky, as it may influence on mod functionality

Electronic cases

• All in one designs (deprecated)

  • case_bridge-v1
  • case_relays-v1
  • for shaft cut off 100mm from the end of Skarsta handle or use Hex-Key 6mm which will be used to connect motor to table (deprecated)

• Modullar designs

  • Electronics
    • case_bridge-v2
    • case_relays-v2
  • Motor
    • case_motor-v2
  • Sensors
    • sensor-rot - relative position
    • sensor-hall - relative position
    • sensor-sonar - absolute position

Display + Keypad cases

• panel-v1
• panel-v2

FAQ

• if any Error message bellow is showed on display it is needed to manually power down/up table to be able to operate once again, after any of error pops out it is advised to closely inspect table if the problem reoccurs if so open an issue

  Error code	Description
  Err 1	Motor stuck and cannot rotate
  Err 2	Motor started unexpectedly
  Err 3	Wiring issue

• in case of reversed polarity on motor update #define REVERSE_POLARITY false to true in configuration.h

Library Credentials

Rotary HC-SR04 TM1637 PolymorphicButtons

Thanks to

• iLLiac4, See his mods on Thingiverse
• p0thi, for ESPHome integration