Midea Portasplit in Home Assistant einbinden

Die Midea Portasplit ist eine der spannendsten mobilen Klimaanlagen der letzten Jahre, weil sie technisch wie eine waschechte Split-Klimaanlage funktioniert – nur ohne aufwendige Montage. Wenn Du sie zusätzlich in Home Assistant einbindest, bekommst Du Zugriff auf Automationen, Energie-Statistiken und Funktionen, die die offizielle Midea-App gar nicht erst anbietet. In dieser Anleitung zeige ich Dir Schritt für Schritt, wie die Integration gelingt.

Warum die Portasplit überhaupt in Home Assistant einbinden?

Die Midea-App reicht für den Alltag, stößt aber schnell an Grenzen, sobald Du die Portasplit mit anderen Geräten kombinieren willst. Über Home Assistant kannst Du die Klimaanlage zum Beispiel automatisch starten, sobald ein Fenstersensor meldet, dass alle Fenster geschlossen sind, oder die Zieltemperatur an einen externen Temperatursensor koppeln, statt Dich auf den internen Fühler des Geräts zu verlassen. Auch Energieverbrauchsdaten landen so direkt in Deinen bestehenden Dashboards statt in einer separaten Herstelleroberfläche, und Sprachsteuerung über Assistenten wird deutlich flexibler, weil Du selbst festlegst, welche Funktionen freigegeben werden.

Welche Integration Du für die Portasplit brauchst

Für die Einbindung der Portasplit hat sich die Community-Integration „Midea Smart AC“ (bekannt unter dem Projektnamen midea-ac-py, gepflegt im Fork von mill1000) als zuverlässigste Lösung etabliert. Sie steuert das Gerät lokal über Dein Netzwerk, arbeitet also auch bei Internetausfall weiter, und wird aktuell aktiv weiterentwickelt – inklusive spezifischer Portasplit-Funktionen wie dem „Out Silent Mode“ für die Außeneinheit. Ältere Integrationen wie die ursprüngliche Midea-AC-LAN-Variante gelten in der Community mittlerweile als überholt und fehleranfälliger.

Voraussetzungen

Home Assistant ist installiert und läuft (Home Assistant OS, Container oder Core)
HACS ist eingerichtet, da die Integration darüber installiert wird
Die Portasplit hängt im selben WLAN wie Dein Home-Assistant-Server
Die Portasplit ist bereits einmal über die Midea-App in Betrieb genommen worden (WLAN-Einrichtung abgeschlossen)

Schritt 1: Integration über HACS installieren

Öffne HACS in Home Assistant, wähle „Integrationen“ und suche dort nach „Midea Smart AC“. Alternativ findest Du das Projekt auch direkt auf GitHub, falls Du die Dateien lieber manuell in Dein custom_components-Verzeichnis kopieren möchtest. Nach der Installation über HACS musst Du Home Assistant einmal neu starten, damit die Integration geladen wird.

Schritt 2: Gerät hinzufügen

Gehe anschließend zu Einstellungen > Geräte & Dienste > Integration hinzufügen und suche nach „Midea Smart AC“. Home Assistant bietet Dir jetzt zwei Wege an:

Automatische Erkennung („Discover devices“): Lässt Du das Eingabefeld leer, durchsucht Home Assistant Dein gesamtes Netzwerk nach kompatiblen Geräten. Alternativ trägst Du die IP-Adresse der Portasplit direkt ein, falls die automatische Suche nichts findet.
Manuelle Konfiguration: Hier gibst Du Geräte-ID, IP-Adresse und Port selbst ein.

Ein wichtiger Punkt bei der Portasplit: Sie zählt technisch zu den neueren „V3“-Geräten. Das bedeutet, dass beim erstmaligen Einrichten kurz die Midea-Cloud kontaktiert wird, um Token und Schlüssel für die spätere lokale Steuerung abzurufen. Diese Werte werden danach dauerhaft gespeichert – für den täglichen Betrieb ist anschließend keine Internetverbindung mehr nötig. Falls die automatische Einrichtung mit Deiner Standard-Cloud-Region nicht klappt, probier in den Einstellungen die jeweils andere Region aus.

Schritt 3: Manuelle Konfiguration, falls nötig

Findet Home Assistant die Portasplit nicht automatisch, kannst Du Geräte-ID, Token und Schlüssel auch manuell ermitteln. Dafür installierst Du auf einem Rechner mit Python das Tool msmart-ng:

pip install msmart-ng
msmart-ng discover

Der Befehl listet alle gefundenen Midea-Geräte im Netzwerk auf. Achte darauf, dass bei Deiner Portasplit als Typ 0xAC angezeigt wird und die Eigenschaft supported auf „True“ steht. Die ausgegebene Geräte-ID, der Token (128 Zeichen) und der Schlüssel (64 Zeichen) trägst Du dann im manuellen Konfigurationsdialog von Home Assistant ein.

Welche Funktionen Dir zur Verfügung stehen

Nach erfolgreicher Einrichtung legt die Integration ein Klima-Entity an, über das Du Modus, Zieltemperatur und Lüfterstufe steuerst. Je nachdem, welche Fähigkeiten Deine Portasplit meldet, kommen automatisch weitere Entitäten hinzu:

Umgebungslicht-Anzeige (Display) als eigener Schalter
Presets für Sleep, Eco, Boost/Turbo und Frostschutz (Away)
Der bei der Portasplit besonders gefragte „Out Silent Mode“, der die Außeneinheit deutlich leiser laufen lässt – praktisch, wenn Nachbarn oder das Schlafzimmer in Hörweite liegen
Schwenkwinkel-Steuerung (Swing) und Luftfeuchtigkeitssensor, sofern unterstützt
Optionale Energie- und Leistungssensoren, die Du auf der Geräteseite manuell aktivieren kannst

Über die Integrationsoptionen lässt sich zusätzlich die Temperaturschrittweite anpassen, ein Signalton bei Änderungen deaktivieren oder die maximale Verbindungsdauer begrenzen.

Troubleshooting: Gerät wird „nicht verfügbar“

Ein bekanntes Problem bei einigen Midea-Geräten: Die Verbindung wird nach einiger Zeit vom Gerät selbst getrennt, was in den Logs zu Fehlermeldungen und einem kurzzeitigen „nicht verfügbar“-Status führt. Abhilfe schafft meist, in den Integrationsoptionen die „Maximum Connection Lifetime“ auf einen Wert von etwa 90 Sekunden zu setzen – dann baut die Integration die Verbindung proaktiv neu auf, bevor das Gerät selbst abbricht.

Automatisierungsideen für Deine Portasplit

Sobald das Klima-Entity in Home Assistant existiert, lassen sich damit Automationen bauen, die mit der Herstelleroberfläche allein nicht möglich sind. Ein paar Beispiele, die sich in der Praxis bewährt haben:

Die Portasplit schaltet automatisch in den Eco-Modus, sobald niemand mehr zu Hause ist (Kopplung an Anwesenheitserkennung)
Der „Out Silent Mode“ wird abends automatisch aktiviert, damit die Außeneinheit nachts leiser läuft
Push-Benachrichtigung, falls das Gerät einen Fehlercode meldet oder der Filter gereinigt werden muss
Kopplung mit einem Fenstersensor, damit die Anlage pausiert, sobald ein Fenster geöffnet wird

Häufige Fragen zur Portasplit-Integration

Funktioniert die Steuerung auch ohne Internetverbindung?
Ja, nach der einmaligen Einrichtung läuft die Kommunikation zwischen Home Assistant und der Portasplit rein lokal über Dein Netzwerk. Die Cloud wird nur beim erstmaligen Abrufen von Token und Schlüssel benötigt.

Kann ich die Midea-App parallel weiter nutzen?
Grundsätzlich ja, allerdings kann es in seltenen Fällen zu kurzzeitigen Verbindungskonflikten kommen, wenn App und Home Assistant gleichzeitig auf das Gerät zugreifen. Im Alltag berichten die meisten Nutzer aber von einem stabilen Parallelbetrieb.

Was mache ich, wenn Home Assistant die Portasplit nicht findet?
Prüfe zunächst, ob sich beide Geräte im selben Subnetz befinden, und probiere alternativ die manuelle Konfiguration mit Geräte-ID, Token und Schlüssel über msmart-ng aus. Bei V3-Geräten hilft es manchmal auch, testweise die andere Cloud-Region auszuwählen.

Fazit

Mit der Midea-Smart-AC-Integration holst Du aus Deiner Portasplit deutlich mehr heraus, als es die Hersteller-App erlaubt: lokale Steuerung ohne Cloud-Zwang im Alltag, Automationen mit anderen Smart-Home-Geräten und Zugriff auf Spezialfunktionen wie den Out Silent Mode. Wer noch unschlüssig ist, ob die Portasplit die richtige Klimalösung ist, findet in unserem ausführlichen Portasplit-Test weitere Details zu Leistung und Praxistauglichkeit. Und wer sein Smart Home ohnehin gerade ausbaut, wirft am besten auch einen Blick auf unsere Matter-Einrichtung für Android, um Geräte verschiedener Hersteller sauber zusammenzuführen.

Letzte Aktualisierung am 19. Juli 2026