CATALOG

芯步的智能硬件以开放HTTP API为核心优势,这意味着你无需集成复杂的SDK,任何后端语言(Java、Python、PHP、Node.js等)都能直接调用。以下方案基于其智能插座/控制器的标准接口规范展开。

1. 行业痛点与解决概述

在共享麻将馆(无人棋牌室)的运营中,痛点在于“电控管理”:用户扫码下单后需自动通电、时间快到时提醒、超时自动断电。传统的人工管理模式效率低且浪费电力。

本方案基于芯步智能插座/插排的开放接口能力,将8位机柜智能插排无缝集成到你的共享棋牌室项目中。通过HTTP请求,实现对麻将机、空调、饮水机、灯光等设备的独立远程控制,达到“人在电通,人走电断”的无人值守效果

2. 硬件选型与组网拓扑

2.1 硬件:8位机柜智能插排

虽然芯步官网典型产品包含4路控制器和16A单路插座,但其硬件系列共享同一套API协议(UNI系列)。

  • 推荐型号:选择支持“8路分控”的智能插排。

  • 关键参数:每路需支持独立开关控制、具备电量计量功能、支持2500W以上功率(麻将机+空调负载较大)。

  • 设备标识:每个设备(Device)拥有唯一的Device IDAPI Key

2.2 组网结构

  1. 设备层:8位插排接入WiFi 2.4G网络(芯步设备直连WiFi,无需网关,降低部署成本)

  2. 云层:芯步开放API服务器(或私有化部署的服务器)。

  3. 业务层:你的共享棋牌室后端服务器(Java/PHP/Node.js)。

  4. 控制端:用户小程序/管理后台。

数据流用户点击小程序 -> 业务后端 -> 芯步开放API -> 云端指令下发 -> WiFi插排 -> 继电器吸合 -> 麻将机通电

3. 核心对接流程与技术实现

芯步接口最大的便捷性在于采用HTTP协议签名机制,无需复杂的MQTT Broker配置(当然也支持MQTT,视具体型号而定,HTTP对接速度最快)。

3.1 准备工作:接口签名机制

芯步的开放接口通常采用签名认证。在发送任何控制命令前,需要按照规则生成sign签名算法参考(基于通用实践,具体需查阅随附文档):

  • 组合参数:DeviceID + Timestamp + AccessToken/SecretKey

  • 加密方式:MD5或SHA-1。

3.2 关键接口调用实例(伪代码逻辑)

假设我们需要控制插排的第3号插口(麻将机)。你需要调用设备控制接口 /ordercontrol

请求示例

业务逻辑映射

  • 用户下单status: 1 -> 给对应包间的插排对应通道通电。

  • 用户退单/断电status: 0 -> 切断电源。

  • 强制断电/清洁:在订单间隙,调用status: 0切断总闸,防止顾客私接大功率电器。

4. 业务系统集成实战(针对共享麻将馆)

为了达到商用级别,仅会开关是不够的,你需要实现以下高级集成策略

4.1 动态参数读取与能耗监控

芯步电表系列(如UNI-CZ-16A-P)支持读取实时电流电压

  • 场景:通过接口/orderquery获取当前麻将机的实时功率。

  • 应用

    • 如果麻将机已关机但功率仍>50W(说明可能有人在用手机充电或其他不正规用电)或 =0W(设备故障),系统可自动预警或强制断电。

4.2 定时任务与联动策略

在你去对接项目的过程中,可能不需要实时保持长连接,可以利用芯步设备支持的“定时任务”功能或由你的服务器定时下发指令

  • 临提醒:在订单结束前10分钟,你的服务器通过接口发送指令,让插排上的语音播报模块(如果有)或通过你的小程序提醒用户,而非直接断电。

  • 强切策略:当订单时间归零时,调用接口直接切断通道3(麻将机)通道4(空调),但暂时保留通道1(照明) 2分钟,以便用户收拾离开现场时。

4.3 设备状态同步机制

由于WiFi设备可能偶尔出现网络抖动,必须处理“指令下发成功但执行失败”的情况。

  • 解决方案:调用芯步接口后,不要立即认为设备已动作。

  • 需调用 查询接口 确认状态,或者通过回调/Webhook机制(芯步支持将设备状态变更主动推送到你的服务器),更新你数据库中的device_status字段。

5. 常见问题与排障指南

在对接8位机柜插排到项目的过程中,可能会遇到以下具体问题:

5.1 关于“8位”的具体实现

  • 现象:接口文档只提到了单路控制,怎么控制8位?

  • 解决:芯步的8位插排在逻辑上被视为 “1个设备,8个端点(Endpoint)” 。在API调用中,device_id保持不变,通过channeloutlet_id参数来区分控制哪一个孔位。如果使用的是Modbus RTU over TCP协议,则需要关注寄存器地址(参考类似DL/T645或Modbus协议的结构)

5.2 网络配网问题

  • 场景:共享棋牌室往往分布在多个包厢,2.4G WiFi信号干扰大。

  • :确保每个机柜位置信号强度在-60dBm以上。利用芯步设备的5组WiFi备份功能,预置多个AP名称,以防某一路由器宕机设备掉线

5.3 私有化部署(局域网)

  • 如果你的项目注重内网安全性:芯步支持私有化部署,这意味着你的后端服务器可以直接通过网线连接交换机,与插排处于同一局域网段进行HTTP通信,完全不经过外网,极大降低控制延迟并提高安全性。

6. 总结

将芯步8位智能插排接入共享麻将馆项目,核心逻辑在于利用其标准的HTTP API将传统的物理按键操作转化为代码指令。

对接步骤总结

  1. 硬件就绪:设备上电联网,记录Device ID。

  2. 签名验证:在后端实现签名算法。

  3. 一对一映射:将数据库中的Room_IDDevice_IDChannel绑定。

  4. 业务融合:在订单StartEnd的钩子函数中,精确调用断电/通电指令。

通过上述方案,你可以快速实现“扫码通电-定时断电-远程运维”的完整闭环。