芯步的AC4-10A智能通断器通过HTTP API实现了设备控制与业务逻辑的解耦,这意味着你可以用任何支持HTTP的编程语言,在几分钟内完成远程开关的集成。以下方案涵盖接口对接、签名鉴权、代码示例以及会议室场景的联动设计。
解决方案:基于芯步 AC4-10A 的智能办公电路控制系统集成
1. 概述与准备工作
在现代智能办公场景中,对照明、饮水机、投影幕布或会议室新风系统的交流电路进行远程通断控制,是实现节能与自动化的基础。芯步推出的 UNI-TDQ-AC4-10A 型号智能通断器,是一款支持WiFi直连、无需网关的硬件设备。
核心集成目标:将 AC4-10A 硬件通过其开放的 HTTP API 接口,无缝接入现有的企业办公软件(如钉钉、企业微信)或自研的 SaaS 后台,实现电路状态的实时监控与远程控制。
准备工作:
硬件设备:芯步 AC4-10A 智能通断器(已通电并处于未配网状态)。
开发账号:注册芯步官方平台账号,获取
AppID和AppSecret(用于生成签名)。网络环境:设备仅支持 2.4G WiFi,需确保办公区域 WiFi 信号覆盖。
2. 硬件部署与网络配置
在写代码之前,需要先将物理设备连接到网络。
配网流程
登录芯步物联网控制台。
在“网络配置”中登记现场的 2.4G WiFi 名称与密码。
长按设备外壳上的按钮直至指示灯进入快闪模式(配网状态)。
通过控制台将网络凭证推送给设备。成功后,设备将出现在“在线设备”列表中。
获取凭证:在设备列表中记录下该设备的唯一标识符 Device ID(例如:
12345678),后续所有 API 调用都需此 ID。
3. API 接口深度解析
芯步的接口设计遵循 RESTful 风格,通过 HTTP/HTTPS 协议传输,兼容性极强。
请求地址
http(s)://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}核心参数说明
AppID:在控制台应用管理模块获取。sign:签名,为防止接口被篡改,需将参数按字典序排序后结合AppSecret进行 MD5 加密。device:目标设备 ID(支持批量控制,用逗号分隔,上限100台)。order:控制指令(JSON 格式)。
针对 AC4-10A 的指令集该型号主要控制交流电路通断(Power On/Off),标准指令格式为:
扩展指令参考(若涉及多路或高级控制)若环境中使用了多路控制器版本,可支持精细化操作
单路控制
{"power1": 1}(控制第一路开启)批量控制
{"batch":{"relay":[1,3],"power":1}}(同时开启第1和第3路)临时触发
{"point":{"relay":[1],"interval":1000}}(瞬时通电1秒后自动断开,用于门禁或碎纸机等场景)
4. 代码实现与集成步骤
以下展示如何在不同编程环境下下发“打开电路”指令。
步骤 1:签名计算(通用逻辑)为防止他人伪造控制指令,系统要求签名。封装一个签名工具函数。逻辑:将 ts, AppID, Device 等参数按字母排序,拼接 Secret,计算 MD5。
步骤 2:发起 HTTP 请求示例:使用 Python 控制照明电路通断
步骤 3:接入办公软件(以网页/JavaScript 为例)在前端管理界面中,可以直接通过 Ajax 调用后台封装好的控制接口。
5. 进阶策略:打造智慧办公联动场景
单纯的手机开关只是第一步。真正提升价值的是逻辑联动。以下是基于 AC4-10A 构建的典型办公场景:
第一种场景:会议室智能调度
需求:会议室没人时自动断电,有人预定且刷卡进门时自动通电。
实现方案
传感层:部署芯步的 “人体存在雷达传感器” 。当传感器探测到无人状态持续超过15分钟,会向服务器上报“无人”事件。
逻辑层:软件后台接收到“无人”事件,同时查询会议室的预约系统(API对接)。
执行层:若无人且无预约,后台自动调用本文的
{"power":0}接口,通过 AC4-10A 切断麦克风、投影仪及空调的总电源,实现节能。
第二种场景:设备维护与定时任务
需求:饮水机/热水器只在工作时段运行,防止干烧。
实现方案
利用芯步平台自带的 “定时任务” 功能,或自行编写 Cron 脚本,在 9:00 调用
{"power":1},在 18:00 调用{"power":0}。高级特性:AC4-10A 支持设定 5 组 WiFi 网络并自动切换,即便办公网络信号波动,也能保证定时任务的稳定性。
6. 注意事项与排障指南
状态反馈机制API 返回 200 仅代表服务器收到了指令,不代表设备真的执行成功(可能在断电或断网状态)。对于正式场景(如远程重启关键服务器),订阅 “消息推送” 服务,接收设备执行后的回执才进行最终确认。
私有化部署支持若办公环境涉及敏感数据不允许上公网,AC4-10A 同样支持 局域网 和 私有化部署。只需设置
api.thingboot.com指向内部 IP 地址,所有 HTTP 流量将在内网闭环,安全性比较高。电气安全AC4-10A 额定电流为 10A(最大约 2200W),严禁接入中央空调外机或大功率工业设备。接线前请一定要关闭总闸,零火线不可接反(通常 L 为进火线,L‘ 为出火线接负载)。
通过以上方案,开发者可以在 2 小时内完成单台设备的对接,并以此为基座,构建覆盖全办公楼的能效管理系统。