
ClimaControl ME_CN105_ATA_WIFI je Wi-Fi brána tretej strany od firmy ProtoART (Enschede, Holandsko), ktorá pridáva lokálne sieťové ovládanie ku klimatizáciám Mitsubishi Electric typu vzduch-vzduch. Modul sa zapája do servisného konektora CN105, ktorý je prítomný na takmer každej vnútornej jednotke RAC a PAC značky Mitsubishi Electric, a sprístupňuje tepelné čerpadlo cez lokálne HTTP REST API, MQTT klienta a mDNS hostname — to všetko bez cloudového účtu. TapHome sa pripája cez HTTP v lokálnej sieti, číta JSON stav tepelného čerpadla a riadi zapnutie, režim, ventilátor, lamely a nastavenú teplotu.
Ide o lokálnu integráciu — bez MelCloud účtu, bez závislosti na internete, bez dopytovania Mitsubishi cloudu. Šablóna spolupracuje s existujúcimi Wi-Fi adaptérmi MelCloud a s káblovými termostatmi MHK1 / MHK2 na tej istej zbernici CN105; platí posledný prijatý príkaz.
Hardvér brány vyrába ProtoART, nie Mitsubishi Electric. Mitsubishi Electric vyrába klimatizácie, ktoré táto brána ovláda. ProtoART má samostatné varianty pre Mitsubishi Heavy Industries (MHI_XY_ATA_WIFI / MHI_CNS_ATA_WIFI) a pre Mitsubishi Electric vzduch-voda Ecodan (ME_CN105_ATW_WIFI) — pre tieto systémy použite zodpovedajúcu šablónu.
Hardvér
Modul ClimaControl je malá plastová krabička (bez externého napájacieho zdroja) postavená na Wi-Fi mikrokontroléri ESP32. Dodáva sa plne zmontovaný a predprogramovaný — žiadne spájkovanie ani flashovanie firmvéru nie je potrebné.
Balenie obsahuje:
- Modul ClimaControl (ESP32, Wi-Fi b/g/n, MQTT a HTTP REST klient)
- Predpripravený CN105 kábel (5-pinový kľúčovaný konektor)
- Voliteľne: bezdrôtový externý snímač teploty a vlhkosti (CR2032 batéria)
- Voliteľne: predlžovací kábel CN105 (objednáva sa samostatne)
Napájanie je odoberané z 12 V vetvy na CN105 — žiadne pripojenie do elektrickej siete ani externý zdroj. Na každú vnútornú jednotku je potrebný jeden modul ClimaControl (multi-split systémy vyžadujú jeden modul na každú vnútornú jednotku).
Podporované vnútorné jednotky Mitsubishi Electric
ProtoART uvádza bránu ako kompatibilnú s väčšinou vnútorných jednotiek Mitsubishi Electric RAC a PAC, ktoré majú CN105 port — vrátane kanálových, nástenných, kazetových a parapetných jednotiek.
| Rada | Konštrukcia | Potvrdené modely |
|---|---|---|
| MSZ | Nástenný split (RAC) | MSZ-AP, AY, DM, EF, FD, FE, FH, FS, GA, GB, GC, GE, GL, GS, GV, HR, LN, RW |
| MLZ / MLS | Jednosmerná kazetová | MLZ-KA, MLZ-KP, MLS-KP |
| MFZ | Parapetná | MFZ-KA, MFZ-KJ |
| PEAD / PEA / PKA / PVA / PLA / SEZ | Kanálová / Mr. Slim / PAC | PEAD-M, PEAD-RP100, PEA-RP140EA2, PKA-A, PKFY-P06NLMU-E-TH, PVA-A, PLA-A18BA, SEZ-KD |
| Multi-split / Mr. Slim | Vonkajšie / multi-zónové | MSXY-FP, MSXY-FNVE, SVZ-KPNA, MXZ-8C48NAHZ, MPEZS-60VJA, NAXWST18A112AA |
Ak konkrétny model nie je v zozname, ale má CN105 port, spravidla je kompatibilný — ProtoART vyzýva používateľov, aby kontaktovali podporu na [email protected] pre potvrdenie.
ClimaControl ME_CN105_ATA_WIFI je určený iba pre systémy Mitsubishi Electric vzduch-vzduch. Nepodporuje zariadenia Mitsubishi Heavy Industries (MHI) — pre MHI vnútorné jednotky treba variant MHI_XY_ATA_WIFI alebo MHI_CNS_ATA_WIFI. Mitsubishi Electric vzduch-voda (Ecodan) používa iný variant ClimaControl (ME_CN105_ATW_WIFI).
Inštalácia
Modul sa pripája k internej doske PCB vnútornej jednotky. Inštalácia vyžaduje otvorenie elektrickej skrinky vnútornej jednotky, preto postupujte podľa montážneho návodu Mitsubishi Electric pre daný model a vždy najprv odpojte jednotku na hlavnom ističi.
- Odpojte klimatizáciu na hlavnom ističi.
- Otvorte elektrickú skrinku vnútornej jednotky podľa montážneho návodu Mitsubishi Electric.
- Nájdite 5-pinový konektor CN105 na doske vnútornej jednotky (niekedy označený CN105 alebo CNS).
- Zapojte kábel ClimaControl do CN105 — konektor je kľúčovaný, možná je len jedna orientácia.
- Veďte kábel cez existujúci servisný otvor a upevnite krabičku ClimaControl na stenu vedľa vnútornej jednotky (alebo dovnútra skrinky, ak je miesto).
- Zapnite napájanie — ClimaControl sa napája z 12 V vetvy na CN105.
Wi-Fi nastavenie (captive portal)
Pri prvom spustení modul vysiela vlastný Wi-Fi prístupový bod a otvorí captive portal. Pripojte sa na tento AP, zadajte prístupové údaje domácej Wi-Fi siete a modul sa pripojí do LAN. Od tohto momentu sa ohlasuje cez mDNS / Bonjour ako heatpump.local — dostupný na http://heatpump.local/ pre webové UI a http://heatpump.local/control pre REST API.
Používajte mDNS hostname
heatpump.localnamiesto IP adresy pridelenej cez DHCP. Názov prežije obnovenie DHCP leasu aj reštart routera — IP sa môže zmeniť, názov nie.
Súbeh s MelCloud a termostatmi MHK
ClimaControl sa pripája paralelne k existujúcim Wi-Fi rozhraniam MelCloud a káblovým termostatom MHK1 / MHK2 — všetky riadiace prvky zdieľajú zbernicu CN105. Nie je potrebné žiadne špeciálne zapojenie a platí posledný príkaz. TapHome, aplikácia MelCloud aj nástenný termostat môžu riadiť tú istú jednotku súčasne.
Konfigurácia
Importný parameter TapHome
Pri importe šablóny v aplikácii TapHome treba nastaviť jediný parameter:
| Parameter | Popis | Odporúčaná hodnota |
|---|---|---|
IpAddress | Adresa dostupná z TapHome CCU | heatpump.local |
Port 80 je pevný. Autentifikácia sa nepoužíva — modul je určený pre dôveryhodný LAN segment. Udržujte ho v dôveryhodnej sieti alebo VLAN; akékoľvek zariadenie, ktoré dosiahne /control na porte 80, môže ovládať HVAC.
Ak mDNS hostname nie je rozpoznateľný z CCU (napríklad medzi podsieťami bez mDNS reflektora), použite statický DHCP lease a zadajte IP adresu priamo.
Zariadenia šablóny
Šablóna periodicky (každých 2,5 s) dopytuje endpoint /control, ukladá celú JSON odpoveď do modulovej premennej (status) a sprístupňuje sedem podriadených zariadení, ktoré parsujú jednotlivé polia z tejto cache.
Zapnutie
Jednoduchý spínač on/off. Číta heatpump.power (on/off) a zapisuje /control?cmd=heatpump&power=on|off.
Prevádzkový režim
Viachodnotový prepínač s piatimi režimami podporovanými na vnútorných jednotkách Mitsubishi Electric vzduch-vzduch:
| Hodnota | Režim | Zápis ako |
|---|---|---|
| 0 | Auto | mode=auto |
| 1 | Chladenie | mode=cool |
| 2 | Ventilácia (iba ventilátor) | mode=fan |
| 3 | Vysúšanie | mode=dry |
| 4 | Vykurovanie | mode=heat |
Rýchlosť ventilátora
Viachodnotový prepínač so šiestimi stupňami: Tichý, 1, 2, 3, 4, Auto. Číta heatpump.fan a zapisuje /control?cmd=heatpump&fan=…. Interný enum mapuje quiet=0, 1=1, 2=2, 3=3, 4=4, auto=5.
Termostat
Zariadenie typu termostat, ktoré číta aktuálnu izbovú teplotu (heatpump.actual_temperature) a aktuálnu nastavenú teplotu (heatpump.set_temperature) a zapisuje novú nastavenú teplotu cez /control?cmd=heatpump&set_temperature={value}. Teploty sú uvádzané v °C ako desatinné čísla.
Pole actual_temperature je napájané buď vstavaným termistorom vnútornej jednotky, alebo — ak sa používa — kanálom Remote Temperature popísaným nižšie.
Remote Temperature (externý izbový snímač)
Write-only premenná, ktorá posiela externú hodnotu izbovej teploty do HVAC a prepíše vstavaný termistor vnútornej jednotky. Ľubovoľný teplotný snímač v TapHome (bezdrôtový, Modbus, Zigbee a pod.) sa k nej dá pripojiť jednoduchým smart pravidlom: pri každej zmene zdrojového snímača sa jeho hodnota v °C zapíše do tohto zariadenia.
Hodnota vzdialenej teploty sa musí obnovovať minimálne raz za 15 sekúnd, inak jednotka prepne späť na vstavaný termistor, kým nepríde nová hodnota. Nakonfigurujte smart pravidlo tak, aby zapisovalo pri každej zmene a aj periodicky (napríklad každých 10 sekúnd), aby krátke obdobia bez zmeny senzora nezhodili override.
Hodnoty ≤ 0 a NaN šablóna ignoruje — túto funkciu používajte len vtedy, ak máte spoľahlivý izbový snímač na strane TapHome.
Poloha lamiel (vertikálne)
Viachodnotový prepínač pre uhol vertikálnych lamiel: 1, 2, 3, 4, Auto. Číta heatpump.vane a zapisuje /control?cmd=heatpump&vane=…. HTTP API ProtoART dokumentuje aj hodnotu swing — aktuálna šablóna ju neexponuje.
Poloha širokých lamiel (horizontálne)
Viachodnotový prepínač pre smer horizontálnych lamiel: Úplne vľavo, Vľavo, Stred, Vpravo, Úplne vpravo, Široké, Kývanie. Číta heatpump.widevane a zapisuje /control?cmd=heatpump&widevane=…. ProtoART dokumentuje aj hodnotu split, ktorú aktuálna šablóna neexponuje.
Servisná akcia Reset na úrovni modulu
Jediná servisná akcia na úrovni modulu — Reset — pošle /control?cmd=restart a vyvolá reštart ESP32. Užitočná po aktualizácii firmvéru alebo keď sa zasekne UART linka CN105.
Ďalšie schopnosti (nie sú implementované)
ProtoART poskytuje oveľa viac telemetrických polí, než aktuálna šablóna využíva. Dajú sa doplniť v budúcej revízii šablóny:
- Teplota výparníka (
heatpump.tinp) a vonkajšia teplota (heatpump.tout) — termistory výparníka a vonkajšej jednotky. - Tlak výparníka (
heatpump.pinp) — diagnostický. - Spotreba energie (
heatpump.tpcns) — kumulatívny počítadlo energie; dá sa namapovať ako elektromer v TapHome. - Čas prevádzky (
heatpump.optime) — počítadlo motohodín kompresora. - Príznak prevádzky (
heatpump.oper) — kompresor aktívny / standby. - Stav odmrazovania (
heatpump.defrost) — true počas odmrazovania vonkajšej jednotky. - Hot adjust (
heatpump.hotadjust) — príznak predhrevu. - Standby (
heatpump.standby) — vnútorná jednotka je zapnutá, ale aktívne nehreje/nechladí. - Stav snímača i-see (
heatpump.isee) — detekcia prítomnosti osôb na sérii MSZ-FH. - Hodnoty externého snímača (
sensor.external.*) — teplota, vlhkosť a stav batérie voliteľného bezdrôtového CR2032 snímača. - Diagnostika — stav UART linky CN105 (
sys.conhp), stav spojenia externého snímača (sys.conext), uptime modulu (sys.up), Wi-Fi RSSI (wifi.rssi), verzia firmvéru (fw.curr).
Voliteľný bezdrôtový externý snímač
ProtoART predáva ako voliteľné príslušenstvo malý batériový bezdrôtový snímač (CR2032, LoRa / 2,4 GHz). Meria teplotu a vlhkosť v okolí a slúži na eliminovanie efektu „teplej bubliny" okolo termistora vnútornej jednotky — vstavaný snímač sa nachádza vo vnútri skrinky a pri vykurovaní vykazuje vyššiu teplotu, než je skutočne v miestnosti.
Snímač sa páruje priamo s modulom ClimaControl (nie s TapHome). Jeho hodnoty sa objavujú v JSON stave pod sensor.external.* a používa ich interná logika modulu. Aktuálna šablóna TapHome ich späť nečíta — ak externý snímač nie je kúpený, použite ľubovoľný teplotný snímač TapHome a nasmerujte ho na zariadenie Remote Temperature.
Riešenie problémov
heatpump.local sa nerozlišuje
- Overte, že sa modul ClimaControl pripojil k domácej Wi-Fi — stav LED je zdokumentovaný v návode ProtoART.
- Uistite sa, že TapHome CCU je v tej istej LAN / VLAN ako modul. mDNS (Bonjour) je link-local — cez podsiete neprechádza, kým na routeri nie je nakonfigurovaný mDNS reflektor.
- Otvorte
http://heatpump.local/controlv prehliadači na zariadení v rovnakej LAN — JSON odpoveď potvrdí, že modul je dostupný. - Ak mDNS nie je k dispozícii, priraďte modulu statický DHCP lease podľa jeho MAC adresy a zadajte IP priamo do importného parametra
IpAddress.
Všetky hodnoty sú po importe NaN
Šablóna dopytuje /control bez parametrov každých 2,5 s. Ak sú všetky polia NaN, HTTP požiadavka neprebieha úspešne:
- Skontrolujte, že
IpAddresssmeruje na dosiahnuteľný host. - Otvorte
http://{IpAddress}/controlv prehliadači — ak vráti prihlasovací formulár alebo chybovú stránku, firmvér modulu môže byť zastaraný; aktualizujte podľa poznámok k verziám firmvéru ProtoART. - Skontrolujte kábel CN105 — ak je kábel uvoľnený alebo je vnútorná jednotka vypnutá, modul nabehne, ale sekcia JSON týkajúca sa tepelného čerpadla vráti prázdne / predvolené hodnoty. Diagnostický údaj
sys.conhp(aktuálne neexponovaný) v takom prípade klesne na0.
Remote Temperature nemá žiadny efekt
- Overte, že zápis prebieha minimálne každých 15 s — pri dlhšom intervale sa jednotka medzi zápismi vráti k internému termistoru.
- Skontrolujte, že zapisovaná hodnota je kladné desatinné číslo (°C). Hodnoty
≤ 0aNaNskript šablóny explicitne ignoruje. - Niektoré vnútorné jednotky Mitsubishi Electric vyžadujú, aby bola jednotka v režime Chladenie, Vykurovanie alebo Auto, aby sa vzdialená teplota prejavila. V režimoch Vysúšanie a Ventilácia kompresor nepoužíva nastavenú teplotu, takže Remote Temperature nemá viditeľný vplyv.
Zápisy nastavenej teploty sú potichu prepísané
Ak iný ovládač (aplikácia MelCloud, termostat MHK, IR diaľkové ovládanie) pošle príkaz približne v rovnakom čase ako TapHome, na zbernici CN105 platí posledný príkaz. Toto je očakávané správanie pre systém s viacerými ovládačmi. Ak má nastavenú teplotu vlastniť jeden ovládač, ostatné odpojte (alebo obmedzte ich prístup cez Wi-Fi / časový plán).
Príkazy ventilátora alebo lamiel nemajú efekt
Enum šablóny mapuje 0 – 5 pre ventilátor a lamely. Niektoré modely Mitsubishi Electric fyzicky nepodporujú každý stupeň — napríklad jednotka bez režimu „Tichý" príkaz prijme, ale beží na najbližšom podporovanom stupni. Otestujte každú rýchlosť oproti originálnemu diaľkovému ovládaniu jednotky a zistite, ktoré stupne konkrétny model skutočne ponúka.
Hardvér ProtoART je otvorený aj pre iné platformy domácej automatizácie (Home Assistant, OpenHAB, FHEM, Tasmota, Homey). K jednému modulu sa môže pripojiť viacero klientov súčasne — napríklad TapHome a Home Assistant môžu obaja čítať aj zapisovať bez vzájomného rušenia, pretože modul stav medzi klientmi neserializuje. Vyhýbajte sa protichodným zápisom z paralelne bežiacich automatizácií.