共享棋牌室设备机柜电源管理：怎样把8位机柜智能插排对接到软件项目中_解决方案

CATALOG

一、概述

共享棋牌室（无人棋牌室、自助麻将馆）是典型的自助服务场景，设备电源管理直接影响运营效率和用户体验。传统方案中，服务员需要现场送电、设备故障无法远程处理、闭店时容易遗忘关电。芯步8位机柜智能插排（PDU）通过开放HTTP接口，可无缝接入您的棋牌室管理系统，实现8路设备电源的远程集中控制、订单联动启停、定时自动断电等自动化管理功能。

核心能力

8孔位独立分控：单台设备可管理机柜内所有电器（麻将机、空调、照明、排风扇等）
开放HTTP API：适用于任何支持HTTP请求的编程语言，10分钟完成对接
铝合金外壳：1U标准机架式安装，坚固耐用、散热好
私有化部署：支持局域网运行，数据安全可控
无网关设计：WiFi直连，可设定5组WiFi自动切换

棋牌室包间8位电源分配方案

孔位	控制对象	典型功率	管理策略
孔位1	麻将机1	100-200W	订单开始自动开，结束自动关
孔位2	麻将机2	100-200W	同上
孔位3	空调	1500-2500W	订单联动开启
孔位4	照明	50-100W	订单开始自动开
孔位5	排风扇	30-50W	订单开始自动开
孔位6	饮水机/冰柜	500W	常开或定时
孔位7	电视/娱乐设备	100-200W	按需开启
孔位8	备用/音响	-	扩展预留

二、核心产品选型

2.1 8位机柜智能插排规格

芯步提供两款8位机柜智能插排（PDU），可根据棋牌室管理需求选择：

特性	智能PDU[分控]\|8位	智能PDU[总控]\|8位
控制方式	8路独立分控	总控（8路同时控制）
单孔位负载	MAX 2200W（阻性）	MAX 2200W（阻性）
总额定功率	4400W（阻性）/ 700W（感性）	4400W（阻性）/ 700W（感性）
外壳材质	铝合金	铝合金
安装方式	1U标准机架式	1U标准机架式
产品尺寸	宽644mm × 长60.3mm × 厚45.2mm	同左
联网方式	WiFi 2.4GHz	WiFi 2.4GHz
控制接口	HTTP API	HTTP API
私有化部署	支持	支持

数据来源：

⚠️ 选型：棋牌室推荐选择分控版。各设备（麻将机、空调、照明）需要独立控制（如只重启麻将机而不影响空调），因此8路独立分控是更优选择。

2.2 负载能力说明

负载类型	每孔位最大功率	总额定功率	常见设备
阻性负载	2200W	4400W	空调、照明、麻将机
感性负载	350W	700W	LED灯、节能灯

LED灯特殊要求：如果用于LED或节能灯泡，单孔位负载应小于300W

2.3 产品核心优势

本产品开放HTTP接口，适用于任何支持HTTP请求的编程语言。接口简单、清晰、友好，仅需在接口携带签名以及设备ID，即可向设备下发命令。支持接入任何形式的软件项目：Web、APP/小程序、窗体软件以及SaaS/低代码等平台。

其他特性

私有化部署：支持自建消息服务器，可运行在纯局域网环境
无需网关：设备使用WiFi 2.4G无线网络，采用WiFi直接方式，无需网关支持
多网络备份：可设定5组WiFi网络，优先连接信号最强的进行连接
铝合金外壳：坚固耐用、散热好，符合机柜安装标准

三、整体架构

3.1 系统架构图

┌─────────────────────────────────────────────────────────────────┐
│                    棋牌室管理系统 / 小程序后台                    │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐               │
│  │  订单处理   │  │  设备控制   │  │  定时任务   │               │
│  └─────────────┘  └─────────────┘  └─────────────┘               │
└─────────────────────────────────────────────────────────────────┘
                              │
                              │ HTTP API调用（携带签名）
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                     芯步云平台 / 私有化服务器                  │
└─────────────────────────────────────────────────────────────────┘
                              │
                              │ WiFi 2.4GHz
          ┌───────────────────┼───────────────────┐
          │                   │                   │
          ▼                   ▼                   ▼
    ┌──────────┐       ┌──────────┐       ┌──────────┐
    │ 包间A    │       │ 包间B    │       │ 包间C    │
    │ 8位PDU   │       │ 8位PDU   │       │ 8位PDU   │
    │ ┌──────┐ │       │ ┌──────┐ │       │ ┌──────┐ │
    │ │麻将机│ │       │ │麻将机│ │       │ │麻将机│ │
    │ │空调  │ │       │ │空调  │ │       │ │空调  │ │
    │ │照明  │ │       │ │照明  │ │       │ │照明  │ │
    │ │排风扇│ │       │ │排风扇│ │       │ │排风扇│ │
    │ └──────┘ │       │ └──────┘ │       │ └──────┘ │
    └──────────┘       └──────────┘       └──────────┘

3.2 共享棋牌室8位电源分配方案

孔位	控制对象	电源接口	管理策略
孔位1	麻将机1	国标插座	订单开始自动开，结束自动关
孔位2	麻将机2	国标插座	订单开始自动开，结束自动关
孔位3	空调	国标插座	订单开始自动开，结束时由温度策略决定
孔位4	照明	国标插座	订单开始自动开，结束自动关
孔位5	排风扇	国标插座	订单开始自动开
孔位6	饮水机/冰柜	国标插座	常开或营业时段定时
孔位7	电视/娱乐设备	国标插座	按需开启
孔位8	备用/音响	国标插座	扩展预留

参考来源：

四、API接口接入详解

4.1 接口地址与签名计算

请求地址

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 先断后通（设备远程重启）

适用于麻将机死机时的远程复位：

4.2.4 分组管理（多包间批量操作）

通过分组ID控制多个包间的设备，无需维护设备ID列表：

https://api.thingboot.com/{AppID}/group/control/?sign={sign}&ts={ts}

请求示例

分组控制说明参考：

4.2.5 携带业务标识

在命令中携带订单号等业务信息，便于追踪：

extra字段说明：

4.3 多语言代码示例

Python

import requests
import time
import hashlib

class MahjongRoomPowerManager:
    """棋牌室电源管理器（8位PDU）"""
    
    # 孔位编号映射
    PORT_MAP = {
        "mahjong_1": 1,    # 麻将机1
        "mahjong_2": 2,    # 麻将机2
        "ac": 3,           # 空调
        "light": 4,        # 照明
        "fan": 5,          # 排风扇
        "water": 6,        # 饮水机
        "tv": 7,           # 电视
        "reserve": 8       # 备用
    }
    
    def __init__(self, app_id: str, app_secret: str, device_id: str):
        self.app_id = app_id
        self.app_secret = app_secret
        self.device_id = device_id
        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, order: dict) -> dict:
        """发送命令到设备"""
        ts = int(time.time())
        sign = self._generate_sign(ts)
        url = f"{self.base_url}?sign={sign}&ts={ts}"
        payload = {"device": self.device_id, "order": order}
        
        response = requests.post(url, json=payload, timeout=5)
        return response.json()
    
    # ========== 单孔位控制 ==========
    def control_port(self, port_name: str, on: bool) -> dict:
        """控制单个设备"""
        port = self.PORT_MAP.get(port_name)
        if port:
            return self._send_command({f"power{port}": "1" if on else "0"})
        return {"error": "invalid port name"}
    
    # ========== 订单联动（核心功能）==========
    def start_booking(self, duration_minutes: int = 120) -> dict:
        """订单开始:开启包间所有设备"""
        # 开启麻将机、空调、照明、排风扇
        order = {
            "batch": {
                "relay": [1, 2, 3, 4, 5],
                "power": "1"
            }
        }
        result = self._send_command(order)
        
        # 可选:设置订单结束定时关电
        self.schedule_auto_off(duration_minutes)
        
        return result
    
    def end_booking(self) -> dict:
        """订单结束:关闭包间所有设备"""
        order = {
            "batch": {
                "relay": [1, 2, 3, 4, 5],
                "power": "0"
            }
        }
        return self._send_command(order)
    
    # ========== 设备重启 ==========
    def reboot_mahjong(self, port: int = 1) -> dict:
        """远程重启麻将机"""
        return self._send_command({
            "reset": {"relay": [port], "interval": 10000}
        })
    
    def reboot_ac(self) -> dict:
        """远程重启空调"""
        return self._send_command({
            "reset": {"relay": [3], "interval": 15000}
        })
    
    # ========== 批量控制 ==========
    def all_off(self) -> dict:
        """全关所有8路"""
        return self._send_command({
            "batch": {"relay": list(range(1, 9)), "power": "0"}
        })
    
    def schedule_auto_off(self, minutes: int):
        """订单结束后自动关电（业务系统侧实现）"""
        pass

# 使用示例
manager = MahjongRoomPowerManager("your_app_id", "your_app_secret", "pdu_room_101")

# 顾客扫码下单，包间自动通电
manager.start_booking(duration_minutes=120)

# 麻将机死机，远程重启
manager.reboot_mahjong(1)

# 订单结束，自动断电
manager.end_booking()

JavaScript/Node.js

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

class MahjongRoomPowerManager {
    constructor(appId, appSecret, deviceId) {
        this.appId = appId;
        this.appSecret = appSecret;
        this.deviceId = deviceId;
        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(order) {
        const ts = Math.floor(Date.now() / 1000);
        const sign = this._generateSign(ts);
        const url = `${this.baseUrl}?sign=${sign}&ts=${ts}`;
        
        const payload = { device: this.deviceId, order };
        const response = await axios.post(url, payload);
        return response.data;
    }
    
    // 订单开始
    async startBooking() {
        return this.sendCommand({
            batch: { relay: [1,2,3,4,5], power: "1" }
        });
    }
    
    // 订单结束
    async endBooking() {
        return this.sendCommand({
            batch: { relay: [1,2,3,4,5], power: "0" }
        });
    }
    
    // 重启麻将机
    async rebootMahjong(port = 1) {
        return this.sendCommand({
            reset: { relay: [port], interval: 10000 }
        });
    }
    
    // 全关
    async allOff() {
        return this.sendCommand({
            batch: { relay: [1,2,3,4,5,6,7,8], power: "0" }
        });
    }
}

Shell（curl）- 快速测试

五、棋牌室场景实战

5.1 第一种场景：扫码下单自动通电

需求：用户通过小程序预订包间并支付成功后，包间自动通电，设备准备就绪。

实现的方式是：支付回调触发API批量控制

5.2 第二种场景：订单倒计时自动断电

需求：订单时间结束时，自动关闭所有设备电源，防止下一位用户未付费使用。

实现的方式是：业务系统定时任务

5.3 第三种场景：麻将机死机远程重启

需求：麻将机长时间运行后卡死，运维人员远程重启恢复。

实现的方式是reset先断后通命令

5.4 场景四：空调定时启停

需求：根据营业时间自动开关空调，节约能耗。

实现的方式是：平台定时任务

任务名称	执行时间	命令	说明
营业前预冷	09:00	`{"power3":"1"}`	开启空调
午休节能	12:00-13:00	`{"power3":"0"}`	关闭空调
下午开启	13:00	`{"power3":"1"}`	重新开启
闭店关机	23:00	`{"batch":{"relay":[1,2,3,4,5],"power":"0"}}`	全关

5.5 场景五：批量管理多包间

需求：运营人员后台统一查看/控制所有包间设备状态。

六、分组管理（多包间批量操作）

对于连锁棋牌室，可通过设备分组管理功能，通过分组ID实现统一控制。

分组控制接口

https://api.thingboot.com/{AppID}/group/control/?sign={sign}&ts={ts}

请求示例

分组控制说明参考：

分组管理的优势

无需维护设备ID列表，通过分组ID即可控制
支持按楼层、区域组织设备
适合连锁棋牌室大规模部署

七、私有化部署方案

棋牌室运营方对数据安全要求较高，芯步8位PDU支持纯局域网运行。

部署模式对比

特性	公有云模式	私有化模式
设备联网	WiFi连接互联网	连接棋牌室内网WiFi
API地址	`api.thingboot.com`	自建服务器IP
数据流向	经过芯步云端	内网直连，数据不出门店
网络依赖	需要互联网	仅需局域网

私有化配置要点

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

八、设备安装部署指南

8.1 安装要求

项目	要求
安装方式	1U标准机架式安装
工作电压	100-250V AC（交流市电）
单路负载	阻性≤2200W，感性≤350W
总额定功率	4400W（阻性）/ 700W（感性）
网络要求	WiFi 2.4GHz信号覆盖良好
外壳材质	铝合金，分隔式绝缘隔断

8.2 棋牌室包间8路分配

孔位	推荐用途	注意事项
孔位1	麻将机1	接入设备
孔位2	麻将机2	如需两台麻将机
孔位3	空调	注意空调功率，2匹空调约1500-2500W
孔位4	照明	LED灯负载<300W
孔位5	排风扇	感性负载<350W
孔位6	饮水机/冰柜	阻性负载<2200W
孔位7	电视/娱乐设备	按需配置
孔位8	备用/音响	扩展预留

8.3 安装注意事项

LED灯特殊要求：用于LED或节能灯泡时，单孔位负载应小于300W
总额定功率限制：全接通时总负载不得超过4400W
WiFi信号：金属机柜可能屏蔽信号，安装前测试信号强度
机柜安装：标准1U高度，可直接固定于机柜导轨
即插即用：3P插头直接接入市电，无需改线

九、常见问题与排障

问题	可能原因	解决方案
设备不在线	WiFi信号弱	检查2.4GHz WiFi覆盖，设备支持5组WiFi自动切换
单路无输出	负载超限	检查该孔位负载是否超过2200W
总额定功率超限	多设备同时运行	错峰启动大功率设备
命令下发成功但设备无动作	设备离线	200仅表示平台接收，需确认设备在线状态
LED灯闪烁	感性负载超限	LED灯每孔位不超过300W
批量控制部分失败	部分设备离线	确认所有设备在线后再执行批量控制

十、总结

本方案基于芯步8位机柜智能插排（PDU），实现了共享棋牌室的集中电源管理与订单联动控制

能力	实现的方式是
8路独立分控	单设备管理包间内所有电器
扫码下单自动通电	支付回调触发批量控制命令
订单结束自动断电	定时任务+批量控制
设备死机远程重启	`reset`先断后通命令
批量多包间管理	分组控制或设备列表批量操作
定时节能管理	平台定时任务

集成核心步骤

获取AppID/AppSecret，实现MD5签名算法
根据棋牌室包间规划8路孔位分配
开发HTTP调用模块，封装订单联动逻辑
配置定时任务或对接预约系统
物理安装PDU至机柜

方案优势

✅ 8路独立分控：单设备管理棋牌室包间所有电器
✅ 接口统一：标准HTTP API，10分钟完成对接
✅ 订单全流程联动：从下单到离店自动化管理
✅ 铝合金外壳：1U机架式安装，坚固耐用散热好
✅ 多种控制模式：通断、批量、重启，适配全场景
✅ 私有化支持：数据安全可控，适合连锁门店部署

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