怎么接入AC1-10A智能控制器来实现场景联动控制_解决方案

CATALOG

芯步AC1-10A智能通断器的核心优势在于开放的HTTP接口，这使得场景联动不需要依赖封闭的App或专用网关——你可以用自己的业务系统直接控制它。下面从技术架构、接入步骤到典型场景，完整说明如何实现联动控制。

解决方案：基于芯步开放接口的 AC1-10A 智能控制器场景联动接入

一、核心能力概述

本方案基于芯步 AC1-10A 智能通断器（智能控制器）及同生态的传感器系列产品。AC1-10A 是一款支持 WiFi 2.4G 直连的继电器控制设备，具备 1 路 10A 输出，额定功率 2200W，适合控制灯光、插座、小型电器等。

其核心开放能力包括：

标准 HTTP API：支持任何具备 HTTP 请求能力的后端语言（Java, Python, PHP, Node.js 等）或前端（需代理）调用。
状态实时推送：设备状态变化（如本地按键操作、通断变化）会主动推送至开发者指定的服务器 URL 。
私有化部署：支持在纯局域网环境运行，保障数据安全与响应速度。

二、接入架构图

为了实现“场景联动”，通常需要将 传感器（输入） -> 业务服务器（逻辑处理） -> AC1-10A（输出） 串联起来。

sequenceDiagram
    participant Sensor as 传感器设备
(如人体雷达/门磁)
    participant DeviceSDK as 芯步云/局域网
    participant UserServer as 用户业务服务器
(联动逻辑核心)
    participant AC as AC1-10A控制器
(灯光/插座/电器)

    Sensor->>DeviceSDK: 1. 上报传感数据
(如: 检测到有人)
    DeviceSDK->>UserServer: 2. HTTP推送
(设备ID:820720, 状态:有人)
    UserServer->>UserServer: 3. 执行联动规则
(判断: 若有人, 则开灯)
    UserServer->>DeviceSDK: 4. 下发控制指令
(API: /device/control/)
    DeviceSDK->>AC: 5. 执行动作
(闭合继电器, 接通电源)
    AC-->>UserServer: 6. (可选) 状态反馈

三、接入实施步骤

1. 环境准备与凭证获取

首先需要在芯步平台完成账号注册与设备配置：

注册开发者账号：前往芯步官网注册账号。
创建工作台：在用户中心创建“工作台”，进入“物联网控制台”模块。
获取密钥：在控制台的开发设置中获取 AppID 和 AppSecret。这两项是后续接口调用的身份凭证。
添加设备：使用提供的“批量配网小程序”或 App 为 AC1-10A 配置 WiFi 网络。
- 注意：设备仅支持 2.4G WiFi，可配置 5 组 WiFi 以实现信号冗余。
- 记录下设备的唯一标识 Device ID。

2. 核心接口调试：直接控制

要实现联动，需先掌握如何用 HTTP 协议控制 AC1-10A。

接口概览

URLhttp(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}
Method：POST
Content-Type：application/json

签名算法为了安全，所有接口需携带签名。算法逻辑为：sign = md5( md5(AppSecret) + ts )。（注：ts 为 Unix 时间戳，单位为秒）

请求示例 (控制设备开启)假设 AppId 为 12345，Device ID 为 67890。

通过上述调用，可立即改变 AC1-10A 的通断状态，响应时间约 80-120ms。

3. 配置“被动接收”机制：接收传感器数据

场景联动的核心在于“触发”。AC1-10A 自身可被控制，但要实现自动化（如人来灯亮），需要接收传感器的信号。

配置消息推送在控制台中配置 “消息推送 URL”。

作用：当人体传感器、温湿度传感器或门磁等设备状态改变时，芯步平台会主动拼接 JSON 数据，并 POST 请求到你配置的服务器地址。
数据格式示例 (人体雷达)
{ "device": "820720", // 传感器ID "msg_type": "report", "data": { "radar": 1, // 1代表检测到有人，0代表无人 "illuminance": 320 // 光照强度等 } }

4. 实现联动逻辑

场景案例：当“人体传感器”检测到有人，且当前照度较低，则自动开启 AC1-10A 控制的灯光。

开发步骤

接收请求：编写后端 API（如 /webhook/device/report）接收平台推送的传感器数据。
条件判断：解析 JSON 中的 data.radar 状态。若 radar == 1，触发联动。
下发指令：在同一个请求周期内，调用上文“步骤 2”中的控制接口，向 AC1-10A 发送 {"power": 1} 指令。

伪代码示例：

四、高级场景与命令进阶

AC1-10A 不仅支持简单的开/关，还支持动作序列，这为设计复杂联动提供了可能。

命令类型	JSON 指令格式	应用场景案例
点动控制	`{"point": {"interval": 500}}`	场景：短按遥控器/门禁按钮。联动：配合门磁，实现“刷卡开门后，继电器接通 500ms 后自动断开”，模拟按门禁键的动作。
先通后断	`{"point": {"relay":[1], "interval": 1000}}`	场景：控制卷帘门/车库门。联动：给电机一个启动脉冲，1秒后自动切断，避免电机长时间空转。
互斥/复位	`{"reset": {"relay":[1], "interval": 500}}`	场景：逻辑复位。联动：用于某些需要先断电重启的设备，如路由器或投影仪幕布。
批量控制	`{"batch": {"relay":[1,2,3], "power": 0}}`	场景：“一键离家”模式。联动：当用户按下智能门锁的“布防”键时，服务器发送此指令，一次性关闭所有楼层的灯光。

五、网络架构选型 (公有云 vs 局域网)

根据项目需求，有两种部署模式可选：

公有云模式 (标准)
- 链路：设备 -> 芯步云 -> 你的业务服务器。
- 优势：无需公网 IP，运维简单，跨网络访问方便。
- 适用：连锁店铺管理、智能家居远程控制。
局域网私有化模式 (推荐高敏场景)
- 链路：设备 <-> 同网段路由器 <-> 你的本地服务器。
- 配置：开启 AC1-10A 的局域网模式（LAPI），设备会维护一份局域网 IP 列表。
- 优势零延迟、断网仍可用、数据不出厂，绝对安全。
- 适用：工厂生产线、实验室、医疗设备联动。

六、总结

通过接入芯步 AC1-10A 的开放接口，可以快速实现任意设备之间的场景联动，用户仅需关注业务逻辑层——即“当收到 X 信号时，执行 Y 动作”。这种基于 HTTP 的松耦合架构，不仅降低了开发门槛，也使得系统可以灵活运行在 Windows、Linux、ARM 等任意平台上。