Midea Klimaanlage lokal in Home Assistant einbinden

Ich habe mir in letzter Zeit mal angeschaut, wie man Midea-Klimaanlagen komplett lokal in Home Assistant einbindet. Kein Cloud-Zwang, keine Abhängigkeit von Midea-Servern, direkte TCP-Verbindung ins lokale Netzwerk. Die HACS-Integration midea_ac_lan macht das möglich und funktioniert nicht nur mit Midea, sondern auch mit einer ganzen Reihe anderer Marken, die auf Mideas M-Smart-Plattform basieren. Ich zeige dir Schritt für Schritt, wie du das einrichtest, welche Entitäten du danach hast, warum du deinen Token jetzt sichern solltest und welche Automationen sich im Alltag wirklich bewähren.

Was du vorher brauchst

Ein paar Dinge sollten stehen, bevor du loslegst:

• Home Assistant 2024.4.1 oder neuer
• HACS installiert und eingerichtet
• Klimaanlage im gleichen Netzwerk wie Home Assistant
• eine statische IP für die Klimaanlage (DHCP-Reservation im Router)
• einen Midea-Account in der SmartHome oder MSmartHome App, den brauchst du nur einmalig für den Token

Die statische IP vergibst du nicht am Gerät selbst, sondern über eine DHCP-Reservation in deinem Router. Du suchst dort die MAC-Adresse deiner Klimaanlage raus und weist ihr dauerhaft eine feste IP zu. Ohne das kann die Integration nach einem Neustart die Verbindung verlieren, was im Alltag ziemlich nervig ist.

Den Midea-Account nutzt die Integration nur einmal, um sich einen Geräte-Token vom Cloud-Server zu holen. Danach läuft alles lokal, der Account wird nicht mehr gebraucht.

midea_ac_lan über HACS installieren

Die Installation läuft wie bei jeder anderen HACS-Integration:

1. In Home Assistant in der Seitenleiste auf HACS klicken
2. Oben rechts auf die drei Punkte, dann Benutzerdefinierte Repositories. Dort wuwentao/midea_ac_lan eintragen und als Kategorie Integration wählen
3. Nach Midea AC LAN suchen und auf Herunterladen klicken
4. Home Assistant neu starten, damit die Integration geladen wird

Wer lieber das Terminal nimmt, kann die Integration auch per Script installieren. Im Terminal-Add-on reicht ein Befehl:

wget -O - https://github.com/wuwentao/midea_ac_lan/raw/main/scripts/install.sh | ARCHIVE_TAG=latest bash -

Gerät hinzufügen und einrichten

Wenn Home Assistant neu gestartet ist, gehst du auf Einstellungen → Geräte & Dienste → Integration hinzufügen und suchst nach Midea AC LAN. Achte darauf, dass du die richtige auswählst, denn es gibt noch eine zweite Midea-Integration, die schon ab Werk in Home Assistant enthalten ist. Die brauchen wir hier nicht.

1. Erkennungsmethode wählen: Automatisch (empfohlen), Manuell oder Nur Auflisten
2. Midea-Account und Passwort eingeben, die Integration holt sich einmalig Token und Key vom Cloud-Server
3. Die erkannten Geräte werden aufgelistet, du wählst dein Gerät aus und bestätigst

Eine Sache noch: Die automatische Erkennung funktioniert nur, wenn Home Assistant und die Klimaanlage im gleichen Subnetz hängen. Wenn du mit VLANs arbeitest oder die Geräte in getrennten Netzen sind, nimmst du die manuelle Konfiguration und gibst die IP-Adresse direkt ein.

Welche Entitäten und Sensoren du bekommst

Sobald das Gerät eingebunden ist, legt die Integration eine ganze Reihe an Entitäten an. Die wichtigste ist die climate.*-Entität für die Hauptsteuerung. Je nach Modell kommen noch ein paar Sensoren und Schalter dazu:

Welche davon wirklich auftauchen, hängt vom Gerätemodell ab. Nicht jede Klimaanlage liefert alle Sensoren. Über die Optionen der Integration kannst du unter Extra Entities weitere Entitäten aktivieren, falls dir etwas fehlt. Die Lamellensteuerung steckt als Attribut swing_mode in der Climate-Entität, mit den Werten off, vertical, horizontal und both.

Bei den Modi der Climate-Entität hast du diese Optionen:

• cool: Kühlen
• heat: Heizen
• auto: Automatik, das Gerät entscheidet selbst
• dry: Entfeuchten
• fan_only: nur Ventilator, ohne die Temperatur zu ändern

Token sichern, am besten sofort

Das ist tatsächlich der wichtigste Punkt in dieser Anleitung, und ich sage das nicht übertrieben. Midea schließt nach und nach die Cloud-APIs, über die die Integration bisher Token für neue Geräte abrufen konnte. Die Meiju Cloud und die SmartHome Cloud sind bereits offline. Weitere Server werden folgen.

Solange du einen gültigen Token hast, läuft alles lokal weiter. Wenn du aber irgendwann Home Assistant neu aufsetzt oder die Integration entfernst und neu hinzufügst, kannst du dir keinen neuen Token mehr holen, sobald die APIs offline sind. Du bist dann draußen.

Die Tokens liegen in der internen HA-Datenbank unter .storage/core.config_entries. Der File Editor zeigt diesen Ordner nicht an. In Studio Code Server erreichst du die Datei, indem du den Pfad /homeassistant/.storage/core.config_entries direkt in die Adressleiste eingibst. Alternativ im Terminal-Add-on dieser Befehl, der nach midea_ac_lan sucht und die 15 Zeilen danach zeigt:

grep -A 15 midea_ac_lan /homeassistant/.storage/core.config_entries

In der Ausgabe suchst du nach "domain":"midea_ac_lan". Im "data"-Block findest du dann "token" und "key" als lange Hex-Strings. Beide Werte sichern, am besten auf einem USB-Stick, einem NAS oder einem anderen Gerät außerhalb von Home Assistant. Auch "device_id", "protocol" und "port" sind sinnvoll zu notieren, die brauchst du bei einer manuellen Neueinrichtung.

Danach läuft die Kommunikation rein lokal über TCP auf Port 6444. Ein vollständiges HA-Backup enthält den .storage/-Ordner automatisch. Wenn du also regelmäßige Backups machst, bist du auf der sicheren Seite. Trotzdem: einmal kurz kopieren und weglegen schadet nicht.

Drei Automationen zum Direkt-Kopieren

Ich habe dir drei Automationen mitgebracht, die ich selbst nutze oder zumindest für wahnsinnig sinnvoll halte. Die Entity-IDs musst du natürlich an deine eigenen Geräte anpassen.

Fenster auf, Klima aus. Wenn du ein Fenster öffnest, soll die Klimaanlage nicht weiterlaufen. Das löst ein einfacher Fensterkontakt:

1alias: "Klima aus bei offenem Fenster"
2triggers:
3  - trigger: state
4    entity_id: binary_sensor.fenster_wohnzimmer
5    to: "on"
6actions:
7  - action: climate.turn_off
8    target:
9      entity_id: climate.midea_ac_wohnzimmer

Du kannst die Automation natürlich erweitern und das Gerät wieder einschalten, sobald das Fenster zu ist. Das überlasse ich dir.

Nachtabsenkung per Zeitplan. Ab 22 Uhr wird die Zieltemperatur auf 25 Grad angehoben und der Lüfter auf die niedrigste Stufe gesetzt. Die Bedingung prüft vorher, ob die Anlage überhaupt im Kühlmodus läuft:

1alias: "Klima Nachtabsenkung"
2triggers:
3  - trigger: time
4    at: "22:00:00"
5conditions:
6  - condition: state
7    entity_id: climate.midea_ac_wohnzimmer
8    state: "cool"
9actions:
10  - action: climate.set_temperature
11    target:
12      entity_id: climate.midea_ac_wohnzimmer
13    data:
14      temperature: 25
15  - action: climate.set_fan_mode
16    target:
17      entity_id: climate.midea_ac_wohnzimmer
18    data:
19      fan_mode: "low"

Kühlung bei PV-Überschuss. Das ist für alle, die eine PV-Anlage oder ein Balkonkraftwerk zu Hause haben. Wenn du gerade mehr als 1000 Watt ins Netz einspeist und die Klimaanlage sowieso aus ist, kannst du den Strom auch direkt nutzen:

1alias: "Klima bei PV-Überschuss"
2triggers:
3  - trigger: numeric_state
4    entity_id: sensor.grid_export_power
5    above: 1000
6    for:
7      minutes: 5
8conditions:
9  - condition: state
10    entity_id: climate.midea_ac_wohnzimmer
11    state: "off"
12actions:
13  - action: climate.set_hvac_mode
14    target:
15      entity_id: climate.midea_ac_wohnzimmer
16    data:
17      hvac_mode: "cool"
18  - action: climate.set_temperature
19    target:
20      entity_id: climate.midea_ac_wohnzimmer
21    data:
22      temperature: 23

Du brauchst dafür einen Sensor, der dir die aktuell eingespeiste Leistung liefert. Den sensor.grid_export_power ersetzt du durch deine eigene Entität.

Dashboard-Card, nur wenn erreichbar

Ich habe mir die Klimaanlage aufs Dashboard gebaut, aber nur sichtbar wenn das Gerät auch wirklich verfügbar ist. Wenn ich die Anlage vom Strom nehme, will ich die Kachel nicht sehen. Das geht mit einer Conditional Card, die ihre innere Karte nur zeigt, solange der Zustand nicht unavailable ist.

Die Thermostat-Card sieht so aus:

1type: conditional
2conditions:
3  - condition: state
4    entity: climate.midea_ac_wohnzimmer
5    state_not: unavailable
6card:
7  type: thermostat
8  entity: climate.midea_ac_wohnzimmer
9  features:
10    - type: climate-hvac-modes
11      hvac_modes:
12        - cool
13        - heat
14        - auto
15        - fan_only
16        - off

Wer Mushroom Cards installiert hat, kann alternativ die Mushroom Climate Card nehmen. Die ist kompakter und zeigt Temperatur, Modus und Lüfterstufe auf einen Blick:

1type: conditional
2conditions:
3  - condition: state
4    entity: climate.midea_ac_wohnzimmer
5    state_not: unavailable
6card:
7  type: custom:mushroom-climate-card
8  entity: climate.midea_ac_wohnzimmer
9  show_temperature_control: true
10  hvac_modes:
11    - cool
12    - heat
13    - auto
14    - fan_only
15    - off
16  collapsible_controls: true

Falls du Mushroom noch nicht installiert hast, einfach in HACS nach Mushroom suchen und die Frontend-Integration herunterladen. Nach einem Browser-Reload sind die Cards direkt verfügbar.

Welche Marken und Geräte funktionieren

Midea AC LAN funktioniert mit allem, was auf Mideas M-Smart-Plattform basiert, und das sind überraschend viele Hersteller:

Gerade bei den mobilen Comfee-Geräten ist die Integration wahnsinnig verbreitet. Die vollständige Liste aller unterstützten Geräte findest du im Wiki der Integration auf GitHub. Dort steht auch, welche Entitäten und Funktionen es je nach Gerätetyp gibt. Bevor du loslegst, lohnt sich ein kurzer Blick dorthin.

Hast du schon eine Klimaanlage in Home Assistant eingebunden? Und wenn ja, welche Automationen hast du dir ausgedacht? Ich bin gespannt, was ihr da so treibt, schreibt es gerne unten in die Kommentare.