芯步的通断器AC3计量版通过WiFi直连，开放HTTP/MQTT接口，支持远程通断控制和实时电量采集。以下方案涵盖设备配网、接口鉴权、状态反馈和业务系统集成等关键环节。
解决方案：基于芯步开放平台对接智能通断器AC3计量版
1. 概述
本方案的目标是指导开发者如何利用芯步开放平台，对接 智能通断器 AC3-10A 计量版。通过调用其开放接口，实现对其线路的远程通断控制、状态实时反馈以及电能数据计量。
AC3-10A计量版（型号：UNI-TDQ-AC3-10A-P）支持WiFi直连，无需网关，支持HTTP/HTTPS请求及MQTT协议，适用于智慧楼宇、能源管理、智能家居等场景。
2. 硬件与接口能力
| 能力项 | 参数/功能 | 说明 |
|---|---|---|
| 设备型号 | UNI-TDQ-AC3-10A-P | 10A计量版本 |
| 控制指令 | power (线路通断) | 下发 power=1 接通，power=0 断开 |
| 计量数据 | metering (实时读取) | 电压、电流、功率、用电量等 |
| 定时功能 | reset/point | 支持先断后通、先通后断的自动时序控制 |
| 响应延迟 | 80-120ms | 下发指令到设备执行的往返时间 |
设备支持远程定时任务和自定义联动操作，当负载超过设定的安全功率阈值时，设备具备自动断电保护功能。
3. 对接准备
注册芯步开发者账号，获取AppID和AppSecret。
配网：将AC3计量版通电，通过“芯步”小程序或控制台进行网络配置。该设备仅支持2.4G WiFi频段，可预设5组WiFi网络以实现信号冗余。
设备ID获取：配网成功后，在物联网控制台的设备列表中查看并记录Device ID。
4. 核心接口鉴权（Sign签名）
所有HTTP接口请求均需携带sign和ts参数，鉴权机制如下：
将开发者密码（AppSecret）进行一次MD5加密。
将上一步结果拼接上当前时间戳
ts（10位秒级）。将拼接后的字符串再次进行MD5加密，得到最终的
sign。
公式
sign = md5( md5(AppSecret) + ts )
5. 关键功能实现流程
5.1 线路状态反馈与控制
通过向设备下发指令实现远程操控，接口地址为：http(s)://api.thingboot.com/{AppID}/device/control/。
第一种场景：远程开启/关闭线路
请求方法：POST
Body参数
接口返回200仅代表指令下发成功，不代表设备实际执行结果，需配合消息推送确认。
第二种场景：获取实时用电计量
指令：下发读取计量命令或等待设备自动上报。
指令示例
{"metering":"read"}返回数据解析：设备上报的数据通常包含
voltage（电压）、current（电流）、power（功率）、energy（累计电量）等字段。
第三种场景：先断后通时序控制（适用于风机、灯光复位）
需求：断开线路5秒后重新接通。
指令
{"reset": 5000}（单位毫秒）。此指令在需要对设备进行完全断电重启或临时切断负载的场景中尤其适用。
5.2 实时状态同步方案
单纯的HTTP请求是单向的，为了获取设备真实状态（如本地按键操作、过载自动断电），需配置消息推送机制。
方案A：HTTP回调（推荐）
在芯步控制台设置“API回调URL”。
当设备状态变化（如功率突变、开关被按下、自动断电）时，平台会主动POST数据到指定URL。
业务系统接收并解析数据，更新数据库中的设备状态。
方案B：主动轮询
定时（如每5秒）向设备下发查询指令获取最新状态。
注意：此方式实时性较差且易触发接口限流（单设备1次/秒限制）。
5.3 批量与分组控制
若需同步控制多个AC3计量版，使用分组接口：http(s)://api.thingboot.com/{AppID}/group/control/。
指令示例：同时控制一组设备全部关闭。
分组控制接口支持一次操作最多100台设备，适用于区域总控或场景联动需求。
6. 业务系统集成架构
系统集成采用异步架构：
控制链路：业务系统 → 芯步开放平台（HTTP/ MQTT） → WiFi路由器 → AC3计量版
状态链路：AC3计量版 → 芯步云平台 → 业务系统（HTTP回调）
这种分离的设计保证了控制指令的快速下发与状态数据的可靠同步，避免因网络波动导致状态丢失。
7. 注意事项
私有化部署：AC3计量版支持局域网纯环境运行。若需在内网使用，可在服务器上部署芯步提供的私有化服务，此时API地址将指向本地服务器，不依赖公网。
限流策略：接口限制为单设备每秒1次访问，高并发场景下需在业务层做好请求合并与限流。
安全保护：计量版支持设置“安全功率”阈值。对接时增加此配置接口，当设备上报功率超过阈值触发自动断电后，系统应记录断电事件并向运维人员告警。
extra字段用法：在需要追踪指令业务来源的场景（如工单系统），可在
order中传入extra字段，平台异步推送时会原样返回，便于业务闭环。
8. 总结
通过芯步的开放接口对接AC3-10A计量版，开发者仅需关注签名算法和设备ID管理。利用power指令实现控制，监听HTTP回调获取计量与反馈，即可快速集成可靠的线路状态反馈与控制系统。