[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~power4、batch、point、reset、get_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 )
签名计算步骤
对AppSecret进行第一次MD5加密,得到32位小写字符串
将结果与时间戳ts拼接(直接拼接,无分隔符)
对拼接后的字符串进行第二次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 --> E24.2 硬件定时 vs 软件定时
| 方案 | 实现的方式是 | 优点 | 缺点 |
|---|---|---|---|
| 硬件定时(point) | 设备内置定时器 | 无需软件服务参与,即使服务器宕机也能按时断电 | 需设备支持 |
| 软件定时 | 服务端调度器 | 灵活,支持复杂逻辑 | 依赖服务持续运行 |
本方案推荐:优先使用point命令实现硬件定时断电,配合软件定时器实现预约时段管理、预冷预热等高级功能。
4.3 point命令详解
point命令是芯步控制器的核心定时功能
命令格式
使用方式
先通过
power1、power2命令通电再下发
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 订单驱动场景:扫码入场自动通电 + 定时断电
业务流程
用户扫码选择球桌并支付
系统自动开启该桌灯光和空调
同时设置
point定时断电时间到自动断电,无需人工干预
核心代码
5.2 预约时段联动场景:预订时间自动开启/关闭
业务流程
用户通过小程序预订未来时段
系统记录预订信息
预订开始前5分钟自动预开空调
预订开始时自动开启灯光
预订结束时自动断电
核心代码
5.3 订单超时告警场景
业务流程
检测到超时未关设备时自动告警
运营人员可远程介入处理
核心代码
第六章:部署与故障排查
6.1 台球室部署
| 部署要点 | 推荐方案 | 说明 |
|---|---|---|
| 控制器安装 | 配电箱内/球桌附近 | 便于接线和维护 |
| 网络要求 | 2.4GHz WiFi | 设备仅支持2.4GHz频段 |
| 灯光控制 | 第1路接LED灯 | 感性负载≤350W |
| 空调控制 | 第2路加交流接触器 | 大功率空调需扩展 |
| 天线选择 | 外置天线版 | 金属配电箱信号屏蔽 |
6.2 常见问题排查
| 现象 | 可能原因 | 解决方案 |
|---|---|---|
| 设备离线 | 1. DC 5V电源断开2. WiFi密码错误/信号弱3. 路由器禁用了MAC | 1. 检查供电2. 重新配网3. 检查路由器白名单 |
| 接口返回403 | 1. 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路输出接入交流接触器线圈
空调电源线通过接触器主触点
控制器仅提供小电流控制信号,接触器负责大电流通断
第七章:总结
通过将芯步智能控制器接入台球室管理系统,可以构建“订单驱动、定时控制、节能高效”的智能化灯光空调管理体系。
核心要点回顾
硬件选型:智能控制器4路,第1路接灯光(LED≤350W),第2路接空调
核心技术
point命令实现硬件定时断电,无需软件定时器核心命令
power1开灯、power2开空调、point延时断电、get_status状态查询签名安全
Sign = md5(md5(AppSecret) + ts),双重MD5保障场景覆盖:订单开始通电+定时断电、预约时段联动、订单超时告警
对接工作量评估:熟悉HTTP接口的开发者可在2小时内完成基础功能对接。
台球室运营收益
无人值守:实现24小时自助,人力成本降低
节能降耗:订单结束自动断电,预计节省电费30%以上
用户体验:预约时段自动开启,到场即享舒适环境
远程运维:支持远程状态查询和异常处理
让每一张台球桌的灯光和空调都“听话”——用户入场即开、离开现场时即关、智能定时、高效节能,这是物联网赋能共享台球室的核心价值。