怎么二次开发35A远程智能空开来实现远程批量控制_解决方案

CATALOG

35A远程智能空开（一般指芯步智能通断器/断路器类产品）的批量控制，核心思路是一次请求操作多个设备或通过标签分组管理。下面从接口选择、实现方法到代码示例完整说明。

一、搞清楚两种批量控制的玩法

在芯步的体系里，要实现“批量控制”，主要有两种套路，你可以根据场景来选：

直接指定设备ID（适合临时、小批量）： 如果你只需要临时关掉某几层楼的灯，或者重启某几台服务器，直接拿着设备ID列表去发命令最简单。这种方式的优点是灵活，不需要提前做配置。
使用标签（标签，适合固定分组、大批量）： 如果你需要长期管理，比如控制整个“东区照明”或者“工厂A所有流水线”，先把设备加入一个标签。这样一来，一次命令就能控制成百上千台设备，管理起来也更清晰。

二、具体的接口怎么用

不管是哪种方法，核心都是调用芯步的设备控制接口。

方法一：直接在请求里塞一堆设备ID

这是最直接的办法。芯步的接口支持一次请求最多100个设备ID，只要用英文逗号隔开就行。

假设你要同时关掉3个空开（ID分别是 886201， 886202， 886203），命令是这样的：

请求地址： https://api.thingboot.com/{你的AppID}/device/control/？sign={签名}&ts={时间戳}
请求体（JSON格式）

注意： 这里的order要传字符串形式的JSON，power：0就是断电（关）的意思，power：1是通电（开）。同时由于设备类型不同，针对多路控制器，可能需要使用power1， power2来指定哪一路，批量控制时只要这几个设备都支持power指令即可。

方法二：打标签，搞分组管理

如果100台的限额还是不够，或者你想让“一键下班”更优雅，用标签。

先建标签：在芯步的后台（物联网控制台），新建一个叫“3楼会议室”的标签，把这一层的10个空开都加进去。你会拿到一个标签ID（比如 tag_id 是 10086）。
发送命令：接下来，你只要对着这个标签发命令就行了。

请求体

这样，所有在“3楼会议室”标签下的空开会同时执行命令。而且不同标签下的设备可以是不同类型的，只要指令名字相同就行。

三、撸起袖子写代码（Python示例）

为了让你更有感觉，我用Python写了个简单的脚本，你可以拿去改改就能用。这里面包含了签名计算，这一步比较容易踩坑，请留意一下。

import requests
import time
import hashlib
import json

# --- 配置信息（去后台复制）---
APP_ID = "你的AppID"  
APP_SECRET = "你的AppSecret" 
# 这里演示用的是设备ID列表方式，你也可以换成 tag=10086 的写法
DEVICE_IDS = "886201,886202,886203"

# --- 辅助函数:计算签名 ---
def calc_sign(secret, ts):
    # 官方逻辑:md5(md5(AppSecret) + ts)
    md5_first = hashlib.md5(secret.encode()).hexdigest()
    sign_str = md5_first + str(ts)
    sign = hashlib.md5(sign_str.encode()).hexdigest()
    return sign

# --- 主逻辑:批量断电 ---
def batch_power_off():
    # 1. 拿当前时间戳（秒）
    ts = int(time.time())
    # 2. 算签名
    sign = calc_sign(APP_SECRET, ts)
    
    # 3. 拼URL
    url = f"https://api.thingboot.com/{APP_ID}/device/control/？sign={sign}&ts={ts}"
    
    # 4. 拼Body: device传逗号分隔的ID， order传关电命令
    #   注意:这里如果指令是power，如果设备是多路的可能需要传power1，具体看你设备的指令集
    payload = {
        "device": DEVICE_IDS,
        "order": json.dumps({"power": 0})  # 一定要包装成字符串
    }
    
    # 5. 发送POST请求
    headers = {"Content-Type": "application/json"}
    response = requests.post(url, json=payload, headers=headers)
    
    # 6. 查看结果
    if response.status_code == 200:
        res_json = response.json()
        if res_json.get("code") == 200:
            print("指令已下发成功！")
        else:
            print(f"接口报错: {res_json}")
    else:
        print("HTTP请求失败")

if __name__ == "__main__":
    batch_power_off()

四、几个小（避坑指南）

异步反馈（心里要有数）：接口返回200只代表平台收到了指令，不代表空开真的执行了。如果设备刚好离线，虽然显示成功，其实并没跳闸。如果你的业务要求比较严格（比如计费系统），配置消息推送，接收设备执行后的结果回调，做到心里有数。
踩一下“标签”的坑：用tag参数时，要确保这个标签下的设备指令是通用的。如果你把一个单路的空开（指令是power）和一个四路的控制器（指令可能是power1）放在同一个标签里，同时下发power=0可能会失败，或只有部分设备响应。
利用extra字段做关联：在批量控制时，你可能想知道“这批命令是谁在什么时候发的”。你可以在order里加一个extra字段，比如{“power”：0, “extra”：“admin_batch_off_20230521”}。平台推送结果时会把这个字段原样带回，方便你做日志审计。

五、总结一下

要实现芯步35A空开的批量控制，其实就是把多个设备ID拼成字符串或者打标签。代码实现上，重点在于签名的计算（MD5嵌套）和请求格式（order必须是字符串）。搞定这些，你就可以在自己的系统里一键控制全楼的灯光或设备了。