怎样对接2路智能直流控制模块来实现负载状态反馈控制_解决方案

CATALOG

芯步的2路智能直流控制模块提供了完整的HTTP API接口，支持远程通断控制、状态查询以及实时消息推送。以下方案涵盖签名生成、指令下发、状态反馈接收三个核心环节，可直接用于系统集成开发。

1. 概述

1.1 产品简介

芯步2路智能直流控制模块是一款支持远程控制的继电器输出设备，具备以下特性

2路独立控制：支持独立控制两路直流负载的通断
多种控制模式：支持瞬间（点动）、自锁、互锁等模式
状态反馈：实时上报继电器状态及负载工作状态
HTTP API支持：开放完整的HTTP接口，支持第三方系统集成

1.2 适用场景

工业自动化设备控制
智能照明系统
电机/泵阀控制
农业灌溉系统
机房电源管理

1.3 技术架构

┌─────────────┐    HTTP API     ┌─────────────┐    MQTT/HTTP   ┌─────────────┐
│             │ ───────────────>│             │ ─────────────> │             │
│  业务系统   │    下发指令      │  芯步云平台  │    设备通信    │  2路控制模块 │
│             │ <───────────────│             │ <───────────── │             │
└─────────────┘    状态回调      └─────────────┘    状态上报     └─────────────┘
                                                                       │
                                                                       ▼
                                                                ┌─────────────┐
                                                                │  直流负载   │
                                                                │ (电机/灯)   │
                                                                └─────────────┘

2. 对接准备工作

2.1 平台账号注册

访问芯步官网（）注册企业/开发者账号。

2.2 创建工作台与应用

登录后进入控制台，创建新的工作台
在工作台中创建应用，系统自动生成：
- AppID：应用唯一标识
- AppSecret：接口签名密钥

2.3 设备添加与激活

在控制台通过设备ID添加2路直流控制模块
确保设备Wi-Fi配网成功，设备状态显示为在线

2.4 接口地址

生产环境https://api.thingboot.com
请求路径格式：/{AppID}/device/control/?sign={sign}&ts={ts}

3. API接口对接详解

3.1 签名机制（重要安全说明）

所有API请求都需要携带签名（sign）和时间戳（ts）参数，签名算法如下

sign = md5( md5(AppSecret) + ts )

参数说明

参数	类型	说明
AppID	string	平台分配的应用ID
AppSecret	string	平台分配的密钥，严禁泄露
ts	int	当前Unix时间戳（秒）
sign	string	签名结果（32位小写MD5）

3.2 单路控制接口

请求方式：POSTContent-Type：application/json

请求示例

命令参数说明

指令	说明	示例
`{"power1":1}`	打开第1路	继电器吸合
`{"power1":0}`	关闭第1路	继电器断开
`{"power2":1}`	打开第2路	继电器吸合
`{"power2":0}`	关闭第2路	继电器断开

响应示例

3.3 批量控制接口

请求示例：同时控制两路

3.4 点动/脉冲控制模式

适用于控制电机、阀门等需要脉冲信号的设备，支持“先通后断”模式，让继电器在指定时间后自动复位。

点动模式（先通后断，自动恢复）：

参数说明：2000表示打开第1路后，2000毫秒（2秒）后自动关闭。

延时复位控制（先断后通）：

参数说明：关闭第1路后，3000毫秒（3秒）后自动恢复闭合。

批量点动控制

参数说明：控制继电器1和2，先闭合1000ms（1秒）后断开。

4. 负载状态反馈机制

4.1 实时状态上报配置

为实现负载状态反馈，需要配置消息推送功能：

推送地址配置（在芯步控制台设置）：

进入应用设置 → 消息推送
配置回调URL：https://your-domain.com/api/device/callback

4.2 状态上报数据格式

当设备状态变化时（继电器动作或负载状态改变），平台主动推送状态数据

4.3 业务系统回调处理示例（Python Flask）

4.4 主动查询设备状态

除了被动接收回调，业务系统也可主动查询设备状态：

5. 完整对接案例

5.1 场景：智慧水泵控制系统

需求：水池水位低于下限时自动启动水泵（第1路），水位达到上限时关闭水泵，并实时上报运行状态和故障反馈。

5.2 Python 完整实现代码

import requests
import hashlib
import time
import json

class YouyouIoTController:
    def __init__(self, app_id, app_secret, device_id):
        self.app_id = app_id
        self.app_secret = app_secret
        self.device_id = device_id
        self.base_url = "https://api.thingboot.com"
    
    def _generate_sign(self, ts):
        """生成API签名"""
        inner_md5 = hashlib.md5(self.app_secret.encode()).hexdigest()
        sign_str = inner_md5 + str(ts)
        sign = hashlib.md5(sign_str.encode()).hexdigest()
        return sign
    
    def _send_command(self, order):
        """发送控制命令"""
        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": self.device_id,
            "order": order
        }
        
        response = requests.post(url, json=payload, timeout=10)
        return response.json()
    
    def control_power1(self, state):
        """控制第1路（水泵）"""
        command = {"power1": 1 if state else 0}
        result = self._send_command(command)
        return result.get('code') == 0
    
    def control_power2(self, state):
        """控制第2路（备用）"""
        command = {"power2": 1 if state else 0}
        result = self._send_command(command)
        return result.get('code') == 0
    
    def pulse_control(self, relay, duration_ms):
        """脉冲控制"""
        command = {f"point{relay}": duration_ms}
        result = self._send_command(command)
        return result.get('code') == 0
    
    def get_device_status(self):
        """查询设备状态（需根据平台实际接口调整）"""
        # 此处为示例，实际应调用状态查询接口
        ts = int(time.time())
        sign = self._generate_sign(ts)
        url = f"{self.base_url}/{self.app_id}/device/status/?device={self.device_id}&sign={sign}&ts={ts}"
        response = requests.get(url, timeout=10)
        return response.json()

# 业务使用示例
if __name__ == "__main__":
    controller = YouyouIoTController("YOUR_APP_ID", "YOUR_APP_SECRET", "DEVICE_ID")
    
    # 启动水泵（第1路）
    if controller.control_power1(True):
        print("水泵已启动")
    
    # 脉冲控制（打开2秒后自动关闭）
    if controller.pulse_control(2, 2000):
        print("第2路执行脉冲控制")

5.3 状态反馈处理服务端（Node.js）

const express = require('express');
const crypto = require('crypto');

const app = express();
app.use(express.json());

// 设备状态存储
const deviceStatus = new Map();

// 接收设备状态回调
app.post('/api/device/callback', (req, res) => {
    const { device_id, status, timestamp } = req.body;
    
    // 更新本地状态
    deviceStatus.set(device_id, {
        ...status,
        lastUpdate: timestamp
    });
    
    console.log(`设备${device_id}状态更新:`, status);
    
    // 根据负载状态执行业务逻辑
    if (status.power1 === 1) {
        console.log('水泵已启动，开始记录运行时长');
        startRuntimeRecord(device_id);
    } else if (status.power1 === 0) {
        console.log('水泵已停止，计算本次运行时长');
        stopAndCalculateRuntime(device_id);
    }
    
    res.json({ code: 0, message: 'received' });
});

// 查询设备当前状态
app.get('/api/device/status/:deviceId', (req, res) => {
    const status = deviceStatus.get(req.params.deviceId);
    res.json({ device_id: req.params.deviceId, status: status || {} });
});

app.listen(8080, () => {
    console.log('回调服务已启动: http://localhost:8080');
});

6. 常见问题和需要注意的点

6.1 网络与通信

设备需连接2.4GHz Wi-Fi（不支持5GHz频段）
确保设备与云平台保持心跳连接，离线状态下命令无法送达
API调用超时设置为10秒，同时配置重试机制

6.2 安全规范

严禁在客户端代码中硬编码AppSecret，须通过后端服务调用
时间戳ts有效期一般为300秒，防止重放攻击
生产环境启用HTTPS协议

6.3 状态同步

状态上报可能存在1-3秒延迟，对实时性要求高的场景轮询+回调结合
网络波动时可能导致状态丢失，业务系统定期全量同步

6.4 技术支持

芯步提供全程技术支持，可联系工程师协助

设备选型与对接指导
走线安装与调试
接口联调测试

7. 总结

通过芯步开放的HTTP API接口，业务系统可以快速集成2路智能直流控制模块，实现：

远程控制：通过HTTP请求对两路负载进行独立开关控制，支持点动/脉冲等多种控制模式
状态反馈：通过消息推送机制实时接收负载状态变化，实现闭环控制
稳定可靠：签名鉴权保障接口安全，标准HTTP协议便于跨平台集成

该方案适用于智慧农业、工业自动化、智能楼宇等需要远程设备控制与状态监控的场景，可大幅降低物联网设备接入的开发成本。

1. 概述

1.1 产品简介

1.2 适用场景

1.3 技术架构

2. 对接准备工作

2.1 平台账号注册

2.2 创建工作台与应用

2.3 设备添加与激活

2.4 接口地址

3. API接口对接详解

3.1 签名机制（重要安全说明）

3.2 单路控制接口

3.3 批量控制接口

3.4 点动/脉冲控制模式

4. 负载状态反馈机制

4.1 实时状态上报配置

4.2 状态上报数据格式

4.3 业务系统回调处理示例（Python Flask）

4.4 主动查询设备状态

5. 完整对接案例

5.1 场景：智慧水泵控制系统

5.2 Python 完整实现代码

5.3 状态反馈处理服务端（Node.js）

6. 常见问题和需要注意的点

6.1 网络与通信

6.2 安全规范

6.3 状态同步

6.4 技术支持

7. 总结

控制器产品方案：

怎么在照明控制中集成智能设备来实现分路控制灯光与设备

怎样在照明控制中对接智能硬件以实现多达24路独立线路控制

如何二次开发4 路智能照明控制器来实现定时开关照明设备电源

共享自习室包间管理：怎么将8路包间灯光空调控制器接入到软件项目中

剧本杀密室包间场景：怎样把HTTP接口包间控制器接入到自己的项目中

负载场景方案：

怎么对接8路智能直流控制器来实现低压直流负载通断控制

如何接入AC4-10A开关以实现单路交流负载控制

怎样对接 8 路智能交流控制模块以实现交流负载通断控制

共享场所直流负载管理：怎么将4路直流电路控制器对接到项目中

怎样对接60A带计量数显物联网断路器来实现额定功率负载控制

反馈用途方案：

怎么接入24 路智能分体远程设备集中控制模块以实现线路状态反馈控制

如何在车间设备机柜电源控制中对接智能设备来实现线路状态反馈控制

怎么对接30W 自动语音通知音柱以实现设备状态语音反馈

怎样对接60A带计量数显额定 13200W 断路器来实现电路状态反馈控制

怎么在调度站语音播报中接入智能设备以实现设备状态语音反馈