Ziel der Lektion
Nach dieser Lektion kannst du:
- eine Split-Klimaanlage komplett lokal steuern (ohne Cloud, ohne Hersteller-App),
- prüfen, ob deine Anlage kompatibel ist (WiFi-Dongle/Port erkennen),
- den WLAN-Dongle durch eigene Hardware ersetzen (ESP + Level-Shifter),
- eine ESPHome-Firmware mit der Midea Climate Plattform bauen und flashen,
- typische Fehler (Flash-Mode, YAML-Speicherfehler, TX/RX vertauscht, Logging/BAUD) schnell lösen,
- und das Gerät als Thermostat-Kachel in Home Assistant nutzen (Heizen/Kühlen, Modus, Temperatur, Swing etc.).
1) Ausgangslage: Warum überhaupt Klimaanlage lokal steuern?
Dein Setup: Studio / ausgebautes Zimmer → keine einfache Anbindung an Zentralheizung ohne Umbau.
Lösung: Split-Klimaanlage (Innen- und Außengerät) – funktioniert super, aber:
- Standard: Hersteller-Dongle + Cloud + App
- Ziel: 0% Cloud, 0% App, volle Kontrolle in Home Assistant
2) Welche Klimaanlagen funktionieren?
Dieses Modul ist explizit für Anlagen, die einen Midea WiFi-Dongle haben, der oft aussieht wie ein kleiner USB-Stick (technisch nicht “USB-Standard”, aber Formfaktor ähnlich).
Quick-Check Kompatibilität
- Hast du so einen WiFi-Dongle? ✅ Dann stehen die Chancen sehr gut.
- Oben findest du die Links aus dem Forum.
- Im Gerät findest du meist:
- einen 4-Pin/mehrpoligen Port, manchmal als “USB-ähnlich” ausgeführt
- Es gibt einen langen Community-Thread mit Kompatibilitätsliste (nicht perfekt gepflegt, aber gute Basis).
Praxis-Hinweis von dir:
- Auch wenn die Marke vorne “deutsch” aussieht (Importeur), zählt oft der eigentliche OEM (z. B. Midea-Plattform dahinter).
3) Zwei Wege: “Günstig & schnell” vs “PCB-Profi”
Du zeigst beide Optionen, startest aber bewusst mit der einfachsten:
Option A: Günstig & schnell (für Einsteiger)
- fertige Module “zusammenstecken”
- Nachteil: größerer Formfaktor als der originale Dongle → passt nicht ganz so elegant rein, aber funktioniert.
Option B: High-End / PCB
- kleine Platine (bestellbar, idealer Formfaktor)
- entweder selbst löten oder fertig bestücken lassen
- kommt als eigenes Modul/Video später
4) Hardware-Teile in dieser Lektion (Minimal-Set)
A) “Kleiner ESP” (Dongle-Formfaktor)
Du nutzt ein sehr kompaktes ESP-Modul (vergleichbar ESP8266-Klasse), ohne USB-Port.
➡️ Das heißt: zum Flashen brauchst du einen USB-Seriell-Adapter.
B) USB-Seriell-Adapter (Flash-Adapter)
Es gibt mehrere Bauformen. Du nimmst eine Variante, bei der man das ESP-Modul direkt “aufstecken” kann (praktisch fürs Flashen).
C) Logic Level Shifter (3,3V → 5V)
Ganz zentral:
- ESP sendet UART-Signale mit 3,3V
- Klimaanlage erwartet UART-Signalpegel mit 5V
➡️ daher brauchst du einen Logic Level Shifter, der die Signale “hochhebt”.
5) ESPHome Projekt anlegen (der Teil, wo viele hängen bleiben)
Schritt 1 — Neues Gerät in ESPHome anlegen
Du legst das Gerät in ESPHome an (bei dir z. B. “Klima Atelier”).
Schritt 2 — Wichtig: Board-Definition korrekt setzen
Du betonst:
- Du musst diesmal die korrekte Board-/Pin-Definition eintragen (z. B. eine spezielle Board-ID/Variante)
- damit ESPHome weiß, welche Pins z. B. Reset / TX / RX / 3V3 sind
Schritt 3 — Der “fiese” Debug-Fehler: Logger Baudrate auf 0
Du hast lange gesucht, weil es kontraintuitiv ist:
Warum?
Der ESP nutzt für die Klimaanlage die gleichen RX/TX Pins, die du sonst fürs USB-Logging nimmst.
Wenn der Logger aktiv ist, funkt er dir in die Kommunikation rein.
➡️ Lösung:
- Logger Baudrate auf 0 (deaktiviert serielles Logging)
Wichtiges Debug-Pattern:
- Wenn’s gar nicht geht: erst Logger deaktivieren (Baudrate 0)
- Wenn du debuggen musst: temporär Logger wieder aktivieren (via
# auskommentieren / aktivieren), neu flashen, wieder zurück
Du erklärst das sehr praxisnah:
- USB-Logs sind dann leer (klar)
- dafür kannst du später “WiFi-Logs” anschauen (OTA/Remote Logs)
6) Klima-Plattform in ESPHome: Midea Climate
Du nutzt die ESPHome Midea Climate Integration und findest sie so stark, weil:
- Home Assistant bekommt direkt ein vollwertiges Climate-Gerät
- Funktionen wie Fernbedienung: Modus, Solltemperatur, Swing etc. sind sauber integriert
Konfig-Strategie
Du empfiehlst:
- erstmal “maximal” konfigurieren (alles rein, was möglich ist)
- dann später ausmisten, wenn dein Gerät z. B. keinen bestimmten Modus kann
Und du zeigst den Weg:
- In ESPHome auf die Dokumentation klicken → dort siehst du alle Optionen (Swing vertical/horizontal, Modes, Limits etc.)
7) Typischer ESPHome-Editor-Fehler: Speichern klappt nicht
Du zeigst eine realistische “Hard-Reality”:
- YAML speichert nicht, Fehler taucht auf
Fix-Weg aus deinem Video
- entweder Device neu anlegen
- oder in ESPHome “Clean Build Files” / “Clear Build Files” nutzen
Danach speichern → funktioniert.
8) Flashen: Gerät in Flash-Mode bringen
Weil das ein kleiner Dongle-ESP ist, muss er manuell in den Boot/Flash-Modus.
Du nennst typische Varianten:
- Knopf drücken → einstecken → loslassen
- oder halten → einstecken → loslassen
Je nach Board leicht unterschiedlich.
Wenn’s nicht sofort klappt:
- verschiedene Reihenfolgen ausprobieren (kurz, pragmatisch)
- sobald gekoppelt: Installieren → Factory.bin flashen
9) Warum du nach dem Flash keine USB-Logs siehst (und warum das ok ist)
Du erklärst:
- USB-Logs fehlen, weil Baudrate 0
- dafür kannst du Logs über WiFi ansehen (OTA logs / remote logs)
Im Log siehst du ggf. erstmal sowas wie:
- “Trying to connect…”
- “send…” aber noch keine sinnvollen Antworten
Das ist normal, weil die Klimaanlage noch nicht verdrahtet ist.
10) Verkabelung zur Klimaanlage: Port, Spannung prüfen, TX/RX
Schritt 1 — Klimaanlagen-Port finden
- Abdeckung aufschrauben
- dort sitzt normalerweise der Dongle-Port (USB-ähnlich / 4-Pin)
- du steckst deinen Adapter an
Schritt 2 — Spannung messen (sehr wichtiger Reality-Check)
Du empfiehlst:
- Multimeter nehmen, Spannung am Port messen
- bei dir: 4,99V → also 5V-System
Wichtiger Hinweis:
- Manche Geräte arbeiten wohl mit 12V (seltener)
➡️ daher: immer messen, nicht raten.
Schritt 3 — UART Leitungen korrekt
Wenn keine Daten kommen:
- TX/RX vertauscht ist DER Klassiker
Du sagst: wenn du keine States/keine “Good news” siehst → TX/RX tauschen.
Schritt 4 — Level-Shifter richtig einsetzen
- ESP 3,3V UART → Level-Shifter → 5V UART Richtung Klimaanlage
- Ohne Level-Shifter kann es sein: sendet, aber versteht nix.
11) “Jackpot-Log”: Woran du erkennst, dass es funktioniert
Du beschreibst sinngemäß:
- wenn im Log ein neuer State / Rückmeldung erscheint (“New state …”)
→ dann hast du wirklich gesendet und empfangen.
Und dein Profi-Move:
- Wenn unklar: Log hier rein kopieren, analysieren lassen (weil die Rohmeldungen oft wenig intuitiv sind).
12) Home Assistant Integration: Thermostat-Kachel
Sobald das Device online ist:
- Einstellungen → Geräte & Dienste → ESPHome → Gerät
- Klimagerät hinzufügen → Dashboard
Du zeigst:
- kleine Kachel + besser: Thermostat-Kachel (groß)
Dann in der Praxis:
- Einschalten → Anlage piepst
- Modus wählen (z. B. Heizen)
- Solltemperatur setzen (z. B. 23°C)
- nach ~1 Sekunde kommt’s an → läuft
13) Was du damit später automatisieren kannst (Ausblick)
Beispiele aus deinem Alltag:
- PV-Überschuss → Klimaanlage zum Kühlen/Heizen nutzen
- Automationen je nach Temperatur/Feuchte/Anwesenheit
- “Wenn stottert / komisch verhält” → Monitoring & Regeln
Troubleshooting-Checkliste (die 90% der Probleme löst)
A) Keine Daten / keine Rückmeldung
- TX/RX tauschen
- Level-Shifter drin?
- Spannung am Port wirklich 5V oder 12V?
B) USB-Logs leer
- Erwartet: Logger Baudrate = 0
- Logs über WiFi ansehen
- Zum Debuggen Logger kurz wieder aktivieren (temporär)
C) Flash-Mode klappt nicht
- Knopf-Sequenz variieren: drücken/halten + einstecken + loslassen
D) ESPHome speichert nicht / Build spinnt
- “Clean/Clear Build Files”
- notfalls neues Device anlegen