一、产品概述与选型

芯步4路共享空间智能控制器MINI是一款专为服务型门店包间场景设计的嵌入式智能控制设备，广泛应用于共享棋牌室、茶室、休息室、舞蹈练习室、琴房、沐浴房等场所。该设备提供两个版本选择：

选型：若项目需要向用户播报订单提醒、服务说明、超时提醒等信息，必须选择TTS版本。语音播报是该控制器区别于同类产品的核心差异化功能。

二、硬件接口与负载配置

2.1 四路输出定义

控制器提供4路独立输出接口，每路均可通过HTTP接口远程控制通断

2.2 典型包间接线方案

以标准棋牌室包间为例：

• 第1路：接入照明灯带及排风扇（并联）

• 第2路：接入麻将桌电源插座

• 第3路：接入门禁电磁锁，实现扫码开锁

• 第4路：接入柜机空调

2.3 安装注意事项

• 设备采用WiFi 2.4GHz无线连接，无需网关，但需确保包间WiFi信号覆盖

• 工作电压为DC 5V/1A，随附电源适配器

• 外壳采用防火V0级PC材质，尺寸仅72×90×62.8mm，可嵌入86盒或明装

• 支持设定5组WiFi网络，自动连接信号最强的网络

三、API接口集成方案

3.1 接口架构

芯步开放平台采用HTTP API模式，支持任何支持HTTP请求的编程语言接入。整体架构如下：

[小程序/APP/Web] → [芯步API] → [WiFi] → [Mini控制器] → [电器]
         ↑                │
         └── 可选私有化部署 ──┘

3.2 鉴权机制

接口采用双重MD5签名验证，保障安全性

开发调试便捷功能：可在控制台开启“调试模式”，该模式下系统不检查sign、ts和IP白名单，方便快速对接测试。

3.3 核心API命令

单路独立控制

批量控制

TTS语音播报（核心特色）

语音播报命令格式说明：play:gbk:16 中的16表示音量等级（范围待确认），使用GBK编码支持中文。

时序控制命令

3.4 完整调用示例（cURL）

四、项目集成场景方案

4.1 共享棋牌室/包间

业务流程

1. 用户小程序下单 → 系统开锁（第3路通电）→ 语音播报“欢迎光临”

2. 用户扫码进入 → 系统自动通电（第1、2、4路）

3. 时间到或用户点击结束 → 语音播报提醒 → 延迟后断电锁门

关键代码逻辑

4.2 自助自习室/琴房

特殊需求：按时计费、超时提醒、强制断电

4.3 配套传感器联动（扩展）

芯步提供配套传感器产品，可实现自动化联动

联动原理：传感器将数据上报到您的服务器 → 服务器分析数据 → 下发控制命令到Mini控制器

五、系统对接关键要点

5.1 设备配网流程

1. 给控制器接通5V电源

2. 设备进入配网模式（具体操作参考产品手册）

3. 通过芯步控制台或小程序完成WiFi配置

4. 在控制台获取设备ID

5.2 私有化部署选项

对于数据安全要求高的项目，支持私有化部署和自建消息服务器，可在纯局域网环境中运行。

5.3 响应时间

从命令下发到设备响应约为80-120ms，满足实时控制需求。

5.4 状态同步策略

• 设备状态变化会实时上报到您的服务器（需配置消息接收地址）

• 服务端维护设备状态缓存，避免频繁查询

六、集成Checklist

本方案涵盖了从硬件选型、接口集成到业务场景的完整路径。芯步的HTTP API设计简洁，采用标准签名机制，可快速集成到小程序、APP或Web管理后台中。TTS语音播报功能是提升用户体验的核心亮点，在需要用户提醒的订单式场景中优先选用该版本。