跳转到内容

SPI LED 灯带

spi_led_strip 灯光平台驱动一个或多个 SPI 接口的 RGB LED。这些 LED 通常用于灯带，其中每个 LED 都可以单独寻址。此组件需要配置 SPI 接口。

此组件已使用 APA102 LED 和 P9813 LED 驱动器进行测试。它也应该适用于 HD107 和 SK9822 类型的 LED，或任何其他具有类似接口的 LED —— SPI、每种颜色 8 位、BGR 顺序。

# 配置示例
spi:
  mosi_pin: GPIO06
  clk_pin: GPIO07

light:
  - platform: spi_led_strip
    num_leds: 30
    id: rgb_led
    name: "RGB LED Strip"
    data_rate: 1MHz

颜色校正

校准/校正 LED 灯带产生的颜色通常是有利的，因为不同颜色的感知强度通常会有所不同。这可以通过使用 color_correct 来调整 RGB 组件的相对亮度来实现。

配置变量

num_leds (可选, 整数): 连接的 LED 数量。默认为 1。
data_rate (可选): 设置显示器的 SPI 接口数据速率。可选值为 80MHz、40MHz、20MHz、10MHz、5MHz、2MHz、1MHz（默认）、200kHz、75kHz 或 1kHz。
所有其他选项来自灯光组件。

根据您的硬件，您可能还需要配置一个 output GPIO 引脚来控制 LED 的电源。APA102 及其同类产品没有 CS 输入，并且是只写的，因此不应指定 SPI miso 引脚。

另见