芯步的智能墙壁触摸开关1路采用标准HTTP接口,这意味着无论你用Python、Java、PHP还是前端JavaScript,只要能把HTTP请求发出去,就能轻松对接。下面是一份完整的对接方案。
一、我们有什么?
芯步的智能墙壁触摸开关1路,说白了就是一个能联网的“电灯开关”。它的核心参数如下:
型号:UNI-KG-CM-1
控制路数:1路(也就是控制一条灯线)
通讯方式:WiFi 2.4G(不需要网关,直接连你家路由器)
安装方式:标准86底盒(换掉家里老开关就行)
核心亮点开放HTTP接口,不需要那些复杂的物联网协议
所谓的“1路”,就是它能控制一组灯。如果你家是双开/三开,就得买2路或3路的版本。
二、软件对接核心流程
对接的思路非常简单:你的软件通过HTTP请求,去调芯步的云平台API,云平台再把指令下发给家里的开关。
整个过程分三步走:
第一步:准备工作
注册账号:去芯步官网注册一个开发者账号
获取密钥:登录工作台,找到“开发设置”,拿到两个关键字符串:
AppID:你的应用身份标识AppSecret:你的应用密码(不要泄露)
配网:在手机App上把开关连上你家WiFi
第二步:搞定签名算法
芯步的接口用了签名验证,防止接口被别人乱刷。签名的生成规则如下
把
AppSecret做一次MD5加密把第1步的结果拼上当前时间戳
ts(单位:秒)把第2步拼出来的字符串再做一次MD5
用Python举例子:
第三步:发起控制请求
接口地址:https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}
请求方式是POST,Content-Type为application/json,请求体如下:
device:设备的唯一ID,可以在控制台查看order:控制命令。{"power1": 1}表示开第一路,{"power1": 0}表示关第一路
完整代码示例(Python版):
三、进阶玩法
除了简单的开关,这个开关还支持一些高级功能:
1. 状态保持:用户按了开关后,过几秒自动恢复
这个命令会让开关保持开启状态,如果用户手动关掉它,3秒后会自动再打开 。
2. 先通后断:开启后延时自动关闭
开关先接通,3000毫秒后自动断开,适合做门铃或临时照明。
3. 先断后通:关闭后延时自动开启
开关先断开,3000毫秒后自动接通 。
四、各语言快速对接参考
前端JavaScript
微信小程序:调用wx.request,用法和上面类似 。
Shell脚本:用curl,适合Linux服务器定时任务 。
五、部署方案选择
芯步支持两种部署模式:
公网模式:设备通过芯步的云平台控制,适合普通家庭场景
私有化部署:如果你的项目跑在纯局域网环境,可以把消息服务器部署在内网 。开关通过局域网直接跟你的服务器通信,不用走外网。
六、常见坑点提示
只支持2.4G WiFi:如果家里开了双频合一,大概率连不上。先把路由器5G频段关掉或拆分。
签名过期:时间戳误差会导致签名失效,记得确保服务器时间准确。
设备ID在哪找:登录控制台,设备列表里能看到设备ID 。