芯步的8路智能分体远程交直流输出控制箱（UNI-KZQ-TY-8）提供开放的HTTP API接口，支持通过简单的HTTP请求对每路输出进行独立控制。本文基于其接口特性，提供一套完整的自定义场景联动方案——核心思路是用业务系统作为“大脑”，接收传感器数据或业务事件，通过条件判断后向控制箱下发指令，实现灵活的场景自动化。

1. 解决概述

本方案采用公有云/私有云业务系统作为联动中控，利用芯步开放的HTTP接口实现设备控制。系统架构如下：

• 设备层：8路智能分体远程交直流输出控制箱（被控设备）+ 各类传感器（如温湿度、人体雷达、烟感等，触发源）。

• 网络层：设备通过WiFi 2.4G连接网络，支持公网或纯局域网通信。

• 平台层：芯步开放API或用户自建的私有化服务器。

• 应用层：用户的Web/APP/小程序后端，负责执行“如果……就……”的逻辑判断。

2. 核心技术原理

该控制箱的接口机制非常简单，完全基于HTTP协议，无需复杂的MQTT配置。

• 接口地址： http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

• 请求方法： POST

• 签名机制： sign = md5(md5(开发者密码) + "." + 时间戳{ts})，这是一种轻量级的鉴权方式，适合高并发场景。

• 控制指令： 通过JSON格式发送order参数。对于8路控制器，参数为power1至power8，值1代表开启，0代表关闭。

  • 示例：开启第1、3路，关闭第2路：{"device": 设备ID, "order": {"power1": 1, "power2": 0, "power3": 1}}。

执行效率：从云端下发指令到设备执行动作，典型响应时间为80-120毫秒。

3. 自定义场景联动实现步骤

为了实现自定义联动，需要利用您的业务系统服务器作为“桥梁”。以下是标准的数据流向和代码实现逻辑。

3.1 步骤一：设备接入与网络配置

1. 接线与供电：给8路控制箱接上DC 12V电源。根据负载类型（阻性/感性）连接被控设备（灯光、电机、电磁锁等）。

2. 联网配置：通过芯步提供的配置工具或串口指令，将设备的WiFi模块连接到现场2.4GHz网络。确保控制箱与您的服务器网络可达（若为局域网部署，需保证在同一网段）。

3.2 步骤二：触发源对接

联动的前提是“触发条件”。触发条件通常来自两类数据源：

1. 传感器设备：如温湿度传感器、人体雷达传感器等。这些设备会主动向您的服务器推送状态数据（例如：有人移动或温度>30度）。

2. 业务软件事件：如ERP系统发出的“生产开始”信号，或APP用户点击的“一键观影”按钮。

服务器端接收数据示例（以Node.js为例）

3.3 步骤三：核心联动逻辑实现（中控代码）

业务系统收到触发信号后，需要向8路控制箱下发指令。以下是封装好的API调用核心函数，展示了签名生成和指令发送方法

1. 生成签名

2. 发送控制指令

3.4 步骤四：典型自定义场景配置案例

场景 A：环境恒温联动（温度触发型）

• 需求：当仓库温度超过35℃时，自动启动8路控制箱上的第1路（大功率排风扇）。

• 配置逻辑

  1. 监听：服务器监听温湿度传感器上报数据。

  2. 判断if sensor.temp > 35。

  3. 动作：调用control_8ch_relay(..., {"power1": 1})。

  4. 恢复：当温度低于28℃时，调用control_8ch_relay(..., {"power1": 0})。

场景 B：安防报警联动（传感器触发型）

• 需求：当有人体雷达传感器检测到非法入侵时，立即接通控制箱的第2路（警号）和第3路（灯光闪烁），并切断第4路（电源总闸）。

• 配置逻辑

  1. 监听：服务器接收雷达传感器报警消息{"movement": true}。

  2. 并发动作

     • 调用接口：{"power2": 1, "power3": 1}（开警号、开灯）。

     • 调用接口：{"power4": 0}（切断电源）。

场景 C：定时喂食/灌溉（时间触发型）

• 需求：每天早8:00和晚17:00，接通第5路（投食器）10秒后关闭。

• 配置逻辑

  1. 在服务器设置Cron定时任务。

  2. 8:00执行：调用{"power5": 1}$\rightarrow$ 延时10秒 $\rightarrow$ 调用{"power5": 0}。

  3. 17:00执行：重复上述逻辑。

4. 高级应用：私有化与纯局域网部署

对于数据安全要求比较高的工业场景，芯步支持私有化部署。

• 原理：所有设备通过WiFi直连，数据不经过芯步的公有云，而是直接发送到您指定的服务器IP。

• 实施

  1. 在配置设备网络时，将API域名指向您自己的服务器地址（例如：http://192.168.1.100:8080）。

  2. Server端代码无需修改，只需保证签名校验逻辑一致，即可实现纯内网闭环控制，延迟更低且不依赖外网。

5. 总结

对接芯步8路智能控制箱实现自定义联动的核心在于“业务系统做中控”。通过解析标准的HTTP API（签名机制：md5(md5(密码).时间戳)），开发者可以轻松地将此硬件集成到任何现有的软件系统中，无论是公有云架构还是纯局域网环境，只需简单的POST请求即可实现毫秒级的8路独立控制。