Mitsubishi WF-RAC für Home Assistant (Marketplace-Integration)

Installationen: 2.121 teilen Analysedaten
GitHub-Sterne: 306
Verbindung: Funktioniert lokal
Pflege: In den letzten 6 Monaten aktualisiert
Version: 2026.10.1, 26. Oktober 2026
Kategorie: Klima, Wärmepumpen und Klimaanlagen
Art: Marketplace-Integration
Marke: Mitsubishi
Voraussetzung: Braucht den Marketplace (HACS bis Home Assistant 2026.10)
Domain: mitsubishi_wf_rac
Quelle: github.com/blues-sechseck/Mitsubishi-WF-RAC-Integration
Probleme: Problem melden

Unabhängiges Verzeichnis, erstellt vom Entwickler von Vulpo. Steht in keiner Verbindung zu Home Assistant oder der Open Home Foundation.

Überblick

Mitsubishi WF-RAC ist eine Integration für Klimaanlagen von Mitsubishi Heavy Industries, die das WF-RAC WiFi-Modul verwenden. Sie spricht mit der lokalen HTTP-API des Moduls, sodass die Steuerung im lokalen Netzwerk bleibt, und Geräte im Netzwerk werden automatisch gefunden. Sie fügt eine Klima-Entität hinzu, dazu Sensoren, Binärsensoren, einen Schalter für den Flüsterbetrieb, Auswahlen für Luftlenkung und Ventilatorstufe sowie eine Energiesumme, die zurückgesetzt werden kann. Geräte, die diese Fähigkeit melden, erhalten außerdem Zahlen und Auswahlen für den Home Leave Mode. Die Optionen umfassen Temperaturoffsets, eine Überschwingkorrektur für Kühlen, Entfeuchten und Heizen sowie einen Außenraum-Temperatursensor, nach dem das Gerät regeln kann. Eine optionale Prüfung auf Firmware-Updates ist die einzige Verbindung zum Internet und ist standardmäßig ausgeschaltet. Sie funktioniert nicht mit Systemen von Mitsubishi Electric oder mit MELCloud.

Zusammenfassung der README und des Codes von blues-sechseck/Mitsubishi-WF-RAC-Integration, automatisch erstellt und übersetzt. Stimmt etwas nicht, oder betreust du das Projekt und möchtest hier deinen eigenen Text? Melde dich

Unterstützt

Funktioniert lokal Spricht mit deinen Geräten in deinem eigenen Netzwerk. Keine Cloud des Herstellers dazwischen.
Wird automatisch erkannt Home Assistant entdeckt sie im Netzwerk und bietet an, sie hinzuzufügen.
Aus dem Marketplace Wird über den Marketplace installiert, früher HACS.
Aktiv gepflegt Das Projekt hat in den letzten sechs Monaten eine neue Version oder Änderung veröffentlicht.

Stellt bereit

Klima
Schalter
Sensoren

Einrichtung

Installiere sie aus dem Marketplace und starte Home Assistant neu. Füge sie dann unter Einstellungen > Geräte & Dienste hinzu.

WF-RAC AC Verbindungs-Info

Host (IP) AdresseDie lokale IP-Adresse des WLAN-Moduls im Klimagerät. Eine geänderte Adresse wird übernommen, sobald sich das Modul wieder ankündigt; vergeben Sie im Router eine feste Adresse oder korrigieren Sie sie hier, falls das ausbleibt.
PortDer Port, auf dem die lokale Schnittstelle des Moduls lauscht. Belassen Sie 51443, sofern Ihr Modul keinen anderen ankündigt.
Doppelte IP-Adresse ignorierenFügt dieses Klimagerät hinzu, obwohl bereits ein anderer Eintrag dieselbe IP-Adresse verwendet. Gedacht für ein Gerät, dessen alter Eintrag verloren ging: Das Modul nimmt jeweils nur eine Verbindung an, zwei Einträge darauf erzeugen Fehler im Protokoll.

WF-RAC Klima gefunden

PortDer Port, unter dem das Modul erreichbar ist. Normalerweise 51443 — weicht der oben angekündigte Wert ab, hier korrigieren.

WF-RAC-Verbindung neu konfigurieren

Host (IP) AdresseDie lokale IP-Adresse des WLAN-Moduls im Klimagerät. Eine geänderte Adresse wird übernommen, sobald sich das Modul wieder ankündigt; vergeben Sie im Router eine feste Adresse oder korrigieren Sie sie hier, falls das ausbleibt.
PortDer Port, auf dem die lokale Schnittstelle des Moduls lauscht. Belassen Sie 51443, sofern Ihr Modul keinen anderen ankündigt.

Nach der Einrichtung

Max. Anzahl WiederholungenAufeinanderfolgende fehlgeschlagene Abfragen, bevor das Klimagerät als nicht verfügbar gilt. Das Minimum von drei entspricht bei 60 s Abfrageintervall etwa drei Minuten — genug, um die stündliche WLAN-Neuanmeldung des Moduls zu überbrücken. Bei schwacher Verbindung erhöhen.
Auf Firmware-Updates prüfenLegt eine Firmware-Update-Entität an, die die Version des Moduls mit dem Server des Herstellers vergleicht. Das ist die einzige ausgehende Internetverbindung der Integration — ausgeschaltet lassen, um vollständig lokal zu bleiben.
SensorDas Gerät regelt auf diesen Sensor. Leer lassen, damit es wieder seinen eigenen benutzt; bei „unavailable“ oder „unknown“ geschieht dasselbe mit dem nächsten Frame. Beim Heizen legen die meisten Geräte von sich aus 2 °C auf die Einstellung — ein Sensor im Raum macht das sichtbar; wie sich das am Gerät abschalten lässt, steht im README.
Überschwingen KühlenWie weit der Raum über Ihre Einstellung hinausschießt, bevor das Gerät abschaltet. 22 °C eingestellt, Raum pendelt sich bei 21,5 °C ein: 0,5 eintragen. Startet bei 0,5, weil die bisher gemessenen Geräte das brauchen — prüfen Sie, wo Ihr Raum landet, und passen Sie an. Bleibt er stattdessen darüber und wird nie kalt genug, tragen Sie eine negative Zahl ein. Viertelgrad ist der feinste Schritt, der beim Gerät ankommt. Gilt nur im Modus Kühlen — Trocknen hat ein eigenes Feld, im Automatikbetrieb bekommt das Gerät Ihren Messwert unverändert.
Überschwingen TrocknenDasselbe fürs Trocknen, das ebenfalls kühlt und dasselbe Vorzeichen hat. Startet bei 0: das bisher einzige gemessene Gerät landete in diesem Modus auf seiner Einstellung, mit breiterem Band als beim Kühlen. Schießt Ihres darüber hinaus, Ziel einstellen, den Raum einpendeln lassen und eintragen, wie weit er darüber hinausging.
Überschwingen HeizenDasselbe fürs Heizen, und nur im Modus Heizen: positiv, wenn der Raum über Ihrer Einstellung landet, negativ, wenn er darunter bleibt.
Zieltemperatur-OffsetPositiv senkt den ans Gerät gesendeten Sollwert, negativ hebt ihn an — die Karte zeigt in beiden Fällen weiterhin Ihren Wert. Die meisten Geräte runden ein halbes Grad auf das nächste ganze auf, 0,5 wirkt hier also oft wie 1. Wenn eine Innentemperatur-Quelle eingerichtet ist, ist das Überschwingen Kühlen der passendere Hebel für ein Gerät, das über das Ziel hinausschießt — es greift feiner und lässt den Sollwert so, wie ihn auch die App zeigt.
Zieltemperatur-Offset (Kühlen)Leer lassen, um den allgemeinen Zieltemperatur-Offset zu verwenden.
Zieltemperatur-Offset (Heizen)Leer lassen, um den allgemeinen Zieltemperatur-Offset zu verwenden.
Innentemperatur Sensor-OffsetWird zum Messwert des geräteeigenen Innenfühlers addiert, bevor er angezeigt wird. Nur die Anzeige — am Verhalten des Geräts ändert sich nichts.
Außentemperatur Sensor-OffsetDasselbe für die Außentemperatur, die das Gerät meldet.

Texte aus dem Code von blues-sechseck/Mitsubishi-WF-RAC-Integration.

Entitäten

BinärsensorenProblem, Anwesenheit, Kompressoranforderung, Externe Steuerung, Innentemperatur-Vorgabe, Abtauen
TastenEnergieverbrauch gesamt zurücksetzen
ZahlenHome Leave Kühlen Außen-Temp.-Vorgabe, Home Leave Kühlen Soll-Raumtemp., Home Leave Heizen Außen-Temp.-Vorgabe, Home Leave Heizen Soll-Raumtemp.
AuswahlfelderHorizontale Schwingrichtung, Vertikale Schwingrichtung, Lüftungsgeschwindigkeit, Abwesenheitsmodus, Home Leave Kühlen Lüfterstufe, Home Leave Heizen Lüfterstufe
SensorenInnentemperatur, Außentemperatur, Zieltemperatur, Klima-ID, Betreiber-ID, Geräte-ID, IP, Kontoanzahl, Fehler, Zuletzt geändert von, Konto läuft ab, LED-Status und 22 weitere
SchalterSilent-Betrieb
UpdatesFirmware-Update

Aktionen

Horizontale Schwingrichtung setzenSetzt die horizontale (links/rechts) Schwingrichtung.Felder: Horizontale Schwingrichtung
Vertikale Schwingrichtung setzenSetzt die vertikale (oben/unten) Schwingrichtung.Felder: Vertikale Schwingrichtung
Home-Leave-Status abfragenFordert vom Gerät seine aktuellen Home-Leave-Schwellen und Lüfterstufen an. Einmal aufrufen, damit die Number- und Select-Entitäten einen Wert zum Anzeigen und Ändern haben — bei einem gewöhnlichen Poll lässt das Gerät sie weg. Nur bei Modellen mit der HomeLeaveMode-Fähigkeit.
Home Leave Mode setzenSchreibt neue Home-Leave-Schwellen und Lüfterstufen für Kühlen und Heizen. Nur bei Modellen mit der HomeLeaveMode-Fähigkeit.Felder: Schwelle Kühlen, Sollwert Kühlen, Lüfterstufe Kühlen, Schwelle Heizen, Sollwert Heizen, Lüfterstufe Heizen
Raumtemperatur vorgebenGibt dem Gerät eine Raumtemperatur vor, auf die es regelt, statt auf die seines eigenen Fühlers. Der Wert wird nicht von dieser Aktion gesendet; er fährt auf dem nächsten ohnehin fälligen Frame mit und wirkt daher innerhalb einer Minute. Solange eine Vorgabe steht, fragt die Integration je Zyklus ein Betriebsdatensegment ab — das ist der Frame, der sie trägt. Ohne Temperatur aufgerufen, gibt die Aktion das Gerät auf seinen eigenen Fühler zurück.Felder: Temperatur
Energieverbrauch gesamt setzenÜberschreibt den aufgelaufenen Gesamtverbrauch eines Geräts. 0 setzt ihn zurück, ein Zählerstand von vorher überträgt den alten Wert. Betrifft nur den Zähler der Integration — der Zähler im Gerät ist nicht beschreibbar.Felder: Wert

Fehlerbehebung

DiagnosedatenLädt eine Diagnosedatei herunter, die du an einen Fehlerbericht anhängen kannst.
ReparaturhinweiseMögliche Hinweise unter Einstellungen > Reparaturen:Verstellt sich selbst, wenn Betriebsdaten abgefragt werden

Aus der README

This is a Home Assistant integration for Mitsubishi Heavy Industries air conditioners that use the WF-RAC WiFi module and the "Smart M-Air" app.
Not compatible with Mitsubishi Electric systems (e.g. those using a MAC-577IF2-E interface) or the MELCloud platform — those are a different manufacturer with a different app and protocol. If your unit uses MELCloud, see Home Assistant's built-in MELCloud integration instead.

Aus der README von blues-sechseck/Mitsubishi-WF-RAC-Integration, MIT License. Gekürzt.