怎样二次开发4路HTTP接口包间控制器MINI以实现远程重置包间设备状态_解决方案

CATALOG

针对芯步4路HTTP接口包间控制器MINI的二次开发，这篇文章将提供一个完整的解决方案，指导你如何实现“一键重置”功能，从而远程恢复包间内所有设备的初始状态。

一、搞清楚我们要解决啥问题

先说说场景吧。

咱们经营棋牌室、剧本杀或者共享茶室的老板们肯定懂这个痛：顾客走人了，你得赶紧去包间里把空调关了、灯灭了、把麻将机断电（省得下一波客人来了机器还在嗡嗡响），还要把门锁释放掉让新客人能扫码进门。

如果是人工去操作，服务员跑来跑去累得够呛不说，碰上高峰期根本忙不过来。

那我们今天的任务就是：利用芯步这个Mini控制器的开放接口，自己写个小脚本，实现“一键重置”——点一下，所有设备全部回到初始状态。

这个小功能你可以集成到你的小程序后台、PC管理端，甚至做一个物理快捷按钮都行。

这个Mini控制器虽然只有4路，但麻雀虽小五脏俱全：

第1路（16A）：一般接照明灯、换气扇、吸烟灯。有时候客人走了烟雾缭绕，得排气。
第2路（16A）：接饮水机、麻将机。特别是麻将机，客人离开现场时必须断电，防止下一波人来了洗牌机还在空转。
第3路（10A）：接门禁电磁锁。这是最重要的——控制客人能不能进门。
第4路（30A）：接2匹空调。这可是电费大户，客人走了忘关空调，一天浪费几十块钱。

我们要做的是：按一个键，让这几路电先断开，再根据你的需要重新接通部分设备（比如门禁要保持断电锁住，或者让换气扇再转五分钟）。

二、动手前，先看懂它是怎么通信的

这玩意儿用的是HTTP接口，意味着不管你是用PHP写后台、用Python写脚本，还是用Go写微服务，只要会发HTTP请求，就能控制它。

重点来了——签名机制，这个是很多新手第一次搞容易卡住的地方。芯步的接口为了安全，不是裸奔调用，需要加签名。

核心逻辑就是：

先把你的AppSecret（开发者密码）做一次MD5加密。
把加密后的字符串拼上当前的时间戳ts。
再把拼起来的东西做一次MD5加密，得到sign。

用公式写就是：sign = md5( md5(AppSecret) + ts )。

为什么要这么折腾？说白了就是为了防止有人抓包篡改请求，保证每次调用都是合法的。开发的时候记得时间戳取秒数，不是毫秒，很多新手在这翻车。

三、“重置”怎么玩？两种核心思路

要实现“重置”，其实有两种路子。我帮你分析一下哪种更适合你。

方案A：最省事的“咔咔全断”

这个是刚需。客人结账离开现场时，你需要把所有设备断电。

命令：

这就是最简单的全关指令。调一下这个接口，4路全部变成0，灯灭、麻将机停、空调关。

如果你还想给门禁断电让门锁上（一般都是断电开锁型），那也是包含在全断里面的。

方案B：优雅的“硬重启”（Reset命令）

有些设备（比如某些网络设备或者有电容的电器）直接断电再马上通电不太好，或者你希望执行“先断后通”的时序控制。

这个Mini控制器提供了一个专门的命令叫 先断后通（reset） 。

比如说，你的路由器接在第2路，你想让它重启一下，那就发：

意思是：断开第2路，等5秒钟，再自动接通。

重点来了：对于“重置包间状态”，最标准的手法是：执行全断（power:0），然后选择性恢复必须通电的设备。

比如门锁，通常是不需要恢复通电的（保持断电状态才能锁住门），但换气扇你可能想让它再转5分钟散味。这种情况就要用组合命令：

先发：{"power": 0}（全断）
再发：{"power2": 1}（单独打开排风扇）

你要是嫌发两次请求太麻烦，也可以直接用批量控制（batch） 命令，直接指定哪几路关、哪几路开。{"batch":{"relay":[1,2,4],"power":0}} 可以让1、2、4路关，3路不动，这样一组合就能灵活定制"复位后的状态"。

四、代码实战：写一个重置脚本

用Python举例子，因为写起来最快，你跑在任何服务器甚至Windows电脑上都能用。如果你后台是PHP，逻辑完全一样，换下语法就行。

第一步：准备好参数

你要去芯步的控制台拿到三个东西：

AppID：你的应用ID
AppSecret：你的密钥（千万别泄露到前端网页里）
DeviceID：你那个Mini控制器的设备编号（壳子上或者控制台设备列表都能找到）

第二步：写脚本

import requests
import hashlib
import time

# --- 配置信息（请替换成你自己的）---
APP_ID = "你的AppID"
APP_SECRET = "你的AppSecret"
DEVICE_ID = "你的设备ID"  # 比如 "1878"

# 芯步的API地址模板
API_URL = f"https://api.thingboot.com/{APP_ID}/device/control/"

def reset_package():
    """
    核心功能:重置包间，先全断，再开排风扇（举例）
    """
    # 1. 准备时间戳（秒）
    ts = str(int(time.time()))
    
    # 2. 计算签名:md5(md5(secret) + ts)
    # 先md5一下Secret
    md5_secret = hashlib.md5(APP_SECRET.encode('utf-8')).hexdigest()
    # 拼接并再次md5
    sign_str = md5_secret + ts
    sign = hashlib.md5(sign_str.encode('utf-8')).hexdigest()
    
    # 3. 拼接请求URL（带签名和时间戳）
    url = f"{API_URL}?sign={sign}&ts={ts}"
    
    # ========= 执行重置动作 =========
    
    # 第一步:全关（power:0），让包间归零
    print("正在执行全关断电...")
    order_all_off = {"power": 0}
    payload = {
        "device": DEVICE_ID,
        "order": order_all_off
    }
    
    try:
        response = requests.post(url, json=payload, timeout=5)
        print(f"全关指令已发送，响应码:{response.status_code}, 内容:{response.text}")
    except Exception as e:
        print(f"请求失败:{e}")
        return

# 可选:第二步，如果包间需要立即通风（比如刚抽完烟），2秒后单独打开换气扇（假设换气扇在第1路）
    # 实际场景中，往往是客人刚走，并不需要马上开灯开空调，但如果你需要复位后自动打开某些设备，取消注释下面代码
    # time.sleep(2)  # 等待2秒，模拟继电器动作间隔
    # print("正在单独开启排风扇...")
    # order_fan_on = {"power1": 1}
    # payload2 = {"device": DEVICE_ID, "order": order_fan_on}
    # requests.post(url, json=payload2, timeout=5)
    # print("排风扇已开启")

if __name__ == "__main__":
    reset_package()
    print("包间重置任务执行完毕！")

如果你不想通过芯步的云平台中转，控制器跟你的服务器在同一个局域网，也可以走私有化模式：直接请求http://设备IP地址/control，那套签名逻辑会简化很多，甚至可以不签名直接用。

五、进阶：怎么把它放进你的系统里

写好了脚本，只是万里长征第一步。更重要的是怎么让收银员点一下就触发。

你这样做：

封装一个API接口：在你的后台管理系统里，新建一个路由，比如 /api/room/reset?room_id=101 。这个接口里面就调用我们上面写的那个Python函数（或者PHP版）。
前端加个按钮：在你的小程序或者网页管理后台，每个包间的详情页加一个大大的红色按钮叫 “打扫 / 重置” 。
联动业务逻辑：不要手动去点按钮，可以做得更智能——比如客人通过小程序点击“退房/离开现场时”时，系统自动调用这个重置接口。这样全程自动化，你连服务员都不需要安排人去按按钮了。
加个防呆确认：调用接口之前最好弹个窗问一下"确认要重置包间吗？空调关了客人可能会投诉"，避免服务员手滑。如果是从订单结束事件自动触发的，可以把延迟时间调到订单结束后的3-5分钟，给客人留个缓冲。

六、踩坑经验：几个容易出问题的地方

这几条是我帮别人调试接口时遇到的高频坑，提前帮你避开：

时间戳要对齐：服务器的系统时间不准会导致签名验证失败。如果发现签名一直错，先检查一下服务器时间是不是和北京时间差太多。Windows服务器尤其容易有这个问题。
别在前端暴露AppSecret：有些人图省事，直接在小程序前端代码里写死了AppSecret，这等于把家门钥匙挂门口。一定要把签名计算放在你自己的后端服务器，前端只调用你自己的接口。
局域网模式更稳：如果你对云端依赖比较敏感（比如怕断网后控制不了），可以把控制器切换到局域网模式，直接用它的IP地址控制。这种方式可以不依赖外网，只要你的管理后台和内网通着就行。
语音播报版本有坑：如果你买的是TTS语音版，发播报命令时中文要做GBK转16进制，直接传UTF-8编码的中文会乱码或没声音。

七、总结

说白了，二次开发这个Mini控制器一点都不神秘。它的本质就是发HTTP请求。你只要把 power1、power2 这些字段搞清楚，配合 reset 或 batch 命令，就能轻松实现包间状态的“一键重置”。

从最基础的全断，到进阶的“先断后通”，再到集成进订单系统自动触发——这几个层次做下来，你的包间管理就能完全脱离人工巡检。服务员不用再跑断腿，客人也能立刻进下一个包间，翻台率自然就上来了。

希望这个方案能帮到你，让你在写代码的时候少走点弯路。