CATALOG

芯步的AC4-10A智能通断器通过HTTP API实现了设备控制与业务逻辑的解耦,这意味着你可以用任何支持HTTP的编程语言,在几分钟内完成远程开关的集成。以下方案涵盖接口对接、签名鉴权、代码示例以及会议室场景的联动设计。

解决方案:基于芯步 AC4-10A 的智能办公电路控制系统集成

1. 概述与准备工作

在现代智能办公场景中,对照明、饮水机、投影幕布或会议室新风系统的交流电路进行远程通断控制,是实现节能与自动化的基础。芯步推出的 UNI-TDQ-AC4-10A 型号智能通断器,是一款支持WiFi直连、无需网关的硬件设备

核心集成目标:将 AC4-10A 硬件通过其开放的 HTTP API 接口,无缝接入现有的企业办公软件(如钉钉、企业微信)或自研的 SaaS 后台,实现电路状态的实时监控与远程控制。

准备工作:

  1. 硬件设备:芯步 AC4-10A 智能通断器(已通电并处于未配网状态)。

  2. 开发账号:注册芯步官方平台账号,获取 AppIDAppSecret(用于生成签名)。

  3. 网络环境:设备仅支持 2.4G WiFi,需确保办公区域 WiFi 信号覆盖

2. 硬件部署与网络配置

在写代码之前,需要先将物理设备连接到网络。

  • 配网流程

    1. 登录芯步物联网控制台。

    2. 在“网络配置”中登记现场的 2.4G WiFi 名称与密码

    3. 长按设备外壳上的按钮直至指示灯进入快闪模式(配网状态)。

    4. 通过控制台将网络凭证推送给设备。成功后,设备将出现在“在线设备”列表中。

  • 获取凭证:在设备列表中记录下该设备的唯一标识符 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 构建的典型办公场景:

第一种场景:会议室智能调度

  • 需求:会议室没人时自动断电,有人预定且刷卡进门时自动通电。

  • 实现方案

    1. 传感层:部署芯步的 “人体存在雷达传感器” 。当传感器探测到无人状态持续超过15分钟,会向服务器上报“无人”事件

    2. 逻辑层:软件后台接收到“无人”事件,同时查询会议室的预约系统(API对接)。

    3. 执行层:若无人且无预约,后台自动调用本文的 {"power":0} 接口,通过 AC4-10A 切断麦克风、投影仪及空调的总电源,实现节能。

第二种场景:设备维护与定时任务

  • 需求:饮水机/热水器只在工作时段运行,防止干烧。

  • 实现方案

    • 利用芯步平台自带的 “定时任务” 功能,或自行编写 Cron 脚本,在 9:00 调用 {"power":1},在 18:00 调用 {"power":0}

    • 高级特性:AC4-10A 支持设定 5 组 WiFi 网络并自动切换,即便办公网络信号波动,也能保证定时任务的稳定性

6. 注意事项与排障指南

  1. 状态反馈机制API 返回 200 仅代表服务器收到了指令,不代表设备真的执行成功(可能在断电或断网状态)。对于正式场景(如远程重启关键服务器),订阅 “消息推送” 服务,接收设备执行后的回执才进行最终确认

  2. 私有化部署支持若办公环境涉及敏感数据不允许上公网,AC4-10A 同样支持 局域网私有化部署。只需设置 api.thingboot.com 指向内部 IP 地址,所有 HTTP 流量将在内网闭环,安全性比较高

  3. 电气安全AC4-10A 额定电流为 10A(最大约 2200W),严禁接入中央空调外机或大功率工业设备。接线前请一定要关闭总闸,零火线不可接反(通常 L 为进火线,L‘ 为出火线接负载)。

通过以上方案,开发者可以在 2 小时内完成单台设备的对接,并以此为基座,构建覆盖全办公楼的能效管理系统。