FastLED SPI Light

The fastled_spi light platform allows you to create RGB lights in esphomelib for a number of supported chipsets.

SPI FastLED lights differ from the FastLED Clockless Light in that they require two pins to be connected, one for a data and one for a clock signal whereas the clockless lights only need a single pin.

../../../_images/fastled_spi-ui.png
# Example configuration entry
light:
  - platform: fastled_spi
    chipset: WS2801
    data_pin: GPIO23
    clock_pin: GPIO22
    num_leds: 60
    rgb_order: BRG
    name: "FastLED SPI Light"

Configuration variables:

  • name (Required, string): The name of the light.
  • chipset (Required, string): Set a chipset to use. See Supported Chipsets for options.
  • data_pin (Required, Pin): The pin for the data line of the FastLED light.
  • clock_pin (Required, Pin): The pin for the clock line of the FastLED light.
  • num_leds (Required, int): The number of LEDs attached.
  • rgb_order (Optional, string): The order of the RGB channels. Use this if your light doesn’t seem to map the RGB light channels correctly. For example if your light shows up green when you set a red color through the frontend. Valid values are RGB, RBG, GRB, GBR, BRG and BGR. Defaults to RGB.
  • max_refresh_rate (Optional, Time): A time interval used to limit the number of commands a light can handle per second. For example 16ms will limit the light to a refresh rate of about 60Hz. Defaults to the default value for the used chipset.
  • gamma_correct (Optional, float): The gamma correction factor for the light. Defaults to 2.8.
  • color_correct (Optional, list of percentages): The color correction for each channel. This denotes the maximum brightness of the red, green and blue channel. Defaults to color_correct: [100%, 100%, 100%].
  • default_transition_length (Optional, Time): The length of the transition if no transition parameter is provided by Home Assistant. Defaults to 1s.
  • power_supply (Optional, ID): The Power Supply Component to connect to this light. When the light is turned on, the power supply will automatically be switched on too.
  • effects (Optional, list): A list of light effects to use for this light.
  • id (Optional, ID): Manually specify the ID used for code generation.
  • All other options from MQTT Component.

Supported Chipsets

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