跳转到内容
ESPHome - 智能家居，简单易用

FastLED 灯

WARNING

FastLED 在 ESP8266 的 Arduino 3 或更新版本下无法正常工作。目前，您可以降级 arduino 版本或使用 Neopixelbus。

esp8266:
  framework:
    version: 2.7.4

请参阅这些相关问题：

WARNING

FastLED 无法与 ESP-IDF 配合使用。

对于可寻址灯，您可以使用 Esp32 Rmt Led Strip，对于 SPI LED，请参见 Spi Led Strip。

无时钟

Section titled “无时钟”

fastled_clockless 灯光平台允许您在 ESPHome 中为多种支持的芯片组创建 RGB 灯。

无时钟 FastLED 灯与 SPI 的不同之处在于它们只有一根数据线需要连接，而不是分开的数据和时钟线。

# 配置示例
light:
  - platform: fastled_clockless
    chipset: WS2811
    pin: GPIOXX
    num_leds: 60
    rgb_order: BRG
    name: "FastLED WS2811 Light"

配置变量

Section titled “配置变量”

  • chipset (必需, 字符串): 设置要使用的芯片组。 有关选项，请参见支持的芯片组。

  • pin (必需, 引脚): FastLED 灯的数据线引脚。

  • num_leds (*必需, 整数): 连接的 LED 数量。

  • rgb_order (可选, 字符串): RGB 通道的顺序。如果您的灯似乎没有正确映射 RGB 灯通道，请使用此选项。例如，如果您通过前端设置红色但灯显示为绿色。有效值为 RGB、RBG、GRB、GBR、BRG 和 BGR。默认为 RGB。

  • max_refresh_rate (可选, 时间): 用于限制灯光每秒可处理的命令数量的时间间隔。例如，16ms 将限制灯光的刷新率约为 60Hz。默认为所用芯片组的默认值。

  • 所有其他选项来自灯光组件。

支持的芯片组

Section titled “支持的芯片组”
  • NEOPIXEL
  • WS2811
  • WS2811_400（WS2811，时钟率为 400kHz）
  • WS2812B
  • WS2812
  • WS2813
  • WS2852
  • APA104
  • APA106
  • GW6205
  • GW6205_400（GW6205，时钟率为 400kHz）
  • LPD1886
  • LPD1886_8BIT（LPD1886，8 位颜色通道值）
  • PL9823
  • SK6812
  • SK6822
  • TM1803
  • TM1804
  • TM1809
  • TM1829
  • UCS1903B
  • UCS1903
  • UCS1904
  • UCS2903
  • SM16703

SPI

Section titled “SPI”

fastled_spi 灯光平台允许您在 ESPHome 中为多种支持的芯片组创建 RGB 灯。

有关在 ESP-IDF（和 Arduino）上工作的替代组件，请参见 Spi Led Strip。

SPI FastLED 灯与无时钟的不同之处在于它们需要连接两个引脚，一个用于数据，一个用于时钟信号，而无时钟灯只需要一个引脚。

# 配置示例
light:
  - platform: fastled_spi
    chipset: WS2801
    data_pin: GPIOXX
    clock_pin: GPIOXX
    num_leds: 60
    rgb_order: BRG
    name: "FastLED SPI Light"

配置变量

Section titled “配置变量”

  • chipset (必需, 字符串): 设置要使用的芯片组。有关选项，请参见支持的芯片组。

  • data_pin (必需, 引脚): FastLED 灯的数据线引脚。

  • clock_pin (必需, 引脚): FastLED 灯的时钟线引脚。

  • num_leds (*必需, 整数): 连接的 LED 数量。

  • rgb_order (可选, 字符串): RGB 通道的顺序。如果您的灯似乎没有正确映射 RGB 灯通道，请使用此选项。例如，如果您通过前端设置红色但灯显示为绿色。有效值为 RGB、RBG、GRB、GBR、BRG 和 BGR。默认为 RGB。

  • max_refresh_rate (可选, 时间): 用于限制灯光每秒可处理的命令数量的时间间隔。例如，16ms 将限制灯光的刷新率约为 60Hz。默认为所用芯片组的默认值。

  • data_rate (可选, 频率): 用于向灯传输数据的数据速率。如果您的电缆很长或电平转换器较慢，可以帮助解决问题。

  • effects (可选, 列表): 用于此灯的灯光效果列表。

  • 所有其他选项来自灯光组件。

支持的芯片组

Section titled “支持的芯片组”
  • APA102
  • DOTSTAR
  • LPD8806
  • P9813
  • SK9822
  • SM16716
  • WS2801
  • WS2803

另见

Section titled “另见”