怎么接入DC-10A 物联网开关以实现按钮动作屏蔽控制_解决方案

CATALOG

芯步DC-10A智能通断器的“按钮动作屏蔽”功能，技术上可通过设备自带的“开关量输入”配置实现——将外部物理开关的动作与继电器输出解耦。以下方案涵盖本地局域网和云端HTTP两种控制路径，以及完整的代码实现示例。

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

在开始集成之前，首先需要了解 DC-10A 的相关技术参数。该设备是一个不带物理按键的智能通断器，通常用于嵌入灯、电机或其它电器内部。

物理特征：它本身不带传统的翘板开关，而是提供 IN1、IN2 两路开关量输入接口，用于外接物理按钮（如自复位开关）。
核心需求：所谓的“屏蔽按钮动作”，在物联网领域通常指 禁止外部物理输入，即设备收到外接开关的信号后，不执行任何动作（不翻转继电器状态）。
控制方式
- 本地局域网 (LAN)：设备在局域网内的 IP 地址是固定的，可以直接通过 HTTP POST 请求控制，响应速度极快（适合工业或自动化生产线）。
- 云端 API (SaaS)：通过芯步的官方开放平台进行控制，适合跨地域、远程或需要数据统计的场景。

2. 解决方案原理解析

要实现“屏蔽控制”，核心逻辑是：当系统处于某种特定状态（如下班模式、设备维护模式）时，如果有人在本地按下了外接的物理开关，设备控制器（单片机）会收到一个信号，但不会执行继电器的闭合或断开。

这通常通过修改设备配置或下发特定指令来实现。根据芯步的通用机制，我们可以通过修改设备针对输入端（Input）的响应逻辑来达成目标。

实现路径

物理层：外接按钮接入 IN1 和 COM 端口。
逻辑层
- 默认模式：短按 -> 切换继电器状态（开/关）。
- 屏蔽模式：通过 HTTP 接口发送指令，告诉 DC-10A：“忽略所有来自 IN1 的触发信号”。

3. 具体开发实施步骤

您可以根据设备所处的网络环境，选择以下两种方案之一进行开发。

方案 A：局域网直连方案（推荐，低延迟）

此方案不经过云端服务器，直接向设备 IP 发送 HTTP 指令。由于 DC-10A 直连 WiFi，只要您的服务器/手机与设备处于同一局域网即可。

1. 准备环境

确保 DC-10A 已连接 WiFi，并在路由后台或通过 mDNS 获取到设备 IP（例如 192.168.1.100）。
注意：私有化部署时，如果配置了密码 secret，请求需携带 sign 参数 (md5(secret))。

2. 定义“屏蔽”与“恢复”的功能函数

我们将利用设备本身对输入信号的处理机制。如果设备手册支持自定义输入配置，通常可以通过修改 di（数字输入）的映射关系来实现。

假设接口逻辑：通过发送 di 配置指令，将输入通道的动作设置为 none（无动作）。

Shell (cURL) 示例

Python 实现 (局域网版)

import requests
import json

class DC10ALocalController:
    def __init__(self, device_ip):
        self.base_url = f"http://{device_ip}/control"
        # 如果内置密码，需计算 sign: hashlib.md5(secret.encode()).hexdigest()
        # self.params = {'sign': 'calculated_sign'}

def set_input_mode(self, input_pin, mode):
        """
        设置输入引脚模式
        :param input_pin: 输入引脚编号，如 'di1', 'di2'
        :param mode: 模式, 'toggle' (正常) 或 'disabled' (屏蔽)
        """
        # 映射逻辑:将 mode 转换为设备识别的命令
        # 假设设备接受 {"di1": {"action": "none"}} 来屏蔽
        command = {
            input_pin: {
                "action": mode
            }
        }
        # 发送 POST 请求
        try:
            response = requests.post(self.base_url, json=command, timeout=2)
            return response.json()
        except Exception as e:
            return {"error": str(e)}

def shield_button(self):
        """屏蔽按钮"""
        return self.set_input_mode('di1', 'none') # 'none' 代表无动作

def restore_button(self):
        """恢复按钮"""
        return self.set_input_mode('di1', 'toggle') # 'toggle' 代表翻转继电器

# 使用示例
controller = DC10ALocalController("192.168.1.100")
controller.shield_button()  # 此时按外接开关，设备无反应

方案 B：云端 API 方案 (适合远程锁定的场景)

如果您需要在外出时，远程锁定设备的按键功能，需要通过芯步的云端 HTTP 接口。

1. 获取凭证

登录芯步控制台，获取 AppID 和 AppSecret。
获取目标设备的 DeviceID (通常在控制台设备列表可见)。

2. 签名算法

所有云端请求需要携带签名。
公式：sign = md5( md5(AppSecret) + ts )。

3. 云端控制代码 (Node.js 示例)

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

class YoyoCloudAPI {
    constructor(appId, appSecret) {
        this.appId = appId;
        this.appSecret = appSecret;
        this.baseUrl = 'https://api.thingboot.com';
    }

// 生成签名
    generateSign(ts) {
        const step1 = crypto.createHash('md5').update(this.appSecret).digest('hex');
        const step2 = crypto.createHash('md5').update(step1 + ts).digest('hex');
        return step2;
    }

// 控制设备
    async sendCommand(deviceId, order) {
        const ts = Math.floor(Date.now() / 1000);
        const sign = this.generateSign(ts);
        const url = `${this.baseUrl}/${this.appId}/device/control/?sign=${sign}&ts=${ts}`;
        
        const payload = {
            device: deviceId,
            order: order
        };

const response = await axios.post(url, payload, {
            headers: { 'Content-Type': 'application/json' }
        });
        return response.data;
    }

// 屏蔽按钮:下发一个无效命令或修改配置
    async shieldButton(deviceId) {
        // 策略:下发一个无实际物理意义的命令来 "覆盖" 或 "锁死" 按钮状态
        // 注意:实际的 DC-10A 物理按钮是直接连 GPIO 的。
        // 如果是云端控制继电器，物理按钮通常仍会触发。
        // 要实现真正的物理屏蔽，通常需要依靠设备固件支持 "童锁" 功能。
        // 假设 DC-10A 支持 "锁定" 命令:
        const order = { "child_lock": 1 }; 
        console.log(`正在远程锁定设备 ${deviceId} 的物理按钮...`);
        return this.sendCommand(deviceId, order);
    }

async unshieldButton(deviceId) {
        const order = { "child_lock": 0 };
        console.log(`正在解除锁定...`);
        return this.sendCommand(deviceId, order);
    }
}

// 使用示例
const api = new YoyoCloudAPI("your_app_id", "your_app_secret");
api.shieldButton("device_serial_123456");

4. 高级策略与业务逻辑集成

在实际业务场景中，“屏蔽按钮”往往不是孤立的行为，而是某种安全策略的一部分。以下是一个结合了状态管理的 Python 高级实现，展示了如何在 Web 服务中集成该逻辑：

from flask import Flask, request, jsonify
from enum import Enum

app = Flask(__name__)

# 全局状态管理
device_status = {
    "dc10a_001": {
        "is_button_blocked": False,
        "relay_state": "off"
    }
}

class ButtonAction(Enum):
    BLOCK = "block"
    RELEASE = "release"

def execute_device_command(device_id, command):
    """
    这里封装了上文提到的局域网或云端 HTTP 请求
    """
    # 伪代码: requests.post(f"http://{ip}/control", json=command)
    print(f"Executing on {device_id}: {command}")
    return True

@app.route('/api/device/<device_id>/button_block', methods=['POST'])
def block_button(device_id):
    """
    场景:仓库下班关门后，自动屏蔽门口开关，防止无关人员误操作电机。
    """
    action = request.json.get('action')
    
    if action == ButtonAction.BLOCK.value:
        # 1. 下发屏蔽指令给 DC-10A
        # 指令含义:设置 DI1 输入状态为 "no_response"
        success = execute_device_command(device_id, {"di1": "disabled"})
        
        if success:
            device_status[device_id]["is_button_blocked"] = True
            return jsonify({"status": "success", "msg": "物理按钮已屏蔽，此时按下按钮无效。"})
    
    elif action == ButtonAction.RELEASE.value:
        success = execute_device_command(device_id, {"di1": "enabled"})
        if success:
            device_status[device_id]["is_button_blocked"] = False
            return jsonify({"status": "success", "msg": "物理按钮已恢复。"})
    
    return jsonify({"status": "error"}), 400

if __name__ == '__main__':
    app.run(port=5000)

5. 常见问题排查

在实际对接过程中，如果发现“屏蔽”指令无效，通常是由以下几个原因引起的：

设备固件版本不支持：早期的物联网设备，物理按钮的GPIO（通用输入输出）与继电器是直连逻辑，无法通过软件屏蔽。如果无法屏蔽，可能需要更换支持“童锁”功能的型号（如智能墙壁插座10A 明确支持按钮动作自定义）。
接口地址混淆
- 控制云端设备请用 https://api.thingboot.com。
- 控制局域网设备请用 http://<设备IP>/control。
输入信号类型匹配
- DC-10A 支持 两路开关量输入。请确认外接的物理开关是 无源干接点 类型，且接线正确（通常接 IN 和 COM）。

通过上述接口调用与状态管理，您可以轻松地将芯步 DC-10A 集成到现有的自动化系统中，实现对物理按钮操作的灵活管控，满足公共区域节能、设备防误触等复杂业务需求。