芯步AC5-10A智能通断器是一款支持HTTP接口的WiFi继电器模块,可嵌入传统灯具线路实现远程开关控制。以下方案涵盖硬件接线、接口调用、代码示例及部署架构。
1. 解决概述
在许多智慧园区、工业厂区或老旧办公楼改造项目中,存在大量传统的荧光灯、高压汞灯或LED灯具。这些灯具通常由墙壁开关或传统配电箱控制,无法接入现代的楼宇自动化系统。
本方案的目标是通过芯步 AC5-10A 智能通断器,利用其开放的 HTTP API 接口,在不改动现有灯具主体线路的前提下,将传统灯具快速接入物联网平台,实现远程集中控制、定时策略下发及状态反馈。
AC5-10A 型号支持最高 10A 电流(约 2200W 阻性负载),适用于绝大多数工业照明及商用照明回路。
2. 硬件选型与接线指南
2.1 硬件:芯步 AC5-10A
电气参数:工作电压 AC 100-250V,额定电流 Max 10A。
控制能力:1路继电器输出,支持功率高达 2200W(阻性负载),对于 LED 或感性负载控制在 350W 以内以保证稳定性。
网络特性:支持 2.4GHz WiFi,直连路由器,无需额外购买网关,降低项目硬件成本。
特色接口:提供一路开关量输入接口,可外接物理按键(如复位开关或墙壁开关),实现“本地+远程”双控,即使网络中断也不影响本地操作。
2.2 接线原理与安全规范
在进行接线前,必须切断总闸电源,并由持证电工操作。该设备体积小巧(45.2mm * 41.1mm * 20mm),适合隐藏在灯具的接线盒或灯罩内。
输入端(L/N):火线(L)进、零线(N)进。
输出端(L1/N1):接灯具负载。
物理按键(IN):可外接自复位开关,连接到 GND 和 IN 端口,用于本地控制。
接线示意图解
电源火线 → 设备L端电源零线 → 设备N端 & 灯具N端(零线直通)设备L1端 → 灯具L端(火线受控)
3. API 接口对接详解
AC5-10A 采用标准的 HTTP 协议进行通信,这意味着只要你的项目能发起 HTTPS 请求(C/C++、Java、Python、Go、Node-RED 等),即可实现控制。
3.1 接口基础信息
请求地址
https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}请求方法:POST
数据格式:JSON
核心鉴权参数
AppID:在芯步控制台创建应用后获取。ts:Unix 时间戳,用于防止重放攻击。sign:签名,根据AppSecret和参数排序计算得出(具体算法需参考官方文档,通常是对参数进行 MD5 或 SHA-1 加密)。
3.2 核心指令集
在请求的 Body 中,通过 order 字段传递控制指令。
| 功能描述 | order 参数值 | 场景说明 |
|---|---|---|
| 开启灯具 | {"power":"1"} | 继电器吸合,线路导通 |
| 关闭灯具 | {"power":"0"} | 继电器断开,线路切断 |
| 临时点亮(点动) | {"point":"5000"} | 先导通,保持5秒后自动断开(单位:毫秒) |
| 短暂断电(复位) | {"reset":"2000"} | 先断开,2秒后自动重新吸合 |
3.3 多语言代码示例
第一种场景:使用 cURL 命令行(适用于 Shell 脚本调试或 Linux 嵌入式环境)
在自动化脚本中,可以直接调用系统命令来开关灯。
参考来源:芯步官方 Shell 脚本对接规范
第二种场景:PHP 后端(适用于 Web 管理系统)
在现代 Web 项目中,通常在后端封装统一的照明控制服务。
参考来源:芯步 PHP 对接示例
第三种场景:Python 自动化(适用于安防联动或定时任务脚本)
4. 项目落地实施流程
4.1 设备初始化与配网
注册与创建:在芯步官网注册账号,进入“物联网控制台”,创建一个新的工作台应用,获取
AppID和AppSecret。设备配网
手机连接 2.4G WiFi(注意:IoT 设备通常不支持 5G 频段)。
打开芯步提供的配网小程序或 App(通常支持 SmartConfig 或 AP 模式)。
将设备的 MAC 地址/ID 绑定到账户下的工作台中。
获取标识:在后台“设备列表”中查看刚刚添加的
device_id,这是后续 API 调用的唯一凭证。
4.2 系统集成架构
为了实现稳定的控制,采用如下三层架构:
设备层:AC5-10A 通断器嵌入灯具回路,通过 WiFi 连接至现场 AP/路由器。
传输层:设备保持长连接至芯步公有云平台(或私有化部署的 MQTT/HTTP 服务器)。响应时间通常在 80-120ms 之间。
应用层:你的业务服务器通过调用芯步的开放 HTTP API 下发指令。
*注:如果项目要求纯局域网内运行,AC5-10A 同样支持私有化部署,可将数据直接推送至你的自建服务器。*
4.3 高级功能扩展
定时与联动:利用
point(先通后断)或reset(先断后通)指令,结合服务器端的 Cron 任务,可以实现路灯半夜隔盏关灯(节能模式)或消防报警强切强启功能。本地物理备份:利用设备的开关量输入接口,外接一个常开按钮。这相当于在物理层面保留了操控权,对于不符合“长期通电”习惯的场所(如会议室),这一设计能提升用户体验。
状态反馈:虽然 AC5-10A 主要侧重控制,但在项目中若需确认灯具是否真正亮起(如灯具损坏检测),配合芯步生态中的光照传感器或电量计量版通断器(AC4-10A 计量版),通过对比电流变化来判断灯丝状态。
5. 常见问题与规避
WiFi 信号强度:AC5-10A 依赖 2.4G WiFi。在厂房或大型仓库中,若灯具安装在金属灯罩内,信号可能被屏蔽。在实施前进行点位信号测试,或确保附近 10-15 米内有良好的 AP 覆盖。
感性负载冲击:若控制的是老式电感镇流器的日光灯或电机,由于启动瞬间电流极大(可达额定电流的5-7倍),负载功率控制在 300W 以内,或降额使用以防继电器触点粘连。
签名算法:这是对接中最容易出错的一环。在开发阶段,开启芯步控制台的“日志”功能,对比本地生成的
sign与平台工具生成的sign是否一致,以确认加密逻辑。
通过上述方案,开发人员可以在不进行复杂嵌入式开发的情况下,仅通过几行 HTTP 代码,安全、高效地将传统照明系统升级为智能化物联网系统。