AC2-10A智能通断器支持通过HTTP接口进行远程控制和能耗数据获取,可快速集成到现有系统中。以下方案涵盖接口接入流程、能耗数据获取方式以及定时控制策略。
1. 背景与目标
在智能楼宇、基站管理、工业物联网等领域,对小型用电设备的精细化管理需求日益迫切。传统的定时开关仅能控制通断,无法感知能耗,导致无法进行能效分析和故障预警。
AC2-10A 智能通断器 是芯步推出的一款支持 WiFi 直连、具备 10A-16A 承载能力(额定功率 2200W)的智能控制设备。本方案的目标是指导开发者如何通过其开放的 HTTP API 接口,快速将该设备集成到第三方系统中,实现实时能耗监测、远程通断控制及个性化定时任务的闭环管理。
2. 硬件与接口能力
在开始开发前,需明确 AC2-10A 的技术特性,这对设计至关重要
通信方式:WiFi 2.4GHz,无需网关,直连路由器。
控制能力:1路继电器输出,支持“先通后断”与“先断后通”模式。
数据上报:支持状态变化实时推送(类似微信公众号机制)至指定 URL(Webhook)。
接口协议:HTTP/HTTPS + JSON,签名认证(MD5)。
3. 设计
为了实现“实时计量控制”,采用 “下行控制 + 上行推送” 的双向架构:
下行链路(控制端):您的业务服务器通过调用芯步开放 API,向设备下发“开/关”或“定时”指令。
上行链路(感知端):AC2-10A 实时监测线路功耗。一旦电量发生变化或达到统计周期,设备主动通过 HTTP POST 请求将消息推送到您指定的服务器地址。
4. 接入流程详解
4.1 前期准备与鉴权
首先需要在芯步控制台获取密钥对,接口鉴权采用 双重 MD5 嵌套 机制,相比明文 Token 更安全。
签名算法Sign = MD5( MD5(AppSecret) + ts )
AppSecret:开发者密码。ts:Unix 时间戳(秒)。
开发注意:时间戳有效期通常控制在 5 分钟内,防止请求被重放攻击。
4.2 功能一:实时能耗数据的获取(上行)
这是实现“计量”功能的核心。AC2-10A 不具备主动查询的电表寄存器,而是采用 “变化即推送” 的模式。
配置消息接收服务器在设备管理控制台中,配置您的服务器接收地址(URL)。当设备状态变化或能耗更新时,芯步服务器会向该地址发送 JSON 数据包。
典型能耗数据字段解析当设备上报数据时,您的服务器接口应能接收如下结构的参数:
power:当前实时功率(W)。energy:累计用电量(kWh)。voltage:当前电压(V)。current:当前电流(A)。power_factor:功率因数。
应用逻辑您的接收接口收到数据后,应立即存入 Redis 或时序数据库(如 InfluxDB),用于实时大屏展示或历史曲线分析。
4.3 功能二:远程控制与定时执行(下行)
系统需要根据能耗数据(如“检测到功率低于阈值”)或时间策略(如“18:00 开启”)下发指令。
1. 标准通断控制通过调用 HTTP 接口控制设备闭合或断开。
请求地址
https://api.thingboot.com/{AppId}/device/control/请求方法:POST
核心命令示例
2. 自定义动作与精密定时AC2-10A 支持毫秒级的延时动作,这对于保护压缩机类设备(如空调、冰箱)尤为重要。例如,断电后需等待 3 分钟才能再启动,避免损坏:
命令示例
{"power1": 0, "delay": 180000}(延迟 180 秒后关闭)脉冲模式
{"pulse": {"power1": 1, "duration": 500}}(开启 500 毫秒后自动关闭,用于触发门禁或信号灯)。
5. 解决方案实施:定时能耗控制策略
以下结合以上接口,构建一个 “基于实时电费的空调自动轮控” 场景,展示 AC2-10A 的业务逻辑:
策略逻辑
计量:AC2-10A 每分钟上报一次电流与功率。
判断:服务器发现当前时段为“尖峰电价”,且总功率超过阈值。
执行:下发指令关闭非必要设备;待功率下降或时段结束后,再下发指令恢复供电。
核心代码逻辑示例 (Python/伪代码)
6. 高级功能集成
6.1 断网重连与本地缓存
AC2-10A 支持设定 5组WiFi网络 并自动切换最强信号。在您的软件设计中:
利用设备的“心跳”机制判断设备在线状态。
若设备离线,服务器端定时任务应暂停下发,避免因指令堆积导致的“误动作”。
6.2 消息去重与调用机制
由于网络重试机制,设备可能会重复推送相同时间戳的能耗数据。您的接收接口应通过 msg_id 或 timestamp + device_id 做调用机制校验,避免数据库写入重复的用电记录。
7. 总结
免网关:相比 Zigbee 或 LoRa 方案,AC2-10A 的 WiFi 直连大幅降低部署成本和维护复杂度。
开放性:标准 HTTP API 使得任何编程语言均可接入,无缝对接现有的 ERP 或楼宇自控系统。
精细化:毫秒级延时控制与实时功率反馈,满足了从简单的路灯定时到复杂的工业设备能耗管理的全场景需求。