怎样接入AC1智能通断器来实现单路交流负载控制_解决方案

CATALOG

AC1智能通断器是芯步推出的基础负载控制单元，支持1-10A交流负载，核心优势在于无需网关、WiFi直连，并提供开放HTTP接口。这意味着你可以用任何支持HTTP请求的编程语言或开发平台（Web、APP、小程序、SaaS等）直接对它进行控制。

下面是一套完整的接入和二次开发方案。

在编写代码前，首先需要完成设备的物理安装与网络配置。

1. 硬件接线

2. 配网绑定

由于AC1采用WiFi直连方案，无需网关，需通过芯步官方提供的配网流程（通常是APP或一键配网）将设备加入本地2.4G WiFi网络。
关键步骤：配网成功后，记录下官方平台为设备分配的唯一标识符（设备ID）。同时，在平台账户后台获取API访问密钥access_token或签名密钥，这是后续API调用的凭证。

AC1的开放接口极具友好性，本质上就是标准的HTTP请求。无论使用哪种编程语言，核心都是向特定URL发送POST或GET请求。

1. 接口通用地址根据部署环境，请求地址分为两种模式：

2. 签名机制与请求头为了安全，芯步的接口通常采用签名验证。请求头（Header）中需包含鉴权信息：

参数名	类型	必填	说明
`X-Device-ID`	String	是	目标AC1设备的唯一ID
`X-Signature`	String	是	根据时间戳+设备ID+密钥生成的MD5或HMAC-SHA1签名
`X-Timestamp`	Long	是	毫秒级时间戳，用于防重放攻击
`Content-Type`	String	是	`application/json;charset=utf-8`

签名生成伪代码示例

完成鉴权后，即可向AC1下发指令。AC1作为通断器，核心指令仅两种：开、关。

1. 请求参数

Endpoint/ordercontrol/{device_id}

MethodPOST

Body (JSON)

2. 实战代码示例

场景：利用Python控制办公室照明灯（AC1负载）

智能控制不仅仅是“发指令”，还需要“知状态”。AC1支持两种状态获取方式。

1. 主动查询（同步）调用查询接口获取设备当前的通断状态。

2. 被动接收（异步/WebSocket）如果需要实时监控设备被手动按压（如果AC1有物理按键）开关的状态变化，或者需要获取实时能耗数据，使用消息队列或WebSocket。

AC1专为“嵌入式集成”设计，非常容易融入现有系统：

集成场景	实施方案
SaaS后台	在后台管理界面增加一个按钮，调用上述`control_ac1`接口，实现远程运维或定时任务。
手机APP/小程序	通过后端服务代理调用（避免在前端暴露API密钥），用户点击APP按钮 -> 触发后端 -> 芯步云 -> AC1。
低代码平台	利用低代码平台的“HTTP请求控件”，填入URL和Header参数即可生成控制页面，省去后端代码编写。
智能联动	编写脚本监听传感器（如温湿度计），当温度超过阈值时，自动调用`control_ac1("off")`切断加热设备。

签名错误：严格检查时间戳单位（毫秒）以及拼接顺序，芯步对时间误差通常要求在5分钟以内，请确保设备时间同步。
无响应：如果AC1执行指令后无反馈，首先检查设备是否在线。AC1依赖于2.4G WiFi，距离路由器过远或信号干扰可能导致丢包。配置多组WiFi网络名称，设备会自动切换至信号最强的连接。
局域网模式：若需纯内网环境运行，请参考私有化部署文档，将请求Base URL更换为自建服务器地址，此时签名验证逻辑可能简化为IP白名单。

通过以上步骤，即可完成从硬件接线到代码集成的全过程，将AC1智能通断器无缝集成至任何业务系统中。