棋牌室无人化改造的核心是包间电源的远程控制,芯步的8路控制器通过HTTP API可实现对麻将机、空调、灯光等设备的独立管控。以下是完整的接入方案,涵盖选型、对接流程和关键代码逻辑。
解决方案:基于芯步8路控制器的棋牌室电源集成方案
1. 设备选型与场景分析
针对棋牌室包间,核心需求是独立控制每个包间的照明、麻将机、空调、排风扇以及门禁锁。芯步的 【智能通用控制器 8路 (UNI-KZQ-TY-8) 】是该项目的最佳选择。
核心优势:提供8路物理继电器输出,意味着一个设备可以管理一个包间内的所有强电设备,无需购买多个单路开关,降低了布线复杂度和成本。
负载匹配:单路最大支持2200W阻性负载,完全覆盖麻将机、换气扇及LED照明;若接入空调,通过控制器驱动交流接触器来带空调,以延长设备寿命。
接口开放:该设备支持标准的HTTP API接口,支持云端和局域网本地控制,响应速度极快(局域网端约50-100ms),适合高并发的订单场景。
2. 硬件部署与接线规划
在你开展项目前,需要先规划好物理接线。假设一个标准棋牌室包间:
| 线路编号 | 推荐负载 | 说明 |
|---|---|---|
| 线路1 | 总照明/LED灯带 | 基础照明 |
| 线路2 | 麻将机 | 核心娱乐设备 |
| 线路3 | 排风扇/吸烟灯 | 空气循环 |
| 线路4 | 空调内机 | 需配合接触器或直接控制(视功率而定) |
| 线路5 | 饮水机/茶具 | 服务型电器 |
| 线路6 | 插座 | 顾客手机充电等 |
| 线路7 | 广告灯箱/门头 | 营业状态展示 |
| 线路8 | 门禁锁电源 | 配合电磁锁,实现订单开始通电开锁,结束断电锁门 |
接线提醒:设备工作电压为DC 12V,需放置在弱电箱或包间吊顶内,强电线(220V)接入控制器输入端,负载线接至输出端。
3. API对接流程与技术实现
芯步的接口采用标准的HTTP POST请求,签名验证机制确保了API调用的安全性。
3.1 前期准备
注册开发者账号:登录芯步官网,进入工作台,获取专属的
AppID和AppSecret。设备配网:通过“物联网控制台”将8路控制器连接至包间WiFi(仅支持2.4GHz),获取设备唯一ID(
device_id)。
3.2 签名算法
为了防止接口被篡改,每次请求需计算签名 sign。公式如下
step1 = md5(AppSecret)
step2 = step1 + ts(ts为当前Unix时间戳)
sign = md5(step2)
3.3 核心控制代码示例
你可以使用任何后端语言(Java、Python、Go、PHP)调用接口。以下是一个通用的控制逻辑示例(伪代码/逻辑描述):
API请求地址https://api.thingboot.com/{AppID}/device/control/?sign={YourSign}&ts={timestamp}
请求参数
场景逻辑:用户下单成功当用户在微信小程序支付包间费用后,你的后端服务需要执行以下操作:
计算签名:使用你的
AppSecret和当前时间戳计算sign。下发开锁指令
通常门禁接在第8路(
power8)。命令:
{“power8”: 1}—— 电磁锁通电,门锁打开,用户进入包间。
下发通电指令
开启照明、空调和新风。
命令:
{“power1”: 1, “power3”: 1, “power4”: 1}
注意:麻将机线路默认通电,因为麻将机本身有开关,用户需要自行按桌上的开关。
场景逻辑:用户订单结束用户点击退场或订单时间耗尽时,执行断电操作:
总清指令:为防止遗漏,可直接下发关闭所有线路的指令。
命令:
{“power1”: 0, “power2”: 0, “power3”: 0, “power4”: 0, “power5”: 0, “power6”: 0, “power7”: 0, “power8”: 0}
二次确认:在断电后延迟1-2秒查询一次设备状态,确保所有电器关闭,避免浪费电费。
3.4 获取设备实时状态
除了控制,你还需要在管理后台看到每个包间灯光的通断状态。
方法:芯步提供了设备状态查询接口(
device/status);如果你的服务器支持,也可以配置设备状态回调,当有人按了墙壁开关的物理按键时,设备会主动上报状态到你的服务器,保持系统同步。
4. 高级功能集成
语音播报提醒:芯步部分8路控制器支持TTS语音功能。当用户还剩15分钟结束时,你的服务器可以通过API发送语音指令给包间控制器。
指令示例:
{“play:gbk:16”:“尊敬的顾客,您的包间时间还剩15分钟,如需续费请扫码。”}
本地局域网控制(高稳定性):如果棋牌室的网络环境不稳定,可以利用设备的局域网API功能。你的本地服务器可以直接通过设备的IP地址发送HTTP指令,不经过云端,响应更快,且外网断网时依然可以控制包间断电。
5. 避坑指南
感性负载问题:电机类设备(麻将机、空调压缩机)属于感性负载,在断电时会产生火花,长时间可能导致继电器触点粘连。严格控制空调线路的功率,若空调功率大于700W,请一定要加装交流接触器。
WiFi信号强度:8路控制器依赖2.4G WiFi。如果包间处于角落或金属门较多,确保信号强度在-60dBm以上,否则可能出现指令超时。
上电状态设置:在芯步控制台中,可以配置“上电状态”。设为恢复断电前状态。这样一旦路由器重启或设备重启,包间不会自动亮灯导致误操作。
通过上述方案,你可以将芯步8路控制器无缝集成到你的棋牌室SaaS系统中,实现从订单支付 -> 开锁 -> 通电 -> 计费 -> 断电的全自动化闭环管理。