CATALOG

[45280] 文档版本:V1.0 更新日期:2026年5月 适用对象:软件工程师、台球室运营方、物联网设备集成商

第一章:共享台球室场景需求与产品选型

1.1 台球室灯光空调控制的运营挑战

共享台球室作为无人值守经营场景,灯光和空调的智能控制是保障用户体验和节能降耗的核心环节。传统管理模式面临以下痛点:

痛点具体表现带来的影响
离开现场时忘关设备用户打完球离开时忘记关灯关空调电费持续消耗,运营成本增加
人工管理低效需工作人员逐间巡查关灯关空调无法实现24小时无人值守
预约时段管理难用户预约时段与实际使用时长不匹配超时占用影响后续用户
环境体验不佳用户入场时空调未提前开启夏天闷热、冬天寒冷影响体验

1.2 解决方案:智能控制器实现定时任务自动化控制

芯步智能控制器通过HTTP接口与台球室管理软件对接,实现“订单开始自动通电→时段结束自动断电→预约时段联动控制”的完整自动化闭环。

核心价值

  • 定时任务自动化:支持point命令硬件定时断电,无需软件定时器

  • 两路独立控制:第1路灯光 + 第2路空调,互不干扰

  • 开放HTTP接口:适用于任何支持HTTP请求的编程语言

  • 节能降耗:杜绝离开现场时忘关导致的能源浪费

  • 私有化部署:支持纯局域网运行,数据不出店

1.3 芯步智能控制器核心参数

针对台球室两路灯光空调控制场景,推荐使用智能控制器4路2路智能墙壁开关

方案一:智能控制器4路(推荐)

参数项规格详情
产品型号UNI-KZQ-AC-4(交流电压版)
控制路数4路独立控制(使用其中2路)
工作电压AC 85-265V(市电)
单路额定电流MAX 10A
单路阻性负载2200W(白炽灯等)
单路感性负载350W(LED灯、空调等⚠️)
总负载功率4路总和不超过2500W
无线连接WiFi 2.4GHz
支持命令power1~power4batchpointresetget_status

版本对比

设备路数空调适用性推荐场景
智能控制器4路4路第1-4路均可接需要多路独立控制
智能墙壁开关2路2路每路10A仅灯光+空调两路

⚠️ 功率重要提示:空调属于感性负载,启动电流可达额定电流5-7倍。控制器单路感性负载限制为350W,仅适用于1匹以下小功率空调。若使用大功率空调,搭配交流接触器扩展控制能力。LED灯光同样属于感性负载,每路LED灯功率需控制在350W以内。

1.4 推荐通道分配

┌─────────────────────────────────────────────┐
│           智能控制器4路                      │
├─────────────────────────────────────────────┤
│  第1路 ──────► 台球桌照明灯(LED灯)         │
│  第2路 ──────► 空调(小功率/加接触器)        │
│  第3路 ──────► 备用                         │
│  第4路 ──────► 备用                         │
└─────────────────────────────────────────────┘

第二章:HTTP接口协议详解

2.1 整体架构

芯步智能控制器采用标准的HTTP请求-响应模型,适用于任何支持HTTP请求的编程语言,可无缝接入小程序、管理后台等系统。

性能指标:从命令下发到设备响应,端到端延迟约为80-120ms

2.2 请求地址与签名算法

请求地址格式

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

签名算法(核心安全机制)

Sign = md5( md5(AppSecret) + ts )

签名计算步骤

  1. 对AppSecret进行第一次MD5加密,得到32位小写字符串

  2. 将结果与时间戳ts拼接(直接拼接,无分隔符)

  3. 对拼接后的字符串进行第二次MD5加密

Python示例

2.3 核心命令集

智能控制器支持以下核心命令

命令类型命令示例说明台球室应用
开启灯光{"power1":"1"}开启第1路用户入场开灯
关闭灯光{"power1":"0"}关闭第1路订单结束关灯
开启空调{"power2":"1"}开启第2路用户入场开空调
定时断电{"point":{"relay":[1,2],"interval":3600000}}1小时后自动断电订单结束自动关
批量控制{"batch":{"relay":[1,2],"power":"1"}}同时开启两路一键开启场景
状态查询{"get_status":""}查询所有路状态运营监控

第三章:多语言代码实现

3.1 完整Python实现

3.2 Node.js实现

第四章:定时任务系统详细设计

4.1 定时任务架构图

graph TB
    subgraph 触发源
        A1[订单开始事件]
        A2[预订时间到达]
        A3[运营定时策略]
        A4[用户手动操作]
    end
    
    subgraph 任务调度层
        B[定时任务引擎]
        B1[point硬件定时]
        B2[软件调度器]
        B3[Cron表达式]
    end
    
    subgraph 设备控制层
        C[芯步API]
        D[智能控制器]
    end
    
    subgraph 执行层
        E1[灯光ON/OFF]
        E2[空调ON/OFF]
    end
    
    A1 --> B
    A2 --> B
    A3 --> B
    A4 --> B
    B --> C
    C --> D
    D --> E1
    D --> E2

4.2 硬件定时 vs 软件定时

方案实现的方式是优点缺点
硬件定时(point)设备内置定时器无需软件服务参与,即使服务器宕机也能按时断电需设备支持
软件定时服务端调度器灵活,支持复杂逻辑依赖服务持续运行

本方案推荐:优先使用point命令实现硬件定时断电,配合软件定时器实现预约时段管理、预冷预热等高级功能。

4.3 point命令详解

point命令是芯步控制器的核心定时功能

命令格式

使用方式

  • 先通过power1power2命令通电

  • 再下发point命令设置自动断电时间

  • 设备硬件定时,无需软件定时任务或后端队列

4.4 每日定时开关策略

4.5 订单驱动的定时控制流程

sequenceDiagram
    participant User as 用户
    participant App as 小程序
    participant PMS as 预订系统
    participant Device as 智能控制器
    
    User->>App: 扫码选桌支付
    App->>PMS: 确认订单(90分钟)
    PMS->>Device: 通电(point:90分钟)
    Device-->>PMS: 通电成功
    PMS-->>App: 订单成功
    Device->>Device: 90分钟后自动断电
    
    Note over User: 使用30分钟后...
    
    User->>App: 点击续费30分钟
    App->>PMS: 续费请求
    PMS->>Device: 重新计算延时(剩余60+30分钟)
    Device-->>PMS: 更新定时成功

第五章:台球室业务场景集成

5.1 订单驱动场景:扫码入场自动通电 + 定时断电

业务流程

  1. 用户扫码选择球桌并支付

  2. 系统自动开启该桌灯光和空调

  3. 同时设置point定时断电

  4. 时间到自动断电,无需人工干预

核心代码

5.2 预约时段联动场景:预订时间自动开启/关闭

业务流程

  1. 用户通过小程序预订未来时段

  2. 系统记录预订信息

  3. 预订开始前5分钟自动预开空调

  4. 预订开始时自动开启灯光

  5. 预订结束时自动断电

核心代码

5.3 订单超时告警场景

业务流程

  • 检测到超时未关设备时自动告警

  • 运营人员可远程介入处理

核心代码

第六章:部署与故障排查

6.1 台球室部署

部署要点推荐方案说明
控制器安装配电箱内/球桌附近便于接线和维护
网络要求2.4GHz WiFi设备仅支持2.4GHz频段
灯光控制第1路接LED灯感性负载≤350W
空调控制第2路加交流接触器大功率空调需扩展
天线选择外置天线版金属配电箱信号屏蔽

6.2 常见问题排查

现象可能原因解决方案
设备离线1. DC 5V电源断开2. WiFi密码错误/信号弱3. 路由器禁用了MAC1. 检查供电2. 重新配网3. 检查路由器白名单
接口返回4031. AppSecret错误2. 签名计算错误3. ts与服务端时间偏差>5分钟1. 核对AppSecret2. 确认MD5为32位小写3. 同步NTP时间
控制成功但空调不工作1. 感性负载功率超限2. 未配交流接触器1. 确认空调功率2. 加装交流接触器
定时断电不生效point命令格式错误确认point.interval单位正确(毫秒)

6.3 功率扩展方案

如果空调功率较大,需要使用交流接触器扩展

graph LR
    A[智能控制器] -->|控制信号| B[交流接触器线圈]
    B -->|触点闭合| C[空调电源]
    D[市电] --> B
    B --> C

接线要点:

  • 控制器第2路输出接入交流接触器线圈

  • 空调电源线通过接触器主触点

  • 控制器仅提供小电流控制信号,接触器负责大电流通断

第七章:总结

通过将芯步智能控制器接入台球室管理系统,可以构建“订单驱动、定时控制、节能高效”的智能化灯光空调管理体系。

核心要点回顾

  1. 硬件选型:智能控制器4路,第1路接灯光(LED≤350W),第2路接空调

  2. 核心技术point命令实现硬件定时断电,无需软件定时器

  3. 核心命令power1开灯、power2开空调、point延时断电、get_status状态查询

  4. 签名安全Sign = md5(md5(AppSecret) + ts),双重MD5保障

  5. 场景覆盖:订单开始通电+定时断电、预约时段联动、订单超时告警

对接工作量评估:熟悉HTTP接口的开发者可在2小时内完成基础功能对接。

台球室运营收益

  • 无人值守:实现24小时自助,人力成本降低

  • 节能降耗:订单结束自动断电,预计节省电费30%以上

  • 用户体验:预约时段自动开启,到场即享舒适环境

  • 远程运维:支持远程状态查询和异常处理

让每一张台球桌的灯光和空调都“听话”——用户入场即开、离开现场时即关、智能定时、高效节能,这是物联网赋能共享台球室的核心价值。

控制器产品方案:
如何接入共享空间智能控制器以实现自定义联动操作
查看 >>
如何二次开发4 路智能照明控制器来实现定时开关照明设备电源
查看 >>
怎样在无人值守包间设备控制中接入智能设备以实现HTTP接口远程独立控制通断
查看 >>
舞蹈练习室设备管理:如何将8路包间场景联动控制器对接到自己的项目中
查看 >>
无人售货机两路设备控制:如何把智能2路交流远程控制模块集成到软件项目中
查看 >>
两路场景方案:
怎么在智慧教室两路灯光设备控制中对接智能设备以实现定时任务启停控制
查看 >>
怎么在小型商铺照明管理中对接智能设备来实现两路照明设备控制
查看 >>
自助洗车设备两路电源管理:怎样将智能2路交流回路控制器接入到软件项目中
查看 >>
共享茶室两路设备电源管理:如何将智能控制器2路|交流电压版集成到项目中
查看 >>
怎么在共享充电站照明管理中接入智能设备以实现两路照明一路门禁控制
查看 >>
启停用途方案:
怎样二次开发智能分体控制箱8路来实现定时自动启停控制
查看 >>
怎样在共享茶室三路设备电源管理中对接智能设备来实现定时任务集中启停控制
查看 >>
怎样在共享桌游室灯光控制中接入智能设备以实现定时自动启停控制
查看 >>
如何在共享台球室两路灯光空调控制中集成智能硬件来实现定时任务启停控制
查看 >>
如何对接智能2路交流开关控制器以实现定时任务启停控制
查看 >>