怎样对接4路灯光控制器以实现过流过载保护控制_解决方案

CATALOG

芯步的4路灯光控制器本身不具备直接检测电流的功能，无法“主动”上报过载状态。因此，实现过流过载保护的常规思路是：业务系统结合功率阈值，主动下发“断电”指令。以下方案详细说明如何通过开放接口完成这一闭环控制。

1. 解决概述

本方案的目标是指导开发者利用芯步开放平台的 HTTP API 接口，对接 4路灯光控制器（如型号：UNI-KZQ-ZM-4 或 UNI-KZQ-ZM-4-16A），实现线路的过流过载自动保护控制。

核心逻辑：

监测：业务系统需获取当前线路的实时功率数据（依赖带电量监测功能的硬件或外置传感器）。
判断：业务系统设定阈值，判断实时功率是否超载。
执行：当检测到过载时，系统调用芯步接口，向指定线路发送 0（关闭）指令，切断电源。
恢复：故障排除后，系统可手动或自动发送 1（开启）指令恢复供电。

2. 硬件与接口能力

在开始对接前，请确认您使用的硬件型号及支持的开放能力。

功能模块	支持情况	说明
4路独立控制	支持	可分别控制第1-4路的开关状态。
HTTP接口	支持	全面开放，简单友好，支持公网/局域网/私有化。
功率/电流检测	不支持	标准照明控制器仅控制通断，不具备计量功能。
时序保护	支持	设备端支持时序保护，避免瞬间大负载冲击。

关键提醒： 标准的4路灯光控制器（UNI-KZQ-ZM-4）仅提供 通断控制 功能，不具备 电量采集和过载主动上报功能。这意味着“过载检测”必须在您的业务服务器端通过逻辑判断完成，而不是等待设备推送。

3. 接口对接方案设计

本方案假设您已有办法获取负载的实时功率（例如搭配芯步带计量功能的插座，或第三方传感器），重点说明如何利用控制器接口执行保护动作。

3.1 鉴权与接口准备

芯步的API使用动态签名验证，对接前需准备以下参数：

AppId：应用ID（在物联网控制台获取）。
AppSecret：开发者密码（在物联网控制台设置）。
Sign (签名)：计算规则为 md5(md5(AppSecret) + ts)。
Ts： Unix时间戳（秒）。

签名生成示例（伪代码）：

3.2 控制指令下发（执行保护）

当业务系统判定某线路过载时，需立即向对应设备下发“断开”指令。

请求地址： http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}
请求方式： POST
Content-Type： application/json

请求体 (Body) 示例：假设设备ID为 820720，当前检测到第2路发生过载，需要断开该路。

参数解析
power1 / power2 / power3 / power4：分别代表第1至第4路。
值 1 代表开启，0 代表关闭。

3.3 批量控制与全保护场景

如果过载情况涉及多路或需要紧急全切，可以使用批量控制语法。

全切指令示例：

4. 过载保护的逻辑实现策略

由于硬件无法主动上报电流，在业务服务器上构建以下逻辑模型：

4.1 被动保护模式（推荐）

数据源：在前端回路中串联 带计量功能的智能插座 或 智慧电箱模块。
流程
1. 服务器定时轮询计量设备API，获取实时电流/功率。
2. 判断 当前功率 > 额定阈值（如：单路 > 10A 或总功率 > 2200W）。
3. 触发动作：调用 3.2 章节的接口，将对应 powerX 置为 0。
4. 记录日志：记录下因过载导致的断电事件。

4.2 主动预防模式

利用控制器的 “时序保护” 和 “延时通” 功能，在开启大功率负载时避免冲击：

场景：同时开启4路LED灯，瞬间电流过大。
解决：下发指令时，并非同时发送全部开启，而是使用延时命令。
- 示例：先开第1路，延时2秒，再开第2路……以此类推。

5. 开发实施步骤

按照以下步骤快速集成到您的系统中：

获取设备凭证
- 登录芯步控制台。
- 获取 AppId 和 AppSecret。
- 添加设备，获取目标控制器的 Device ID。
撰写接口驱动
- 编写签名生成函数（参考第3.1节）。
- 编写HTTP POST请求模块，指向 /device/control/ 路径。
集成保护逻辑
- 在您的业务代码中，创建“功率阈值-动作”映射表。
- 实现在接收到过载告警时，调用步骤2的接口。
调试与验证
- 使用Postman或Curl命令模拟请求。
- 验证签名错误（Code 5006）或设备不在线等返回状态。

6. 常见问题与规避

Q1：如果设备处于离线状态，下发断电指令会生效吗？

A：不会。指令会被缓存极短时间，若设备未上线则失效。：在业务逻辑中增加“指令确认”机制，若设备无响应需触发人工告警。

Q2：单路支持的最大功率是多少？如何避免烧坏设备？

A：标准版为 10A/路，大功率版为 16A/路。若负载超过此物理极限，接口下发关闭无效，必须通过前级空气开关保护。API保护仅适用于软件层面的逻辑过载（如超过设定阈值，但未达到物理极限）。

Q3：能不能在没有计量插座的情况下实现过载保护？

A：如果负载是固定的（如已知某设备功率恒定2000W），您可以在程序中设定“只要开启该设备，即开始计时，10分钟后自动关闭”的逻辑，利用 延时断 命令实现伪过载保护。

7. 总结

芯步的4路灯光控制器提供了稳定、低延迟的HTTP控制接口，虽然硬件本身不直接支持过载检测，但通过外置计量传感配合云端逻辑判断，您可以构建一套完整的过流过载保护系统。关键在于利用好 /device/control/ 接口中的 powerX 指令，并结合业务侧的数据监测能力。