怎样接入60A数显智能空开来实现远程定时通断控制_解决方案

CATALOG

60A数显智能空开属于大功率设备，接入时需要重点关注接口签名算法、定时任务机制以及负载安全边界。以下方案基于芯步开放接口，梳理从设备配网到业务系统集成的完整流程。

解决方案：基于芯步开放接口接入60A数显智能空开实现远程定时通断控制

1. 概述

60A数显智能空开（属于智能通断器/断路器类产品）通常用于工厂设备、充电桩、大型照明电路或大功率家电的电流计量与保护。

通过接入芯步的开放接口，开发者可以绕过复杂的硬件开发，直接通过HTTP协议实现以下目标：

远程强制通断：在任何地点执行“合闸”或“分闸”。
定时策略执行：设定“今晚18:00开启，明早08:00关闭”等循环或单次任务。
状态与数据感知：获取空开的通断状态及实时的电流、电压、功率因数等数显数据（如产品支持）。

2. 硬件与接口准备

硬件设备：芯步 60A 数显智能空开（确认支持HTTP远程控制及数据回传）。
接口协议HTTP/HTTPS POST 请求。
核心凭证
- AppID：应用唯一标识。
- AppSecret：接口调用的密钥（用于加密）。
- Device ID：设备唯一ID（扫码或配网后获得）。

3. 接入流程与技术实现

3.1 设备初始化与配网

在进行API调用前，需确保空开连接至互联网。

账号注册：注册芯步开发者账号。
设备配网：使用“芯步小程序”或“PC控制台”的“网络配置”功能，将设备加入本地2.4GHz WiFi网络。
获取设备ID：配网成功后，在控制台“设备列表”中查看并记录该60A空开的 Device ID。

3.2 API 签名机制

为了防止接口被恶意调用，芯步采用动态签名验证。所有控制请求必须携带 sign 和 ts（时间戳）。

签名算法步骤如下

将 AppSecret 进行第一次 MD5 加密，得到 Secret_MD5。
将 Secret_MD5 与当前Unix时间戳 ts （秒）进行字符串拼接。
将拼接后的字符串进行第二次 MD5 加密，得到最终的 sign。

公式化描述Sign = MD5( MD5(AppSecret) + ts )

3.3 实现远程定时通断控制

由于60A空开属于大功率设备，在代码逻辑中增加“操作确认”机制，防止误关导致生产事故。

1. 单次即时控制通过向接口下发 order 指令实现通电或断电。

接口地址： http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}
请求方法： POST
请求体 (JSON)
{ "device": "这里填写60A空开的设备ID", "order": {"power": 1} // 1 代表合闸/通电，0 代表分闸/断电 }
注意：请根据60A空开的具体产品手册确认控制字段是 power 还是 power1，大功率单路设备多使用 power。

2. 内置定时任务在一些场景中，设备断网会导致云端定时任务失效。芯步设备支持设备端硬件定时，命令下发后，即使断网，空开也会在指定时间后动作。

需求场景：充电桩充电1小时后自动断电。
下发命令
{ "device": "Device_ID", "order": {"reset": 3600000} // 数值单位为毫秒，3600000 = 1小时 }
解析：该命令会立即让空开通电，并在1小时（3600000ms）后自动断开。

3. 业务层复杂定时策略对于“每周一至周五 09:00 开启”等复杂循环规则，在您的业务服务器（或云函数）中使用 cron 表达式实现。

业务逻辑：服务器定时任务 -> 计算签名 -> 调用上述“单次即时控制”接口。

3.4 代码示例

以下伪代码展示了如何封装一个控制60A空开的函数，本示例中为Python代码，这适用于大多数支持HTTP请求的后端语言。

import hashlib
import time
import requests
import json

# 配置信息
APP_ID = "YOUR_APP_ID"
APP_SECRET = "YOUR_APP_SECRET"
DEVICE_ID = "YOUR_60A_AIR_SWITCH_ID"
API_URL = f"https://api.thingboot.com/{APP_ID}/device/control/"

def control_air_switch(action): # action: 1为开启, 0为关闭
    # 1. 生成时间戳
    ts = str(int(time.time()))
    
    # 2. 生成签名（严格按照官方文档逻辑）
    # 先对 AppSecret 进行第一次 MD5
    md5_app_secret = hashlib.md5(APP_SECRET.encode()).hexdigest()
    # 拼接字符串
    sign_str = md5_app_secret + ts
    # 第二次 MD5 得到最终签名
    sign = hashlib.md5(sign_str.encode()).hexdigest()
    
    # 3. 构造请求参数
    params = {
        'sign': sign,
        'ts': ts
    }
    
    # 4. 构造Body (符合60A空开的命令格式)
    payload = {
        'device': DEVICE_ID,
        'order': {'power': action}  # 关键点:确认字段名为 power
    }
    
    # 5. 发起请求
    headers = {'Content-Type': 'application/json'}
    response = requests.post(API_URL, params=params, data=json.dumps(payload), headers=headers)
    
    return response.json()

# 示例:远程关闭60A空开
# result = control_air_switch(0)

4. 针对“数显”数据的获取

如果业务需要获取60A空开的实时电流、电压、电量（kWh）等数据用于大屏展示或计费系统：

状态查询接口：调用设备状态查询API（如 device/status），返回的JSON数据中通常包含 voltage、current、power 字段。
消息推送：在芯步控制台配置消息推送URL。当空开数据变化时，平台会主动向你的服务器推送实时数据，免去轮询压力。

5. 注意事项与

安全校验：请一定要在服务器端校验时间戳 ts 的有效性（例如5分钟内有效），防止重放攻击。
执行确认：60A电流通常涉及380V高压或大功率设备。请在代码中设计逻辑，在发送“闭合/通电”命令前，确保设备端无故障告警。
响应速度：根据官方数据，从命令下发到设备动作约80-120ms。若业务要求比较高实时性（如<50ms），可考虑使用局域网IP直控功能。
本地IO触发：若需在断网时保持控制，可利用空开自带的物理接线端子，外接旋钮或按钮实现硬件级应急控制。

通过以上步骤，您可以利用芯步的开放接口，在无需深研嵌入式固件的情况下，快速为您的60A数显智能空开搭建一套可靠的远程定时控制系统。