CATALOG

壁挂式“双模”存在监测模块的“感应延时”设置,本质上是修改设备内部雷达传感器的灵敏度参数或触发后的冷却时间。芯步的开放接口采用标准HTTP协议,通过向设备下发特定JSON指令即可完成设置。以下是完整对接方案。

解决方案:基于开放API对接壁挂式“双模”存在监测模块实现感应延时设置

1. 准备工作与环境分析

在开始对接前,需要明确“感应延时”的逻辑。通常,存在传感器在检测到无人状态后,会等待一个预设的持续时间(即延时),才会将状态从“有人”切换为“无人”。

  • 适用场景:办公节能控制(人离开后延时关灯)、安防布防(避免频繁误报)。

  • 技术前提:确保传感器已通电并联网,获取其唯一的设备ID(Device ID)。

  • 接口特点:芯步提供标准的HTTP API,支持公网局域网(局域网IP地址需在控制台查看或设置)控制,响应速度通常在80-120ms

2. 接口鉴权与寻址

所有控制命令均通过POST方法提交,地址结构如下:http(s)://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}

  • 核心鉴权字段

    • AppID: 平台为应用生成的唯一标识。

    • ts: 当前Unix时间戳(秒)。

    • sign: 签名,计算方式为 md5( md5(AppSecret) + ts )

(注:若在局域网环境且已知设备IP,可采用局域网API直连,响应更快,寻址方式参考设备网络配置文档)

3. 延时设置核心指令下发

壁挂式“双模”存在监测模块(通常属于雷达/红外类传感器)的延时参数通常通过特定的order对象进行配置。

目标:将感应延时设置为30秒(即人离开后30秒,设备上报“无人”状态)。

请求示例(JSON)

代码实现逻辑(通用伪代码)

  1. 构造参数:获取当前时间戳ts和计算签名sign

  2. 发起请求:将上述JSON作为Body,Header设置Content-Type: application/json

  3. 处理响应:检查返回状态码,200通常代表指令执行成功。

注:根据产品库信息,radar_enable用于控制雷达模块开关,部分型号的延时参数需参考具体产品手册

4. 延时效果的逻辑验证

由于传感器是“上行”设备(主动上报数据),下发命令后,无需轮询查询,只需监听设备上报的消息即可验证。

  • 验证方法

    1. 触发传感器(人在传感器前移动),设备上报“有人”事件。

    2. 人员离开监测区域。

    3. 观察设备上报“无人”事件的时间戳是否正好为离开后的第30秒。

  • 异常处理:若延时未生效,检查order中是否包含了必须的启动参数(如radar_enable);若传感器支持灵敏度调节,过高的灵敏度可能导致延时计数被环境杂波不断重置

5. 进阶与联动策略

设置延时的最终目的是为了实现更智能的联动。

  • 多指令复合:在设置延时的同时,可以一并下发其他配置。例如同时关闭指示灯以避免光污染:

  • 服务端逻辑:不要在断网或弱网环境下单纯依赖本地延时,可以在您的服务器端做二次逻辑判断。例如:传感器上报“无人”后,服务器等待5秒再查询一次状态,若确认为无人再执行关灯动作,这样可以增加系统的鲁棒性

总结

对接芯步壁挂式“双模”模块进行延时设置,核心在于掌握 device/control 接口的签名机制,并准确下发包含 delay 参数的 order 指令。通过该接口,开发者可以轻松地将物理硬件的感应逻辑融入到软件系统的业务流程中。