CATALOG

这是一篇关于如何将芯步智能触摸墙壁开关2路集成到你自有项目中的解决方案。我会尽量写得通俗、口语化一些,不讲复杂的底层原理,直接从“怎么调通”和“怎么用到业务里”入手。

一、 这东西能干嘛?

说白了,这就是一个长得好看的86式墙壁开关,只不过它连了WiFi。你可以把它想象成一个“手臂”,而你的服务器或小程序就是“大脑”。

在无人值守场景(比如共享棋牌室、自习室、茶室)里,它主要干两件事:

  1. 人肉按:客人走进黑乎乎的包间,用手指戳一下,灯亮了。

  2. 远程掐:客人在手机上点“结束订单”,系统自动把灯和电给掐了。

为什么选它? 因为它开放 HTTP 接口。不管你是用 Java 写后端、用 Node.js 写脚本,甚至是用 Excel 的 VBA,只要能发 HTTP 请求,就能管住这盏灯。

二、 准备工作:拿到“遥控器”的钥匙

在写代码之前,需要先把设备和你的账号绑在一起,流程非常简单:

  1. 注册与创建:去芯步官网注册个账号,创建一个“工作台”(可以理解成一个项目空间)。

  2. 设备配网:这步稍微动手。用微信小程序或电脑后台,给开关连上现场的 2.4G WiFi

    • 注意:必须用 2.4G,5G 频段它不认

    • 技巧:现场配网时,可能需要用手机热点模拟一下环境,总之确保开关的指示灯不闪了,常亮代表联网成功。

  3. 找到身份证:在控制台里找到你刚添加的那个设备,复制下那串 Device ID(设备ID)。这就是你开关的唯一身份证。

搞定这一步,你的开关就“在线”了,接下来才是真正的集成。

三、 动手集成:就这么几行代码

这是最爽的部分。芯步的接口设计得比较良心,不用看长篇大论的文档。

接口地址(POST请求):https://api.thingboot.com/{你的AppID}/device/control/

需要携带的参数(放在 Body 里):

  • device:刚才记下的设备ID。

  • order:你要下达的命令(JSON格式)。

最核心的命令示例:

假设你要控制 “第一路” (比如左键控制的主灯):

  • 开灯{"power1":"1"}

  • 关灯{"power1":"0"}

假设你要控制 “第二路” (比如右键控制的排气扇或灯带):

  • {"power2":"1"}

  • {"power2":"0"}

实战代码(随便挑一种):

语言/场景核心逻辑适合谁
Node.js (后端)req.write("device=设备ID&order={\"power1\":\"1\"}")写小程序/网页后端
Pythonrequests.post(url, data={'device':'xxx', 'order':'{"power1":"0"}'})数据分析或快速脚本
前端 注意直接调用会暴露 AppID!请一定要通过后端转发防止被恶意利用

避坑提示:千万不要在前端网页或未加密的 App 里直接暴露 AppIDSign(签名),否则别人抓到包就能随便控制你的开关了。

四、 高级玩法:这才是“无人值守”的精髓

光会远程开关不够,我们要的是自动化。结合这个开关的“高级命令”和业务逻辑,会爽很多。

1. 第一种场景:人走灯灭 + 自动断电

应用场景:共享棋牌室/茶室,用户在小程序点“续费失败”或“订单结束”。

  • 业务逻辑:订单结束 → 调用接口关灯关电。

  • 进阶玩法:你可以搭配一个人体传感器。如果房间没人且订单结束,直接 {"power1":"0"} 关总闸。如果房间没人但灯还亮着(客人忘了关),系统后台可以自动巡检把这路电切了,省点电费

2. 第二种场景:防占座/定时闪烁提醒

应用场景:时间快到了,怎么提醒客人?

  • 业务逻辑:利用“先通后断”或“闪烁”功能。

  • 代码效果{"point1":"2000"} —— 让灯先通电(亮),维持2秒后自动断电。

  • 实际体验:剩余时间5分钟时,让灯闪三下;剩余1分钟时,让灯保持常亮;时间到后,直接断电。这种物理提醒比手机弹窗管用多了。

3. 第三种场景:锁定状态(防手贱)

应用场景:清洁模式 or 外人勿入。

  • 问题:保洁阿姨在打扫,总有人路过把灯按开。

  • 解决:命令 {"power1":{"keep":"0","revert":"9999"}}。这时如果有人手贱按开关,灯虽然会亮,但 9999 秒后(或者你设定的时间)会自动关掉,或者直接忽略用户的物理按键操作。这在远程管理里非常实用。

五、 如果不想走外网?局域网/私有化

有些朋友做的是军工、医院或者极度隐私的项目,不想数据经过芯步的云服务器。这开关支持纯局域网控制你可以在本地部署一套服务器,把 API 请求指向本地的 IP 地址。这样一来,即使外网断了,你的内网系统依然能控制开关。如果你的项目对网络要求比较高,买的时候记得问清楚客服怎么切到局域网模式。

六、 总结一下集成步骤

  1. 接线:找个电工师傅,按照说明书把开关接到灯和电路里,其实就是替换传统开关(注意:必须接零线)。

  2. 配网:拿手机 App 把开关连上现场 WiFi。

  3. 开发:后端写一个 HTTP 工具类,把 AppIDDeviceID 配好。

  4. 联调:调通 power1:1 接口,灯亮了,恭喜你,搞定了。

  5. 业务绑定:把“物理世界的灯”和“逻辑世界的订单”绑在一起。订单开始 -> 开灯;订单结束 -> 关灯。

这玩意本质上就是一个 “通过网络控制继电器闭合”的工具。一旦你想通了这点,你会发现它的应用场景远不止灯。接个门锁电机,就是门禁;接个水泵,就是智能灌溉。放开了玩吧!