
ClimaControl ME_CN105_ATA_WIFI to bramka Wi-Fi firmy trzeciej od ProtoART (Enschede, Holandia), która dodaje lokalne sieciowe sterowanie do klimatyzatorów Mitsubishi Electric typu powietrze-powietrze. Moduł podłącza się do serwisowego złącza CN105, obecnego praktycznie w każdej jednostce wewnętrznej RAC i PAC Mitsubishi Electric, i udostępnia pompę ciepła przez lokalne HTTP REST API, klienta MQTT oraz nazwę hosta mDNS — wszystko bez konta w chmurze. TapHome łączy się przez HTTP w sieci lokalnej, odczytuje stan JSON pompy ciepła i steruje zasilaniem, trybem, wentylatorem, żaluzjami oraz zadaną temperaturą.
To lokalna integracja — bez konta MelCloud, bez zależności od Internetu, bez odpytywania chmury Mitsubishi. Szablon współpracuje z istniejącymi adapterami Wi-Fi MelCloud oraz z przewodowymi termostatami MHK1 / MHK2 na tej samej magistrali CN105; wygrywa ostatnie wysłane polecenie.
Sprzęt bramki produkuje ProtoART, a nie Mitsubishi Electric. Mitsubishi Electric produkuje klimatyzatory, którymi ta bramka steruje. ProtoART oferuje osobne warianty bramek dla Mitsubishi Heavy Industries (MHI_XY_ATA_WIFI / MHI_CNS_ATA_WIFI) oraz dla Mitsubishi Electric powietrze-woda Ecodan (ME_CN105_ATW_WIFI) — do tych systemów należy użyć odpowiedniego szablonu.
Sprzęt
Moduł ClimaControl to niewielka plastikowa obudowa (bez zewnętrznego zasilacza) oparta na mikrokontrolerze Wi-Fi ESP32. Dostarczany jest w pełni zmontowany i zaprogramowany — bez lutowania i flashowania firmware’u.
Zestaw zawiera:
- Moduł ClimaControl (ESP32, Wi-Fi b/g/n, klient MQTT i HTTP REST)
- Gotowy przewód CN105 (5-pinowe, kluczowane złącze)
- Opcjonalnie: bezprzewodowy zewnętrzny czujnik temperatury i wilgotności (bateria CR2032)
- Opcjonalnie: przedłużacz CN105 (zamawiany osobno)
Zasilanie jest pobierane z szyny 12 V na CN105 — nie jest wymagane podłączenie do sieci elektrycznej ani zewnętrzny zasilacz. Dla każdej jednostki wewnętrznej potrzebny jest jeden moduł ClimaControl (systemy multi-split wymagają jednego modułu na każdą jednostkę wewnętrzną).
Obsługiwane jednostki wewnętrzne Mitsubishi Electric
ProtoART wskazuje, że bramka jest kompatybilna z większością jednostek wewnętrznych Mitsubishi Electric RAC i PAC wyposażonych w port CN105 — w tym kanałowe, ścienne, kasetonowe i przypodłogowe.
| Rodzina | Konstrukcja | Potwierdzone serie |
|---|---|---|
| MSZ | Ścienny split (RAC) | MSZ-AP, AY, DM, EF, FD, FE, FH, FS, GA, GB, GC, GE, GL, GS, GV, HR, LN, RW |
| MLZ / MLS | Kasetonowa jednokierunkowa | MLZ-KA, MLZ-KP, MLS-KP |
| MFZ | Przypodłogowa | MFZ-KA, MFZ-KJ |
| PEAD / PEA / PKA / PVA / PLA / SEZ | Kanałowa / 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 | Zewnętrzne / multi-strefowe | MSXY-FP, MSXY-FNVE, SVZ-KPNA, MXZ-8C48NAHZ, MPEZS-60VJA, NAXWST18A112AA |
Jeśli konkretnego modelu nie ma na liście, ale ma port CN105, zwykle jest kompatybilny — ProtoART zachęca użytkowników, aby potwierdzili to u wsparcia pod adresem [email protected].
ClimaControl ME_CN105_ATA_WIFI jest przeznaczony wyłącznie do systemów Mitsubishi Electric powietrze-powietrze. Nie obsługuje urządzeń Mitsubishi Heavy Industries (MHI) — do jednostek wewnętrznych MHI potrzebne są warianty MHI_XY_ATA_WIFI lub MHI_CNS_ATA_WIFI. Mitsubishi Electric powietrze-woda (Ecodan) wymaga innego wariantu ClimaControl (ME_CN105_ATW_WIFI).
Instalacja
Moduł podłącza się do wewnętrznej płytki PCB jednostki wewnętrznej. Instalacja wymaga otwarcia przedziału elektrycznego jednostki wewnętrznej — należy postępować zgodnie z instrukcją montażu Mitsubishi Electric dla danego modelu i zawsze najpierw wyłączyć jednostkę na głównym wyłączniku.
- Wyłącz klimatyzator na głównym wyłączniku.
- Otwórz przedział elektryczny jednostki wewnętrznej zgodnie z instrukcją montażu Mitsubishi Electric.
- Znajdź 5-pinowe złącze CN105 na płytce jednostki wewnętrznej (czasami oznaczone CN105 lub CNS).
- Wepnij przewód ClimaControl w CN105 — złącze jest kluczowane, pasuje tylko w jednej orientacji.
- Poprowadź kabel przez istniejący otwór serwisowy i zamocuj obudowę ClimaControl na ścianie obok jednostki wewnętrznej (lub w obudowie jednostki, jeśli jest miejsce).
- Włącz zasilanie — ClimaControl jest zasilany z szyny 12 V na CN105.
Konfiguracja Wi-Fi (captive portal)
Przy pierwszym uruchomieniu moduł emituje własny punkt dostępu Wi-Fi i otwiera captive portal. Połącz się z tym AP, wprowadź w portalu dane domowej sieci Wi-Fi, a moduł dołączy do LAN. Od tego momentu rozgłasza się przez mDNS / Bonjour jako heatpump.local — dostępny pod http://heatpump.local/ dla interfejsu webowego i http://heatpump.local/control dla REST API.
Używaj nazwy mDNS
heatpump.localzamiast adresu IP przydzielonego przez DHCP. Nazwa przetrwa odnowienia dzierżaw DHCP i restarty routera — IP może się zmienić, nazwa nie.
Współistnienie z MelCloud i termostatami MHK
ClimaControl łączy się równolegle z istniejącymi interfejsami Wi-Fi MelCloud oraz przewodowymi termostatami MHK1 / MHK2 — wszystkie kontrolery współdzielą magistralę CN105. Nie jest potrzebne specjalne okablowanie, wygrywa ostatnie polecenie. TapHome, aplikacja MelCloud i termostat naścienny mogą jednocześnie sterować tą samą jednostką.
Konfiguracja
Parametr importu TapHome
Podczas importu szablonu w aplikacji TapHome trzeba ustawić jeden parametr:
| Parametr | Opis | Zalecana wartość |
|---|---|---|
IpAddress | Host osiągalny z CCU TapHome | heatpump.local |
Port 80 jest stały. Uwierzytelnianie nie jest używane — moduł jest przeznaczony do zaufanego dostępu w LAN. Trzymaj go w zaufanym segmencie sieciowym lub VLAN-ie; każde urządzenie, które dociera do /control na porcie 80, może sterować HVAC.
Jeśli nazwa mDNS nie jest rozwiązywana w sieci CCU TapHome (np. między podsieciami bez przekazywania mDNS), użyj statycznej dzierżawy DHCP i wpisz adres IP bezpośrednio.
Urządzenia szablonu
Szablon co 2,5 s odpytuje endpoint /control, zapisuje całą odpowiedź JSON ze stanem w zmiennej modułu (status) i udostępnia siedem urządzeń podrzędnych, które parsują poszczególne pola z tej pamięci podręcznej.
Zasilanie
Prosty przełącznik on/off. Odczytuje heatpump.power (on/off) i zapisuje /control?cmd=heatpump&power=on|off.
Tryb pracy
Przełącznik wielowartościowy z pięcioma trybami obsługiwanymi w jednostkach wewnętrznych Mitsubishi Electric powietrze-powietrze:
| Wartość | Tryb | Zapis jako |
|---|---|---|
| 0 | Auto | mode=auto |
| 1 | Chłodzenie | mode=cool |
| 2 | Wentylacja (tylko wentylator) | mode=fan |
| 3 | Osuszanie | mode=dry |
| 4 | Grzanie | mode=heat |
Prędkość wentylatora
Przełącznik wielowartościowy z sześcioma stopniami: Cichy, 1, 2, 3, 4, Auto. Odczytuje heatpump.fan i zapisuje /control?cmd=heatpump&fan=…. Wewnętrzny enum mapuje quiet=0, 1=1, 2=2, 3=3, 4=4, auto=5.
Termostat
Urządzenie typu termostat, które odczytuje bieżącą temperaturę pomieszczenia (heatpump.actual_temperature) i aktualną wartość zadaną (heatpump.set_temperature) oraz zapisuje nową wartość zadaną przez /control?cmd=heatpump&set_temperature={value}. Temperatury podawane są w °C jako liczby zmiennoprzecinkowe.
Pole actual_temperature jest zasilane przez wbudowany termistor jednostki wewnętrznej lub — jeśli jest używany — przez kanał Remote Temperature opisany poniżej.
Remote Temperature (zewnętrzny czujnik pokojowy)
Zmienna tylko do zapisu, która podaje do HVAC zewnętrzną wartość temperatury pokojowej, nadpisując wbudowany termistor jednostki wewnętrznej. Dowolny czujnik temperatury TapHome (bezprzewodowy, Modbus, Zigbee itd.) można do niej podłączyć prostą smart regułą: przy każdej zmianie czujnika źródłowego jego wartość w °C jest zapisywana do tego urządzenia.
Wartość zdalnej temperatury musi być odświeżana co najmniej raz na 15 sekund, w przeciwnym razie jednostka wraca do wbudowanego termistora do momentu pojawienia się nowej wartości. Skonfiguruj smart regułę tak, aby zapisywała przy każdej zmianie i cyklicznie (np. co 10 sekund), dzięki czemu krótkie okresy braku zmian czujnika nie zniwelują nadpisania.
Wartości ≤ 0 i NaN są ignorowane przez szablon — korzystaj z tej funkcji tylko wtedy, gdy masz niezawodny czujnik pokojowy po stronie TapHome.
Położenie żaluzji (pionowe)
Przełącznik wielowartościowy dla kąta pionowych żaluzji: 1, 2, 3, 4, Auto. Odczytuje heatpump.vane i zapisuje /control?cmd=heatpump&vane=…. HTTP API ProtoART dokumentuje także wartość swing — obecny szablon jej nie udostępnia.
Położenie żaluzji szerokich (poziome)
Przełącznik wielowartościowy dla kierunku poziomych żaluzji: Skrajnie w lewo, W lewo, Środek, W prawo, Skrajnie w prawo, Szeroko, Oscylacja. Odczytuje heatpump.widevane i zapisuje /control?cmd=heatpump&widevane=…. ProtoART dokumentuje także wartość split, której obecny szablon nie udostępnia.
Akcja serwisowa Reset na poziomie modułu
Jedyna akcja serwisowa na poziomie modułu — Reset — wysyła /control?cmd=restart i wywołuje restart ESP32. Przydatna po aktualizacjach firmware’u lub gdy linia UART CN105 się zawiesi.
Dodatkowe funkcje (niezaimplementowane)
ProtoART udostępnia znacznie więcej pól telemetrycznych, niż zużywa obecny szablon. Można je dodać w przyszłej rewizji szablonu:
- Temperatura wymiennika wewnętrznego (
heatpump.tinp) i temperatura zewnętrzna (heatpump.tout) — termistory wymiennika i jednostki zewnętrznej. - Ciśnienie wymiennika wewnętrznego (
heatpump.pinp) — diagnostyczne. - Zużycie energii (
heatpump.tpcns) — skumulowany licznik energii; można zmapować jako licznik energii elektrycznej TapHome. - Czas pracy (
heatpump.optime) — licznik motogodzin sprężarki. - Flaga pracy (
heatpump.oper) — sprężarka aktywna / standby. - Stan odszraniania (
heatpump.defrost) — true w trakcie odszraniania jednostki zewnętrznej. - Hot adjust (
heatpump.hotadjust) — flaga wstępnego podgrzewania. - Stan standby (
heatpump.standby) — jednostka wewnętrzna jest włączona, ale aktywnie nie grzeje/nie chłodzi. - Stan czujnika i-see (
heatpump.isee) — wykrywanie obecności w serii MSZ-FH. - Wartości czujnika zewnętrznego (
sensor.external.*) — temperatura, wilgotność i poziom baterii opcjonalnego bezprzewodowego czujnika CR2032. - Diagnostyka — stan linii UART CN105 (
sys.conhp), stan połączenia czujnika zewnętrznego (sys.conext), uptime modułu (sys.up), Wi-Fi RSSI (wifi.rssi), wersja firmware’u (fw.curr).
Opcjonalny bezprzewodowy czujnik zewnętrzny
ProtoART sprzedaje jako opcjonalny dodatek niewielki bezprzewodowy czujnik zasilany baterią (CR2032, LoRa / 2,4 GHz). Raportuje temperaturę i wilgotność otoczenia i służy do eliminowania efektu „bąbla cieplnego" wokół termistora jednostki wewnętrznej — wbudowany czujnik znajduje się wewnątrz obudowy i podczas grzania wykazuje temperaturę wyższą niż rzeczywista w pomieszczeniu.
Czujnik paruje się bezpośrednio z modułem ClimaControl (nie z TapHome). Jego wartości pojawiają się w stanie JSON pod sensor.external.* i są używane przez wewnętrzną logikę modułu. Obecny szablon TapHome ich nie odczytuje — jeśli czujnik zewnętrzny nie jest zakupiony, podłącz do urządzenia Remote Temperature dowolny czujnik temperatury TapHome.
Rozwiązywanie problemów
heatpump.local się nie rozwiązuje
- Potwierdź, że moduł ClimaControl dołączył do domowej sieci Wi-Fi — stan diody LED jest opisany w instrukcji ProtoART.
- Upewnij się, że CCU TapHome znajduje się w tej samej sieci LAN / VLAN co moduł. mDNS (Bonjour) jest link-local — nie przechodzi przez podsieci, jeśli na routerze nie skonfigurowano reflektora mDNS.
- Otwórz
http://heatpump.local/controlw przeglądarce na urządzeniu w tej samej sieci LAN — odpowiedź JSON potwierdzi, że moduł jest osiągalny. - Jeśli mDNS jest niedostępny, przypisz modułowi statyczną dzierżawę DHCP po jego adresie MAC i wpisz IP bezpośrednio w parametrze importu
IpAddress.
Wszystkie wartości po imporcie to NaN
Szablon odpytuje /control bez parametrów co 2,5 s. Jeśli wszystkie pola mają NaN, żądanie HTTP nie dochodzi do skutku:
- Sprawdź, że
IpAddresswskazuje osiągalny host. - Otwórz
http://{IpAddress}/controlw przeglądarce — jeśli zwraca formularz logowania lub stronę błędu, firmware modułu może być przestarzały; zaktualizuj go zgodnie z ProtoART Firmware Release Notes. - Sprawdź kabel CN105 — jeśli kabel jest odpięty lub jednostka wewnętrzna jest odłączona od zasilania, moduł się uruchamia, ale sekcja JSON dotycząca pompy ciepła zwraca puste / domyślne wartości. Diagnostyczna wartość
sys.conhp(obecnie nieudostępniana) spada w tym przypadku do0.
Remote Temperature nie przynosi efektu
- Sprawdź, że zapis odbywa się co najmniej co 15 s — przy dłuższym interwale jednostka między zapisami wraca do wewnętrznego termistora.
- Sprawdź, że zapisywana wartość jest dodatnią liczbą zmiennoprzecinkową (°C). Wartości
≤ 0iNaNsą jawnie ignorowane przez skrypt szablonu. - Niektóre jednostki wewnętrzne Mitsubishi Electric wymagają, aby jednostka była w trybie Chłodzenie, Grzanie lub Auto, aby zdalna temperatura działała. W trybach Osuszanie i Wentylacja sprężarka nie używa wartości zadanej, więc Remote Temperature nie ma widocznego wpływu.
Zapisy wartości zadanej są cicho nadpisywane
Jeśli inny sterownik (aplikacja MelCloud, termostat MHK, pilot IR) wyśle polecenie mniej więcej w tym samym czasie co TapHome, na magistrali CN105 wygrywa ostatnie polecenie. Jest to oczekiwane zachowanie systemu z wieloma sterownikami. Jeśli wartość zadana ma należeć do jednego sterownika, usuń pozostałe (lub ogranicz ich dostęp przez Wi-Fi / harmonogram).
Polecenia wentylatora lub żaluzji nie działają
Enum szablonu mapuje 0 – 5 dla wentylatora/żaluzji. Niektóre modele Mitsubishi Electric fizycznie nie obsługują każdego stopnia — na przykład jednostka bez trybu „Cichy" przyjmie polecenie, ale pracuje na najbliższym obsługiwanym stopniu. Przetestuj każdą prędkość przy użyciu oryginalnego pilota jednostki, aby sprawdzić, które stopnie dany model faktycznie udostępnia.
Sprzęt ProtoART jest otwarty także dla innych platform automatyki domowej (Home Assistant, OpenHAB, FHEM, Tasmota, Homey). Do jednego modułu może jednocześnie podłączyć się wielu klientów — na przykład TapHome i Home Assistant mogą jednocześnie odczytywać i zapisywać bez wzajemnego zakłócania, ponieważ moduł nie serializuje stanu między klientami. Unikaj sprzecznych zapisów z równolegle działających automatyzacji.