Alternative Local Deck Firmware
This repository contains alternative firmware for the LocalDeck device. This firmware connects directly to Home Assistant via WebSocket API, providing a customizable and responsive interface for controlling your smart home devices.
Direct connection to Home Assistant over websocket
Support for toggling switch
,light
,cover
and script
entities with a single press
Support for calling media_player.media_play_pause service for media_player
entities
State and brightness tracking for lights
Brightness/Volume control with special up and down buttons (lights / media_player)
Child Lock Mode (Holding 0,0 + 5,0 for 1 seconds enables child lock mode (Purple LEDs), same actions for disabling (White LEDs)
Default color and brightness settings for switches
Visual feedback for connection status
src/secrets.h.example
to src/secrets.h
src/secrets.h
with your Wi-Fi and Home Assistant credentials:#define WIFI_SSID "Your_SSID_Here"
#define WIFI_PASSWORD "Your_Password_Here"
#define HA_HOST "Your_HA_IP_Here"
#define HA_PORT 8123
#define HA_API_PASSWORD "Your_Long_Lived_Access_Token_Here"
To configure your entity mappings:
src/config.h.example
file to src/config.h
.src/config.h
and replace the example mappings with your own Home Assistant entity mappings.Use PlatformIO to build and flash the firmware to your LocalDeck device.
After flashing the firmware and powering on the LocalDeck, it will attempt to connect to your Wi-Fi network and Home Assistant instance.
Solid Red: Failed to connect to Wi-Fi
Red and Orange alternating: Failed to connect to Home Assistant WebSocket
ENABLE_SERIAL_LOGGING
is disabled in common.h if not monitoring via serial! It somehow causes the device to hang when serial buffer is not being consumed!secrets.h
.Contributions are welcome! Please feel free to submit a Pull Request.