怎么对接智能控制器4路|直流电压版来实现联动场景逻辑控制_解决方案

CATALOG

芯步的4路直流控制器采用标准HTTP接口，单次请求即可完成单路/批量通断、时序脉冲等操作。以下方案涵盖签名计算、7种控制命令和5个典型联动场景的代码示例。

解决方案：基于芯步智能直流控制器4路的联动场景逻辑对接

1. 产品核心特性与接口概览

芯步的 “智能控制器4路|直流电压版”（型号：UNI-KZQ-DC-4） 是一款支持4路独立控制的远程继电器模组。它采用 WiFi 2.4G 直接入网，无需网关，极大地降低了集成门槛。

在开发对接中，其核心优势在于开放的HTTP接口。开发者无需关心底层硬件协议，只需通过HTTP请求向云端发送指令，即可实现对电磁锁、电插锁、电机等直流设备的控制。同时，该设备支持私有化部署和自建消息服务器，满足局域网环境下的高安全需求。

2. 接口对接前的准备工作

在开始编码前，请完成以下配置，确保网络通路顺畅：

获取凭证：登录芯步控制台，在“开发设置”中获取 AppID 和 AppSecret（开发者密码）。
设备配网：为控制器接通电源（AC 85-265V宽电压），通过设备热点或智能配网方式，将设备连入2.4G WiFi网络。
获取设备ID：在控制台的设备列表中，获取目标设备的唯一标识 Device ID。
开启调试模式（可选）：在开发测试阶段，开启控制台的“调试模式”，此时系统不校验签名和时间戳，便于快速验证逻辑。生产环境必须关闭该模式并启用签名校验。

3. 核心联动控制逻辑实现

联动场景的核心在于通过代码生成认证签名，并向指定URL发送POST命令。

接口地址https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}

签名算法（必填）为了安全，生产环境需计算 sign。算法规则如下

将 AppSecret 进行 MD5 加密，得到 str1。
将 str1 拼接上当前时间戳（秒）ts，得到 str2。
将 str2 再次进行 MD5 加密，得到最终的 sign。

数据包结构请求Body为JSON格式，包含 device（设备ID）和 order（命令对象）。

4. 控制命令详解与场景方案

针对“联动场景逻辑控制”，该控制器不仅支持简单的开关，还支持复杂的时序和互锁逻辑。以下是几种在实际场景中的应用方案：

场景方案	逻辑描述	Order参数示例（JSON字符串）	适用场景
独立单控	标准的开启/关闭第2路	`{"power2":"1"}`	远程开门、灯光开关
批量控制	同时关闭第1路和第3路	`{"batch":{"relay":[1,3],"power":"0"}}`	一键全关、下班断电
电机正反转	先通后断实现电机正转	`{"point":{"relay":[1],"interval":3000}}`	卷闸门下降、道闸落杆
电机反转	先断后通实现电机反转	`{"reset":{"relay":[2],"interval":3000}}`	卷闸门上升、道闸抬杆
脉冲触发	瞬间通电1秒后自动断电	`{"point":{"relay":[4],"interval":1000}}`	点按式门禁、自动售货机出货
互锁控制	通过逻辑代码实现	前端代码判断：关2前先关1	A/B路切换，如窗帘开关
定时/延时	平台云端定时任务	控制台设置（无需写代码）	定时灌溉、定时路灯

重要说明
在控制水塔或车库门电机时，需要通过 point 或 reset 指令模拟按钮按下后松开的动作。interval 单位为毫秒（ms）。
直流版通常用于控制 12V/24V 的电磁锁或小电机；若控制220V交流电，请选用“交流电压版”。

5. 实战联动代码示例（Python 与 JavaScript）

以下代码展示了如何在业务系统中实现上述联动逻辑。

Python 实现（适合后端或云函数）

import requests
import hashlib
import time
import json

# 配置信息
APP_ID = "Your_App_ID"
APP_SECRET = "Your_App_Secret"
DEVICE_ID = "Your_Device_ID"

def control_device(order_cmd):
    # 1. 生成签名
    ts = str(int(time.time()))
    md5_app_secret = hashlib.md5(APP_SECRET.encode()).hexdigest()
    sign_str = md5_app_secret + ts
    sign = hashlib.md5(sign_str.encode()).hexdigest()
    
    # 2. 构建URL和Headers
    url = f"https://api.thingboot.com/{APP_ID}/device/control/?sign={sign}&ts={ts}"
    headers = {'Content-Type': 'application/json'}
    
    # 3. 构建负载
    payload = {
        "device": DEVICE_ID,
        "order": order_cmd
    }
    
    # 4. 发送请求
    response = requests.post(url, headers=headers, data=json.dumps(payload))
    return response.json()

# 场景1:门禁系统 - 按下开门按钮，第1路通电触发门锁，持续3秒后自动关闭（模拟开锁）
def unlock_door():
    print("门锁已打开，请进入...")
    # 发送 point 命令，relay 1 号口，持续 3000ms
    return control_device({"point": {"relay": [1], "interval": 3000}})

# 场景2:卷帘门/窗帘控制 - 电机正转（释放）
def curtain_down():
    print("窗帘正在下降...")
    # 第2路闭合（正转）持续5秒后断开
    return control_device({"point": {"relay": [2], "interval": 5000}})

# 场景3:自动售货机 - 批量出货（先推第1个货道，延迟0.5秒再推第2个货道）
def vending_dispense():
    print("开始出货...")
    control_device({"point": {"relay": [1], "interval": 500}})  # 货道1推出
    time.sleep(0.6)  # 业务逻辑中的延迟
    return control_device({"point": {"relay": [2], "interval": 500}})  # 货道2推出

if __name__ == "__main__":
    # 测试开锁
    unlock_door()

微信小程序 / JavaScript 实现（适合前端直接调用）在前端调用时，由于涉及AppSecret密钥安全问题，强烈将上述签名过程封装在你的后端服务中，前端仅调用你自己的接口。以下签名算法仅用于展示原理：

6. 高级联动：逻辑自控与状态反馈

在真正的智能联动中，仅下发命令是不够的，还需要根据设备状态进行逻辑判断。

获取设备状态联动逻辑往往需要“感知”当前状态。例如：“如果门锁是关的，且检测到人脸识别成功，再开锁”。你可以调用芯步的 设备状态查询接口，获取当前各路继电器是开启还是关闭状态，以此作为后续联动逻辑的“if”判断条件。
输入输出联动该控制器背面提供了开关量信号输入接口。你可以将物理按钮接入输入端，然后在平台配置“联动规则”：当输入1检测到高/低电平信号时，触发输出1的动作。哪怕网络断开，这种物理联动依然生效，适合本地急停或手动控制需求。

7. 总结

通过芯步的开放接口对接 4路直流控制器，开发者可以将复杂的硬件控制逻辑简化为标准的HTTP请求。无论是构建共享经济设备（如共享洗衣机、快递柜）、智能家居（如电动窗帘）还是工业自动化（如水泵控制），都可以通过本文提到的 point（点动）、batch（批量） 以及 签名认证机制 快速落地。