芯步的12路智能分路照明控制器采用WiFi直连方式，通过HTTP接口即可实现远程控制，单路响应速度80-120ms。这意味着你不需要专用网关，只要有网络就能对接。下面我从接入架构、接口协议、场景联动策略三个层面来写。
1. 项目概述与对接目标
本文旨在为系统集成商或软件开发者提供一套完整的对接指南，利用芯步 UNI-KZQ-ZM-12-10A 智能照明控制器的开放 API，实现复杂的场景联动照明控制。
通过对接，目标实现：
远程单控与集控：独立控制 12 个回路中的任意一个，或同时控制多个回路。
传感器联动：结合人体存在传感器、光照传感器，实现人来灯亮、人走灯灭或根据光照自动调节。
场景模式切换：一键切换预设场景（如“全开模式”、“节能模式”、“影院模式”等）。
2. 核心技术架构与对接原理
芯步的硬件产品（包括照明控制器和各类传感器）均采用 WiFi 2.4G 直连方式，无需网关，这一特性降低了系统复杂度和硬件成本。
2.1 通讯机制
所有设备统一采用 HTTP POST 请求与开发者服务器（或云端）进行交互，主要分为两类数据流：
下行控制：服务器向设备下发指令（如：开灯、关灯、调光）。
上行感知：传感器设备向服务器上报状态（如：有人移动、温度过高）。
2.2 接口通用规范
芯步开放平台遵循统一的鉴权机制，任何对接都需要携带特定的参数以确保安全性。
请求地址
http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}请求方法：
POST请求头：
Content-Type: application/json鉴权参数
AppId： 在芯步控制台获取的应用唯一标识。ts： 当前 Unix 时间戳。sign： 签名，生成算法为md5( md5(AppSecret) + ts )。
3. 12路照明控制器接口对接详解
3.1 设备指令模型
针对“12路智能分路照明控制器”（型号：UNI-KZQ-ZM-12-10A），其核心控制逻辑基于继电器输出。该设备支持 12 个独立继电器，每个继电器可单独控制，负载能力为 10A/路。
核心 JSON 命令参数格式如下：
| 功能描述 | JSON 结构 (order参数) | 说明 |
|---|---|---|
| 单路开启 | {"power1": 1} | 开启第1路，取值范围 power1 至 power12，数值 1 为开启。 |
| 单路关闭 | {"power1": 0} | 关闭第1路。 |
| 全开 | {"power": 1} | 开启所有12路。 |
| 全关 | {"power": 0} | 关闭所有12路。 |
| 多路组合 | {"power1":1, "power3":1, "power5":0} | 同时开启1、3路，关闭第5路。 |
3.2 代码对接示例 (Node.js)
以下示例展示了如何在业务系统中调用接口关闭第 3 路灯光（假设 AppSecret 已配置）：
4. 场景联动实现策略
“场景联动”的核心在于 数据流的中转与逻辑处理。依靠单一设备无法实现复杂联动，必须通过您的业务服务器作为大脑，接收传感器数据，分析后向照明控制器下发指令。
4.1 典型联动场景：人体感应与灯光控制
场景需求：当有人进入仓库时，自动开启指定区域的照明回路（如第5、6路）；人离开后延时 30 秒关闭。
技术实现流程
设备部署：部署“芯步智能人体存在雷达传感器”与“12路控制器”在同一局域网或同一云账号下。
数据上报：传感器探测到“有人”状态，立即通过 HTTP 推送至您的服务器（需在芯步控制台配置消息接收服务器 URL）。
逻辑处理（服务器端）
接收传感器数据：
{"device": "sensor_01", "status": "occupied"}。触发业务逻辑：调用上述 API，向 12 路控制器发送
{"power5":1, "power6":1}。
延时任务：当服务器收到“无人”信号时，不立即关灯，设定一个
setTimeout任务，30 秒后再发送关闭指令{"power5":0, "power6":0}。如果在 30 秒内再次检测到“有人”，需清除之前的延时任务，保持灯光常亮。
4.2 典型联动场景：定时策略与工作日模式
针对办公楼或园区照明，可以利用服务器的 Cron 任务定时下发指令：
08:00 场景：开启大堂及办公区基础照明（
power1,power2）。12:00 场景：关闭部分非必要照明（
power3,power4）以节能。18:00 场景：开启氛围照明（
power5），展示建筑轮廓。22:00 场景：全关，仅留应急回路（
power12）。
4.3 私有化部署与低延迟优化
对于要求高稳定性的工业或医疗场景，采用 私有化部署模式
设备支持配置本地局域网服务器地址（内网 IP）。
您的服务器部署在本地，设备与服务器通过内网通讯，此时的接口调用延迟可降至 80ms 以内，规避公网抖动风险。
5. 关键注意事项
设备ID获取：所有操作必须基于
Device ID。该 ID 可在设备外壳标签、设备配网后的控制台列表或通过设备配网接口获取。状态同步：照明控制器支持状态上报。当有人本地手动按下（或通过其他方式控制）按钮时，设备会向服务器推送当前状态，请一定要在服务器端更新数据库记录，避免出现 APP 显示“开”而实际灯已“关”的不同步问题。
多路并发指令：如果需要同时控制 12 个回路，不要发送 12 次 HTTP 请求，应合并为 1 个请求中的 order 对象（如
{"power1":1, "power2":0, ...}），以提高执行效率并避免网络拥塞。
6. 总结
通过本文方案，您可以利用标准的 HTTP API 将芯步的 12 路硬件控制器无缝集成到您的智慧楼宇或工业物联系统中。重点在于利用服务器的逻辑处理能力，将“人体传感器”、“光照传感器”的上行数据与“照明控制器”的下行控制结合，最终实现高效、智能的场景照明管理。