CATALOG

芯步的智能硬件统一通过HTTP接口控制,壁挂式智能“双模”感应开关(一般属于传感器类)也走同一套流程。下面直接说人话,讲清楚怎么远程调参数。

一、搞清楚你的设备“听什么话”

首先得明白,虽然它叫“开关”,但“双模”感应开关主要是用来感知人的存在(红外+超声波“双模”)。你要远程配置的通常不是“开/关灯”,而是它的感应灵敏度延时时间光感阈值这些参数。

根据芯步的接口逻辑,所有设备(开关、传感器、插座)都是用同一套接口发命令,只是命令内容(order里面的东西)不一样

你要做的是先找到你这款“壁挂式智能“双模”感应开关”对应的产品手册。在芯步后台或者官网硬件中心,找到你这个具体型号,看它支持哪些“下行命令”。

大概率支持的命令长这样(具体以手册为准,我举个例子):

  • 设置灵敏度{"sens": 80} (把灵敏度设到80%)

  • 设置延时关闭{"delay": 300} (人离开后30秒关)

  • 设置光感阈值{"lux": 50} (低于50勒克斯才生效)

  • 开启/关闭雷达{"radar_enable": 1} (开启感应)

二、准备好你的“身份证”和“签名”

要远程发命令,你得证明“你是你”。就像登录微信要有账号密码,调接口需要 AppIDAppSecret

  1. 去芯步官网登录你的账号,进入“工作台” -> “物联网控制台” -> “开发设置”。

  2. 这里你会看到 AppID(你的账号ID)和 AppSecret(你的密码,注意保密)。

  3. 千万别直接把密码发出去!调用接口时,需要把密码做一下 MD5加密运算,加上时间戳,生成一个 sign(签名)

直白点说:平台不认明文密码,只认加密后的签名。代码里写死的是加密算法,而不是密码明文。

三、开始“打电话”给设备(调用接口)

地址(URL)https://api.thingboot.com/{你的AppId}/device/control/?sign={你的签名}&ts={当前时间戳}

方法: POST数据格式: JSON

请求体(Body)样例

假设你的设备ID是 123456789,你想把它的“有人延迟关闭时间”改成 500 秒,同时打开雷达感应。

提醒几个坑:

  • 参数名要对order 里面写什么,必须严格看产品手册。写错一个字母,设备就不理你

  • 返回200不代表设备执行了:接口返回 {"code":200} 只代表平台收到指令并发下去了,不代表你的开关真的配置成功了。如果设备离线(比如断电了),它收不到。想确认是否生效,要么等设备上报状态(消息推送),要么去看后台日志

四、如果你不想写代码,有傻瓜式办法

芯步后台其实自带 API 调试工具,不需要写代码也能测试。

  1. 在控制台找到“设备管理”,点进你这个感应开关的详情页。

  2. 找一个叫“调试”、“下发指令”或“API调试”的按钮。

  3. 直接在弹出的框里输入 JSON 命令(比如 {"delay":200}),点发送。

  4. 如果看到设备马上响应了(比如指示灯闪一下),说明命令写对了。这时候再把这段命令复制到你的正式代码里。

五、完整操作流程(实战步骤)

假设你刚买回来设备,准备配参数:

  1. 配网:用芯步小程序给设备连上 WiFi(必须2.4G频段)

  2. 找ID:在后台设备列表里,复制那一长串 设备ID

  3. 查手册:去“硬件产品”页面找到“壁挂式“双模”感应开关”,下载 产品手册,翻到“接口命令”那一章,确认你要改的参数的 Key 名称(例如是叫 delay 还是叫 timeout)。

  4. 组合命令:拼接 JSON:{"device":"你的ID", "order":{"参数名":"参数值"}}

  5. 发请求:用 Postman 或你的后端代码,带上动态生成的 sign,POST 到上面的地址。

总结

  1. 查手册确定命令格式。

  2. 算签名搞定安全验证。

  3. POST数据api.thingboot.com

如果用起来发现命令没反应,先检查签名对不对(最容易错),再检查设备是否在线。实在搞不定,芯步的客服群里直接喊工程师帮你看看签名算法,他们工程师免费指导的