pdf-icon

Unit NeoHEX Home Assistant 集成

Unit NeoHEX 是一款六边形 RGB LED 灯板,内嵌 37 颗 RGB LED 全彩灯珠。使用单总线控制,支持多个灯板级联。

本篇文档将展示如何把 Unit NeoHEX 集成至 Home Assistant 中,主要参考:

提示
1. ESP32 RMT LED Strip 组件仅支持 ESP-IDF 框架; Arduino 框架下的 灯光组件为 NeoPixelBus Light。自 2026.1.0 版本后,ESPHome 默认框架将变为 ESP-IDF,建议选用 ESP32 RMT LED Strip 作为灯光组件。
2. 因为 Unit NeoHEX 只是单独的灯光硬件,需要额外的主控设备(如 Atom 系列、Stamp 系列,Stick 系列,Core/Basic 系列等)才能集成至 Home Assistant;由于设计原因,不同主控的驱动能力不完全一致,详情参考 操作说明 -> 驱动情况

配置灯光组件

譬如使用 Atom EchoS3R 作为主机,其信号线是GPIO2:

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

更多灯光设置和效果,可以参考

将灯光添加至 Home Assistant

完成配置并且成功上传程序后,可以在集成中找到灯光实体,以下是灯光面板的示例

注意
将灯光亮度调整至 100% 时,长时间工作接触灯光小心烫手; 为了灯珠寿命,不建议长时间保持最高亮度。
On This Page