Skip to content

Releases: anklimov/lighthub

v4.2 - New functionality & improvements

06 May 00:25
Choose a tag to compare

New functionality
Control up to 4 Air conditioners
-D NOSERIAL option to release Serial from debug output and use for any purposes
Mercury electricity counter channel type (and ability to share bus with Modbus devices)
New channels commands:


Ability to use timed commands: for example: ON 60000 mean ON now and OFF after 60 sec
DHCP fallback (using last known IP address if DHCP failed)

Fixes and improvements:
Up to 20% RAM saving on huge JSON configs (avoid same text strings in RAM)
Counter - now based on integers (not float) to avoid precsision loses
ESP8266 firmware - slimming to allow OTA on ESP12
MBUS universal driver completed
MultiZone ventilation

Bugfix release

21 Nov 22:11
Choose a tag to compare
  • Modbus negative values fix
  • Parsing of values between 0 and 1 fixed
  • Modbus optimized and relability increased
  • PID: fixes, added minimum and maximum output limits
  • issue with config saving to flash, if config size>20K (DUE) fixed/refactored


03 Oct 22:58
Choose a tag to compare

(!) Complete Modbus v2 two-way mapping functionality (both, command and values)
PID enable/disable command
PWM Relay fixes
Multivent fixes
Air condition swing mode
ModbusTCP&UDP bridge option (-D IPMODBUS)
CleanUp persistant payload
Deleting commands from individual (not broadcast) topics on execute
PID regulator alarm functionality and fixes

Production tested environments: lighthub21, due, mega2560*
Smoke tested: ESP32, ESP8266
Non tested (just builded): stm*, nrf*, controllino

Refactoring, HTTP, new drivers & functionality

05 Jan 22:46
Choose a tag to compare

CORE changes:

  • CORE refactored.
  • Config persistence (saving parameters & config) - now working for Mega, DUE, ESP8266, ESP32.
  • Config auto-saving to flash on portal changes (http ETAG supported to version control).
  • HTTP API & tiny web interface (external by CORS)
  • MDNS controller announcing
  • Local config changing by web
  • Delayed commands (/del suffix)
  • NO_MQTT option
  • input polling on timer interrupts (DUE)

Device driver changes

  • PID regulator (13 type)
  • Relay PWM thermostat (16 type)
  • RGBWW channel type (17 type) & color temperature set
  • Legacy modbus (4 type) improvement (retry speedup, mask = 3 & 4 for swap hi & lo bytes)
  • Multivent driver (18 type)
  • UART bridge (15 type) (serial protocol interceptor) - wireshark udpdump compatible
  • Artnet - to DMX configuration (channel range to pass throw)
  • PWM driver (3 type) - RBGW compatible


  • flashing scripts for DUE
  • Platformio target for OTA (invoke OTA scripts from custom_builds)
  • Clean-up & optimisation

Maintenance release/critical fix

27 Jul 18:49
Choose a tag to compare
  • Compilation issues fixed (caused by updated versions aJSON, ArduinoOTA, Adafruit libs)
  • return statements fixed (compilation errors with updated versions of ESP* compilers)
  • One critical bug with locks leakage on group channels control (causes LAN outage after weeks of operation) - fixed

Updated binaries

v3.0.0 Completely refactored modular core

12 Apr 23:25
Choose a tag to compare

Main improvement:
Since this release, controller's core is refactored completely with new architecture of base classes and new-style internal API (see Doxigen docs for details)

Now is possible to develop drivers for virtually any new devices with minimal effort, using existent drivers code as simple template with minimal impact on core.
New datatypes are used to communicate between modules (variant types, which allow transfer various types of values (float point, hsv, rgb, int, percentage, temperature e t.c)


  • 49days issue fixed
  • DMXbuf corruption fix (then DMX channels in config is out of range)
  • Critical: DMXsmooth buffer memory corruption fixed (due only)
  • DMX flickering bug fixed,
  • MQTT port/login/password issue fixed for some platforms
  • Modbus for ESP32

Breaking changes:

  • Percentage volume scale range 0..100 changed to 0..255 for topics with /set suffix (0..100 scale kept unchanged for old-style topics in order to OpenHAB compatibility). Its strongly recommended to reconfigure your smarthome software (i.e HomeAssistant) _to use new firmware with emulation of old scale (0..100) - re-compile project with option SCALE_VOLUME_100 added in your custom-build-flag file

  • to report temperature from sensors (1-wire or DHT or Modbus) to local or remote regulators (relay or PID thermostat) you need to add /val suffix to item name
    i.e old style sensor definition:
    new style:

New functionality:

  • New universal modbus driver - allow to poll any type of modbus RTU device (described on config) and submit results to MQTT and/or to internal objects
    Support INPUT REGISTERS and HANDLE REGISTERS, only pooling at this moment (writting registers - in roadmap), possible to use old-style Modbus driver same time with new one
  • Thermostate and regulator (PID or relay) now can communicate across MQTT (not just locally). Just use example above to configure remote topic
  • internal "PID regulator" item type. Allow to configure so many as you needed PID regulators to control local or remote devices
  • Exponential bright matrix for RGBW Led (optonal, use BRIGHT_STEP or BRIGHT_LOG compilation directives to activate)
  • HSV & RGB mixed control
  • OTA tools for win added
  • GROUP fixes&optimization
  • Adopted to aJson lib update
  • Color temperature
  • Doxigen documentation (autogenerated)
  • less stack consumption &faster for recursive groups
  • RGB on PWM

Compiled binaries in "compiled" folders of attached archive

The final release for v2 architecture

12 Apr 21:58
Choose a tag to compare


  • 1-wire fixes
  • Critical: DMXsmooth buffer memory corruption fixed
  • (critical) Syslog memory corruption fixed …
  • MQTT port/login/password issue fixed for some platforms
  • OTA sockets leak fixed with every Ethernet interface restart (critical)
  • REST command fixed
  • ESP Wifi auto-restore connect for wifi manager …
  • ESP32 stability fix + remove DMX

New functionality:

  • Analog & I2C input reading cache …
  • MCP23017 inputs

Known issues:

  • 49days bug (after 49 days of continuous running - timer overflow with reboot or partial degradation) - fixed in v3.0.0

v2.1: Merge pull request #54 from anklimov/develop

06 May 23:05
Choose a tag to compare

Motor driver,
Adafruit Neopixel lib,
Double/triple clicks,
long-presses etc,
DMX smooth fading for DUE
many stability improvements


11 Jun 13:07
Choose a tag to compare

==== ENG ====

  • Compiled binaries & tools
  • MQTT topic architecture review to HOMIE convention
  • Normal Opened water thermostats (use negative pin #)
  • RGB to RGBW mapping improved
  • All platforms working Mega (DUE, ESP8266, ESP32, NRF52)
  • Hardware MAC whenever is possible, include DUE (generated from MPU ID)
  • More sensors: CCS811, HDC1080, DHT22
  • Reliable WiFi on ESPx
  • Analog inputs support/Leak sensors
  • Many stability improvements

==== RUS ====
Прошивка радикально доработана, основные изменения, относительно релиза 1.0 (2018):

  • Добавлены откомпилированные образы и утилиты для загрузки
  • Доработана логика MQTT топиков до частичного соответствия homie convention, топики теперь настраиваются
  • Для поддержки нормально открытых водяных термостатов, если использовать отрицательный PIN# вместо положительного - будет работать наоборот. Включать устройство если требуемая температура достигнута
  • Алгоритм преобразования RGB цвета в RGBW существенно доработан. Если насыщенность более половины - используются только RGB светодиоды. Если менее - добавляется белая лента. При нулевой насыщенности работает только чисто белое освещение.
  • Прошивка теперь работает на всех заявленных платформах - Mega, DUE, ESP8266, ESP32, NRF52
  • Везде где возможно используем аппаратный MAC адрес (для DUE генерируем его из уникального номера чипа)
  • Добавлены датчики CO2 и влажности CCS811, HDC1080, DHT22
  • ESP теперь надежно работают с WIFI
  • Больше совместимости с внешним ПО - Domotics, HomeAssistant, NodeRed
  • Работа с аналоговыми входами
  • Работа с датчиками протечки

Ну и серьезно улучшена стабильность и устойчивость к самым разным непредсказуемым воздействиям

Инструкцию по сборке и загрузке можно найти на Wiki

First productive release

29 Jun 21:55
Choose a tag to compare

Tested and operating in production on platforms Mega2560 and Due with Wiznet 5100 and 5500 network accordingly
Another combinations/platforms (ESP8266, controllino) are developed but still wasn't tested enough