怎么对接4路智能照明控制器以实现4路独立线路控制_解决方案

CATALOG

四路独立线路控制集成方案：芯步智能照明控制器对接指南

在智能照明或设备控制项目中，四路独立控制是一个高频需求——无论是共享自习室的桌面灯控、展厅的分区照明，还是智慧工厂的产线信号灯控制，都需要对多路负载进行独立、精准的远程通断管理。芯步的智能照明控制器4路（型号：UNI-KZQ-ZM-4）正是为此场景设计，其核心价值在于：单台设备支持4路独立控制、通过HTTP接口实现毫秒级响应、WiFi直连无需额外网关。

以下从硬件选型、接口规范、代码实现到场景应用，给出完整的技术方案。

一、产品选型与核心参数

芯步提供多款4路控制器，针对照明场景，交流电压版是最适配的选择。需要根据实际负载类型和功率选择对应版本

对比维度	智能控制器4路（交流版）	智能照明控制器4路（16A版）
型号	UNI-KZQ-AC-4	UNI-KZQ-ZM-4-16A
工作电压	AC 85-265V（市电直供）	AC 100-250V
单路额定电流	MAX 10A	MAX 16A
单路负载（阻性）	≤2200W	≤3500W
单路负载（感性）	≤350W	≤500W
适用场景	普通照明、插座	大功率照明、空调等
无线连接	WiFi 2.4GHz	WiFi 2.4GHz

数据来源：芯步产品参数页

选型

常规LED灯具、筒灯（单路<1000W）：选10A版即可
大功率金卤灯、多盏灯并联（单路>2000W）：选16A版
感性负载（风扇、电机）：无论功率大小，将额定功率除以3后与设备匹配

二、硬件安装与接线

2.1 设备外观与接口

智能照明控制器4路为标准导轨安装式设备，主要接口包括：

输入端：火线（L）、零线（N）接入——设备自身供电
输出端：4组继电器输出接口（每组含火线出）
天线接口（外置天线版）：用于增强WiFi信号
状态指示灯：电源灯、网络灯、4路继电器状态灯

2.2 接线规范

配电箱接线示意:
                    ┌─────────────────────────────────────┐
    总闸L ──────────┤ L（设备供电输入）                      │
                    │                     ┌─ OUT1 ── 第1路灯具 │
    总闸N ──────────┤ N（设备供电输入）    ├─ OUT2 ── 第2路灯具 │
                    │             智能照明 │ ├─ OUT3 ── 第3路灯具 │
    灯具1火线端 ────┤ 控制器4路   ├─ OUT4 ── 第4路灯具 │
    灯具1零线端 ────┼─ 直接连接总闸N回路    │                     │
                    └─────────────────────────────────────┘

关键要点

必须断电操作：确认总闸断开后才可接线
零线共用：所有灯具的零线可直接并接到总闸N端，设备仅控制火线通断
线径要求：10A版本使用≥1.5mm²铜线，16A版本≥2.5mm²
安全防护：安装对应额定电流的空气开关作为前级保护

三、网络配置与设备激活

设备通电后，需要进行WiFi配网接入芯步云平台。

3.1 配网方式

设备支持两种配网模式

AP配网模式：设备自身发射热点（SSID格式：YOIO_XXXX），手机连接后通过小程序/APP配置WiFi信息
SmartConfig配网：手机APP与设备处于同一WiFi下，通过广播方式一键配网

3.2 配网步骤

长按设备上的配网按键（通常位于外壳侧面），直到指示灯快闪
打开“芯步”微信小程序或APP，选择“添加设备”
输入目标WiFi的SSID和密码（仅支持2.4GHz频段）
按照提示完成配网，等待设备指示灯变为常亮即表示联网成功
在设备列表中记录该设备的Device ID（后续API调用需要）

3.3 多WiFi冗余

该设备支持配置5组WiFi网络，当当前网络信号弱或断开时，会自动扫描并连接信号最强的可用网络。这一设计在公共网络环境（如商场、办公楼）中尤为实用。

四、API接口对接方案

芯步提供标准的HTTP API接口，支持对4路输出进行独立或批量控制。接口响应时间约80-120ms。

4.1 接口地址与鉴权

请求地址

POST https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}

参数说明

参数	类型	说明
AppID	string	应用ID，由芯步平台生成
ts	string	当前Unix时间戳（精确到秒）
sign	string	签名，计算公式见下方
device	string/integer	设备ID（配网后获取）
order	json	控制命令JSON对象

签名算法

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

开发者在芯步控制台获取开发者密码（DevSecret）后，按此公式生成签名。

4.2 单路独立控制命令

JSON命令格式

power1~power4分别对应第1~4路输出
值1表示接通（继电器闭合），0表示断开（继电器断开）
以上示例：第1路、第3路打开；第2路、第4路关闭

单路命令示例（仅开启第1路）：

4.3 批量控制命令

当需要同时对多条线路执行相同操作时，可使用batch指令简化代码：

relay：目标线路数组
power：0断开 / 1接通
以上示例：关闭第1路和第3路

4.4 定时命令

支持“先通后断”和“先断后通”两种定时模式，适用于场景切换、设备自检等场景。

先通后断（指定线路接通，N毫秒后自动断开）：

第1、2路立即接通
3000毫秒（3秒）后自动断开

先断后通（指定线路断开，N毫秒后自动接通）：

第3、4路立即断开
5000毫秒（5秒）后自动接通

五、代码对接示例

以下以Python为例，展示完整的设备控制调用流程。

5.1 签名生成函数

5.2 各场景调用示例

六、典型应用场景

6.1 共享自习室桌面灯控

用户扫码选择座位后，系统自动开启对应座位的照明电源。订单结束或超时时自动断电。

6.2 展厅分区灯光联动

配合人体传感器，实现“人来灯亮、人走灯灭”的智能照明。

6.3 工厂设备状态指示

利用4路输出分别控制红、黄、绿三色信号灯及蜂鸣器，实现设备状态的可视化。

七、注意事项与最佳实践

注意项	说明
WiFi频段	仅支持2.4GHz，5GHz无法连接
感性负载降额	电机、风扇等感性负载启动电流大，实际功率不超过额定值的1/3
网络稳定性	在配电箱内加装工业级路由器，保证信号强度
手动应急	设备物理按键支持手动控制，标注在配电箱面板上
防火墙配置	如需部署在纯局域网，支持私有化部署，可自建消息服务器