ESP32 实时信号处理与物联网系统从波形生成到 Web 频谱监控关键词ESP32、FreeRTOS、DAC、ADC、FFT、MQTT、边缘计算、Web 服务器项目源码https://github.com/WuQinghui-00/ESP32-Signal-Processing-System一、项目背景在物联网和边缘计算快速发展的今天越来越多的数据处理任务从云端下沉到设备端。本项目设计并实现了一套基于 ESP32 的嵌入式信号处理系统实现了从波形生成、数据采集、实时频谱分析到云端上报和 Web 监控的全链路闭环。核心特点设备端完成 FFT 频谱分析边缘计算仅上报关键结果降低带宽消耗内置 Web 服务器浏览器即可查看实时频谱曲线经过信号发生器 示波器真机交叉验证本文数据均为实测二、系统架构2.1 整体架构图┌─────────────────────────────────────────────────────────────┐ │ ESP32 │ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │ │ DAC 波形 │ │ ADC 采集 │ │ FFT 分析 │ │ │ │ 生成 │───▶│ 数据 │───▶│ 频谱 │ │ │ └──────────┘ └──────────┘ └──────────┘ │ │ │ │ │ │ │ ▼ ▼ ▼ │ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │ │ GPIO25 │ │ GPIO35 │ │ 峰值频率 │ │ │ │ 输出 │ │ 输入 │ │ 检测 │ │ │ └──────────┘ └──────────┘ └──────────┘ │ │ │ │ │ ▼ │ │ ┌──────────────────┐ │ │ │ WiFi MQTT 上报 │ │ │ │ HTTP Web 服务器 │ │ │ └──────────────────┘ │ └─────────────────────────────────────────────────────────────┘ │ │ ▼ ▼ ┌─────────────┐ ┌─────────────┐ │ EMQX 云端 │ │ 浏览器监控 │ │ MQTT 服务器 │ │ Canvas 绘图 │ └─────────────┘ └─────────────┘2.2 代码结构main/ ├── main.c # 主函数、采集/FFT 主循环、串口命令 ├── dac_wave.c/h # DAC 波形生成esp_timer 定时驱动 ├── adc_sample.c/h # ADC 数据采集1000Hz128 点 ├── fft_process.c/h # FFT 频谱分析Hann 窗 radix-2 峰值 ├── mqtt_report.c/h # WiFi MQTT 云端上报QoS1 断线缓存 ├── webserver.c/h # HTTP Web 服务器Canvas 频谱 诊断 API └── CMakeLists.txt # 构建配置2.3 技术栈层级技术芯片ESP32RTOSFreeRTOS驱动DAC / ADC算法FFT 峰值检测ESP-DSP通信WiFi / MQTT / HTTP框架ESP-IDF v5.3.1三、核心功能实现3.1 任务架构系统使用一个串口命令解析任务采集 FFT 上报在主循环中完成xTaskCreate(uart_task, uart, 4096, NULL, 1, NULL);DAC 波形输出由esp_timer 周期定时器驱动而非忙等循环见踩坑 3。3.2 波形生成DAC通过查表法生成正弦波、方波、三角波频率可调// 正弦波表生成 for (int i 0; i 256; i) { sine_table[i] 128 (int)(127 * sin(2 * 3.14159 * i / 256)); } // esp_timer 回调中按周期输出一个采样点 static void dac_timer_cb(void *arg) { dac_output_voltage(DAC_CHANNEL_1, sine_table[phase 255]); }3.3 数据采集ADCADC 单次采样One-shot模式1000Hz 采样率采集 128 点实测稳定1007 S/s误差 1%void adc_init(void) { adc1_config_width(ADC_WIDTH_BIT_12); adc1_config_channel_atten(ADC1_CHANNEL_7, ADC_ATTEN_DB_12); } int adc_sample(int16_t *buffer, int len) { for (int i 0; i len; i) { buffer[i] adc1_get_raw(ADC1_CHANNEL_7); esp_rom_delay_us(1000); // 1000Hz } return measured_rate; // 实际测量并返回真实采样率 }3.4 频谱分析FFT完整链路去直流 → Hann 窗 → 128 点 radix-2 FFT → 幅值谱 → 峰值检测// 去直流减去平均值消除 ADC 偏置分量 int remove_dc_offset(int16_t *data, int len); // FFT 分析Hann 窗 128 点 radix-2 FFTESP-DSP 峰值检测 int fft_analyze(int16_t *data, int len, int sample_rate, float *magnitude, float *peak_freq, float *peak_amp); // 主循环调用 int dc_offset remove_dc_offset(buffer, SAMPLE_LEN); int peak_bin fft_analyze(buffer, SAMPLE_LEN, SAMPLE_RATE, spectrum, peak_freq, peak_amp); ESP_LOGI(TAG, FFT: peak bin%d, freq%d Hz, amp%.0f, peak_bin, (int)(peak_freq 0.5f), peak_amp);频率分辨率 采样率 / FFT 点数 1000 / 128 ≈7.8Hz/bin。3.5 物联网通信WiFi MQTTWiFi 采用指数退避重连实测 1s → 2s → 4s 递增并统计断线次数/重试次数static void wifi_event_handler(void *arg, esp_event_base_t event_base, int32_t event_id, void *event_data) { if (event_base WIFI_EVENT event_id WIFI_EVENT_STA_DISCONNECTED) { schedule_reconnect_with_backoff(); // 指数退避重连 } }MQTT 使用 QoS1 上报真实频谱结果断线期间缓存最新状态重连后自动补发// 实际 payload峰值频率 峰值幅值 采样率 {peak_frequency:203,peak_amplitude:35600,sample_rate:1007}3.6 Web 监控HTTP 服务器内置 HTTP 服务器/Canvas 实时频谱曲线网格线 红色峰值标记每 2 秒刷新/spectrum/data返回真实频谱 JSONx 7.8~500Hz 频率轴y 各 bin 幅值peak_freq/api/status、/api/metrics系统诊断接口运行时间、WiFi/MQTT 状态、堆余量等频谱接口使用信号量保护快照避免 handler 读取到正在写入的缓冲区static esp_err_t spectrum_data_handler(httpd_req_t *req) { int16_t snapshot[SPECTRUM_MAX_LEN]; if (xSemaphoreTake(s_spectrum_lock, portMAX_DELAY) pdTRUE) { len s_spectrum_len; memcpy(snapshot, s_spectrum, len * sizeof(int16_t)); xSemaphoreGive(s_spectrum_lock); } // 构建 {peak_freq:..., x:[...], y:[...]} JSON 返回 }四、硬件连接4.1 真机验证连接信号发生器 示波器设备连接信号发生器 DG1032 CH2正弦输出 →GPIO35High-Z 负载50~400HzVpp 0.5~2V偏置 1.65V发生器 GND→ 板子 GND必须共地示波器 DHO4804 CH2BNC 同轴线监测输入波形4.2 自测回路无仪器时使用杜邦线将GPIO25DAC 输出连接到 GPIO35ADC 输入即可在板内完成波形生成 → 采集 → FFT 的闭环验证。五、编译与烧录5.1 环境准备安装 ESP-IDF v5.3.1。5.2 配置 WiFi修改mqtt_report.c中的 WiFi 配置#define WIFI_SSID 你的WiFi名称 #define WIFI_PASS 你的WiFi密码5.3 编译烧录idf.py set-target esp32 idf.py build idf.py -p COM3 flash monitor六、真机实测结果测试环境信号发生器 Rigol DG1032 示波器 DHO4804手机热点WPA3RSSI -43~-62dBmMQTT broker.emqx.ioQoS1。6.1 采样率校准✅ 实测采样率稳定1007 S/s目标 1000误差 1%。6.2 FFT 频率准确性五档频率FFT 频率验证分辨率 7.8125Hz全部 ±1 bin 内实测频率打印 输入频率为50Hz时100Hz时200Hz时300Hz时400Hz时故五档频率全部落在预期误差内分辨率 7.8Hz±1 bin 以内发生器设定 (Hz)FFT 报频 (Hz)偏差5047-310010222002033300297-3400398-2结论整条ADC 采样1kS/s→ 去直流 → Hann 窗 → 128 点 FFT → 峰值检测链路在真机上验证准确配合示波器的频率测量构成仪器级交叉验证。6.3幅度线性200Hz实测串口打印 幅度为0.5V1V时2V时200Hz 下幅度 0.5/1/2 VppFFT 幅值严格线性设定 (Vpp)FFT amp比值0.5~8,8001.001~17,5001.992~35,7004.06amp 与电压的固定换算比例来自窗函数增益与 ADC 标定系数线性无异常。6.4 网络可靠性✅ 长时间运行发布2400 条 QoS1 消息100% ACK✅ 断线期间缓存最新状态重连后自动补发Resent cached state✅ WiFi 退避重连#1 ~1087ms → #2 ~2171ms翻倍 抖动热点恢复后自动重连✅ 连续运行90 分钟无异常堆余量约 170KB七、踩坑记录坑 1/spectrum/data接口卡死真机发现现象/api/status正常频谱接口一直转圈不返回。根因httpd 任务默认栈 4096频谱 handler 的 2.3KB 局部缓冲 浮点格式化导致栈溢出任务崩溃请求挂死。解决httpd 任务栈改为8192IDF 5.x 字段名为stack_size。验证重烧后接口秒回 JSON。坑 2Web 频谱曲线不显示真机发现现象数据能更新但 Canvas 无曲线浏览器 Console 报Uncaught SyntaxError: Unexpected end of input。根因HTML 以单行字符串传输JS 中的//行注释把该行剩余代码全部注释掉函数未闭合。解决JS 中的//注释改为/* */块注释。验证本地用 Node 做单行 JS 语法检查复现同一报错修复后通过重烧后曲线正常绘制。坑 3任务看门狗报警真机发现现象每 5 秒打印task_wdt: IDLE1 (CPU 1)CPU1 被dac_out任务占用。根因DAC 输出任务为忙等循环esp_rom_delay_us优先级高且永不阻塞饿死 IDLE1。解决改用esp_timer 周期定时器驱动 DAC 输出任务不再占用 CPU。验证重烧后看门狗报警消失波形输出正常。坑 4早期经验ADC 连续模式DMA配置失败现象ADC sampling frequency out of range。原因ESP32 连续模式驱动配置受限。解决改用轮询模式One-shot1000Hz 稳定运行。八、项目总结8.1 完成功能模块功能DAC正弦波/方波/三角波esp_timer 定时驱动ADC1000Hz 采样率128 点采集实测 1007 S/sFFT去直流 Hann 窗 radix-2 峰值检测WiFi自动连接指数退避重连MQTTQoS1 上报 断线缓存补发WebCanvas 实时频谱曲线 诊断 APIFreeRTOS多任务架构8.2 项目亮点边缘计算设备端完成 FFT 分析仅上报关键结果仪器交叉验证信号发生器 示波器真机测试频率 ±1 bin、幅度线性真机排障能力真机测试发现并修复 3 个编译期不可见的问题栈溢出、JS 注释、看门狗全栈能力从驱动开发到云端上报到 Web 监控8.3 后续优化接入阿里云/腾讯云 IoT 平台实现 OTA 远程升级添加更丰富的波形类型锯齿波、自定义波形低功耗实测Light Sleep DFS 已配置待整板电流对比九、项目链接GitHubhttps://github.com/WuQinghui-00/ESP32-Signal-Processing-System真机测试报告https://github.com/WuQinghui-00/ESP32-Signal-Processing-System/blob/fae-improvement/docs/test-report.md系统架构图ESP32-Signal-Processing-System/docs/architecture.md at fae-improvement · WuQinghui-00/ESP32-Signal-Processing-System · GitHub十、参考资料ESP-IDF 电源管理文档电源管理 - ESP32 - — ESP-IDF 编程指南 latest 文档ESP-DSP 数字信号处理库https://github.com/espressif/esp-dspESP32 睡眠模式详解睡眠模式 - ESP32 - — ESP-IDF 编程指南 latest 文档
ESP32 实时信号处理与物联网系统从波形生成到 Web 频谱监控关键词ESP32、FreeRTOS、DAC、ADC、FFT、MQTT、边缘计算、Web 服务器项目源码https://github.com/WuQinghui-00/ESP32-Signal-Processing-System一、项目背景在物联网和边缘计算快速发展的今天越来越多的数据处理任务从云端下沉到设备端。本项目设计并实现了一套基于 ESP32 的嵌入式信号处理系统实现了从波形生成、数据采集、实时频谱分析到云端上报和 Web 监控的全链路闭环。核心特点设备端完成 FFT 频谱分析边缘计算仅上报关键结果降低带宽消耗内置 Web 服务器浏览器即可查看实时频谱曲线经过信号发生器 示波器真机交叉验证本文数据均为实测二、系统架构2.1 整体架构图┌─────────────────────────────────────────────────────────────┐ │ ESP32 │ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │ │ DAC 波形 │ │ ADC 采集 │ │ FFT 分析 │ │ │ │ 生成 │───▶│ 数据 │───▶│ 频谱 │ │ │ └──────────┘ └──────────┘ └──────────┘ │ │ │ │ │ │ │ ▼ ▼ ▼ │ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │ │ GPIO25 │ │ GPIO35 │ │ 峰值频率 │ │ │ │ 输出 │ │ 输入 │ │ 检测 │ │ │ └──────────┘ └──────────┘ └──────────┘ │ │ │ │ │ ▼ │ │ ┌──────────────────┐ │ │ │ WiFi MQTT 上报 │ │ │ │ HTTP Web 服务器 │ │ │ └──────────────────┘ │ └─────────────────────────────────────────────────────────────┘ │ │ ▼ ▼ ┌─────────────┐ ┌─────────────┐ │ EMQX 云端 │ │ 浏览器监控 │ │ MQTT 服务器 │ │ Canvas 绘图 │ └─────────────┘ └─────────────┘2.2 代码结构main/ ├── main.c # 主函数、采集/FFT 主循环、串口命令 ├── dac_wave.c/h # DAC 波形生成esp_timer 定时驱动 ├── adc_sample.c/h # ADC 数据采集1000Hz128 点 ├── fft_process.c/h # FFT 频谱分析Hann 窗 radix-2 峰值 ├── mqtt_report.c/h # WiFi MQTT 云端上报QoS1 断线缓存 ├── webserver.c/h # HTTP Web 服务器Canvas 频谱 诊断 API └── CMakeLists.txt # 构建配置2.3 技术栈层级技术芯片ESP32RTOSFreeRTOS驱动DAC / ADC算法FFT 峰值检测ESP-DSP通信WiFi / MQTT / HTTP框架ESP-IDF v5.3.1三、核心功能实现3.1 任务架构系统使用一个串口命令解析任务采集 FFT 上报在主循环中完成xTaskCreate(uart_task, uart, 4096, NULL, 1, NULL);DAC 波形输出由esp_timer 周期定时器驱动而非忙等循环见踩坑 3。3.2 波形生成DAC通过查表法生成正弦波、方波、三角波频率可调// 正弦波表生成 for (int i 0; i 256; i) { sine_table[i] 128 (int)(127 * sin(2 * 3.14159 * i / 256)); } // esp_timer 回调中按周期输出一个采样点 static void dac_timer_cb(void *arg) { dac_output_voltage(DAC_CHANNEL_1, sine_table[phase 255]); }3.3 数据采集ADCADC 单次采样One-shot模式1000Hz 采样率采集 128 点实测稳定1007 S/s误差 1%void adc_init(void) { adc1_config_width(ADC_WIDTH_BIT_12); adc1_config_channel_atten(ADC1_CHANNEL_7, ADC_ATTEN_DB_12); } int adc_sample(int16_t *buffer, int len) { for (int i 0; i len; i) { buffer[i] adc1_get_raw(ADC1_CHANNEL_7); esp_rom_delay_us(1000); // 1000Hz } return measured_rate; // 实际测量并返回真实采样率 }3.4 频谱分析FFT完整链路去直流 → Hann 窗 → 128 点 radix-2 FFT → 幅值谱 → 峰值检测// 去直流减去平均值消除 ADC 偏置分量 int remove_dc_offset(int16_t *data, int len); // FFT 分析Hann 窗 128 点 radix-2 FFTESP-DSP 峰值检测 int fft_analyze(int16_t *data, int len, int sample_rate, float *magnitude, float *peak_freq, float *peak_amp); // 主循环调用 int dc_offset remove_dc_offset(buffer, SAMPLE_LEN); int peak_bin fft_analyze(buffer, SAMPLE_LEN, SAMPLE_RATE, spectrum, peak_freq, peak_amp); ESP_LOGI(TAG, FFT: peak bin%d, freq%d Hz, amp%.0f, peak_bin, (int)(peak_freq 0.5f), peak_amp);频率分辨率 采样率 / FFT 点数 1000 / 128 ≈7.8Hz/bin。3.5 物联网通信WiFi MQTTWiFi 采用指数退避重连实测 1s → 2s → 4s 递增并统计断线次数/重试次数static void wifi_event_handler(void *arg, esp_event_base_t event_base, int32_t event_id, void *event_data) { if (event_base WIFI_EVENT event_id WIFI_EVENT_STA_DISCONNECTED) { schedule_reconnect_with_backoff(); // 指数退避重连 } }MQTT 使用 QoS1 上报真实频谱结果断线期间缓存最新状态重连后自动补发// 实际 payload峰值频率 峰值幅值 采样率 {peak_frequency:203,peak_amplitude:35600,sample_rate:1007}3.6 Web 监控HTTP 服务器内置 HTTP 服务器/Canvas 实时频谱曲线网格线 红色峰值标记每 2 秒刷新/spectrum/data返回真实频谱 JSONx 7.8~500Hz 频率轴y 各 bin 幅值peak_freq/api/status、/api/metrics系统诊断接口运行时间、WiFi/MQTT 状态、堆余量等频谱接口使用信号量保护快照避免 handler 读取到正在写入的缓冲区static esp_err_t spectrum_data_handler(httpd_req_t *req) { int16_t snapshot[SPECTRUM_MAX_LEN]; if (xSemaphoreTake(s_spectrum_lock, portMAX_DELAY) pdTRUE) { len s_spectrum_len; memcpy(snapshot, s_spectrum, len * sizeof(int16_t)); xSemaphoreGive(s_spectrum_lock); } // 构建 {peak_freq:..., x:[...], y:[...]} JSON 返回 }四、硬件连接4.1 真机验证连接信号发生器 示波器设备连接信号发生器 DG1032 CH2正弦输出 →GPIO35High-Z 负载50~400HzVpp 0.5~2V偏置 1.65V发生器 GND→ 板子 GND必须共地示波器 DHO4804 CH2BNC 同轴线监测输入波形4.2 自测回路无仪器时使用杜邦线将GPIO25DAC 输出连接到 GPIO35ADC 输入即可在板内完成波形生成 → 采集 → FFT 的闭环验证。五、编译与烧录5.1 环境准备安装 ESP-IDF v5.3.1。5.2 配置 WiFi修改mqtt_report.c中的 WiFi 配置#define WIFI_SSID 你的WiFi名称 #define WIFI_PASS 你的WiFi密码5.3 编译烧录idf.py set-target esp32 idf.py build idf.py -p COM3 flash monitor六、真机实测结果测试环境信号发生器 Rigol DG1032 示波器 DHO4804手机热点WPA3RSSI -43~-62dBmMQTT broker.emqx.ioQoS1。6.1 采样率校准✅ 实测采样率稳定1007 S/s目标 1000误差 1%。6.2 FFT 频率准确性五档频率FFT 频率验证分辨率 7.8125Hz全部 ±1 bin 内实测频率打印 输入频率为50Hz时100Hz时200Hz时300Hz时400Hz时故五档频率全部落在预期误差内分辨率 7.8Hz±1 bin 以内发生器设定 (Hz)FFT 报频 (Hz)偏差5047-310010222002033300297-3400398-2结论整条ADC 采样1kS/s→ 去直流 → Hann 窗 → 128 点 FFT → 峰值检测链路在真机上验证准确配合示波器的频率测量构成仪器级交叉验证。6.3幅度线性200Hz实测串口打印 幅度为0.5V1V时2V时200Hz 下幅度 0.5/1/2 VppFFT 幅值严格线性设定 (Vpp)FFT amp比值0.5~8,8001.001~17,5001.992~35,7004.06amp 与电压的固定换算比例来自窗函数增益与 ADC 标定系数线性无异常。6.4 网络可靠性✅ 长时间运行发布2400 条 QoS1 消息100% ACK✅ 断线期间缓存最新状态重连后自动补发Resent cached state✅ WiFi 退避重连#1 ~1087ms → #2 ~2171ms翻倍 抖动热点恢复后自动重连✅ 连续运行90 分钟无异常堆余量约 170KB七、踩坑记录坑 1/spectrum/data接口卡死真机发现现象/api/status正常频谱接口一直转圈不返回。根因httpd 任务默认栈 4096频谱 handler 的 2.3KB 局部缓冲 浮点格式化导致栈溢出任务崩溃请求挂死。解决httpd 任务栈改为8192IDF 5.x 字段名为stack_size。验证重烧后接口秒回 JSON。坑 2Web 频谱曲线不显示真机发现现象数据能更新但 Canvas 无曲线浏览器 Console 报Uncaught SyntaxError: Unexpected end of input。根因HTML 以单行字符串传输JS 中的//行注释把该行剩余代码全部注释掉函数未闭合。解决JS 中的//注释改为/* */块注释。验证本地用 Node 做单行 JS 语法检查复现同一报错修复后通过重烧后曲线正常绘制。坑 3任务看门狗报警真机发现现象每 5 秒打印task_wdt: IDLE1 (CPU 1)CPU1 被dac_out任务占用。根因DAC 输出任务为忙等循环esp_rom_delay_us优先级高且永不阻塞饿死 IDLE1。解决改用esp_timer 周期定时器驱动 DAC 输出任务不再占用 CPU。验证重烧后看门狗报警消失波形输出正常。坑 4早期经验ADC 连续模式DMA配置失败现象ADC sampling frequency out of range。原因ESP32 连续模式驱动配置受限。解决改用轮询模式One-shot1000Hz 稳定运行。八、项目总结8.1 完成功能模块功能DAC正弦波/方波/三角波esp_timer 定时驱动ADC1000Hz 采样率128 点采集实测 1007 S/sFFT去直流 Hann 窗 radix-2 峰值检测WiFi自动连接指数退避重连MQTTQoS1 上报 断线缓存补发WebCanvas 实时频谱曲线 诊断 APIFreeRTOS多任务架构8.2 项目亮点边缘计算设备端完成 FFT 分析仅上报关键结果仪器交叉验证信号发生器 示波器真机测试频率 ±1 bin、幅度线性真机排障能力真机测试发现并修复 3 个编译期不可见的问题栈溢出、JS 注释、看门狗全栈能力从驱动开发到云端上报到 Web 监控8.3 后续优化接入阿里云/腾讯云 IoT 平台实现 OTA 远程升级添加更丰富的波形类型锯齿波、自定义波形低功耗实测Light Sleep DFS 已配置待整板电流对比九、项目链接GitHubhttps://github.com/WuQinghui-00/ESP32-Signal-Processing-System真机测试报告https://github.com/WuQinghui-00/ESP32-Signal-Processing-System/blob/fae-improvement/docs/test-report.md系统架构图ESP32-Signal-Processing-System/docs/architecture.md at fae-improvement · WuQinghui-00/ESP32-Signal-Processing-System · GitHub十、参考资料ESP-IDF 电源管理文档电源管理 - ESP32 - — ESP-IDF 编程指南 latest 文档ESP-DSP 数字信号处理库https://github.com/espressif/esp-dspESP32 睡眠模式详解睡眠模式 - ESP32 - — ESP-IDF 编程指南 latest 文档
