芯步的智能包间控制器Mini通过开放HTTP接口，支持远程状态监测和四路独立控制。以下方案涵盖了从接口对接、状态上报到业务落地的完整流程。

解决方案：基于芯步开放接口的包间设备远程状态监测系统

1. 概述

本方案的目标是利用芯步智能包间控制器Mini（型号UNI-KZQ-BJ-MINI） 的开放API接口，构建一套对包间内主要用电设备进行远程状态监测与控制的系统。

通过对接该控制器，运营方可以实时获取包间内4路电路的通断状态（如照明、麻将机、门锁、空调的开关情况），并实现远程控制与异常报警。

2. 硬件与接口能力分析

智能包间控制器Mini提供4路独立电路，具体对接监测能力如下表所示：

开放接口优势

• 通用性：支持任何支持HTTP请求的编程语言（如Python、Java、PHP、Go等）及SaaS平台。

• 网络适应性：支持WiFi 2.4G直连，且支持纯局域网或私有化部署，保障数据安全。

3. 状态监测的实现机制

要实现“远程状态监测”，核心在于两点：主动查询与被动接收。

3.1 实时状态查询

系统可通过API主动向设备下发查询指令，或读取设备当前上报的状态。

• 技术实现：调用芯步的通用控制接口，通过传入特定参数获取设备信息。

• 请求示例POST https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

• 参数详情

  • device: 目标包间的Mini控制器唯一ID。

  • order: 封装为JSON的指令，例如查询所有线路状态可使用{"status":"1"}或类似的读取指令（具体参照设备上下行定义）。

3.2 状态变更实时推送

为了实现对包间设备的“实时”监测，避免频繁轮询造成的服务器压力，配置消息推送机制。

• 推送逻辑：当包间内的设备状态发生变化时，例如顾客通过物理按键关闭了麻将机，或者定时任务触发了关灯，设备会将状态变化上报至云端，云端立即转发至开发者设置的服务器地址。

• 数据格式

  { "device": "设备ID", "type": "state", "message": { "mid": "消息唯一ID", "data": [ { "power2": "0" // 表明第2路电源已关闭 } ], "ts": "1656416279506" } }

• 应用场景

  • 门磁状态监测：当顾客扫码开门或关门离开时，第3路门锁状态变化会立即推送到系统，系统据此更新房间的“空闲/占用”状态。

  • 设备异常监测：如果某路电路负载过大导致自动断电，系统能立即收到推送并通知管理员。

4. 解决方案详细设计：以无人棋牌室场景为例

以下以“共享棋牌室”场景为例，阐述如何利用接口实现具体的状态监测与联动。

4.1 系统架构

1. 设备层：各包间部署Mini控制器（控制照明、麻将机、空调、门锁）及传感器。

2. 云平台层：芯步云平台（负责设备连接、消息转发、API鉴权）。

3. 业务层：商家的SaaS管理系统（接收Webhook推送，下发控制指令，处理业务逻辑）。

4.2 关键业务流程与接口对接逻辑

步骤一：用户下单与授权

• 动作：用户在小程序下单，支付成功。

• 业务系统响应：系统调用control接口，下发开门指令。

• 接口指令

  { "device": "room_A_controller", "order": {"power3": 1} // 第3路电磁锁通电，断电开锁（或反之，取决于锁类型） }

步骤二：全屋设备状态监测与自检

• 动作：用户进入包间。

• 业务逻辑：系统后台此时可调用查询接口，拉取当前该设备所有线路的状态。

• 监测点

  • 检测power1（照明）是否正常启动。

  • 检测power2（麻将机）是否通电待机。

  • 若某线路状态与预设“应通电”状态不符，系统自动补发指令或推送“设备离线/故障”告警给管理员。

步骤三：使用中的远程监控与断网重连

• 场景：用户中途打电话要求关闭空调（第4路）。

• 操作路径：客服后台点击“关闭空调” -> 调用API。

• 指令示例

  {"batch": {"relay": [4], "power": 0}}

• 状态回执：设备执行成功后，云端通过消息推送告知系统“第4路已断开”。若网络波动，Mini控制器内置的5组WiFi机制会自动重连，确保状态最终一致。

步骤四：订单结束与自动断电

• 触发：订单倒计时结束。

• 业务系统响应

  1. 下发指令关闭所有电器：{"batch": {"relay": [1,2,4], "power": 0}}。

  2. 下发指令锁门：{"power3": 0}。

• 最终状态监测：系统收到{"power3": 0}的推送反馈，确认门已锁好。界面显示该包间状态变为“空闲/待清洁”。

4.3 增值监测：语音播报状态确认

对于带TTS版本的Mini控制器，当系统下发语音指令时，虽然无法直接通过数据包知道“顾客是否听到了”，但可以通过逻辑监测：

• 指令下发监测：系统成功调用接口下发{"play":"请勿吸烟"}，接口返回成功，表明语音数据已送达设备缓存。

• 心跳监测：若设备处于在线状态，即表明其具备播报能力。

5. 开发对接注意事项

在开发对接过程中，为确保状态监测的准确性，需注意以下技术细节：

1. 签名机制

   • 所有API请求必须携带动态签名。

   • 算法Sign = md5( md5(AppSecret) + ts )。

   • 注意：时间戳ts的有效性通常有几分钟的窗口期，需确保服务器时间与标准时间同步，避免签名失效。

2. 心跳维护

   • 虽然设备会主动推送状态，但业务系统定期（如每5分钟）通过API轮询一次设备状态作为兜底机制，以防网络波动导致Webhook漏推。

3. 门锁逻辑测试

   • 第3路门禁接口逻辑需严格测试。通常电磁锁是“断电开锁”，而电插锁可能是“断电上锁”。请根据购买的五金件规格，明确power3:1代表锁门还是开门。

4. 私有化部署

   • 如果对数据隐私要求比较高（如政府项目或高端会所），可以利用其私有化特性。将消息服务器地址指向本地服务器，所有状态数据不经过公网，仅在局域网内传输。

通过以上方案，开发者可以快速利用芯步Mini控制器的开放接口，实现从“单纯控制”到“可监可控”的智能化升级。