怎样对接AC5-10A 电源控制模块来实现用电数据上传控制_解决方案

CATALOG

AC5-10A电源控制模块是一款支持HTTP接口直连的智能通断器，无需网关即可接入WiFi网络。以下方案将从接口架构、对接流程、核心功能实现到数据采集，给出完整的技术路径。

一、解决概述

AC5-10A 电源控制模块是芯步推出的一款支持WiFi直连的智能通断器，额定电流10A，适用于灯、电机、插座等设备的智能化改造。该模块的核心优势在于开放的HTTP API接口，意味着任何能发出HTTP请求的编程语言（Python, Java, PHP, Go）或工具（Postman）都可以直接与其通信。

目标：

控制层：实现对设备电源的开关、复位及点动控制。
数据层：实时获取设备当前的开关状态及用电负载情况（需结合其他传感器或平台算法）。
系统集成：将模块无缝接入现有的管理系统（如ERP、物业中台、能耗监测系统）。

二、对接前准备与环境配置

在编写代码之前，需要对模块进行初始化和获取关键凭证。

1. 设备配网

给AC5-10A模块通电。
使用微信或芯步App，将模块连接到2.4GHz的WiFi网络。
注意：该设备不需要网关，直接连接路由器，这降低了网络延迟和硬件成本。

2. 获取平台凭证登录芯步工作台，进行开发设置：

AppID：应用的唯一标识。
AppSecret：用于生成签名，鉴权密钥。
设备ID：在“设备列表”中查看该模块对应的数字ID。
开发模式：在对接初期，可以在工作台开启“调试模式”（Troubleshoot Mode），该模式下系统会暂时忽略签名校验，方便开发者快速验证指令格式。

三、接口对接核心逻辑

芯步的API采用统一的入口格式，签名机制保证了接口的安全性。

1. 接口地址与签名机制

请求URL： http(s)://api.thingboot.com/{AppId}/device/control/
参数：需携带 sign（签名）和 ts（时间戳）。
签名算法通常涉及将 AppSecret、ts 以及请求参数进行MD5加密。这是为了防止接口被恶意篡改。

2. 控制指令下发HTTP Method为 POST，Content-Type 为 application/json。

根据官方文档，控制电源通断的核心JSON结构如下

3. 高级功能命令结构除了简单的开关，AC5-10A还支持点动等功能

点动/脉冲控制通过下发 point 命令，可以实现类似“按一下”的效果，常用于门禁或触发信号。
{ "device": "设备ID", "order": { "point": 100 } } // 100毫秒的通断脉冲
复位
{ "device": "设备ID", "order": { "reset": null } }

四、用电数据采集方案

关于“用电数据上传”，AC5-10A模块的硬件本身主要是通断控制，为了获取精确的电压、电流、功率因数等用电数据，解决方案通常有两条路径：

1. 直接数据上报（推荐）芯步平台支持设备状态实时上报。当设备状态变化或按固定频率，模块会主动向你的服务器推送数据。

实现的方式是：在你的业务系统中配置消息接收接口（Webhook）。
数据内容：当AC5-10A执行开关动作或检测到负载变化时，它会将当前状态上报给你配置的服务器地址。
对接流程：在“开发设置”中配置“消息推送URL”，平台会将JSON格式的用电/状态数据POST到你的服务器。

2. 主动查询如果无法配置公网回调地址（例如在内网环境），系统可以采用定时轮询的方式。

五、实战：业务系统集成步骤

假设需要将“会议室投影仪电源”纳入OA系统管理。

第一步：下发控制开发人员编写后端逻辑，当用户在OA页面点击“关闭投影仪”时，后端调用API：

URL: https://api.thingboot.com/你的AppID/device/control/?sign=计算值&ts=当前时间戳
Body:
{ "device": 123456, "order": { "power": 0 } }

第二步：接收状态反馈

用户在OA页面看到的“设备状态”不能仅靠前端臆想，应依赖后端收到的消息推送。
当AC5-10A执行成功断电后，模块会发出状态变更消息。
你的服务器接收到消息后，更新数据库中的“电源状态”字段，并记录日志。

第三步：实现定时任务利用系统自带的“定时任务”功能，或自行写Cron Job调用API。

场景：每天晚上22:00，系统自动调用API查询宿舍楼各楼层的AC5-10A状态，若发现未关闭（Power=1），则自动下发关闭指令（Power=0），实现节能降耗。

六、技术参数与限制

在对接开发时，需要注意以下硬件特性以规避风险

响应速度：从命令下达到设备响应，在普通家用宽带环境下平均为 80-120ms。
负载限制
- 阻性负载（如白炽灯、电暖器）：最大 2200W。
- 感性负载（如电机、LED节能灯）：小于 300W。对接感性负载时，需要考虑浪涌电流，避免继电器粘连。
网络：仅支持 2.4GHz WiFi，不支持5G频段。