AC4-30A是一款支持HTTP API的智能通断器，可远程控制6600W以下设备的电源通断。以下方案涵盖设备配网、API调用、签名生成及典型场景代码实现。

解决方案：基于芯步AC4-30A的自动化设备交流电源管理对接方案

1. 产品概述与核心能力

芯步AC4-30A智能控制模块是一款支持WiFi直连的大功率通断器。在对接到软件项目时，它具备以下核心特征：

• 大功率承载：支持AC 85-265V宽电压，额定电流30A，总额定功率高达6600W，适用于空调、大型电机、集中照明线路等工业或商业场景。

• 接口开放：不依赖特定厂商APP，通过开放的HTTP API即可实现控制，支持任何主流后端语言（Java, Python, PHP, Go等）。

• 多种控制模式：不仅支持简单的“开/关”，还支持“先通后断”或“先断后通”的脉冲模式（如自动门控制）。

• 部署灵活：既支持公网远程控制，也支持局域网和私有化部署，保证数据安全与低延迟。

2. 对接流程架构

整个对接流程分为四个步骤：环境准备 -> 设备配网 -> 接口鉴权 -> 业务集成。

flowchart TD
    A[软件开发者/集成商] -->|1. 注册与创建| B[芯步控制台]
    B -->|获取| C[AppID & AppKey]
    A -->|2. 设备上电配网| D[AC4-30A硬件]
    D -->|配置WiFi| E[企业/场所2.4G WiFi]
    E -->|获取| F[Device ID]
    C -->|3. 生成签名Sign| G[后端业务服务器]
    F --> G
    G -->|4. HTTP API调用| H[芯步云平台]
    H -->|下发指令| D
    H -->|异步回调| G

3. 详细对接步骤

3.1 环境准备与凭证获取

1. 注册账号：在芯步官网注册开发者账号，并创建“工作台”。

2. 获取凭证：登录控制台，在开发者选项中找到：

   • AppID：应用唯一标识。

   • AppKey：用于生成签名的密钥（请妥善保管于服务端）。

3. 安装模块：在工作台中安装“物联网控制台”模块，以便管理设备。

3.2 设备配网与ID获取

AC4-30A仅支持2.4G WiFi。

• 配网方式：可使用“芯步小程序”或控制台自带的“网络配置”功能进行配网。

• 操作核心：手机连接2.4G WiFi，通过热点模式将WiFi凭证发送给设备。

• 获取Device ID：配网成功后，设备会在控制台列表中显示。设备ID是后续API操作的核心参数。

3.3 API 鉴权与签名生成（核心难点）

为了安全，所有HTTP接口请求都需要携带签名。调用地址格式为：http(s)://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}

签名生成逻辑需使用 AppKey 和请求参数生成 MD5 哈希值。

1. 将请求参数（如 device, order 等）与 ts（时间戳）、AppKey 合并。

2. 按特定顺序排序并拼接成字符串。

3. 计算MD5值作为 sign。

注：ts 用于防止重放攻击，服务器会校验时间戳的有效性。

3.4 下发控制指令

AC4-30A支持三种主要指令，通过 order 参数传递 JSON 字符串

Java 代码示例 (使用 OkHttp)

注意：接口返回200只代表平台收到了指令，若需确认设备实际执行状态，需通过消息推送机制接收设备回传的状态。

4. 自动化与场景联动设计

将AC4-30A融入软件项目，核心在于与其他系统的联动：

1. 传感器联动结合芯步的环境传感器（如温湿度、人体雷达）。例如：

   • 服务器收到“温度 > 35℃”的传感器数据。

   • 自动调用 {"power":"1"} 指令，启动排风扇或空调。

   • 自动化策略在后端服务中实现，通过逻辑判断调用API。

2. 定时任务无需在代码中写死Cron Job，可直接利用AC4-30A硬件支持的远程定时任务功能。通过API设置设备本地定时器，即使断网也能执行。

3. 高级控制（4路控制器场景） ：如果现场需要控制多路设备，使用芯步的“智能控制器4路”系列。其指令格式支持批量控制，例如 {"batch":{"relay":[1,3],"power":"0"}} 可一次性关闭第1和第3路，效率更高。

5. 解决总结

通过上述方案，开发者可以快速将AC4-30A模块集成至现有的楼宇自动化、智慧农业或工业控制软件中，实现对交流电源的精细化、自动化管理。如需具体语言（如Python或C#）的签名生成代码示例，可进一步提供支持。