Panasonic Smart China R

Home Assistant 自定义集成，对接**松下智能家电（中国大陆）**云端 API，支持中央空调和新风换气设备。

本项目基于 mcdona1d/panasonic_smart_china 开发，在此基础上加入了新风设备支持，并大幅扩展了云端通信逻辑。感谢 arthurfsy 最早公开松下云端登录算法，感谢 Hassbian 论坛 omegaojian 对 MidERV 设备的抓包分析，为本项目逆向 DCERV-03 端点提供了关键线索。MidERV 与 SmallERV 机型的 payload 字段、运行模式值域和风量档位数据，参考自社区 dkong5ssss/panasonic_smart_china_erv 项目，感谢该项目作者的实测和整理。

---

效果截图

　

---

支持设备

中央空调（category 0900）✅ 完全可用

• 型号：配合 CZ-RD501DW2 线控器的松下家用多联/风管机
• 提供标准 climate 实体，支持开关机、模式切换、温度设定、风速调节

新风换气机（category 0800 / 0850）

集成会在首次拉取设备状态后自动识别机型（DCERV / NewDCERV / MidERV / SmallERV），无需手动配置。

机型支持状态

机型	devSubTypeId	category	状态
FY-35ZJD2C	DCERV-03	0800	✅ 实测可用
FV-RZ06VD1	MIDERV	0800	✅ 用户确认可用
SmallERV 系列	SmallERV-*	0850	🟡 代码完整，征集测试（#5）
NewDCERV 系列	NEWDCERV-*	0800	🟡 代码完整，征集测试（#6）

MidERV（FV-RZ06VD1 等）

控件：

• 开关机 (runSta)
• 假日模式 (holM)
• 运行模式：热交换 / 内循环 / 睡眠 / 自动ECO (runM 0/2/3/4)
• 风量：低 / 中 / 高 (airVo 1/2/3)
• PM2.5 滤网更换周期：60 / 90 / 120 天 (saFilEx)
• 回风滤网更换周期：180–365 天，7 档 (raFilEx)
• PM2.5 滤网清洗提醒：30 / 60 天 (saFilCl)
• 回风滤网清洗提醒：30 / 60 天 (raFilCl)

DCERV-03（FY-35ZJD2C 等）

传感器（稳定可用）：

传感器	字段	说明
室外 PM2.5	oaPMC	µg/m³
送风 PM2.5	saPMC	µg/m³
回风 PM2.5	raPMC	µg/m³
室外湿度	oaHumC	%
回风湿度	raHumC	%
室外温度	oaTeC	°C
送风温度	saTeC	°C
回风温度	raTeC	°C
回风 CO₂	raCO2C	ppm
回风 TVOC	raTVC	等级
外滤网寿命	oaFilExTL	小时
送风滤网寿命	saFilExTL	小时
回风滤网寿命	raFilExTL	小时

控件（稳定可用）：

• 开关机 (runSta)
• 假日模式 (holM)
• 运行模式：热交换 / 静音 / 普通换气 / 内循环 / 混风 / 自动ECO (runM 48–53)
• 风量：弱 / 强 (airVo 0/1)
• 压差模式：标准 / 正压 / 自定义 (preSet)
• 正压强度：弱 / 中 / 强 (preM)
• 自定义送风量 / 排风量：0%–100%，步长 20% (userSupWind / userExhWind)
• 外滤网更换周期：90 / 120 / 150 / 180 天 (oaFilEx)
• PM2.5 触发阈值：35 / 50 / 75 µg/m³ (pmSen)
• CO₂ 触发阈值：800 / 1000 / 1500 ppm (coSen)
• TVOC 触发阈值：低 / 高 (tvSen)

---

核心特性

• 无需手动抓包：内置双重 SHA-512 token 算法，账号密码直接登录
• 会话保活（Anti-Kickout）：10 分钟重登冷却，避免跟手机 App 互踢 session
• 静默重登：SSID 过期时自动用存储的凭证续期，无需手动 re-auth
• 多设备支持：按 deviceId 区分，可同时添加多台设备

---

安装

HACS（推荐）

1. HACS → 集成 → 右上角菜单 → Custom repositories
2. 填入 https://github.com/rudyll/panasonic_smart_china_r，类别选 Integration
3. 搜索 Panasonic Smart China R，下载
4. 重启 Home Assistant

手动安装

1. 下载本项目，将 custom_components/panasonic_smart_china_r 复制到 HA 配置目录的 custom_components/ 下
2. 确认路径：/config/custom_components/panasonic_smart_china_r/__init__.py
3. 重启 Home Assistant

---

配置

1. 配置 → 设备与服务 → 添加集成 → 搜索 Panasonic Smart China R
2. 输入松下智家 App 的手机号和密码
3. 选择设备（空调选控制器型号；新风机直接确认）

松下云端为单点登录。HA 接管 session 后，手机 App 再次登录会把 HA 踢下线（反之亦然）。内置冷却机制可减少抢占频率，但无法完全避免。若需长期稳定共存，建议用第二个松下账号并通过 App 内设备分享授权。

---

Token 算法

松下 DCERV-03 设备 token 为双层 SHA-512：

parts = device_id.split("_")   # 格式：MAC_CATEGORY_SUFFIX
mac = parts[0].upper()
category = parts[1].upper()
suffix = parts[2]               # 注意：suffix 保持原始大小写，不能 upper()
inner = sha512(f"{mac[6:]}_{category}_{mac[:6]}")
token = sha512(f"{inner}_{suffix}")

注意：suffix 全转大写会导致 token 校验失败，这与 App JS 源码的 toUpperCase 不一致，是 DCERV-03 型号的特殊行为。

---

兼容性

• Home Assistant 2024.1+
• Python 3.11+
• 仅适用于中国大陆地区"松下智能家电" App（蓝色图标），不支持国际版 Comfort Cloud

---

其他设备型号

设备类型	Category	状态	说明
中央空调（CZ-RD501DW2）	0900	✅ 实测
DCERV-03 大型新风	0800	✅ 实测
MidERV 中型新风	0800	✅ 用户确认	FV-RZ06VD1
SmallERV 小型新风	0850	🟡 征集测试	issue #5
NewDCERV 新一代大型新风	0800	🟡 征集测试	issue #6
空气净化器（Aircle）	0830	🔍 待开发	issue #3
其他 0900 空调控制器	0900	🔍 征集数据	issue #7

如果你的松下设备不在以上列表，可参考 Wiki：如何适配新设备 自行逆向并提交 PR。

---

免责声明

本项目为社区开源作品，非松下官方出品。通过模拟 App API 请求实现功能，请合理使用。因使用本项目导致的设备异常或账号问题，开发者不承担责任。

---