基于芯步 MINI 控制器的硬件特性与开放 API，这套方案的核心思路是：将硬件指令抽象为业务动作，用状态机管理设备生命周期，并通过签名机制保障通信安全。
以下是针对“门店包间设备电源管理”的详细接入方案。
1. 背景与目标
在服务型门店（如棋牌室、茶室、影院足道、自习室）的运营中，包间空调、麻将机、照明等设备常存在“空转”现象——顾客离开现场时后设备未关、非营业时段待机耗电，导致电费居高不下。同时，店员手动巡检关电耗时费力，尤其在夜间或客流高峰，管理极易出现疏漏。
核心目标：
精细化分路控制：将照明、麻将机、门锁、空调接入不同线路，实现独立远程通断。
事件联动：配合订单系统，实现“订单开始即通电，订单结束即断电”的自动化。
节能：杜绝包间无人时的设备空耗，预期降低电费支出20%-30%。
2. 硬件核心能力：MINI 控制器的四路分工
本方案选用 芯步智能包间控制器 MINI，其核心优势在于负载能力强、接口标准，无需改造现有线路。具体四路配置如下：
| 线路编号 | 接口类型 | 负载上限 | 接入设备 | 业务逻辑 |
|---|---|---|---|---|
| 第1路 | 16A 开关 | 3500W | 照明、换气扇、灯带 | 入座即亮，离座即灭 |
| 第2路 | 16A 插座 | 3500W | 麻将机、饮水机、按摩椅 | 订单开始供电，结束强断 |
| 第3路 | 10A 门禁 | 2200W | 电插锁、电磁锁（门禁） | 配合室内传感器实现无人自动落锁 |
| 第4路 | 30A 插座 | 6600W | 2匹空调、取暖器 | 重点管控，离开现场时强制关闭防浪费 |
特性说明：设备支持 WiFi 2.4G 直连，无需网关，且开放 HTTP API 接口，可直接与您的后台或小程序通信 。
3. 软件接入方案：API 调用详解
将 MINI 控制器集成到现有软件项目（如门店管理后台、小程序、SaaS系统）中，主要分为 “指令下发” 和 “状态回调” 两部分。
3.1 鉴权机制与请求流程
为了防止接口被恶意调用，芯步采用了 动态签名 机制。每次请求都需要实时计算 Sign。
签名生成规则（Pseudocode）：
请求地址：https://api.thingboot.com/{AppID}/device/control/?sign={final_sign}&ts={ts}
3.2 核心控制指令代码示例 (cURL / JavaScript)
假设业务场景：顾客在收银台完成开单，系统需自动开启 1路 照明和 2路 麻将机。
请求体构造：
device: 粘贴设备外壳标签上的 Device ID (例如：12345678)。order: 指令集。直接使用power1和power2作为参数名进行控制。
HTTP 请求示例 (POST JSON)：
3.3 复杂场景指令进阶
在实际项目中，你可能需要更复杂的逻辑，例如控制门锁延时或语音播报：
| 业务场景 | Order 指令 JSON 示例 | 说明 |
|---|---|---|
| 单路断电 | {"power3": 0} | 关闭第3路门禁，顾客可推门离开 |
| 批量操作 | {"batch":{"relay":[1,2,4],"power":0}} | 一键结束，关闭照明、麻将机、空调 |
| 暂离模式 | {"point":{"relay":[1],"interval":5000}} | 照明先关，5秒后重开（配合感应器） |
| 语音播报 | {"play:gbk:16":"欢迎光临，请尽情享受"} | TTS版本支持，适合迎宾或叫号 |
4. 业务逻辑设计：从“人控”到“智控”
接入硬件只是第一步，真正的价值在于业务逻辑的优化。在软件系统中设计以下三个自动化策略：
策略一：订单生命周期绑定（核心）
触发点：用户在小程序下单 → 动作：调用 API 开启 1、2、4路（照明、麻将机、空调）。
触发点：订单倒计时结束或点击“退单” → 动作：调用 API 关闭 所有路，同时开启 3路门禁延时（给顾客30秒离开时间，随后落锁）。
策略二：异常状态巡检（后台定时任务）
逻辑：设定每晚 23:00 运行定时任务。
脚本：查询所有“空闲”状态的包间对应的设备 ID，下发强制全关指令
{"batch":{"relay":[1,2,3,4],"power":0}}。这能有效防止店员下班漏关空调，仅此一项每月可省数百元。
策略三：设备状态同步（推荐使用异步推送）
虽然调用 API 返回 200 代表指令送达，但若设备断电离线，指令无法执行。
：在项目中配置消息推送接收端。设备执行指令后，会上报最新状态到你的服务器，以此作为“动作执行成功”的凭证，并在管理后台显示“在线/离线”状态。
5. 私有化部署与网络安全
考虑到连锁门店的数据隐私，若你的软件项目运行在纯内网环境或不希望数据经过芯步的公有云：该系列控制器支持 局域网 HTTP 通信 和 私有化部署。
方案：只要你的服务器与控制器在同一局域网（或通过 VPN 连通内网），可直接将请求域名指向设备本地的 IP 地址，通信不经过外网，保障数据安全且响应速度更快（毫秒级）。
6. 接入效果预期
完成上述接入后，你的门店管理系统将具备以下能力：
效率提升：开台关台时间从 5 分钟缩短至 2 秒（自动完成）。
防逃单机制：未支付状态下无法通过物理开关强制开启空调/麻将机（可设定上电默认状态）。
用电可视化：系统后台可记录每路开关的动作时间，便于分析包间翻台率与设备使用率。
下一步行动：
在芯步控制台获取
AppID、AppSecret及测试设备的Device ID。使用 Postman 测试上述 API 指令，验证照明和插座能否正常响应。
编写后台服务层代码，封装
OpenLight()、CloseAll()等业务函数。