CATALOG

芯步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 设备初始化与配网

  1. 注册与创建:在芯步官网注册账号,进入“物联网控制台”,创建一个新的工作台应用,获取 AppIDAppSecret

  2. 设备配网

    • 手机连接 2.4G WiFi(注意:IoT 设备通常不支持 5G 频段)。

    • 打开芯步提供的配网小程序或 App(通常支持 SmartConfig 或 AP 模式)。

    • 将设备的 MAC 地址/ID 绑定到账户下的工作台中。

  3. 获取标识:在后台“设备列表”中查看刚刚添加的 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 代码,安全、高效地将传统照明系统升级为智能化物联网系统。