pdf-icon

Unit NeoHEX Home Assistant Integration

This chapter describes how to integrate Unit NeoHEX into Home Assistant.

Preparation

  • Unit NeoHEX Hexagon RGB LED Board
  • Compatible controller devices (Atom series, Stamp series, Stick series, Core/Basic series, etc.)

Note

  • The ESP32 RMT LED Strip component only supports the ESP-IDF framework; the light component under the Arduino framework is NeoPixelBus Light. Since version 2026.1.0, ESPHome's default framework will be ESP-IDF, it is recommended to choose ESP32 RMT LED Strip as the light component.
  • Because Unit NeoHEX is only individual lighting hardware, an additional main controller is required to integrate it into Home Assistant; due to design reasons, the driving capabilities of different main controllers are not completely consistent. For details, refer to Learn -> Drive Status

Configuration

  1. Using Atom EchoS

3R as the host, its signal line is GPIO2, the configuration example is as follows:

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
    ...
  1. For more light settings and effects, refer to: Light Effects
  2. Main reference component: ESP32 RMT LED Strip

Download and Burn Firmware

  1. After completing the configuration, download the firmware file.
  2. Burn the firmware to the main controller device.

Start Using

After completing the configuration and successfully uploading the program, find the light entity in the Home Assistant integration.

Note
When adjusting the light brightness to 100%, be careful of burns when touching the light during long-term operation; for the lifespan of the LEDs, it is not recommended to maintain maximum brightness for a long time.
On This Page