1. 项目缘起为什么需要一个“存在感知”的温湿度计几年前我在家里折腾智能家居想实现一个很简单的场景当检测到客厅有人时自动打开空气净化器并根据温湿度调整工作模式。市面上的人体传感器不少但要么是简单的红外热释电PIR人不动就失效要么是毫米波雷达模块价格不菲且功能单一。至于温湿度虽然传感器遍地都是但很少有设备能把“环境感知”和“人体存在感知”这两件事无缝融合在一起并提供一个直观的本地化控制界面。于是SenseMate32这个想法就诞生了。它的核心目标很明确用最低的成本和最简单的硬件打造一个集成了高精度人体存在检测与温湿度监测的智能传感终端并且所有数据和控制都通过一个美观的Web界面在本地完成不依赖任何云服务。听起来像是把几个模块堆在一起其实远不止如此。难点在于如何让ESP32这颗“大脑”高效、稳定地协调LD2420毫米波雷达和AHT20温湿度传感器的工作处理它们的数据并构建一个响应迅速、信息丰富的Web服务器。这背后涉及到传感器驱动、数据滤波、WebSocket实时通信、前端数据可视化等一系列嵌入式Web开发的关键技术。经过几个版本的迭代和实测SenseMate32已经成为一个非常稳定可靠的小工具。它不仅能准确区分房间里是有人静坐、轻微活动还是无人状态还能同时提供精准的环境数据。所有这一切你只需要通过手机或电脑的浏览器输入设备的IP地址就能访问数据刷新几乎无延迟隐私完全掌握在自己手中。接下来我就把这个项目的完整实现过程、核心原理以及我踩过的那些坑毫无保留地分享出来。2. 硬件选型与核心模块深度解析SenseMate32的硬件架构非常清晰核心就是一块ESP32开发板外挂两个传感器模块。但每个部件的选型都经过了深思熟虑并非随意搭配。2.1 主控芯片为什么是ESP32在嵌入式物联网领域MCU的选择很多比如STM32、Arduino Uno、树莓派Pico等。我最终锁定ESP32是基于以下几个无法替代的优势双核处理器与丰富内存ESP32通常拥有两个Xtensa LX6核心主频可达240MHz并内置520KB SRAM和4MB Flash视具体型号。这对于我们的项目至关重要。我们可以将一个核心Core 0专用于运行Web服务器、处理HTTP/WebSocket请求、渲染前端页面另一个核心Core 1则全力负责高频次地读取LD2420雷达数据和AHT20传感器数据并进行实时滤波和算法处理。这种硬件级的并行处理能力确保了Web界面的流畅性与传感器响应的实时性不会相互拖累。相比之下单核MCU在同时处理网络和传感器任务时很容易出现界面卡顿或检测延迟。内置Wi-Fi与蓝牙这是ESP32的招牌功能。内置的Wi-Fi模块让我们省去了额外的网络芯片简化了硬件设计和成本。通过Wi-Fi设备可以轻松接入家庭局域网为Web UI提供访问通道。蓝牙则预留了未来进行蓝牙配网或与手机直接交互的可能性。完善的生态系统与开发便利性无论是使用官方的ESP-IDF框架还是更易上手的Arduino Core for ESP32都有海量的库和社区支持。像WebServer、WebSockets、ArduinoJson这些库都非常成熟能极大加速开发进程。对于LD2420和AHT20这类常用传感器通常也能找到经过验证的驱动库。注意ESP32型号繁多如ESP32-D0WDQ6、ESP32-S3等。对于本项目选择一款带有足够GPIO、且Flash不小于4MB的通用型号即可例如常见的ESP32 DevKitC或NodeMCU-32S开发板。避免使用内存过小的变体。2.2 存在感知核心LD2420毫米波雷达模块探秘人体存在检测是本项目的灵魂而LD2420正是实现这一功能的“眼睛”。它不同于传统的PIR传感器。PIR被动红外传感器的工作原理是检测人体发出的特定波长红外线的变化。它的致命缺点是必须要有相对运动才能触发。当人静止不动时红外辐射场稳定传感器就无法感知会导致“人在却判无人”的尴尬情况。这对于需要持续感知存在的场景如自动关灯、持续监测是不可接受的。LD2420毫米波雷达模块则采用了完全不同的原理。它主动发射频率为24GHz的毫米波并接收遇到物体后反射回来的回波。通过分析反射波的频率变化多普勒效应和相位差它可以检测微动即使是呼吸时胸部的微弱起伏也能引起回波频率的微小变化从而被检测到。测距可以大致判断目标物体与雷达之间的距离。区分动静通过算法能够区分目标是静止、微动还是大幅运动。LD2420通过UART串口与ESP32通信发送包含目标状态、距离、能量值等信息的结构化数据帧。ESP32解析这些数据帧通过一定的算法如能量阈值判断、持续时长判断来最终判定“有人”或“无人”状态。这种方式的可靠性和灵敏度远高于PIR。在硬件连接上LD2420通常只需要连接VCC、GND、TX、RX四根线到ESP32。需要注意的是LD2420的TX要接ESP32的某个RX引脚如GPIO16RX接ESP32的某个TX引脚如GPIO17。2.3 环境感知AHT20温湿度传感器环境监测部分我们选择了AHT20。这是一款性价比极高的数字温湿度复合传感器采用I2C接口通信。精度典型湿度精度为±2%RH温度精度为±0.3°C。对于家庭环境监测这个精度完全足够且比常见的DHT11湿度±5%温度±2°C要优秀得多。稳定性AHT20内部有专用的ASIC芯片、MEMs半导体电容式湿度传感元件和温度传感元件出厂经过校准长期稳定性较好。接口简单I2C接口只需两根线SDA, SCL可以方便地与ESP32的I2C引脚连接并且支持总线挂载多个设备。在ESP32上通常使用GPIO21作为SDAGPIO22作为SCL来构建I2C总线。AHT20的I2C地址通常是0x38。2.4 硬件连接总图与供电考量将所有模块连接起来模块引脚连接到ESP32引脚备注LD2420VCC3.3V务必接3.3V5V可能损坏模块GNDGND共地TXGPIO16 (RX2)雷达数据发送端RXGPIO17 (TX2)接收ESP32配置指令AHT20VCC3.3VGNDGNDSDAGPIO21I2C数据线SCLGPIO22I2C时钟线ESP32USB电脑USB用于供电和程序烧录供电注意整个系统可以由ESP32开发板的USB口供电5V输入板载LDO降压到3.3V。如果部署在远离插座的位置可以考虑使用一个5V/1A以上的移动电源或USB充电器供电。确保电源能提供足够的电流尤其在Wi-Fi高速传输数据时ESP32的峰值电流可能达到500mA。3. 软件架构设计与核心代码实现硬件是骨架软件才是灵魂。SenseMate32的软件架构设计遵循了“前后端分离嵌入式层面”与“事件驱动”的思想以保证高效和稳定。3.1 整体软件流程与双核任务分配程序上电后会依次进行初始化然后创建两个主要任务Task分别跑在两个CPU核心上。// 伪代码示意核心流程 void setup() { // 1. 初始化串口用于调试 Serial.begin(115200); // 2. 初始化传感器I2C总线、AHT20、雷达串口 initI2C(); initAHT20(); initLD2420(); // 设置串口波特率绑定数据解析函数 // 3. 连接Wi-Fi connectToWiFi(Your_SSID, Your_Password); // 4. 初始化Web服务器和WebSocket服务器 initWebServer(); // 设置路由如“/”返回HTML页面“/data”提供API initWebSocketServer(); // 用于向网页实时推送数据 // 5. 创建任务 xTaskCreatePinnedToCore( sensorReadingTask, // 传感器数据读取任务函数 SensorTask, // 任务名 4096, // 栈深度 NULL, // 参数 1, // 优先级数字越大优先级越高 sensorTaskHandle, // 任务句柄 0 // 指定运行在核心0 (Core 0) ); // Web服务器事件循环通常在主循环loop中运行默认使用核心1 (Core 1) // 或者也可以创建单独任务但Arduino的WebServer库事件循环在loop中处理更方便 } void loop() { // 处理Web服务器客户端请求 webServer.handleClient(); // 处理WebSocket事件 webSocket.loop(); // 可以添加一些低优先级的后台任务 delay(2); // 短暂延时让出CPU时间 } // 运行在核心0上的传感器任务 void sensorReadingTask(void *pvParameters) { for (;;) { // 1. 读取AHT20数据频率较低如每2秒一次 readAHT20Data(); // 2. 检查并解析LD2420串口数据频率高循环处理 processLD2420Buffer(); // 3. 融合数据判断最终的存在状态 determinePresenceStatus(); // 4. 将最新数据存入全局变量并通过WebSocket广播 broadcastDataViaWebSocket(); // 任务延时控制循环频率 vTaskDelay(10 / portTICK_PERIOD_MS); // 例如每10ms循环一次 } }这种设计确保了传感器数据采集的实时性不受网络请求处理的影响。WebSocket用于将传感器数据主动、实时地推送到已连接的网页客户端避免了网页反复轮询Polling带来的延迟和服务器压力。3.2 LD2420数据解析与存在判定算法LD2420会通过串口持续发送数据帧。帧格式通常是固定的包含帧头、数据长度、各种运动/静止目标的距离和能量值、帧尾校验等。解析的关键步骤串口数据接收在serialEvent2()如果使用Serial2或循环中读取串口数据存入缓冲区。帧同步在缓冲区中寻找固定的帧头例如0xF4, 0xF3, 0xF2, 0xF1。长度校验根据帧头后的长度字段检查缓冲区中是否收到了完整的一帧数据。数据提取按照协议解析出各个“距离门”的能量值。LD2420将检测区域分成多个距离段如0-0.75m, 0.75-1.5m...每个段返回一个能量值。状态判定这是算法的核心。简单的阈值法容易误触发。我采用的是一种“能量-持续时间”联合判据能量阈值设置一个基础能量阈值ENERGY_THRESHOLD。只有当某个距离门的能量值持续超过此阈值才认为该区域有潜在目标。持续计数为每个距离门设置一个计数器。当能量超过阈值时计数器增加低于阈值时计数器减少。只有当计数器超过一个设定的“确认计数”CONFIRM_COUNT如对应500ms时才最终判定为“有人”。释放延时当所有距离门能量都低于阈值后并不立即判定为“无人”而是启动一个“释放延时”计时器如2秒。延时结束后才切换为“无人”状态。这能有效避免人在短暂静止如打字间隙时状态的频繁跳变。// 简化的判定逻辑伪代码 bool presenceDetected false; int stableCounter 0; const int CONFIRM_NEEDED 50; // 50次循环假设每次循环10ms即500ms const int RELEASE_DELAY_MS 2000; unsigned long lastDetectedTime 0; void determinePresenceStatus() { int maxEnergy getMaxEnergyFromLD2420(); // 获取当前所有距离门中的最大能量值 if (maxEnergy ENERGY_THRESHOLD) { stableCounter; if (stableCounter CONFIRM_NEEDED !presenceDetected) { presenceDetected true; // 触发有人事件如点亮LED记录时间 } lastDetectedTime millis(); // 更新最后一次检测到的时间 } else { stableCounter max(0, stableCounter - 2); // 缓慢递减计数器 } // 释放延时判断 if (presenceDetected (millis() - lastDetectedTime RELEASE_DELAY_MS)) { presenceDetected false; stableCounter 0; // 触发无人事件 } }通过调整ENERGY_THRESHOLD、CONFIRM_NEEDED和RELEASE_DELAY_MS这三个参数可以在灵敏度检测微弱存在和抗干扰性避免误报之间取得最佳平衡。例如将其安装在客厅可能需要较低的阈值和较短的确认时间来快速响应人进入而安装在卫生间可能需要较高的阈值和较长的释放延时防止水汽流动造成误触发。3.3 Web服务器与实时数据推送我们使用ESP32的WebServer库和WebSockets库来构建交互界面。1. 提供静态网页HTML/CSS/JS在setup()中我们需要设置一个路由当浏览器访问设备IP的根路径时返回我们编写好的HTML页面。webServer.on(/, HTTP_GET, []() { String html FPSTR(MAIN_PAGE); // MAIN_PAGE是一个存储HTML代码的常量字符串 webServer.send(200, text/html, html); });为了便于管理可以将HTML、CSS、JavaScript代码写在单独的.h头文件中通过PROGMEM关键字存储在Flash中以节省RAM。2. 建立WebSocket连接WebSocket是一种全双工通信协议建立连接后服务器和客户端可以随时相互发送数据完美适合实时数据推送。// WebSocket事件处理 webSocket.onEvent([](uint8_t num, WStype_t type, uint8_t * payload, size_t length) { switch(type) { case WStype_DISCONNECTED: Serial.printf([%u] Disconnected!\n, num); break; case WStype_CONNECTED: { IPAddress ip webSocket.remoteIP(num); Serial.printf([%u] Connected from %d.%d.%d.%d\n, num, ip[0], ip[1], ip[2], ip[3]); // 连接建立后立即发送一次当前所有数据 sendAllSensorData(num); } break; case WStype_TEXT: // 处理从网页前端发来的消息例如调整阈值参数 handleWebSocketMessage(num, payload, length); break; } });3. 定时推送传感器数据在sensorReadingTask中每当得到新的传感器数据并完成状态判定后就通过WebSocket广播给所有连接的客户端。void broadcastDataViaWebSocket() { // 创建一个JSON字符串包含所有要推送的数据 DynamicJsonDocument doc(256); doc[presence] presenceDetected ? 有人 : 无人; doc[temperature] currentTemp; doc[humidity] currentHumidity; doc[max_energy] maxEnergy; // 可选用于前端调试 doc[rssi] WiFi.RSSI(); // 可选显示Wi-Fi信号强度 String jsonString; serializeJson(doc, jsonString); // 广播给所有连接的客户端 webSocket.broadcastTXT(jsonString); }3.4 前端界面设计与数据可视化前端页面的目标是清晰、实时地展示信息。我们使用简单的HTML/CSS和JavaScript来实现。HTML结构包含几个主要的div区域用于显示温湿度数值、存在状态、信号强度以及一个用于绘制温湿度历史曲线的canvas画布。CSS样式采用Flexbox进行简单布局使页面在手机和电脑上都能自适应。为“有人”/“无人”状态设计不同的颜色如绿色/灰色和图标增强视觉提示。JavaScript逻辑建立WebSocket连接页面加载后连接到ESP32的WebSocket服务器ws://[ESP32_IP]:81。处理实时数据在WebSocket的onmessage事件中解析收到的JSON数据并更新对应的HTML元素。socket.onmessage function(event) { var data JSON.parse(event.data); document.getElementById(tempValue).innerText data.temperature.toFixed(1) °C; document.getElementById(humValue).innerText data.humidity.toFixed(1) %; var statusElem document.getElementById(presenceStatus); statusElem.innerText data.presence; if(data.presence 有人) { statusElem.style.color #4CAF50; // 绿色 } else { statusElem.style.color #9E9E9E; // 灰色 } // 将数据点添加到图表数据集 addDataToChart(data.temperature, data.humidity); };绘制历史图表使用轻量级的Chart.js库。我们维护两个数组分别存储最近N个时间点的温湿度数据。每次收到新数据就更新数组并重绘图表。可以添加按钮来切换显示/隐藏温度或湿度曲线。参数配置界面进阶可以添加一个折叠面板里面包含几个输入框和滑动条用于调整LD2420的检测阈值、释放延时等参数。当前端修改这些参数后通过WebSocket发送一个特定的JSON指令给ESP32ESP32解析后调用相应的函数来修改运行参数并保存到Preferences类似EEPROM中实现掉电保存。4. 实际部署、调试与避坑指南代码写完只是第一步让设备稳定可靠地运行起来才是真正的挑战。下面分享我在部署和调试SenseMate32过程中积累的关键经验。4.1 雷达模块安装位置与角度校准LD2420的安装位置直接决定了检测效果。以下是几个黄金法则高度建议安装在1.8米至2.2米的高度略高于人体身高。这个高度可以减少地面杂物反射的干扰并使波束更好地覆盖人体活动区域。角度雷达模块应略微向下倾斜约10-15度让波束中心指向需要监测区域的中心。切勿水平或向上安装。朝向雷达的辐射方向图通常是一个扇形。确保这个扇形的长边方向覆盖你关心的区域。例如监测一个长方形房间可以让扇形长边平行于房间的长边。避开干扰源远离空调出风口、风扇、暖气片等有持续气流或热源扰动的地方。也要避免正对窗户窗外移动的树叶、车辆可能会引起误报。材质影响毫米波可以穿透塑料、亚克力、薄木板等非金属材料。你可以将模块隐藏在装饰盒、灯罩后面实现隐形安装。但金属外壳会完全屏蔽信号必须露出天线区域。调试方法在代码中将LD2420的原始能量值通过串口打印出来。然后你人在检测区域内以不同状态走动、静坐、完全静止活动观察各个距离门的能量值变化。这能帮你精确了解雷达的“视野”范围并据此调整安装位置和软件阈值。4.2 电源稳定性与Wi-Fi连接优化ESP32在启动Wi-Fi和高速传输数据时功耗较大不稳定的电源会导致设备不断重启。电源测试使用万用表监测ESP32的3.3V引脚电压在Wi-Fi连接和WebSocket广播数据的瞬间观察电压是否有大幅跌落如低于3.0V。如果有说明电源带载能力不足。电容补救在ESP32的3.3V和GND之间并联一个470μF的电解电容和一个100nF的陶瓷电容。电解电容应对电流突变陶瓷电容滤除高频噪声。这是提升稳定性的廉价且有效的方法。Wi-Fi配置在代码中增加Wi-Fi连接失败的重试机制和超时判断。如果信号弱可以考虑使用WiFi.setTxPower(WIFI_POWER_19_5dBm)提高发射功率注意法规限制。指定静态IP地址避免DHCP租约到期带来的短暂断线虽然Web服务器会受影响但传感器任务可能还在跑。IPAddress local_IP(192, 168, 1, 200); IPAddress gateway(192, 168, 1, 1); IPAddress subnet(255, 255, 255, 0); WiFi.config(local_IP, gateway, subnet);4.3 传感器数据滤波与异常值处理原始传感器数据往往带有噪声直接使用会导致Web界面数值跳动影响体验。AHT20数据滤波温湿度变化相对缓慢可以采用滑动平均滤波。#define FILTER_SIZE 10 float tempHistory[FILTER_SIZE]; int historyIndex 0; float getFilteredTemperature(float newTemp) { tempHistory[historyIndex] newTemp; historyIndex (historyIndex 1) % FILTER_SIZE; float sum 0; for (int i 0; i FILTER_SIZE; i) { sum tempHistory[i]; } return sum / FILTER_SIZE; }LD2420能量值滤波同样可以采用滑动平均但窗口不宜过大以免影响响应速度。我通常对每个距离门的能量值做5个点的滑动平均。异常值剔除在AHT20读数前检查I2C通信是否正常。如果连续多次读取失败则记录错误并尝试重新初始化I2C而不是使用错误数据。4.4 内存管理与看门狗长时间运行是嵌入式设备的基本要求内存泄漏和程序跑飞是两大杀手。堆栈空间确保为任务特别是sensorReadingTask分配足够的堆栈空间上文代码中的4096。如果任务中调用了很多函数或使用了较大的局部数组需要适当增加。可以通过uxTaskGetStackHighWaterMark()函数监控堆栈水位。动态内存谨慎使用String类尤其是在循环中拼接字符串容易产生内存碎片。在WebSocket构建JSON时使用ArduinoJson库的DynamicJsonDocument并预估好文档大小避免频繁分配释放。看门狗ESP32有硬件看门狗。在Arduino环境中loop()函数会自动喂狗。但在我们创建的sensorReadingTask中如果有一个很长的阻塞操作如delay(1000)会导致看门狗超时重启。因此在任务循环中应使用vTaskDelay()代替delay()并将长任务拆分。也可以考虑启用任务看门狗需要配置。4.5 固件更新OTA与配置保存设备安装好后不可能每次都拆下来用USB线更新程序。Arduino OTA利用ESP32的OTA功能可以通过网络更新固件。在代码中引入ArduinoOTA库并在setup()中配置好。之后在Arduino IDE中选择“网络端口”上传就能像最初烧录一样方便地更新程序。参数保存用户通过Web界面调整的雷达阈值、释放延时等参数需要保存到非易失性存储器中。推荐使用ESP32的Preferences库它比传统的EEPROM模拟更简单可靠。#include Preferences.h Preferences prefs; void saveSettings() { prefs.begin(senseMate, false); // 打开命名空间false表示读写模式 prefs.putUInt(energy_thresh, energyThreshold); prefs.putUInt(release_delay, releaseDelayMs); prefs.end(); } void loadSettings() { prefs.begin(senseMate, true); // true表示只读模式 energyThreshold prefs.getUInt(energy_thresh, 50); // 默认值50 releaseDelayMs prefs.getUInt(release_delay, 2000); // 默认值2000 prefs.end(); }5. 项目扩展思路与应用场景一个基础的SenseMate32已经完成但它就像一个乐高底座有巨大的扩展潜力。硬件扩展添加显示屏连接一块小型的OLED或TFT屏幕本地直接显示状态和温湿度作为冗余显示。增加继电器输出用ESP32的GPIO控制一个5V继电器模块可以直接驱动灯具、风扇等220V设备实现“感知-执行”的闭环。例如检测到有人且温度高于28°C自动打开风扇。集成光照传感器如BH1750实现根据环境光照自动开关窗帘或调节灯光。多雷达组网对于大空间可以用多个SenseMate32设备各自监测一个区域通过Wi-Fi将状态上报到一个中央主机如运行Home Assistant的树莓派实现全景存在感知。软件与生态集成MQTT协议支持这是将设备融入主流智能家居平台的关键。让SenseMate32作为一个MQTT客户端将“有人/无人”状态和温湿度数据发布到MQTT服务器如Mosquitto。这样Home Assistant、Node-RED等平台就能轻松订阅这些数据并与其他设备进行复杂联动。联动场景示例SenseMate32检测到卫生间有人且湿度持续升高可能在洗澡自动开启浴霸换气扇。HomeKit / Matter支持通过开源库如ESP-HomeKit或Matter SDK将设备直接接入苹果HomeKit或支持Matter的生态获得更好的跨平台体验。数据持久化与历史分析将温湿度数据定期上传到本地数据库如InfluxDB然后用Grafana绘制长期趋势图分析家庭环境变化。应用场景展望智能照明真正的“人来灯亮人走灯灭”无视静止状态。节能控制会议室、办公室无人时自动关闭空调、投影仪。安防预警在设防时段检测到不应有人的区域存在活动触发报警。健康关怀监测老人卧室夜间活动频率异常长时间静止可能触发提醒。环境自动化根据房间内是否有人以及温湿度自动调节加湿器、除湿机、新风系统的工作模式。从一颗ESP32开发板开始到最终成为一个稳定、智能、可扩展的环境感知节点SenseMate32项目的全过程充满了嵌入式开发的典型挑战和乐趣。它不仅仅是一个温湿度计或人体传感器而是一个展示了如何将廉价硬件、开源软件和实用算法结合起来解决真实需求的完整案例。希望这份详细的拆解能为你自己的物联网项目提供扎实的参考。
