STM32C8T6+OLED波形显示：ADC采样与DMA绘图实战

简介：一款基于STM32C8T6的OLED波形显示工程包，别名“mini版示波器”，面向嵌入式初学者与电子爱好者，解决如何利用低成本MCU驱动OLED并实时绘制波形的问题。项目同时支持0.96寸与1.3寸屏幕，覆盖ADC采样、信号滤波/峰值检测、图形渲染完整链路，适合学习STM32外设驱动及裸机波形显示开发。压缩包共193个文件，大小4.66MB，以34个C源码、36个头文件、35个编译中间文件（o/d/crf）及Keil工程文件（uvprojx/uvoptx）为主，另含hex、axf、map等烧录与调试文件，可直接编译下载验证，也便于对照工程结构梳理代码。已有1965人学习。通过该项目，读者能掌握STM32C8T6内置ADC采集、DMA/中断读取，以及SPI/I2C驱动OLED的实用技巧；同时可理解从模拟信号到屏幕波形的完整处理流程，为自制便携示波器或信号测量工具打下基础。

1. STM32C8T6+OLED波形显示是什么：一个能画波形的mini版示波器Demo

很多人看到“STM32C8T6+OLED波形显示”这个名字，脑子里第一反应是想做一个mini版示波器，手里拿着就能测信号。拆开之后你会发现，它本质是一个 ADC 采样 + OLED 绘图的演示工程：C8T6 自带的 12bit ADC 把模拟电压转成数字量，DMA 搬运到内存，再通过 I2C 接口把波形画到 0.96寸 OLED 上。它能解决的，是把“连续采集”和“实时刷新”这个嵌入式混合信号处理的链路完整跑通，适合刚点亮 OLED、想从点灯进阶到信号处理的入门者，也适合想快速抄一套可扩展采集框架的熟手。

它的边界也要先说清楚：输入范围 0～3.3V，带宽只能到几十到几百 kHz 这个量级，且没有硬件触发。拿它当正经仪器用会翻车，把它当“看得见波形的学习套件”就非常值。下面我从拆包、接线、代码、调参、避坑这几个角度，把这份资源从头到尾过一遍。

2. 拆开 RAR 包：文件结构、引脚连接与 C8T6 选型理由

2.1 资源包里常见的内容与使用顺序

这类波形显示工程压缩包，我拆过几次，结构大同小异。一般会有四块东西：

• MDK 工程文件（.uvprojx），以及 User、HARDWARE 目录下的 C 源码；
• OLED 驱动文件，通常基于 SSD1306，I2C 或 SPI 版本不一定相同，要确认；
• 原理图 PDF，有些是完整开发板原理图，有些只是最小系统图；
• 芯片手册或者接线说明文档。

拿到包之后，第一步不是开代码，而是先看接线说明和原理图，确认 OLED 是 I2C 还是 SPI、ADC 采样引脚是 PA0 还是 PA1。很多资源包里的工程和实际接线不一致，直接编译下载后黑屏，就是这里埋下的雷。

常见的使用顺序是：先对照原理图画接线 → 看 OLED 驱动头文件里的地址宏 → 再找 ADC 初始化函数确认通道 → 最后才是编译烧录。这个顺序能省下后面至少一小时排查时间。

2.2 引脚接线：OLED 与模拟输入的分配

以最常见的 0.96 寸 I2C OLED 为例，模块只有四个针脚：VCC、GND、SCL、SDA。OLED 的 I2C 接口速度 400kHz 就够用，选择 C8T6 的 I2C1 或软件模拟 I2C 都可以。如果资源包用的是硬件 I2C，那 SCL 和 SDA 必须接到对应的复用引脚上，比如 PB6、PB7；如果用的是 IO 模拟时序，那原则上任意两个普通 GPIO 都可以，但要注意代码里到底是按哪两个引脚写的。

ADC 输入引脚的选择也有讲究。C8T6 有 10 个外部 ADC 通道，PA0～PA7、PB0、PB1，但很多 demo 默认用的是 PA0，也就是 ADC1 的通道 0。这里给出我常用的接线参考表：

有些模块带有 RST 和 DC 引脚，SSD1306 的 I2C 模式通常不强制接复位脚，上电时序由内部电路保证，但如果你遇到屏幕花屏，重启模块比重启单片机更有效。可以额外把 RST 接到一个 GPIO 上，程序初始化时拉低再拉高一次，这个“后悔药”我在后面避坑部分会细说。

2.3 为什么是 C8T6 而不是 C6T6：资源边界

STM32F103C8T6 和 C6T6 都是 LQFP48 封装，外观几乎一样，但区别在水下。C8T6 是 64KB Flash、20KB SRAM，C6T6 只有 32KB Flash、10KB SRAM。波形显示工程看起来代码量不大，但一旦你加入浮点计算、显示缓冲区、双缓冲 DMA、串口调试输出和菜单逻辑，32KB Flash 会非常拮据。而且两个型号的 SRAM 差距直接决定了能不能开一个 512 点的 uint16_t 采样数组，这是很多调速方案的基础。

所以我一直建议，哪怕你手头只有 C6T6，也要在为目标工程写程序时把代码镜像到 C8T6 上验证。资源包按 C8T6 来设计不是没道理：64KB Flash 能装下 HAL 库、OLED 驱动和后续扩展的触发算法，20KB SRAM 也能容纳 512 个采样点的双缓冲，同时给显示刷新留出余量。

3. 采样链路设计：ADC 时钟、DMA 搬运与 128×64 显示映射

3.1 为什么不能只用延时查询：ADC 连续采样与 DMA

很多人拿到工程，第一反应是“ADC 采样 = 循环里调 HAL_ADC_GetValue”。这在测静态电压没问题，但做波形显示就行不通。波形显示需要在一个时间段内等间隔采集一系列点，如果每次采样之间用 delay 控制，CPU 会完全被占用。

正确姿势是 ADC 工作在连续扫描模式下，配合 DMA 把转换结果自动搬运到内存。C8T6 的 ADC 转换完成后会产生 DMA 请求，DMA 把结果写入内存数组，主循环只需要检查 DMA 传输完成标志，再去 OLED 上绘图。这样 ADC 采样和显示刷新在时间上是错开的。

我一般会把 DMA 模式设置为循环模式（Circular Mode），让 ADC 一直转，DMA 一直接，传输一定数量后自动回卷继续传输。这么做的好处是采样动作完全不需要代码干预，CPU 只在需要时读一组已完成的数据。

如果资源包里的工程没有 DMA，而是用中断一次一次读，那刷新率会非常难看。在做高速波形时，中断间隔会越来越不稳定，波形自然就飘。遇到这种工程，优先改成 DMA 方式。

3.2 ADC 时钟与采样时间参数

C8T6 的 ADC 时钟最高不能超过 14MHz。系统主频 72MHz 时，APB2 总线时钟也是 72MHz，要经过 ADC 预分频器分频，常见配置是 6 分频得到 12MHz。采样时间决定 ADC 对一个信号的充电时间，可选 1.5、7.5、13.5、28.5、41.5、55.5、71.5、239.5 个 ADC 时钟周期。

对普通示波器 Demo 来说，信号源大多是信号发生器或 PWM 方波，阻抗不算太高，我用得最多的是 28.5 周期或 71.5 周期，既能保证采样稳定，又不会把转换速度拖得太慢。如果采样时间选 239.5 周期，单次转换时间会拉长，最高有效采样率直接下降很多，显示出的波形边沿会变钝。

这里可以参考一组经验参数：

注意一个最常见的配置错误：ADC 和 DMA 的时钟要同时使能，如果只开了 ADC 外设时钟而没开 DMA1 时钟，程序会一直卡在 HAL_ADC_Start_DMA 里。这个细节非常阴间，因为编译器不会报错，现象只是程序停在启动函数里不上不下。

3.3 OLED 坐标映射与刷新方式

0.96 寸 SSD1306 的分辨率是 128×64 像素，一屏只有 128 列。这意味着理想情况下每列对应一个采样点，一次刷新最多画 128 个点。如果一次 DMA 传输 512 点，需要做数据抽稀，或者让波形横向滚动。

垂直方向映射很简单：ADC 12bit 结果 0～4095，除以 64 就得到 0～63。OLED 左上角是原点，但电压高时波形应该在屏幕上方，所以显示坐标要用 63 减去这个值，否则波形是上下颠倒的。

刷新方式有两个流派。一种是“整屏刷新”：等 DMA 收集满 128 个点，一次性把这 128 个点画到 OLED 上。另一种是“滚动刷新”：每次在屏幕右侧画一个新点，然后把整屏左移一列。滚动刷新看起来更像示波器，但 SSD1306 的 SSD 没有硬件位图平移功能，需要把每个页面的像素数据左移一位，刷新时间会翻好几倍，帧率很容易掉到个位数。

我推荐资源落地时先用整屏刷新，把链路跑通，再决定要不要做滚动效果。整屏刷新下，I2C 速率提到 400kHz，刷一屏大约需要 20 多毫秒，也就是 40 帧左右的对屏幕刷新率尚可接受，但加上 ADC 采样和数据处理，实际帧率在 20～30 帧之间，这个数值对观察低频信号足够了。

4. 代码作业：HAL 库下 ADC + DMA + OLED 绘制主循环怎么改

4.1 ADC + DMA 初始化代码与缓冲分配

大部分下载资源的代码基于 HAL 库，下面这段是核心。

ADC_HandleTypeDef hadc1; DMA_HandleTypeDef hdma_adc1; #define ADC_BUF_LEN 512 uint16_t adc_buf[ADC_BUF_LEN]; uint8_t wave_ready = 0; static void MX_ADC1_DMA_Init(void) { __HAL_RCC_ADC1_CLK_ENABLE(); __HAL_RCC_DMA1_CLK_ENABLE(); hadc1.Instance = ADC1; hadc1.Init.ScanConvMode = ADC_SCAN_DISABLE; hadc1.Init.ContinuousConvMode = ENABLE; hadc1.Init.DiscontinuousConvMode = DISABLE; hadc1.Init.ExternalTrigConv = ADC_SOFTWARE_START; hadc1.Init.DataAlign = ADC_DATAALIGN_RIGHT; hadc1.Init.NbrOfConversion = 1; HAL_ADC_Init(&hadc1); ADC_ChannelConfTypeDef sConfig = {0}; sConfig.Channel = ADC_CHANNEL_0; sConfig.Rank = ADC_REGULAR_RANK_1; sConfig.SamplingTime = ADC_SAMPLETIME_71CYCLES_5; HAL_ADC_ConfigChannel(&hadc1, &sConfig); hdma_adc1.Instance = DMA1_Channel1; hdma_adc1.Init.Direction = DMA_PERIPH_TO_MEMORY; hdma_adc1.Init.PeriphInc = DMA_PINC_DISABLE; hdma_adc1.Init.MemInc = DMA_MINC_ENABLE; hdma_adc1.Init.PeriphDataAlignment = DMA_PDATAALIGN_HALFWORD; hdma_adc1.Init.MemDataAlignment = DMA_MDATAALIGN_HALFWORD; hdma_adc1.Init.Mode = DMA_CIRCULAR; hdma_adc1.Init.Priority = DMA_PRIORITY_HIGH; HAL_DMA_Init(&hdma_adc1); __HAL_LINKDMA(&hadc1, DMA_Handle, hdma_adc1); HAL_ADC_Start_DMA(&hadc1, (uint32_t *)adc_buf, ADC_BUF_LEN); }

这段代码做了四件事。第一，把 ADC1 配置为单通道、连续转换、软件触发，数据右对齐。第二，选择通道 0，也就是 PA0，采样时间为 71.5 个时钟周期。第三，把 DMA1 通道 1 配置为外设到内存、循环模式、半字宽度，这样 ADC 转换结果会不断自动写入 adc_buf。第四，启动 DMA 传输。

如果你要换通道，把ADC_CHANNEL_0改成对应引脚上的通道号即可，比如 PA1 对应ADC_CHANNEL_1。同时必须确保 GPIO 引脚模式是模拟输入，不是复用推挽，也不是浮空输入。很多初学者把 PA0 配成 GPIO 复用功能，结果 ADC 始终读到 0。

4.2 DMA 完成回调与波形绘制函数

DMA 传输完成回调是通知主循环的“闹钟”。在 HAL 库中，回调函数长这样：

void HAL_ADC_ConvCpltCallback(ADC_HandleTypeDef* hadc) { if (hadc->Instance == ADC1) { wave_ready = 1; } }

回调里只做置标志位这一件事，不要在中断里直接调 OLED 绘图函数。SSD1306 的 I2C 发送过程很长，如果在中断里发一屏数据，整个系统都会被拖死，看起来像死机。这个坑我踩过，后面避坑章节会专门讲。

波形绘制函数是资源包的核心模块。我一般按照整屏刷新来写：

#include "ssd1306.h" void OLED_DrawWave(uint16_t *buf, uint16_t len) { uint8_t x, y; OLED_ClearBuffer(); OLED_DrawLine(0, 63, 127, 63); // 底部基线 for (x = 0; x < len; x++) { y = 63 - (buf[x] >> 6); // 12bit 数据右移 6 位映射到 0~63 OLED_DrawPixel(x, y, 1); } OLED_UpdateScreen(); }

buf[x] >> 6就是把 0～4095 压到 0～63。如果输入信号小于 0V 或大于 3.3V，ADC 会饱和在 0 或 4095，波形在屏幕上下边缘被截平，这表示超出测量范围了。OLED_UpdateScreen()是一次整屏刷新，它会将缓冲区的数据通过 I2C 发送给 SSD1306。

有一点值得留意：OLED_ClearBuffer()只是把内存缓冲清掉，并没有真正清屏幕，真正清屏是OLED_UpdateScreen()里发送全 0 数据。整屏刷新策略下，清缓冲和绘点都在内存里操作，最后一次性发送，这个效率远高于“清屏再画点再刷新”的三步走。如果资源包里是三步走的写法，建议改成这种方式。

4.3 主循环框架：先亮 OLED 再查 ADC

主循环的结构非常简单，但顺序有讲究。初始化时先做 OLED 初始化、显示 LOGO 或提示文字，再启动 ADC DMA 传输。不要反过来，因为 OLED 初始化的 I2C 时序如果和 ADC 采样抢总线，可能造成初始采样阶段数据异常。

int main(void) { HAL_Init(); SystemClock_Config(); MX_GPIO_Init(); MX_DMA_Init(); MX_I2C1_Init(); OLED_Init(); OLED_ClearBuffer(); OLED_UpdateScreen(); MX_ADC1_DMA_Init(); HAL_ADC_Start_DMA(&hadc1, (uint32_t *)adc_buf, ADC_BUF_LEN); while (1) { if (wave_ready) { wave_ready = 0; OLED_DrawWave(adc_buf + 384, 128); } } }

每次从adc_buf + 384开始取 128 个点，是因为 DMA 是循环模式，缓冲区 512 点一圈，最后 128 个点总是包含最新采样数据。如果你画全屏 128 个点，而adc_buf是 512 点，直接用指针偏移就能取出最新的一段，不存在跨缓冲区边界的问题。

如果你调试时发现波形只有半屏有意义，那大概率是偏移算错了。更稳妥的方案是 DMA 单次就传 128 点，但那样两个转换周期之间会有空隙，连续性稍差。所以不少工程干脆把 DMA 缓冲设为 256，取后 128 点，效果均衡。

4.4 参数怎么调节：采样点数、触发与帧率

这里给一张调参速查表，我实际调工程时会围绕它做实验：

调整ADC_BUF_LEN时要注意 SRAM 占用。C8T6 只有 20KB SRAM，如果开两个 512 点 uint16_t 数组，只用掉 4KB，问题不大。但如果又开大字体缓存又开三缓冲，SRAM 就吃紧了。

帧率瓶颈通常不在 CPU 主频，而在 I2C 刷新。128×64 的 SSD1306 页面模式是 8 页，每页 128 字节，一屏数据量 1024 字节。标准 I2C 传输每字节后面还要跟一个 ACK 位，400kHz 下刷完整屏大约需要 20ms 以上，再加上命令开销，整屏刷新帧率很难超过 40Hz。所以看到 20Hz 左右的表现其实是这个方案的常态，不要指望它能像电脑示波器一样丝滑。

5. 排查手册：OLED 黑屏、波形乱跳、AD 噪声五个高频坑

5.1 现象一：OLED 只有背光没有画面

OLED 不是背光屏，所以严格说没有“背光亮”这种状态，更像屏幕全亮或完全不亮。多数情况是屏幕没初始化成功，但不是芯片坏了，而是 I2C 地址错了。

SSD1306 的 I2C 地址由 SA0 引脚决定。大部分 0.96 寸模块 SA0 被拉低，地址是 0x3C；少数模块拉高，地址变成 0x3D。代码里写的是 0x3C，遇到 0x3D 的模块就会黑屏。解决方法是先用 I2C 扫描工具读设备地址，或者把驱动宏改成另一个地址重新编译。我一开始手头有块屏幕死活不亮，换了地址后立刻正常。这个坑不属于玄学，纯属硬件差异。

还有一种情况是模块需要复位时序。一些模块的 RST 引脚悬空，上电瞬间内部复位不彻底，表现为花屏或持续黑屏。可以将 RST 接到一个 GPIO，初始化时拉低 10ms 再拉高，这能解决八成上电不稳定问题。

5.2 现象二：波形横向乱跳，像心电图一样抖动

现象是同样的正弦波，每次刷新后横轴位置都不一样，波形左右来回跑，无法稳定观察。

原因是采样起始点没有触发机制。DMA 是连续循环采集，每次取到的 128 个点是任意时间窗口，窗口起点和信号周期没关系，自然每次显示相位都不同。真实示波器都有触发电路，用比较器锁定信号的某个上升沿再开始采集。

解决分两步。软件层面可以做一个简单触发：在缓冲区里找第一次跨越设定电平的索引，以这个索引作为窗口起点。这个方法不需要额外硬件，对干净方波信号效果不错，但遇到噪声大的信号会误触发。硬件层面是加一个比较器，把输入信号和可调参考电压比较后送给 MCU 的 EXTI 外部中断，在中断里重新启动 DMA。资源包一般不含硬件触发，属于进阶改动，我会在最后一章给方案。

5.3 现象三：高频正弦波上屏变成低频锯齿

拿 10kHz 正弦波测试，屏幕上出现的却不是规则的 10kHz 正弦，而是像低频慢扫的波形，甚至变成三角形，一节一节跳变。

原因是采样率不足或发生混叠。ADC 采样时间太长，实际采样率远小于信号频率，波形就会失真。另一个常见原因是 OLED 刷新帧率低，导致视觉上看到的“点”是一个滑动的窗口，而不是信号的真实形状。

解决先确认 ADC 时钟和采样时间：ADC 时钟 12MHz、采样时间 71.5 周期，单通道连续转换理论采样率大约在 160kSa/s 左右，能稳定观察 10kHz 以内的信号。超过这个范围后，建议把采样时间降到 7.5 周期，或者改用更高速的 CPU 和 SPI DMA 方案。要更彻底，就需要在输入信号进 ADC 之前加 RC 低通滤波器做抗混叠滤波，把高于采样率一半的频率滤掉。

5.4 现象四：上电后 OLED 白屏或程序卡死，复位才恢复

白屏的原因是 OLED 驱动在发送数据时被中断打断，I2C 时序坏掉。常见场景是 DMA 传输完成中断里直接调用了OLED_UpdateScreen()，这个函数会长时间占用 I2C 总线，而中断可能再次触发，导致发送队列错乱。

解决方式是严格保证中断回调里只置标志位，绘图放到主循环中处理。另一个变体问题出现在 DMA 传输未完成时主循环又启动了下一次 DMA 传输，HAL 库会返回HAL_BUSY，然后程序就停在那里。解决方法是在启动下一个 DMA 周期前等待传输完成，或者使用双缓冲机制，在一个缓冲写数据时另一个缓冲正在被 DMA 使用。

还有一个细节容易被忽略：DMA1 通道 1 在 ADC1 上用了，就不要在 OLED 的 GPIO 初始化里再次把这组 DMA 通道分配给外设。有些工程用 DMA 做串口发送或者 SPI 屏，多个外设抢同一个 DMA 通道，启动后一个正常一个黑屏，改 DMA 通道就能解决。

5.5 现象五：ADC 数值在几十码内漂移，读数不稳

同一个电压源，显示波形不是一条直线，而是一条噪声带，上下跳动的幅度可能有十几到几十个 ADC 码。

原因有几类。电源纹波最直接，C8T6 的内部 ADC 参考电压是 VDDA，而 LQFP48 封装没有单独的 VREF+ 引脚，参考电压直接取决于 3.3V 电源质量，如果开发板从 USB 取电且没有加磁珠和电容，纹波会被 ADC 完整采进去。第二类是输入引脚浮空或接触不良，PA0 没接信号线时它就是一个天线，你把手指靠近波形就会明显跳动。第三类是采样时间过短，转换电容没有充满。

解决时先给 3.3V 并联一颗 100nF 和一颗 10uF 滤波电容。然后用短粗杜邦线把信号源和 PA0 连起来，不要在高阻抗状态下悬空观察。最后把采样时间提到 239.5 周期试一下，如果噪声明显减小，那就是采样时间设置的问题。这三个动作能解决 90% 的“读数漂移”。

6. 让波形稳定可测：软件触发、前端保护与标定收尾

6.1 用 GPIO 方波做自检

没有信号发生器时，可以用 C8T6 自己的 GPIO 输出方波，把引脚直接飞线到 PA0，作为内部自检信号源。这是我在每个工程上都保留的习惯。

void GPIO_TestSignal_Init(void) { GPIO_InitTypeDef gpio = {0}; __HAL_RCC_GPIOA_CLK_ENABLE(); gpio.Pin = GPIO_PIN_8; gpio.Mode = GPIO_MODE_OUTPUT_PP; gpio.Speed = GPIO_SPEED_FREQ_LOW; HAL_GPIO_Init(GPIOA, &gpio); } void GPIO_TestSignal_Task(void) { HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_8); HAL_Delay(1); }

在主循环里定时翻转 PA8，就能得到 500Hz 左右的方波，接到 PA0 上观察。整个过程不需要外部信号源，用来验证 ADC、DMA、OLED 链路是否正常非常直接。调整HAL_Delay的时间可以改变方波频率，从而验证不同频率下波形显示是否正确。

6.2 无信号发生器的 Y 轴标定方法

没有标准源，就用一个精密电位器，把三个引脚分别接到 3.3V、GND 和 PA0，旋转电位器就能提供 0～3.3V 之间任意直流电压。然后让 OLED 同时显示 ADC 原始数值或换算电压，用万用表测量电位器中间抽头的实际电压，对比 OLED 上的数值，就能标定 Vref 的基准。如果偏差是整体偏小，优先检查 3.3V 电源电压；如果偏差不是线性的，很可能是采样时间不足或者 PCB 布局导致参考不稳。

标定的意义在于：这个资源包里的波形只能看相对形状，不能看绝对幅度。如果想让 Y 轴显示真实的电压刻度，必须根据实际 Vref 做一次比例换算。C8T6 的 12bit ADC 默认参考是 3.3V，但实际 VDDA 可能是 3.29V 或 3.31V，不做标定，波形幅度会有百分之几的偏差。

6.3 下一步：软件触发和输入前端保护

波形稳定后，就可以往真正的 mini 示波器方向改造。软件触发是最容易加的一步。在adc_buf缓冲区里找信号从低到高跨越某电平的索引，然后从这个索引开始取 128 点：

uint16_t find_trigger_edge(uint16_t *buf, uint16_t len, uint16_t level) { for (uint16_t i = 1; i < len; i++) { if (buf[i - 1] < level && buf[i] >= level) { return i; } } return 0; }

需要把 DMA 缓冲至少开到 256 或 512 点，因为触发点不一定出现在最新 128 点内，如果缓冲区太小，触发点找不到，波形还是不稳定。level可以做成按键可调，长按增加电平，让用户适应不同偏置的信号。

输入前端保护比触发更优先，因为直接测量高于 3.3V 的信号会永久损坏芯片。常见的改造是串一个 1kΩ 电阻，再在 PA0 到 GND 之间并两个反向串联的二极管钳位，让电压被限制在 -0.7V～4V 之间。更进一步可以用运放做电压跟随器，把输入阻抗抬高到兆欧级别，这样被测电路不易被拉偏。

从那以后，我每次拿到新的 ADC 类工程，都会先强制走一遍自检流程：GPIO 方波输入 PA0、整屏刷新 OLED、软件触发找边沿，三步正常后再去接真实信号。这个流程让很多看起来莫名其妙的“波形显示不正常”问题在五分钟内变成自己的锅还是工程的锅。希望帮到你。

本文还有配套的精品资源，点击获取