Diese Dokumentation beschreibt immer die neueste Version des Moduls, aktuell 1.0.3 im Kanal Beta.
Midea
Steuert eine Midea Klimaanlage (0xAC) oder einen Midea Entfeuchter (0xA1) direkt per LAN.
Ältere Geräte werden per Protokoll V2 ohne Token angesprochen, neuere Geräte per Protokoll V3 mit Token und Key.
Die Cloud wird ausschließlich zur einmaligen Token-Ermittlung genutzt – danach kommuniziert das Modul vollständig lokal.
Inhaltsverzeichnis
- Midea
1. Voraussetzungen
- mindestens IP-Symcon 9.0
- PHP-Erweiterung GMP (für präzise Berechnung großer Geräte-IDs)
- Midea Klimaanlage oder Midea Entfeuchter im lokalen Netzwerk
- Feste IP-Adresse des Geräts (DHCP-Reservierung im Router empfohlen)
2. Konfiguration
Grundeinstellungen
| Einstellung | Beschreibung |
|---|---|
| Gerätetyp | Klimaanlage (0xAC) oder Entfeuchter (0xA1). Das Formular zeigt nur die manuelle Konfiguration des gewählten Typs und schaltet beim Umstellen sofort um. |
| IP-Adresse | Lokale IP-Adresse des Geräts |
| TCP-Port | Standard: 6444 |
| Aktualisierungsintervall | Abfrageintervall in Sekunden (0 = deaktiviert) |
Protokoll V3 (Token / Key)
Nur für neuere Geräte mit V3-Firmware erforderlich. Bei älteren Geräten (V2) alle Felder leer lassen.
| Einstellung | Beschreibung |
|---|---|
| Token (Hex) | Authentifizierungstoken, hexadezimal |
| Key (Hex) | Sitzungsschlüssel, hexadezimal |
| Appliance ID | Numerische Geräte-ID aus der Midea-Cloud (bei V2 nicht erforderlich) |
| Seriennummer | Nur zur Anzeige, wird automatisch befüllt |
Tipp: Ob ein Gerät V2 oder V3 nutzt lässt sich einfach testen: Token-Felder leer lassen und „Jetzt aktualisieren" klicken. Kommt eine Antwort → V2. Keine Antwort → V3 mit Token erforderlich.
Manuelle Konfiguration (Klimaanlage)
Da nicht alle Geräteeigenschaften per B5-Abfrage zuverlässig erkannt werden, können sie hier manuell gesteuert werden. Nach dem ersten „Capabilities ermitteln" werden die Checkboxen automatisch aus dem B5-Ergebnis vorbelegt und können danach manuell angepasst werden.
Verfügbare Modi
Nicht unterstützte Betriebsmodi können hier deaktiviert werden. Der Modus-Auswahl in IPS enthält dann nur die aktivierten Modi.
| Checkbox | Beschreibung |
|---|---|
| Auto (1) | Automatik-Modus |
| Kühlen (2) | Kühlbetrieb |
| Trocknen (3) | Entfeuchtungsbetrieb |
| Heizen (4) | Heizbetrieb |
| Lüften (5) | Nur Lüfterbetrieb ohne Wärmetausch |
Lüfterstufen
| Checkbox | Beschreibung |
|---|---|
| Leise (20) verfügbar | Lüfterstufe „Leise" einblenden (Standard: deaktiviert) |
| Mittel (60) verfügbar | Lüfterstufe „Mittel" einblenden (Standard: aktiviert) |
Zusatzfunktionen
| Checkbox | Variable | Beschreibung |
|---|---|---|
| Vertikale Lamellen | VerticalSwing | Lamellensteuerung vertikal |
| Horizontale Lamellen | HorizontalSwing | Lamellensteuerung horizontal |
| Eco-Modus | EcoMode | Energiespar-Modus |
| Turbo | Turbo | Turbo-/Boost-Modus |
| Luftreiniger | Purifier | Ionisations-/Luftreinigungsfunktion |
| Trockner | Dryer | No-Frost-Lüfter-Funktion |
| Frostschutz | FrostProtect | 8°C-Heizbetrieb |
| Display-Steuerung | ShowScreen | Display ein/aus |
| Innenfeuchte-Sensor | IndoorHumidity | Luftfeuchtigkeit innen |
| Leistungsmessung | CurrentPower | Stromverbrauch in Watt |
Hinweis: Solange noch keine Capabilities ermittelt wurden, werden alle optionalen Variablen angezeigt. Nach dem ersten „Capabilities ermitteln" steuern ausschließlich die Checkboxen, welche Variablen registriert werden.
Manuelle Konfiguration (Entfeuchter)
„Capabilities ermitteln" belegt diese Checkboxen aus der Meldung des Geräts vor. Manche Geräte melden Funktionen, die sie gar nicht haben, deshalb lassen sie sich danach von Hand ändern. Ab Werk ist alles aktiviert.
| Checkbox | Wirkung |
|---|---|
| Smart (3), Trocknen (4), Luftreinigung (6), Schimmelschutz (7) | Modus in der Auswahl. Soll-Feuchte (1) und Dauerbetrieb (2) gibt es immer |
| Lüfterstufe Mittel (60) verfügbar | Mittel in der Auswahl. Niedrig (40) und Hoch (80) gibt es immer |
| Ionisator vorhanden | Variable IonMode |
| Pumpe vorhanden | Variable Pump |
| Lüftungslamellen vorhanden | Variable VerticalSwing |
| Füllstandssensor vorhanden | Variable TankLevel |
| Filteranzeige vorhanden | Variable FilterIndicator |
| Schlafmodus vorhanden | Variable SleepMode. Das Gerät meldet den Schlafmodus nicht, „Capabilities ermitteln“ lässt diese Checkbox deshalb unverändert. Manche Geräte (z. B. Comfee 0xA1) reagieren nicht darauf, dann den Haken entfernen |
Token automatisch ermitteln (Cloud-Login)
Die Cloud-Zugangsdaten werden ausschließlich einmalig zur Token-Ermittlung genutzt. Danach kommuniziert das Modul rein lokal.
| Einstellung | Beschreibung |
|---|---|
| App | SmartHome (Standard, empfohlen), NetHome Plus, NetHome Plus (EU), Midea Air, Midea Air (EU) oder Ariston Clima |
| E-Mail-Adresse | Benutzername des Midea-Cloud-Accounts |
| Passwort | Passwort des Midea-Cloud-Accounts |
3. Token automatisch ermitteln
Schritt 1 – ApplianceID ermitteln
- Cloud-Zugangsdaten eintragen
- Schaltfläche „1. ApplianceID ermitteln" klicken
- Bei einem einzigen Gerät im Account wird die ApplianceID automatisch gesetzt
- Bei mehreren Geräten die korrekte ID manuell in das Feld Appliance ID eintragen
Schritt 2 – Token ermitteln
- Schaltfläche „2. Token ermitteln" klicken
- Das Modul fragt die Cloud ab und testet den Token direkt gegen das Gerät
- Bei Erfolg werden Token und Key automatisch gespeichert
- Im Anschluss wird „Capabilities ermitteln" automatisch ausgeführt und die Checkboxen werden vorbelegt
4. Variablen
Klimaanlage – Basisvariablen
Immer vorhanden, unabhängig von Capabilities und Checkboxen.
| Ident | Bezeichnung | Typ | Steuerbar |
|---|---|---|---|
Running | Betrieb | Boolean | ✅ |
Mode | Modus | Integer | ✅ (nur aktivierte Modi, siehe Manuelle Konfiguration) |
TargetTemperature | Soll-Temperatur | Float | ✅ (16,0 – 31,0 °C) |
IndoorTemperature | Innentemperatur | Float | ❌ |
OutdoorTemperature | Außentemperatur | Float | ❌ |
ErrorCode | Fehlercode | Integer | ❌ |
Klimaanlage – Optionale Variablen
Werden nur angelegt wenn die jeweilige Checkbox in der Konfiguration aktiviert ist.
Nach „Capabilities ermitteln" werden die Checkboxen automatisch aus dem B5-Ergebnis vorbelegt.
| Ident | Bezeichnung | Typ | Steuerbar |
|---|---|---|---|
FanSpeed | Lüfterstufe | Integer | ✅ (20=Leise¹, 40=Niedrig, 60=Mittel¹, 80=Hoch, 102=Auto, 127=Voll) |
VerticalSwing | Vertikale Lamellen | Integer | ✅ (0=Aus, 1–3=Stufe) |
HorizontalSwing | Horizontale Lamellen | Integer | ✅ (0=Aus, 1–3=Stufe) |
EcoMode | Eco-Modus | Boolean | ✅ |
Turbo | Turbo | Boolean | ✅ |
Purifier | Luftreiniger | Boolean | ✅ |
Dryer | Trockner | Boolean | ✅ |
FrostProtect | Frostschutz | Boolean | ✅ |
ShowScreen | Display | Boolean | ✅ |
IndoorHumidity | Innenfeuchte | Float | ❌ |
CurrentPower | Leistung | Float | ❌ |
¹ Leise (20) und Mittel (60) sind per Checkbox manuell aktivierbar.
Entfeuchter
| Ident | Bezeichnung | Typ | Steuerbar |
|---|---|---|---|
Running | Betrieb | Boolean | ✅ |
Mode | Modus | Integer | ✅ (1=Soll-Feuchte, 2=Dauerbetrieb, 3=Smart, 4=Trocknen, 6=Luftreinigung, 7=Schimmelschutz) |
FanSpeed | Lüfterstufe | Integer | ✅ (40=Niedrig, 60=Mittel, 80=Hoch) |
TargetHumidity | Soll-Feuchte | Integer | ✅ (35 – 85 %, andere Werte werden begrenzt) |
CurrentHumidity | Ist-Feuchte | Float | ❌ |
IndoorTemperature | Raumtemperatur | Float | ❌ |
IonMode | Ionisierung² | Boolean | ✅ |
Pump | Pumpe² | Boolean | ✅ |
SleepMode | Schlafmodus² | Boolean | ✅ |
VerticalSwing | Lüftungslamellen² | Boolean | ✅ |
TankFull | Tank voll | Boolean | ❌ |
TankLevel | Tankfüllstand² | Integer | ❌ |
FilterIndicator | Filter reinigen² | Boolean | ❌ |
Defrosting | Abtauen | Boolean | ❌ |
ErrorCode | Fehlercode | Integer | ❌ |
Welche Modi und Lüfterstufen zur Auswahl stehen, steuert die manuelle Konfiguration (Entfeuchter).
² Nur vorhanden, wenn die passende Checkbox in der manuellen Konfiguration (Entfeuchter) aktiviert ist.
5. Aktionsschaltflächen
| Schaltfläche | Beschreibung |
|---|---|
| Jetzt aktualisieren | Liest sofort den aktuellen Gerätestatus aus |
| Capabilities ermitteln | Fragt das Gerät nach unterstützten Funktionen (B5-Befehl), belegt Checkboxen vor und registriert Variablen neu |
| 1. ApplianceID ermitteln | Ruft die Geräteliste aus der Midea-Cloud ab |
| 2. Token ermitteln | Holt Token und Key aus der Cloud, testet sie direkt gegen das Gerät, speichert sie und führt anschließend automatisch „Capabilities ermitteln" aus |
6. Debugging
Das Modul schreibt detaillierte Diagnosemeldungen in das IPS-Debug-Fenster der Instanz (SendDebug). Die Meldungen sind nach Kategorien gegliedert:
| Kategorie | Inhalt |
|---|---|
Update | Polling-Zyklus: Start, gesendeter Befehl, Antwortgröße, Status |
Token | Token-Ermittlung, UDP-IDs, Handshake-Test |
Cloud | Meldungen aus der Cloud-API (Authentifizierung, Geräteliste) |
B5 | Rohdaten und erkannte Capabilities der B5-Abfrage |
ApplianceID | Gerätelisten-Abfrage und automatische ID-Zuweisung |
Variables | Anlegen und Löschen optionaler Variablen |
sendV2 / sendV3 | Netzwerkfehler auf LAN-Ebene |
Echte Fehler werden zusätzlich ins IPS-Systemlog (KL_ERROR) geschrieben.
7. Spenden
Dieses Modul ist für die nicht kommerzielle Nutzung kostenlos, Schenkungen als Unterstützung für den Autor werden hier akzeptiert:
