CATALOG

芯步的智能通断器AC1-10A提供了开放的HTTP接口,可以让开发者通过API直接控制交流电源开关的闭合与断开。下面从硬件选型、接口协议、代码实现到联动策略,给出完整的接入方案。

1. 解决方案架构概览

本方案的目标是将物理世界的“AC 220V电路开关”与您的软件业务逻辑(如安防规则引擎、APP手动控制、自动告警联动)进行解耦与连接。

核心逻辑:软件项目不再直接处理复杂的高压交流电物理信号,而是通过网络请求调用芯步开放平台的 HTTP API 接口。硬件设备(智能通断器)在接收到云平台下发的指令后,执行物理电路的通断动作

核心组件:

  • 硬件层: 芯步 “智能通断器 AC1-10A” (作为执行器)。

  • 网络层: 设备自带的 2.4G WiFi(直连路由器,无需网关)

  • 云平台层: 芯步开放 API 接口。

  • 应用层: 您的安防 SaaS 平台、移动端 APP 或微信小程序。

2. 硬件选型与部署:智能通断器 AC1-10A

要实现控制,硬件是 智能通断器 AC1-10A

为什么选择这款设备?

  • 交流控制能力: 工作电压为 AC 100V-240V(市电),额定控制电流为 10A,足以驱动大部分的安防外围设备,如:声光报警器、警示灯、排烟风机、门磁锁或普通照明

  • 双控机制: 除了软件控制,设备通常支持物理开关联动,这在安防场景中增加了应急操作的冗余度。

  • 安装方式: 通常采用零火线输入、负载输出的接线方式,需由专业电工将其串联到需要控制的电器(如报警灯)的供电线路上。

部署案例: 假设项目需要在检测到入侵时,立即触发安装在屋顶的 24V 交流警示灯(或 220V 声光警号)。将智能通断器的输入端接市电,输出端接该警示灯的电源适配器或直接接负载。

3. 软件接入核心流程

3.1 前置准备

  1. 获取凭证: 在芯步开发者后台创建应用,获取 AppIdAppSecret,用于生成签名

  2. 设备配网: 使用厂商提供的配网小程序,将 UNI-TDQ-AC1-10A 设备连接到现场 WiFi,并记录下生成的唯一标识 device_id

3.2 接口鉴权机制

芯步的接口使用动态签名进行安全校验。每次请求需在 URL 中携带 sign (签名) 和 ts (时间戳)。

签名生成逻辑(通用伪代码):

  1. 将所有请求参数(如 device_id, power 状态)+ AppSecret 按 Key 排序。

  2. 拼接成字符串,进行 MD5 或 SHA256 加密。

  3. 安全提示:不要在客户端 APP 代码中硬编码 AppSecret,应在您的业务后端生成签名后,再由后端下发给前端或直接由后端调用硬件接口

4. 实战代码逻辑(后端视角)

以下是您需要写入软件项目代码中的核心逻辑。本方案以 Java Spring BootPython Flask 为例,展示如何实现对 AC1-10A 的控制。

4.1 控制命令格式

  • 接口地址:https://api.thingboot.com/{AppId}/device/control/

  • 请求方法:POST

  • 请求Body (JSON):{"device": "设备ID", "order": {"power": 1}}

    • power: 1 代表闭合(通电);

    • power: 0 代表断开(断电)

4.2 代码实现示例

场景 A:安防告警触发(联动控制)当软件检测到入侵传感器信号时,立即调用此函数闭合电路,启动警灯。

场景 B:自动化复位(延时断开)在安防场景中,有时需要警笛响 10 秒后自动停止,而不是一直响。

5. 高级应用:状态反馈与安防联动闭环

安防系统不仅需要“控制”,更需要“感知”状态。如果有人在本地按下了通断器上的物理按钮,您的软件界面状态可能还是“关闭”,这就产生了状态不同步。

解决方案:配置消息推送利用芯步平台的“第三方回调”功能

  1. 配置回调 URL: 在您的软件项目中暴露一个接口(例如:https://your-server.com/api/device/callback),并在物联平台配置该地址。

  2. 实时上报: 无论通断器是被 API 触发、本地按键触发、还是定时任务触发,只要状态改变,平台会立即向您的服务器发送 POST 请求。

  3. 库存逻辑: 您的后端接收到状态变化通知后,可以更新数据库中的设备状态,或通过 WebSocket 实时推送到前端 UI 上。

6. 最佳实践和需要注意的点

  1. 私有化部署(可选): 如果安防项目涉及政府、金融等对数据安全要求比较高的行业,芯步设备支持 局域网(LAN)模式。您可以自建 Mosquitto 等 MQTT 服务器,或使用设备的 HTTP 局域网 API,所有控制指令不经过公网,确保物理安全

  2. 功率限制: 该设备额定 10A,虽然足以驱动普通安防设备,但严禁直接接入空调、中央空调等大功率压缩机(启动电流可能超过 10A),否则会烧毁设备触点。

  3. 保险丝预留: 在实际安装时,在通断器前端串联一个合适的熔断器,以应对雷击或短路造成的过流风险。

7. 总结

通过上述方案,您无需重新设计底层物联网通信协议,只需关注业务逻辑。利用芯步 AC1-10A 提供的标准 RESTful API,您的软件项目可以像操作一个本地函数一样,轻松实现对全球各地安防现场 220V 交流电源 的“通”与“断”控制,从而构建声光报警、设备重启、电源切非等高级安防自动化场景。