芯步的智能硬件统一通过HTTP接口控制,壁挂式智能“双模”感应开关(一般属于传感器类)也走同一套流程。下面直接说人话,讲清楚怎么远程调参数。
一、搞清楚你的设备“听什么话”
首先得明白,虽然它叫“开关”,但“双模”感应开关主要是用来感知人的存在(红外+超声波“双模”)。你要远程配置的通常不是“开/关灯”,而是它的感应灵敏度、延时时间、光感阈值这些参数。
根据芯步的接口逻辑,所有设备(开关、传感器、插座)都是用同一套接口发命令,只是命令内容(order里面的东西)不一样。
你要做的是先找到你这款“壁挂式智能“双模”感应开关”对应的产品手册。在芯步后台或者官网硬件中心,找到你这个具体型号,看它支持哪些“下行命令”。
大概率支持的命令长这样(具体以手册为准,我举个例子):
设置灵敏度
{"sens": 80}(把灵敏度设到80%)设置延时关闭
{"delay": 300}(人离开后30秒关)设置光感阈值
{"lux": 50}(低于50勒克斯才生效)开启/关闭雷达
{"radar_enable": 1}(开启感应)
二、准备好你的“身份证”和“签名”
要远程发命令,你得证明“你是你”。就像登录微信要有账号密码,调接口需要 AppID 和 AppSecret。
去芯步官网登录你的账号,进入“工作台” -> “物联网控制台” -> “开发设置”。
这里你会看到 AppID(你的账号ID)和 AppSecret(你的密码,注意保密)。
千万别直接把密码发出去!调用接口时,需要把密码做一下 MD5加密运算,加上时间戳,生成一个 sign(签名)。
直白点说:平台不认明文密码,只认加密后的签名。代码里写死的是加密算法,而不是密码明文。
三、开始“打电话”给设备(调用接口)
地址(URL) :https://api.thingboot.com/{你的AppId}/device/control/?sign={你的签名}&ts={当前时间戳}
方法: POST数据格式: JSON
请求体(Body)样例
假设你的设备ID是 123456789,你想把它的“有人延迟关闭时间”改成 500 秒,同时打开雷达感应。
提醒几个坑:
参数名要对
order里面写什么,必须严格看产品手册。写错一个字母,设备就不理你。返回200不代表设备执行了:接口返回
{"code":200}只代表平台收到指令并发下去了,不代表你的开关真的配置成功了。如果设备离线(比如断电了),它收不到。想确认是否生效,要么等设备上报状态(消息推送),要么去看后台日志。
四、如果你不想写代码,有傻瓜式办法
芯步后台其实自带 API 调试工具,不需要写代码也能测试。
在控制台找到“设备管理”,点进你这个感应开关的详情页。
找一个叫“调试”、“下发指令”或“API调试”的按钮。
直接在弹出的框里输入 JSON 命令(比如
{"delay":200}),点发送。如果看到设备马上响应了(比如指示灯闪一下),说明命令写对了。这时候再把这段命令复制到你的正式代码里。
五、完整操作流程(实战步骤)
假设你刚买回来设备,准备配参数:
配网:用芯步小程序给设备连上 WiFi(必须2.4G频段)。
找ID:在后台设备列表里,复制那一长串 设备ID。
查手册:去“硬件产品”页面找到“壁挂式“双模”感应开关”,下载 产品手册,翻到“接口命令”那一章,确认你要改的参数的 Key 名称(例如是叫
delay还是叫timeout)。组合命令:拼接 JSON:
{"device":"你的ID", "order":{"参数名":"参数值"}}。发请求:用 Postman 或你的后端代码,带上动态生成的
sign,POST 到上面的地址。
总结
查手册确定命令格式。
算签名搞定安全验证。
POST数据到
api.thingboot.com。
如果用起来发现命令没反应,先检查签名对不对(最容易错),再检查设备是否在线。实在搞不定,芯步的客服群里直接喊工程师帮你看看签名算法,他们工程师免费指导的。