STM32+LVGL实现信号同频采集与实时波形显示：电赛H题核心方案解析

在电赛这类时间紧、任务重的竞赛中，如何高效利用有限资源，快速实现核心功能并完成演示，是每个参赛者面临的巨大挑战。最近，我复盘了一次在极短时间内（约2天）独立完成2023年电赛H题“同频显示”核心功能的实战经历。虽然最终版本仅测试了一路信号，但整个方案从硬件选型、软件架构到算法实现，形成了一套完整、可复现的闭环流程。本文将详细拆解这一“速成”方案，重点分享如何快速搭建系统、实现信号同频采集与显示，并深入剖析其中的关键技术与避坑要点。无论你是正在备赛的电赛新手，还是对信号处理与实时显示感兴趣的开发者，都能从中获得可直接复用的代码和清晰的实现思路。

1. 项目背景与核心需求分析

1.1 2023年电赛H题“同频显示”任务解读

全国大学生电子设计竞赛（电赛）的题目通常要求参赛者在规定时间内完成一个功能完整的电子系统。2023年H题“同频显示”的核心任务，是设计并制作一个信号采集与显示装置，能够对多路同频信号进行同步采集，并在显示屏上以一致的频率和相位关系进行可视化，从而直观展示信号间的相互关系。

核心挑战在于“同频”与“同步”：

1. 同频采集：需要确保对多路信号的采样时钟完全同步，避免因采样时刻不同步引入的相位误差，这是后续进行准确对比分析的基础。
2. 实时显示：采集到的数据需要以波形图等形式实时刷新显示，并且显示的更新频率需要与信号频率保持协调，避免出现显示卡顿或波形闪烁。
3. 系统集成：在有限的2天时间内，需要完成从传感器信号调理、微控制器采集、数据处理到屏幕驱动的全链路开发，对开发者的系统设计能力和编码效率是极大考验。

1.2 “一人两天速成”策略与范围界定

面对这样的挑战，“速成”并非意味着降低质量，而是聚焦核心、简化外围、复用成熟方案。本次实战的策略明确为：

• 核心目标：优先实现“一路信号的完整采集、处理与同频显示”闭环。证明系统架构和核心算法的可行性。
• 简化范围：暂不实现多路信号的严格同步采集（此为后续扩展点），但软件架构预留接口。显示部分先实现单路波形稳定、无闪烁的刷新。
• 技术选型：选用社区资源丰富、性能足够的硬件平台（如STM32系列MCU）和成熟的图形库（如LVGL、U8g2等），避免在底层驱动上耗费过多时间。
• 开发节奏：第一天完成硬件连接、基础驱动和采集功能；第二天集中攻克显示刷新算法和系统联调。

本文将围绕这个已实现的“单路信号版”同频显示系统展开，详细说明其实现过程。掌握了单路的核心，扩展到多路同步将主要增加硬件同步触发和软件数据结构的调整。

2. 系统设计与硬件平台选型

一个典型的同频显示系统包含信号输入、核心处理、信息输出三大模块。我们的速成方案硬件架构力求简洁、可靠。

2.1 系统整体架构框图

[信号源] --> [信号调理电路] --> [ADC采集引脚] --> [微控制器(MCU)] | | (处理、缓存) V [显示控制器] --> [显示屏]

• 信号源：可以是函数发生器产生的正弦波、方波等，也可以是实际传感器输出的模拟信号。
• 信号调理电路：根据信号幅度，可能需要进行衰减、放大、电平偏移（抬升到MCU的ADC正电压输入范围，如0-3.3V）以及必要的滤波。
• 微控制器(MCU)：系统的核心，负责ADC采样控制、数据缓存、波形数据处理、显示指令生成。
• 显示屏：用于可视化波形，通常选用SPI或I2C接口的TFT液晶屏，分辨率无需过高（如320x240），但刷新率要满足要求。

2.2 关键硬件组件选型建议

1. 微控制器 (MCU)：STM32F4系列（如STM32F407/F429）

• 理由：性价比高，主频高（168MHz以上），内置高速ADC（可达2.4MSPS），DMA资源丰富，且有成熟的HAL库或标准外设库，开发效率高。F429还集成了LCD-TFT控制器，可直接驱动RGB接口屏幕，性能更强。
• 备选：如果对成本更敏感，STM32F1系列（如F103C8T6）也可行，但ADC速度和主频较低，需要更精细的优化。

2. 显示屏：SPI接口的TFT屏（如ILI9341驱动芯片）

• 理由：SPI接口接线简单（仅需4-5根线），虽然纯软件SPI刷屏速度慢，但通过STM32的硬件SPI+DMA可以极大提升刷屏效率，满足波形刷新需求。市面上模块化程度高，资料丰富。
• 注意：如果选用STM32F429，可以直接使用其FSMC接口驱动8080并口屏，刷屏速度极快，是更优选择。

3. ADC采集：利用MCU内置ADC

• 优势：无需外置ADC芯片，简化电路和编程。STM32的ADC支持定时器触发、DMA传输，能实现精准的等间隔采样，这是实现“同频”采集的关键。

4. 信号调理：运算放大器电路

• 作用：如果信号幅度不在ADC量程内，需要设计简单的同相放大或反相放大电路。必要时加入电压跟随器提高输入阻抗，加入RC低通滤波抗混叠。

本方案实际使用硬件清单：

• MCU最小系统板：STM32F407VET6核心板
• 显示屏：2.4寸 SPI TFT屏 (驱动芯片ILI9341)
• 调试工具：ST-Link V2下载器/调试器
• 信号源：普源精电（Rigol）DG1022函数发生器
• 其他：杜邦线、电阻电容若干用于信号调理（视具体信号而定）

3. 软件开发环境与工程配置

“工欲善其事，必先利其器”。快速开发离不开高效的开发环境。

3.1 开发环境搭建

1. IDE选择：STM32CubeIDE
   • 这是ST官方推出的免费集成开发环境，基于Eclipse，集成了STM32CubeMX配置工具、代码编辑器、编译器和调试器。一站式解决配置、编码、调试问题，非常适合快速原型开发。
2. 固件库：STM32CubeF4 Firmware Package
   • 在STM32CubeIDE中创建项目时，会自动下载或关联对应的HAL库。HAL库抽象程度高，代码可移植性好，虽然效率略低于标准库，但开发速度更快。
3. 图形库选择：LVGL (Light and Versatile Graphics Library)
   • 一个开源、高度可裁剪的嵌入式图形库，支持多种控件和动画，内存占用相对灵活。虽然上手有一定复杂度，但其强大的功能和活跃的社区，对于需要绘制动态波形图的应用是很好的选择。本方案使用LVGL。
   • 备选：u8g2库更轻量，适合单色屏或简单图形；TFT_eSPI（来自Arduino生态）配置简单，但与STM32CubeIDE集成稍麻烦。

3.2 STM32CubeMX工程初始化

这是最关键的一步，通过图形化配置生成基础代码。

1. 创建项目：选择对应的MCU型号（STM32F407VETx）。
2. 系统核心（SYS）：
   • Debug: 设置为Serial Wire，以便使用ST-Link调试。
3. 时钟（RCC）：
   • High Speed Clock (HSE): 选择Crystal/Ceramic Resonator，使用外部8MHz晶振。
   • 在Clock Configuration标签页，将系统时钟（SYSCLK）配置到最大168MHz，并确保ADC、APB2等时钟在允许范围内（ADC时钟通常不超过36MHz）。
4. ADC配置（以ADC1, 通道0为例）：
   • 在Analog->ADC1中，启用IN0通道（对应PA0引脚）。
   • Parameter Settings:
     • Resolution: 12位（4096级分辨率）。
     • Scan Conversion Mode:Disabled（单通道）。
     • Continuous Conversion Mode:Disabled，我们将用定时器触发。
     • DMA Continuous Requests:Enabled（与DMA配合）。
     • End Of Conversion Selection:EOC flag at the end of single conversion。
   • DMA Settings: 点击Add，选择ADC1，模式为Circular（循环模式），这样DMA会自动循环填充缓冲区。
5. 定时器配置（用于触发ADC采样）：
   • 启用一个通用定时器，如TIM2。
   • Parameter Settings:
     • Prescaler: 根据采样率计算。例如，定时器时钟为84MHz，要产生10kHz的采样率，则Prescaler设为8399，Counter Period设为999。这样更新频率 = 84MHz / (8400 * 1000) = 10Hz？这里计算有误，正确应为：Update Event = TIM_CLK / ((PSC+1)*(ARR+1))。设目标采样率Fs=10kHz，TIM_CLK=84MHz，则(PSC+1)*(ARR+1) = 84M / 10k = 8400。可以令PSC=839，ARR=99，则(839+1)*(99+1)=840*100=84000，实际Fs=84M/84000=1kHz。需要重新调整。关键在于ARR和PSC的配置。
     • Trigger Event Selection: 选择Update Event作为触发输出。
   • 在ADC1的Regular Conversion设置中，将External Trigger Conversion Source设置为Timer 2 Trigger Out event。
6. SPI配置（驱动屏幕）：
   • 启用SPI1（或根据屏幕实际连接选择）。
   • Parameter Settings:
     • Mode:Full-Duplex Master。
     • Hardware NSS Signal:Disable（软件控制片选）。
     • 根据ILI9341数据手册设置Baud Rate（不要超过屏幕极限，如20MHz以下），Data Size为8 Bits，CPOL/CPHA通常为Low/1 Edge（Mode 0），具体需查屏驱手册。
7. GPIO配置：
   • 配置SPI的SCK、MISO、MOSI引脚。
   • 配置一个GPIO引脚作为屏幕的DC（数据/命令）线，另一个作为RST（复位）线，CS（片选）线也可以用一个GPIO控制。
8. 生成代码：
   • 在Project Manager中设置好项目名称、路径、Toolchain/IDE为STM32CubeIDE。
   • 点击GENERATE CODE，生成初始化代码。

4. 核心模块代码实现

生成了基础工程后，我们需要在main.c和自定义的文件中添加核心逻辑。

4.1 ADC与DMA数据采集模块

目标：配置定时器以固定频率触发ADC，并通过DMA将采样值自动存入循环缓冲区。

首先，在main.c的/* USER CODE BEGIN PV */区域定义缓冲区。

/* Private variables ---------------------------------------------------------*/ #define ADC_BUFFER_SIZE 1024 // 采样缓冲区大小，需为2的幂次，便于取模运算 volatile uint16_t adc_buffer[ADC_BUFFER_SIZE]; // DMA将数据填充至此 volatile uint32_t adc_buffer_index = 0; // 用于记录当前最新数据位置的索引（由DMA半满/全满中断更新）

在/* USER CODE BEGIN 2 */区域启动ADC和DMA。

/* USER CODE BEGIN 2 */ // 启动DMA传输，将ADC转换结果搬运到adc_buffer if (HAL_ADC_Start_DMA(&hadc1, (uint32_t*)adc_buffer, ADC_BUFFER_SIZE) != HAL_OK) { Error_Handler(); } // 启动定时器，定时器溢出事件将触发ADC转换 HAL_TIM_Base_Start(&htim2); /* USER CODE END 2 */

为了知道DMA传输到了哪个位置，我们需要开启DMA的半传输完成和传输完成中断，并在回调函数中更新索引。

在CubeMX中，ADC1的DMA设置里，将DMA Interrupt Settings中的Transfer Complete和Half Transfer中断使能。

然后，在stm32f4xx_it.c中找到DMA2_Stream0（或你实际使用的流）的中断服务函数，但更规范的做法是使用HAL库的回调函数。我们在main.c中重写对应的回调函数：

/* USER CODE BEGIN 4 */ // DMA传输完成一半的回调（前半部分缓冲区满） void HAL_ADC_ConvHalfCpltCallback(ADC_HandleTypeDef* hadc) { if (hadc->Instance == ADC1) { adc_buffer_index = ADC_BUFFER_SIZE / 2; // 最新数据在前半部分的末尾 } } // DMA传输全部完成的回调（后半部分缓冲区满） void HAL_ADC_ConvCpltCallback(ADC_HandleTypeDef* hadc) { if (hadc->Instance == ADC1) { adc_buffer_index = ADC_BUFFER_SIZE; // 最新数据在缓冲区的末尾 } } /* USER CODE END 4 */

关键点：adc_buffer_index指示了DMA即将写入的下一个位置的前一个位置（即最新有效数据的位置）。由于是循环缓冲区，实际读取时需要进行取模运算。这种方式避免了在中断中进行大量数据处理，仅更新索引，将耗时的波形绘制工作放在主循环中。

4.2 LVGL图形库移植与驱动适配

LVGL的移植主要涉及三个部分：显示驱动、输入设备驱动和心跳时钟。

1. 添加LVGL源码到工程：

   • 从LVGL官网下载最新稳定版源码。
   • 在CubeIDE工程中，创建Middlewares/lvgl文件夹，将lvgl源码目录下的src、examples、demos等需要的文件夹复制进来，并在IDE中导入这些文件组。
   • 在项目属性C/C++ Build->Settings->MCU GCC Compiler->Include paths中，添加LVGL头文件路径。

2. 配置lv_conf.h：

   • 将lvgl目录下的lv_conf_template.h复制到工程根目录，重命名为lv_conf.h。
   • 在lv_conf.h中启用关键功能，并设置显示分辨率：

     #if 1 /*Set it to "1" to enable content*/ #define LV_COLOR_DEPTH 16 // 颜色深度，16位RGB565适合TFT #define LV_HOR_RES_MAX 320 // 水平分辨率 #define LV_VER_RES_MAX 240 // 垂直分辨率 // 内存配置：使用静态缓冲区 #define LV_MEM_SIZE (32U * 1024U) // 为LVGL分配32KB内存 #define LV_DISP_DEF_REFR_PERIOD 30 // 默认刷新周期[ms] #define LV_USE_PERF_MONITOR 0 // 性能监控，调试时可开启 #define LV_USE_LOG 0 // 日志，调试时可开启 // 禁用不需要的模块以节省空间 #define LV_USE_FLEX 0 #define LV_USE_GRID 0

   • 在main.c中包含此头文件：#include “lv_conf.h”。

3. 实现显示驱动（lv_port_disp.c）：

   • 参考LVGL的examples/porting模板。核心是实现一个flush_cb回调函数，该函数负责将LVGL绘制好的图像数据（一个矩形区域）搬运到屏幕的指定位置。
   • 我们需要在此函数中实现通过SPI向ILI9341发送绘图命令和数据。通常需要先设置窗口（CASET,PASET），然后发送RAMWR命令，接着连续发送像素数据。
   • 优化关键：使用STM32的SPI+DMA来发送像素数据，将CPU从繁重的SPI传输中解放出来。在flush_cb中启动DMA传输，并等待传输完成信号（或使用LVGL的异步刷新机制）。

4. 实现心跳定时器：

   • LVGL需要在一个定时器中断中调用lv_tick_inc(x)来更新内部时钟。我们可以使用一个基本定时器（如TIM3），配置为1ms中断。
   • 在stm32f4xx_it.c的TIM3_IRQHandler中调用lv_tick_inc(1);。

5. 初始化LVGL：

   • 在main.c的/* USER CODE BEGIN 2 */中，初始化LVGL并创建屏幕对象。

     lv_init(); lv_port_disp_init(); // 初始化显示驱动 // lv_port_indev_init(); // 如果需要触摸，初始化输入设备 lv_obj_t * scr = lv_scr_act(); // 获取当前活跃屏幕

4.3 波形绘制控件与同频显示逻辑

这是软件的核心。我们将在LVGL的屏幕上创建一个图表（lv_chart）对象来显示波形。

1. 创建图表：

   /* USER CODE BEGIN 2 */ // ... LVGL初始化之后 lv_obj_t * chart = lv_chart_create(lv_scr_act()); lv_obj_set_size(chart, 300, 200); // 设置图表大小 lv_obj_align(chart, LV_ALIGN_CENTER, 0, 0); // 居中 lv_chart_set_point_count(chart, ADC_BUFFER_SIZE); // 设置图表点数，与采样缓冲区一致 lv_chart_set_range(chart, LV_CHART_AXIS_PRIMARY_Y, 0, 4095); // Y轴范围对应ADC 12位值 lv_chart_set_div_line_count(chart, 5, 5); // 设置网格线数量 lv_chart_set_update_mode(chart, LV_CHART_UPDATE_MODE_CIRCULAR); // 环形更新模式，新数据从右侧推入，旧数据从左侧移出，形成滚动效果 lv_chart_series_t * ser = lv_chart_add_series(chart, lv_palette_main(LV_PALETTE_BLUE), LV_CHART_AXIS_PRIMARY_Y); // 添加一个数据系列 /* USER CODE END 2 */

2. 主循环中更新波形（实现“同频显示”）： “同频显示”的本质是显示刷新率与信号频率或采样率保持协调。我们不是每采一个点就刷新一次屏幕（那会极其频繁且无必要），而是采集够一屏（或一个周期）的数据后，批量刷新。

   /* USER CODE BEGIN WHILE */ uint32_t last_draw_time = 0; uint32_t draw_interval = 33; // 约30Hz刷新率 (1000ms/30 ≈ 33ms) while (1) { uint32_t current_time = HAL_GetTick(); // 控制刷新频率，避免过度刷新导致卡顿 if (current_time - last_draw_time > draw_interval) { static uint32_t last_read_index = 0; uint32_t current_index = adc_buffer_index; // 获取DMA最新索引 if (current_index != last_read_index) { // 计算需要读取的数据量 int32_t data_to_read = (current_index - last_read_index) & (ADC_BUFFER_SIZE - 1); // 利用位与运算处理循环缓冲区 if (data_to_read < 0) data_to_read += ADC_BUFFER_SIZE; // 限制一次最多读取的点数，防止一次处理数据过多阻塞主循环 uint32_t max_points_per_frame = lv_chart_get_point_count(chart); data_to_read = data_to_read > max_points_per_frame ? max_points_per_frame : data_to_read; if (data_to_read > 0) { // 从循环缓冲区中读取数据并更新图表系列 for (uint32_t i = 0; i < data_to_read; i++) { last_read_index = (last_read_index + 1) & (ADC_BUFFER_SIZE - 1); // 更新读取索引 lv_chart_set_next_value(chart, ser, adc_buffer[last_read_index]); // 设置图表的下一个值 } lv_chart_refresh(chart); // 刷新图表显示 } } last_draw_time = current_time; } lv_timer_handler(); // 处理LVGL的任务和动画，必须周期性调用 HAL_Delay(5); // 短暂延时，防止CPU占用率100% } /* USER CODE END WHILE */

   逻辑解析：

   • draw_interval控制了波形刷新的最大频率。例如33ms对应约30FPS，对于观察低频信号（几十Hz到几百Hz）足够平滑。
   • 通过比较current_index和last_read_index，计算出自上次刷新以来新产生了多少采样点。
   • 使用位与运算& (ADC_BUFFER_SIZE - 1)来处理循环缓冲区的索引回绕，前提是ADC_BUFFER_SIZE是2的幂。
   • lv_chart_set_next_value将ADC值添加到图表系列中。由于图表设置为LV_CHART_UPDATE_MODE_CIRCULAR，新数据会从右侧推入，形成波形向左滚动的动态效果，这是示波器常见的显示模式。
   • lv_timer_handler()必须被周期性调用，以处理LVGL的内部任务，如渲染、动画等。

5. 系统联调与效果验证

将代码编译下载到STM32开发板后，进行系统联调。

5.1 硬件连接检查

1. 确保ST-Link与板子连接正确，供电正常。
2. 将函数发生器的输出通过信号调理电路（如果需要）连接到MCU的ADC输入引脚（如PA0）。
3. SPI屏幕的VCC、GND、SCK、MOSI、DC、RST、CS与MCU对应引脚连接正确。BL（背光）接高电平或PWM控制。

5.2 信号源设置与观测

1. 在函数发生器上设置一个正弦波，频率设为1kHz，幅度设为1Vpp，偏移设为1.65V（假设ADC参考电压为3.3V，则1.65V位于量程中间）。
2. 上电后，观察屏幕。应该能看到一条稳定的正弦波形在屏幕上从左向右滚动。
3. 调整采样率：修改定时器TIM2的预分频器（PSC）和自动重载值（ARR），可以改变ADC的采样频率。采样率至少应为信号最高频率的2倍（奈奎斯特定理），实际中建议5-10倍以上以获得较好波形。例如，要采样1kHz信号，采样率可设为10kHz。
4. 调整显示：如果波形滚动太快或太慢，可以调整draw_interval或lv_chart_set_point_count。更少的点数会使波形滚动更快，更多的点数则能显示更长的历史波形但滚动变慢。

5.3 实现“同频”效果验证

“同频显示”在这里体现为：当改变信号源频率时，屏幕上波形的周期数（一个屏幕宽度内显示的完整波形个数）应保持相对稳定，且波形不应出现明显的断裂或混叠。

• 测试：将信号频率从1kHz逐步增加到5kHz、10kHz。
• 预期现象：波形看起来更“密集”（因为一个屏幕宽度内的时间跨度固定，频率高则周期多），但波形本身应该是连续、光滑的正弦波，没有明显的毛刺或失真。如果出现波形断裂，可能是采样率不够高；如果波形严重失真，可能是信号调理电路带宽不足或存在干扰。

6. 常见问题与排查思路

在开发过程中，你可能会遇到以下问题：

7. 扩展优化与进阶思路

完成单路信号的基本显示后，可以从以下几个方面进行扩展和优化，向完整的电赛题目要求迈进：

7.1 扩展至多路同步采集与显示

1. 硬件同步：使用同一个定时器的多个触发输出（如主从定时器模式），同时触发多个ADC（如果MCU有多个ADC），或者使用一个ADC的扫描模式轮流采样多个通道。扫描模式+定时器触发+DMA是实现多路同步采样的经典方案。
2. 软件架构：为每一路信号创建独立的LVGL图表系列（lv_chart_series_t），并使用不同的颜色。在DMA中断或主循环中，将不同通道的数据分别填充到对应的系列中。
3. 相位关系显示：可以在图表上添加垂直光标线，或者通过计算两路信号的过零点时间差来动态显示相位差。

7.2 提升性能与稳定性

1. 双缓冲区机制：为ADC DMA设置双缓冲区（Double Buffer），当其中一个缓冲区满时触发中断进行数据处理，同时DMA继续向另一个缓冲区写入，实现“乒乓操作”，彻底避免数据丢失。
2. 直接存储器访问（DMA2D）：如果使用STM32F4/F7/H7系列且屏幕为RGB接口，可以利用DMA2D硬件加速图形填充和混合，极大减轻CPU负担，让更多资源用于信号处理算法。
3. 实时操作系统（RTOS）：引入FreeRTOS等RTOS，将ADC采集、波形处理、图形刷新、用户交互等任务分配到不同优先级的线程中，提高系统的实时性和响应性。

7.3 增加实用功能

1. 参数自动测量：在MCU端实现简单的信号分析算法，计算并实时显示信号的频率、周期、峰峰值、有效值等。
2. 触发功能：实现边沿触发，使波形稳定显示。可以设置触发电平和触发边沿（上升沿/下降沿），只有当ADC数据满足触发条件时，才开始更新显示缓冲区。
3. 波形存储与回放：将一段时间的ADC数据存入外部Flash或SD卡，之后可以回放分析。
4. 人机交互：增加编码器或按键，用于调整采样率、时基、电压档位等参数，并通过LVGL创建美观的设置菜单。

这套基于STM32和LVGL的“同频显示”速成方案，在两天内成功实现了从信号采集到实时显示的核心闭环。它验证了硬件选型、软件架构和关键算法（定时器触发ADC、DMA循环缓冲、LVGL动态图表）的可行性。虽然目前只处理了一路信号，但整个框架清晰，模块化程度高，为扩展多路同步、添加高级功能奠定了坚实基础。电赛备战或类似嵌入式图形化显示项目开发，关键在于快速搭建可运行的原型，然后在此基础上迭代优化。希望这篇详细的实战笔记能为你提供一条清晰的路径，助你在紧张的时间内高效完成开发任务。