如何二次开发壁挂式红外雷达存在感应器来实现人体存在联动控制_解决方案

CATALOG

壁挂式红外雷达存在感应器的核心价值在于“静态人体探测”——普通红外传感器无法感知静坐、睡眠状态的人体，而毫米波雷达能捕捉呼吸等微动体征。以下方案基于芯步开放接口，实现有人/无人状态实时联动控制灯光、空调等设备。

1. 背景与概述

在智能家居、智慧办公及节能控制场景中，传统红外传感器往往无法探测静坐、睡眠等静态人体状态，容易导致“人在灯灭”的误判。为了解决这一问题，芯步推出了壁挂式红外雷达存在感应器。该设备融合了红外与毫米波雷达技术，能够精准探测微动甚至静态人体存在。

本方案的目标是指导开发者利用该硬件产品的开放HTTP接口，将其接入自有系统（如Web/APP/小程序），实现“人来灯开、人走灯关”或与其他设备联动的智能化控制。方案核心在于通过二次开发对接设备上报的“有人/无人”状态，并下发指令至执行设备。

2. 核心技术原理

本方案涉及的产品为智能人体存在红外和雷达传感器[壁挂]。其工作原理是通过雷达模块发射电磁波并接收人体反射回波，结合红外辅助探测，以此判断空间内是否有人体存在。

探测精度：静态人体微动可被雷达模块捕捉，解决了传统PIR红外在人体静止时无法触发的痛点。
状态上报：当环境状态（从有人变为无人，或无人变为有人）发生变化时，设备会主动向预设的服务器地址推送实时状态数据。

3. 二次开发环境准备

在进行二次开发前，需要完成以下准备工作：

硬件准备：获取“壁挂式红外雷达存在感应器”并接通电源。
账号与工作台：访问芯步官网注册账号，并创建“工作台”以管理设备。
获取关键凭证：在管理后台的“开发设置”中获取：
- AppId：应用唯一标识。
- AppSecret：接口加密密钥（用于生成签名）。
网络配置：设备仅支持2.4G WiFi。有两种配网方式：
- 小程序配网：通过“芯步”小程序，录入现场的WiFi名称和密码，利用手机热点模式让设备连接网络。
- 控制台配网：在物联网控制台的“网络配置”中登记WiFi信息，并推送给设备。

4. 接口对接与联动实现

4.1 数据接收（消息推送机制）

传感器采用“上行消息”机制。当检测到人体存在状态变化时，设备会将消息推送到开发者指定的服务器地址。

核心逻辑：设备不主动寻找服务器，而是开发者在后台配置接收URL。
状态属性：当红外或雷达模块检测到状态变化时，系统上报的事件名称为 infrared_target（红外感应）及雷达相关参数。
- 1：有人
- 0：无人

4.2 控制指令下发（API调用）

若需要联动其他设备（如关闭插座、开关灯），需调用设备控制接口。

接口地址http(s)://api.thingboot.com/{AppId}/device/control/

签名算法为了安全性，接口需要携带签名（sign）。算法步骤如下

将 AppSecret 进行 MD5 加密：secret_md5 = md5(AppSecret)
拼接时间戳：tmp_str = secret_md5 + ts （ts为Unix时间戳，秒）
再次MD5得到最终签名：sign = md5(tmp_str)

请求示例（JSON）

4.3 联动控制流程图

整个二次开发的逻辑闭环如下：

设备探测：雷达传感器检测到人体进入。
数据上报：设备通过HTTP POST请求，将 infrared_target=1 发送至开发者后端。
逻辑处理：开发者后端接收数据，解析状态码，执行业务逻辑（例如：查询时间段、环境亮度等）。
指令下发：后端调用控制接口，向照明开关或智能插座下发 {"power":1} 命令。
执行动作：执行设备打开灯光/空调。

5. 关键命令与属性定义

在二次开发编写代码时，需对照产品的“物模型”进行变量定义。以下是该壁挂传感器的主要属性

功能模块	命令/属性	数据类型	值含义	说明
雷达模块	`radar_enable`	下发命令	1：开启 / 0：关闭	远程控制雷达探测开关
红外感应	`infrared_target`	上报状态	1：有人 / 0：无人	核心联动触发点
线路控制	`power`	下发命令	1：通 / 0：断	控制传感器本身的输出线路
LED指示灯	`led`	下发/配置	1：长亮 / 0：长灭	设置设备状态灯模式
无人触发延时	`infrared_change_0`	设备配置	单位：秒	配置无人状态触发后的延迟上报时间

6. 代码实现核心逻辑（伪代码示例）

以下以Node.js为例，展示服务端如何接收传感器上报并下发控制指令：

// 1. 启动HTTP服务接收设备上报的数据 (需将接收URL配置到芯步后台)
app.post('/api/sensor/callback', (req, res) => {
    const { device, infrared_target } = req.body; // 解析上报数据 {infrared_target: 1}
    
    if (infrared_target === 1) {
        console.log(`设备 ${device} 检测到有人，正在联动开灯...`);
        // 2. 调用芯步API，控制另一台开关设备
        controlDevice(device_light_id, 1);
    } else if (infrared_target === 0) {
        console.log(`设备 ${device} 无人，正在关灯...`);
        controlDevice(device_light_id, 0);
    }
    res.status(200).send('success'); // 必须返回响应，否则设备会重试
});

// 生成签名并下发指令
function controlDevice(deviceId, powerStatus) {
    const ts = Math.floor(Date.now() / 1000);
    const step1 = crypto.createHash('md5').update(AppSecret).digest('hex');
    const sign = crypto.createHash('md5').update(step1 + ts).digest('hex');
    
    const url = `https://api.thingboot.com/${AppId}/device/control/?sign=${sign}&ts=${ts}`;
    const data = { device: deviceId, order: { power: powerStatus } };
    
    axios.post(url, data).then(response => {
        console.log('联动控制成功:', response.data);
    });
}

7. 私有化与高级配置

对于一些高安全场所（如医疗、军工或企业内部系统），芯步支持私有化部署。

方案：设备数据可直接推送到局域网内的服务器IP，无需经过外网云端。
配置：在设备配置项中，将服务器地址修改为本地服务器的IP和端口。
固件：产品手册中包含详细的配置项说明（如红外触发的持续时间、线路开机状态等），开发者可根据实际场景调整传感器的灵敏度和上报频率，以匹配不同场景的需求。

8. 总结

通过芯步壁挂式红外雷达存在感应器的开放HTTP接口，开发者可以在数小时内完成从“设备配网”到“代码对接”的全过程。该方案不仅解决了传统红外感应器“静默误判”的痛点，其无网关的直接WiFi连接方式也降低了硬件成本及系统复杂度。开发者只需关注自身的业务逻辑（如：是否在特定时间段启用联动、是否需要叠加光线传感器判断），即可快速构建稳定、智能的人体存在联动控制系统。