Faikin Ninja P1P2 — MQTT-handleiding

Een volledige handleiding voor het bedienen en uitlezen van een Faikin Ninja P1P2 via MQTT, van de eerste instelling tot de volledige referentie van topics, opdrachten en sensoren.

Dit gaat over de Faikin Ninja-module die op een Daikin P1/P2-besturingsbus is aangesloten: VRV en VRF, Sky Air, F-serie commercieel en kanaalsystemen met een Airbase- of zoneregelaar. Overal in deze tekst is het voorbeeld-basistopic ac/livingroom en is het voorbeeld-IP van de broker 192.168.1.10. Vervang beide door uw eigen waarden.

Dit is niet dezelfde MQTT-interface als die van de Faikin Faikout. De Ninja draait andere firmware met een andere topicindeling, dus automatiseringen die voor een Faikout zijn geschreven werken hier niet. Hebt u een Faikout, raadpleeg dan de MQTT-handleiding voor de Faikin Faikout. Paragraaf 5 bevat een vergelijking naast elkaar.

1. Wat MQTT u oplevert

De ingebouwde webpagina van de Ninja volstaat voor dagelijks gebruik. MQTT hebt u nodig wanneer de airconditioner deel moet uitmaken van iets groters.

• Automatisering. Schakel de unit vanuit van alles: aanwezigheid, een schema, een stroomprijsfeed, een deursensor, de temperatuur van een andere kamer.
• Echte meetgegevens. De P1/P2-bus draagt veel meer dan aan, uit en temperatuur. De Ninja publiceert binnen- en buitenthermistoren, koudemiddeldrukken, de stand van het expansieventiel, de status van compressor en ventilator, bedrijfsuren en de foutcodes van de unit zelf. Het meeste daarvan is onzichtbaar vanaf de wandbediening.
• Zones in kanaalsystemen. Hebt u een Daikin-zoneregelaar, dan wordt elke klep een afzonderlijk schakelbaar element.
• Eén plek voor alles. Home Assistant, Node-RED, openHAB en alles wat verder MQTT spreekt zien tegelijk hetzelfde apparaat.
• Het blijft lokaal. MQTT draait op uw eigen broker in uw eigen netwerk. Er verlaat niets het huis en er is geen account nodig.

2. Voordat u begint

U hebt drie dingen nodig.

1. De Ninja op uw WiFi, bereikbaar via zijn eigen webpagina. Is dat niet zo, doorloop dan eerst de installatiehandleiding.
2. Een MQTT-broker in uw netwerk. Gebruikt u Home Assistant, installeer dan de add-on Mosquitto broker; dat duurt een paar minuten en levert een broker plus een gebruikersnaam en wachtwoord op. Anders volstaat elke Mosquitto of compatibele broker op een machine die aan blijft.
3. Het IP-adres, de gebruikersnaam en het wachtwoord van de broker.

U hebt geen Home Assistant nodig om MQTT te gebruiken, en u hebt geen MQTT nodig om Home Assistant te gebruiken. Het zijn losse keuzes die toevallig goed samengaan.

3. Stap 1: wijs de Ninja naar uw MQTT-broker

Open de webpagina van de Ninja en ga naar MQTT settings.

Die laatste twee zijn belangrijker dan ze lijken. De Ninja bouwt al zijn topics daaruit op:

basistopic = <Topic> / <Friendly Name>

Dus Topic = ac en Friendly Name = livingroom geeft een basistopic ac/livingroom, en het statustopic wordt ac/livingroom/state.

Kies beide voordat u automatiseringen bouwt. Ze later wijzigen hernoemt elk topic en breekt stilzwijgend alles wat naar de oude verwijst. Een handige afspraak is één gedeeld voorvoegsel voor al uw units (ac) plus een kamernaam die niet gaat veranderen (livingroom, masterbed, office).

Sla op; de module maakt opnieuw verbinding en begint te publiceren.

4. Stap 2: controleer of hij verbonden is

Daar hebt u geen terminal voor nodig. Twee plekken laten het u meteen zien.

Op de pagina van de Ninja zelf

Ga naar de module. Bovenaan de pagina, naast de apparaatnaam, staat de brokerstatus. MQTT connected betekent dat de module uw broker heeft bereikt en publiceert.

Ontbreekt dat, dan klopt de host, poort, gebruikersnaam of het wachtwoord niet, of is de broker niet bereikbaar vanaf het netwerk waarop de module zit. Controleer de MQTT-instellingen opnieuw en zie daarna Problemen oplossen.

In Home Assistant

U hoeft niets met de hand toe te voegen. De Ninja publiceert de MQTT-discovery-berichten van Home Assistant, dus zodra hij de broker bereikt vindt Home Assistant hem vanzelf. Zolang de MQTT-integratie al is ingesteld en naar dezelfde broker wijst:

1. Ga naar Settings > Devices & services > MQTT en open de apparatenlijst.
2. Uw apparaat verschijnt binnen enkele seconden, genoemd naar de Friendly Name die u hebt ingesteld.
3. Open het en alles staat er al: een climate-entiteit met modus, doeltemperatuur, ventilatorsnelheid en lamel; een lange lijst diagnostische sensoren; en, als u een zoneregelaar hebt, een schakelaar voor elke klepzone.

U zou nooit met de hand een climate-entiteit in YAML hoeven schrijven voor een Ninja. Betrapt u zichzelf daarop, dan is er stroomopwaarts iets mis.

Liever controleren vanaf een terminal

Optioneel, en alleen de moeite waard als u de mosquitto-clienttools al hebt geïnstalleerd:

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

U zou ac/livingroom/availability moeten zien met online, en een volledige JSON-payload op ac/livingroom/state.

Komt er niets binnen, ga dan naar Problemen oplossen.

5. De topicstructuur

Alles hangt aan het basistopic dat u in paragraaf 3 hebt samengesteld. Met basistopic ac/livingroom:

Klimaat en besturing

Systeem en beheer

Voor de meeste automatisering hebt u er maar drie nodig: publiceren naar de .../set-topics en abonneren op state en availability.

Als u ook een Faikout hebt

De twee producten kiezen tegengestelde benaderingen, dus het loont ze naast elkaar te zien.

6. Opdrachten verzenden

Publiceer een gewone tekenreeks naar het bijbehorende .../set-topic. Er is geen JSON-omhulsel: de payload is de kale waarde.

power/set

mode/set

temp/set

De doeltemperatuur als getal, bijv. 24. Bereik 16 tot 32 °C, in stappen van 1.0 °C. U kunt dat bereik beperken met system/set_min_temp en system/set_max_temp (paragraaf 11).

fan/set

Welke snelheden u krijgt hangt af van de binnenunit. De module meldt de snelheden die uw unit werkelijk ondersteunt; een snelheid sturen die hij niet heeft, wordt genegeerd.

De gebruikelijke groepen zijn:

• 3 standen met auto: low, medium, high, auto
• 2 standen: low, high
• 4 standen zone/Airbase: low, medium, low_auto, medium_auto
• 6 standen zone/Airbase: low, medium, high, low_auto, medium_auto, high_auto

vane/set

Voorbeelden

# On, cooling, 24 C, auto fan, swinging
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'

Doordat elke besturing zijn eigen topic heeft, doet de volgorde er niet toe en stuurt u alleen wat u nodig hebt.

7. Zones in kanaalsystemen

Zit er een Daikin-zoneregelaar op de P1/P2-bus, dan kan de Ninja elke klep openen en sluiten.

Publiceer ON of OFF naar ac/livingroom/zone/<n>/set, waarbij <n> gelijk is aan 1 tot 8:

# Open zone 1, close zone 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'

De statuspayload meldt terug:

In Home Assistant wordt elke actieve zone automatisch als eigen schakelaar herkend, dus configureren hoeft niet.

Twee praktische opmerkingen. Zones verschijnen alleen als er een zoneregelaar aanwezig is, dus bij een gewone split zijn er helemaal geen zonesleutels. En alle zones tegelijk sluiten is een goede manier om een kanaalsysteem in de problemen te brengen: laat er minstens één open, of zet de unit uit.

8. Status uitlezen

De module publiceert één volledig JSON-object naar <base>/state zodra er iets verandert.

Alleen sensoren die uw unit werkelijk meldt verschijnen. De Ninja bepaalt wat de aangesloten binnen- en buitenunits publiceren en verbergt de rest, dus uw payload is korter dan het voorbeeld hieronder en twee verschillende Daikins leveren verschillende sleutels op. Dat is normaal. Schrijf automatiseringen op de sleutels die u op uw eigen unit ziet.

{
  "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
}

De sleutels die u als eerste moet kennen:

Een unit kan "power": "on" zijn met "action": "idle" en dat is volkomen normaal: hij is op temperatuur. Wilt u weten of hij echt werkt, kijk dan naar action, operating of f_comp_operating.

Abonneer u ook op <base>/availability. offline daar betekent dat de module is weggevallen, wat iets anders is dan een uitgeschakelde airconditioner.

9. Home Assistant via MQTT

Voeg de integratie MQTT toe en wijs die naar dezelfde broker. Dat is de hele installatie: de Ninja meldt zich aan en Home Assistant bouwt de rest.

Wat u krijgt:

• Een climate-entiteit met de modi heat, cool, dry, fan_only en off, de ventilatorstanden van uw unit, zwenkstanden 1 tot 5 en swing, en een stap van 1.0 °C.
• Sensoren en binaire sensoren voor elke thermistor, druk, actuator, urenteller, foutcode en modelaanduiding die uw unit meldt. De meeste komen onder Diagnostisch.
• Schakelaars voor elke actieve klepzone.

Entity-ID's volgen de Friendly Name, dus met livingroom krijgt u climate.livingroom, sensor.livingroom_outside_temperature, switch.livingroom_zone_1 enzovoort. Controleer de exacte namen in Developer tools > States voordat u YAML schrijft.

Een dashboardkaart

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

Een automatisering

De unit uitzetten zodra het huis comfortabel is, met action in plaats van power zodat hij niet afgaat terwijl de unit nog aan het werk is:

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

Letten op storingen

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

Die is het opzetten waard. De foutcode is dezelfde code die een monteur van de wandbediening afleest, en die vooraf weten scheelt een bezoek.

10. Andere platformen

Dezelfde topics werken overal. Publiceer tekenreeksen naar <base>/…/set, abonneer u op <base>/state.

mosquitto-opdrachtregel

# Watch everything for this device
mosquitto_sub -h 192.168.1.10 -u USER -P PASS -t 'ac/livingroom/#' -v

# Turn on and cool to 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'

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

Node-RED

Gebruik een MQTT in-node op ac/livingroom/state met de uitvoer ingesteld op een geparseerd JSON-object en lees dan msg.payload.power, msg.payload.room_temperature enzovoort.

Om te verzenden gebruikt u MQTT out met topic en payload leeg, zodat die uit het bericht komen. Payloads moeten tekenreeksen zijn, dus zet getallen eerst om.

De hele unit in één keer instellen:

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" }
];

Een dashboardschuifregelaar die de doeltemperatuur aanstuurt:

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

Alleen inschakelen als hij nu uit staat:

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;

Abonneren op ac/livingroom/availability is een goedkope manier om uw dashboard te vergrijzen wanneer de module wegvalt.

openHAB

Voeg een MQTT-broker-Thing toe en daarna een Generic MQTT Thing met kanalen die naar de topics wijzen. Een switch-kanaal op ac/livingroom/power/set met ON/OFF, een number-kanaal op ac/livingroom/temp/set, en statuskanalen die ac/livingroom/state lezen met een JSONPATH-transformatie zoals $.room_temperature.

11. Systeembeheer en opties

Deze staan onder <base>/system/. De meeste starten de module opnieuw op, dus koppel ze niet aan iets dat vaak afgaat.

system/set

factory wist ook uw WiFi- en MQTT-instellingen, dus de module komt terug op zijn eigen installatienetwerk en moet helemaal opnieuw worden ingesteld. Beschouw dit als laatste redmiddel.

Temperatuurgrenzen

Handig in een huurwoning of een kantoor: begrens het bereik en niemand zet in juli nog 16 °C.

Safe Mode

system/set_safemode met on of off. Start opnieuw op.

Modbus RTU ID

system/set_modbus_rtu_id met een getal van 1 tot 254, voor gebouwbeheerinstallaties met de RS485-uitvoering. Start opnieuw op.

Opties via MQTT

system/opt/rqt neemt een JSON-object aan en laat u meerdere instellingen tegelijk wijzigen zonder de webpagina:

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

Wat wordt geaccepteerd komt terug op system/opt/rps, dus abonneer u daarop om het te bevestigen in plaats van het aan te nemen.

Als u webpanel uitzet, verwijdert u uw eigen weg terug. Doe dat alleen als u zeker weet dat MQTT werkt.

system/info

Wordt periodiek gepubliceerd:

{
  "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 is de waarde om in de gaten te houden. Bij slechter dan ongeveer -80 dBm haalt u de module beter uit de metalen behuizing voordat u iets anders de schuld geeft.

12. Sensorreferentie

Alles hieronder wordt automatisch gedetecteerd. Meldt uw unit het niet, dan ontbreekt de sleutel in de statuspayload en wordt er in Home Assistant geen entiteit aangemaakt. Een korte lijst is geen storing.

De belangrijkste

Binnenthermistoren

Buitenthermistoren en drukken

De persgastemperatuur en de twee drukken samen komen het dichtst bij een live gezondheidscontrole van de buitenunit. Zet ze een seizoen lang in een grafiek en een afwijkende waarde valt lang op voordat er iets uitvalt.

Actuatoren en bedrijfsstatus

Uren en storingen

Waar de unit een storingshistorie bijhoudt, draagt elke vastgelegde gebeurtenis een regelnummer, de code, de datum en het unitnummer:

[
  {"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}
]

Moduletelemetrie

13. Problemen oplossen

Geen MQTT connected-badge op de webpagina. Controleer de host en de poort, daarna de gebruikersnaam en het wachtwoord. Zit de broker op een ander VLAN of subnet dan de module, dan is dat meestal het echte probleem.

De badge zegt verbonden, maar in Home Assistant verschijnt niets. Controleer of de MQTT-integratie van Home Assistant naar dezelfde broker wijst. Twee brokers in één netwerk is een veelgemaakte en verwarrende fout. Controleer daarna of discovery is ingeschakeld in de instellingen van de module.

Er ontbreken sensoren. Dat hoort zo. Alleen wat de aangesloten units melden wordt gepubliceerd, en een kleine split laat veel minder zien dan een VRV. Geen storing.

Geen zoneschakelaars. Zones hebben een Daikin-zoneregelaar op de P1/P2-bus nodig. Zonder die regelaar valt er niets te bedienen.

Opdrachten worden genegeerd. Payloads zijn gewone tekenreeksen en zijn hoofdlettergevoelig zoals beschreven: ON en OFF in hoofdletters voor aan/uit en zones, modusnamen in kleine letters. Een getal in plaats van een tekenreeks sturen voor de temperatuur mislukt in sommige clients, waaronder Node-RED.

De temperatuur gaat niet waar u hem wilt hebben. Controleer min_temp en max_temp in system/info. Mogelijk heeft iemand het bereik versmald.

Hij valt steeds weg. Kijk naar rssi in system/info. Rond -80 dBm of slechter is marginaal. Haal de module uit de metalen behuizing.

De unit staat aan maar er gebeurt niets. Kijk naar action en f_comp_operating. Is action gelijk aan idle, dan is hij op temperatuur. Draait de compressor nooit en is f_error_present waar, lees dan f_error_code en geef die door aan uw installateur.

Alles stopte na een instellingswijziging. Het hernoemen van Topic of Friendly Name hernoemt elk topic. Uw automatiseringen wijzen nog naar de oude.

14. Beknopt overzicht

Basistopic ac/livingroom. Vervang door het uwe.

Lezen (abonneren)

Besturen (publiceren)

Systeem (publiceren)

Sleutels om in de gaten te houden

Bronnen: de protocoldocumentatie van MQTT voor de Faikin Ninja P1P2. Het beschreven gedrag komt overeen met de firmware van augustus 2026; de webpagina van uw eigen module en de gepubliceerde system/info zijn maatgevend voor de versie die u hebt geïnstalleerd. Welke sensoren beschikbaar zijn verschilt per binnen- en buitenunit.