CATALOG

芯步的三路智能开关通过HTTP接口对接,其实比你想象的要简单——核心就是“签名计算+一条POST请求”。下面这份方案会从硬件准备、接口对接到底层代码实现都过一遍,你可以直接拿去参考。

解决方案:基于芯步开放接口的三路触摸控制开关对接指南

一、 痛点与目标

在很多办公空间、园区或智慧工厂项目中,照明能耗占总成本的比重不小,而且管理起来特别麻烦——保安得一层层去巡检关灯,体验很不好。

我们的目标是:把你项目里的照明设备换成芯步的智能开关,通过调用它那个极其简单的HTTP接口,实现三路照明的远程控制、定时关断和状态维持。

说白了,就是把物理按键的动作,变成你软件里的一个“开关按钮”。

二、 硬件准备

我们要用的硬件是:芯步【智能触摸墙壁开关3路】

  • 为什么选它? 它最大的好处是“无损安装”。标准的86型盒,如果你项目是旧改,直接替换原来的面板就行,不用重新凿墙布线。支持零火或单火布线,对施工队来说门槛很低。

  • 控制对象:虽然是“照明”管理,但这三条线路(L1, L2, L3)本质上是继电器控制。所以,除了接灯,你接排风扇、小功率电机啥的也行,把它当一个通用的三路干接点控制器用。

三、 对接核心:HTTP API 详解

这是最关键的一环。芯步的接口设计非常“友好”,没有复杂的物联网协议,就是标准的HTTP POST请求

1. 请求地址(URL)

  • AppId: 你在芯步控制台创建项目后拿到的。

  • sign: 签名,为了防止接口被别人随便调用,需要加密一下。

  • ts: 时间戳(Unix秒级)。主要是为了防止网络攻击,一般给你5分钟的有效期。

2. 请求体(Body)—— 核心命令这就是你要发给开关的指令。假设你的设备ID是 820720

  • 场景A:我要把第1路打开,第2路关闭,第3路打开

就是这么简单,power1 代表第一路,1是开,0是关

  • 场景B:“安全节能”的核心功能 —— 人体感应联动(自动关闭)很多项目要求做到“人走灯灭”,但你不想写复杂的定时任务?用它的 “保持/复位” 功能。假设你在厕所或走廊:用户按了开灯,或者人体传感器触发了开灯。我们需要下发命令:打开第1路,但强制要求30秒后必须自动关闭,就算用户忘了关也没事。

解读:keep:0 代表保持关闭状态?这里要仔细看一下文档。实际上逻辑通常是:让设备处于“临时”状态,revert 后面的数字是秒数。这个命令的效果是:无论用户怎么操作,30秒后设备尝试恢复到你设定的状态(关)。这对节能管理非常刚需。

  • 场景C:一键全开/全关有时候需要搞活动或者下班清场,直接操作三路:

四、 实战对接步骤:以 Python 和 JavaScript 为例

接口拼起来非常简单,芯步官网给的示例也很清楚。

第一步:计算签名为了防止别人伪造你的请求,需要把 AppSecret 和时间戳混在一起加密 算法是:sign = md5( md5(AppSecret) + ts )(注意:是先把AppSecret做一次MD5,得到的结果拼接时间戳字符串,再做一次MD5。)

第二步:写代码

Python 版(适合后端或脚本)

JavaScript (前端 / 小程序 / Node.js)后端有时候需要转发给前端,逻辑其实是一样的。

五、 进阶场景:联动与节能策略

单纯把开关接到项目里意义不大,我们要做的是“安全节能”。这里有几个落地:

1. 结合传感器实现“人来灯亮,人走灯灭”芯步除了开关,还有人体存在传感器。逻辑如下:

  • 你的服务器收到“传感器上报”的数据(有人)。

  • 你的代码判断逻辑 -> 调用上述 power1=1 接口 -> 开灯。

  • 设置定时任务:如果传感器连续 10 分钟 没有上报有人 -> 调用 power1=0 接口 -> 关灯。

  • 或者更简单的,直接用我们上文提到的 revert 参数,下发一个“保持开10分钟”的命令,省去你写定时器的麻烦。

2. 定时巡检与异常报警如果你的项目是园区管理,可以在后台写个 Cron 定时任务(例如凌晨1点)。

  • 调用接口查询设备状态(根据文档,通常也有状态查询接口或上行消息推送)。

  • 如果发现状态是“开”,直接下发全关命令(power1:0, power2:0, power3:0)。

  • 如果连续几天某个回路能耗异常(虽然开关本身不计量,但如果你是接了智能电表),可以联动切断。

3. 物理面板与软件的双向同步有个小细节要注意:芯步的这款触摸开关是 “状态同步” 的。什么意思呢?就是用户在墙上用手按了一下开关,这个状态是会主动上报给你的服务器的。

  • 好处:你的APP后台能实时显示真实的灯的状态,不会出现“APP显示关,灯实际亮”的尴尬情况。

六、 总结

将芯步的三路开关对接到你的项目中,技术上的门槛其实很低:

  1. 硬件上:只需要替换86盒开关,施工简单。

  2. 开发上:只要会 POST 请求,十分钟就能跑通第一个“开灯”指令。

  3. 价值上:通过 power1/power2/power3 的三路独立控制和定时复位功能,能很快搭建出一套节能、安全的照明管理系统。

你先去芯步官网的控制台,注册一个账号,然后申请一个免费的设备ID,用 Postman 软件直接发一条 {"power1":1} 的命令给设备。如果灯亮了,剩下的就是把上面的代码复制到你的项目里了。