芯步的壁挂式“双模”存在监测模块支持HTTP接口直接调用,整个接入流程其实不复杂。下面我把从配网到获取数据、控制设备的完整方案整理出来,你可以按步骤来操作。
一、准备工作:认识你的“主角”
首先,我们今天要搞定的硬件是 “智能人体存在雷达和烟雾传感器[壁挂]” (名字有点长,后面我就叫它“壁挂“双模”模块”吧)。
这玩意儿有啥本事呢?它其实是个“双面间谍”:
雷达模块:负责探测微动,比如你在那儿坐着敲键盘,呼吸起伏它都能感觉到。
红外模块:负责探测明显的热源移动。
它判断“有人”的逻辑比较严谨:只有雷达和红外都觉得“没人”了,它才敢上报“无人”,这样就极大减少了误报(比如对着风扇吹导致误判的情况)。
既然是“芯步”家的,它们的产品有一个对开发者比较友好的地方:直接走HTTP协议,不需要搞复杂的网关硬件。只要设备连上了WiFi,你后端服务器就能直接调它。
二、核心思路:怎么“聊”?
我们不搞复杂的嵌入式开发,走的是“云对云”或“端对云”的路线。
架构大概是这样的:你的服务器 <> 芯步云平台 <> 壁挂传感器(通过WiFi)
芯步的云平台已经把硬件的接口封装好了,你不需要知道底层雷达是怎么滤波的,你只需要给你的后端程序员看这个文档,让他们调接口就行了。
几个关键词你得知道:
AppID / AppSecret:相当于你家的“门牌号”和“钥匙”,在芯步工作台里生成。
Device ID:每一个传感器的身份证号。
Sign(签名):为了防止接口被随便调用,每次请求都要加个密,虽然听着麻烦,但代码也就几行的事。
三、详细步骤:手把手教你“连”
为了方便理解,假设我们有一个场景:办公室需要检测到有人就开灯,没人就关灯。
第一步:物理接线 & 配网(拿到手先通电)
接线:这玩意儿一般是220V供电(也有低压版,看你买哪个),把火线零线接好。注意安全!如果是DC版,插上USB或接电源。
配网:这时候你需要下载“芯步”的App或者在他们的小程序里。
打开App,添加设备,搜索这个“壁挂“双模”模块”。
输入你家路由器的2.4G WiFi密码(注意:不支持5G WiFi,这点要记住)。
听到设备“滴滴”或者指示灯变了,就说明连上网了。
第二步:找“钥匙”和“地址”(后端准备工作)
让你的后端同学登录,做两件事:
拿AppID和AppSecret:在“开发设置”里,这两串字符是调接口的凭证。
拿到Device ID:在“设备列表”里,找到你刚才配网的那个设备,复制那一串ID。
第三步:写代码调接口(核心逻辑)
这是比较关键的部分。你需要调用的接口地址是:https://api.thingboot.com/{你的AppID}/device/control/?sign={签名}&ts={时间戳}
1. 怎么算签名?稍微有点绕,但照着文档写很容易:
签名 = md5( md5(AppSecret) + ts )注:ts是当前时间的秒数戳。
2. 怎么查“有没有人”?很多新手可能会问:“是不是要不停去问传感器?”其实不用。芯步的机制是 “主动上报” 。
你只需要在你的服务器配置一个“接收地址”(比如
http://你的域名/api/receive)。只要有人进出,传感器会立刻把状态推到这个地址。
上报的数据长啥样? 大概是
{"infrared_target": 1}(1代表有人,0代表无人)。
3. 如果我就是要主动查状态怎么办?也行。你可以发一个查询命令,或者直接等它定时上报。但为了省流量和省资源,让设备主动推。
4. 实现“有人开灯/关灯”的逻辑虽然传感器本身自带一个“继电器”(就是可以直接输出开关信号),但既然你问的是“开放接口”,那玩法就更灵活了:
你的服务器收到“有人”信号 -> 调接口控制智能开关或灯带。
伪代码示例(用curl命令演示,方便测试):
第四步:调试与坑位预警(稍微注意一下)
“双模”的特性(比较重要)
别急:雷达检测是持续的,但为了防止误报,它可能有个延时。比如你设置了“无人延时2分钟”,那人走了得等2分钟它才报“无人”,这是为了避免你在里面静止不动它误关灯。这个参数可以在工作台“产品定义”里调。
灵敏度:如果你发现它老误报,去后台把“红外无人触发持续时间”调长一点。
网络问题
这玩意儿只认2.4G WiFi。如果你们公司WiFi是混合的,记得关掉5G频段或者用访客网络。
调试模式
刚开始写代码如果一直报“签名错误”,记得去后台打开 “调试模式” 。在调试模式下,它不校验签名和时间戳,你可以先用Postman把逻辑跑通,最后再关掉调试模式去算签名。这是一个很方便的功能。
四、总结一下
总的来说,用芯步这个壁挂“双模”模块实现人体感应,其实就是在做三件事:
配网:让设备上网。
订阅/接收:让设备知道你的服务器地址(通过配置HTTP推送),把人来了这个消息推给你。
执行:你的服务器收到消息后,通过开放接口去控制灯或者其他设备。
如果你只是想单纯做个测试,不想写代码,直接用芯步控制台里的 “API调试工具” ,输入Device ID和命令 {"radar_enable":1},如果返回成功,说明设备活得好好的,剩下的就是后端同学把签名算法搞定就行了。