4路包间电源控制器MINI是专为棋牌室、茶室等场景设计的设备，通过HTTP API可实现对灯光、插座、门禁、空调的远程独立控制。以下方案涵盖硬件准备、接口对接、命令调用和常见场景示例，帮助快速完成项目集成。

解决方案：4路智能包间电源控制器MINI项目对接指南

1. 产品理解与场景定义

在开始对接前，需要明确“4路智能包间电源控制器MINI”的硬件特性，以便在后端设计中定义好设备ID与具体业务的映射关系。

• 核心参数

  • 第1路：16A继电器，通常控制照明、换气扇。

  • 第2路：16A插座，控制麻将机、饮水机等插座电源。

  • 第3路：10A门禁专用，配合12V电磁锁实现远程开门。

  • 第4路：30A大功率，专门用于2匹空调的启停。

  • 通信方式：WiFi 2.4GHz，无需网关，直连路由器。

• 适用场景：共享棋牌室、自助茶室、琴房、自习室等无人值守场景。

2. 对接准备与配置

在编写代码之前，需要进行环境配置，获取关键的密钥信息。

• 账号注册与工作台创建访问芯步官网注册账号，并创建“工作台”。在工作台内进入“物联网控制台”模块。

• 设备配网给控制器接电。通过“物联网控制台”或官方配网工具，将设备连接到所在场所的2.4G WiFi网络。记录下分配给该设备的唯一 Device ID（例如：1878）。

• 获取开发者凭证在控制台的“开发设置”中，获取 AppID 和 AppSecret（开发者密码）。这是调用接口的钥匙。

  • 调试技巧：开发阶段可开启“调试模式”，此时系统会暂时忽略签名校验，方便先用Postman测试连通性。

3. 接口鉴权与请求封装

芯步的开放接口基于HTTP协议，签名算法简单且安全性高，适用于任何能发起HTTP请求的后端语言（Java, Python, PHP, Node.js等）。

• 请求地址https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}

• 鉴权机制签名(sign) 生成规则为：sign = md5( md5(AppSecret) + ts )

  • ts：当前的Unix时间戳（秒）。

  • 注意：需将AppSecret进行第一次MD5加密，得到字符串拼接上ts，再进行第二次MD5。

• 请求体： 通过POST发送JSON数据，包含device和order字段。

4. 核心API命令详解

该控制器通过标准的JSON命令控制，完全基于HTTP接口，无其他依赖。

4.1 单路独立控制这是最常用的功能，直接指定线路进行开关。

• 开灯/接通第1路： {"power1": 1}

• 关麻将机/断开第2路： {"power2": 0}

• 关空调/断开第4路： {"power4": 0}

4.2 高级场景控制通过高级指令，可以实现更丰富的自动化逻辑，无需客户端处理计时器。

• 批量控制：一键全开或全关包间电源。

  • {"power": 1} （全开1-4路）

  • {"power": 0} （全关）

• 临时断电复位：用于门禁或特殊设备的重启。例如：断开第3路2秒钟后自动闭合。

  • {"reset": {"relay": [3], "interval": 2000}}

• 先通后断：用于门禁控制（刷卡开门后保持通电再断电）。

  • {"point": {"relay": [3], "interval": 500}}

• TTS语音播报：仅限TTS版本。当有新订单或顾客呼叫时，包间喇叭可播报提醒。

  • {"play:gbk:16": "您好，您的服务时间还剩15分钟"}

5. 项目对接实战步骤

第一步：后端服务层封装（伪代码逻辑）在后端封装一个通用函数，便于业务层调用。

第二步：业务逻辑集成

1. 上电初始化：每天早上系统自动执行全开操作（{"power": 1}），打开所有包间设备，保证麻将机、路由器通电。

2. 订单开始：用户在小程序下单支付成功 -> 后端调用接口给对应包间的电磁锁供电（{"power3": 1}），用户推门进入。

3. 运行中监测：用户点击“呼叫服务” -> 后端调用TTS接口（该包间控制器播报“服务员请到888房”）。

4. 订单结束（无人值守）

   • 空调延时关闭：用户点击退租 -> 后端调用空调关闭（{"power4": 0}），并记录。

   • 门禁策略：若系统判断订单结束，执行复位命令（{"reset": {"relay": [3], "interval": 1000}}），让门锁断开一秒后复原，强制顾客离开房间无法再进入。

   • 全关：确认为空房后，调用全关（{"power": 0}），切断麻将机和灯光，节能省电。

6. 高级架构与私有化部署

对于注重网络安全或网络隔离的场所（如高端会所、政务休息室），芯步支持局域网与私有化部署。

• 局域网IP直连：设备在局域网内会获得本地IP，支持直接通过内网IP调用API，命令响应可低至80ms-120ms，且不占用公网带宽。

• 本地服务器接收：代码中的api.thingboot.com可替换为设备在局域网内的IP地址，实现纯内网环境运行。

7. 常见问题排查

1. 设备离线

   • 排查：检查控制器旁绿色指示灯状态。确认现场WiFi是2.4G频段（5G不支持）。查看网络是否需MAC地址认证。

2. 签名错误

   • 排查：核对AppSecret无多余空格。确认时间戳是秒级（毫秒会导致失败）。

3. 第3路接门锁不动作

   • 排查：第3路为直流输出，需确认电磁锁是DC 12V/24V且控制器电源匹配。普通220V电插锁需加转换器。

4. 空调无法启动

   • 排查：检查空调插座是否接到第4路（30A）。若空调功率超3500W需加交流接触器。

8. 总结

通过上述方案，开发人员可以在很短时间内完成“4路智能包间电源控制器MINI”的对接。该方案的核心优势在于：

1. 开发门槛低：标准HTTP协议 + 简单的MD5签名，任意后端语言均可快速集成。

2. 业务覆盖全：从灯光、插座到大功率空调和门禁，一机解决所有包间设备控制。

3. 无人值守闭环：结合“复位”命令和TTS语音，完美实现自助消费的“开门-消费-断电-关门”全自动化流程。