芯步的4路照明控制模块通过标准HTTP接口开放控制能力，支持单路独立控制、批量操作及延时通断等场景。以下方案涵盖接口接入、签名计算、多语言代码示例及典型应用场景。

1. 产品概述与核心能力

芯步的4路照明控制模块（型号：UNI-KZQ-ZM-4） 是一款支持远程控制的智能硬件。它具备4路独立继电器输出，每路额定功率最高可达10A（部分型号16A），能够直接控制灯光、电器以及各类工业设备。

在二次开发中，开发者可以利用其提供的全开放式HTTP API接口，实现以下核心能力：

• 独立分控：对1-4路中的任意一路进行单独的开关操作，互不干扰。

• 批量控制：一次性下发指令，同时控制多路（如：一键开灯、一键关灯）。

• 延时与场景：支持“先通后断”或“先断后通”的脉冲控制，适用于门禁、电机等设备。

• 跨平台兼容：由于基于HTTP协议，该接口可被任何支持网络请求的编程语言（如Python, Java, Node.js, PHP）或平台（小程序、Web应用、APP）调用。

2. 接口鉴权与准备

在开始编码前，需要准备以下三个关键参数，这些参数可在芯步控制台获取：

1. AppId： 应用的唯一标识。

2. Developer Password （开发密码）： 用于生成签名，保障接口安全。

3. Device ID （设备ID）： 目标控制器的硬件标识（例如：820720）。

签名（Sign）生成逻辑（关键步骤）：为了防止接口被恶意篡改，每次请求都需要携带动态签名。算法如下

sign = md5( md5(开发者密码) + "." + 时间戳 )

简要流程：

1. 获取当前Unix时间戳（精确到秒）作为 ts。

2. 将开发者密码进行第一次MD5加密，得到32位小写字符串 pwd_md5。

3. 拼接字符串：pwd_md5 + "." + ts。

4. 对拼接后的字符串再次进行MD5加密，得到最终的 sign。

3. 核心API详解：分路控制

所有控制指令均通过POST方式提交至统一地址，数据格式为JSON。

• 请求地址http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

• 请求体（Body）核心结构控制指令通过 order 字段传递，主要包含以下几种模式：

3.1 直接分路控制（最常用）

适用于开关灯、通断电。直接指定 power1 到 power4 的状态。

• 指令示例：关闭第1路，开启第2、3、4路。

  { "device": 820720, "order": { "power1": 0, "power2": 1, "power3": 1, "power4": 1 } }

• 字段说明powerX 对应第X路；1 代表闭合/通电，0 代表断开/断电。

3.2 批量与高级控制

适用于特定自动化场景

• 批量控制只操作特定线路（如关闭第1和第3路）："order": {"batch": {"relay": [1, 3], "power": 0}}

• 先断后通（复位）适用于设备重启或门禁触发："order": {"reset": {"relay": [2], "interval": 1000}} （第2路先断开，间隔1秒后自动吸合）

• 先通后断（点动）适用于电机或脉冲控制："order": {"point": {"relay": [1], "interval": 500}} （第1路通电0.5秒后自动断开）

4. 二次开发代码示例

以下示例展示了如何在不同的开发环境中调用接口，实现分路控制。

4.1 Python 实现（适用于后端/脚本）

4.2 Node.js 实现（适用于云函数或小程序）

4.3 PHP 实现（适用于Web后台）

5. 典型应用场景解决方案

基于上述接口能力，您可以快速构建以下商业或工业解决方案：

5.1 共享空间智能化（自习室/棋牌室）

需求：用户在APP下单后自动通电，时间结束后自动断电。实现方案

1. 分路映射：将设备4路分别映射为“总照明”、“座位插座”、“空调”和“路由器”。

2. 业务流程

   • 用户支付成功 -> 后端调用接口发送 {"power1":1, "power2":1...} -> 设备吸合，房间供电。

   • 订单倒计时结束 -> 后端发送 {"power1":0, "power2":0...} -> 设备断开，房间全断。

   • 高级应用：用户点击“续费”，直接再次发送开指令即可，无需重启设备。

5.2 工业设备远程监控与复位

需求：服务器机房或工业路由器死机，需要远程重启。实现方案

1. 硬件接线：将模块串联在设备的电源线上。

2. 逻辑实现

   • 监控程序检测到设备Ping不通。

   • 调用接口发送 {"reset": {"relay": [1], "interval": 5000}}。

   • 效果：继电断开5秒后自动吸合，设备断电重启，恢复网络。

5.3 自定义面板与语音控制

需求：开发一个微信小程序，实现类似“智能家居”的界面。实现方案

1. UI设计：在小程序中放置4个开关按钮。

2. 前端逻辑：点击按钮时，调用 wx.request（参考上文Node.js示例），根据按钮状态发送 powerX 指令。

3. 状态同步：由于HTTP是无状态的，在本地维护一个状态变量，或者在需要高精度状态反馈时，调用平台的设备状态查询接口（拉取最新数据）。

6. 注意事项与优化

1. 响应速度：该模块在局域网或优质公网环境下，命令响应时间约为 80-120ms，这对于控制灯具来说几乎是瞬时的，用户体验良好。

2. 负载安全：虽然额定功率为10A/路，但在控制电机、空调等感性负载时，预留足够余量（如选择16A型号或外接交流接触器），避免瞬时电流烧毁触点。

3. 私有化部署：如果您的项目对数据安全要求比较高（如政府、军工项目），芯步支持私有化部署。届时API地址将变更为您的私有服务器地址，但接口协议完全不变。