这是一篇关于芯步智能包间控制器MINI的硬件接入与接口控制解决方案。

文章会稍微口语化一点，像技术同事之间聊天那样，结合官方的开放接口，重点聊怎么把第3路（门禁专用口）用起来。

一、 我们聊什么？—— 把“笨锁”变“智能锁”

大家好，在共享棋牌室、茶室或者影音包间的改造中，最头疼的问题之一就是门禁管理。你肯定不想拿着钥匙去开门，或者客人到了还得打电话问密码。

今天我们要聊的，就是如何利用芯步的4路包间综合管理控制器MINI，配合它的开放接口，把普通的电磁锁/电插锁接入网络，实现手机点一下、或者客人下单自动开门。

一句话概括： 我们要用代码控制MINI控制器的“第3路”接线柱，让它瞬间断电，磁力消失，门就开了。

二、 主角介绍：这个“MINI”盒子凭啥能控门？

首先，我们得认识一下这个硬件。别看它叫MINI，麻雀虽小五脏俱全。

• 它是啥？ 是一款专为服务型门店设计的4路智能控制器。

• 核心功能： 就是通过WiFi接收命令，然后控制背后的4个接线柱（开关）的通断。

• 关键点（划重点）： 它的第3路，在产品参数里明确写着就是 “10A门禁电磁锁接口”。

  • 这意味着什么？意味着厂家已经把继电器的线路优化好了，你不用改电路，直接把电磁锁的两根线拧到“第3路”的接口上就行。

• 适用锁具： 可以接任何直流电磁锁或电插锁。

除了门，另外几路干嘛？既然都叫包间控制器了，它顺便还能管别的：

• 第1路： 接照明或换气扇（16A）。

• 第2路： 接麻将机、饮水机（16A）。

• 第4路： 接2匹空调（30A）。

• TTS版本： 有的版本还能播报语音：“欢迎光临，您的包间已通电”。

这样，一个包间只需要一个盒子，把所有强电设备全搞定。

三、 核心逻辑：怎么用代码开门？

要控制门禁，咱们不需要懂复杂的硬件电路原理，只需要懂HTTP请求。

MINI控制器是走WiFi的，它开放了HTTP接口。说白了，它就是一个小型的Web服务器。

控制逻辑是这样的：

你的服务器/手机/小程序 -> 发一个HTTP POST命令 -> 告诉MINI盒子 -> “把第3路给我断开（OFF）”

电磁锁的特性：绝大多数电磁锁是 “断电开门” 原理。即：

• 通电（ON）：门吸住，打不开。

• 断电（OFF）：门松开，自动打开。

所以，我们想要开门5秒钟，流程就是：

1. 发送命令让第3路 关闭 (power3=0) -> 门开了。

2. 等待5秒。

3. 发送命令让第3路 开启 (power3=1) -> 门锁恢复吸合。

当然，不用我们自己写定时器，接口自带定时复位功能，下面会讲。

四、 实操：动手敲代码（接口调用详解）

芯步的接口非常标准化，只要是支持HTTP请求的语言（Java, Python, PHP, Go, 甚至命令行Curl）都能搞定。

在开始前，你需要准备三个东西：

1. AppId / AppSecret： 在芯步控制台注册设备后获取。

2. Device ID： MINI盒子上的设备编号。

3. WiFi环境： 确保MINI盒子已经连上了2.4G WiFi。

1. 签名机制（安全验证）

为了防止别人乱开门，接口需要签名验证。规则稍微有点绕，但在代码里封装好就行了：签名算法是：Sign = md5( md5(AppSecret) + ts )。ts是当前时间戳。

2. 开门命令详解

请求地址：http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

请求方式：POSTContent-Type：application/json

核心Body参数：

• power3 这里的 3 就是代表 第3路。

• 0 代表 关闭/断开（门开）。1 代表 打开/接通（门锁吸合）。

3. 更优雅的写法：自动复位（推荐！）

如果你不想自己在代码里写sleep(5)，可以用 reset 命令。这个命令的意思是：先关闭，等待N毫秒，自动再打开。

示例代码：

• reset3：对第3路执行“断开-等待-闭合”动作。

• 5000：单位是毫秒，即断开5秒后自动恢复。

场景模拟： 客人下单成功后，后台直接发送这条指令。门锁“咔”一声弹开5秒，客人拉门进入，5秒后门自动锁上。完美！

4. 极简示例（Curl命令）

如果你现在就要测试，在Linux命令行里可以直接跑：

五、 硬件接线：手把手教你接

光有代码不行，线接错了也白搭。

1. 断电操作！ 接线前请一定要关闭总闸，MINI控制器是直接接220V强电的，注意安全。

2. 锁的准备： 买回来的电磁锁或电插锁，一般是两根线（通常是红色和黑色）。

3. 识别接口： 看MINI控制器的接线端子排。

   • 找到 “第3路” 区域。

   • 它通常有两个孔：一个是 L3-out (火线出)，一个是 N (零线共用/公共端)。

   • 注意： 如果是直流电磁锁，需要看你的MINI版本（有的MINI第3路输出是直流，有的是交流，核对一下产品手册，但通常MINI第3路是继电器干接点信号，如果你是12V电磁锁，需要外接12V电源串进去，不要直接用220V电去点锁！）

   • 安全： 如果是非电工技术人员，直接购买12V直流电磁锁，把MINI的“第3路”当作开关，串在12V电源和锁之间。

六、 进阶与避坑指南

1. 超低延迟：芯步的设备响应很快，通常命令下发到执行在 80-120毫秒 左右。按下去瞬间就有反应，体验很好。

2. 局域网私有化（内网直连）：如果你不想走云端，追求极稳的内网环境，MINI控制器是支持局域网或私有化部署的。你的服务端可以直接向内网IP发请求，外网断了也不影响关门开门。

3. 状态同步：当客人开门进去后，怎么判断包间是否有人？MINI控制器支持功率计量功能。你可以读取第3路的电流变化，或者配合门磁传感器，来判断门是开着的还是关着的，防止客人“溜门”。

4. 紧急开门：别忘了保留一个物理的智能墙壁出门开关（大概几十块钱）。万一系统崩了或者客人手机没电，按一下墙上的开关也能触发