Wie thuis airconditioners van Mitsubishi Heavy Industries (MHI) heeft hangen met een WF-RAC Wi-Fi module, weet hoe handig het is om ze slim aan te sturen. Maar de officiële Smart M-Air app (van Mitsubishi zelf) laat op het gebied van slimme automatiseringen en snelheid soms te wensen over. En wat als het internet of de cloud eruit ligt? Gelukkig is er een veel betere oplossing: een lokaal centrale ‘AircoBridge’ die op zichzelf werkt en ook gekoppeld kan worden aan Homey.

In dit artikel duiken we in wat AircoBridge uniek maakt, hoe de integratie werkt en welke cruciale fix we hebben uitgebracht voor WF-RAC gebruikers.

Het Probleem met Trage Cloud API’s & Tientallen Losse Connecties

Als je meerdere MHI airco’s in huis hebt en deze afzonderlijk integreert in je domotica netwerk (of via externe cloud connecties), loop je al snel tegen een paar vervelende obstakels aan:

  • Afhankelijkheid van de cloud: Valt je internetverbinding weg? Dan werken je slimme schema’s en Flows in huis niet meer.
  • Trage respons en API limits: Cloud-requests leggen een flinke weg af. Commando’s worden pas na een paar seconden verwerkt. De app is extreem traag.
  • De ‘4-Operator Limit’: MHI Wi-Fi modules accepteren maximaal 4 geregistreerde telefoons/apparaten (slots). Als verschillende plugins en mobieltjes los van elkaar verbinding maken, zit het geheugen van je airco-module in no-time vol.
  • Homey plugin voor WF-RAC module: vaak time outs en/of problemen

De Oplossing: AircoBridge als Centraal Station

AircoBridge verandert de manier waarop je met je MHI airconditioners communiceert. Het werkt als één centraal lokaal station op je thuisnetwerk (bijvoorbeeld via Docker op een NAS, Macmini, Ubuntu server, Home Assistant server of Raspberry Pi).

Waarom is AircoBridge een gamechanger?

  • ⚡ 100% Lokaal & Razendsnel: Geen cloud accounts, geen abonnementskosten en direct reactie binnen enkele milliseconden over je eigen netwerk.

  • 🛡️ Slechts 1 Slot in Gebruik: AircoBridge maakt als enige verbinding met de airco’s. Al je slimme apparaten en dashboards in huis praten vervolgens via AircoBridge. Je houdt zo altijd fysieke slots vrij op de airco zelf.

  • 📊 Ingebouwde Dashboard & Energie inzicht: AircoBridge biedt uit zichzelf al een strakke web interface met uitgebreid inzicht in kamer- en buitentemperaturen, actueel stroomverbruik (W/kWh), sturing (3D Auto, horizontale/verticale vanes) en automatiseringen en nog veel meer.

De Homey Plugin

Het wordt pas echt leuk als we AircoBridge dan ook nog koppelen aan ons smart home hart: Homey. Via de officiële Airco-Bridge App voor Homey praten je MHI airco’s direct mee in je Flows. Omdat Homey via de bridge communiceert in plaats van met alle airco’s los:

  • Blijft je netwerk rustig: Geen overvloed aan poll-verzoeken op je Wi-Fi.

  • Schakel je alles in één Flow: Wil je bij zonne energie overschot alle 4 de airco’s tegelijk aanzetten? Homey geeft 1 gecombineerd signaal aan AircoBridge, die het foutloos verdeelt.

  • Triggers op alles: Maak Flows op basis van actuele ruimtetemperaturen, de stand van de vinnen of het energieverbruik van de compressor.

De ‘OpenSSL EPROTO’ Bug & Onze Custom Fork (Fix!)

Toen we AircoBridge recent wilden uitrollen op een opstelling met WF-RAC modules (poort 51443), liepen we tegen een hardnekkig probleem aan. De originele AircoBridge software veronderstelde bij poort 51443 standaard een versleutelde HTTPS/TLS-handshake. Sommige WF-RAC modules praten op deze poort echter unencrypted HTTP.

Het resultaat? Een harde foutmelding in Node.js: write EPROTO: error:0A00010B:SSL routines:tls_validate_record_header:wrong version number

Hierdoor was het handmatig toevoegen of ontdekken van de airco units via het dashboard onmogelijk.

Onze Fork: Schone HTTP-by-Default

Omdat we de community graag vooruithelpen, hebben we een custom fork uitgebracht waarin de communicatielaag en de API-routes volledig zijn aangepast naar standaard HTTP.

  • GitHub Repository: mbnn/AircoBridge

  • Docker Image: ghcr.io/mbnn/aircobridge:latest

Status Update: We hebben inmiddels een Pull Request (PR) ingediend bij de originele ontwikkelaar (CrazyHenk44). Totdat deze officieel gemerged is, kan iedereen die tegen hetzelfde probleem aanloopt gebruikmaken van onze kant-en-klare Docker container!

Snel Aan de Slag (Docker Compose)

Wil je deze lokaal-gestuurde opstelling zelf draaien? Met de onderstaande compose.yaml staat AircoBridge binnen 1 minuut op je server:

services:
airco:
image: ghcr.io/mbnn/aircobridge:latest
container_name: aircobridge
restart: unless-stopped
network_mode: host
environment:
NODE_ENV: production
PORT: 3000
volumes:
- ./config:/app/config
- ./data:/app/data

Na het opstarten open je http://<IP-van-je-server>:3000, voeg je je airco’s toe en koppel je de Homey Airco-Bridge app.

Geen trage cloud reacties meer, geen volgelopen telefoonslots en volledige controle in eigen huis. Met AircoBridge en Homey haal je het maximale uit je Mitsubishi Heavy Industries airco’s!

Bron/Origineel: Aircobridge / CrazyHenk44