这是一篇为你准备的解决方案,咱们尽量说得直白一点,不搞那些复杂的官腔,但该有的干货一个不少。
各位技术伙伴、项目负责人:
大家好!
如果你正在开发共享棋牌室、茶室、自习室,甚至是企业办公楼的工位管理系统,那你一定考虑过一个问题:怎么远程控制包间里的灯、插座、门禁和空调?
市面上很多方案要么太封闭,不给接口;要么需要复杂的网关配置,折腾半天。
今天咱们就专门聊聊芯步的这款“4路共享空间智能控制器MINI”(以下简称MINI控制器),怎么把它干净利索地对接到你自己的项目里。
一、 先认识一下这个小家伙能干啥
在写代码之前,得先搞懂这4路分别能接什么,这样你在设计数据库和业务逻辑时才不会乱。
这个MINI控制器虽然是 Mini 版本,但功能很全,基本上一个包间(或者一个独立空间)的核心用电设备它都能管起来
第1路:接照明灯、换气扇。负载能到 3500W,一般商用它都扛得住。
第2路:接插座(麻将机、饮水机、按摩仪)。客人一断电,这些设备必须全没电,防止耗电。
第3路这个是门禁专用路。接电磁锁或电插锁(直流)。
第4路这个是空调专用路。这一路的负载特别高(6600W),专门用来接 2匹 甚至更大的空调。
小贴士:如果你买的是 TTS 版本,它还能语音播报,比如客人下单成功后,设备直接喊出来“欢迎光临某某号房”。
二、 硬核对接:这玩意儿怎么调?
这是大家最关心的部分。芯步一个比较厚道的地方就是接口完全开放,而且支持私有化部署。
所谓的“对接”,其实就是你的服务器给这台设备发一个 HTTP 请求。
1. 准备工作(三要素)
在动手之前,你要先拿到三样东西,都在芯步的控制台里能看到
AppID:你的应用ID,相当于你在芯步的“账号标识”。
AppSecret:你的密钥,千万别泄露在前端代码里,只在后端用。
Device ID:这台 MINI 控制器的设备ID,你可以理解为这台机器的身份证号。
2. 鉴权与请求地址
为了安全,请求是需要签名的。签名算法很简单,就是标准的 MD5 嵌套
签名 = md5( md5(你的AppSecret) + 时间戳 )
然后,把所有参数拼接到这个地址:
POST https://api.thingboot.com/{你的AppId}/device/control/?sign={签名}&ts={时间戳}
3. 核心命令下发(实战篇)
请求的 Body 是 JSON 格式,包含 device 和 order 两个字段。
我们先来个最实用的例子:客人下单成功了,系统需要自动打开某包间的灯、通电、关门。
假设设备ID是 DEV10001。
场景 A:客人下单,开门开灯
场景 B:客人时间到了,批量全关
场景 C:只控制空调(第4路)
因为空调启动电流大,或者需要保持压缩机不频繁启动,单独控制空调很常用:
4. 进阶玩法:不用网关,局域网直连
这里得提一句,它支持 WiFi 直连,2.4G 频段,不需要买网关,插上电配好网就能用。
而且它还支持私有化部署。如果你的项目跑在封闭内网(比如公司内部局域网、不连外