Faikin Ninja P1P2 — MQTT-Handbuch

Ein vollständiger Leitfaden zur Steuerung und Überwachung eines Faikin Ninja P1P2 über MQTT, von der ersten Einrichtung bis zur vollständigen Topic-, Befehls- und Sensorreferenz.

Dies betrifft das Faikin Ninja Modul, das an einem Daikin P1/P2-Steuerbus betrieben wird: VRV und VRF, Sky Air, F-Serie für gewerbliche Anlagen sowie Kanalgeräte mit Airbase- oder Zonenregler. Durchgehend lautet das Beispiel-Basistopic ac/livingroom und die Beispiel-Broker-IP 192.168.1.10. Ersetzen Sie beide durch Ihre eigenen Werte.

Dies ist nicht dieselbe MQTT-Schnittstelle wie beim Faikin Faikout. Der Ninja verwendet eine andere Firmware mit einem anderen Topic-Aufbau, daher lassen sich Automationen für einen Faikout nicht übertragen. Wenn Sie einen Faikout haben, lesen Sie stattdessen das Faikin Faikout MQTT-Handbuch. Abschnitt 5 enthält einen direkten Vergleich.

1. Was MQTT Ihnen bietet

Die integrierte Weboberfläche des Ninja reicht für den täglichen Gebrauch aus. MQTT brauchen Sie dann, wenn die Klimaanlage Teil von etwas Größerem werden soll.

• Automatisierung. Lösen Sie das Gerät durch beliebige Ereignisse aus: Anwesenheit, einen Zeitplan, einen Strompreis-Feed, einen Türsensor, die Temperatur eines anderen Raums.
• Echte Messtechnik. Der P1/P2-Bus überträgt weit mehr als Ein, Aus und Temperatur. Der Ninja veröffentlicht Thermistoren von Innen- und Außengerät, Kältemitteldrücke, die Position des Expansionsventils, den Zustand von Verdichter und Ventilator, Betriebsstunden und die Fehlercodes des Geräts selbst. Das meiste davon ist am Wandregler nicht sichtbar.
• Zonen bei Kanalgeräten. Wenn Sie einen Daikin Zonenregler haben, wird jede Klappe zu einem einzeln schaltbaren Schalter.
• Alles an einem Ort. Home Assistant, Node-RED, openHAB und alles andere, was MQTT spricht, sehen dasselbe Gerät gleichzeitig.
• Es bleibt lokal. MQTT läuft auf Ihrem eigenen Broker in Ihrem eigenen Netzwerk. Nichts verlässt das Haus, und es muss kein Konto angelegt werden.

2. Bevor Sie beginnen

Sie benötigen drei Dinge.

1. Der Ninja in Ihrem WiFi, erreichbar über seine eigene Weboberfläche. Falls nicht, lesen Sie zuerst die Installationsanleitung.
2. Ein MQTT-Broker in Ihrem Netzwerk. Wenn Sie Home Assistant betreiben, installieren Sie das Add-on Mosquitto broker; das dauert einige Minuten und liefert Ihnen einen Broker samt Benutzername und Passwort. Ansonsten genügt jeder Mosquitto- oder kompatible Broker auf einem Rechner, der dauerhaft läuft.
3. Die IP-Adresse, den Benutzernamen und das Passwort des Brokers.

Sie brauchen kein Home Assistant, um MQTT zu nutzen, und Sie brauchen kein MQTT, um Home Assistant zu nutzen. Das sind getrennte Entscheidungen, die zufällig gut zusammenpassen.

3. Schritt 1: Den Ninja auf Ihren MQTT-Broker ausrichten

Öffnen Sie die Weboberfläche des Ninja und wechseln Sie zu den MQTT settings.

Die letzten beiden sind wichtiger, als sie aussehen. Der Ninja bildet daraus sämtliche Topics:

Basistopic = <Topic> / <Friendly Name>

Also ergibt Topic = ac und Friendly Name = livingroom ein Basistopic von ac/livingroom, und das State-Topic lautet dann ac/livingroom/state.

Wählen Sie beide vor dem Aufbau jeder Automation. Eine spätere Änderung benennt sämtliche Topics um und legt stillschweigend alles lahm, was sich auf die alten bezieht. Eine bewährte Konvention ist ein gemeinsames Präfix für alle Ihre Geräte (ac) plus einen Raumnamen, der sich nicht ändert (livingroom, masterbed, office).

Speichern Sie; das Modul verbindet sich neu und beginnt zu publizieren.

4. Schritt 2: Verbindung bestätigen

Dafür brauchen Sie kein Terminal. Zwei Stellen zeigen es Ihnen sofort.

Auf der eigenen Seite des Ninja

Rufen Sie das Modul auf. Oben auf der Seite, neben dem Gerätenamen, wird der Broker-Status angezeigt. MQTT connected bedeutet, dass das Modul Ihren Broker erreicht hat und publiziert.

Fehlt diese Anzeige, sind entweder Host, Port, Benutzername oder Passwort falsch, oder der Broker ist aus dem Netzwerk des Moduls nicht erreichbar. Prüfen Sie die MQTT-Einstellungen erneut und lesen Sie dann die Fehlersuche.

In Home Assistant

Nichts von Hand hinzuzufügen. Der Ninja veröffentlicht die MQTT-Discovery-Nachrichten von Home Assistant. Sobald er den Broker erreicht, gilt: Home Assistant findet ihn von selbst. Vorausgesetzt, die MQTT-Integration ist bereits eingerichtet und auf denselben Broker gerichtet:

1. Gehen Sie zu Einstellungen > Geräte & Dienste > MQTT und öffnen Sie dann die Geräteliste.
2. Ihr Gerät erscheint innerhalb weniger Sekunden, benannt nach dem von Ihnen gesetzten Friendly Name.
3. Öffnen Sie es, und alles ist bereits vorhanden: eine climate-Entität mit Modus, Solltemperatur, Lüfterstufe und Lamelle; eine lange Liste von Diagnosesensoren; und, falls Sie einen Zonenregler haben, ein Schalter für jede Klappenzone.

Sie sollten für einen Ninja niemals eine climate-Entität von Hand in YAML schreiben müssen. Wenn Sie das tun, stimmt weiter oben etwas nicht.

Falls Sie lieber im Terminal prüfen

Optional und nur sinnvoll, wenn Sie die mosquitto-Client-Werkzeuge bereits installiert haben:

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

Sie sollten sehen, dass ac/livingroom/availability meldet online, und einen vollständigen JSON-Payload auf ac/livingroom/state.

Wenn nichts eintrifft, springen Sie zur Fehlersuche.

5. Die Topic-Struktur

Alles hängt an dem Basistopic, das Sie in Abschnitt 3 gebildet haben. Mit dem Basistopic ac/livingroom:

Klima und Steuerung

System und Verwaltung

Für die meisten Automationen brauchen Sie nur drei: publizieren Sie auf die .../set-Topics und abonnieren Sie state und availability.

Falls Sie auch einen Faikout haben

Die beiden Produkte verfolgen gegensätzliche Ansätze, daher lohnt sich ein direkter Vergleich.

6. Befehle senden

Publizieren Sie eine einfache Zeichenkette auf das jeweilige .../set-Topic. Es gibt keinen JSON-Rahmen: der Payload ist der reine Wert.

power/set

mode/set

temp/set

Die Solltemperatur als Zahl, z. B. 24. Bereich 16 bis 32 °C, in 1.0 °C-Schritten. Sie können diesen Bereich mit system/set_min_temp und system/set_max_temp einschränken (Abschnitt 11).

fan/set

Welche Stufen verfügbar sind, hängt vom Innengerät ab. Das Modul meldet die Stufen, die Ihr Gerät tatsächlich unterstützt; eine nicht vorhandene Stufe zu senden, wird ignoriert.

Die üblichen Gruppierungen sind:

• 3 Stufen mit Automatik: low, medium, high, auto
• 2 Stufen: low, high
• 4 Stufen Zone/Airbase: low, medium, low_auto, medium_auto
• 6 Stufen Zone/Airbase: low, medium, high, low_auto, medium_auto, high_auto

vane/set

Beispiele

# 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'

Da jede Steuerung ein eigenes Topic hat, spielt die Reihenfolge keine Rolle, und Sie können nur die senden, die Sie brauchen.

7. Zonen bei Kanalgeräten

Wenn ein Daikin Zonenregler am P1/P2-Bus hängt, kann der Ninja jede Klappe öffnen und schließen.

Publizieren Sie ON oder OFF auf ac/livingroom/zone/<n>/set, wobei <n> den Wert 1 bis 8 hat:

# 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'

Der State-Payload meldet zurück:

In Home Assistant wird jede aktive Zone automatisch als eigener Schalter erkannt, es ist keine Konfiguration nötig.

Zwei praktische Hinweise. Zonen erscheinen nur, wenn ein Zonenregler vorhanden ist; an einem einfachen Split-Gerät gibt es daher überhaupt keine Zonenschlüssel. Und alle Zonen gleichzeitig zu schließen, ist ein sicherer Weg, ein Kanalgerät zu überlasten: lassen Sie mindestens eine offen oder schalten Sie das Gerät stattdessen aus.

8. Status auslesen

Das Modul veröffentlicht bei jeder Änderung ein vollständiges JSON-Objekt auf <base>/state.

Es erscheinen nur Sensoren, die Ihr Gerät tatsächlich meldet. Der Ninja erkennt, was die angeschlossenen Innen- und Außengeräte veröffentlichen, und blendet den Rest aus. Ihr Payload wird daher kürzer sein als das Beispiel unten, und zwei verschiedene Daikin-Geräte liefern unterschiedliche Schlüssel. Das ist normal. Schreiben Sie Automationen gegen die Schlüssel, die Sie an Ihrem eigenen Gerät sehen.

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

Die zuerst wichtigen Schlüssel:

Ein Gerät kann "power": "on" sein und dabei "action": "idle" melden, und das ist völlig normal: sie hat die Temperatur erreicht. Wenn Sie wissen wollen, ob sie wirklich arbeitet, sehen Sie sich action, operating oder f_comp_operating an.

Abonnieren Sie auch <base>/availability. offline bedeutet dort, dass das Modul ausgefallen ist, was etwas anderes ist als eine ausgeschaltete Klimaanlage.

9. Home Assistant über MQTT

Fügen Sie die Integration MQTT hinzu und richten Sie sie auf denselben Broker aus. Mehr ist nicht einzurichten: der Ninja meldet sich selbst an, und Home Assistant baut alles auf.

Was Sie erhalten:

• Eine climate-Entität mit den Modi heat, cool, dry, fan_only und off, den Lüftermodi Ihres Geräts, den Schwenkpositionen 1 bis 5 und swing sowie einer Schrittweite von 1.0 °C.
• Sensoren und Binärsensoren für jeden Thermistor, jeden Druck, jeden Aktor, jeden Stundenzähler, jeden Fehlercode und jede Modellbezeichnung, die Ihr Gerät meldet. Die meisten landen unter Diagnose.
• Schalter für jede aktive Klappenzone.

Die Entity-IDs folgen dem Friendly Name, mit livingroom erhalten Sie also climate.livingroom, sensor.livingroom_outside_temperature, switch.livingroom_zone_1 und so weiter. Prüfen Sie die genauen Namen unter Entwicklerwerkzeuge > Zustände, bevor Sie YAML schreiben.

Eine Dashboard-Karte

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

Eine Automation

Das Gerät ausschalten, sobald das Haus behaglich ist, und zwar anhand von action statt power, damit sie nicht auslöst, während das Gerät noch arbeitet:

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

Auf Störungen achten

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

Das lohnt sich einzurichten. Der Fehlercode ist derselbe, den ein Techniker am Wandregler ablesen würde, und ihn vorab zu kennen, erspart oft einen Besuch.

10. Andere Plattformen

Dieselben Topics funktionieren überall. Publizieren Sie Zeichenketten auf <base>/…/set, abonnieren Sie <base>/state.

mosquitto-Kommandozeile

# 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

Verwenden Sie einen MQTT in-Node auf ac/livingroom/state, dessen Ausgabe auf ein geparstes JSON-Objekt gesetzt ist, und lesen Sie dann msg.payload.power, msg.payload.room_temperature und so weiter.

Zum Senden verwenden Sie MQTT out, wobei Topic und Payload leer bleiben, damit sie aus der Nachricht stammen. Payloads müssen Zeichenketten sein, konvertieren Sie Zahlen also vorher.

Das gesamte Gerät in einem Zug einstellen:

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

Ein Dashboard-Schieberegler, der die Solltemperatur steuert:

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

Nur einschalten, wenn es derzeit ausgeschaltet ist:

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;

Das Abonnieren von ac/livingroom/availability ist eine einfache Möglichkeit, Ihr Dashboard auszugrauen, wenn das Modul ausfällt.

openHAB

Legen Sie ein MQTT Broker Thing an, dann ein Generic MQTT Thing mit Kanälen, die auf die Topics zeigen. Ein Switch-Kanal auf ac/livingroom/power/set mit ON/OFF, ein Number-Kanal auf ac/livingroom/temp/set und Statuskanäle, die ac/livingroom/state mit einer JSONPATH-Transformation wie $.room_temperature auslesen.

11. Systemverwaltung und Optionen

Diese liegen unter <base>/system/. Die meisten davon starten das Modul neu, binden Sie sie daher nicht in etwas ein, das häufig auslöst.

system/set

factory löscht auch Ihre WiFi- und MQTT-Einstellungen, sodass das Modul mit seinem eigenen Einrichtungsnetzwerk zurückkehrt und komplett neu konfiguriert werden muss. Betrachten Sie das als letztes Mittel.

Temperaturgrenzen

Nützlich in einer Mietwohnung oder einem Büro: begrenzen Sie den Bereich, und niemand kann im Juli 16 °C einstellen.

Safe Mode

system/set_safemode mit on oder off. Startet neu.

Modbus RTU ID

system/set_modbus_rtu_id mit einer Zahl von 1 bis 254, für gebäudetechnische Anlagen mit der RS485-Variante. Startet neu.

Optionen über MQTT

system/opt/rqt nimmt ein JSON-Objekt entgegen und erlaubt es, mehrere Einstellungen auf einmal ohne die Weboberfläche zu ändern:

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

Was übernommen wird, wird auf system/opt/rps zurückgemeldet; abonnieren Sie dieses Topic zur Bestätigung, statt es anzunehmen.

Wenn Sie webpanel abschalten, nehmen Sie sich selbst den Weg zurück. Tun Sie das nur, wenn Sie sicher sind, dass MQTT funktioniert.

system/info

Wird periodisch veröffentlicht:

{
  "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 ist der entscheidende Wert. Alles schlechter als etwa -80 dBm, und Sie sollten das Modul aus dem Metallgehäuse holen, bevor Sie etwas anderem die Schuld geben.

12. Sensorreferenz

Alles Folgende wird automatisch erkannt. Wenn Ihr Gerät etwas nicht meldet, fehlt der Schlüssel im State-Payload und in Home Assistant wird keine Entität angelegt. Eine kurze Liste ist kein Fehler.

Die wichtigsten

Thermistoren im Innengerät

Außenthermistoren und Drücke

Drucktemperatur und die beiden Drücke zusammen kommen einer laufenden Zustandsprüfung des Außengeräts am nächsten. Stellen Sie sie über eine Saison grafisch dar, und ein abweichender Wert fällt lange auf, bevor etwas auslöst.

Aktoren und Betriebszustand

Stunden und Störungen

Sofern das Gerät eine Störungshistorie führt, trägt jedes aufgezeichnete Ereignis eine Zeilennummer, den Code, das Datum und die Gerätenummer:

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

Modul-Telemetrie

13. Fehlersuche

Kein MQTT connected Hinweis auf der Weboberfläche. Prüfen Sie Host und Port, dann Benutzername und Passwort. Liegt der Broker in einem anderen VLAN oder Subnetz als das Modul, ist das meist die eigentliche Ursache.

Der Hinweis zeigt verbunden, aber in Home Assistant erscheint nichts. Vergewissern Sie sich, dass die MQTT-Integration von Home Assistant auf den gleichen Broker zeigt. Zwei Broker in einem Netzwerk sind ein häufiger und verwirrender Fehler. Prüfen Sie anschließend, ob die Discovery in den Einstellungen des Moduls aktiviert ist.

Einige Sensoren fehlen. Das ist zu erwarten. Veröffentlicht wird nur, was die angeschlossenen Geräte melden, und ein kleines Split-Gerät zeigt weit weniger als ein VRV. Kein Fehler.

Keine Zonenschalter. Zonen erfordern einen Daikin Zonenregler am P1/P2-Bus. Ohne einen solchen gibt es nichts zu steuern.

Befehle werden ignoriert. Payloads sind einfache Zeichenketten und beachten wie dokumentiert die Groß- und Kleinschreibung: ON und OFF in Großbuchstaben für Ein/Aus und Zonen, Modusnamen in Kleinbuchstaben. Für die Temperatur eine Zahl statt einer Zeichenkette zu senden, schlägt in manchen Clients fehl, Node-RED eingeschlossen.

Die Temperatur lässt sich nicht wie gewünscht einstellen. Prüfen Sie min_temp und max_temp unter system/info. Möglicherweise hat jemand den Bereich eingeschränkt.

Die Verbindung bricht immer wieder ab. Sehen Sie sich rssi unter system/info an. Um -80 dBm oder schlechter ist grenzwertig. Bringen Sie das Modul außerhalb des Metallgehäuses an.

Das Gerät ist eingeschaltet, aber es passiert nichts. Sehen Sie sich action und f_comp_operating an. Wenn action den Wert idle hat, ist die Temperatur erreicht. Wenn der Verdichter nie läuft und f_error_present wahr ist, lesen Sie f_error_code aus und nennen Sie ihn Ihrem Installateur.

Nach einer Einstellungsänderung geht nichts mehr. Das Umbenennen von Topic oder Friendly Name benennt sämtliche Topics um. Ihre Automationen zeigen weiterhin auf die alten.

14. Kurzreferenz

Basistopic ac/livingroom. Ersetzen Sie es durch Ihres.

Lesen (abonnieren)

Steuern (publizieren)

System (publizieren)

Schlüssel, die man beobachten sollte

Quellen: die MQTT-Protokolldokumentation des Faikin Ninja P1P2. Das beschriebene Verhalten entspricht der Firmware mit Stand August 2026; maßgeblich für die bei Ihnen installierte Version sind die Weboberfläche Ihres Moduls und die veröffentlichten system/info. Die Verfügbarkeit von Sensoren hängt von Innen- und Außengerät ab.