如何对接8 路包间设备控制模块来实现空调电源控制_解决方案

CATALOG

针对芯步8路包间设备控制模块的空调电源控制对接，由于其第8路为30A继电器直接输出，最佳的对接方案是直接通断法。以下是基于其开放HTTP接口的详细对接指引。

芯步的8路包间控制器（如型号 UNI-KZQ-BJ-MAX）本质上是WiFi继电器输出设备。它不像红外遥控器那样可以调温度、调模式，而是直接控制空调插座的物理通断电。

控制对象：空调的电源线路（L/N火零线）。
控制原理：通过HTTP接口闭合/断开控制器内部的第8路继电器，从而控制空调插座的220V通断。
典型应用场景
- 无人自动断电：包间订单结束后，远程切断空调电源，避免浪费。
- 定时开启：预定时间前10分钟通电，让空调提前制冷。
- 远程运维：空调卡机时，远程断电重启（硬件复位）。

在开始对接代码之前，请确认你的硬件配置，这是解决方案的基础。

推荐设备：芯步 智能包间控制器 | Max（必须含第8路30A接口）。
接线方案
- 严禁将控制器直接串联在空调面板开关上（通常是无缘开关信号，电压不对）。
- 正确做法：将控制器 第8路输出接口 串联到空调的电源火线上。
- 注意：该模块第8路支持最大 6600W 阻性负载，足以带动2匹甚至3匹的家用/商用空调。

芯步提供了标准的HTTP API接口，你可以使用任何后端语言（Java, Python, PHP, Node.js）或通过云平台（如的点灯科技、HomeAssistant等）进行对接。

为了防止接口被恶意攻击，芯步使用动态签名机制。算法步骤如下：

根据芯步[产品手册]的命令定义

路径 (Line)	命令字段 (Command)	功能描述	适用场景
第8路	`power8`	控制第8路通断	核心功能：控制空调电源
全部	`batch`	批量控制所有线路	一键锁门并关空调

JSON 请求示例（控制空调关闭/开启）

第一种场景：关闭空调（退单后节能）

第二种场景：开启空调（用户下单后通电）

第三种场景：一键“清场模式”（关空调 + 关灯 + 落锁）利用batch命令，同时操作第1路（灯）、第7路（门锁）、第8路（空调）。

以下代码演示了如何在自研系统中集成控制逻辑。

Python 实现 (适用于后端逻辑)

Node.js / JavaScript 实现 (适用于云函数或Web管理后台)

由于直接切断电源，空调再次通电时可能处于待机状态（不会自动开机），也可能恢复断电前的状态（取决于空调主板设计）。为了解决这个问题，你可以利用该控制器的 第5路或第6路（16A接口） 结合 红外转发器

可行性方案：在包间内增加一个“芯步红外控制器”。
逻辑组合
- 客人下单 -> 调用API给第8路上电（空调得电） -> 延时2秒 -> 调用红外API发送“开机+制冷+26度”指令。
- 客人退单 -> 调用红外API发送“关机”指令 -> 延时5秒 -> 调用API切断第8路电源。

设备不在线 (Offline)
- 该设备仅支持2.4G WiFi。如果连上了5G WiFi或信号弱，设备会离线，API会返回 code 200 但设备不动作。
- 排查：登录芯步控制台，查看设备最后在线时间。
空调功率过大
- 第8路虽然标称30A，但如果是大型商用5匹柜机，启动电流极大。中间增加大功率交流接触器，用小电流（控制器的30A）控制大电流（接触器的线圈）。
状态同步
- 使用芯步的消息推送服务（Webhook）。当用户在本地用物理按键按了开关，或者设备状态发生变化，云端会主动推送消息到你的服务器，你需要监听这些消息来更新你系统中的“空调状态”。