这是一份关于芯步“4路包间电源控制器MINI”的集成解决方案。我将采用方案书的形式,语气稍微口语化一点,避免过于生硬的技术文档风格,同时确保细节到位。
1. 引子:这小东西能干啥?
大家好,咱们今天聊聊怎么把芯步的4路包间电源控制器MINI给集成到大家的软件里。
这年头,不管是共享棋牌室、自助茶室,还是那种按小时租用的自习室、琴房,想要实现真正的“无人值守”,核心就两点:门禁能自动开,电闸能远程断。
这款Mini控制器其实就是干这个活的“小钢炮”。它大概就一个拳头大小,但能干的事不少:
第1路:接照明灯或者排气扇。
第2路:接麻将机、饮水机。
第3路:专门留出来接电磁锁(门禁锁)。
第4路:功率比较大,专门用来接空调(2匹以内没问题)。
简单来说,有了它,你就不用再去买继电器、中间继电器乱接一通了。而且它自带WiFi,接上网就能用。
2. 核心思路:怎么“对话”?
这玩意儿没有乱七八糟的私有协议,也不强制要求你有固定的公网IP。它走的是 HTTP 协议。
这意味着什么?意味着只要你的软件能发HTTP请求(现在大部分编程语言都能做到,比如 Java, Python, PHP, Node.js, Go 等),不管你是Web网页、手机APP还是微信小程序,都能直接控制它 。
架构流程大概是这样的:
用户手机点一下 -> 你的服务器处理业务逻辑 -> 你的服务器调用芯步的API -> 指令通过云端下发给包间里的Mini控制器 -> 继电器吸合 -> 灯亮了/门开了。
3. 动手干:一步步搞定集成
这里我们不讲虚的,直接说怎么把代码跑通。在开始之前,需要先拿到两样东西:AppID 和 AppSecret(去芯步的控制台注册就有了)。
第一步:搞定签名
调用它的接口,第一步不是直接发指令,而是算一个 sign (签名)。虽然有点小麻烦,但这是为了安全,防止别人随便控制你的设备。
官方给的逻辑是:sign = md5( md5(AppSecret) + ts )
啥意思呢?
把你拿到的
AppSecret做一次MD5加密,得到一个32位的字符串。在这个字符串后面拼接上当前的时间戳
ts(比如:1715324567)。把拼起来的新字符串再做一次MD5加密。
这里踩坑提醒:ts 用的是秒,不是毫秒。
简单说人话版本(伪代码):
第二步:发指令把空调关了(或者打开)
假设有顾客刚走,我们需要把包间里的空调(接在第4路)关掉。我们要请求的地址是这个样子的:https://api.thingboot.com/{你的AppID}/device/control/?sign={刚才算的sign}&ts={时间戳}
请求体 (Body) 要这么写:
解释一下:
power1控制第1路(照明)power2控制第2路(麻将机)power3控制第3路(门禁锁)power4控制第4路(空调)
如果我们要开门,就发 {“power3”: 1}。
第三步:一键全关
如果包间里客人走了,你想把所有的灯、麻将机都关了,又不想写4行代码,可以用批量控制:
第四步:进阶玩法——语音播报
如果你买的是 TTS版本,这个控制器还带了个小喇叭。你可以让它说话!比如客人刚下单,你可以自动调用接口让包间里喊一嗓子:“有新的订单啦,请开始打扫” 。
语音播报的命令稍微特殊一点点,要用 GBK 编码(防止中文