WetterCubePlus/WetterAmpel

English version

Die WetterAmpel ist ein eigenständiges WLAN-Zusatzgerät. Es fragt den WetterCubePlus ab und zeigt die Temperatur über drei WS2812B-LEDs als Ampel an. Die Firmware liegt unter WetterAmpel/WetterAmpel.ino.

LED	Bedeutung
Grün	Temperatur im grünen Bereich (Standard 15–19 °C)
Gelb	Temperatur im gelben Bereich (Standard 20–24 °C)
Rot	Temperatur im roten Bereich (Standard 25–99 °C)
alle blinken rot	DWD-Warnung aktiv, am Cube noch nicht bestätigt
kurzes weißes Blitzen	Abfrage des Cubes fehlgeschlagen (die letzte Farbe bleibt stehen)

Die Bereiche stellst du in der Web-Oberfläche des Cubes unter Ampel-Konfiguration ein.

Modi

Unter Ampel-Konfiguration → Was die Ampel anzeigt wählst du, was die LEDs bedeuten. Die Ampel selbst muss dafür nicht neu geflasht werden.

Modus	Grün	Gelb	Rot
Temperatur (Standard)	im grünen Bereich	im gelben Bereich	im roten Bereich
Pollen (meine Allergene)	keine bis geringe Belastung	mittlere bis hohe Belastung	starke Belastung
Luftqualität	europäischer AQI bis 40 (gut, mittel)	AQI bis 60 (mäßig)	AQI über 60 (schlecht oder schlechter)

Beim Modus Pollen zählt der schlimmste der unter Meine Allergene gewählten Pollen. Die DWD-Warnung lässt die Ampel in jedem Modus blinken. Fehlen die Daten, bleibt die Ampel aus. Die WebUI zeigt neben der Farbe, was sie ausgelöst hat (z. B. „Birke (Stufe 2.5 von 3)“).

Bauteile und Verdrahtung

Komponente	Typ
Mikrocontroller	ESP32-C3 (z. B. Super Mini), WLAN integriert
LEDs	3× WS2812B, in Reihe
Stromversorgung	5 V über USB

Funktion	Anschluss
WS2812B Daten (erste LED, DIN)	GPIO 8
WS2812B VCC	5 V
WS2812B GND	GND

Die LEDs sind als Kette verdrahtet (DIN → DOUT → DIN → …): LED 0 grün (unten), LED 1 gelb (mittig), LED 2 rot (oben). Empfohlen sind ein Widerstand von 300–470 Ω in der Datenleitung und ein 100-µF-Kondensator zwischen VCC und GND.

Firmware flashen

In WetterAmpel.ino oben im Konfigurationsblock WLAN-Name, Passwort und die IP des Cubes eintragen (WIFI_SSID, WIFI_PASSWORD, CUBE_HOST).
Mit der Arduino IDE auf den ESP32-C3 aufspielen (Bibliotheken: FastLED und ArduinoJson).

Wichtig: Die Zugangsdaten nur lokal eintragen und nie committen. Das Repository ist öffentlich; im Repo stehen bewusst nur Platzhalter (xxx).

Verhalten der Firmware

Fragt alle 30 Sekunden GET http://<CUBE_HOST>/api/ampel ab.
Ist das WLAN länger als 2 Minuten weg, startet die Ampel selbst neu (ein einfaches „Wiederverbinden“ blieb früher auf manchen Modulen hängen).
Zusätzlich startet sie vorsorglich alle 24 Stunden neu.

API des Cubes

GET /api/ampel liefert zum Beispiel:

{
  "temperature": 22.4,
  "data_age_min": 3,
  "dwd_warning": false,
  "active": "yellow",
  "mode": "temperature",
  "detail": "22.4 °C",
  "thresholds": {
    "green":  { "min": 15, "max": 19 },
    "yellow": { "min": 20, "max": 24 },
    "red":    { "min": 25, "max": 99 }
  }
}

mode ist temperature, pollen oder air, detail beschreibt die aktuelle Anzeige. data_age_min zeigt, wie alt der letzte erfolgreiche Wetterabruf ist. dwd_warning: true heißt: aktive DWD-Warnung, am Cube noch nicht durch Öffnen der Warnkarte bestätigt.