怎么二次开发4路交流输出控制器来实现自定义联动操作_解决方案

CATALOG

芯步的4路交流输出控制器开放了标准的HTTP接口，支持单路控制、批量操作、时序联动等多种指令模式。以下方案从接口能力、签名计算到代码实现，梳理了完整的二次开发路径，帮助你快速构建自定义联动逻辑。

解决方案：基于芯步4路交流输出控制器的自定义联动开发

一、背景与目标

4路交流输出控制器 是一款支持WiFi联网的工业级智能控制设备，具备4路独立继电器，每路支持最高10A/2200W（阻性）负载。在标准场景中，它可用于远程控制灯、风扇、插座等。

但在复杂的商业或工业场景（如共享自习室、智能大棚、自动化产线）中，往往需要设备根据传感器数据（如温度、人体感应）或复杂的时间逻辑自动执行动作。

本方案的目标：利用芯步开放的HTTP API，通过二次开发实现“传感器触发 + 逻辑判断 + 多路联动控制”的自定义闭环。

二、核心技术原理

设备的二次开发基于 “云云对接” 或 “客户端到设备” 的直接通信模式。

通信协议：标准 HTTP/HTTPS。
数据格式：JSON 字符串。
交互流程：开发者服务器/App → 芯步开放API → 4路控制器 → 执行通断。

三、开放接口关键能力解析

在进行开发前，首先要了解接口支持的指令粒度。根据官方接口文档，order 参数支持以下几种强大模式，这是实现“自定义联动”的基础

指令模式	JSON结构示例	适用场景
单路独立控制	`{"power1":"1"}` (开启第一路)	基础开关，独立控制单个设备。
批量同步控制	`{"batch":{"relay":[1,2,3],"power":0}}`	一键全关或定时关闭所有区域。
先通后断 (点动)	`{"point":{"relay":[1],"interval":1000}}`	门禁控制（通电开门1秒后自动断电）、设备复位。
先断后通 (重启)	`{"reset":{"relay":[1,2],"interval":5000}}`	网络设备重启（断电5秒后自动恢复供电）。

四、自定义联动逻辑实施方案

为了不让设备“孤立”运行，我们需要编写一个中间件服务（或云函数） 来连接传感器信号与控制器指令。

1. 系统设计

感知层：温湿度传感器、人体雷达传感器（同样上报数据到API）。
逻辑层：开发者服务器（Node.js/Python/PHP）。
执行层：芯步4路控制器。

2. 步骤一：环境准备

获取凭证：登录芯步控制台，获取 AppID 和 AppSecret。
设备配网：将4路控制器连接至WiFi，获取唯一的 DeviceID。
签名计算：每次API请求需计算 sign。公式通常为：md5(AppID + AppSecret + ts)。

3. 步骤二：编写联动逻辑（核心代码示例）

假设一个智能自习室的场景：

联动逻辑：用户扫码付款后，自动开启座位对应的“第1路（照明）+ 第2路（插座）”，并设置15分钟后自动关闭。
紧急逻辑：烟雾报警器触发时，立即执行“批量关断”所有4路输出。

Python 实现示例（自定义联动服务）：

import requests
import time
import hashlib
import json

class TBController:
    def __init__(self, app_id, app_secret):
        self.app_id = app_id
        self.app_secret = app_secret
        self.base_url = "http://api.thingboot.com"
    
    def _generate_sign(self, ts):
        # 签名生成逻辑参考官方文档
        return hashlib.md5(f"{self.app_id}{self.app_secret}{ts}".encode()).hexdigest()
    
    def control_device(self, device_id, order_json):
        ts = int(time.time())
        sign = self._generate_sign(ts)
        url = f"{self.base_url}/{self.app_id}/device/control/?sign={sign}&ts={ts}"
        
        payload = {
            "device": device_id,
            "order": order_json
        }
        # 发起POST请求
        response = requests.post(url, data=payload)
        return response.json()

# 实例化控制器
api = TBController("YourAppID", "YourAppSecret")
device_id = "1234567890"

# 1. 自定义联动:执行"先开照明，后开插座"的时序启动 （间隔2秒）
print("正在执行启动流程...")
# 开启第一路（照明）
api.control_device(device_id, {"power1":"1"})
time.sleep(2)
# 开启第二路（插座）
api.control_device(device_id, {"power2":"1"})

# 2. 自定义联动:点动模式 - 如:按一下物理开关，触发洒水5秒自动停
print("执行点动模式...")
api.control_device(device_id, {"point":{"relay":[4],"interval":5000}})

# 3. 自定义联动:紧急关断 (如温湿度超标或烟雾报警)
# 直接批量关闭所有输出
print("紧急关断所有线路...")
api.control_device(device_id, {"batch":{"relay":[1,2,3,4],"power":0}})

4. 步骤三：高级联动场景配置

利用 设备上报状态 的反向触发机制，可以让4路控制器更加智能。

场景 A：恒温恒湿联动 (大棚/机房)

需求：温度 > 35°C 时，自动开启第3路（风扇）。
开发逻辑
1. 服务器接收温湿度传感器的上报数据（temperature=36）。
2. 服务器判断 36 > 35。
3. 服务器调用API：{"power3":"1"} 开启风扇。
4. 当温度回落，调用 {"power3":"0"} 关闭风扇。

场景 B：人体感应灯光联动 (展厅/走廊)

需求：检测到人经过，触发第1路（灯光）亮起；人离开1分钟后熄灭。
开发逻辑
1. 服务器收到雷达传感器上报的“无人”信号。
2. 服务器设置延时任务（delay 60s）。
3. 60秒后调用API下发 {"point":{"relay":[1],"interval":0}} (即执行关闭)。

五、开发注意事项

关于签名：生产环境下必须开启签名校验（关闭调试模式），并严格核对 ts 时间戳（误差一般不得超过5分钟），防止接口被恶意攻击。
负载安全：4路交流控制器虽支持10A电流，但全接通时总负载不超过4400W（阻性）。在开发联动逻辑时，增加“互锁逻辑”（例如开启第2路时自动关闭第1路），避免过载。
状态同步：由于HTTP是无状态的，在调用控制接口成功后，本地数据库缓存一下设备状态，避免因网络丢包导致的界面状态与实际不符。也可以通过芯步提供的 消息推送 服务，接收设备状态的实时回调。
局域网直连（私有化） ：如果你的系统对响应速度要求比较高（如工业自动化），芯步设备支持私有化部署，无需经过公网云平台，开发时可直接将API请求指向设备内网IP，响应可缩短至毫秒级。

六、总结

通过芯步提供的开放接口，开发者主要做三件事：解析输入（各类传感器信号）、执行逻辑计算（定时/条件判断）、打包输出（JSON命令）。利用 batch 批处理指令可以简化代码，利用 point 点动指令可以模拟物理按键动作。这套方案不需要修改设备固件，完全通过服务器端的代码即可实现高度自定义的工业级联动。