CATALOG

这是一个基于芯步开放接口的解决方案。咱们今天就来聊聊,怎么用更“极客”一点的方式,把那些传统的灯管、排风扇或者不智能的设备,集成到你的总控系统里,实现单路电源的精准控制。

核心思路:把“开关”变成“接口”

传统的灯光控制,得让人跑到现场去按按钮。而我们要做的,就是利用芯步的智能硬件(比如智能墙壁开关、四路控制器),把物理上的“通”和“断”,转换成HTTP协议里的一句指令。

简单来说,你就是给设备发个网络请求,剩下的通断电操作,交给硬件去完成

第一步:选硬件——得有个“执行命令”的物件

要实现单路电源控制,你需要选对硬件。根据芯步的产品线,通常会选这两类:

  1. 智能墙壁开关(1路/2路/3路):适合直接替换家里的86型墙壁开关。如果你是想控制几盏灯,选它最合适,直接原位替换,不用改线路

  2. 智能照明控制器(如UNI-KZQ-ZM-4):这是个四路控制器,适合藏在设备柜里。比如你要控制四个不同的设备电源,或者控制整个楼层的多路灯光,用这个性价比很高

划重点:这些设备都是通过WiFi连网的,所以你现场要有2.4GHz的WiFi信号覆盖。

第二步:拿凭证——注册应用与获取密钥

在动手写代码之前,得先拿到“通行证”。去芯步的开放平台控制台,你需要做两件事:

  1. 获取AppID和AppSecret:这相当于你在芯步系统里的账号和密码,每一个API请求都要带上它来识别身份

  2. 添加设备:把你的智能开关或控制器配网,加到你的账号下。配网成功后,你会拿到一个关键的 Device ID(设备ID),等下就是通过这个ID去找对应的设备。

第三步:核心逻辑——发送控制指令

这是最关键的一步。芯步的接口非常“简单粗暴”——完全通过HTTP POST请求来控制。

1. 搞懂签名机制(Sign)

别看到签名就头大,芯步的签名逻辑其实挺顺的。当你发出请求时,为了防止别人伪造,需要生成一个sign。公式大概是这样的(根据官方文档描述):sign = md5( md5(AppSecret) + ts )

  • AppSecret:你的密钥。

  • ts:当前的时间戳(秒)。

  • md5:标准的加密算法

  • 实际操作:先把你自己的AppSecret做一次MD5,得到一串字符串,然后把这串字符串后面拼接上当前的ts时间戳,再把拼接后的整个字符串做一次MD5,得到的就是sign

2. 构造请求地址

地址格式如下,注意把{AppId}{sign}{ts}替换成真实的:http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

3. 核心“杀手锏”:Body参数(定义要控哪一路)

请求的时候,数据格式用JSON。这里以控制一个3路开关的第1路打开、第2路关闭为例:

是不是很直观?power1power2power3对应的就是设备的1、2、3路硬件接线口

第四步:实战场景与进阶玩法

掌握了上面的开关控制,我们就可以玩点花的了。

第一种场景:给鱼缸水泵定时(配合服务器)

假设你有一台养鱼的水泵,想让工作1小时,停半小时。你可以在自己的服务器上写个定时任务(Cron Job),每隔半小时调用一次API:

  • 如果水泵开了一小时,就发一条 {"power1": "0"} 关掉它。

  • 如果关了半小时,就发一条 {"power1": "1"} 打开它。

第二种场景:想只让灯“闪”一下(先通后断)

有时候我们不是想一直开或关,只是想给设备一个“脉冲”信号(比如按一下投影仪幕布的上升键,按一下就行,不需要一直按着)。芯步支持这种高级命令

第三种场景:查一下这个灯是开着还是关着?

用获取设备详情的接口,可以拿到当前状态。发送GET请求到 /device/info/,返回的数据里有个state字段: