1. 项目背景久坐提醒是健康类嵌入式应用中一个很典型的场景。传统方案通常依赖按键、压力传感器、摄像头或 BLE 设备判断用户是否在座但这些方案要么需要额外结构设计要么涉及隐私问题。本项目尝试使用 DFRobot C4002 毫米波人体存在传感器结合 ESP32-S31-Korvo 开发板实现一个适合书房、办公室场景的离席/久坐提醒器。工程目标包括通过 USB-TTL 转接器读取 C4002 数据判断人体是否处于座位区域在 LCD 屏幕显示当前状态、目标距离、久坐时间和倒计时久坐超过阈值后点亮板载 RGB LED支持离席重置和久坐时间统计。项目仓库结构基于 ESP-IDF 工程组织目标芯片为esp32s31。2. 硬件环境使用的主要硬件如下ESP32-S31-Korvo 开发板DFRobot C4002 毫米波人体存在传感器USB-TTL 转接器例如 CH340/CH34xESP32-S31-Korvo 板载 800x480 RGB LCDESP32-S31-Korvo 板载 WS2812 RGB LED。C4002 通过 USB-TTL 转接器连接到 ESP32-S31 的 USB Host 接口。这个连接方式先通过 ESP-IDF 官方 CDC Host 示例验证过可正常识别 CH340 设备并读取串口数据。之所以采用 USB-TTL 转接器而不是直接使用普通 UART GPIO是因为 ESP32-S31-Korvo 开发板的大量 I/O 已经分配给 RGB LCD、音频、按键、摄像头、SD 卡等板载外设开发板没有额外引出足够方便使用的空闲 I/O 接口来连接 C4002。相比重新飞线或改动板载外设使用 USB Host 接 USB-TTL 转接器更稳定也更适合做可复现的开发板示例。构建目标设置为idf.py--previewset-targetesp32s31因为当前使用的 ESP-IDF 分支中esp32s31仍属于 preview target所以后续idf.py命令也需要带--preview。3. USB CDC Host 接入 C4002C4002 模块本质上通过 UART 输出数据。由于开发板侧使用 USB Host因此采用 USB-TTL 转接器接入。工程依赖以下 USB VCP/CDC 组件dependencies:usb_host_cdc_acm:^2.3usb_host_ch34x_vcp:^2.2usb_host_cp210x_vcp:^2.2usb_host_ftdi_vcp:^2.1程序启动后会安装 USB Host 和 CDC ACM Host 驱动并监听新设备连接constcdc_acm_host_driver_config_tdriver_config{.driver_task_stack_size4096,.driver_task_priorityUSB_HOST_PRIORITY1,.xCoreID0,.new_dev_cbnew_dev_cb,};cdc_acm_host_install(driver_config);当 CH340 转接器插入后日志类似USB CDC connected VID0x1A86 PID0x7523 CDC device opened at 115200 8N1C4002 默认波特率为115200使用 8N1。4. C4002 数据帧解析开发初期先按 ASCII 文本方式兼容解析例如statepresence,presence_dist1.20 statemotion,motion_speed0.34 statenone但实际测试中发现C4002 通过当前配置输出的是二进制帧。抓到的数据帧以如下头部开始FA F5 AA A5根据日志分析帧格式大致为FA F5 AA A5帧头后 2 字节小端整帧长度最后 2 字节前面所有字节的加和校验偏移 12目标状态偏移 24、25目标距离单位厘米小端格式。状态字段当前按如下方式解释0无目标 1静止存在 2运动解析代码中会校验帧头、长度和 checksum。距离字段解析后转换为米用于 LCD 和日志显示。5. 为什么必须结合距离判断最开始只根据 C4002 的Static Presence和Motion状态判断用户是否久坐。测试后发现这样会有一个明显问题用户离开座位但仍在房间内C4002 仍可能检测到人体存在。此时传感器状态仍是Static Presence或Motion单纯依赖状态无法判断“在座”还是“离开座位”。因此后续加入距离判断默认座位有效距离30cm ~ 100cm只有当目标距离在这个范围内时才认为用户处于座位区域sample-in_seat_zonedistance_cmCONFIG_C4002_SEAT_MIN_DISTANCE_CMdistance_cmCONFIG_C4002_SEAT_MAX_DISTANCE_CM;当距离超过 1m例如日志中的target_dist1.50m seatedno即使状态仍为Static Presence也不再累计久坐时间。6. 久坐计时逻辑的迭代这个项目中最容易出错的是计时逻辑。早期逻辑中进入 session 后使用static_snow-static_start_us;这会导致一个问题如果用户短暂离开座位区域但还没有达到 away reset 时间程序虽然显示seatedno但内部提醒判断仍可能继续按 wall-clock 时间增长。例如static7s target_dist1.56m seatedno ... REMINDER | Static presence for 15s这明显不符合预期因为用户已经离开座位区域倒计时应该暂停。最终修正为“实际在座累计时间”模型int64_tseated_interval_start_us;int64_tseated_accumulated_us;逻辑如下seatedyes时开始或继续累计seatedno时暂停累计重新回到座位区域后继续累计超过 away reset 时间后重置 session久坐提醒只在in_seat_zonetrue时触发。这样就能实现0.96m 内累计到 7 秒 离开到 1.56m 后倒计时暂停 回到 1m 内后从 7 秒继续 累计到 15 秒才提醒7. 板载 RGB LED 控制问题开发中遇到过一个典型硬件映射问题。一开始根据资料误以为板载可寻址 RGB LED 在 GPIO8但实际烧录后 LED 没有反应。后续查看 ESP32-S31-Korvo 出厂 demo 的 BSP发现#defineBSP_LED_WS2812GPIO_NUM_37而 GPIO8 是 LCD 的 RGB 数据线#defineBSP_LCD_DATA0GPIO_NUM_8所以正确的 WS2812 引脚是 GPIO37。出厂 demo 使用led_strip组件和 RMT 驱动 WS2812颜色格式为 GRB。当前工程中采用 RMT 自定义 encoder 控制板载灯上电短暂红灯自检久坐提醒触发后点亮红灯离座 reset 后熄灭红灯。8. LCD 显示实现ESP32-S31-Korvo 带有 800x480 RGB LCD。出厂 demo 中 LCD 参数如下分辨率800 x 480 颜色格式RGB565 数据宽度16-bit RGB PCLK26 MHz关键 GPIODATA0 GPIO8 DATA1 GPIO9 ... DATA15 GPIO36 PCLK GPIO40 DE GPIO43 HSYNC GPIO44 VSYNC GPIO45最开始尝试直接引入完整出厂 BSP但它会连带引入 Camera、Video、Audio、SD 等依赖其中esp_video在当前环境下编译遇到sys/socket.h缺失问题。因此最终采用“最小 LCD 初始化”方案只移植 RGB LCD GPIO 和时序参数使用esp_lcd_new_rgb_panel()初始化 RGB panel使用esp_lvgl_adapter注册到 LVGL不引入完整 BSP。LCD 初始化核心代码类似esp_lcd_rgb_panel_config_tpanel_config{.timings{.pclk_hz26*1000*1000,.h_res800,.v_res480,.hsync_pulse_width1,.hsync_back_porch40,.hsync_front_porch20,.vsync_pulse_width1,.vsync_back_porch10,.vsync_front_porch5,.flags.pclk_active_negtrue,},.data_width16,.in_color_formatLCD_COLOR_FMT_RGB565,.flags.fb_in_psramtrue,};9. PSRAM 配置问题启用 LCD 后第一次运行遇到lcd_rgb_panel_alloc_frame_buffers: no mem for frame buffer esp_lcd_new_rgb_panel: alloc frame buffers failed原因是 LCD 帧缓冲太大。800x480 RGB565 单帧约 750KB内部 RAM 无法承载必须启用 PSRAM。出厂 demo 中也开启了 PSRAMCONFIG_SPIRAMy CONFIG_SPIRAM_SPEED_250My CONFIG_SPIRAM_XIP_FROM_PSRAMy启用后启动日志中可以看到esp_psram: Found 16MB PSRAM device esp_psram: Speed: 250MHz esp_psram: Adding pool of 15680K of PSRAM memoryLCD 初始化也正常RGB LCD registered to LVGL adapter LCD UI initialized10. LCD 界面内容LCD 界面主要面向调试和实际使用显示内容包括状态图标当前状态是否在座目标距离久坐提醒倒计时当前静止在座时间当前 session 时间总静止在座统计时间。状态图标设计为简单字符?未知 O离座或无目标 S在座 M运动 !久坐提醒倒计时逻辑需要特别注意在座时倒计时减少离开座位区域时倒计时暂停回到座位区域后继续达到阈值后显示提醒状态。11. 当前默认配置当前工程默认配置如下久坐提醒阈值15 秒 重复提醒间隔300 秒 离座重置时间10 秒 座位有效距离30cm ~ 100cm LCD 显示开启 板载 RGB LEDGPIO37配置文件主要包括sdkconfig.defaults main/Kconfig.projbuild main/idf_component.yml建议将sdkconfig.defaults上传仓库便于其他开发者复现关键配置。12. 构建与烧录代码仓库地址https://gitee.com/zealsoft/c4002_sedentary_reminder构建命令cd D:\esp\master\esp-idf\projects\c4002_sedentary_reminder idf.py--previewset-targetesp32s31 idf.py--preview build idf.py--preview flash monitor13. 仓库上传建议建议上传CMakeLists.txt README.md README_zh.md sdkconfig.defaults dependencies.lock main/ .gitignore建议忽略build/ managed_components/managed_components是 ESP-IDF Component Manager 自动下载的依赖不需要上传。build是构建产物也不应上传。如果希望完全复现当前开发环境也可以上传sdkconfig。但更通用的做法是上传sdkconfig.defaults让用户通过idf.py set-target和默认配置生成自己的sdkconfig。14. 总结这个项目看起来只是一个“久坐提醒器”但实际开发中涉及了不少嵌入式工程细节USB Host CDC 设备枚举C4002 二进制帧解析毫米波存在状态与距离联合判断防止房间内其他位置误判为在座WS2812 引脚与 LCD 引脚冲突排查ESP32-S31-Korvo RGB LCD 初始化LVGL adapter 接入PSRAM 帧缓冲配置久坐计时逻辑从 wall-clock 改为实际在座累计。最终实现的效果是系统能够通过 C4002 判断用户是否处于座位区域在 LCD 上显示状态和倒计时并在实际久坐达到阈值后点亮红灯提醒用户起身活动。
基于 ESP32-S31-Korvo 与 C4002 毫米波传感器的离席/久坐提醒器开发实践
发布时间：2026/6/9 11:23:10
1. 项目背景久坐提醒是健康类嵌入式应用中一个很典型的场景。传统方案通常依赖按键、压力传感器、摄像头或 BLE 设备判断用户是否在座但这些方案要么需要额外结构设计要么涉及隐私问题。本项目尝试使用 DFRobot C4002 毫米波人体存在传感器结合 ESP32-S31-Korvo 开发板实现一个适合书房、办公室场景的离席/久坐提醒器。工程目标包括通过 USB-TTL 转接器读取 C4002 数据判断人体是否处于座位区域在 LCD 屏幕显示当前状态、目标距离、久坐时间和倒计时久坐超过阈值后点亮板载 RGB LED支持离席重置和久坐时间统计。项目仓库结构基于 ESP-IDF 工程组织目标芯片为esp32s31。2. 硬件环境使用的主要硬件如下ESP32-S31-Korvo 开发板DFRobot C4002 毫米波人体存在传感器USB-TTL 转接器例如 CH340/CH34xESP32-S31-Korvo 板载 800x480 RGB LCDESP32-S31-Korvo 板载 WS2812 RGB LED。C4002 通过 USB-TTL 转接器连接到 ESP32-S31 的 USB Host 接口。这个连接方式先通过 ESP-IDF 官方 CDC Host 示例验证过可正常识别 CH340 设备并读取串口数据。之所以采用 USB-TTL 转接器而不是直接使用普通 UART GPIO是因为 ESP32-S31-Korvo 开发板的大量 I/O 已经分配给 RGB LCD、音频、按键、摄像头、SD 卡等板载外设开发板没有额外引出足够方便使用的空闲 I/O 接口来连接 C4002。相比重新飞线或改动板载外设使用 USB Host 接 USB-TTL 转接器更稳定也更适合做可复现的开发板示例。构建目标设置为idf.py--previewset-targetesp32s31因为当前使用的 ESP-IDF 分支中esp32s31仍属于 preview target所以后续idf.py命令也需要带--preview。3. USB CDC Host 接入 C4002C4002 模块本质上通过 UART 输出数据。由于开发板侧使用 USB Host因此采用 USB-TTL 转接器接入。工程依赖以下 USB VCP/CDC 组件dependencies:usb_host_cdc_acm:^2.3usb_host_ch34x_vcp:^2.2usb_host_cp210x_vcp:^2.2usb_host_ftdi_vcp:^2.1程序启动后会安装 USB Host 和 CDC ACM Host 驱动并监听新设备连接constcdc_acm_host_driver_config_tdriver_config{.driver_task_stack_size4096,.driver_task_priorityUSB_HOST_PRIORITY1,.xCoreID0,.new_dev_cbnew_dev_cb,};cdc_acm_host_install(driver_config);当 CH340 转接器插入后日志类似USB CDC connected VID0x1A86 PID0x7523 CDC device opened at 115200 8N1C4002 默认波特率为115200使用 8N1。4. C4002 数据帧解析开发初期先按 ASCII 文本方式兼容解析例如statepresence,presence_dist1.20 statemotion,motion_speed0.34 statenone但实际测试中发现C4002 通过当前配置输出的是二进制帧。抓到的数据帧以如下头部开始FA F5 AA A5根据日志分析帧格式大致为FA F5 AA A5帧头后 2 字节小端整帧长度最后 2 字节前面所有字节的加和校验偏移 12目标状态偏移 24、25目标距离单位厘米小端格式。状态字段当前按如下方式解释0无目标 1静止存在 2运动解析代码中会校验帧头、长度和 checksum。距离字段解析后转换为米用于 LCD 和日志显示。5. 为什么必须结合距离判断最开始只根据 C4002 的Static Presence和Motion状态判断用户是否久坐。测试后发现这样会有一个明显问题用户离开座位但仍在房间内C4002 仍可能检测到人体存在。此时传感器状态仍是Static Presence或Motion单纯依赖状态无法判断“在座”还是“离开座位”。因此后续加入距离判断默认座位有效距离30cm ~ 100cm只有当目标距离在这个范围内时才认为用户处于座位区域sample-in_seat_zonedistance_cmCONFIG_C4002_SEAT_MIN_DISTANCE_CMdistance_cmCONFIG_C4002_SEAT_MAX_DISTANCE_CM;当距离超过 1m例如日志中的target_dist1.50m seatedno即使状态仍为Static Presence也不再累计久坐时间。6. 久坐计时逻辑的迭代这个项目中最容易出错的是计时逻辑。早期逻辑中进入 session 后使用static_snow-static_start_us;这会导致一个问题如果用户短暂离开座位区域但还没有达到 away reset 时间程序虽然显示seatedno但内部提醒判断仍可能继续按 wall-clock 时间增长。例如static7s target_dist1.56m seatedno ... REMINDER | Static presence for 15s这明显不符合预期因为用户已经离开座位区域倒计时应该暂停。最终修正为“实际在座累计时间”模型int64_tseated_interval_start_us;int64_tseated_accumulated_us;逻辑如下seatedyes时开始或继续累计seatedno时暂停累计重新回到座位区域后继续累计超过 away reset 时间后重置 session久坐提醒只在in_seat_zonetrue时触发。这样就能实现0.96m 内累计到 7 秒 离开到 1.56m 后倒计时暂停 回到 1m 内后从 7 秒继续 累计到 15 秒才提醒7. 板载 RGB LED 控制问题开发中遇到过一个典型硬件映射问题。一开始根据资料误以为板载可寻址 RGB LED 在 GPIO8但实际烧录后 LED 没有反应。后续查看 ESP32-S31-Korvo 出厂 demo 的 BSP发现#defineBSP_LED_WS2812GPIO_NUM_37而 GPIO8 是 LCD 的 RGB 数据线#defineBSP_LCD_DATA0GPIO_NUM_8所以正确的 WS2812 引脚是 GPIO37。出厂 demo 使用led_strip组件和 RMT 驱动 WS2812颜色格式为 GRB。当前工程中采用 RMT 自定义 encoder 控制板载灯上电短暂红灯自检久坐提醒触发后点亮红灯离座 reset 后熄灭红灯。8. LCD 显示实现ESP32-S31-Korvo 带有 800x480 RGB LCD。出厂 demo 中 LCD 参数如下分辨率800 x 480 颜色格式RGB565 数据宽度16-bit RGB PCLK26 MHz关键 GPIODATA0 GPIO8 DATA1 GPIO9 ... DATA15 GPIO36 PCLK GPIO40 DE GPIO43 HSYNC GPIO44 VSYNC GPIO45最开始尝试直接引入完整出厂 BSP但它会连带引入 Camera、Video、Audio、SD 等依赖其中esp_video在当前环境下编译遇到sys/socket.h缺失问题。因此最终采用“最小 LCD 初始化”方案只移植 RGB LCD GPIO 和时序参数使用esp_lcd_new_rgb_panel()初始化 RGB panel使用esp_lvgl_adapter注册到 LVGL不引入完整 BSP。LCD 初始化核心代码类似esp_lcd_rgb_panel_config_tpanel_config{.timings{.pclk_hz26*1000*1000,.h_res800,.v_res480,.hsync_pulse_width1,.hsync_back_porch40,.hsync_front_porch20,.vsync_pulse_width1,.vsync_back_porch10,.vsync_front_porch5,.flags.pclk_active_negtrue,},.data_width16,.in_color_formatLCD_COLOR_FMT_RGB565,.flags.fb_in_psramtrue,};9. PSRAM 配置问题启用 LCD 后第一次运行遇到lcd_rgb_panel_alloc_frame_buffers: no mem for frame buffer esp_lcd_new_rgb_panel: alloc frame buffers failed原因是 LCD 帧缓冲太大。800x480 RGB565 单帧约 750KB内部 RAM 无法承载必须启用 PSRAM。出厂 demo 中也开启了 PSRAMCONFIG_SPIRAMy CONFIG_SPIRAM_SPEED_250My CONFIG_SPIRAM_XIP_FROM_PSRAMy启用后启动日志中可以看到esp_psram: Found 16MB PSRAM device esp_psram: Speed: 250MHz esp_psram: Adding pool of 15680K of PSRAM memoryLCD 初始化也正常RGB LCD registered to LVGL adapter LCD UI initialized10. LCD 界面内容LCD 界面主要面向调试和实际使用显示内容包括状态图标当前状态是否在座目标距离久坐提醒倒计时当前静止在座时间当前 session 时间总静止在座统计时间。状态图标设计为简单字符?未知 O离座或无目标 S在座 M运动 !久坐提醒倒计时逻辑需要特别注意在座时倒计时减少离开座位区域时倒计时暂停回到座位区域后继续达到阈值后显示提醒状态。11. 当前默认配置当前工程默认配置如下久坐提醒阈值15 秒 重复提醒间隔300 秒 离座重置时间10 秒 座位有效距离30cm ~ 100cm LCD 显示开启 板载 RGB LEDGPIO37配置文件主要包括sdkconfig.defaults main/Kconfig.projbuild main/idf_component.yml建议将sdkconfig.defaults上传仓库便于其他开发者复现关键配置。12. 构建与烧录代码仓库地址https://gitee.com/zealsoft/c4002_sedentary_reminder构建命令cd D:\esp\master\esp-idf\projects\c4002_sedentary_reminder idf.py--previewset-targetesp32s31 idf.py--preview build idf.py--preview flash monitor13. 仓库上传建议建议上传CMakeLists.txt README.md README_zh.md sdkconfig.defaults dependencies.lock main/ .gitignore建议忽略build/ managed_components/managed_components是 ESP-IDF Component Manager 自动下载的依赖不需要上传。build是构建产物也不应上传。如果希望完全复现当前开发环境也可以上传sdkconfig。但更通用的做法是上传sdkconfig.defaults让用户通过idf.py set-target和默认配置生成自己的sdkconfig。14. 总结这个项目看起来只是一个“久坐提醒器”但实际开发中涉及了不少嵌入式工程细节USB Host CDC 设备枚举C4002 二进制帧解析毫米波存在状态与距离联合判断防止房间内其他位置误判为在座WS2812 引脚与 LCD 引脚冲突排查ESP32-S31-Korvo RGB LCD 初始化LVGL adapter 接入PSRAM 帧缓冲配置久坐计时逻辑从 wall-clock 改为实际在座累计。最终实现的效果是系统能够通过 C4002 判断用户是否处于座位区域在 LCD 上显示状态和倒计时并在实际久坐达到阈值后点亮红灯提醒用户起身活动。
 ；YGGFLRRIRP)
