Faikin Ninja P1P2 — instrukcja MQTT

Kompletny przewodnik po sterowaniu modułem Faikin Ninja P1P2 i jego monitorowaniu przez MQTT, od pierwszej konfiguracji po pełny wykaz tematów, poleceń i czujników.

Dotyczy to modułu Faikin Ninja podłączonego do magistrali sterującej Daikin P1/P2: VRV i VRF, Sky Air, urządzenia komercyjne serii F oraz systemy kanałowe ze sterownikiem Airbase lub sterownikiem stref. W całym dokumencie przykładowy temat bazowy to ac/livingroom, a przykładowy adres IP brokera to 192.168.1.10. Oba należy zastąpić własnymi wartościami.

To nie jest ten sam interfejs MQTT co w module Faikin Faikout. Ninja działa na innym oprogramowaniu układowym i ma inny układ tematów, więc automatyzacje napisane dla modułu Faikout nie będą działać. Jeżeli posiadają Państwo moduł Faikout, prosimy zapoznać się z dokumentem Instrukcja MQTT modułu Faikin Faikout. Rozdział 5 zawiera porównanie obu rozwiązań.

1. Co daje MQTT

Wbudowana strona modułu Ninja w zupełności wystarcza do codziennej obsługi. MQTT przydaje się wtedy, gdy klimatyzator ma stać się częścią większej całości.

• Automatyzacja. Urządzenie można wyzwolić dowolnym zdarzeniem: obecnością, harmonogramem, danymi o cenie energii, czujnikiem otwarcia drzwi czy temperaturą w innym pomieszczeniu.
• Rzetelna telemetria. Magistrala P1/P2 przenosi znacznie więcej niż samo włączenie, wyłączenie i temperaturę. Ninja publikuje odczyty termistorów jednostki wewnętrznej i zewnętrznej, ciśnienia czynnika chłodniczego, położenie zaworu rozprężnego, stan sprężarki i wentylatora, liczniki godzin pracy oraz własne kody błędów urządzenia. Większości z tych danych nie widać na sterowniku ściennym.
• Strefy w systemach kanałowych. Jeżeli w instalacji pracuje sterownik stref Daikin, każda przepustnica staje się osobno sterowanym przełącznikiem.
• Wszystko w jednym miejscu. Home Assistant, Node-RED, openHAB i każde inne oprogramowanie obsługujące MQTT widzą to samo urządzenie jednocześnie.
• Działa lokalnie. MQTT działa na Państwa własnym brokerze, w Państwa własnej sieci. Żadne dane nie opuszczają domu i nie trzeba zakładać konta.

2. Przed rozpoczęciem

Potrzebne są trzy rzeczy.

1. Moduł Ninja podłączony do sieci WiFi, dostępny pod własną stroną internetową. Jeżeli tak nie jest, należy najpierw wykonać kroki opisane w dokumencie przewodnik instalacji.
2. Broker MQTT w Państwa sieci. W przypadku korzystania z Home Assistant należy zainstalować dodatek Mosquitto broker; zajmuje to kilka minut i zapewnia broker wraz z nazwą użytkownika i hasłem. W pozostałych przypadkach wystarczy dowolny broker Mosquitto lub zgodny, działający na stale włączonym komputerze.
3. Adres IP brokera, nazwa użytkownika i hasło.

Do korzystania z MQTT Home Assistant nie jest potrzebny, a do korzystania z Home Assistant nie jest potrzebny MQTT. To dwie niezależne decyzje, które po prostu dobrze się uzupełniają.

3. Krok 1: Wskazanie modułowi Ninja brokera MQTT

Należy otworzyć stronę modułu Ninja i przejść do sekcji MQTT settings.

Te dwa pola mają większe znaczenie, niż się wydaje. Ninja buduje z nich wszystkie swoje tematy:

temat bazowy = <Topic> / <Friendly Name>

Zatem Topic = ac oraz Friendly Name = livingroom dają temat bazowy ac/livingroom, a temat stanu przyjmuje postać ac/livingroom/state.

Oba należy wybrać przed zbudowaniem jakiejkolwiek automatyzacji. Późniejsza zmiana powoduje zmianę nazw wszystkich tematów i po cichu psuje wszystko, co odwołuje się do starych. Dobrą praktyką jest jeden wspólny przedrostek dla wszystkich urządzeń (ac) oraz nazwa pomieszczenia, która się nie zmieni (livingroom, masterbed, office).

Po zapisaniu moduł ponownie się łączy i zaczyna publikować dane.

4. Krok 2: Potwierdzenie połączenia

Nie jest do tego potrzebny terminal. Odpowiedź dają od razu dwa miejsca.

Na stronie samego modułu Ninja

Należy otworzyć stronę modułu. U góry strony, obok nazwy urządzenia, wyświetlany jest stan połączenia z brokerem. MQTT connected oznacza, że moduł nawiązał połączenie z brokerem i publikuje dane.

Jeżeli tego napisu nie ma, błędny jest host, port, nazwa użytkownika lub hasło, albo broker jest nieosiągalny z sieci, w której pracuje moduł. Należy ponownie sprawdzić ustawienia MQTT, a następnie przejść do rozdziału o rozwiązywaniu problemów.

W Home Assistant

Nie trzeba niczego dodawać ręcznie. Ninja publikuje komunikaty wykrywania MQTT dla Home Assistant, więc po nawiązaniu połączenia z brokerem Home Assistant znajdzie go samodzielnie. Warunkiem jest wcześniejsze skonfigurowanie integracji MQTT i wskazanie jej tego samego brokera:

1. Należy przejść do Settings > Devices & services > MQTT, a następnie otworzyć listę urządzeń.
2. Urządzenie pojawi się w ciągu kilku sekund, pod nazwą ustawioną w polu Friendly Name.
3. Po jego otwarciu wszystko jest już na miejscu: encja climate z trybem pracy, temperaturą zadaną, prędkością wentylatora i pozycją żaluzji, długa lista czujników diagnostycznych, a przy sterowniku stref także przełącznik dla każdej strefy przepustnicy.

W przypadku modułu Ninja nigdy nie powinno być potrzeby ręcznego pisania encji climate w YAML. Jeżeli okazuje się to konieczne, coś wcześniej zostało źle skonfigurowane.

Sprawdzenie z poziomu terminala

Opcjonalnie, i warto tylko wtedy, gdy narzędzia klienckie mosquitto są już zainstalowane:

mosquitto_sub -h 192.168.1.10 -u USER -P PASS -t 'ac/livingroom/#' -v

Temat ac/livingroom/availability powinien zgłaszać online, a na temacie ac/livingroom/state powinien pojawić się pełny ładunek JSON.

Jeżeli nic nie przychodzi, należy przejść do rozdziału o rozwiązywaniu problemów.

5. Struktura tematów

Wszystko opiera się na temacie bazowym zbudowanym w rozdziale 3. Dla tematu bazowego ac/livingroom:

Klimatyzacja i sterowanie

System i zarządzanie

W większości automatyzacji potrzebne są tylko trzy rzeczy: publikowanie w tematach .../set oraz subskrypcja tematów state i availability.

Jeżeli posiadają Państwo także moduł Faikout

Oba produkty przyjmują przeciwne podejście, warto więc zobaczyć je obok siebie.

6. Wysyłanie poleceń

Należy opublikować zwykły ciąg znaków w odpowiednim temacie .../set. Nie ma opakowania JSON: ładunkiem jest sama wartość.

power/set

mode/set

temp/set

Temperatura zadana jako liczba, np. 24. Zakres od 16 do 32 °C, w krokach co 1,0 °C. Zakres ten można zawęzić za pomocą system/set_min_temp i system/set_max_temp (rozdział 11).

fan/set

Dostępne prędkości zależą od jednostki wewnętrznej. Moduł zgłasza te, które dane urządzenie faktycznie obsługuje; wysłanie nieobsługiwanej wartości zostanie zignorowane.

Najczęstsze zestawy to:

• 3 prędkości z trybem automatycznym: low, medium, high, auto
• 2 prędkości: low, high
• 4 prędkości, strefy/Airbase: low, medium, low_auto, medium_auto
• 6 prędkości, strefy/Airbase: low, medium, high, low_auto, medium_auto, high_auto

vane/set

Przykłady

# Włączenie, chłodzenie, 24 C, wentylator automatyczny, oscylacja
mosquitto_pub -h 192.168.1.10 -t 'ac/livingroom/power/set' -m 'ON'
mosquitto_pub -h 192.168.1.10 -t 'ac/livingroom/mode/set'  -m 'cool'
mosquitto_pub -h 192.168.1.10 -t 'ac/livingroom/temp/set'  -m '24'
mosquitto_pub -h 192.168.1.10 -t 'ac/livingroom/fan/set'   -m 'auto'
mosquitto_pub -h 192.168.1.10 -t 'ac/livingroom/vane/set'  -m 'swing'

Ponieważ każda funkcja ma własny temat, kolejność nie ma znaczenia i można wysyłać tylko to, co jest potrzebne.

7. Strefy w systemach kanałowych

Jeżeli na magistrali P1/P2 pracuje sterownik stref Daikin, moduł Ninja może otwierać i zamykać każdą przepustnicę.

Należy opublikować ON lub OFF w temacie ac/livingroom/zone/<n>/set, gdzie <n> przyjmuje wartości od 1 do 8:

# Otwarcie strefy 1, zamknięcie strefy 3
mosquitto_pub -h 192.168.1.10 -t 'ac/livingroom/zone/1/set' -m 'ON'
mosquitto_pub -h 192.168.1.10 -t 'ac/livingroom/zone/3/set' -m 'OFF'

Ładunek stanu zwraca:

W Home Assistant każda aktywna strefa jest wykrywana automatycznie jako osobny przełącznik, więc konfiguracja nie jest potrzebna.

Dwie uwagi praktyczne. Strefy pojawiają się wyłącznie wtedy, gdy obecny jest sterownik stref, więc w zwykłym systemie split nie będzie żadnych kluczy stref. Ponadto zamknięcie wszystkich stref naraz to prosta droga do kłopotów z systemem kanałowym: należy zostawić otwartą co najmniej jedną strefę albo po prostu wyłączyć urządzenie.

8. Odczyt stanu

Moduł publikuje jeden kompletny obiekt JSON w temacie <base>/state przy każdej zmianie.

Pojawiają się wyłącznie te czujniki, które dane urządzenie faktycznie zgłasza. Ninja wykrywa, co publikują podłączone jednostki wewnętrzna i zewnętrzna, a resztę pomija, więc Państwa ładunek będzie krótszy niż poniższy przykład, a dwa różne urządzenia Daikin dadzą różne klucze. Jest to normalne. Automatyzacje należy pisać w oparciu o klucze widoczne we własnym urządzeniu.

{
  "power": "on",
  "mode": "cool",
  "action": "cooling",
  "temperature": 24,
  "fan": "auto",
  "vane": "swing",
  "room_temperature": 25.5,
  "outside_temperature": 32.0,
  "f_intake_temp": 25.0,
  "f_indoor_th1": 18.2,
  "f_indoor_th2": 24.8,
  "f_outdoor_th1": 32.0,
  "f_outdoor_th3": 75.4,
  "f_pe_pressure": 0.83,
  "f_pc_pressure": 2.40,
  "f_drain_pump": false,
  "f_electric_heater": false,
  "f_comp_operating": true,
  "operating": true,
  "f_fan_step": 3,
  "f_ev_pulses": 240,
  "f_id_op_hours": 1250,
  "f_error_present": false,
  "f_error_code": "",
  "f_indoor_model": "FBA100BVMA",
  "f_outdoor_model": "RZA100DV1",
  "zone_count": 4,
  "zone_1": true,
  "zone_2": true,
  "zone_3": false,
  "zone_4": false
}

Klucze, które warto poznać w pierwszej kolejności:

Urządzenie może mieć "power": "on" przy "action": "idle" i jest to całkowicie normalne: osiągnęło temperaturę zadaną. Aby sprawdzić, czy rzeczywiście pracuje, należy spojrzeć na action, operating lub f_comp_operating.

Warto subskrybować także temat <base>/availability. Wartość offline oznacza, że rozłączył się moduł, co jest czymś innym niż wyłączony klimatyzator.

9. Home Assistant przez MQTT

Należy dodać integrację MQTT i wskazać jej ten sam broker. To cała konfiguracja: Ninja sam się zgłasza, a Home Assistant buduje resztę.

Co Państwo otrzymują:

• Encję climate z trybami heat, cool, dry, fan_only i off, prędkościami wentylatora obsługiwanymi przez dane urządzenie, pozycjami żaluzji od 1 do 5 oraz swing, a także krokiem 1,0 °C.
• Czujniki i czujniki binarne dla każdego termistora, ciśnienia, elementu wykonawczego, licznika godzin, kodu błędu i oznaczenia modelu zgłaszanego przez urządzenie. Większość trafia do kategorii Diagnostic.
• Przełączniki dla każdej aktywnej strefy przepustnicy.

Identyfikatory encji wynikają z pola Friendly Name, więc przy wartości livingroom otrzymają Państwo climate.livingroom, sensor.livingroom_outside_temperature, switch.livingroom_zone_1 i tak dalej. Dokładne nazwy należy sprawdzić w Developer tools > States przed pisaniem kodu YAML.

Karta na pulpicie

type: vertical-stack
cards:
  - type: thermostat
    entity: climate.livingroom

  - type: entities
    title: Zones
    entities:
      - entity: switch.livingroom_zone_1
        name: Living
      - entity: switch.livingroom_zone_2
        name: Master bed
      - entity: switch.livingroom_zone_3
        name: Study
      - entity: switch.livingroom_zone_4
        name: Kids

  - type: glance
    title: Right now
    columns: 3
    entities:
      - entity: sensor.livingroom_room_temperature
        name: Room
      - entity: sensor.livingroom_outside_temperature
        name: Outside
      - entity: binary_sensor.livingroom_compressor_operating
        name: Compressor

  - type: history-graph
    hours_to_show: 24
    entities:
      - sensor.livingroom_room_temperature
      - sensor.livingroom_outside_temperature
      - sensor.livingroom_od_pc_pressure

Automatyzacja

Wyłączenie urządzenia, gdy w domu zrobi się komfortowo. Wykorzystano klucz action, a nie power, aby automatyzacja nie zadziałała w chwili, gdy urządzenie nadal pracuje:

alias: Living room off when settled
triggers:
  - trigger: state
    entity_id: climate.livingroom
    attribute: hvac_action
    to: idle
    for: "00:20:00"
conditions:
  - condition: numeric_state
    entity_id: sensor.livingroom_room_temperature
    below: 25
actions:
  - action: climate.turn_off
    target:
      entity_id: climate.livingroom
mode: single

Nadzór nad usterkami

alias: Air conditioner fault
triggers:
  - trigger: state
    entity_id: binary_sensor.livingroom_ac_error_present
    to: "on"
actions:
  - action: notify.mobile_app_phone
    data:
      title: Air conditioner fault
      message: >-
        Error {{ states('sensor.livingroom_ac_error_code') }} on
        {{ state_attr('climate.livingroom','friendly_name') }}.
mode: single

Tę automatyzację warto skonfigurować. Kod błędu jest tym samym kodem, który serwisant odczytałby ze sterownika ściennego, a znajomość tego kodu przed zgłoszeniem oszczędza jedną wizytę.

10. Inne platformy

Te same tematy działają wszędzie. Ciągi znaków należy publikować w <base>/…/set, a subskrybować <base>/state.

Wiersz poleceń mosquitto

# Podgląd wszystkiego dla tego urządzenia
mosquitto_sub -h 192.168.1.10 -u USER -P PASS -t 'ac/livingroom/#' -v

# Włączenie i chłodzenie do 23
mosquitto_pub -h 192.168.1.10 -t 'ac/livingroom/power/set' -m 'ON'
mosquitto_pub -h 192.168.1.10 -t 'ac/livingroom/mode/set'  -m 'cool'
mosquitto_pub -h 192.168.1.10 -t 'ac/livingroom/temp/set'  -m '23'

# Otwarcie strefy 1
mosquitto_pub -h 192.168.1.10 -t 'ac/livingroom/zone/1/set' -m 'ON'

Node-RED

Należy użyć węzła MQTT in na temacie ac/livingroom/state z wyjściem ustawionym na sparsowany obiekt JSON, a następnie odczytywać msg.payload.power, msg.payload.room_temperature i tak dalej.

Do wysyłania należy użyć węzła MQTT out z pustym polem tematu i ładunku, aby pochodziły z komunikatu. Ładunki muszą być ciągami znaków, więc liczby trzeba wcześniej przekonwertować.

Ustawienie całego urządzenia za jednym razem:

const base = "ac/livingroom";
return [
    { topic: base + "/power/set", payload: "ON" },
    { topic: base + "/mode/set",  payload: "cool" },
    { topic: base + "/temp/set",  payload: "24" },
    { topic: base + "/fan/set",   payload: "auto" }
];

Suwak na pulpicie sterujący temperaturą zadaną:

msg.topic = "ac/livingroom/temp/set";
msg.payload = String(msg.payload);
return msg;

Włączenie tylko wtedy, gdy urządzenie jest wyłączone:

const p = typeof msg.payload === 'string'
    ? JSON.parse(msg.payload)
    : msg.payload;
if (p.power !== "on") {
    return [{ topic: "ac/livingroom/power/set", payload: "ON" }];
}
return null;

Subskrypcja tematu ac/livingroom/availability to tani sposób na wygaszenie pulpitu, gdy moduł się rozłączy.

openHAB

Należy dodać obiekt MQTT Broker Thing, a następnie Generic MQTT Thing z kanałami wskazującymi tematy. Kanał typu switch na temacie ac/livingroom/power/set z wartościami ON/OFF, kanał liczbowy na temacie ac/livingroom/temp/set oraz kanały stanu odczytujące ac/livingroom/state z przekształceniem JSONPATH, na przykład $.room_temperature.

11. Zarządzanie systemem i opcje

Znajdują się one pod <base>/system/. Większość z nich powoduje ponowne uruchomienie modułu, nie należy więc wpinać ich w mechanizmy wyzwalane często.

system/set

factory kasuje również ustawienia WiFi i MQTT, więc moduł wraca do własnej sieci konfiguracyjnej i trzeba go skonfigurować od zera. Należy traktować to jako ostateczność.

Limity temperatury

Przydatne w wynajmowanym lokalu lub biurze: po ograniczeniu zakresu nikt nie ustawi 16 °C w lipcu.

Tryb bezpieczny

system/set_safemode z wartością on lub off. Powoduje restart.

Modbus RTU ID

system/set_modbus_rtu_id z liczbą od 1 do 254, dla instalacji zarządzania budynkiem korzystających z wersji RS485. Powoduje restart.

Opcje przez MQTT

system/opt/rqt przyjmuje obiekt JSON i pozwala zmienić kilka ustawień naraz, bez korzystania ze strony internetowej:

{
  "options": {
    "homekit": "On",
    "mode": "All",
    "safemode": "Off",
    "webpanel": "On"
  }
}

Wszystko, co zostanie przyjęte, jest odsyłane w temacie system/opt/rps, warto więc go subskrybować i potwierdzać zamiast zakładać.

Wyłączenie webpanel odbiera Państwu drogę powrotną. Należy to robić tylko wtedy, gdy mają Państwo pewność, że MQTT działa.

system/info

Publikowane okresowo:

{
  "connection_state": "online",
  "safe_mode": "Off",
  "reset_reason": "Software reset via ESP_RESTART",
  "web_panel": "On",
  "free_heap": "68.45",
  "rssi": "-62",
  "bssid": "AA:BB:CC:DD:EE:FF",
  "up_time": 172800,
  "min_temp": 16,
  "max_temp": 32,
  "protocol_ver": "P1P2"
}

rssi to wartość, którą warto obserwować. Przy wyniku gorszym niż mniej więcej -80 dBm należy przenieść moduł poza metalową obudowę, zanim zacznie się szukać innych przyczyn.

12. Wykaz czujników

Wszystko poniżej jest wykrywane automatycznie. Jeżeli urządzenie danej wartości nie zgłasza, klucz nie pojawia się w ładunku stanu i w Home Assistant nie powstaje żadna encja. Krótka lista nie oznacza usterki.

Najważniejsze

Termistory jednostki wewnętrznej

Termistory i ciśnienia jednostki zewnętrznej

Temperatura tłoczenia razem z obydwoma ciśnieniami to najbliższy odpowiednik bieżącej kontroli stanu jednostki zewnętrznej. Wystarczy zestawić je na wykresie przez cały sezon, a nietypowy odczyt rzuci się w oczy na długo przed zadziałaniem zabezpieczeń.

Elementy wykonawcze i stan pracy

Godziny pracy i usterki

Jeżeli urządzenie przechowuje historię usterek, każde zapisane zdarzenie zawiera numer wiersza, kod, datę i numer jednostki:

[
  {"row": 1, "code": "A9-01", "date": "17/01/24", "unit": 0},
  {"row": 2, "code": "E7-57", "date": "10/11/23", "unit": 0},
  {"row": 3, "code": "C2-04", "date": "05/08/23", "unit": 0}
]

Telemetria modułu

13. Rozwiązywanie problemów

Na stronie internetowej nie ma plakietki MQTT connected. Należy sprawdzić host i port, a następnie nazwę użytkownika i hasło. Jeżeli broker znajduje się w innej sieci VLAN lub podsieci niż moduł, zwykle to jest właściwa przyczyna.

Plakietka pokazuje połączenie, ale w Home Assistant nic się nie pojawia. Należy potwierdzić, że integracja MQTT w Home Assistant wskazuje ten sam broker. Dwa brokery w jednej sieci to częsty i mylący błąd. Następnie należy sprawdzić, czy w ustawieniach modułu włączone jest wykrywanie.

Brakuje niektórych czujników. Tak ma być. Publikowane jest wyłącznie to, co zgłaszają podłączone jednostki, a mały system split pokaże znacznie mniej niż VRV. To nie jest usterka.

Brak przełączników stref. Strefy wymagają sterownika stref Daikin na magistrali P1/P2. Bez niego nie ma czym sterować.

Polecenia są ignorowane. Ładunki to zwykłe ciągi znaków i rozróżniają wielkość liter zgodnie z dokumentacją: ON i OFF wielkimi literami dla zasilania i stref, nazwy trybów małymi literami. Wysłanie liczby zamiast ciągu znaków dla temperatury zakończy się niepowodzeniem w części klientów, w tym w Node-RED.

Temperatura nie osiąga oczekiwanej wartości. Należy sprawdzić min_temp i max_temp w system/info. Ktoś mógł zawęzić zakres.

Połączenie ciągle się zrywa. Należy sprawdzić rssi w system/info. Około -80 dBm lub gorzej to wartość graniczna. Moduł należy przenieść poza metalową obudowę.

Urządzenie jest włączone, ale nic się nie dzieje. Należy sprawdzić action i f_comp_operating. Jeżeli action ma wartość idle, temperatura zadana została osiągnięta. Jeżeli sprężarka w ogóle nie pracuje, a f_error_present ma wartość true, należy odczytać f_error_code i podać go instalatorowi.

Wszystko przestało działać po zmianie ustawień. Zmiana pola Topic lub Friendly Name zmienia nazwy wszystkich tematów. Automatyzacje nadal wskazują stare.

14. Skrócony wykaz

Temat bazowy ac/livingroom. Należy zastąpić własnym.

Odczyt (subskrypcja)

Sterowanie (publikacja)

System (publikacja)

Klucze warte obserwacji

Źródła: dokumentacja protokołu MQTT dla Faikin Ninja P1P2. Opisane zachowanie odpowiada oprogramowaniu układowemu według stanu na sierpień 2026; dla zainstalowanej u Państwa wersji rozstrzygające są własna strona modułu oraz publikowany temat system/info. Dostępność czujników zależy od jednostki wewnętrznej i zewnętrznej.