CATALOG

AC1-10A 是芯步推出的一款支持 HTTP 接口控制的智能通断器,通过二次开发可以将其转化为可采集电流数据、可感知设备状态的“智能传感器”。以下方案从状态感知、数据采集、异常告警三个维度,给出完整的开发路径。

解决方案:基于芯步 AC1-10A 开放接口的设备运行状态监控系统

1. 核心思路

通常情况下,AC1-10A 仅作为一个被动的执行器(接收开/关指令)。为了实现运行状态监控,我们需要利用该设备的上行消息机制。当设备状态变化或周期性上报数据时,云平台会主动将消息推送到你指定的服务器,从而实现对电流、电压、功率及开关状态的实时监控

2. 硬件与接口准备

  • 硬件型号:芯步智能通断器 AC1-10A(额定功率 2200W,支持 WiFi 2.4G)

  • 开发凭证

    • AppID:应用唯一标识。

    • AppSecret:开发者密钥(用于签名计算)。

  • 设备ID:通过官方控制台获取目标设备的 device 标识符

3. 状态监控的技术实现方案

3.1 实时状态感知:配置消息推送

单纯的轮询无法做到实时监控,且容易触发 API 限流。方案应采用Webhook 回调机制

  • 操作步骤:在芯步控制台中,配置“消息推送 URL”(例如:http://yourdomain.com/api/device/callback)。

  • 触发场景

    1. 设备上下线:设备断电断网或重新联网时,会推送事件。

    2. 状态变化:用户按下物理按键、或 HTTP 控制指令执行后,设备状态发生变化。

    3. 遥测数据:设备会按策略上报电压(V)、电流(A)、功率(W)等数据

  • 数据解析示例:你需要在你的服务器端接收 POST 请求,解析 JSON 包,获取 power(开关状态)、current(电流值)等字段。

3.2 主动状态巡检:调用控制与查询接口

对于需要确认命令是否执行成功或定时巡检的场景,可以通过 HTTP 接口主动拉取状态。

  • API 地址https://api.thingboot.com/{AppID}/device/control/

  • 签名算法为了保证接口安全,每次请求需携带签名 sign,计算公式为:

    1. md5_secret = md5(AppSecret)

    2. sign = md5(md5_secret + ts)(其中 ts 为 Unix 时间戳)

  • 下发指令

    • 查询状态:通过约定命令获取当前实时功率。

    • 控制通断:下发 {"power":1} 开启,{"power":0} 关闭。

3.3 AC1-10A 特有的监控逻辑

不同于普通的开关,AC1-10A 的高价值在于其电量计量功能。

  • 电流监控:设定阈值的判断逻辑。例如,当 power 状态为 1(开启),但 current < 0.1A(电流极小),逻辑判定为 “设备空载/故障”

  • 功率超限保护:如果在运行中检测到 power > 2200W(额定值),系统应立即下发 {"power":0} 指令强行断电,实现软保护,具体代码如下:

4. 系统设计

为方便你理解整个数据流向,以下是推荐的高可用架构:

  1. 设备层:AC1-10A 智能通断器连接 WiFi,与控制设备(如电机、水泵、照明)相连。

  2. 平台层:芯步云平台处理设备连接状态与数据。

  3. 应用层:你的业务服务器。

    • 回调服务:接收平台推送的状态数据,存入数据库。

    • 分析服务:逻辑判断(如“运行时长统计”、“异常断电告警”)。

    • 控制服务:定时任务查询设备状态或下发补偿指令。

  4. 展示层:可视化大屏或手机 APP。

5. 关键代码实现逻辑

由于你不需要附件,以下提供伪代码逻辑,展示如何在你的业务系统中整合监控逻辑:

(1)回调接收端你需要编写一个 Web 服务来接收设备的实时上报:

(2)主动查询端如果需要定时查询设备是否掉线:

6. 常见异常场景监控策略

监控场景AI 判定逻辑联动动作
设备离线连续3次回调超时,或 API 返回设备不在线。推送“网络异常”告警;如果是关键设备,触发备用设备切换。
电流过载上报电流 > 额定电流 (10A) 且持续超过 3 秒。下发 {"power":0} 切断电路,防止烧毁。
空载运行设备处于“开”状态,但电流 < 0.05A 持续 30 秒。下发 {"power":0} 关闭电源,节约电能并保护电机。
状态漂移软件逻辑需要“开”,但反馈状态是“关”。重新下发 {"power":1} 指令,并记录一次纠正日志。

7. 总结

通过二次开发 AC1-10A,它不再是一个简单的开关,而是一个可感知、可计算、可报警的智能断路器。利用其开放的 HTTP API 进行双向通信,结合消息回调机制,开发者可以在 3-5 天内快速构建起一个基础的工业或商业设备运行状态监控系统