简介这是一套基于STM32微控制器实现的简易数字示波器完整开发资源面向计算机科学、人工智能、通信工程、自动化及电子信息等专业的在校学生、青年教师与嵌入式初学者解决课程设计、毕业设计、实验验证与信号采集分析等典型教学与工程入门需求。压缩包共含多个关键文件以C语言源代码.c/.h、Keil工程配置、原理图说明文档PDF/DOCX、详细设计报告及README使用指南为主整体大小为19.56MB结构清晰模块划分明确便于理解ADC采样、DMA传输、FFT频谱计算与LCD波形绘制等核心流程。已有251人下载学习项目经实际硬件调试验证所有功能运行稳定课程答辩平均分达94.5分配套文档涵盖软硬件设计思路、关键参数配置说明与常见问题提示可直接用于课设演示、毕设原型开发或在现有基础上拓展逻辑分析、串口上传等进阶功能。 用STM32做一台桌面示波器这事听起来有点“疯狂”但实际做下来你会发现它远比想象中靠谱。项目开工前我定的目标是不用FPGA、不用外挂ADC芯片、不加高速比较器就靠STM32片内ADC加DMA在LCD上稳定显示波形把原理图、源代码、设计文档全部开源整理好。现在板子已经跑了一年多测过方波、正弦波、PWM信号、串口TX波形也踩了不少坑。这篇博文就把整个项目的核心细节掰开揉碎讲清楚从方案选型到源码结构从硬件调到问题排查全部基于这套开源工程给想做STM32示波器或者正在做课设、毕设的朋友一个可以直接“抄作业”的完整参考。1. 项目整体设计与方案选型1.1 核心需求拆解示波器这个产品拆开看就三件事把模拟信号变成数字量、把数字量存下来、把存储的数据画到屏幕上。围绕这三件事基于STM32的示波器项目需求其实非常清晰第一采样通道要能覆盖常见信号。日常调试单片机项目时最常测的是3.3V/5V逻辑电平、PWM波形、串口数据、I2C/SPI时钟、电源纹波这些信号的特点是电压范围固定、频率低大部分在几百kHz以下。所以ADC的采样率要求并不极端1Msps左右已经能覆盖绝大多数入门级调试场景。第二触发逻辑必须要有。示波器没有触发波形在屏幕上就是一团乱跑的水平线。STM32方案里触发可以用软件实现通过检测采样数据中的上升沿或下降沿来对齐显示窗口效果虽然不如硬件触发精准但胜在实现简单、参数可调。第三显示交互要顺手。波形画出来要清晰网格、电压刻度、时间刻度、触发电平线这些基础元素不能少最好还能支持暂停/运行切换、电压档位切换、时基切换。这一块看似简单实际上非常影响使用体验很多开源方案死在交互上——波形画出来了但按钮失灵、菜单混乱根本没法用。第四也是容易被忽略的——文档和源代码结构要完整。既然是开源项目别人拿到源码后能不能看懂、能不能改直接决定了项目的价值。这套工程的文档分了三级设计文档讲总体架构、源码注释讲函数实现、README教环境搭建和烧录步骤。1.2 为什么选STM32而不是其他方案市面上做简易示波器的主流方案有几种纯FPGA、STM32外部高速ADC、STM32片内ADC、ESP32片内ADC、甚至树莓派Pico。我最终选了STM32F407VET6核心原因有三个一是片内ADC性能够用且配置灵活。STM32F407的ADC是12位、最多3个ADC模块每个模块有独立通道最高采样率在ADCCLK30MHz时可达2.4Msps。如果只用单通道、把采样周期压到最短1.5周期实际能跑到的采样率在1.7Msps左右配合DMA可以做到全速采样不占CPU。这已经能测100kHz左右的信号了。二是DMA和双缓冲机制非常成熟。ADC采样结果通过DMA搬运到内存不需要CPU干预CPU只负责在缓冲区“半满”和“全满”时把数据拷走或处理。这种架构天然适合示波器这种需要连续采样、实时显示的场景。三是生态熟、资料多、调试工具链完善。不管是STM32CubeMX生成初始化代码、Keil/MDK编译还是ST-Link在线调试整个开发流程我闭着眼睛都能走完出了问题也容易找答案。相比之下FPGA方案调试难度大得多ESP32虽然性能也不错但ADC线性度和稳定性确实差点意思。1.3 关键参数推算与指标预期做示波器必然涉及一个核心参数——等效带宽。对于一个数字示波器理论上能采到的最大信号频率受采样定理限制采样率至少要大于信号最高频率的两倍实际工程中为了保证波形重构质量一般取5到10倍。STM32F407以1.5周期采样、单通道连续模式跑实测能达到1.6Msps左右那么可靠显示的信号频率上限就是160kHz到320kHz——对单片机调试场景来说绰绰有余。存储深度方面片内SRAM有192KB我分配了32KB的采样缓冲也就是一次能存储16000个采样点。这对于显示一个屏幕的波形来说非常充裕还能支持较大的时基范围。垂直分辨率是12位ADC位深理论上能分辨4096级电压配合前端分压电路可以做到0到3.3V、0到20V、0到100V多个量程。实测下来在3.3V档位下电压读数误差在±20mV以内作为入门示波器完全合格。注意所有采样率、带宽指标都是工程实测值不是手册标称值。实际项目中我把ADC的采样周期配置为1.5周期这是F407能达到最高采样率的配置但要注意此时ADC输入阻抗的影响会更明显前级必须有运放跟随。2. 硬件电路设计要点2.1 前端信号调理分压、跟随、保护STM32的ADC输入范围是0到VREF一般接3.3V而实际测量中信号电压可能会超过这个范围。所以硬件第一级必须做信号调理方案是“电阻分压电压跟随器”。分压部分用了一个旋转开关切换三组分压电阻实现三档量程档位分压比输入范围适用场景X11:10-3.3V数字逻辑信号、电池电压X1010:10-33V模拟电源、常见直流电路X100100:10-330V高压电源、市电整流后分压电阻选精密电阻0.1%精度每档都用两个电阻串联再并联一个电容做高频补偿这是从模拟示波器输入级抄来的经典结构。分压后信号进入运放跟随器运放选的是轨到轨输入输出型号比如SGM8534这样在接近0V或3.3V时不会有严重饱和失真。保护电路也在这里分压点和地之间跨接两个反向并联的二极管把输入电压钳位在-0.7V到VCC0.7V之间。实测输入突然接到24V直流电时ADC没有被击穿保护非常可靠。提示这里一定要用低漏电流二极管比如BAT54S否则小信号测量时会看到明显的漏电流偏移。2.2 触发电平电路模拟比较器可选但我选了软件触发很多DIY示波器的触发直接在ADC采样数据里做软件检测我也采用了这个方案原因很简单——省掉一个比较器芯片电路更简单而且STM32的实时性足够处理。软件触发的思路是DMA缓冲区里存了连续采样的数据CPU在缓冲区填满后从头扫描找“上一刻电压低于阈值、下一刻电压高于阈值”的点这个位置就是上升沿触发点找到后以这个点为中心截取一屏数据送去显示。软件触发的好处是可随时调整触发电平不用改硬件缺点是触发点精度受采样周期限制而且只能对已存储的数据做回溯式检测无法做到硬件比较器那种“等待触发信号再开始采样”的准实时性。对入门级示波器来说这点误差完全可接受。当然如果后续想要更稳定的触发可以在板子上预留一个比较器芯片比如LM311的位置把比较器输出接到STM32的外部中断引脚用中断触发DMA重新采样。这条升级路径在后面“可扩展方向”里详细说。2.3 ADC参考电压与电源设计这个坑我一开始没注意到STM32的ADC参考电压VREF如果直接连3.3V电源那么3.3V上的纹波就会直接反映在测量结果上。实测下来电源纹波30mV左右ADC读数在未接信号时也会上下跳几个LSB每个LSB约0.8mV波形基线看起来毛刺很多。解决办法是在VREF脚上加独立RC滤波用磁珠串联一个10欧电阻再并联两个去耦电容10uF钽电容100nF陶瓷电容。这样处理之后ADC噪声从原来的数个LSB降到1个LSB以内波形干净了很多。电源部分用AMS1117-3.3给数字部分供电模拟部分再单独用一片低噪声LDO避免数字开关电流通过地线耦合到模拟电路。PCB设计上模拟地和数字地单点连接ADC的采样引脚走线尽量短且远离晶振和数字信号线。2.4 PCB布局走线经验这块板子我画了三个版本前两版都因为布局问题导致波形质量差。总结几个关键经验ADC输入引脚PA0-PA3周围不要走数字信号线尤其是SPI、I2C这类高频翻转的信号。运放供电引脚处必须放置100nF去耦电容并且电容要尽量靠近芯片引脚否则高频段会出现增益抖动。DMA缓冲区和ADC配置寄存器都在AHB总线上没有特殊要求但LCD数据线如果和ADC采样通道靠得很近刷新屏幕时的数字噪声会污染采到的模拟信号。我最终用一个屏蔽地线把LCD排线和模拟输入区域隔开问题得到解决。地平面完整性比走线长度更重要。第二版PCB为了美观切了好几处地平面第三版干脆整块敷铜不切断寄生的电感电容干扰反而消失了。3. 核心代码实现与源码结构3.1 源码目录组织拿到工程先看懂这里完整的源代码工程基于STM32CubeMX HAL库源码目录如下STM32_Oscilloscope/ ├── Core/ │ ├── Inc/ │ │ ├── main.h │ │ ├── adc.h │ │ ├── dma.h │ │ ├── lcd.h │ │ ├── trigger.h │ │ ├── ui.h │ │ └── usart.h │ └── Src/ │ ├── main.c │ ├── adc.c │ ├── dma.c │ ├── lcd.c │ ├── trigger.c │ ├── ui.c │ └── usart.c ├── Drivers/ │ ├── CMSIS/ │ └── STM32F4xx_HAL_Driver/ ├── Docs/ │ ├── 设计文档.md │ ├── 使用手册.md │ └── 调试记录.md ├── MDK-ARM/ └── README.md模块划分的原则是高内聚、低耦合。adc.c只负责ADC初始化、DMA配置和缓冲区的读写管理trigger.c只负责触发检测ui.c只管屏幕绘制和菜单交互main.c里只做初始化调用和主循环调度。这样拆的好处是如果你不想用我的UI可以直接换掉ui.c如果想扩展成双通道只需改adc.c和trigger.c其他模块不用动。3.2 ADCDMA采样核心配置逐行解释ADC配置的关键在于采样周期和DMA模式。以下是adc.c中初始化代码的核心片段void MX_ADC1_Init(void) { ADC_ChannelConfTypeDef sConfig {0}; hadc1.Instance ADC1; hadc1.Init.ClockPrescaler ADC_CLOCK_SYNC_PCLK_DIV4; // ADCCLK 84MHz/4 21MHz hadc1.Init.Resolution ADC_RESOLUTION_12B; // 12位分辨率 hadc1.Init.ScanConvMode DISABLE; // 单通道扫描模式关闭 hadc1.Init.ContinuousConvMode ENABLE; // 连续转换模式 hadc1.Init.DiscontinuousConvMode DISABLE; hadc1.Init.ExternalTrigConvEdge ADC_EXTERNALTRIGCONVEDGE_NONE; // 软件触发 hadc1.Init.DataAlign ADC_DATAALIGN_RIGHT; hadc1.Init.NbrOfConversion 1; HAL_ADC_Init(hadc1); sConfig.Channel ADC_CHANNEL_0; // PA0 sConfig.Rank 1; sConfig.SamplingTime ADC_SAMPLETIME_1CYCLE_5; // 1.5周期采样 HAL_ADC_ConfigChannel(hadc1, sConfig); }ClockPrescaler PCLK_DIV4对应ADCCLK21MHz。F407的ADC最高允许36MHz21MHz是留了余量保证转换精度。SamplingTime 1.5周期是最高采样率的关键12位转换本身需要12个周期总采样周期1.51213.5周期那么采样率21MHz/13.5≈1.56Msps。DMA配置是另一个关键点。我用了循环模式加双缓冲代码在main.c中static uint16_t adc_buf[2][ADC_BUF_SIZE]; // 双缓冲每块12800点 // 启动ADC的DMA传输 HAL_ADC_Start_DMA(hadc1, (uint32_t *)adc_buf, ADC_BUF_SIZE * 2);DMA配置为循环模式后当缓冲区前半部分写满时触发HalfTransfer中断后半部分写满时触发TransferComplete中断在两个中断回调里分别设置标志位主循环读标志位后处理对应缓冲区数据。这样就实现了“DMA一直在采样CPU在处理上一块数据”的流水线操作采样不丢点UI也不会卡顿。3.3 触发检测逻辑让波形稳定停住触发检测写在了trigger.c里。核心思路是先在缓冲区中找到满足“上一个点低于阈值当前点高于阈值”的位置然后以这个点为参考把完整的一屏数据截取出来。代码uint16_t FindTriggerEdge(uint16_t *buf, uint16_t len, uint16_t threshold) { for (uint16_t i 1; i len; i) { if (buf[i - 1] threshold buf[i] threshold) { return i; // 返回上升沿触发点的缓冲区下标 } } return 0xFFFF; // 未找到边沿返回无效值 }触发模式的实现在trigger.c里还有三种模式上升沿触发、下降沿触发、自动触发。自动触发指的是在设定时间内找不到边沿时直接把当前缓冲区数据显示出来不做截取对齐。这样即使信号频率太低、边沿太少屏幕也不会空白。实际调试中发现单纯做边沿检测还不够容易在噪声处误触发。我在代码里加了一个“防抖”逻辑触发点检测到之后要求之后的N个采样点都持续高于触发电平才确认是有效触发。N的取值跟采样率有关默认16在高噪声环境下可以调到64代价是触发延迟会稍微变大。3.4 LCD波形绘制从裸画点优化到显存刷新我用的是2.8寸TFTLCD屏ILI9341驱动320×240分辨率。最开始的画点函数是一位一位刷的画一屏波形要几百毫秒刷新率只有1-2帧/秒完全没法用。后来改成帧缓冲方案在内存里开辟320×240的显存数组波形绘制全部在显存里完成一次DMA把整块显存刷到LCD。这个优化效果立竿见影刷新率提升到20帧/秒以上。显存占据320×24076800字节用RGB565格式就是153600字节刚好在F407的192KB SRAM范围内。如果你用F103只有20KB SRAM就得改成“行缓冲逐行刷新”的方案或者牺牲颜色深度用单色图形模式。绘制逻辑上把ADC原始值映射到屏幕Y坐标// 原始值范围0-4095映射到屏幕Y轴0-239 // 同时考虑触发电平线THRESH_LINE_Y和垂直偏移v_offset uint8_t y (uint8_t)((adc_val * (LCD_HEIGHT - 2)) / 4095); // 再取反屏幕Y轴向下而电压值向上 y (LCD_HEIGHT - 1) - y v_offset;网格线的画法是在绘制波形前先画一遍浅灰色点阵再叠加波形线。这样波形和网格层次分明不会互相干扰视线。3.5 串口与上位机扩展虽然屏幕能显示波形但有时候还是想把数据弄到电脑上做进一步分析。工程里加了一个简单的串口协议按固定周期通过USART1把采样数据打包成二进制格式发送帧头0xAA 0x55 数据长度 原始采样值 校验。电脑端可以用串口助手接收也可以自己写一个简单的Python脚本解析并实时绘图。import serial import struct import matplotlib.pyplot as plt ser serial.Serial(COM10, 921600, timeout1) data [] while True: # 查找帧头和帧尾解析出原始ADC值列表 ...串口波特率我配到了921600实测传输12位ADC原始值每秒可以传约4万个采样点够做离线分析用了。要注意的是串口中断优先级不要设太高否则会频繁打断主循环影响波形刷新和触发检测的实时性。4. 调试、标定与实测数据4.1 零点与增益标定每次上电后ADC的零点、增益都会因为温度、电源电压的微小变化而漂移所以工程里加入了标定流程。标定分两步第一步是零点标定把输入通道接地采集1000个样本取平均值作为零点偏移值。第二步是增益标定给输入端加上一个精确的电压比如2.000V采集1000个样本取平均值根据期望值与实际值的比值算出增益修正系数。// 零点偏移存储在flash中增益系数也持久化保存 uint32_t adc_offset CalculateAverage(0); // 接地时均值 float gain_correction 2.0f / (CalculateAverage(2000) - adc_offset) * 4095.0f / 3.3f;这两个值在CubeMX工程里用HAL_FLASH_Program写入专用扇区下次启动直接读取。标定按钮在UI菜单里按一次进入标定模式屏幕会提示你“接地”或“接2V标准电压”。实测标定后3.3V档位下测量1.8V电压误差小于±5mV10V档位下测量5.0V电压误差小于±50mV。对DIY示波器来说精度已经非常可观。4.2 与商用示波器对比1kHz方波实测我最关心的还是实际测出来什么样。用信号发生器输出1kHz方波3.3V高电平商用示波器作为参考STM32示波器同时测量。STM32示波器设置为2ms/格时基、1V/格垂直灵敏度能看到方波的上升沿大约占了一个采样点约0.64us不是垂直的这是采样率导致的正常现象——1.56Msps采样率下一个采样点间隔是0.64us如果信号上升沿真实持续时间只有几十纳秒会测到明显变缓的上升沿。对比结果如下指标STM32示波器实测商用示波器TBS1102C频率读数1.003kHz1.000kHz高电平电压3.31V3.29V低电平电压0.01V0.00V上升沿时间1.27us2个采样点25ns频率和电压读数差距不大上升沿时间差距巨大这是因为采样率决定的属于正常现象。测正弦波10kHz时波形光滑度也看起来不错只是波形边缘在放大后能看到明显的“台阶感”这是所有数字示波器的共性不是bug。4.3 采样率不足时的“阶梯感”怎么破等效采样技术如果非要测更高频率的信号有一个开源项目常用的技巧——随机等效采样Random Interleaved Sampling。基本原理是对周期性信号反复多次采样每次采样点落在信号周期内的不同相位上把多次采样的样本“拼”在一起来重建一次完整波形。等效采样率可以提升一个数量级。这个技术实现起来不复杂代码逻辑核心是// 对同一周期信号触发多次每次记录触发点和后续采样点 // 将采样点在周期内按相对相位对齐 for (uint32_t i 0; i NUM_SWEEPS; i) { wait_for_trigger(); // 等待下一次触发 sample_points_with_timing(); // 采样N个点 align_to_period(); // 根据当前触发位置估算相位 merge_into_waveform_buffer(); // 合并进最终波形缓冲 }不过等效采样的前提是“被测信号必须是周期信号”而且触发时序必须稳定。这个功能作为进阶分支放在了代码仓库的feature/equiv_sampling分支主线代码没默认开启因为会显著增加CPU占用率。4.4 UI交互与菜单实测菜单参数靠三个按键加一个编码器操作按键切菜单、编码器调数值。实测下来最开始的主界面完全没有菜单只有波形和固定的数值后来根据使用反馈加了“V/div”“S/div”“触发电平”“暂停/运行”四个功能操作逻辑是短按编码器切换选中项、旋转编码器改变数值、长按保存参数到flash。整个开发过程中最耗时间的不是硬件和采样而是菜单交互逻辑的状态机。UI模块里用了一个简单的状态机STATE_IDLE、STATE_MENU、STATE_ADJUST、STATE_CALIBRATE。每个状态下的按键事件定义在一个结构体里方便扩展。typedef struct { uint8_t state; void (*on_key_short)(void); void (*on_key_long)(void); void (*on_encoder_change)(int8_t delta); } ui_state_handler_t;这样写状态机的可读性比散落的if-else强太多后续加新菜单只需要新增一个state handler。5. 常见问题与排查技巧实录5.1 ADC采不到数或读数恒定现象LCD上波形是一条直线数值不变化。排查步骤先查硬件用万用表测量PA0引脚电压如果信号源输出正常而ADC读数不变问题在软件或内部连接。再查CubeMX配置确认ADC的Channel、GPIO模式是否设置为模拟输入GPIO_MODE_ANALOG。这个问题非常常见GPIO配置成复用功能或输入模式ADC读到的就是固定值。最后查DMA配置确认HAL_ADC_Start_DMA调用成功DMA通道优先级不要设成LOW否则在高负载时可能丢中断导致回调里的标志位永远不置位主循环永远不处理缓冲区。5.2 波形有严重毛刺或基线噪声现象未接信号时屏幕上显示的波形基线有肉眼可见的细碎毛刺幅度有几十毫伏。把三个方向都试过之后我的解决顺序是先排除电源问题检查VREF滤波电容是否焊好默认0.1uF如果容值不合理高频噪声会串进参考电压。再排查地线探针地线夹一定要用短的地线一长就成了天线。我用的是标准示波器探头短地线约10cm长效果比鳄鱼夹地线好几个量级。软件层面采样数据做个中值滤波3点中值滤波取三个连续值的中间值对毛刺特别有效。代价是会把真正的窄脉冲细节抹掉一点所以我只在“低噪声模式”菜单下默认开启追求性能时可以关掉。5.3 波形滚动不停止或触发失效现象频率较低比如10Hz的信号时波形明明在屏幕上能显示但无法“停住”一直向左滚动。这是触发逻辑的边界条件没处理好。我的代码在触发模式下有个超时机制如果在一次缓冲区中没找到边沿就显示一个“等待触发”的提示并且不更新波形如果设置了超时时间默认200ms超时后强制显示当前缓冲区内容。这样低频信号、慢边沿信号也能看到波形只是不再对齐到触发点了。调试中发现这个超时值不能设得太短否则正弦波在低频时会有“一卡一卡”的刷新感200ms到500ms比较合适。5.4 主循环跑飞或界面卡死现象有时候按按键没反应有时候LCD画面卡住不动但复位后又能正常用一段时间。这类问题十有八九是中断优先级配置不合理。HAL库的默认配置下SysTick中断优先级为15最低DMA中断也默认15。如果在DMA中断回调里做了耗时操作比如打印日志或者调用HAL_Delay主循环就会被长时间阻塞UI就没响应了。调整方案是HAL_NVIC_SetPriority(DMA2_Stream0_IRQn, 5, 0); // DMA中断优先级设为5 HAL_NVIC_SetPriority(SysTick_IRQn, 10, 0); // SysTick设为10同时DMA中断回调里只做标志位置位所有数据处理触发检测、波形绘制全放到主循环里中断里绝不调用HAL_Delay。5.5 常见问题速查表现象可能原因排查手段ADC读数恒为0GPIO未设模拟输入检查GPIO_MODE_ANALOG波形噪声大VREF滤波不良检查VREF电容波形滚动不停触发超时设置过短调整超时值UI卡顿中断优先级不当调整DMA/SysTick优先级电压读数偏大/偏小零点或增益未标定执行标定流程LCD花屏显存数组越界检查adc_buf索引范围5.6 这个项目还能怎么扩展底板预留了扩展接口后续可以走的方向其实很多双通道支持F407有3个ADC模块可以同时配置ADC1和ADC2用双ADC同步采样模式做到2通道400kHz以上采样率。硬件触发加一个LM311比较器输入信号经比较器后输出到外部中断引脚用PWM触发模式控制DMA采样能实现真正的预触发存储。上位机图形化界面当前是通过串口发送原始数据如果花点时间写一个Qt或Python上位机可以实时画出更精细的波形还能保存和回放。USB高速传输F407自带USB HS如果能用USB把采样数据传到电脑传输速度能到几十MB/s彻底打破串口瓶颈。我个人在实际操作中最大的体会是STM32示波器这个项目硬件电路只占三成难度剩下的七成在“采样时序、触发逻辑、显示刷新”这套软件架构上。只要把这套流程摸透了回头看任何嵌入式项目的数据采集和显示逻辑都特别通透。最后再分享一个小技巧调试触发逻辑的时候别嫌麻烦一定要把“未找到触发”和“已触发但超时”这两种状态区别开用不同颜色或文字显示在屏幕上否则你会被“看起来正常但其实没对齐”的假象坑很久。这套工程的源码和设计文档都是开源的直接拿去改就行遇到问题回来看这篇博文的排查表基本上能解决九成的问题。本文还有配套的精品资源点击获取