CATALOG

AC5-10A 智能通断器的核心优势在于:无需网关直连 Wi-Fi,通过开放的 HTTP 接口即可实现远程控制。这意味着你可以在任何支持 HTTP 请求的环境(Web 后端、App、小程序、脚本)中用几行代码完成设备集成。以下从硬件准备、接口对接、代码实现到部署方式逐一展开。

一、 产品核心特性与选型确认

在开始对接前,确认硬件参数符合项目需求,AC5-10A 模块的具体特性如下:

  • 控制能力:支持 AC 100-250V 市电电压,最大承载电流 10A(约 2200W 阻性负载),满足绝大多数照明回路和一般电器的控制需求

  • 网络连接:采用 WiFi 2.4G 直连,不需要购买网关,降低了硬件成本和部署复杂度。支持设置 5 组 Wi-Fi 备选,网络稳定性较好

  • 接口开放度:提供标准的 HTTP 协议接口,这意味着只要是能发网络请求的语言(Python, Java, Go, PHP, Node.js 等)都能接入,不受特定生态限制

  • 扩展输入:除了控制输出,设备自带 1 路开关量输入,可以外接物理轻触开关,实现“本地按键+远程控制”双控功能

二、 API 接口对接方案

芯步的接口设计遵循标准 RESTful 风格,核心是向指定的 URL 发送 POST 请求。

1. 接口地址与鉴权

  • URLhttps://api.thingboot.com/{AppID}/device/control/

  • 鉴权参数

    • AppID: 在芯步开发者控制台创建应用后获取。

    • sign: 签名,用于验证请求合法性,防止篡改。

    • ts: 时间戳(Unix 秒数),用于防止重放攻击

签名算法(根据官方文档):sign = md5( md5(开发者密码) + “.” + ts )注意:请替换其中的“开发者密码”和“ts”为你自己的数据。

2. 核心命令(Order)说明

该模块支持三种主要控制模式,你可以根据业务场景灵活调用:

  • 基础开关控制

    • 命令字段:power

    • 参数说明:1 代表开启,0 代表关闭。

    • 场景:日常远程开关灯。

  • 先通后断(点动/脉冲)

    • 命令字段:point

    • 参数说明:单位毫秒(如 3000 代表 3 秒)。

    • 逻辑:立即接通,保持 X 毫秒后自动断开。

    • 场景:控制门禁电锁、电动窗帘或即热式电器。

  • 先断后通(重启/复位)

    • 命令字段:reset

    • 参数说明:单位毫秒。

    • 逻辑:立即断开,保持 X 毫秒后自动恢复接通。

    • 场景:远程重启路由器、摄像机等设备

三、 实战接入代码示例

以下演示如何在不同的软件架构中集成该模块。

1. Python 接入示例(适用于后端服务)

2. Shell 脚本(适用于 IoT 边缘网关或自动化任务)

如果你的项目运行在 Linux 服务器上,需要通过定时任务(Cron Job)控制设备,Shell 脚本是最轻量的方式

3. 微信小程序 / 前端 JavaScript

在前端项目中控制需注意跨域问题以及签名的安全性(签名由后端生成,前端调用)。

四、 高级应用与架构

1. 状态同步与反馈机制

HTTP 接口是单向下发指令。对于需要实时获取设备当前开关状态(例如 App 上显示灯是否亮着)的项目,单纯的 HTTP 轮询效率较低。采用私有化部署方案,配置消息服务器,让设备在状态变化时主动上报数据到你的服务器

2. 本地局域网控制(无互联网容灾)

对于商用或高端住宅项目,对稳定性要求比较高。AC5-10A 模块支持局域网控制。如果路由器和网络架构允许,你可以通过首先获取设备内网 IP,直接在内网调用 API,即使外网断开,依然可以控制灯光

3. 物理开关的联动逻辑

该模块提供了“输入接口”。在你的项目中,如果希望外接的物理按键即使在网络断开时也能工作,这是硬件本身就支持的。而在软件层面,你可以监听物理按键触发的状态变化上报,用于在软件界面上更新 UI,或触发其他的联动逻辑

五、 实施总结

将 AC5-10A 模块接入项目,核心工作量为 1-2 小时的开发测试:

  1. 通电配网:设备通电后,通过 SmartConfig 或 AP 热点模式配置 WiFi。

  2. 接口调试:获取 AppID 和 Device ID,按上述 Python 或 Shell 代码跑通第一个“开/关”指令。

  3. 业务集成:将指令封装成你的业务按钮。该方案兼容性极强,不论是开发一个简单的智能插座面板,还是集成到复杂的楼宇自控系统中,都能快速落地