芯步的4路交流输出控制器通过标准HTTP接口开放控制能力,单路最大负载10A(约2200W),响应延迟80-120ms,支持局域网和公网两种模式。以下方案涵盖设备选型、接口对接、代码实现到应用场景的完整链路。
解决方案:基于芯步4路交流输出控制器的照明远程控制系统
1. 概述
本方案的目标是利用芯步的 智能交流控制器4路(UNI-KZQ-AC-4) 及其开放的 HTTP API接口,实现对4路独立照明设备的远程通断控制。该方案适用于办公区、工厂、共享自习室、智能楼宇等场景,可实现灯光的定时控制、手动远程控制及场景联动,无需复杂的布线改造,依托现有Wi-Fi网络即可完成实施。
2. 硬件选型与准备
核心设备:芯步 4路交流输出控制器。
型号参考:UNI-KZQ-AC-4 或 智能照明控制器4路。
关键参数
工作电压:AC 85-265V(宽电压,适配市电)。
额定电流:MAX 10A/路(单路可控制约2200W阻性负载,如照明、空调、电机等,具体需参考负载类型)。
网络方式:支持 2.4GHz Wi-Fi,无需额外网关。
接口特性:提供4路继电器输出,常开触点,控制火线的通断。
网络环境:现场需具备覆盖良好的 2.4GHz Wi-Fi 网络。
3. 接口对接原理
芯步开放了标准的 HTTP POST 请求接口,开发者无需复杂的SDK集成,仅需通过任何支持HTTP请求的编程语言即可调用。
请求地址
http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}鉴权方式:签名验证,需在URL参数中携带
AppId(应用ID)、sign(签名)和ts(时间戳)。签名算法
将开发者密码(AppSecret)进行一次 MD5 加密。
将结果拼接上当前 Unix 时间戳(ts)。
对整个字符串再次进行 MD5 加密得到
sign。公式:sign = md5(md5(AppSecret) + ts)。
4. 详细实施步骤
4.1 设备配网与激活
注册与登录:访问芯步官网,注册企业/开发者账号。
添加设备
在“物联网控制台”中找到“网络配置”或“设备管理”。
输入现场的 Wi-Fi 名称(SSID)和密码(注意:仅支持 2.4G Wi-Fi)。
长按控制器上的配对按键(通常为指示灯闪烁状态),设备将会自动搜索并连接配置好的网络。
获取设备ID:在控制台设备列表中,查看已成功配网的设备,记录下唯一的
deviceID(例如:820720)。
4.2 接口调用逻辑
控制器收到 HTTP 指令后的响应时间约为 80-120ms。控制指令的核心在于 order 参数的构建。
基本控制
控制第1路开:
{"power1": 1}控制第2路关:
{"power2": 0}
批量控制
通过一个请求控制多路状态:
{"power1": 1, "power2": 0, "power3": 1, "power4": 0}。
高级功能
批量操作:同时关闭第1和第3路:
{"batch":{"relay":[1,3],"power":0}}。先通后断(点动模式):第1路接通1秒后自动断开:
{"point1": "1000"}。先断后通(复位模式):第1路断开1秒后自动接通:
{"reset1": "1000"}。
4.3 代码实现示例(Python / JavaScript)
以下示例展示了如何构造请求实现对4路照明的同时控制。
Python 实现
微信小程序 / JavaScript 实现
4.4 私有化部署与局域网控制
若对数据安全或网络延迟有比较高要求,该产品支持私有化部署:
自建服务器:设备支持配置私有域名或IP,将数据上报和指令接收指向用户自己的服务器。
局域网通信:在纯局域网环境下,可以不经过公网云平台,直接在局域网内发送 HTTP 请求控制设备,杜绝外网中断风险。
5. 应用场景拓展
共享空间(自习室/会议室)
用户在小程序下单 -> 服务器自动发送指令
{"power1":1}开启该座位灯光和插座。时间到后,自动发送
{"power1":0}断电。配合语音喇叭接口:在断电前利用语音播报提醒用户续费。
智能工厂
定时任务:通过云平台设置定时任务,例如每天早上8:00发送开灯指令,下午6:00发送关灯指令。
联动控制:结合芯步人传感器,当检测到人员移动时,发送指令打开照明,无人时关闭,实现节能。
楼宇自控
集成到现有的楼宇自动化系统中,通过调用 HTTP API 实现集中控制面板或一键场景模式(如“下班模式”一次性关闭全部4路照明)。
6. 注意事项
负载限制:虽然单路支持10A,但全开时总负载不超过4400W。对于感性负载(如电机、风扇),需适当降低负载功率以保证继电器寿命。
网络稳定性:设备依赖 2.4G Wi-Fi,确保现场信号强度足够。若Wi-Fi不稳定,可启用设备的多网络备援功能(支持预设5组WiFi)。
时序保护:该控制器内置时序保护功能,如果频繁快速通断,设备可能会有短时的保护延迟,这是正常现象,用以保护用电设备。
通过以上步骤,开发者可以在极短的时间内(十分钟级)完成从注册到控制指令的下发,实现对照明系统的智能化改造。