CATALOG

芯步的智能墙壁开关开放标准HTTP接口,任何会发HTTP请求的编程语言都能调用。下面我从选型、接口对接、代码示例到业务场景,一步步说清楚怎么把它集成到你自己的系统里。

小型商铺照明管理解决方案:基于芯步智能开关1路的项目集成

你好,开发者!

如果你是那种既想把实体店的照明搞成智能化的,又不想被某个特定的 App 绑死,想把控制权掌握在自己手里(比如集成到你给商铺定制的小程序或者后台系统里),那么选芯步这类的硬件其实挺省心的。

他们的产品主打的就是“开箱即连”和“纯 API 控制”。下面我们就以 “智能触摸墙壁开关1路” 为例,聊聊怎么把它放进你的项目里。

第一步:选硬件与准备“钥匙”

1. 选哪个型号?针对小型商铺,选 智能触摸墙壁开关1路

  • 为啥是它? 商铺通常是单火控制(很多老店铺没有零线),这款支持单火线安装,直接替换原来的 86 盒开关就行,不用砸墙重新布线

  • 外观: 选钢化玻璃面板的,放在店里看着有档次

2. 开发前的准备(3分钟搞定)你需要拿到三样东西,这相当于你开门的“钥匙”:

  • AppID(应用ID):去芯步控制台注册,创建个项目就有了。

  • AppSecret(应用密钥):这个要保密,相当于密码。

  • Device ID(设备ID):把开关通上电、连上网后,在后台就能看到这个设备的编号。

小贴士:他们是不需要网关的,开关直接连店铺的 2.4G WiFi,省了一个设备的钱

第二步:核心接口对接(其实就一个地址)

这个产品的接口设计得很直白,没有复杂的物联网协议,就是标准的 HTTP POST 请求。

1. 接口地址(Endpoint)

2. 鉴权机制(Sign生成)这是唯一稍微需要动点脑子,但其实照着文档写就行的部分。算法通常是:Sign = md5( md5(AppSecret) + ts )

简单说就是把你的密钥 MD5 加密一次,然后加上当前时间戳,再整体 MD5 一次。

3. 请求体(Body)这是最关键的部分,告诉开关你要干什么。

  • power1:代表第1路(因为是1路开关,就只有这一路)。

  • "1":代表开启;"0" 代表关闭

第三步:实战代码片段(复制就能用)

不管你后端用什么语言,原理都一样。这里给一个 Node.jsPython 的例子,都是比较常用的。

场景:商铺打烊了,API 远程关灯。

Node.js (axios) 示例:

Python (Flask 或 脚本) 示例:

第四步:进阶玩法(不止是开关灯)

如果只是远程开关,那就太无聊了。你可以利用它的特色命令,做出更贴合商铺场景的功能。

1. “客人离开忘关灯”怎么破?商铺经常有客人走了,店员没注意,灯开了一整夜。你可以写一个定时任务,比如每晚 23:00,自动调用上面的接口关一次灯。不需要人工巡检。

2. “人体感应联动”怎么做?你可能会想接一个人体传感器,但那通常需要网关。如果是用这个开关,你可以利用它的 “先断后通”“点动模式”

  • 场景: 比如仓库的灯,想要按下开关后,亮 5 分钟自动熄灭。

  • 指令: 发送 {"reset1":"300000"}(单位毫秒)。这样既省电,又不需要额外买传感器。

3. 集成到你自己的小程序后台假设你给客户的商铺开发了一套 POS 系统。你可以在 POS 机结算页面加一个按钮叫 “清场模式”

  • 逻辑: 点击按钮 -> 调用关灯接口 -> 同时触发音响播报“感谢光临”。

  • 效果: 店员收银完毕,一键关灯,科技感拉满。

踩坑与避坑指南

  1. 关于 WiFi:这个开关只支持 2.4G WiFi,不支持 5G。店铺里如果用的是双频合一的路由器,最好在后台把 2.4G 和 5G 分开,让开关连 2.4G 的那个,不然配网容易失败

  2. 关于签名(Sign):时间戳 ts 的误差不能太大,确保你的服务器时间和北京时间是同步的,差太多接口会报错。

  3. 关于本地控制:虽然用了 HTTP 接口,但如果外网断了,店员按墙壁上的物理按键,灯依然能亮。这一点对商铺很重要,不能因为断网连灯都打不开。

总结

芯步的这款产品对于开发者来说非常友好,因为它没有复杂的配网协议(不需要去研究 MQTT 或者 CoAP),就是简单的 HTTP 请求。你只需要把那两三行签名算法搞定,剩下的就是调用 power1 去开关灯了。

你可以把它当成一个连接到 220V 电路上的网络按钮,完全受你的代码支配。不管你是用 PHP 写的后台,还是用 Node.js 写的服务,都能很轻松地把店铺的照明纳入到你的智能管理系统里。