Home Assistant
Media Player
Expansion
Sensor
Unit NeoHEX Home Assistant Integration
This section describes how to integrate Unit NeoHEX with Home Assistant.
1. Preparation
Environment Setup
- Install Home Assistant by following the official Home Assistant documentation.
- Install the ESPHome Device Builder add-on by following the official ESPHome documentation.
Hardware
- Unit NeoHEX
- Host controller (Atom series, Stamp series, Stick series, or Core / Basic series)
2. Firmware Compilation & Flashing
Framework Compatibility
The
ESP32 RMT LED Strip component supports only the ESP-IDF framework; the light component for the Arduino framework is NeoPixelBus Light. Starting with version 2026.1.0, ESPHome's default framework will change to ESP-IDF. The ESP32 RMT LED Strip component is recommended for lighting.Host Controller
Unit NeoHEX is standalone lighting hardware and requires an additional host controller to integrate with Home Assistant. Due to design differences, drive capability varies between host controllers. For details, see Learn -> Drive Status.
Modify Configuration
Click
EDITon the device card to open the YAML editor.When using Atom VoiceS3R as the host controller, its signal line is
GPIO2. Add the following light configuration:
yaml
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
light:
- platform: esp32_rmt_led_strip
rgb_order: GRB
pin: GPIO2
num_leds: 37
chipset: WS2812
name: "Unit NeoHex"
id: neo_hex_light
restore_mode: RESTORE_DEFAULT_OFF
effects:
- random:
name: "Random"
transition_length: 1s
update_interval: 4s
...- For more light settings and effects, see Light Effects.
- Main reference component: ESP32 RMT LED Strip.
Download and Flash Firmware
- After completing the configuration, download the firmware file.
- Flash the firmware to the host controller.
3. Getting Started
After completing the configuration and successfully flashing the firmware, locate the light entity for Unit NeoHEX in Home Assistant to control the light.
Usage Tip
When the light brightness is set to 100%, be careful of burns if touching the light after prolonged operation. To extend LED lifespan, avoid operating at maximum brightness for extended periods.
Page Tools