Faikin Ninja P1P2 — MQTT 手册

本指南完整介绍如何通过 MQTT 控制和监测 Faikin Ninja P1P2，从初次设置到完整的主题、命令与传感器参考。

本文适用于安装在 Daikin P1/P2 控制总线上的 Faikin Ninja 模块：VRV 与 VRF、Sky Air、F 系列商用机，以及配有 Airbase 或分区控制器的风管系统。全文中示例基础主题为 ac/livingroom，示例代理服务器 IP 为 192.168.1.10。两者都请替换为您自己的值。

这与 Faikin Faikout 的 MQTT 接口并不相同。 Ninja 运行不同的固件，主题结构也不同，因此为 Faikout 编写的自动化无法直接沿用。如果您使用的是 Faikout，请改为查阅 Faikin Faikout MQTT 手册。第 5 节提供了两者的对照表。

1. MQTT 能带来什么

Ninja 内置的网页足以应付日常使用。当您需要让空调成为更大系统的一部分时，才需要 MQTT。

• 自动化。 可由任何条件触发运行：在家状态、时间表、电价数据、门磁传感器，或另一个房间的温度。
• 真正的仪表数据。 P1/P2 总线传输的远不止开机、关机和温度。Ninja 会发布室内外机热敏电阻、制冷剂压力、膨胀阀开度、压缩机与风机状态、运行小时数以及机组自身的故障代码。这些数据大多在壁挂控制器上是看不到的。
• 风管系统分区。 如果您有 Daikin 分区控制器，每个风阀都会变成一个可单独控制的开关。
• 一处集中管理。 Home Assistant、Node-RED、openHAB 以及任何支持 MQTT 的系统都可以同时看到同一台设备。
• 始终在本地运行。 MQTT 运行在您自己网络中的代理服务器上。没有数据离开家里，也不需要注册账户。

2. 开始之前

您需要准备三样东西。

1. Ninja 已接入您的 WiFi，并可通过其自身网页访问。若尚未接入，请先完成 安装指南。
2. 网络中的 MQTT 代理服务器。 如果您运行 Home Assistant，请安装 Mosquitto broker 加载项；只需几分钟即可完成，并会提供代理服务器以及用户名和密码。否则，任何运行在常开设备上的 Mosquitto 或兼容代理服务器都可以。
3. 代理服务器的 IP 地址、用户名和密码。

使用 MQTT 不需要 Home Assistant，使用 Home Assistant 也不需要 MQTT。两者是各自独立的选择，只是配合得很好。

3. 步骤 1：将 Ninja 指向您的 MQTT 代理服务器

打开 Ninja 的网页，进入 MQTT settings。

这两项的重要性超出表面。Ninja 的每一个主题都由它们拼成：

基础主题 = <Topic> / <Friendly Name>

因此 Topic = ac 与 Friendly Name = livingroom 组成的基础主题为 ac/livingroom，状态主题则为 ac/livingroom/state。

请在编写任何自动化之前确定这两项。之后再修改会重命名所有主题，并让引用旧主题的一切悄然失效。一个实用的约定是：为所有机组使用同一个前缀（ac），再加上不会变动的房间名称（livingroom、masterbed、office）。

保存后，模块会重新连接并开始发布数据。

4. 步骤 2：确认连接成功

这不需要终端。有两个地方可以立即看出结果。

在 Ninja 自己的网页上

打开模块页面。在页面顶部设备名称旁，会显示代理服务器的连接状态。MQTT connected 表示模块已连接到您的代理服务器并正在发布数据。

如果没有该提示，说明主机、端口、用户名或密码有误，或者从模块所在的网络无法访问代理服务器。请重新检查 MQTT 设置，然后参阅故障排查。

在 Home Assistant 中

无需手动添加。Ninja 会发布 Home Assistant 的 MQTT 自动发现消息，因此只要连上代理服务器，Home Assistant 就会自动找到它。前提是 MQTT 集成已经配置好，并指向同一个代理服务器：

1. 进入 Settings > Devices & services > MQTT，然后打开设备列表。
2. 几秒钟内设备就会出现，名称取自您设置的 Friendly Name。
3. 打开后一切都已就绪：一个带模式、目标温度、风速和导风板的 climate 实体；一长串诊断传感器；如果有分区控制器，还有每个风阀分区的开关。

对于 Ninja，您完全不需要在 YAML 中手写 climate 实体。如果您正在这样做，说明上游环节出了问题。

如果您更愿意用终端确认

此步骤可选，只有在您已安装 mosquitto 客户端工具时才值得一试：

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

您应当看到 ac/livingroom/availability 报告 online，并在 ac/livingroom/state 上看到完整的 JSON 负载。

如果没有任何数据到达，请直接跳到故障排查。

5. 主题结构

一切都挂在您在第 3 节中拼好的基础主题下。若基础主题为 ac/livingroom：

空调与控制

系统与管理

大多数自动化只需要三项：向 .../set 主题发布，并订阅 state 与 availability。

如果您同时拥有 Faikout

这两款产品采用了相反的做法，因此值得放在一起对比。

6. 发送命令

向相应的 .../set 主题发布纯文本字符串。没有 JSON 外壳：负载就是值本身。

power/set

mode/set

temp/set

目标温度，以数字表示，例如 24。范围 16 至 32 °C，步进 1.0 °C。您可以用 system/set_min_temp 与 system/set_max_temp 收窄该范围（第 11 节）。

fan/set

可用风速取决于室内机。模块会报告您的机组实际支持的风速；发送不支持的值会被忽略。

常见的组合有：

• 三档带自动： low, medium, high, auto
• 两档： low, high
• 四档分区/Airbase： low, medium, low_auto, medium_auto
• 六档分区/Airbase： low, medium, high, low_auto, medium_auto, high_auto

vane/set

示例

# 开机、制冷、24 C、自动风速、摆风
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'

由于每项控制都有各自的主题，发送顺序无关紧要，您只需发送需要的那几项。

7. 风管系统分区

如果 P1/P2 总线上接有 Daikin 分区控制器，Ninja 可以开关每个风阀。

发布 ON 或 OFF 到 ac/livingroom/zone/<n>/set，其中 <n> 为 1 至 8：

# 打开分区 1，关闭分区 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'

状态负载会回报：

在 Home Assistant 中，每个启用的分区都会被自动发现为独立的开关，无需任何配置。

两点实用提示。只有在存在分区控制器时才会出现分区，因此普通分体机不会有任何分区键。另外，同时关闭所有分区容易让风管系统出问题：请至少保留一个分区开启，或者干脆关机。

8. 读取状态

只要有任何变化，模块就会向 <base>/state 发布一个完整的 JSON 对象。

只有您的机组确实上报的传感器才会出现。 Ninja 会检测所连接的室内机和室外机发布了哪些数据，并隐藏其余部分，因此您的负载会比下面的示例短，两台不同的 Daikin 机组也会产生不同的键。这是正常现象。请针对您自己机组上能看到的键来编写自动化。

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

首先值得了解的键：

机组可能处于 "power": "on" 而 "action": "idle" 的状态，这完全正常：说明已达到设定温度。若想知道它是否真的在工作，请查看 action、operating 或 f_comp_operating。

另外还请订阅 <base>/availability。该主题为 offline 表示 模块 已掉线，这与空调关机是两回事。

9. 通过 MQTT 使用 Home Assistant

添加 MQTT 集成并指向同一个代理服务器。整个配置就这么多：Ninja 会自行通告，Home Assistant 会构建其余部分。

您将得到：

• 一个 climate 实体，包含 heat, cool, dry, fan_only 与 off 模式、您机组支持的风速模式、导风板位置 1 至 5 与 swing，以及 1.0 °C 的步进。
• 传感器与二进制传感器，对应您机组上报的每个热敏电阻、压力、执行器、小时计数、故障代码和型号字符串。大多数会归入 Diagnostic 类别。
• 开关，对应每个启用的风阀分区。

实体 ID 沿用 Friendly Name，因此若设为 livingroom，您会得到 climate.livingroom、sensor.livingroom_outside_temperature、switch.livingroom_zone_1 等等。编写 YAML 前，请在 Developer tools > States 中确认确切名称。

仪表板卡片

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

一个自动化示例

在家中温度舒适后关闭机组。这里使用 action 而不是 power，以免机组仍在工作时就触发：

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

监视故障

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

这个自动化值得设置。故障代码与技术人员从壁挂控制器上读到的代码相同，在打电话前先知道它，可以省下一次上门。

10. 其他平台

同样的主题在任何平台上都适用。向 <base>/…/set 发布字符串，订阅 <base>/state。

mosquitto 命令行

# 监视该设备的所有数据
mosquitto_sub -h 192.168.1.10 -u USER -P PASS -t 'ac/livingroom/#' -v

# 开机并制冷到 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'

# 打开分区 1
mosquitto_pub -h 192.168.1.10 -t 'ac/livingroom/zone/1/set' -m 'ON'

Node-RED

使用 MQTT in 节点订阅 ac/livingroom/state，并将输出设为已解析的 JSON 对象，然后读取 msg.payload.power、msg.payload.room_temperature 等等。

发送时使用 MQTT out 节点，并将主题和负载留空，使其来自消息本身。负载必须是字符串，因此需要先转换数字。

一次性设置整台机组：

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

用仪表板滑块调节目标温度：

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

仅在当前关机时才开机：

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;

订阅 ac/livingroom/availability 是在模块掉线时让仪表板变灰的一种简便做法。

openHAB

先添加一个 MQTT Broker Thing，再添加一个 Generic MQTT Thing，并让其通道指向相应主题。在 ac/livingroom/power/set 上建立开关通道，取值 ON/OFF；在 ac/livingroom/temp/set 上建立数字通道；状态通道读取 ac/livingroom/state，并使用类似 $.room_temperature 的 JSONPATH 转换。

11. 系统管理与选项

这些位于 <base>/system/ 之下。其中大多数会重启模块，因此请勿将它们接入频繁触发的流程。

system/set

factory 同时会清除您的 WiFi 和 MQTT 设置，模块会回到自身的配置网络，需要从头重新设置。请将其视为最后手段。

温度限制

在出租房或办公室很实用：限定范围后，谁也无法在七月把温度设到 16 °C。

安全模式

system/set_safemode，取值 on 或 off。会重启。

Modbus RTU ID

system/set_modbus_rtu_id，取值为 1 至 254 的数字，适用于使用 RS485 版本的楼宇管理系统安装。会重启。

通过 MQTT 设置选项

system/opt/rqt 接受一个 JSON 对象，可让您不打开网页就一次修改多项设置：

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

凡是被接受的内容都会在 system/opt/rps 上回显，因此请订阅该主题确认，而不要凭猜测。

关闭 webpanel 会切断您自己回到设置界面的途径。只有在确定 MQTT 正常工作时才这样做。

system/info

定期发布：

{
  "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 是最值得关注的数值。如果比大约 -80 dBm 更差，应先把模块移到金属外壳之外，再去怀疑其他原因。

12. 传感器参考

以下所有内容都会自动检测。如果您的机组不上报，该键就不会出现在状态负载中，Home Assistant 中也不会创建实体。列表短并不代表有故障。

主要项目

室内热敏电阻

室外热敏电阻与压力

排气温度与这两个压力合在一起，是您能获得的最接近室外机实时健康检查的数据。把它们在整个季节中绘成曲线，异常读数会在任何保护装置动作之前很久就显现出来。

执行器与运行状态

运行小时数与故障

如果机组保存了故障历史，每条记录都包含行号、代码、日期和机组编号：

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

模块遥测

13. 故障排查

网页上没有 MQTT connected 标识。 请检查主机和端口，然后检查用户名和密码。如果代理服务器与模块位于不同的 VLAN 或子网，通常这才是真正的原因。

标识显示已连接，但 Home Assistant 中什么也没出现。 请确认 Home Assistant 的 MQTT 集成指向的是同一个代理服务器。同一网络里有两个代理服务器是常见且容易混淆的错误。然后检查模块设置中是否启用了自动发现。

缺少部分传感器。 这是正常的。只有所连机组上报的内容才会发布，小型分体机显示的内容会比 VRV 少得多。这不是故障。

没有分区开关。 分区需要 P1/P2 总线上有 Daikin 分区控制器。没有它就没有可控制的对象。

命令被忽略。 负载是纯字符串，并且如文档所述区分大小写：电源和分区使用大写的 ON 与 OFF，模式名称使用小写。温度若发送数字而非字符串，在部分客户端中会失败，包括 Node-RED。

温度调不到想要的值。 请检查 min_temp 与 max_temp，见 system/info。可能有人收窄了范围。

经常掉线。 请查看 rssi，位于 system/info。约 -80 dBm 或更差就已处于临界。请把模块移到金属外壳之外。

机器开着但什么也没发生。 请查看 action 与 f_comp_operating。如果 action 为 idle，说明已达到设定温度。如果压缩机始终不运转且 f_error_present 为 true，请读取 f_error_code 并告知您的安装人员。

改了设置之后一切都停了。 重命名 Topic 或 Friendly Name 会重命名所有主题。您的自动化仍然指向旧主题。

14. 快速参考速查表

基础主题 ac/livingroom。请替换为您自己的。

读取（订阅）

控制（发布）

系统（发布）

值得关注的键

来源：Faikin Ninja P1P2 MQTT 协议文档。所述行为与 2026 年 8 月的固件一致；对于您所安装的版本，以模块自身网页和发布的 system/info 为准。可用的传感器因室内机和室外机而异。