CATALOG

芯步的4路MINI控制器提供了完整的HTTP API接口,其中reset命令正是为“先断后通”场景设计的——你可以通过一行指令让指定线路断电再恢复,实现设备状态的重置。以下方案按“为什么需要—如何实现—进阶优化”的结构展开,你可根据实际业务场景直接参考使用。

1. 背景与需求

在共享棋牌室、茶室、自助健身房等无人值守场景中,顾客离开现场时后或订单异常时,经常需要将包间内的电器恢复到默认状态(如关闭麻将机、复位门锁、关闭空调等)。传统做法是保洁或店长手动进入包间操作,效率低下且容易遗漏。

痛点:当顾客超时未离开现场时、设备死机或需要强制结束订单时,需要一种 “一键还原” 的能力,确保下一轮顾客入场时设备处于干净、关闭或待命状态。

利用芯步4路包间电器覆盖控制器MINIreset命令(先断后通),可以在不依赖复杂逻辑的情况下,通过HTTP接口实现对门锁、麻将机、空调等设备的断电重启状态归零

2. 核心接口与“重置”逻辑解析

芯步的MINI控制器提供了4路独立继电器输出 。针对“远程重置设备状态”这一需求,我们不需要简单地进行“关闭”(power=0),因为有些智能设备(如麻将机主板、共享按摩椅)仅仅断电可能不够,或者断电后立即上电才能触发复位信号。

关键发现reset命令在官方定义中为 “先断后通”

这意味着:

  1. 断开:指定线路继电器断开,设备彻底断电。

  2. 等待:等待你设定的时间间隔。

  3. 接通:自动重新接通电源。

应用场景对应

  • 电磁门锁复位:断电瞬间释放锁舌,重新上电恢复吸合(配合门磁实现真正的关门检测)。

  • 麻将机/按摩椅重启:某些设备长时间运行会死机,断电重启(Reset)可清除缓存,恢复流畅运行。

  • 空调/电视强制复位:如果顾客乱按导致模式错乱,reset可模拟插拔电源,强制恢复默认状态。

支持的命令参数(Reset):

根据接口文档,reset命令支持以下结构

  • 全线路复位{"reset":{"interval":500}} (所有线路断开500毫秒后重启)

  • 指定线路复位{"reset":{"relay":[1,3],"interval":2000}} (第1和第3路断开2秒后重启)

3. 实施步骤:从拿到设备到远程复位

第一步:前期准备与接线

在实施前,需明确包间内哪些设备需要“重置”功能。

  • 路数规划

    • 第3路:接门锁(直流电磁锁)。复位功能主要用于门锁的归位,防止门禁控制逻辑错乱。

    • 第2路:接麻将机/饮水机。如果麻将机死机,需要切断2-3秒再恢复供电。

    • 第4路:接空调(2匹内)。夏天高温导致空调压缩机保护,可通过复位强制重启外机。

  • 网络配置:该设备仅支持2.4G WiFi,需确保包间信号覆盖。设备支持设置5组WiFi,会自动连接信号最强的

第二步:获取API凭证与签名

你需要通过业务系统(小程序后台/SaaS系统)发送指令。芯步开放平台使用动态签名验证。

签名生成规则

  1. 获取你的 AppIDAppSecret(在芯步控制台获取)。

  2. 获取当前Unix时间戳 ts

  3. 计算公式sign = md5( md5(AppSecret) + ts )

注意:这是两层MD5加密,将AppSecret加密后的字符串拼上时间戳,再整体加密一次。

第三步:编写远程重置逻辑(代码示例)

假设场景:顾客订单结束,需要复位门锁(第3路)并重启麻将机(第2路)

接口地址https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}

请求方式:POST (Content-Type: application/json)

请求Body

Python 实现示例

第四步:业务逻辑集成

单纯调用接口还不够,你需要将它与业务系统绑定:

  1. 订单结束触发

    • 用户在小程序点击“退房”。

    • 后端服务器收到退房事件。

    • 调用上述接口 -> 发送reset指令。

    • 效果:麻将机断电3秒 -> 复位归零;门锁断电3秒 -> 释放锁舌 -> 重新吸合(确保关门状态)。

  2. 远程运维(死机重启)

    • 保洁或店长在管理后台看到“麻将机离线”或“空调不制冷”报修。

    • 后台提供一个“硬件复位”按钮。

    • 点击按钮 -> 调用{"reset":{"relay":[2],"interval":5000}} -> 设备重启,恢复正常。

4. 进阶优化:结合传感器实现自动化重置

如果仅仅依靠HTTP调用还不够“智能”,你可以结合芯步的传感器生态。

场景:无人自动重置

硬件组合:4路MINI控制器 + 人体存在传感器。

流程

  1. 顾客离开包间。

  2. 人体传感器检测到“无人”状态,通过消息推送机制将状态上报至你的服务器

  3. 服务器逻辑判断:如果当前订单状态为“空闲”或“已结束”,且检测到无人超过5分钟。

  4. 自动触发全路Reset{"reset":{"interval":1000}}

  5. 优势:彻底实现无人化,无需人工干预,节省电费并延长设备寿命。

5. 常见问题与排障

  1. 为什么调用接口返回200,但设备没反应?

    • 接口返回200仅代表云平台接收到了指令并送达,但不代表设备执行成功。可能原因:设备离线(WiFi断了)、设备ID填错、relay路数不存在(MINI只有4路)。需要检查设备在线状态

  2. resetpower=0有什么区别?

    • power=0只是断开,不会自动接通。

    • reset“先断后通” 。对于麻将机/路由器这类设备,单纯的关电没意义,必须断电再通电才能重启;对于门锁,过于迅速的复位可能导致逻辑错误,reset支持设置interval间隔时间(如3秒),适配不同机电特性。

  3. 要不要买网关?

    • 不需要。这款MINI控制器是WiFi直连的,直接连2.4G路由器,不需要额外网关

  4. 局域网能控制吗?

    • 可以。芯步全系硬件支持私有化部署和局域网通信。如果你把服务器部署在门店本地,API请求走内网IP,延迟可以降到10ms以内,且断开外网也能用

6. 总结

在4路包间电器覆盖控制器MINI中,对接智能设备实现远程重置的核心是利用其开放的HTTP API接口,特别是reset(先断后通)命令

实施价值

  • 效率:远程处理故障,无需进房。

  • 稳定:强制断电重启解决了90%的智能设备死机问题。

  • 安全:订单结束后自动复位门锁逻辑,防止尾随。

在实际部署中,将第3路(门锁)和第2路(麻将机)作为复位重点,并在后端管理系统中增加“一键复位”按钮和数据埋点,记录每次复位的原因和时间。

控制器产品方案:
怎样接入4路智能直流开关以实现多设备联动控制
查看 >>
校园公共照明控制:怎样将8路智能配电箱接入到软件项目中
查看 >>
怎么接入智能 24 路远程通用控制器来实现设备故障告警通知
查看 >>
智慧教室灯光设备集中控制:怎样把12路分体智能配电控制箱集成到自己的项目中
查看 >>
怎样在共享自习室 LED 灯条控制中集成智能硬件来实现低压直流负载通断控制
查看 >>
覆盖场景方案:
4路包间电器覆盖控制器MINI:怎样将4路包间设备控制器MINI接入到项目中
查看 >>
如何在4路包间电器覆盖控制器MINI中对接智能硬件来实现多包间批量开关控制
查看 >>
怎么在4路包间电器覆盖控制器MINI中对接智能设备来实现远程重置包间设备状态
查看 >>
4路包间电器覆盖控制器MINI:如何将4路包间设备集中控制器MINI接入到自己的项目中
查看 >>
4路包间电器覆盖控制器MINI:如何把4路包间设备控制模块MINI对接到软件项目中
查看 >>
重置用途方案:
如何在共享自习室独立包间控制中集成智能设备以实现远程重置包间设备状态
查看 >>
怎样接入8 路包间设备控制模块来实现远程重置包间设备状态
查看 >>
怎样二次开发4路HTTP接口包间控制器MINI以实现远程重置包间设备状态
查看 >>
如何在4路包间设备控制模块MINI中接入智能硬件来实现远程重置包间设备状态
查看 >>
怎么在4路包间多回路控制模块MINI中对接智能硬件来实现远程重置包间设备状态
查看 >>