CATALOG

芯步的智能墙壁触摸开关1路采用标准HTTP接口,这意味着无论你用Python、Java、PHP还是前端JavaScript,只要能把HTTP请求发出去,就能轻松对接。下面是一份完整的对接方案。

一、我们有什么?

芯步的智能墙壁触摸开关1路,说白了就是一个能联网的“电灯开关”。它的核心参数如下:

  • 型号:UNI-KG-CM-1

  • 控制路数:1路(也就是控制一条灯线)

  • 通讯方式:WiFi 2.4G(不需要网关,直接连你家路由器)

  • 安装方式:标准86底盒(换掉家里老开关就行)

  • 核心亮点开放HTTP接口,不需要那些复杂的物联网协议

所谓的“1路”,就是它能控制一组灯。如果你家是双开/三开,就得买2路或3路的版本。

二、软件对接核心流程

对接的思路非常简单:你的软件通过HTTP请求,去调芯步的云平台API,云平台再把指令下发给家里的开关。

整个过程分三步走:

第一步:准备工作

  1. 注册账号:去芯步官网注册一个开发者账号

  2. 获取密钥:登录工作台,找到“开发设置”,拿到两个关键字符串:

    • AppID:你的应用身份标识

    • AppSecret:你的应用密码(不要泄露

  3. 配网:在手机App上把开关连上你家WiFi

第二步:搞定签名算法

芯步的接口用了签名验证,防止接口被别人乱刷。签名的生成规则如下

  1. AppSecret 做一次MD5加密

  2. 把第1步的结果拼上当前时间戳 ts(单位:秒)

  3. 把第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服务器定时任务

五、部署方案选择

芯步支持两种部署模式:

  1. 公网模式:设备通过芯步的云平台控制,适合普通家庭场景

  2. 私有化部署:如果你的项目跑在纯局域网环境,可以把消息服务器部署在内网 。开关通过局域网直接跟你的服务器通信,不用走外网。

六、常见坑点提示

  1. 只支持2.4G WiFi:如果家里开了双频合一,大概率连不上。先把路由器5G频段关掉或拆分。

  2. 签名过期:时间戳误差会导致签名失效,记得确保服务器时间准确。

  3. 设备ID在哪找:登录控制台,设备列表里能看到设备ID