CATALOG

芯步的开放接口走的是标准的HTTP/MQTT协议,一通百通。下面直接讲怎么把这些硬件串起来,实现“人到家灯亮、人走电断”这种联动效果。

一、 核心思路:把谁和谁连起来?

所谓的“场景联动”,简单说就是: “如果A设备发生了某事,就让B设备去做某个动作”。

在电源控制这个场景里,我们主要关注两类设备:

  1. 触发者(传感器/开关): 比如智能门磁人体红外传感器,或者你手机上的定位(GPS) 。它们是眼睛。

  2. 执行者(电源控制器): 比如芯步的4路智能控制器智能墙壁插座墙壁开关。它们是手。

我们的目标是:当“眼睛”看到了情况,就让“手”去接通或切断电源

二、 准备阶段:拿到“遥控器”的钥匙

要对硬件发号施令,得先拿到芯步开放平台给的权限。你需要先拿到三样东西:

  1. AppID(应用凭证):相当于你在芯步平台的“用户名”,用来标识是你的应用在调用接口

  2. 设备ID(设备身份证):每个硬件在云端的唯一编号。你可以在芯步的后台控制台找到,一般在设备外壳上也有标签

  3. Sign签名(安全钥匙):为了防止别人乱开你家的灯,每次发指令都需要用密钥生成一个签名,证明是你本人在操作

这里稍微直白点解释:你可以把开放平台当成一个快递系统。AppID是你的寄件人ID,设备ID是收货地址,Sign是快递单上的防伪码。你要控制电源,就是发一个“包裹”(指令)给快递系统,让它派送到对应的设备。

三、 实操环节:如何动手搭联动

这里不写复杂的代码,主要是讲逻辑。你可以用任何方式(小程序后台、Python脚本、甚至Node-RED)来发HTTP请求。芯步的接口支持 HTTP GET/POST 和 MQTT 两种方式

第一种场景:人来灯亮(人体感应触发插座通电)

需求:阳台晚上有人经过,自动亮灯(灯接在智能插座上)。方案

  1. 硬件:一个芯步人红外传感器 + 一个芯步智能墙壁插座(10/16A均可)

  2. 逻辑链路:红外传感器检测到人 -> 云端回调你的服务器 -> 你的服务器下发指令给插座 -> 插座闭合通电。

  3. 接口调试当你的服务器收到“有人”的消息后,需要向芯步平台发送一个控制请求。

    • 请求地址http(s)://api.thingboot.com/{你的AppID}/device/control/

    • 关键参数

      • device:填那个智能墙壁插座的设备ID。

      • order:填 {"power":1} (这里的 power 是属性名,1代表开,0代表关)。

    直白解释:就是你后台写一行代码,对着芯步的API喊一声:“把那个插座(device ID)给我打开(order)!”

第二种场景:离家一键全关(场景控制)

需求:出门按一下墙上的场景开关,或者手机点一下“离家模式”,全屋的灯和电器断电,但冰箱保留。方案

  1. 触发:手机APP发送“离家模式”指令。

  2. 批量控制:芯步的开放接口支持一次指令控制多台设备。你可以在 device 参数里用逗号连接多个设备ID

  3. 指令示例device=插座ID1,插座ID2,插座ID3&order={"power":0}

  4. 注意:官方文档一次最多控制100台,且这些设备必须有相同的指令(比如都是关)

第三种场景:设备间的本地联动(进阶)

如果你不想经过云端服务器(为了更快更稳),可以利用有的网关设备具备的边缘计算能力。但这通常需要你买一个网关(比如智能音箱或特定的边缘网关),在本地局域网里写规则。比如,在网关里设置:“如果门磁打开,则1号继电器闭合”。这个逻辑直接在网关里跑,断了外网也能用

四、 避坑指南:写在最后的叮嘱

在实际开发中,有几个点大家容易踩坑,尤其要注意:

  1. 状态反馈问题(异步确认)痛点:你发了开灯指令,平台返回200,这只代表指令平台收到了,不代表灯真的亮了(可能灯坏了或离线了)解法:如果需要确认是否真的通电了,你得去接收芯步平台的消息推送(Callback)。当设备状态真正改变时(比如继电器真的吸合了),平台会主动推一个消息给你,告诉你“成功”或“失败”。或者你直接调接口去查询设备状态。

  2. “保持”指令(点动模式)痛点:有些场景(比如控制电机、卷帘门)需要“按一下转3秒停”,而不是一直通电。解法:芯步的一些开关设备支持指令中的keep参数。如果你发给墙壁开关指令:{"power1":{"keep":"1","revert":"3"}},意思是“打开电路1,保持3秒后自动关闭”。这对于控制门锁、水泵等非常有用

  3. 网络延迟走云端控制一般会有零点几秒的延迟,如果对实时性要求比较高(像工厂急停),用MQTT协议维持长连接,或者依赖边缘计算在局域网内直接发指令

总结这张图

如果不写代码:你可以在芯步的SaaS后台直接配置“智能联动”,把传感器和执行器绑定,连代码都不用写。

如果要自己开发系统:记住这个三步走 ——

  1. :接收设备上报的消息(比如传感器触发了)。

  2. :根据你的业务逻辑判断(比如是否处于离家模式)。

  3. :调用/device/control/接口,把{"power":1}发给对应的电源设备。

插座产品方案:
商场设备电源控制:怎样把智能插座10A接入到自己的项目中
查看 >>
共享麻将馆灯光插座管理:怎么将DC-10A 电器开关集成到自己的项目中
查看 >>
景观亮化设备电源控制:怎样将10A86型定时开关插座对接到项目中
查看 >>
怎样在医院设备电源管理中对接智能设备以实现手机 APP 远程遥控
查看 >>
展会现场设备电源控制:如何将10A86型WiFi智能插座对接到项目中
查看 >>
家居场景方案:
智能家居照明设备控制:怎么把AC4-30A 自动化控制开关集成到软件项目中
查看 >>
智能家居:怎样把12路HTTP接口照明控制器对接到项目中
查看 >>
智能家居:如何将1路远程控制墙壁开关接入到项目中
查看 >>
智能家居照明门禁联动:如何将2 路智能触摸开关对接到自己的项目中
查看 >>
智能家居氛围灯光控制场景:怎么把智能 LED 灯情景控制模块集成到自己的项目中
查看 >>
场景用途方案:
如何二次开发AC4-30A 低压控制开关以实现场景联动控制
查看 >>
怎么二次开发一路门禁一路照明开关来实现场景联动照明门禁控制
查看 >>
怎样对接智能直流控制器4路以实现联动场景逻辑控制
查看 >>
怎么对接25A大电流智能断路器来实现场景联动控制
查看 >>
怎样对接3路智能触摸墙壁开关以实现客房场景化控制
查看 >>