Aktor · Licht

LED, schaltbar und dimmbar

Eine LED an- und ausschalten und dann stufenlos dimmen – das „Hello World“ der Aktoren.

Steckbrett^? GPIO · PWM 3,3 Vca. 0,10 €

Was man sieht: Die LED geht per Klick in der App an, danach fährt ein Schieberegler die Helligkeit hoch und runter.

Was man lernt: Den Unterschied zwischen Digitalausgang und PWM, und wie ESPHome den Ausgang („output“) von der Bedienoberfläche („light“) trennt.

Anschluss

GPIO über einen Vorwiderstand (220 bis 330 Ohm) an die Anode (langes Bein), Kathode an GND. Rote, gelbe und grüne LEDs leuchten mit 3,3 V problemlos.

Zwei Stufen

Nur an und aus: switch: - platform: gpio mit dem Pin. Fertig, in Home Assistant erscheint ein Schalter.

Dimmbar: Der Pin wird zu einem output mit PWM (ledc auf dem ESP32, esp8266_pwm auf dem ESP8266), und ein light: - platform: monochromatic bedient diesen Ausgang. Diese Trennung zwischen Ausgang und Bedienelement zieht sich durch ganz ESPHome, deshalb lohnt es sich, sie hier zu verstehen.

Der ledc-Ausgang arbeitet standardmäßig mit 1 kHz. Höhere Frequenzen gehen, kosten aber Auflösung.

Minimal-YAML

# ESP32: dimmbar per PWM (auf dem ESP8266 statt ledc: esp8266_pwm)
output:
  - platform: ledc
    pin: GPIO5
    id: led_pwm

light:
  - platform: monochromatic
    name: "Dimmbare LED"
    output: led_pwm

Nach der ESPHome-Doku: https://esphome.io/components/light/monochromatic/

Fallen

Ohne Vorwiderstand (220 bis 330 Ohm) stirbt die LED.
Ein GPIO liefert nur etwa 12 mA (ESP8266) bis 40 mA (ESP32). Keine Leistungs-LEDs direkt anschließen.
Auf dem ESP8266 ist PWM Software, bei viel WLAN-Verkehr flackert es leicht.

ESPHome-Komponenten

Typische Projekte

Statusanzeige · Nachtlicht · Atem-Effekt · Ampel mit drei LEDs · Einstieg in PWM für Servo und Buzzer