芯步的16A智能插座支持HTTP API调用,分组控制的核心思路是:先创建设备分组,再通过分组接口批量下发指令。下面是具体的对接方案。
怎么对接芯步16A86型智能插座实现设备分组控制?
大家好!今天咱们来聊一个很实在的问题:怎么通过芯步的开放接口,把我们手里的16A大功率智能插座给“编组”管理起来。
很多朋友可能已经用上了芯步的那款16A插座(型号一般是 UNI-QC-16A 或者带计量的 UNI-QC-16A-P),专门用来控制空调、热水器这些大功率设备。单个控制确实方便,但如果店里装了十几个空调,或者家里别墅三层楼的热水器都要管,一个一个点就太麻烦了。
这时候就需要分组控制了——一键关掉所有空调,或者定时关闭整个楼层的插座。
下面这份“保姆级”解决方案,手把手教你怎么搞定。
一、 准备工作:先把手里的家伙什儿点亮
在敲代码之前,得先把硬件和基础环境准备好。这就跟做饭前得先洗菜切菜一样。
确保设备在线:把16A插座安装好(注意这玩意儿是16A的,线径要够粗),接上WiFi。标准是 86型底盒 安装。在芯步的官方App或者控制台里,你得能看到它显示“在线”。如果不在线,检查一下2.4G Wi-Fi(不支持5G哦)。
拿到关键的钥匙(AppID 和 AppSecret)
登录 [芯步控制台]。
找到“开发设置”或者“我的应用”。
你会看到两个字符串:
AppID(你的用户名)和AppSecret(你的密码)。这两个千万保管好,别泄露给外人。
二、 核心思路:分组是怎么运作的?
其实原理很简单:芯步的云端已经帮我们做好了“分组”这个虚拟概念。
没有分组:你要发指令给
设备A,再发指令给设备B。有分组:你把
设备A和设备B都拉进一个叫“客厅空调”的分组里。你只需要对着这个分组ID喊一声“关机”,云端就会自动去操弄这两个设备。
这套API接口是公开的,不管你是用PHP、Java、Python还是直接用Postman去试,都是一样的道理。
三、 实战步骤:从零搭分组
这里我们主要用 HTTP POST 请求来操作,比较直观。
第一步:创建分组(给设备们找个家)
首先,你需要调用接口创建一个分组。这一步一般在你的后台管理系统里做,或者你写个脚本跑一下。
虽然搜索结果里没有直接贴“创建分组”的代码细节,但根据标准流程,通常是调用 /group/create 之类的接口。重点是,创建成功后,你会得到一个 GroupID(数字)。
第二步:往分组里加设备(把插座拉进来)
假设我们有个分组ID叫 10086(我要把这组插座都管起来)。现在把16A插座(Device ID: 123456 和 789012)加进去。
请求示例通常像这样(视具体接口文档而定,一般是POST JSON数据):
这时候,这两个物理插座就变成“一家人”了。
第三步:执行分组控制(重头戏!)
这是最爽的一步。比如晚上要打烊了,你想把分组里的所有16A插座电源切断。
接口地址一般是:http(s)://api.thingboot.com/{AppID}/group/control/
关键参数来了
group:刚刚创建的那个ID,比如
10086。命令:对于我们的16A插座,它只有一个核心继电器,控制命令就是
power。
如果你想全部关闭(这是最常见的需求):传入参数:power=0 (0代表关,1代表开)
具体请求示例(JSON格式):
就这么简单!云端收到这个请求后,会并发地向组内所有插座发送“断开继电器”的指令。
进阶玩法:如果这个分组里不仅有16A插座,还有别的设备(比如10A插座或者开关),你想只关16A插座?这通常涉及到设备的“物模型”。不过好消息是,如果设备类型不同,不支持的指令会被自动忽略,或者你可以采用更精细的动作(Action)控制。
四、 稍微进阶一点:关于签名(Sign)
很多新手在调接口时卡在这一步,觉得麻烦。其实芯步的签名算法挺简单的
公式是:sign = md5( md5(AppSecret) + ts )
解释一下:
把你的
AppSecret做一次MD5加密,得到一串字符串。把这个字符串和当前的时间戳(
ts,比如 1714555666)拼接在一起。把拼接后的新字符串再做一次MD5。
为什么要这样? 这是为了防止别人拿着你的请求链接去搞破坏。因为时间戳 ts 是一直变的,所以签名也是一次性的。
五、 针对16A插座的小贴士
大功率场合:既然你用16A插座,那肯定是接空调、地暖或大功率电器。用分组控制“一键下班”功能真的很实用,免得员工下班忘了关空调。
状态反馈:如果你在控制台操作,下发指令后
code: 200只代表云端收到了指令。至于插座是不是真的因为WiFi信号不好而没执行,你需要去查设备的上线/下线状态,或者(如果你买的是计量版)看它的功率数据有没有掉下来。先通后断:16A插座还支持
point(先通后断)和reset(先断后通)命令。分组里也支持这个逻辑。比如控制空调,不要直接瞬间断电(对压缩机不好),可以设置point延时断开?不过在分组里批量操作这种场景较少,单控时很实用。
总结一下
要把芯步的16A插座做成群组控制,流程就是:
设备配网 -> 2. 创建分组 -> 3. 拉人进组 -> 4. 调用
/group/control接口,传groupID 和power=0/1。
搞定这些,哪怕你有一百个16A插座,也就是一次HTTP请求的事。希望这篇能帮到你,赶紧去试试把全公司的空调编组管理起来吧!