CATALOG

芯步的智能墙壁开关3路提供了一套简洁的HTTP接口,核心思路就是向指定URL POST一条JSON命令,10分钟就能完成基础对接。下面从硬件准备到代码实现逐层拆解一下。

解决方案:把3路墙壁开关无缝接入你的软件

场景分析:假设你的客户是一个“共享自习室”或者“智能茶室”。他们每个房间都有照明灯、氛围灯带、排风扇(正好三路)。老板希望:

  1. 租客在线支付后,系统自动通电(开灯+开风扇)。

  2. 租客在手机上点“结束” ,自动断电。

  3. 老板在后台上,能随时看哪个房间的灯是开的,甚至能远程强制关闭。

这时候,把物理的“3路墙壁开关”变成“软件里的三个按钮”就是关键。

核心对接原理

其实非常简单,芯步的这系列开关本质上就是一个连上WiFi的继电器你不用关心它底层复杂的电路协议,只要通过它的开放HTTP API接口,向它发送一个“HTTPS请求”即可。

  • 硬件:智能墙壁开关3路(UNI-KZQ-ZM-3或类似型号)。

  • 控制方式POST 一个 JSON 字符串。

  • 响应速度:约80-120毫秒,基本感觉不到延迟

第一步:硬件准备与配网(傻瓜式操作)

虽然我们是写代码的,但得确保硬件能上网。

  1. 安装:把传统的86开关拆下来,直接平行替换上芯步的智能开关。注意,如果原来开关盒里没有零线,记得买“单火版”;如果有零线,买“零火版”更稳定。

  2. 配网

    • 下载“芯步”小程序或登录后台。

    • 把开关切换到配网模式(长按某键,指示灯闪烁)。

    • 用小程序给它输入现场的WiFi账号密码(注意只支持2.4G WiFi)。

    • 听到“滴”的一声,后台显示设备“在线”,这就搞定了

第二步:获取关键参数(开发准备)

你需要在后台拿到三把“钥匙”:

  1. AppID:标识你的应用是属于哪个开发者的。

  2. AppSecret:你的密钥,千万别泄露在前端代码里。

  3. Device ID:就是那个墙壁开关的序列号。比如 820720

签名计算(Sign):为了防止别人乱发指令控制你的灯,你需要做一个简单的MD5加密公式很简单(别怕):Sign = md5( md5(AppSecret) + ts )

  • ts:当前时间戳。

  • 说白了就是把你的密钥MD5一次,再拼上时间戳,再整体MD5一次。这样每个请求都是动态加密的,很安全。

第三步:代码实战(控制三路开关)

这里是核心,我们需要调用设备控制接口。假设你要把“第1路”和“第2路”打开,关掉“第3路”。

接口地址:http(s)://api.thingboot.com/{你的AppId}/device/control/?sign={计算出的签名}&ts={当前时间戳}

请求体 (Body):

举个栗子(假如你用Python):假设你正在写自习室的后台,用户支付成功了,你需要自动执行开灯开风扇。

就这么简单,当你运行这段代码,那个墙壁开关的指示灯瞬间就会跳变。

第四步:进阶玩法(让软件更智能)

只是远程开关太简单了,利用芯步接口里提供的参数,我们可以做更有意思的商业逻辑。

1. “先通后断”——设备保护模式你的客户可能租用2小时,但你担心客户直接暴力断电损坏灯泡?可以用这个命令。比如你要打开第一路,并确保它5秒后自动断开:

(这在共享设备租赁场景非常实用)

2. “状态保持”——防手贱模式自习室规定“必须开灯学习”,如果用户手贱去按墙壁开关把灯关了怎么办?你可以下发一个“保持”命令。比如:锁定第2路为开启状态。用户按了开关,2秒后它会自动弹回来(恢复开启)

3. 轮询状态——实时同步很多做软件的兄弟只关心发指令,忘了“同步状态”。如果用户手动按了墙上的开关,你的软件界面显示“开”,实际是“关”,这就不同步了。解决方案:芯步平台支持状态上报。当物理开关被按下时,它会主动推送一条消息到你的服务器(Webhook)。你需要写一个接收回调的接口,一旦收到消息,立刻更新你数据库里那个设备的状态。如果不想搞回调,也可以通过查询接口定时轮询设备状态。

总结落地步骤

  1. 买硬件:买个“芯步 3路智能墙壁开关”,装上通电。

  2. 配网:在小程序里把它连上网,记下Device ID。

  3. 写代码:复制上面的代码片段,把 AppIDSecretDevice ID填进去。

  4. 对接业务

    • 用户下单 -> 调用 power1=1

    • 用户超时 -> 调用 power1=0

    • 老板点“巡检” -> 调用查询接口,显示当前电压/状态。

这样一来,你的软件项目就拥有了“控制物理世界”的能力,只需要关注业务逻辑,硬件的事交给HTTP接口去操心就行。