共享自习室电源控制：怎样将20A联动控制智能空开集成到项目中_解决方案

CATALOG

一、概述

共享自习室作为自助服务型业态，其电源管理直接关系到运营成本和用户体验。传统方案中，管理员需要亲临现场处理卡座断电、设备复位等问题，效率低下。芯步智能断路器20A（型号：UNI-DLQ-20A）通过开放HTTP接口，可无缝接入您的自习室管理系统，实现多路电源远程分控、订单联动启停、定时自动关断等自动化管理功能。

核心能力

20A大电流承载：单回路最大负载4400W，满足卡座插座、照明、空调等多设备需求
开放HTTP API：适用于任何支持HTTP请求的编程语言，10分钟完成对接
超低延迟：命令下发到设备响应80-120ms，电源切换流畅无感知
私有化部署：支持局域网运行，数据安全可控
无网关设计：WiFi直连，可设定5组WiFi自动切换

共享自习室典型应用场景

场景	控制对象	联动逻辑
扫码上座自动通电	卡座插座	用户扫码支付成功，对应插座自动通电
倒计时结束自动断电	卡座插座	订单结束前5分钟提醒，结束后自动断电
自习室公区照明	照明回路	按营业时间定时自动开关
管理员远程控制	任意回路	后台一键开关指定卡座电源
批量关电	全室设备	闭店时一键关闭所有电源

二、核心产品选型

2.1 智能断路器20A

芯步智能断路器20A（型号：UNI-DLQ-20A）专为共享自习室、棋牌室等场景设计。

特性	参数
额定电流	20A
工作电压	100-250V AC
控制方式	HTTP API远程控制 + 本地按钮
按钮功能	可自定义、可屏蔽
安装方式	标准导轨式安装（35mm DIN导轨）
无线连接	WiFi 2.4GHz
控制接口	HTTP API
私有化部署	支持局域网直连
响应延迟	80-120ms

2.2 选型

对于自习室卡座分布较多的场景，可按以下方案配置：

自习室规模	推荐方案	说明
小型（10-20座）	1台20A断路器 + 排插	断路器控制总线路，各卡座用排插扩展
中型（20-40座）	2-3台20A断路器	分区管理，便于独立控制不同区域
大型（40+座）	配电箱集中部署	断路器+接触器组合，实现精细化控制

2.3 设备核心优势

设备开放HTTP接口，适用于任何支持HTTP请求的编程语言。接口简单、清晰、友好，仅需在接口携带签名以及设备ID，即可向设备下发命令。支持接入任何形式的软件项目：Web、APP/小程序、窗体软件以及SaaS/低代码等平台。同时本产品支持私有化部署，支持自建消息服务器，可运行在纯局域网环境。

三、整体架构

3.1 系统架构图

┌─────────────────────────────────────────────────────────────────┐
│                    自习室管理系统 / 小程序后台                    │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐               │
│  │  订单处理   │  │  设备控制   │  │  定时任务   │               │
│  └─────────────┘  └─────────────┘  └─────────────┘               │
└─────────────────────────────────────────────────────────────────┘
                              │
                              │ HTTP API调用（携带签名）
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                     芯步云平台 / 私有化服务器                  │
└─────────────────────────────────────────────────────────────────┘
                              │
                              │ WiFi 2.4GHz
          ┌───────────────────┼───────────────────┐
          │                   │                   │
          ▼                   ▼                   ▼
    ┌─────────────────────────────────────────────────────────────┐
    │                        自习室配电箱                          │
    │  ┌──────────┐  ┌──────────┐  ┌──────────┐                    │
    │  │ 20A断路器 │  │ 20A断路器 │  │ 照明开关  │                    │
    │  │ (卡座区A)│  │ (卡座区B)│  │ (公区)   │                    │
    │  └────┬─────┘  └────┬─────┘  └────┬─────┘                    │
    │       │             │             │                          │
    │       ▼             ▼             ▼                          │
    │   ┌───┴───┐     ┌───┴───┐     ┌───┴───┐                      │
    │   │卡座1-4│     │卡座5-8│     │ 照明  │                      │
    │   └───────┘     └───────┘     └───────┘                      │
    └─────────────────────────────────────────────────────────────┘

3.2 共享自习室电源分配方案

回路	控制对象	典型功率	管理策略
回路1	卡座区A电源（4-6个卡座）	800-1200W	按座位扫码通电
回路2	卡座区B电源（4-6个卡座）	800-1200W	按座位扫码通电
回路3	公区照明	100-200W	营业时段自动开关
回路4	空调/新风	1500-2000W	按营业时间定时
回路5	饮水机/休息区	500W	订单联动可选

四、API接口接入详解

4.1 接口地址与签名计算

智能断路器开放HTTP接口，可向设备下发命令。

请求地址

https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

参数说明

参数	说明	示例
{AppId}	应用ID（控制台获取）	`qtyVWcgeMq`
{ts}	当前Unix时间戳（秒）	`1747212640`
{sign}	签名	`c484eb97...`

签名计算公式（两次MD5加密）

sign = md5( md5(AppSecret) + ts )

将开发者密码（AppSecret）进行一次MD5
将这个结果拼接上时间戳ts
对整个拼接后的字符串再做一次MD5

签名计算示例

4.2 核心命令详解

智能断路器支持单路控制和批量控制两种方式。

4.2.1 单路独立控制

4.2.2 先断后通（远程重启）

适用于设备死机时的远程复位：

4.2.3 延时自动断电（核心功能）

共享自习室场景中，一条命令即可实现临时通电并自动断开，非常适合订单结束场景

*说明：reset后的数值为延时毫秒数，3600000毫秒 = 1小时*

4.2.4 批量控制（多设备管理）

4.3 多语言代码示例

Python

import requests
import time
import hashlib

class StudyRoomPowerManager:
    """共享自习室电源管理器"""
    
    def __init__(self, app_id: str, app_secret: str):
        self.app_id = app_id
        self.app_secret = app_secret
        self.base_url = f"https://api.thingboot.com/{app_id}/device/control/"
    
    def _generate_sign(self, ts: int) -> str:
        """生成签名:md5(md5(AppSecret) + ts)"""
        md5_secret = hashlib.md5(self.app_secret.encode()).hexdigest()
        sign_str = md5_secret + str(ts)
        return hashlib.md5(sign_str.encode()).hexdigest()
    
    def _send_command(self, device_id: str, order: dict) -> dict:
        """发送命令到设备"""
        ts = int(time.time())
        sign = self._generate_sign(ts)
        url = f"{self.base_url}?sign={sign}&ts={ts}"
        payload = {"device": device_id, "order": order}
        
        response = requests.post(url, json=payload, timeout=5)
        return response.json()
    
    # ========== 核心电源控制 ==========
    def power_on(self, device_id: str) -> dict:
        """接通电源"""
        return self._send_command(device_id, {"power": "1"})
    
    def power_off(self, device_id: str) -> dict:
        """断开电源"""
        return self._send_command(device_id, {"power": "0"})
    
    def power_on_timed(self, device_id: str, duration_minutes: int) -> dict:
        """临时通电，时长结束后自动断电"""
        duration_ms = duration_minutes * 60 * 1000
        return self._send_command(device_id, {"reset": str(duration_ms)})
    
    # ========== 订单联动 ==========
    def start_booking(self, device_id: str, duration_minutes: int) -> dict:
        """用户下单成功，接通电源并设置自动断电"""
        print(f"订单开始:设备 {device_id} 通电 {duration_minutes} 分钟")
        return self.power_on_timed(device_id, duration_minutes)
    
    def extend_booking(self, device_id: str, extra_minutes: int) -> dict:
        """续费:重新设置断电时间"""
        # 先断电再通电（重置定时器）
        self.power_off(device_id)
        time.sleep(0.5)
        return self.power_on_timed(device_id, extra_minutes)
    
    def end_booking(self, device_id: str) -> dict:
        """订单结束，立即断电"""
        return self.power_off(device_id)
    
    # ========== 批量控制 ==========
    def batch_power_off(self, device_ids: list) -> dict:
        """批量关闭多个断路器"""
        devices_str = ",".join(device_ids)
        return self._send_command(devices_str, {"power": "0"})

# 使用示例
manager = StudyRoomPowerManager("your_app_id", "your_app_secret")
breaker_id = "breaker_seat_area_01"

# 用户扫码下单2小时，接通电源
manager.start_booking(breaker_id, 120)

# 用户续费30分钟
manager.extend_booking(breaker_id, 30)

# 订单结束，立即断电
manager.end_booking(breaker_id)

# 闭店时批量关闭所有电源
all_breakers = ["breaker_a01", "breaker_a02", "breaker_b01"]
manager.batch_power_off(all_breakers)

JavaScript/Node.js

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

class StudyRoomPowerManager {
    constructor(appId, appSecret) {
        this.appId = appId;
        this.appSecret = appSecret;
        this.baseUrl = `https://api.thingboot.com/${appId}/device/control/`;
    }
    
    _generateSign(ts) {
        const md5Secret = crypto.createHash('md5').update(this.appSecret).digest('hex');
        const signStr = md5Secret + ts;
        return crypto.createHash('md5').update(signStr).digest('hex');
    }
    
    async sendCommand(deviceId, order) {
        const ts = Math.floor(Date.now() / 1000);
        const sign = this._generateSign(ts);
        const url = `${this.baseUrl}?sign=${sign}&ts=${ts}`;
        
        const payload = { device: deviceId, order };
        const response = await axios.post(url, payload);
        return response.data;
    }
    
    async powerOn(deviceId) {
        return this.sendCommand(deviceId, { power: "1" });
    }
    
    async powerOff(deviceId) {
        return this.sendCommand(deviceId, { power: "0" });
    }
    
    async startBooking(deviceId, durationMinutes) {
        const durationMs = durationMinutes * 60 * 1000;
        return this.sendCommand(deviceId, { reset: durationMs.toString() });
    }
    
    async batchOff(deviceIds) {
        const deviceStr = deviceIds.join(',');
        return this.sendCommand(deviceStr, { power: "0" });
    }
}

Shell（curl）- 快速测试

代码参考：

五、共享自习室场景实战

5.1 第一种场景：扫码上座自动通电

需求：用户通过小程序扫码选择座位并支付成功后，对应卡座插座自动通电。

实现的方式是：支付回调触发API

5.2 第二种场景：倒计时结束自动断电

需求：订单时间结束后，电源自动切断，防止下一位用户未付费使用。

实现的方式是：使用reset命令的延时自动断电功能

5.3 第三种场景：订单即将结束提醒

需求：订单结束前5分钟，通过小程序推送提醒用户续费。

实现的方式是：业务系统定时扫描即将到期的订单

5.4 场景四：管理员后台远程控制

需求：管理员在后台实时查看各断路器状态，并可远程开关指定卡座电源。

5.5 场景五：闭店统一断电

需求：自习室闭店时间到达时，一键关闭所有卡座电源。

实现的方式是：平台定时任务或代码定时器

5.6 场景六：智能用电限制

需求：限制卡座插座的最大功率，防止使用大功率电器造成安全隐患。通过与计量断路器配合，超限自动断电。

六、私有化部署方案

共享自习室运营方对数据安全和成本控制有较高要求，芯步智能断路器支持纯局域网运行。

部署模式对比

特性	公有云模式	私有化模式
设备联网	WiFi连接互联网	连接自习室内网WiFi
API地址	`api.thingboot.com`	自建服务器IP
数据流向	经过芯步云端	内网直连，数据不出自习室
网络依赖	需要互联网	仅需局域网
适用场景	快速部署、单店	连锁品牌、数据安全要求高

私有化配置要点

设备支持配置5组WiFi网络，自动连接信号最强的网络
可搭建现场服务器，所有API调用在内网完成
支持自建消息服务器，接收设备状态回调

七、设备安装部署指南

7.1 安装要求

项目	要求
安装方式	35mm DIN标准导轨安装
额定电流	20A（需匹配≥2.5mm²进线电缆）
工作电压	100-250V AC
网络要求	WiFi 2.4GHz信号覆盖良好
安装位置	配电箱/控制柜内

7.2 自习室部署方案

自习室规模	部署方案	说明
小型（10-20座）	1台20A断路器 + 多路排插	断路器控制总线路，各卡座用排插扩展
中型（20-40座）	2-3台20A断路器	分区管理，便于独立控制不同区域
大型（40+座）	配电箱集中部署	断路器+接触器组合，每4-6座一组

7.3 接线注意事项

电缆规格：20A电流需匹配≥2.5mm²铜芯电缆
散热空间：断路器周围预留足够散热空间
接地保护：必须可靠接地
WiFi信号：金属配电箱可能屏蔽信号，使用外置天线版本
分级控制：采用"1台断路器控制4-6个卡座"的分组方案

八、常见问题与排障

问题	可能原因	解决方案
设备不在线	WiFi信号被屏蔽	检查2.4GHz WiFi覆盖，设备支持5组WiFi自动切换
远程控制无响应	设备离线/参数错误	确认设备在线状态，检查order格式
命令下发成功但设备无动作	设备离线	200仅表示平台接收，需通过消息推送确认执行结果
断路器频繁跳闸	负载功率超限	检查负载是否超过20A×220V=4400W
签名验证失败	AppSecret或ts错误	确认ts为秒级时间戳，签名公式为`md5(md5(AppSecret)+ts)`
延时断电不执行	reset值格式错误	确保reset值为数字字符串，单位毫秒

九、总结

本方案基于芯步智能断路器20A，实现了共享自习室的全自动化电源管理

能力	实现的方式是
扫码自动通电	支付回调触发API
倒计时自动断电	`reset`命令实现延时断电
超低压延迟	80-120ms响应，操作流畅
批量管理	批量控制命令统一关电
管理员远程控制	HTTP API后台操作
私有化部署	内网运行，数据安全可控

集成核心步骤

获取AppID/AppSecret，实现MD5签名算法
开发HTTP调用模块，封装电源控制命令
对接订单系统，实现支付→通电→延时断电→提醒闭环
物理安装设备，按分区规划断路器分配

方案优势

✅ 20A大电流：单回路最大4400W，满足卡座多设备需求
✅ 接口统一：标准HTTP API，10分钟完成对接
✅ 订单全流程联动：从下单到离店自动化电源管理
✅ 超低延迟：80-120ms响应，开关电即时生效
✅ 私有化支持：数据安全可控，适合连锁品牌
✅ 即插即用：WiFi直连无需网关，可设定多组WiFi自动切换

如需详细的产品手册和API文档，请访问查阅或联系技术支持团队获取。