芯步的8路控制器通过开放的HTTP API接口，可以灵活对接各类业务系统。以下方案以包间场景为例，梳理了从签名认证、单路/批量控制，到结合传感器实现自动化联动的完整对接路径，你可根据实际业务需求调整具体逻辑。

芯步8路包间电源控制器对接方案：实现自定义联动操作

1. 背景与目标

在棋牌室、茶室、剧本杀、自习室等共享空间或服务型包间中，通常需要对照明、麻将机、空调、门锁等多个设备进行独立管理。本方案的目标是利用芯步8路包间电源控制器（如智能包间控制器|Max或智能通用控制器）的开放 HTTP API 接口，将其无缝对接到现有的微信公众号、小程序或 PC 端管理后台。

核心目标：

• 实现包间内 8 路电器的远程独立开关。

• 根据业务状态（如订单开始/结束）触发自定义联动操作（如自动通电、断电）。

• 配合传感器实现自动化控制（如无人自动断电）。

2. 硬件选型参数

根据实际负载需求，主要推荐两款 8 路控制器，其接口协议一致：

• 智能包间控制器|Max：专为服务型门店设计。带有分级电路，1-3路（10A）接照明/排风，4-6路（16A）接麻将机/饮水机，8路（30A）接空调，部分版本支持 TTS 语音播报 。

• 智能通用控制器：适用于模型控制或普通负载，支持 DC 12V 供电，总负载功率可达 4400W 。

核心 API 特性：

• 协议：HTTP/HTTPS

• 数据格式：JSON

• 控制方式：支持单路控制（power1~power8）、批量控制（batch）、定时任务和点动模式（point）。

3. 对接流程与接口调试

3.1 前期准备（控制台操作）

在芯步开放平台完成以下步骤：

1. 注册开发者账号：前往芯步官网注册。

2. 获取密钥：在“开发设置”中获取 AppID 和 AppSecret。这两个参数是调用 API 的身份凭证。

3. 添加设备：在控制台添加硬件设备，记录下每个包间对应的 Device ID（设备唯一ID）。

3.2 签名机制

为防止接口被恶意篡改，所有 API 请求均需携带动态签名。签名算法如下：

Sign = md5( md5(AppSecret) + ts )

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

• 逻辑：将 AppSecret 进行一次 MD5 加密得到字符串 A，再将 字符串A + ts 拼接后进行第二次 MD5 加密，得到最终的 Sign 。

3.3 关键 API 调用示例

对接主要涉及“下发指令”。请求地址为：https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

第一种场景：单路独立控制需求：当顾客下单成功后，自动打开包间总电源（假设接在第 1 路）和照明（假设接在第 2 路），关闭门锁（第 7 路）。

• 请求方式：POST

• HeaderContent-Type: application/json

• Body

注：power1:1 代表第一路通电，power7:0 代表第七路（门锁）断电开锁 。

第二种场景：批量与点动控制需求：在某些体验场景下，需要按下按钮让灯带闪烁，或让电机转动几秒后自动停止，此时可使用 point（先通后断）命令。

• Body

注：此命令将接通第 1 路线路，3 秒后自动断开，常用于自动关门或临时的灯光秀 。

第三种场景：全开/全关需求：结束营业时，一键切断包间内所有电源。

• Body

注：batch:0 为全关，batch:1 为全开 。

4. 自定义联动操作设计

基于 API，可以在你的业务服务器上编写逻辑，实现以下典型的联动应用：

4.1 基于订单状态的联动（无人值守模式）

• 用户下单支付成功

  • 触发：power1（照明）开，power4（插座/麻将机）开。

  • 附加逻辑：如果是 TTS 版本，可发送 {“play：gbk：16”：“欢迎光临，设备已通电”}。

• 用户点击“续费”

  • 无需操作电路，保持通电状态，系统自动延长计时。

• 订单结束/超时

  • 触发强制断电：batch:0（全关）。

  • 安全逻辑：为防止顾客被困，第 7 路（门磁锁）需在断电前保持通电（通电锁门，断电开门）。在全关前 10 秒发送语音提醒，再执行 {“power7”： 0} 释放门锁。

4.2 结合传感器的联动策略若包间内部署了芯步的人体存在传感器

1. 数据接收：你的服务器接收传感器上报的 {“radar_enable”： 0}（无人状态）信号。

2. 自定义逻辑：连续 15 分钟检测为“无人”，且订单状态为“使用中”。

3. 执行操作：服务器调用 8 路控制器接口，关闭空调和灯光，仅保留冰箱电源（如第 5 路保持 power5:1），实现节能。

4.3 本地局域网联动（高稳定性方案）在网络断网或对延迟极其敏感（如灯光秀）的场景下，如果你的服务器与设备处于同一局域网，可以考虑私有化部署方案，直接在内网调用设备的固定 IP 地址进行控制，避免公网延迟 。

5. 异常处理与安全

1. 感性负载保护：麻将机和空调属于感性负载，接通或断开时可能产生火花或较大电流。选型时注意功率余量（如第 8 路空调专用口支持 30A 大电流），避免多台大功率设备同时通电启动，可以依次延时启动各回路 。

2. 防呆机制：在实际应用中，避免出现“关门断电”导致服务器关机的情况。控制器、路由器和服务器（或 NAS）接在 UPS 不间断电源上，只控制空调、麻将机等高能耗设备，保持核心通信设备不断电。

3. 状态同步：利用 device/info 类接口定期轮询设备状态，或通过平台的“消息推送”接收设备状态变更回调，避免因手动开关导致系统显示状态与实际不符 。

6. 总结

通过芯步开放的 HTTP API，你可以在 3-5 天内完成 8 路电源控制器与现有业务系统的对接。关键在于利用 AppSecret 处理好签名逻辑，并灵活运用 单路指令 和 批量指令 的组合，即可实现复杂的包间电源管理逻辑。如果自身团队开发资源有限，也可以利用芯步的 SaaS 低代码平台 或 Node-RED 等可视化工具，通过拖拽节点快速搭建联动。