Lights - stodev-com-br/Tasmota GitHub Wiki
Lights come in various shapes (bulb, strips, ceiling lights, ...) but in Tasmota they are separated in 3 categories:
Lights in webUI
Tasmota' webUI displays only Brightness, CT, White or PWM level sliders depending on the light component, the number of PWM channels configured and SetOption used.
There are no RGB controls in the webUI. Use Color
commands instead.
The webUI doesn't have a color picker for RGB lights due to memory and flash size requirements to implement one.
See light commands for how to control lights.
Channel controlled LEDs
Lights controlled using up to 5 channels (red, green, blue, cold white, warm white). Channels are controlled using PWM or APDM.
PWM
PWM (Pulse Width Modulation) is the most common method of controlling LED lights.
These lights are configured by assigning PWM1(i)
through PWM5(i)
components to their GPIOs. Depending on the number of used PWMs Tasmota will recognize the light as
Channels | PWM1 | PWM2 | PWM3 | PWM4 | PWM5 |
---|---|---|---|---|---|
1 | Brightness | ||||
2 | Cold White | Warm White | |||
3 | Red | Green | Blue | ||
4 | Red | Green | Blue | White | |
5 | Red | Green | Blue | Cold White | Warm White |
If you require individual channel control (f.e. when connecting multiple single channel light strips to a multichannel LED controller) use SetOption68 1
to control each PWM individually with sliders in webUI and Channel<x>
commands.
For better color mixing of RGB and white channels read about [White-Blend-Mode](White Blend Mode).
MY92xx
MY92xx family of drivers uses Adaptive Pulse Density Modulation.
Configured in Tasmota by assigning MY92x1 DI
and MY92x DCKI
components to their GPIOs (some devices might have more than one MY92xx controller)
Channel mapping for such devices is dependent on the controllers but is easily remapped using SetOption37
.
SM16716
SM16716 LEDs, sometimes mislabelled as WS2801.
Configured in Tasmota by assigning SM16716 CLK
, SM16716 DAT
and SM16716 PWR
component to their GPIOs.
Some SM16716 bulbs have BGR order and need SetOption37 54
to work properly.
Addressable LEDs
Lights where each LED is individually controlled. In these lights it is possible to adjust each LEDs power, color and brightness, all just with the use of a single GPIO pin.
WebUI shows only the brightness slider and power toggle for these lights, all other controls are available with commands.
WS2812
Any light using WS2811, WS2812b, WS2813 or SK6812 LEDs falls into this component. They're also commonly called Neopixel lights.
Configured in Tasmota by assigning WS2812
component to its GPIO.
For wiring, see instructions for LED strip or Wemos RGB shield.
Status LEDs
Special subset of lights used to convey device status such as Wi-Fi and power. Read more...