简介：这是一份面向STM32初学者与嵌入式显示开发者的LCD实时波形绘制工程源码，围绕3.5寸彩屏驱动、ADC采样与动态曲线刷新展开，可用于数据采集可视化练习和课程设计参考。压缩包共136个文件，约3.08MB，包含33个c与35个h源码、Keil工程及编译中间文件，如uvprojx、hex、axf、map，另有STM32F10x标准外设库中的tim、adc、rcc、flash等驱动，便于直接编译与二次移植。已有4531人学习下载。工程结构按启动文件、外设初始化、LCD底层驱动与应用层绘制划分，便于对照学习。工程将LCD初始化、像素格式转换、坐标缩放与波形绘制封装为可复用函数，并涉及缓冲区更新、定时刷新和DMA传输思路；读者可据此梳理GPIO并口时序、屏幕清屏画线流程及采样数据显示链路，也方便调整分辨率、刷新率和显示范围以适配不同屏幕，并保留参数配置入口。
1. 从「波形抖成一团」说起：一块 LCD 要自己画波形的三个理由
把 STM32 和一块小尺寸 LCD 接起来点亮，半天能做到；但要让它在 LCD 上做实时波形图绘制，把 1 kHz 的方波画得不闪、不撕裂、不丢点，很多人会卡上一两周。这套方案解决的就是中间这段落差：它是一套完整的嵌入式波形显示方案，从采样触发、缓冲组织到屏幕刷新全部自己实现，不依赖图形库和操作系统，RAM 占用控制在十几 KB 以内。适合拿它做单片机课程设计、毕业设计里的信号采集与显示模块，也适合嵌入式硬件从业者做低成本的现场波形监视界面。难点集中在三处：采样速率和屏幕刷新速率对不上、SPI 写屏带宽有限、片上 RAM 装不下一整屏的缓冲区。
2. 总体架构设计：三层结构与四个模块的职责划分
2.1 为什么把采样、缓冲、渲染切成三层
新手最容易写出的结构是「ADC 采一个点，马上算坐标，马上画到屏上」。这个写法在采样率 100 Hz 以下勉强能跑，一旦提到 1 kHz 以上就会立刻翻车：画一个点要走一次设窗口加写显存的流程，SPI 屏上一列像素发完要几十微秒，采样节奏被显示拖死，画出来的波形稀疏、断续、时间轴全是假的。
正确的切法是按「实时性强弱」分层。采集层是硬实时，由定时器硬件触发，中断里只允许做指针切换和标志置位，绝对不能碰屏幕；缓冲层是软实时，负责在采集和渲染之间做速率解耦，把「生产快、消费慢」的矛盾吃掉；渲染层是尽力而为，主循环有空就刷一帧，来不及就跳帧，绝不反向阻塞采集。三层之间只通过缓冲区交换数据，任何一层内部改动都不影响另外两层，这是后面能单独调优采样率或者单独换屏幕的前提。
分层之后有个硬性纪律要守住：中断服务函数里的执行时间必须有上界，而且这个上界要远小于采样周期。我一般要求 ISR 控制在 5 微秒以内，具体做法是把 DMA 搬运、数据拷贝这些活儿全部挪到主循环，中断里只记录「哪一半缓冲已经满了」这一个状态。
2.2 四个模块的接口与数据流
三层拆下来是四个模块：采集模块（定时器 + ADC + DMA）、缓冲模块（双缓冲 + 环形队列）、渲染模块（坐标映射 + 笔刷 + 局部刷新）、显示驱动模块（LCD 底层读写）。数据流是单向的：ADC → DMA → 缓冲 → 渲染 → LCD，中间不回流，这样排查问题时可以顺着数据流一段一段打点，比在回调里到处加打印高效得多。
四个模块的职责边界用一张表定死，写代码之前先对齐这张表，后面扯皮会少很多：
| 模块 | 触发方式 | 单次耗时预算 | 持有的数据 | 禁止做的事 |
|---|---|---|---|---|
| 采集 capture | 定时器 TRGO 硬件触发 | ISR < 5 μs | DMA 目标缓冲 | 浮点运算、写屏、动态内存 |
| 缓冲 buffer | 采集侧写入、渲染侧读取 | 拷贝 512 点 < 200 μs | 双缓冲 + 读写指针 | 阻塞等待、加长临界区 |
| 渲染 render | 主循环轮询 | 单帧 < 15 ms | 一帧像素数据 + 脏列位图 | 直接操作 ADC 寄存器 |
| 显示 lcd_drv | 渲染模块调用 | 单列 < 100 μs | 无（纯函数式） | 缓存整屏显存（RAM 不够） |
模块之间的契约用一个头文件表达，四个模块各自包含它，谁都不许直接引用别人的内部变量：
/* wave.h —— 三层之间唯一的契约，模块之间只认这几个函数 */ #ifndef WAVE_H #define WAVE_H #include <stdint.h> #define WAVE_POINTS 512 /* 一屏可容纳的采样点数，按屏幕宽度取值 */ #define WAVE_CHANNELS 2 /* 双通道交替采样时的通道数 */ /* 采集层 -> 缓冲层：DMA 半满/全满回调里调用，只做指针切换，不拷贝 */ void wave_push_isr(const uint16_t *src, uint16_t half_len); /* 缓冲层 -> 渲染层：取一帧最新的连续数据，返回实际点数 */ uint16_t wave_take_frame(uint16_t *dst, uint16_t max_len); /* 渲染层：把一帧数据画到屏幕指定区域，内部做坐标映射和脏列判断 */ void wave_render(const uint16_t *frame, uint16_t len, uint8_t ch); #endif这三个函数的签名是反复改出来的结果，值得说清楚为什么这么定。wave_push_isr传进来的是 DMA 缓冲的地址而不是数据本身，函数里只把指针存进队列并返回，真正的拷贝留给主循环，所以它在中断里是安全的。wave_take_frame返回实际点数而不是固定长度，是为了让渲染层在采样率变化、一帧凑不满时也能正常画，不至于读越界。wave_render带通道号，双通道交替采样时同一帧里奇偶点属于不同通道，渲染时要按步长 2 抽取，这个参数省不掉。
2.3 主循环与中断的分工
主循环的结构定成「非阻塞轮询 + 状态标志」，不用 RTOS 也能跑得很稳。核心是一个while(1)里依次检查：有没有新帧可取、有没有脏列要刷、有没有按键或串口命令要处理。每一件事都做成「进来先看标志，标志没置就立刻返回」的形式，任何一环卡住都不会拖累其他环。
int main(void) { system_clock_init(); lcd_init(); /* 屏幕初始化，放在采样启动之前 */ capture_init(1000); /* 1 kHz 采样率，具体数值见 3.1 的推导 */ wave_render_init(); capture_start(); /* 最后才开定时器，避免初始化期间堆数据 */ for (;;) { uint16_t frame[WAVE_POINTS]; /* 有整帧就取，取不到直接跳过，不做忙等 */ uint16_t n = wave_take_frame(frame, WAVE_POINTS); if (n) { wave_render(frame, n, 0); /* 通道 0 */ } ui_poll(); /* 按键、串口命令，内部同样是非阻塞 */ } }这段代码里有两处刻意的设计。一是frame数组放在栈上，512 点占 1 KB，主循环栈通常够用；如果屏幕更宽、点数更多，就改成静态数组，别让它压栈。二是capture_start()放在初始化最后，因为定时器一开 ADC 就开始出数，如果此时缓冲还没准备好，前几帧的数据是脏的，屏幕上第一条波形会莫名其妙地跳一下。
时间预算要提前算，不能等写完再测。以 240×320 的 SPI 屏、SPI 时钟 40 MHz 估算，写一个 16 位像素的净时间约 0.4 μs，一列 240 像素约 96 μs，整屏一次约 23 ms。这意味着整屏重画最多 40 帧每秒，波形图根本追不上 1 kHz 的采样率。所以渲染层必须走局部刷新，只画有变化的那几列，把单帧时间压到 5 ms 以内，才能做到每秒 200 帧的视觉刷新。这个估算是后面第 4 章所有优化手法的出发点。
3. 采样链路设计：定时器触发 ADC 与 DMA 双缓冲怎么配
3.1 采样率怎么定：从奈奎斯特到屏幕像素
采样率不能拍脑袋定，它同时被三个条件约束：信号本身的最高频率、屏幕横向能画多少点、以及一帧的刷新时间。按奈奎斯特，采样率至少是被测信号最高频率的 2 倍，工程上一般取 5 到 10 倍，波形才看得出形状；按屏幕，一屏 320 列最多画 320 个点，多采的点要么抽稀要么叠在一起，白费力气；按刷新，1 kHz 采样配 1000 点一帧，主循环每秒要处理 1000 点，这个量对 Cortex-M3 来说是轻松的。
实际取值我一般这样推：先确定要观察的信号带宽，比如心率波形 0.5～5 Hz、音频包络 20～200 Hz、工频干扰 50 Hz、开关电源纹波几十 kHz。前三种用 1 kHz 采样绰绰有余，最后一种就得上 200 kHz 以上，此时一帧只能容纳几十个点，得改用「抽取 + 峰值保持」的显示策略，把一段时间的最大值和最小值画成一条带，而不是逐点连线。这个取舍要在方案里写清楚，答辩时被问到「采样率为什么是 1 kHz」能立刻答上来。
采样率算出来之后，还要核一件事：ADC 的转换时间够不够。以 12 位、采样时间 15 个周期的配置为例，单次转换约 1.2 μs，对应最高约 800 kHz，1 kHz 完全够；但如果开了多通道扫描，每个通道都要单独转换，时间要乘以通道数，这时候 1 kHz 乘 2 通道仍然富余，可以放心用。
3.2 定时器触发 ADC 与 DMA 搬运的配置
采样节奏必须由硬件定时器给，不能用软件延时。软件延时的抖动来自中断响应和循环开销，几十微秒的抖动在时域波形上就是肉眼可见的横向抖动，查起来像玄学，其实就是触发源不对。
配置思路是三件事：定时器更新事件作为 TRGO 输出、ADC 外部触发源指向这个 TRGO、DMA 循环模式把转换结果搬进双缓冲。下面这段是 HAL 库风格的核心配置，参数按实际主频修改：
/* 采样链路初始化：TIM3 TRGO 触发 ADC1，DMA 循环搬运到双缓冲 */ static uint16_t adc_dma_buf[2][WAVE_POINTS]; /* 两块交替：DMA 写一块，CPU 读另一块 */ void capture_init(uint32_t fs_hz) { /* 1. 采样率 = 定时器更新频率，先算自动重装值 */ uint32_t timer_clk = 84000000UL; /* 定时器时钟，按实际总线频率改 */ uint32_t arr = timer_clk / fs_hz - 1; /* 预分频取 0，全部靠 ARR 分频 */ htim3.Instance = TIM3; htim3.Init.Prescaler = 0; htim3.Init.Period = arr; htim3.Init.CounterMode = TIM_COUNTERMODE_UP; HAL_TIM_Base_Init(&htim3); /* 2. TRGO 选更新事件，ADC 每收到一个上升沿才转换一次 */ TIM_MasterConfigTypeDef mc = {0}; mc.MasterOutputTrigger = TIM_TRGO_UPDATE; mc.MasterSlaveMode = TIM_MASTERSLAVEMODE_DISABLE; HAL_TIMEx_MasterConfigSynchronization(&htim3, &mc); /* 3. ADC 关连续转换，节奏完全交给外部触发 */ hadc1.Instance = ADC1; hadc1.Init.ContinuousConvMode = DISABLE; hadc1.Init.ExternalTrigConv = ADC_EXTERNALTRIGCONV_T3_TRGO; hadc1.Init.DMAContinuousRequests = ENABLE; HAL_ADC_Init(&hadc1); /* 4. DMA 循环模式，长度 = 一整块，半满和全满各触发一次中断 */ HAL_ADC_Start_DMA(&hadc1, (uint32_t *)adc_dma_buf, WAVE_POINTS * 2); }几个参数要说清楚。Prescaler = 0是故意的，把分频全部压到 ARR 上，这样采样率调整只需要改一个数，不会出现两个分频系数互相影响的糊涂账。ContinuousConvMode = DISABLE是这套方案的关键，开了连续转换就等于让 ADC 自己狂奔，定时器的触发形同虚设，采样间隔立刻变得不可预测。DMAContinuousRequests = ENABLE保证 DMA 搬完一轮自动回到起点，不用在中断里重新装载，省掉一次重配置的时间窗口。
DMA 长度写成WAVE_POINTS * 2，是把两块缓冲当成一个连续的大数组交给 DMA，这样半满中断对应第一块写满，全满中断对应第二块写满，正好构成天然的双缓冲，不需要额外的乒乓切换逻辑。
3.3 环形缓冲与半满中断的用法
双缓冲解决的是「读写不打架」，但只有两块的时候，如果渲染慢了一拍，第二块也被覆盖，数据就丢了。稳妥的做法是在双缓冲之后再加一层环形队列，把 DMA 的物理双缓冲和逻辑上的数据队列分开：中断里把写满的那半块推进环形队列，主循环从队列里取帧，队列满了就丢最旧的一帧并计数，丢帧数打到调试串口上，是不是丢数据一眼就知道。
/* 环形队列：8 个槽位，每个槽位存一个指针，不拷贝数据本身 */ #define WAVE_QUEUE_LEN 8 static const uint16_t *q_buf[WAVE_QUEUE_LEN]; static volatile uint8_t q_head, q_tail; static volatile uint32_t drop_cnt; /* 丢帧计数，验收时要读它 */ /* 在 DMA 半满/全满回调里调用，执行时间恒定，与点数无关 */ void wave_push_isr(const uint16_t *src, uint16_t half_len) { (void)half_len; uint8_t next = (q_head + 1) % WAVE_QUEUE_LEN; if (next == q_tail) { /* 队列满：丢最旧，保最新，波形才不会滞后 */ q_tail = (q_tail + 1) % WAVE_QUEUE_LEN; drop_cnt++; } q_buf[q_head] = src; /* 只存指针，一次赋值，几十纳秒 */ q_head = next; } /* 主循环调用：取一帧，取不到返回 0 */ uint16_t wave_take_frame(uint16_t *dst, uint16_t max_len) { if (q_tail == q_head) return 0; /* 空队列直接返回，不等待 */ const uint16_t *src = q_buf[q_tail]; q_tail = (q_tail + 1) % WAVE_QUEUE_LEN; uint16_t n = (max_len < WAVE_POINTS) ? max_len : WAVE_POINTS; for (uint16_t i = 0; i < n; i++) dst[i] = src[i]; /* 唯一的拷贝点 */ return n; }这套设计里最值得讲的是「队列存指针不存数据」。存指针的话，中断里的操作是常数时间，和采样点数无关，512 点也好 4096 点也好，ISR 耗时都一样；如果存数据，512 点拷贝在中断里要一两百微秒，1 kHz 采样下直接就超时了。
丢帧策略也要讲清楚为什么丢最旧而不是丢最新。波形显示看的是「现在」，如果队列满了还往里塞最新数据、把最新数据丢掉，屏幕上显示的永远是几百毫秒前的旧波形，操作者会以为信号滞后。丢最旧、保最新，代价是时间轴上有个看不见的断口，但只要丢帧计数不涨，这个断口就不存在。
3.4 触发与同步：让波形在屏幕上站住
自由奔跑的波形会左右乱窜，因为每一帧的起始相位都不一样。要让它站住，得做触发同步：找到一个满足条件的点作为帧的起点，通常选上升沿穿越中值电压的那一点，然后从这一点开始对齐显示。
实现上不需要真的移动数据，只要在取帧之后做一次搜索。搜索范围限制在一帧的前 1/4 内，找到穿越点就把整个数组循环左移，让穿越点落到第 0 个位置。找不到就保持原样，不做插值，宁可显示得「野」一点，也不要引入看不出来的假信号。
/* 中值触发：在帧内找上升沿穿越点，把该点对齐到数组起始 */ static void trigger_align(uint16_t *frame, uint16_t len, uint16_t mid) { uint16_t limit = len / 4; /* 只在 1/4 帧内找，避免大幅搬移 */ for (uint16_t i = 1; i < limit; i++) { if (frame[i - 1] < mid && frame[i] >= mid) { /* 原地循环左移 i 个点，i 小于 128 时耗时不到 50 μs */ for (uint16_t k = 0; k < i; k++) { uint16_t t = frame[0]; for (uint16_t j = 1; j < len; j++) frame[j - 1] = frame[j]; frame[len - 1] = t; } return; } } /* 找不到穿越点就保持原样（例如直流信号），不做任何处理 */ }触发还有个必须注意的点：触发值要跟信号幅度自适应。固定用满量程中值，遇到小信号（比如只有 0.3 V 摆幅）永远找不到穿越点，波形就一直是自由奔跑的状态。做法是每帧先求一次最大最小值，取两者中值作为触发阈值，一帧多花几百微秒，换来的是小信号也能稳住。
4. 屏幕渲染实现：从坐标映射到局部刷新的四个关键算法
4.1 坐标映射与定点化：避免浮点拖慢刷新
ADC 出来的是 0～4095 的码值，屏幕要的是像素坐标，中间要做一次线性映射。这段代码在每一帧、每一个点上都要执行，写成浮点乘除会让整帧时间翻好几倍——Cortex-M3 没有硬件 FPU，一次 float 除法走软件库要几百个周期，512 个点就是十几万周期，几十毫秒就没了，刷新率直接掉到个位数。
正确写法是全程整数，先乘后除，并且把除数量化成移位。下面这个函数在 512 点一帧的规模下总共不到 20 μs：
/* 把 0..4095 的 ADC 码值映射到屏幕 y 像素，全程整数运算 */ static inline uint16_t adc_to_y(uint16_t code, uint16_t y_top, uint16_t y_bot, uint16_t full_code) { /* y = y_bot - code * (y_bot - y_top) / full_code 先乘后除，中间结果最大 4095 * 240 ≈ 98 万，uint32 装得下 */ uint32_t span = (uint32_t)(y_bot - y_top); uint32_t y = (uint32_t)y_bot - ((uint32_t)code * span) / full_code; return (uint16_t)y; }参数里y_top和y_bot是波形绘制区的上下边界，通常要避开顶部状态栏和底部刻度区，不是整屏的 0 和 319。full_code是 ADC 满量程，12 位就是 4095，如果做了过采样就是更大的数。这三个参数从配置文件读，不要在函数里写死，换屏幕或者改显示区域时只改一处。
还有一个容易忽略的细节：code超过full_code时会算出负数，转成uint16_t就变成 65535，屏幕上会出现一根从底部窜到顶部的竖线。所以调用前要么保证 ADC 不会超量程，要么在函数里加一个 clamp，两行代码就能避免这种排查半天的黑匣子问题。
4.2 画点、画线、画竖线：三种笔刷的取舍
画波形最笨的办法是逐点画，每个点设一次坐标窗口再写一个像素。设窗口要发 CASET、RASET 两条命令加若干参数字节，在 SPI 屏上这部分开销比写像素本身还大，逐点画 512 个点要 20 ms 以上，根本别想实时。
波形图的特殊性在于：它是按列组织的，每一列上波形只占一个或几个像素，相邻两列之间是横向连接。所以真正好用的笔刷只有一种：竖线。把「这一列从上一个 y 到新的 y」之间的像素一次刷完，一次设窗口能写上十几个甚至上百个像素，效率是逐点画的一个数量级以上。
/* 一列只设一次窗口，连续写像素，省掉每点一次设坐标 */ void lcd_draw_vline(uint16_t x, uint16_t y0, uint16_t y1, uint16_t color) { if (y0 > y1) { uint16_t t = y0; y0 = y1; y1 = t; } /* 保证 y0 <= y1 */ lcd_set_window(x, y0, x, y1); /* CASET / RASET 各发一次 */ lcd_cmd_mem_write(); /* RAMWR 只发一次 */ uint32_t bytes = (uint32_t)(y1 - y0 + 1) * 2; /* 16 位色，每像素 2 字节 */ lcd_write_color_repeat(color, bytes); /* DMA 或并口连续填充 */ }形成连续的折线，靠的是「上一列画到哪，这一列就从哪开始画」。维护一个y_prev[LCD_W]数组，记录每一列上一次的 y 值，新的一列就从y_prev[x]画到y_new，中间那段自然被填满，视觉上就是一条连续的曲线。这个技巧比 Bresenham 画线快得多，而且不会有断点。
画点只在两个地方用：标记触发点、标记光标位置。这两种都是零星几个点，用逐点写法完全没问题，别为了统一而把所有绘制都套进竖线接口，那样反而绕。
4.3 局部刷新与脏矩形：只重画变动的列
一帧和一帧之间，绝大多数列的 y 值只变化几个像素，甚至完全不变。如果每帧都把整屏重画一遍，23 ms 一帧的下限就卡死在那里，再怎么优化代码也没用。真正省时间的方向是「不画没变的部分」。
做法是给每一列一个脏标记，只有新值不等于旧值才置位。512 列用位图存，一共 64 字节，比每个列一个uint8_t省 8 倍 RAM，对 RAM 紧张的片子很有意义。
/* 脏列位图：320 列只需 40 字节，省下来的 RAM 留给采样缓冲 */ static uint8_t col_dirty[(LCD_W + 7) / 8]; static uint16_t y_prev[LCD_W]; /* 每列上次画到的 y */ static inline void mark_dirty(uint16_t x) { col_dirty[x >> 3] |= (uint8_t)(1u << (x & 7)); } void render_flush(const uint16_t *frame, uint16_t len) { for (uint16_t x = 0; x < len; x++) { if (!(col_dirty[x >> 3] & (1u << (x & 7)))) continue; /* 没变就跳过 */ uint16_t y = adc_to_y(frame[x], Y_TOP, Y_BOT, 4095); if (y == y_prev[x]) continue; /* 值相同也不画 */ /* 先擦新旧两点之间的旧痕迹，再补新点，避免留下残影 */ lcd_draw_vline(x, y_prev[x], y, COLOR_BG); lcd_draw_point(x, y, COLOR_TRACE); y_prev[x] = y; col_dirty[x >> 3] &= (uint8_t)~(1u << (x & 7)); } }擦除区间取的是新旧两点之间的部分，不是整列。这一步很容易写错：整列擦除会把网格线和刻度一起抹掉，每次都重画网格，等于没优化。只擦两点之间的区间，网格就不会被碰到，前提是网格画在波形之下、且颜色不同——这就引出下一节的叠加顺序。
实测下来，500 列里真正变化的通常只有 100 到 200 列，单帧时间从 23 ms 降到 5 ms 左右，再配合 SPI 的 DMA 传输，能稳定在每秒 200 帧的视觉刷新，完全追得上 1 kHz 采样。
4.4 网格、光标与测量标注的叠加顺序
屏幕上不止有波形，还有网格、坐标刻度、触发光标、峰值标注、频率读数。这些东西的刷新频率完全不同：波形每帧都变，网格初始化画一次就不用管了，读数可能一秒才更新一次。如果混在一起每帧全画，等于把最贵的资源花在最不需要刷新的事情上。
叠加顺序要自下而上定死：背景色 → 网格和刻度 → 触发光标 → 波形 → 文字标注。之所以波形在网格之上，是因为擦波形时只擦两点之间的区间，网格被覆盖的像素本来就该被覆盖；之所以文字在最上层，是因为它可能落在波形区域内，压在下面会被波形擦掉。
刷新策略也按层分级：网格只在初始化、改量程、改时基时重画，用一个dirty_layout标志控制；读数用固定宽度的字符，每次只重画变化的那几位，别整行清空再重写，那样在屏幕上会有明显的闪烁；波形按脏列刷。三层各管各的，互不干扰，这是整个渲染部分最省心的地方。
5. 避坑与排查：波形撕裂、刷屏慢、采样丢点的五个现场
5.1 波形中间出现横向裂口
现象：稳定的正弦波上偶尔出现一段平直的横线，像被撕开一样，出现位置随机。
原因：渲染到一半时缓冲区被 DMA 覆盖。取帧函数只是存了指针，如果渲染过程中 DMA 正好把那一块写满并触发下一轮，正在读的数据就变了，画出来的点一半新一半旧。
解决：在wave_take_frame里完成真正的拷贝，让渲染层拿到的是私有副本；拷贝前短暂关中断，拷贝完立刻开。拷贝 512 点大约 200 μs，1 kHz 采样周期是 1000 μs，关中断 200 μs 不会丢数据，但要算一下总线上限，别把拷贝写成逐字节循环还带函数调用。
5.2 刷新率上不去，屏幕有拖影和闪烁
现象：波形能动，但明显滞后，转动电位器时波形要过零点几秒才跟上，屏幕边缘有渲染不全的横带。
原因：整屏重画，或者局部刷新写成了「先整列擦除再画」。整屏 23 ms 一帧的上限已经在 2.3 节算过，再怎么优化寄存器访问也突破不了。还有一种可能是 SPI 时钟配错了，实际跑在 10 MHz 而不是 40 MHz。
解决：先量一次单帧耗时，用 GPIO 翻转加示波器看，或者读定时器计数，别靠肉眼看。确认是整屏重画就上脏列位图；确认是 SPI 慢就检查分频系数和引脚配置，SPI 时钟不能在运行时随便改，改完要重新初始化外设。
5.3 采样点数对不上，波形横向压缩或拉伸
现象：输入 1 kHz 方波，屏幕上显示 10 个周期，按采样率 1 kHz、一屏 512 点算应该只有 0.5 个周期。
原因：定时器 ARR 算错了，实际采样率远高于设定值。最常见的是把定时器时钟当成了系统主频，实际总线到定时器还有分频；另一种是预分频和 ARR 都设了，但只改了一个。
解决：不要靠算，直接测。让一个 GPIO 在 DMA 半满中断里翻转，用示波器量方波频率，就是真实的帧率，乘点数就是采样率。这个测法比看代码可靠得多，我一般调试采样链路第一步就做这个，血泪经验。
5.4 屏幕花屏、雪花点，或者只亮一半
现象：上电后屏幕出现彩色噪点，或者上半屏正常下半屏全白。
原因：初始化命令序列不完整、SPI 速率过高导致时序余量不足、或者复位时序不够长。还有一种是写显存时没有等待前一次 DMA 传输完成，两次写命令叠在一起。
解决：先把 SPI 降速到 10 MHz 以下验证功能，功能对了再逐级提速，找到这块屏稳定工作的上限；每个写操作前检查 DMA 忙标志，忙就等，别硬塞；初始化后加 120 ms 延时再点屏。
5.5 跑一会儿就死机或复位
现象：连续运行几分钟后程序卡死，或者直接复位重启，接调试器看是硬件错误。
原因：栈溢出。512 点的一帧数组放栈上占 1 KB，加上局部变量、库函数调用，默认栈只有 1 KB 的话立刻就冲了。或者中断里做了耗时操作，抢占嵌套把栈吃穿。
解决：把大数组改成静态分配，主循环里的frame直接挪到文件作用域；在启动文件里把栈调到 4 KB 以上；中断服务函数里只留标志位和指针操作，任何带循环、带浮点的代码都挪出去。
6. 验收与答辩：三张表加一段演示把方案讲透
验收不是「能显示波形就算完」，要拿可量化的指标说话。我一般准备三张表，答辩时直接投出来，比讲十分钟原理管用。
第一张是功能验收表，逐项对需求打勾：
| 验收项 | 通过标准 | 验证方法 |
|---|---|---|
| 单通道波形显示 | 1 kHz 方波边缘清晰、无断点 | 信号源输入，目视加截图 |
| 双通道交替显示 | 两路相位关系正确，无串道 | 双路输入不同频率信号对比 |
| 触发同步 | 波形横向抖动小于 1 个像素 | 稳定信号下观察 10 秒 |
| 量程切换 | 切换后波形不越界、不贴边 | 逐档切换，检查上下边界 |
| 时基切换 | 横向点数与设定一致 | 数周期个数反算采样率 |
| 丢帧统计 | 连续运行 10 分钟，丢帧计数为 0 | 读调试口计数器 |
第二张是性能指标表，这几个数是整套方案的「体检报告」：单帧渲染时间、实际刷新帧率、采样率误差、RAM 占用、CPU 占用。测量方法要写进报告，比如单帧时间用 GPIO 翻转加逻辑分析仪测，采样率用 DMA 中断翻转频率反推，RAM 占用看 map 文件里.bss段的增量。答辩被问「你怎么知道是 200 帧」，能掏出测量方法就赢了一半。
第三张是演示脚本表，把 3 分钟的现场演示拆成分步动作和预期现象，避免临场手忙脚乱：
| 步骤 | 操作 | 预期现象 | 讲解要点 |
|---|---|---|---|
| 1 | 上电，不接信号 | 屏幕显示网格与零线 | 说明初始化顺序，采样最后启动 |
| 2 | 输入 1 kHz 方波 | 波形稳定，边沿陡峭 | 讲触发同步与竖线笔刷 |
| 3 | 调节频率到 5 kHz | 波形连续压缩，不丢点 | 讲双缓冲与丢帧策略 |
| 4 | 断开信号 | 波形塌成一条直线 | 讲自动量程与触发搜索失败处理 |
| 5 | 连续运行并读计数器 | 丢帧计数保持 0 | 讲性能余量 |
答辩最容易被追问的三个问题，提前准备好答案：为什么不用图形库（RAM 和 Flash 都紧张，图形库的帧缓冲机制反而不适合局部刷新）；为什么不用 RTOS（这套逻辑是纯粹的生产者消费者模型，一个主循环加中断就够，上 RTOS 反而增加调度抖动）；采样率的上限在哪（受 ADC 转换时间、DMA 带宽、渲染帧率三者中最小的那个限制，给出实测数字）。
从那以后我每次做带屏幕的嵌入式项目，都会在上电第一件事就把「单帧耗时」和「采样率」这两个数测出来写进注释，不测完不动渲染代码——因为这两个数一旦错了，后面所有的优化都是在错误的地基上盖楼，返工成本比测一次大得多。希望这套结构能帮到你。
本文还有配套的精品资源，点击获取
