Skip to content

Latest commit

 

History

History
117 lines (77 loc) · 5.49 KB

flash.md

File metadata and controls

117 lines (77 loc) · 5.49 KB

Flash Firmware

The following guide helps you flash HassLight LED controller with Apple HomeKit based firmware or Home Assistant MQTT based firmware.

Please be aware that it's NOT necessary for you to flash the firmware. It comes with HomeKit based firmware by default.

Congratulations! If you are still reading this, I assume you are a professional and know what you are going to do. By using Home Assistant based firmware which usually means you want to have more flexibility in controlling your LED strip.

Have fun!

Prerequesites

  1. Install CH340G driver if you have never done this on your OS.
  2. Download HassLightFlasher.exe for Windows or HassLightFlasher.dmg for Mac
  3. Choose the firmware to download
Integration Product Color Order Is Default Length Firmware
HomeKit Holiday String (5V) RGB 1 5-10 Meter Download
HomeKit Mood LED Strip (12V) BRG 1 5 Meter Download
HomeKit Mood LED Strip (12V) BRG 0 10 Meter Download
HomeKit Mood LED Strip (12V) GRB 0 5 Meter Download
HomeKit Mood LED Strip (12V) GRB 0 10 Meter Download
HomeAssistant Holiday String (5V) RGB 0 5-10 Meter Download
HomeAssistant Mood LED Strip (12V) BRG 0 5 Meter Download
HomeAssistant Mood LED Strip (12V) GRB 0 5 Meter Download
WLED Holiday String (5V) ANY 0 5-10 Meter Download
WLED Mood LED Strip (12V) ANY 0 5-10 Meter Download

If you are using Linux command, you need 2 additional files rboot.bin and blank_config.bin for HomeKit firmware

When extending the LED strip longer, check this Extend LED Strip

Apple HomeKit

Mac / Windows

  • Make sure jumper header set on 0-hkit

  • Connect to the Micro-USB port on PCB

  • Start HassLightFlasher

    • Choose serial port, click refresh if not seen
    • Choose the firmware.bin which you just download
    • Click "Flash" button, a successful flash looks like the example pictures below

  • Next, follow the Use Apple HomeKit to config

Linux

  • Install esptool and then flash

    $ pip install esptool
    $ esptool.py --chip esp8266 -p /dev/cu.wchusbserial620 --baud 115200 write_flash -fs detect -fm dio -ff 40m 0x0 rboot.bin 0x1000 blank_config.bin 0x2000 holiday_firmware.bin

  • Next, follow the Use Apple HomeKit to config

Home Assistant

Mac / Windows

  • Make sure jumper header set on 0-hass

  • Start HassLightFlasher

    • Choose serial port, click refresh if not seen
    • Choose the firmware.bin which you just download
    • Toggle "Default / Home Assistant / MQTT" integration
    • Click "Flash" button, a successful flash looks like the example pictures below

  • Next, follow the Use Home Assistant to config

Linux

  • Install esptool and then flash

    $ pip install esptool
    $ esptool.py --chip esp8266 -p /dev/cu.wchusbserial620 --baud 115200 write_flash -fs detect -fm dio -ff 40m 0x0 holiday_firmware.bin

  • Next, follow the Use Home Assistant to config

WLED

Mac / Windows

  • Make sure jumper header set on 0-hkit

  • Start HassLightFlasher

    • Choose serial port, click refresh if not seen
    • Choose the firmware.bin which you just download
    • Toggle "Default / Home Assistant / MQTT" integration
    • Click "Flash" button, a successful flash looks like the example pictures below

  • Next, follow the Use WLED to config

Linux

  • Install esptool and then flash

    $ pip install esptool
    $ esptool.py --chip esp8266 -p /dev/cu.wchusbserial620 --baud 115200 write_flash -fs detect -fm dio -ff 40m 0x0 hasslight-wled-*.bin

  • Next, follow the Use WLED to config