CATALOG

芯步的16A智能插座支持HTTP API调用,分组控制的核心思路是:先创建设备分组,再通过分组接口批量下发指令。下面是具体的对接方案。

怎么对接芯步16A86型智能插座实现设备分组控制?

大家好!今天咱们来聊一个很实在的问题:怎么通过芯步的开放接口,把我们手里的16A大功率智能插座给“编组”管理起来。

很多朋友可能已经用上了芯步的那款16A插座(型号一般是 UNI-QC-16A 或者带计量的 UNI-QC-16A-P),专门用来控制空调、热水器这些大功率设备。单个控制确实方便,但如果店里装了十几个空调,或者家里别墅三层楼的热水器都要管,一个一个点就太麻烦了。

这时候就需要分组控制了——一键关掉所有空调,或者定时关闭整个楼层的插座。

下面这份“保姆级”解决方案,手把手教你怎么搞定。

一、 准备工作:先把手里的家伙什儿点亮

在敲代码之前,得先把硬件和基础环境准备好。这就跟做饭前得先洗菜切菜一样。

  1. 确保设备在线:把16A插座安装好(注意这玩意儿是16A的,线径要够粗),接上WiFi。标准是 86型底盒 安装。在芯步的官方App或者控制台里,你得能看到它显示“在线”。如果不在线,检查一下2.4G Wi-Fi(不支持5G哦)。

  2. 拿到关键的钥匙(AppID 和 AppSecret)

    • 登录 [芯步控制台]。

    • 找到“开发设置”或者“我的应用”。

    • 你会看到两个字符串:AppID(你的用户名)和 AppSecret(你的密码)。这两个千万保管好,别泄露给外人。

二、 核心思路:分组是怎么运作的?

其实原理很简单:芯步的云端已经帮我们做好了“分组”这个虚拟概念

  • 没有分组:你要发指令给 设备A,再发指令给 设备B

  • 有分组:你把 设备A设备B 都拉进一个叫“客厅空调”的分组里。你只需要对着这个 分组ID 喊一声“关机”,云端就会自动去操弄这两个设备。

这套API接口是公开的,不管你是用PHP、Java、Python还是直接用Postman去试,都是一样的道理

三、 实战步骤:从零搭分组

这里我们主要用 HTTP POST 请求来操作,比较直观。

第一步:创建分组(给设备们找个家)

首先,你需要调用接口创建一个分组。这一步一般在你的后台管理系统里做,或者你写个脚本跑一下。

虽然搜索结果里没有直接贴“创建分组”的代码细节,但根据标准流程,通常是调用 /group/create 之类的接口。重点是,创建成功后,你会得到一个 GroupID(数字)。

第二步:往分组里加设备(把插座拉进来)

假设我们有个分组ID叫 10086(我要把这组插座都管起来)。现在把16A插座(Device ID: 123456789012)加进去。

请求示例通常像这样(视具体接口文档而定,一般是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 )

解释一下:

  1. 把你的 AppSecret 做一次MD5加密,得到一串字符串。

  2. 把这个字符串和当前的时间戳(ts,比如 1714555666)拼接在一起。

  3. 把拼接后的新字符串再做一次MD5。

为什么要这样? 这是为了防止别人拿着你的请求链接去搞破坏。因为时间戳 ts 是一直变的,所以签名也是一次性的。

五、 针对16A插座的小贴士

  1. 大功率场合:既然你用16A插座,那肯定是接空调、地暖或大功率电器。用分组控制“一键下班”功能真的很实用,免得员工下班忘了关空调

  2. 状态反馈:如果你在控制台操作,下发指令后 code: 200 只代表云端收到了指令。至于插座是不是真的因为WiFi信号不好而没执行,你需要去查设备的上线/下线状态,或者(如果你买的是计量版)看它的功率数据有没有掉下来。

  3. 先通后断:16A插座还支持 point(先通后断)和 reset(先断后通)命令。分组里也支持这个逻辑。比如控制空调,不要直接瞬间断电(对压缩机不好),可以设置 point 延时断开?不过在分组里批量操作这种场景较少,单控时很实用。

总结一下

要把芯步的16A插座做成群组控制,流程就是:

  1. 设备配网 -> 2. 创建分组 -> 3. 拉人进组 -> 4. 调用 /group/control 接口,传 group ID 和 power=0/1

搞定这些,哪怕你有一百个16A插座,也就是一次HTTP请求的事。希望这篇能帮到你,赶紧去试试把全公司的空调编组管理起来吧!