如何在共享台球室设备机柜电源控制中对接智能硬件以实现设备电源批量管控_解决方案

CATALOG

一、解决概述

共享台球室的痛点是：设备分散、管理繁琐——每个台球桌旁都对应一台控球系统（扫球机）和照明，桌球室的灯光、空调等也需要独立控制。传统方案依赖保洁/店长逐一操作，不仅效率低，还容易出现“某桌设备未关”的能耗浪费。

本方案利用芯步智能控制器的多路独立控制能力，将所有设备的供电线路集中接入控制系统，通过HTTP接口与管理后台对接，实现：

支持独立/批量管控：按台球桌编号独立开关，或一键全店断电
定时自动化：营业时间自动通电，闭店自动断电
远程异常处理：设备死机时远程断电重启，无需到场
功率匹配：单路负载最高2200W，足以带动主流扫球机、照明设备

二、核心技术能力分析

2.1 适用产品选型

根据台球室设备数量和功率需求，推荐以下设备组合：

设备类型	芯步智能控制器8路	智能PDU分控版	智能分体控制箱
控制路数	8路独立输出	8位独立插孔	12-24路可选
单路负载	≤2200W[阻]/≤350W[感]	≤2200W/路	≤5000W/路
适用场景	中小型台球室（8桌以内）	机柜集中式	连锁/大型台球室
安装方式	导轨安装	1U机架/桌面	成品控制箱
特殊功能	体积小巧	即插即用	成品出柜，到手即用

选型

8桌以内标配：选智能控制器8路，一台设备管全场
已有机柜/吧台：选智能PDU[分控]|8位，外观更规整
连锁/大型场馆（12桌+）：选智能分体控制箱，24路按需配置，减少设备数量

2.2 核心命令表

根据芯步接口规范，控制器支持以下核心命令

命令类型	JSON格式示例	功能说明（台球室场景）
单路控制	`{"power1":1}`	开启1号桌设备
多路独立控制	`{"power1":1,"power2":0,"power3":1}`	桌1开、桌2关、桌3开
选择性批量控制	`{"batch":{"relay":[1,3,5],"power":0}}`	同时关闭1、3、5号桌
全开全关	`{"batch":{"power":0}}`	一键全场断电
点动模式	`{"point":{"relay":[1],"interval":3000}}`	临时通电3秒
延时复位	`{"reset":{"relay":[1],"interval":5000}}`	断电5秒后自动恢复

2.3 API接口签名规则

芯步API采用动态签名验证机制，设备直连HTTP接口，适用于任何支持HTTP请求的编程语言

请求地址:https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}
请求方法:POST
Content-Type:application/json

签名算法:
sign = md5( md5(AppSecret) + ts )

参数说明:
- AppId:应用ID（控制台获取）
- AppSecret:应用密钥（控制台获取）
- ts:当前Unix时间戳（秒）

请求Body示例（关闭3号桌电源）：

批量控制：支持一次向最多100台设备下发指令，设备ID用逗号分隔：

三、共享台球室集成方案

3.1 整体架构

┌─────────────────────────────────────────────────────────────────┐
│                        台球室设备群                              │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │           智能控制器8路（导轨安装于配电箱）               │   │
│  │  ┌─────┐┌─────┐┌─────┐┌─────┐┌─────┐┌─────┐┌─────┐┌─────┐│   │
│  │  │桌1  ││桌2  ││桌3  ││桌4  ││桌5  ││桌6  ││桌7  ││桌8  ││   │
│  │  │扫球机││扫球机││扫球机││扫球机││扫球机││扫球机││扫球机││扫球机│
│  │  │+照明││+照明││+照明││+照明││+照明││+照明││+照明││+照明││   │
│  │  └─────┘└─────┘└─────┘└─────┘└─────┘└─────┘└─────┘└─────┘│   │
│  └─────────────────────────────────────────────────────────┘   │
│                                                                 │
│  联动触发源:                                                   │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐              │
│  │  用户小程序 │  │  后台定时器 │  │  传感器     │              │
│  │  (扫码开机) │  │  (闭店断电) │  │  (人走关灯) │              │
│  └──────┬──────┘  └──────┬──────┘  └──────┬──────┘              │
│         │                │                │                     │
│         └────────────────┼────────────────┘                     │
│                          │ HTTP API                             │
└──────────────────────────┼──────────────────────────────────────┘
                           │
                           ▼
┌─────────────────────────────────────────────────────────────────┐
│                      台球室管理后台                              │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │                    批量控制引擎                          │   │
│  │  - 单桌独立控制                                          │   │
│  │  - 全场批量开关                                          │   │
│  │  - 定时任务管理                                          │   │
│  └─────────────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────────────┘

3.2 硬件安装步骤

步骤1：设备选型与采购

根据桌数选择：≤8桌用智能控制器8路，≥8桌用智能分体控制箱（24路）
确认台球扫球机、照明等设备总功率，确保单路≤2200W

步骤2：控制器安装

控制器8路：导轨安装于配电箱，体积80×95×65.2mm
分体控制箱：成品出柜，到手即用，无需走线

步骤3：接线

输入端接入配电箱供电线路（AC 220V）
输出端按桌号依次接入扫球机、照明设备

步骤4：网络配置

确保WiFi信号覆盖（设备仅支持2.4G频段）
通过芯步控制台完成配网

步骤5：获取凭证

登录
获取 AppId 和 AppSecret
记录控制器的设备ID（如820720）

3.3 代码集成示例

以下提供Python和Node.js两种语言的完整对接示例。

Python实现（推荐用于后端服务）

import hashlib
import time
import requests
import schedule
import threading
from typing import Dict, Optional, List
from flask import Flask, request, jsonify

app = Flask(__name__)

class BilliardPowerController:
    """台球室8路电源控制器类"""
    
    def __init__(self, app_id: str, app_secret: str):
        self.app_id = app_id
        self.app_secret = app_secret
        self.api_base = "https://api.thingboot.com"
    
    def _generate_sign(self, ts: int) -> str:
        """生成API签名:sign = 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) -> Optional[Dict]:
        """发送控制命令"""
        ts = int(time.time())
        sign = self._generate_sign(ts)
        url = f"{self.api_base}/{self.app_id}/device/control/?sign={sign}&ts={ts}"
        
        payload = {"device": device_id, "order": order}
        try:
            response = requests.post(url, json=payload, timeout=5)
            return response.json()
        except Exception as e:
            print(f"命令发送失败: {e}")
            return None
    
    # ========== 单桌控制 ==========
    def power_on(self, device_id: str, table_number: int) -> Optional[Dict]:
        """开启指定台球桌设备（扫球机+照明）"""
        return self._send_command(device_id, {f"power{table_number}": 1})
    
    def power_off(self, device_id: str, table_number: int) -> Optional[Dict]:
        """关闭指定台球桌设备"""
        return self._send_command(device_id, {f"power{table_number}": 0})
    
    # ========== 批量控制 ==========
    def batch_on(self, device_id: str, tables: List[int]) -> Optional[Dict]:
        """批量开启多个台球桌"""
        return self._send_command(device_id, {
            "batch": {"relay": tables, "power": 1}
        })
    
    def batch_off(self, device_id: str, tables: List[int]) -> Optional[Dict]:
        """批量关闭多个台球桌"""
        return self._send_command(device_id, {
            "batch": {"relay": tables, "power": 0}
        })
    
    def all_on(self, device_id: str) -> Optional[Dict]:
        """全场通电（开门营业）"""
        return self._send_command(device_id, {"batch": {"power": 1}})
    
    def all_off(self, device_id: str) -> Optional[Dict]:
        """全场断电（闭店节能）"""
        return self._send_command(device_id, {"batch": {"power": 0}})
    
    # ========== 辅助功能 ==========
    def point_on(self, device_id: str, table_number: int, duration_ms: int = 5000) -> Optional[Dict]:
        """点动通电:通电后自动断（测试/故障恢复用）"""
        return self._send_command(device_id, {
            "point": {"relay": [table_number], "interval": duration_ms}
        })
    
    def timed_off(self, device_id: str, table_number: int, delay_ms: int) -> Optional[Dict]:
        """延时断电:开启后延时自动关闭（订单超时用）"""
        return self._send_command(device_id, {
            "point": {"relay": [table_number], "interval": delay_ms}
        })

# ========== 台球室配置 ==========
controller = BilliardPowerController("YOUR_APP_ID", "YOUR_APP_SECRET")
DEVICE_ID = "820720"  # 替换为实际设备ID
TABLE_NAMES = {1: "VIP1", 2: "VIP2", 3: "标准桌1", 4: "标准桌2", 5: "标准桌3", 6: "标准桌4"}

# ========== 营业定时任务 ==========
def setup_business_schedule():
    """营业时间自动控制"""
    
    # 9:00 全场通电（开门营业）
    schedule.every().day.at("09:00").do(controller.all_on, DEVICE_ID)
    print("已设置定时任务:每日9:00全场通电")
    
    # 23:00 全场断电（闭店）[citation:8]
    schedule.every().day.at("23:00").do(controller.all_off, DEVICE_ID)
    print("已设置定时任务:每日23:00全场断电")

# ========== 用户扫码开桌接口 ==========
@app.route('/api/table/power', methods=['POST'])
def table_power():
    """用户扫码开桌/关桌接口"""
    data = request.get_json()
    table_number = data.get('table_number')
    action = data.get('action')  # 'on', 'off'
    
    if action == 'on':
        result = controller.power_on(DEVICE_ID, table_number)
        # 可选:点动模式（客户欠费断电例）
        # controller.timed_off(DEVICE_ID, table_number, 60*60*1000)  # 1小时自动断电
        message = f"{table_number}号桌已通电"
    elif action == 'off':
        result = controller.power_off(DEVICE_ID, table_number)
        message = f"{table_number}号桌已断电"
    else:
        return jsonify({"code": 400, "message": "不支持的操作"})
    
    # 记录操作日志
    log_action(table_number, action)
    
    return jsonify({"code": 200 if result else 500, "message": message})

@app.route('/api/table/batch-off', methods=['POST'])
def batch_off():
    """批量关桌（保洁/闭店用）"""
    data = request.get_json()
    tables = data.get('tables', [])  # [1,3,5]
    
    if not tables:
        # 未指定则全关
        result = controller.all_off(DEVICE_ID)
        return jsonify({"code": 200 if result else 500, "message": "全场已断电"})
    
    result = controller.batch_off(DEVICE_ID, tables)
    return jsonify({"code": 200 if result else 500, "message": f"已关闭{table}号桌"})

@app.route('/api/table/restart', methods=['POST'])
def restart_device():
    """故障重启:断电5秒后恢复"""
    data = request.get_json()
    table_number = data.get('table_number')
    
    # 先断电
    controller.power_off(DEVICE_ID, table_number)
    time.sleep(5)
    # 再上电
    result = controller.power_on(DEVICE_ID, table_number)
    
    return jsonify({"code": 200 if result else 500, "message": f"{table_number}号桌已重启"})

# ========== 启动定时任务 ==========
def start_scheduler():
    setup_business_schedule()
    while True:
        schedule.run_pending()
        time.sleep(1)

if __name__ == '__main__':
    scheduler_thread = threading.Thread(target=start_scheduler, daemon=True)
    scheduler_thread.start()
    app.run(host='0.0.0.0', port=5000)

Node.js实现

const crypto = require('crypto');
const https = require('https');
const schedule = require('node-schedule');

class BilliardPowerController {
    constructor(appId, appSecret) {
        this.appId = appId;
        this.appSecret = appSecret;
        this.apiBase = 'https://api.thingboot.com';
    }
    
    md5(str) {
        return crypto.createHash('md5').update(str).digest('hex');
    }
    
    generateSign(ts) {
        const md5Secret = this.md5(this.appSecret);
        return this.md5(md5Secret + ts);
    }
    
    async sendCommand(deviceId, order) {
        const ts = Math.floor(Date.now() / 1000);
        const sign = this.generateSign(ts);
        const url = `${this.apiBase}/${this.appId}/device/control/?sign=${sign}&ts=${ts}`;
        
        const payload = JSON.stringify({
            device: deviceId,
            order: order
        });
        
        return new Promise((resolve, reject) => {
            const options = {
                method: 'POST',
                headers: {
                    'Content-Type': 'application/json',
                    'Content-Length': Buffer.byteLength(payload)
                }
            };
            
            const req = https.request(url, options, (res) => {
                let data = '';
                res.on('data', chunk => data += chunk);
                res.on('end', () => resolve(JSON.parse(data)));
            });
            req.on('error', reject);
            req.write(payload);
            req.end();
        });
    }
    
    async powerOn(deviceId, tableNumber) {
        return this.sendCommand(deviceId, { [`power${tableNumber}`]: 1 });
    }
    
    async powerOff(deviceId, tableNumber) {
        return this.sendCommand(deviceId, { [`power${tableNumber}`]: 0 });
    }
    
    async allOff(deviceId) {
        return this.sendCommand(deviceId, { "batch": { "power": 0 } });
    }
    
    async batchOff(deviceId, tables) {
        return this.sendCommand(deviceId, {
            "batch": { "relay": tables, "power": 0 }
        });
    }
}

// 使用示例
const controller = new BilliardPowerController('YOUR_APP_ID', 'YOUR_APP_SECRET');
const DEVICE_ID = '820720';

// 定时任务:每日23:00全场断电[citation:8]
schedule.scheduleJob('0 23 * * *', () => {
    controller.allOff(DEVICE_ID);
    console.log('闭店时段:全场已断电');
});

// 用户扫码开桌
controller.powerOn(DEVICE_ID, 3);  // 开启3号桌

四、典型应用场景

4.1 用户扫码自动开桌

场景：顾客到达台球室，扫码支付后系统自动开启对应台球桌的扫球机和照明。

4.2 营业时间自动化

事件	时间	动作	说明
开门营业	9:00	全场通电	开启所有设备，预热
午休关电	12:00	关1-4区	节能，保留VIP区使用
午休恢复	13:00	开1-4区	下午场准备
闭店	23:00	全场断电	切断所有电源，节能

4.3 批量分区管理

可将台球桌按区域分组，实现分区管理：

4.4 紧急全场断电

场景：突发事件或结束营业时一键关闭所有设备电源。

五、集成步骤

步骤一：硬件采购与安装

根据桌数确定采购方案（≤8桌用8路控制器，>8桌用分体控制箱）
由电工将控制器安装于配电箱或吧台后方
按桌号接入扫球机和照明设备

步骤二：平台配置

登录
在「开发设置」中获取 AppId 和 AppSecret
为控制器配网，记录设备ID（如820720）

步骤三：后端集成

将上述BilliardPowerController类集成到台球室管理后台
配置营业时间定时任务
对接扫码支付（开桌），对接保洁系统（关桌）

步骤四：部署测试

测试单桌独立控制、批量控制功能
验证定时自动开关效果
测试全场断电（闭店场景）响应

六、总结

优势	说明
8路高集成	一台设备可管8桌，减少设备数量和走线复杂度
批量独立控制	支持单桌、分区、全场三种模式，灵活适配业务场景
定时自动化	营业/闭店自动开关，无需人工干预，节能增效
远程运维	设备死机时远程断电重启，大幅降低上门成本
HTTP开放接口	任何编程语言均可对接，10分钟完成基础集成
即插即用	PDU版本免接线，直接插接；控制器版本导轨安装，与配电箱统一排列
成品控制箱	大型场馆可选24路成品箱，到手即用，无需走线

七、注意事项

负载功率限制 ⚠️：单路阻性负载≤2200W，感性负载（LED/电机）≤350W
总额定功率：全接通时总负载不得超过4400W[阻性]/700W[感性]，请合理分配各桌功率
WiFi信号：确保控制器安装位置WiFi信号良好（仅支持2.4G频段）
定时冗余：配置断网离线保护，避免网络波动影响营业
API响应说明：返回code:200仅表示平台接收指令，不代表设备执行成功
专业安装：涉及强电操作，必须由持证电工按照安全规范安装

通过以上方案，你可以快速将芯步智能控制器集成到共享台球室设备管理系统中，实现单桌独立控制、批量分区管理、营业时间自动化等核心功能，显著提升管理效率并节约能耗。如有疑问，可访问获取详细产品手册和技术支持。

一、解决概述

二、核心技术能力分析

2.1 适用产品选型

2.2 核心命令表

2.3 API接口签名规则

三、共享台球室集成方案

3.1 整体架构

3.2 硬件安装步骤

3.3 代码集成示例

Python实现（推荐用于后端服务）

Node.js实现

四、典型应用场景

4.1 用户扫码自动开桌

4.2 营业时间自动化

4.3 批量分区管理

4.4 紧急全场断电

五、集成步骤

步骤一：硬件采购与安装

步骤二：平台配置

步骤三：后端集成

步骤四：部署测试

六、总结

七、注意事项

插排产品方案：

酒店客房设备机柜电源管理：怎么把8位分控插排接入到自己的项目中

仓储设备机柜电源管理：怎么将8位机柜总控PDU对接到自己的项目中

餐厅设备机柜电源控制：怎样把8位远程控制PDU接入到软件项目中

企业机房机柜设备电源控制：怎么将8位智能分控PDU对接到软件项目中

如何在设备机房远程运维电源管理中对接智能设备以实现故障告警通知

机柜场景方案：

广告机设备机柜电源管理：怎样把智能远程控制8位分控PDU 使用场景接入到自己的项目中

怎样在共享麻将馆设备机柜电源控制中集成智能硬件来实现8路设备电源总控

如何在智能仓储设备机柜电源控制中对接智能设备来实现设备分组控制

便利店设备机柜电源管理：怎么把8位远程控制总控PDU对接到软件项目中

餐厅设备机柜电源控制：怎样把8位远程控制PDU接入到软件项目中

管控用途方案：

如何在共享自习室门禁联动中集成智能硬件以实现设备用电定时管控

怎样接入分控PDU(8位)来实现设备电源批量管控

怎么在设备智能化改造中对接智能设备以实现设备电源批量管控

怎么在社区公共设备机柜电源管理中集成智能设备以实现设备电源批量管控

如何在办公设备照明联动中中接入智能硬件以实现设备用电定时管控