Unit NeoHEX Home Assistant 集成

本章节介绍如何将 Unit NeoHEX 集成至 Home Assistant。

准备工作

• Unit NeoHEX 六边形 RGB LED 灯板
• 适配主控设备（Atom 系列、Stamp 系列、Stick 系列、Core/Basic 系列等）

注意事项

• ESP32 RMT LED Strip 组件仅支持 ESP-IDF 框架； Arduino 框架下的灯光组件为 NeoPixelBus Light。自 2026.1.0 版本后，ESPHome 默认框架将变为 ESP-IDF，建议选用 ESP32 RMT LED Strip 作为灯光组件。
• 因为 Unit NeoHEX 只是单独的灯光硬件，需要额外的主控设备才能集成至 Home Assistant；由于设计原因，不同主控的驱动能力不完全一致，详情参考 操作说明 -> 驱动情况

修改配置

1. 以 Atom EchoS3R 作为主机，其信号线是GPIO2，配置示例如下：

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
    ...

2. 更多灯光设置和效果可参考：Light Effects
3. 主要参考组件：ESP32 RMT LED Strip

下载和烧录固件

1. 完成配置后下载固件文件。
2. 将固件烧录至主控设备。

开始使用

完成配置并且成功上传程序后，在 Home Assistant 集成中找到灯光实体。