这是一个基于芯步 智能包间控制器 Mini (UNI-KZQ-BJ-MINI) 开放接口（HTTP API）的技术解决方案文档。
1. 背景与需求
在共享棋牌室、茶室、影音房等无人值守场景中，包间内的电器设备（如空调、麻将机、照明、门锁）一旦发生故障，往往会直接影响用户体验，甚至导致订单退款。
痛点：
被动响应：通常由用户发现设备不能用（如空调不制冷）后才投诉，管理人员被动介入。
故障模糊：无法区分是“设备真坏了”还是“用户误操作关了电”，增加运维成本。
联动缺失：门锁、电灯、空调各自独立，无法感知设备的电流状态来判断健康度。
解决目标： 利用智能包间控制器Mini的电量监测与远程控制能力，通过HTTP接口对接上层SaaS系统，实现包间设备故障的自动侦测、精准定位与实时告警。
2. 智能包间控制器Mini核心能力
根据产品手册，该控制器具备以下关键特性，是构建自动告警的基础
4路独立控制
第1/2路：16A回路，接照明、麻将机、饮水机。
第3路：10A门禁专用，接电磁锁。
第4路：30A大功率，接2匹空调。
电力参数感知：可监测每路输出的负载功率（W） 变化。这是判断设备是否真实运行或损坏的核心数据。
开放接口：支持 HTTP API 下发命令及获取状态；支持 私有化部署（局域网），保障内网通信稳定性。
TTS语音播报（可选）：支持在告警时在包间内直接播放语音提示。
3. 整体设计
本方案采用端-云-端架构，将控制器作为边缘感知节点，业务服务器作为决策中心。
感知层：智能包间控制器Mini。实时采集各路（麻将机、空调、照明）的电压、电流、功率因数及开关状态。
传输层：基于WiFi 2.4G，通过HTTP协议将状态消息推送到自建服务器或芯步云平台。
业务逻辑层：物业/商家的业务服务器。运行故障判别算法（包括离线检测、功率阈值异常检测）。
告警层：通过企业微信、短信、平台消息或现场TTS语音进行通知。
4. 故障自动告警核心逻辑
要实现自动告警，不能仅看“通断”，必须结合功率指纹技术。以下是针对具体设备的判别逻辑：
4.1 空调故障告警
场景：用户扫码开启了包间空调（第4路已闭合），但房间温度不降或空调离线。
接口数据：获取第4路的
功率(W)、电流(A)。判别逻辑
故障A（压缩机未启动/缺氟）：尽管继电器吸合，但功率仅维持在10-50W（内机风扇），未出现1000W以上的压缩机运行功率峰值。持续10分钟 → 判定为“空调故障/缺氟”。
故障B（外机跳闸/断电）：功率突然从1500W跌落到0W，但继电器状态为闭合 → 判定为“空调异常断电” 。
告警策略高优告警，立即推送至店长手机并发送指令给控制器TTS播报“空调故障，请稍后工作人员将为您处理”。
4.2 麻将机/按摩椅故障告警
场景：用户反映麻将机卡牌或无法洗牌。
判别逻辑
待机异常：麻将机处于洗牌状态时功率应在80-150W波动。如果用户操作界面显示“洗牌中”，但功率持续低于20W → 判定为“电机堵转或主板烧毁”。
电源损坏：继电器吸合后，功率持续为0W持续30秒 → 判定为“设备未响应（可能电源板损坏）” 。
告警策略：中优告警，推送给维修组。
4.3 门锁故障告警
场景：用户出门后门锁无法自动上锁，或电磁锁一直处于通电发热状态。
判别逻辑
反馈机制：控制器虽然控制第3路通断，但结合第三方门磁传感器（通过HTTP API上报）。
电流异常：第3路吸合时间超过设定值（如5分钟），电流持续在1A以上但门磁未反馈“锁闭”信号 → 判定为“门锁空转/卡死”。
告警策略安全告警，推送至安保人员。
4.4 设备离线告警
场景：控制器由于Wi-Fi信号弱或断电断网。
判别逻辑：业务服务器连续5分钟未收到控制器的HTTP心跳数据。
告警策略严重告警，通知工程人员检查包间供电或网络。
5. 接口对接流程与实现要点
芯步开放HTTP接口，开发者无需关心底层协议，只需调用API即可。
5.1 注册与指令下发
设备注册：在芯步工作台获取
device_id（包间控制器Mini的唯一标识）及api_key。状态查询
GET /api/orderstatus?device_id={id}返回示例
{ "channel_1": "on", "power_1": 45.2, "channel_2": "off", "power_2": 0 ... }
故障数据采集：业务系统每30秒轮询一次该接口，或配置芯步的消息服务器（Webhook），让设备主动推送数据。
5.2 核心判别算法伪代码
6. 告警策略与防误报机制
为避免告警风暴（如Wi-Fi抖动导致频繁离线上线），需设计以下机制
延迟确认机制
当检测到故障（如离线或功率异常）时，不立即告警，而是连续轮询3次（间隔10秒）。
若连续3次均为异常状态，才触发告警。若中间恢复，则自动消除。
功率波动容忍度
对于空调、冰箱等感性负载设备，功率本身会有波动。设置低通滤波，只有当异常持续时间超过120秒才上报。
分级通知
P0级（紧急）：门锁故障、完全离线、空调大功率跳闸 → 短信+语音电话。
P1级（重要）：灯泡损坏、麻将机电机故障 → 微信/App推送。
P2级（提示）：设备保养到期（如按运行时长计算） → 平台记录。
一键自检/消音
业务系统在收到告警后，可通过API向控制器下发“自检命令”（例如：第4路断连3秒再恢复），若恢复功率则自动解除告警并发送“已恢复”通知。
7. 实施效益
通过对接芯步智能包间控制器Mini的开放接口：
运维效率提升：将“用户投诉后排查”转变为“系统自动发现”，提前30分钟发现空调漏水/缺氟等问题。
降低误判：结合电流功率数据，可精准区分“控制故障”与“设备物理损坏”，减少无效上门次数。
资产保护：实时监测第4路（空调）和第2路（麻将机）的功率异常，及时发现设备烧毁前兆，防范火灾风险。
总结： 利用智能包间控制器Mini的精细化电流检测能力，配合HTTP API的快速集成能力，只需在业务后台增加几条功率判别逻辑，即可低成本、高效地实现传统无人店难以做到的“设备亚健康状态预警”。