芯步的智能通断器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 前置准备
获取凭证: 在芯步开发者后台创建应用,获取
AppId和AppSecret,用于生成签名 。设备配网: 使用厂商提供的配网小程序,将 UNI-TDQ-AC1-10A 设备连接到现场 WiFi,并记录下生成的唯一标识
device_id。
3.2 接口鉴权机制
芯步的接口使用动态签名进行安全校验。每次请求需在 URL 中携带 sign (签名) 和 ts (时间戳)。
签名生成逻辑(通用伪代码):
将所有请求参数(如
device_id,power状态)+AppSecret按 Key 排序。拼接成字符串,进行 MD5 或 SHA256 加密。
安全提示:不要在客户端 APP 代码中硬编码 AppSecret,应在您的业务后端生成签名后,再由后端下发给前端或直接由后端调用硬件接口 。
4. 实战代码逻辑(后端视角)
以下是您需要写入软件项目代码中的核心逻辑。本方案以 Java Spring Boot 和 Python 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. 高级应用:状态反馈与安防联动闭环
安防系统不仅需要“控制”,更需要“感知”状态。如果有人在本地按下了通断器上的物理按钮,您的软件界面状态可能还是“关闭”,这就产生了状态不同步。
解决方案:配置消息推送利用芯步平台的“第三方回调”功能
配置回调 URL: 在您的软件项目中暴露一个接口(例如:
https://your-server.com/api/device/callback),并在物联平台配置该地址。实时上报: 无论通断器是被 API 触发、本地按键触发、还是定时任务触发,只要状态改变,平台会立即向您的服务器发送
POST请求。库存逻辑: 您的后端接收到状态变化通知后,可以更新数据库中的设备状态,或通过 WebSocket 实时推送到前端 UI 上。
6. 最佳实践和需要注意的点
私有化部署(可选): 如果安防项目涉及政府、金融等对数据安全要求比较高的行业,芯步设备支持 局域网(LAN)模式。您可以自建 Mosquitto 等 MQTT 服务器,或使用设备的 HTTP 局域网 API,所有控制指令不经过公网,确保物理安全 。
功率限制: 该设备额定 10A,虽然足以驱动普通安防设备,但严禁直接接入空调、中央空调等大功率压缩机(启动电流可能超过 10A),否则会烧毁设备触点。
保险丝预留: 在实际安装时,在通断器前端串联一个合适的熔断器,以应对雷击或短路造成的过流风险。
7. 总结
通过上述方案,您无需重新设计底层物联网通信协议,只需关注业务逻辑。利用芯步 AC1-10A 提供的标准 RESTful API,您的软件项目可以像操作一个本地函数一样,轻松实现对全球各地安防现场 220V 交流电源 的“通”与“断”控制,从而构建声光报警、设备重启、电源切非等高级安防自动化场景。