CATALOG

芯步的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(时间戳)。

  • 签名算法

    1. 将开发者密码(AppSecret)进行一次 MD5 加密。

    2. 将结果拼接上当前 Unix 时间戳(ts)。

    3. 对整个字符串再次进行 MD5 加密得到 sign公式:sign = md5(md5(AppSecret) + ts)

4. 详细实施步骤

4.1 设备配网与激活
  1. 注册与登录:访问芯步官网,注册企业/开发者账号

  2. 添加设备

    • 在“物联网控制台”中找到“网络配置”或“设备管理”。

    • 输入现场的 Wi-Fi 名称(SSID)和密码(注意:仅支持 2.4G Wi-Fi

    • 长按控制器上的配对按键(通常为指示灯闪烁状态),设备将会自动搜索并连接配置好的网络。

  3. 获取设备ID:在控制台设备列表中,查看已成功配网的设备,记录下唯一的 device ID(例如: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. 应用场景拓展

  1. 共享空间(自习室/会议室)

    • 用户在小程序下单 -> 服务器自动发送指令 {"power1":1} 开启该座位灯光和插座。

    • 时间到后,自动发送 {"power1":0} 断电。

    • 配合语音喇叭接口:在断电前利用语音播报提醒用户续费

  2. 智能工厂

    • 定时任务:通过云平台设置定时任务,例如每天早上8:00发送开灯指令,下午6:00发送关灯指令。

    • 联动控制:结合芯步人传感器,当检测到人员移动时,发送指令打开照明,无人时关闭,实现节能。

  3. 楼宇自控

    • 集成到现有的楼宇自动化系统中,通过调用 HTTP API 实现集中控制面板或一键场景模式(如“下班模式”一次性关闭全部4路照明)。

6. 注意事项

  • 负载限制:虽然单路支持10A,但全开时总负载不超过4400W。对于感性负载(如电机、风扇),需适当降低负载功率以保证继电器寿命

  • 网络稳定性:设备依赖 2.4G Wi-Fi,确保现场信号强度足够。若Wi-Fi不稳定,可启用设备的多网络备援功能(支持预设5组WiFi)

  • 时序保护:该控制器内置时序保护功能,如果频繁快速通断,设备可能会有短时的保护延迟,这是正常现象,用以保护用电设备

通过以上步骤,开发者可以在极短的时间内(十分钟级)完成从注册到控制指令的下发,实现对照明系统的智能化改造。

控制器产品方案:
如何二次开发4 路智能照明控制器来实现定时开关照明设备电源
查看 >>
共享自习室包间管理:怎么将8路包间灯光空调控制器接入到软件项目中
查看 >>
无人值守包间设备控制:怎么将8路包间设备集中控制器集成到软件项目中
查看 >>
剧本杀密室包间场景:怎样把HTTP接口包间控制器接入到自己的项目中
查看 >>
厂房多设备集中控制:怎样把24 路智能分体远程电源控制器对接到软件项目中
查看 >>
4路场景方案:
如何接入4 路共享设备控制模块来实现4 路照明设备电源状态监测
查看 >>
4路服务门店包间专用控制器MINI:怎么将4路远程包间电源管理模块MINI集成到自己的项目中
查看 >>
怎样在4路包间场景联动控制器MINI中对接智能硬件以实现包间设备故障自动告警
查看 >>
怎么在4路HTTP接口包间控制器MINI中集成智能硬件以实现包间门禁系统联动管理
查看 >>
怎样在酒店客房照明控制中集成智能硬件来实现4路独立线路控制
查看 >>
远程控制用途方案:
怎样在配电柜智能改造中对接智能设备来实现远程控制8路电源
查看 >>
怎样二次开发8 路智能分体远程交直流输出控制箱来实现远程控制8路线路
查看 >>
怎样二次开发双路智能墙壁开关来实现HTTP接口远程控制设备
查看 >>
如何接入远程控制智能通断器模块来实现HTTP接口远程控制
查看 >>
怎么接入2路HTTP接口智能开关以实现远程控制照明与设备
查看 >>