针对 AC5-10A 智能通断器的接入，核心在于利用其开放的 HTTP API 实现控制指令下发。该设备通过 WiFi 直连，无需网关，典型的控制响应时间为 80-120ms。以下方案涵盖硬件选型、接口接入和实战示例。
一、 解决概述：AC5-10A 的核心价值与能力
传统项目的自动化改造往往受限于布线和电网改造的高成本，而 芯步 AC5-10A 智能通断器 提供了一种“即插即用”的交流电源管理方案。
在开始接入前，请确认该硬件的核心参数是否满足你的业务场景：
型号：UNI-TDQ-AC5-10A
工作电压：100-250V AC（覆盖全球标准市电）
额定电流：MAX 10A / 额定功率：MAX 2200W（阻性负载）
无线连接：WiFi 2.4GHz 802.11 b/g/n（注意：不支持5G WiFi）
该模块最突出的3个核心优势：
无需网关，直连云端/局域网：设备上电后直接连接你的路由器和芯步平台，你也可以选择私有化部署方案将其限制在纯局域网内运行，拥有绝对的数据自主权。
双向反馈：除了接收指令，设备支持状态上报。你可以获取设备的实时通断状态，解决了传统定时器“不知道设备是否真的动作了”的痛点。
物理与逻辑双控：模块自带开关量输入接口，你可以外接物理轻触开关，实现即使服务器宕机或网络断开，依然能通过手动控制设备。
二、 接入设计
你可以通过以下两种模式将模块集成到自有项目中：
公有云模式
适用场景：快速验证、无需自建服务器、跨地域管理。
流程：设备 -> 芯步云 -> 你的后端服务器（通过API调用）。
局域网/私有化模式
适用场景：工业内网、数据保密要求高、无外网环境。
流程：设备 -> 你的本地路由器 -> 你的私有化服务器（自建MQTT/HTTP Broker）。
三、 核心接口接入详解
无论使用哪种编程语言（Python, Java, Go, PHP），接入方式均基于标准的 HTTP POST 请求。
1. 准备工作：获取凭证
在正式开发前，请登录芯步控制台，完成以下操作：
获取
AppID和AppSecret。添加设备，获取设备的唯一标识
Device ID（通常在设备标签或控制台可查）。
2. 接口鉴权机制
所有API请求均需携带签名 sign 和时间戳 ts。签名生成规则（仅供参考，请以官方最新文档为准）：sign = md5(AppID + AppSecret + ts)
3. 控制指令详解
请求地址https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}
请求方法：POSTContent-Type：application/json
核心命令集
| 命令对象 | Key 值 | 说明 | 示例（JSON格式） | 应用场景 |
|---|---|---|---|---|
| 线路控制 | power | 控制继电器的开闭 | {"power":"1"} （开启）{"power":"0"} （关闭） | 基础开关控制 |
| 点动模式 | point | 先接通，延时后自动断开 | {"point":"5000"} （毫秒） | 控制闸机、门锁或需要短暂通电的设备 |
| 复位模式 | reset | 先断开，延时后自动接通 | {"reset":"3000"} （毫秒） | 实现路由器、光猫的远程重启 |
数据示例（开启设备）
4. 状态同步：接收设备上报
为了确保系统内设备状态的准确性，你需要配置消息推送。
设置：在控制台配置你的服务器回调 URL（Webhook）。
当设备状态变化时（如：本地按键按下、遥控操作、电压异常断开），平台会主动推送 JSON 数据包到你指定的服务器地址。
：不要完全信赖下发指令后的“成功”反馈，应以设备主动上报的“状态变更”作为最终依据。
四、 实战接入示例 (以 Python 和 Shell 为例)
你可以根据不同项目的技术栈，参考以下代码片段进行集成。
Python 示例 (适用于后端高并发场景)
Shell 脚本 (Curl 示例，适用于嵌入式或脚本环境)
五、 物理接入：如何把它“塞”进你的项目
作为一名工程师，除了软件集成，硬件接线同样关键：
输入端 （L-IN / N-IN）：接来自空开或市电的 220V 火线和零线。
输出端 （L-OUT / N-OUT）：接负载（如电机、灯光、水泵）的电源线。
注意：此模块为单火线控制或双极断开？具体型号查阅说明书，通常零线直通，火线受控。
开关量输入
模块通常提供
SW1接口。将普通轻触开关的两根线连接至
SW1和GND（地线）。通过软件配置该按钮的触发逻辑（如：点按切换状态/长按复位）。
六、 常见问题排查
设备离线 (Offline)
检查 WiFi 是否为 2.4G（不支持 5G）。
检查设备供电是否稳定（AC100-250V）。
带不动负载/烧毁
如果负载是电机、水泵或LED灯（感性/容性负载），请严格降额使用。该模块推荐感性负载不超过 350W，切勿直接带大功率空调或工业电机。
延迟较高
云端默认链路延迟约为 100ms。如果你是局域网内的自动化产线，强烈切换至私有化部署模式，可将延迟降低至 10ms 以内。