Mitsubishi WF-RAC voor Home Assistant (Marketplace-integratie)

Installaties: 2,1K die analysegegevens delen
GitHub-sterren: 306
Verbinding: Werkt lokaal
Onderhoud: Bijgewerkt in de afgelopen 6 maanden
Versie: 2026.10.1, 26 oktober 2026
Categorie: Klimaat, Warmtepompen en airconditioning
Soort: Marketplace-integratie
Merk: Mitsubishi
Vereist: Vereist de Marketplace (HACS op 2026.10 en ouder)
Domein: mitsubishi_wf_rac
Bron: github.com/blues-sechseck/Mitsubishi-WF-RAC-Integration
Problemen: Probleem melden

Onafhankelijk overzicht, gemaakt door de ontwikkelaar van Vulpo. Niet gelieerd aan Home Assistant of de Open Home Foundation.

Over dit item

Mitsubishi WF-RAC is een integratie voor airconditioners van Mitsubishi Heavy Industries die de WF-RAC WiFi-module gebruiken. Hij praat met de lokale HTTP API van de module, dus de bediening blijft op het lokale netwerk, en units op het netwerk worden automatisch gevonden. Hij voegt een klimaatentiteit toe, plus sensoren, binaire sensoren, een schakelaar voor stille werking, selecties voor swing en ventilatorsnelheid, en een energietotaal dat kan worden gereset. Units die deze mogelijkheid melden krijgen ook nummers en selecties voor de Home Leave Mode. De opties omvatten temperatuurcorrecties, overshootcorrectie voor koelen, drogen en verwarmen, en een sensor voor de buitenkamertemperatuur waarop de unit kan regelen. Een optionele controle op firmware-updates is de enige verbinding met internet en staat standaard uit. Hij werkt niet met Mitsubishi Electric-systemen of MELCloud.

Automatische samenvatting van de README en de code van blues-sechseck/Mitsubishi-WF-RAC-Integration, automatisch vertaald. Klopt er iets niet, of ben je de maintainer en wil je hier je eigen tekst tonen? Neem contact op

Ondersteunt

Werkt lokaal Praat met je apparaten op je eigen netwerk. Geen cloud van de aanbieder ertussen.
Wordt vanzelf gevonden Home Assistant vindt het op het netwerk en biedt aan om het toe te voegen.
Uit de Marketplace Wordt geïnstalleerd via de Marketplace, voorheen HACS.
Actief onderhouden De auteur heeft in de afgelopen zes maanden een release of wijziging gepubliceerd.

Levert

Klimaat
Schakelaars
Sensoren

Instellen

Installeer de integratie vanuit de Marketplace en herstart Home Assistant. Voeg de integratie daarna toe onder Instellingen > Apparaten en diensten.

WF-RAC AC verbinding info

Host (IP) adresHet lokale IP-adres van de wifi-module in de airco. Een gewijzigd adres wordt overgenomen zodra de module zich opnieuw aankondigt; geef de module een vast adres in je router, of corrigeer het hier als dat uitblijft.
PoortDe poort waarop de lokale API van de module luistert. Laat 51443 staan, tenzij je module een andere aankondigt.
Dubbel IP-adres negerenVoegt deze airco toe hoewel een andere invoer hetzelfde IP-adres al gebruikt. Bedoeld voor een unit waarvan de oude invoer is verdwenen: de module accepteert één verbinding tegelijk, twee invoeren die hem bevragen leveren fouten in het log op.

WF-RAC Airco ontdekt

PoortDe poort waarop de module bereikbaar is. Normaal gesproken 51443 — wijkt de aangekondigde waarde hierboven af, corrigeer hem dan hier.

WF-RAC AC verbinding herconfigureren

Host (IP) adresHet lokale IP-adres van de wifi-module in de airco. Een gewijzigd adres wordt overgenomen zodra de module zich opnieuw aankondigt; geef de module een vast adres in je router, of corrigeer het hier als dat uitblijft.
PoortDe poort waarop de lokale API van de module luistert. Laat 51443 staan, tenzij je module een andere aankondigt.

Na het instellen

HerhaallimietOpeenvolgende mislukte pollings voordat de airco als niet beschikbaar wordt gemarkeerd. Het minimum van drie is bij een pollinginterval van 60 s ongeveer drie minuten — genoeg om de uurlijkse wifi-herverbinding van de module te overbruggen. Verhoog het bij een zwakke verbinding.
Controleren op firmware-updatesMaakt een Firmware-update-entiteit die de versie van de module vergelijkt met de server van de fabrikant. Dit is de enige uitgaande internetverbinding van de integratie — laat hem uit om volledig lokaal te blijven.
SensorDe airco regelt op deze sensor. Laat leeg om hem terug te zetten op zijn eigen sensor; bij 'unavailable' of 'unknown' gebeurt hetzelfde bij het volgende frame. Bij verwarmen telt de meeste airco's uit zichzelf 2 °C bij de instelling op — een sensor in de kamer maakt dat zichtbaar; hoe je dat op het toestel uitschakelt staat in de README.
Overshoot koelenHoe ver de kamer voorbij je instelling gaat voordat de airco stopt. Ingesteld op 22 °C, kamer blijft op 21,5 °C staan: vul 0,5 in. Begint op 0,5, want dat is wat de tot nu toe gemeten toestellen nodig hebben — kijk waar jouw kamer uitkomt en pas aan. Blijft hij er juist boven en wordt het nooit koud genoeg, vul dan een negatief getal in. Geldt alleen bij koelen — drogen heeft een eigen veld, en in automatisch krijgt de airco je meting ongewijzigd.
Overshoot drogenHetzelfde voor drogen, dat ook koelt en dus hetzelfde teken heeft. Begint op 0: het enige tot nu toe gemeten toestel kwam in deze stand precies op zijn instelling uit, met een bredere band dan bij koelen. Gaat jouw kamer eroverheen, stel dan een doel in, laat de kamer tot rust komen en vul in hoever hij eroverheen ging.
Overshoot verwarmenHetzelfde voor verwarmen: positief als de kamer boven je instelling uitkomt, negatief als hij eronder blijft.
Doel offsetPositief verlaagt de instelling die naar de unit gaat, negatief verhoogt hem — de kaart blijft in beide gevallen uw eigen waarde tonen. De meeste units ronden een halve graad af naar de volgende hele, dus 0,5 werkt hier vaak als 1. Met een binnentemperatuurbron ingesteld is Overshoot koelen hierboven de betere knop voor een unit die doorschiet: die werkt fijner en laat de instelling gelijk aan wat de app toont.
Doel offset (Koelen)Laat leeg om de algemene doeltemperatuur-offset te gebruiken.
Doel offset (Verwarmen)Laat leeg om de algemene doeltemperatuur-offset te gebruiken.
Binnen offsetWordt bij de meting van de eigen binnensensor opgeteld voordat die getoond wordt. Alleen weergave — het gedrag van de unit verandert er niet door.
Buiten offsetHetzelfde voor de buitentemperatuur die de unit meldt.

Teksten uit de code van blues-sechseck/Mitsubishi-WF-RAC-Integration.

Entiteiten

Binaire sensorenProbleem, Bezetting, Compressorvraag, Externe bediening, Opgegeven binnentemperatuur, Ontdooien
KnoppenEnergieverbruik totaal resetten
NummersAfwezig koelen buitentemperatuurdrempel, Afwezig koelen doelkamertemperatuur, Afwezig verwarmen buitentemperatuurdrempel, Afwezig verwarmen doelkamertemperatuur
SelectiesHorizontale zwaairichting, Verticale zwaairichting, Ventilatorsnelheid, Afwezigheidsmodus, Afwezig koelen ventilatorstand, Afwezig verwarmen ventilatorstand
SensorenBinnentemperatuur, Buitentemperatuur, Doeltemperatuur, Airco-ID, Operator-ID, Apparaat-ID, IP, Aantal accounts, Fout, Laatst gewijzigd door, Account verloopt, LED-status en nog 22
SchakelaarsStille werking
UpdatesFirmware-update

Acties

Horizontale zwenkstand instellenStelt de horizontale (links/rechts) zwenkstand in.Velden: Horizontale zwenkstand
Verticale zwenkstand instellenStelt de verticale (omhoog/omlaag) zwenkstand in.Velden: Verticale zwenkstand
Afwezigheidsstatus opvragenVraagt het apparaat om zijn huidige afwezigheidsdrempels en ventilatorstanden. Roep dit éénmaal aan zodat de number- en select-entiteiten een waarde hebben om te tonen en te wijzigen — bij een gewone polling laat het apparaat ze weg. Alleen bij modellen met de HomeLeaveMode-mogelijkheid.
Afwezigheidsmodus instellenSchrijft nieuwe afwezigheidsdrempels en ventilatorstanden voor koelen en verwarmen. Alleen bij modellen met de HomeLeaveMode-mogelijkheid.Velden: Drempel koelen, Doeltemperatuur koelen, Ventilatorstand koelen, Drempel verwarmen, Doeltemperatuur verwarmen, Ventilatorstand verwarmen
Binnentemperatuur opgevenGeeft het apparaat een kamertemperatuur om op te regelen in plaats van die van zijn eigen sensor. De waarde wordt niet door deze actie verstuurd; hij rijdt mee op het eerstvolgende frame dat toch al uitgaat en werkt daarom binnen een minuut. Zolang er een waarde opgegeven is, vraagt de integratie per cyclus één segment bedrijfsdata op — dat is het frame dat hem draagt. Zonder temperatuur aangeroepen geeft de actie het apparaat terug aan zijn eigen sensor.Velden: Temperatuur
Energieverbruik totaal instellenOverschrijft het opgebouwde totaal van één apparaat. 0 zet het terug, een eerder genoteerde meterstand neemt dat cijfer over. Betreft alleen de teller van de integratie — de teller in het apparaat is niet beschrijfbaar.Velden: Waarde

Probleemoplossing

DiagnostiekDownloadt een diagnostiekbestand om aan een bugmelding toe te voegen.
ReparatiemeldingenMeldingen die het kan tonen onder Instellingen > Reparaties:Wijzigt zijn eigen instellingen bij een verzoek om bedrijfsdata

Uit de 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.

Uit de README van blues-sechseck/Mitsubishi-WF-RAC-Integration, MIT License. Ingekort.