跳转到内容

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。

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

无时钟 FastLED 灯光与 SPI 不同,它们只有一根数据线需要连接,而没有单独的数据线和时钟线。

# 示例配置条目
light:
- platform: fastled_clockless
chipset: WS2811
pin: GPIOXX
num_leds: 60
rgb_order: BRG
name: "FastLED WS2811 Light"
  • chipset(必选,string):设置要使用的芯片组。 可选项请参见 受支持的芯片组。

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

  • num_leds(必选,int):连接的 LED 数量。

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

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

  • 来自 Light 的所有其他选项。

  • NEOPIXEL
  • WS2811
  • WS2811_400(时钟率为 400kHz 的 WS2811)
  • WS2812B
  • WS2812
  • WS2813
  • WS2852
  • APA104
  • APA106
  • GW6205
  • GW6205_400(时钟率为 400kHz 的 GW6205)
  • LPD1886
  • LPD1886_8BIT(8 位颜色通道值的 LPD1886)
  • PL9823
  • SK6812
  • SK6822
  • TM1803
  • TM1804
  • TM1809
  • TM1829
  • UCS1903B
  • UCS1903
  • UCS1904
  • UCS2903
  • SM16703

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"
  • chipset(必选,string):设置要使用的芯片组。可选项请参见 受支持的芯片组。

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

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

  • num_leds(必选,int):连接的 LED 数量。

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

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

  • data_rate(可选,frequency):用于将数据移位到灯光的数据速率。如果你的 线缆较长或电平转换器较慢,可能会有帮助。

  • effects(可选,list):一组用于此灯光的 灯光效果。

  • 来自 Light 的所有其他选项。

  • APA102
  • DOTSTAR
  • LPD8806
  • P9813
  • SK9822
  • SM16716
  • WS2801
  • WS2803