LightHub
is Flexible, Arduino-Mega/Arduino DUE/ESP8266 open-software and open-hardware SmartHome controller. RU HOME-site RU
It may operate both:
- On especially designed hardware board with 16 optocoupled digital inputs, 16 ESD protected digital/analog Inputs/outputs, 8 open-collector outputs (up to 0.5A/50V), DMX IN/OUT, MODBUS RTU and hardware 1-wire support circuit.
- On plain Arduino MEGA 2560, Arduino DUE, ESP8266 and even on Controllino
(Controllino and ESP8266 is not tested enough and in experimental stage yet)
Lighthub allows connecting together:
Where is possible both, to configure local control/mapping between inputs and outputs (light, floor heating thermostats) and remote control from MQTT enabled software. At the moment, LightHub tested and perfectly working with following set of complementary free software:
- Openhab or Openhab2 Smarthome software
Openhab provides own native mobile app both, for IoS and Android, and even allow you to use Apple’s HomeKit and Google Home to say “Siri, turn on light in bedroom” or “Hey Google, set bedroom light to Red” but requires some server to be installed in-premises (Raspberry PI with Openhabian will good enough)
- HomeRemote mobile client
Home Remote mobile applicatios for IoS and Android requires just MQTT broker to be working. Any Cloud-based MQTT broker, like CloudMQTT will enough to serve average household, even with free account.
- Node-Red Possibly, the best solution to deploy event-based authomation and scripting on top of MQTT/LightHub. The easy to use universal and visual tool to wire many different devices in single system. Having own Dashbord which allow control from web/mobile web, even without mobile apps (excelent co-working with OpenHab and HomeRemote)
Scalability of Lighthub is virtually unlimited: Setup so many controllers you needed in most convenient places of your house - MQTT broker will allow controllers communicate each other and with Openhab/NodeRed/HomeRemote and propagate commands across network.
Finished portation of project to Arduino DUE and ESP8266 (ESP32 not tested).
Compiled image has been added to compiled/ folder. Flash your Mega 2560
avrdude -v -V -patmega2560 -cwiring -b115200 -D -Uflash:w:firmware.hex:i
or flash your DUE (need to correct path and port, of course)
/Users/<user>/Library/Arduino15/packages/arduino/tools/bossac/1.6.1-arduino/bossac -i -d --port=cu.usbmodem1451 -U false -e -w -v -b firmware.bin -R
Note: binary images usually not up-to-date with recent code. The preferred way, to compile and upload firmware to your controller.
Dependencies
(quite big number of libs required. Use git clone to have your local copy in your Arduino libs folder)
Please check updates for all dependences.
For patched libraries, appropriate GitHub repo URL provided:
- Arduino-Temperature-Control-Library https://github.com/anklimov/Arduino-Temperature-Control-Library
- DS2482_OneWire https://github.com/anklimov/DS2482_OneWire
- FastLED
- Wire (standard)
- Artnet https://github.com/anklimov/Artnet.git
- DmxSimple https://github.com/anklimov/DmxSimple (for AVR) or https://github.com/anklimov/ESP-Dmx (for ESP) or https://github.com/anklimov/DmxDue (for DUE)
- HTTPClient (for AVR) https://github.com/anklimov/HTTPClient or https://github.com/arduino-libraries/ArduinoHttpClient for other platforms
- aJson https://github.com/anklimov/aJson
- CmdArduino https://github.com/anklimov/CmdArduino
- EEPROM (standard for AVR) or DueFlashStorage for DUE: https://github.com/sebnil/DueFlashStorage
- ModbusMaster https://github.com/anklimov/ModbusMaster
- pubsubclient-2.6
- DMXSerial-master (for AVR) https://github.com/anklimov/DMXSerial
- Ethernet https://github.com/anklimov/Ethernet
- SPI (standard)
Portation from AVR Mega 2560 to SAM3X8E (Arduino DUE) done since v 0.96 and tested against Wiznet 5100 Ethernet shield and Wiznet 5500 Ethernet module
AVR version is basic, long time in production and have all functions
*DMX-out is software (DMXSimple) on pin3
SAM3X8E: (Tested. In production. Recomended hardware at current moment)
- default PWM out frequency
- both, DMX-in and DMX-out are hardware USART based. Use USART1 (pins 18 and 19) for DMX-out and DMX-in
ESP8266: (Developed but not tested in production)
- DMX-OUT on USART1 TX
- DMX-IN - not possible to deploy in ESP8266
- Modbus - disabled. Might be configured in future on USART0 instead CLI/DEBUG
since v. 0.97:
Mega and DUE:
Need to use compiler directive -D Wiz5500 and https://github.com/anklimov/Ethernet2 library to compile with Wiznet 5500 instead 5100
Prefered way to compile project is using platformio toolchain, suitable for Arduino Due, and Arduino Mega2560
Due compilation issue “USART0_Handler redefinition”
Please, open /variants/arduino_due_x/variant.cpp file, then add USART0_Handler method definition like this
void USART0_Handler(void) __attribute__((weak));
The normal path to find this file in platformio is:
.platformio/packages/framework-arduinosam/variants/arduino_due_x
First of all install platformio framework. Good tutorial for fast start in RUSSIAN.
In linux\OSX you can open terminal, navigate to your programming directory, then
git clone https://github.com/anklimov/lighthub.git
cd lighthub
now prepare project files for your IDE
pio init --ide [atom|clion|codeblocks|eclipse|emacs|netbeans|qtcreator|sublimetext|vim|visualstudio|vscode]
Set custom build flags. first make your own copy of template
cp build_flags_template.sh my_build_flags.sh
then edit, change or comment unnecessary sections and source it
build and upload firmware for due|megaatmega2560|esp8266 board
pio run -e due|megaatmega2560|esp8266 -t upload
Clean pio libraries folder. Try it if you have compilation problem:
open COM-port monitor with specified baud rate
platformio device monitor -b 115200
Custom build flags
- MY_CONFIG_SERVER=192.168.1.1 // address of external JSON-config http://192.168.1.1/de-ad-be-ef-fe-00.config.json
- WATCH_DOG_TICKER_DISABLE //disable wdt feature
- USE_1W_PIN=49 // use direct connection to 1W devices on 49 pin, no I2C bridge DS2482-100
- SD_CARD_INSERTED // enable sd-card support and fix lan starting
- SERIAL_BAUD=115200 // set baud rate for console on Serial0
- Wiz5500 //Use Wiznet 5500 library instead Wiznet 5100
- DISABLE_FREERAM_PRINT // disable printing free Ram in bytes
- CUSTOM_FIRMWARE_MAC=de:ad:be:ef:fe:00 //set firmware macaddress
- DMX_DISABLE //disable DMX support
- MODBUS_DISABLE // disable Modbus support
- OWIRE_DISABLE // disable OneWire support
- ARTNET_ENABLE //Enable Artnet protocol support
- AVR_DMXOUT_PIN=18 // Set Pin for DMXOUT on megaatmega2560
- CONTROLLINO //Change Modbus port, direction pins and Wiznet SS pins to be working on Controllino
- LAN_INIT_DELAY=2000 // set lan init delay for Wiznet ethernet shield
- ESP_WIFI_AP=MYAP // esp wifi access point name
- ESP_WIFI_PWD=MYPWD // esp wifi access point password
- WIFI_MANAGER_DISABLE //Disable wifi manager for esp8266
- DHT_COUNTER_DISABLE //disable DHT, Counter, Uptime input support (for RAM savings on mega2560)
- RESTART_LAN_ON_MQTT_ERRORS //reinit LAN if many mqtt errors occured
- DEVICE_NAME short handy device name which is used instead of mac for download config http://{MY_CONFIG_SERVER}/{DEVICE_NAME}_config.json
- SYSLOG_ENABLE enable UDP SYSLOG support feature(under DEVELOPMENT) that must be configured through config file
- WITH_PRINTEX_LIB use PrintEx library (develop experimental feature)
Default compilation behavior:
- Config server: lazyhome.ru
- Watchdog enabled
- 1-Wire communication with DS2482-100 I2C driver
- No SD
- Serial speed 115200
- Wiznet 5100 (for MEGA & DUE)
- Free Ram printing enabled
- de:ad:be:ef:fe:ff default MAC address
- DMX support enabled
- Modbus support enabled
- OneWire support enabled
- Artnet disabled
- LAN_INIT_DELAY=500 //ms
- Defailt MQTT input topic: /myhome/in
- Default MQTT topic to publish device status: /myhome/s_out
- Default Alarm output topic /alarm
- DHT, Counter, Uptime support enabled
- Wifi manager for esp8266 enabled
- RESTART_LAN_ON_MQTT_ERRORS disabled
- DEVICE_NAME disabled
- SYSLOG_ENABLE disabled
- WITH_PRINTEX_LIB diabled, using Streaming library
If you’ve using Arduino IDE to compile & flash firmware, it will use Default options above and you will not able to configure additional compilers options except edit “options.h” file