STM32虚拟信号分析仪示波器套件：从模拟前端到上位机的完整信号链设计

简介：这套基于STM32的多功能虚拟信号分析仪示波器套件，面向电子工程师、嵌入式开发者及高校学生，适用于学习STM32外围驱动、ADC采样、数字滤波与波形显示等典型应用。压缩包共302个文件、约10.98MB，核心包括101个h头文件、97个c源码、64个s汇编文件，以及uv2/opt等Keil工程配置，构成可编译烧录的固件项目；另含pcbdoc硬件原理图、pdf使用说明、bmp波形截图和txt辅助文档，便于对照理解从硬件前端到软件处理链路的完整实现。内容覆盖模拟前端调理、定时采样、数据缓冲、高效显示与用户交互，还包含可运行示例生成的方波、三角波、正弦波及其对数自功率谱等位图。已有192人浏览/学习。通过该套件可掌握基于STM32的实时信号分析系统设计思路，适合作为课程设计、毕业设计或工程预研的参考。

1. 别急着画板子：这套件解决的是“信号链没搭好”的问题

很多人在 STM32 上做示波器，第一步就选错了方向：要么直接怼高分辨率 ADC 加 DMA，要么把 FFT 算法写得天花乱坠，结果探头一接真实信号，波形不是漂就是削顶，甚至完全看不到东西。基于STM32多功能虚拟信号分析仪示波器套件这个标题真正值钱的点，不在于“用单片机采集波形”这个已经被人写烂的思路，而是“虚拟仪器”四个字背后的完整链路：前端模拟调理、ADC 采样与触发、USB/串口上行、上位机解析与显示，以及最容易被忽略的校准环节。它是一套软硬结合的信号链方案，而不是单纯的嵌入式代码。

这套件适合三类人：一是做毕业设计或课程设计，需要在一个题目里同时体现模拟电路、数字信号处理和上位机开发能力的学生；二是日常调试电源纹波、PWM 波形、串口时序但不想扛台式示波器的嵌入式工程师；三是想把“采集-传输-显示”这条链路拆开逐步验证的入门者。文章后续提到的所有命令、参数和代码，都围绕一个可行且不依赖特定商家方案的通用架构展开，你可以直接用 CubeMX 生成工程，再按文中思路补齐上位机。先看整个系统怎么拆。

2. 系统架构与选型：先把 STM32 的资源边界画清楚

2.1 为什么虚拟示波器要用 STM32 而不是纯 USB 逻辑分析仪

逻辑分析仪只能看 0/1 电平，而标题里写的是“信号分析仪”，意味着要处理模拟电压、频率、周期、占空比甚至小幅值畸变。STM32 的优势是片上集成了 ADC、DAC、定时器、DMA 和 USB 控制器，一片芯片就能完成采样控制与数据上传。常见的做法是选 STM32F103 或 STM32F401，前者便宜、资料多、ADC 最快 1us，后者主频高、自带 USB FS，适合需要更高采样率或做 FFT 的场景。你要根据输入信号的带宽决定主频，而不是先定芯片再迁就性能。

采样率估算有个经验公式：要测量 100kHz 以内的信号，等效采样率至少 1MSPS，考虑 ADC 实际有效位数（ENOB）和触发余量，2MSPS 比较稳。STM32F103 的 ADC 最高 1MSPS 左右，F401 可以到 2.4MSPS，但单通道连续采样时受限于总线带宽。如果你用定时器触发 ADC 而非 ADC 连续转换模式，可以解放 CPU 并保证采样间隔精确，这一点在测量 PWM 占空比时尤其重要。

核心选型表如下：

注意一个很容易踩的坑：STM32 的 ADC 输入引脚耐压就是 VDDA，通常 3.3V，超过 3.6V 直接烧。所以套件里一定有一个输入保护网络，哪怕只是两个反向并联的二极管接到 3.3V 和 GND，都要先做再说。真实项目里经常看到有人直接把 12V 信号接到 PA1，然后整片芯片报废，这种错误属于模拟前端设计缺失，不是代码问题。

2.2 用 CubeMX 生成最小工程：时钟树与 ADC 触发配置

我习惯用 STM32CubeMX 先生成工程骨架，再在代码里补业务逻辑。因为 ADC 触发、DMA、USB 外设初始化全都依赖 RCC 时钟树，手写寄存器容易漏边角。先新建一个无操作系统的基础工程，选好芯片型号后，按下面顺序配置：

1. RCC：HSE 外部晶振 8MHz，PLL 倍频到 72MHz（F103）或 84MHz（F401）。总线时钟必须稳定，否则 ADC 采样率会漂。
2. ADC1：开启 IN0 或 IN1 单通道，采样时间设为 28.5 周期，连续转换模式关闭，外部触发信号源选 Timer 2 Trigger Out。
3. 定时器 TIM2：分频器与重装载值决定触发频率。例如 72MHz 时钟，PSC=0，ARR=72-1，则触发频率为 1MHz，即每微秒触发一次 ADC 采样。
4. DMA1：ADC1 的 DMA 请求映射到 DMA1 Channel1，模式设为循环模式，数据宽度字（Word），方向外设到内存。
5. USB：启用 USB 设备功能，选择 CDC 类。不需要额外晶振，用内嵌的 48MHz 振荡器，但注意要勾选USB Clock从 PLL 分频得到。

生成代码后，CubeMX 只帮你初始化了外设，触发链路的启停还是要手动控制。核心代码块如下，配合注释理解触发与 DMA 联动：

/* main.c 中初始化后，启动 ADC 采集 */ HAL_ADCEx_Calibration_Start(&hadc1); // 上电校准，不校的话直流偏置会偏很大 HAL_ADC_Start_DMA(&hadc1, (uint32_t*)adc_buf, ADC_BUF_LEN); HAL_TIM_Base_Start(&htim2); // 启动 TIM2，ADC 开始以 1MHz 频率采样 /* 在 DMA 半传输与传输完成中断中切换读指针 */ void HAL_ADC_ConvCpltCallback(ADC_HandleTypeDef *hadc) { // 双缓冲区前半段已填满，可上传 0~len/2 的数据 dma_ready_block = 0; }

逻辑说明：HAL_ADC_Start_DMA启动后，ADC 不会主动采样，必须等 TIM2 的 TRGO 事件。每次溢出产生一个上升沿，ADC 就采样一次。DMA 循环模式把采样值写进缓冲，缓冲区分成两半，产出上半段时触发 callback。参数ADC_BUF_LEN一般是 4096 或 8192，对应一帧波形的点数；点数太少，波形前有锯齿，点数太多，USB 上行带宽压力大。选择 4096 是因为在 1MHz 采样率下，正好 4ms 一帧，上位机 60Hz 刷新时也有足够余量。

你要是只想先跑通，不想管 DMA 双缓冲，也可以用最简单的阻塞式HAL_ADC_Start加延时采点，但那会浪费 CPU，而且采样间隔抖动很大，测正弦波会看到毛刺，这是很多人误以为 ADC 坏了的原因。先用最小代码验证传输链路，再升级采样机制，是更稳妥的顺序。

3. 数据帧协议设计与 USB 虚拟示波器链路打通

3.1 为什么直接用串口工具看波形是不可行的

把 STM32 的 ADC 值通过串口助手打印成十六进制，再用串口工具自带的波形窗口显示，是初学者最常用的调试法。但真实使用中你会发现两个问题：第一，裸数据量很大，921600 波特率下每秒才 92KB 左右，而 1MHz 采样率 16 位精度需要 2MB/s 上行，完全超量；第二，数据没有帧头和通道标识，上位机无法区分“这是一帧数据”和“这是乱码”。所以必须设计一个轻量二进制帧协议，且数据上传前要做降采样或分包传输。

常见做法是定义如下帧头：0xAA 0x55后跟一字节类型、一字节通道数、两字节数据长度，然后跟原始采样值。上位机只在收到完整帧头和数据字节后更新波形。不要用printf发文本格式的数据，格式化的开销不值得。代码里直接写串口或 USB 发送时用中断或 DMA，这里贴一段帧封装函数：

typedef struct { uint8_t head[2]; // 0xAA 0x55 uint8_t type; // 0x01 表示原始波形数据 uint8_t ch_count; // 通道数 1 或 2 uint16_t data_len; // 有效采样点数 uint16_t *data; // 采样值指针 uint16_t crc16; // 简单校验，防止 USB 丢字节 } signal_frame_t; void pack_and_send(signal_frame_t *frame) { uint8_t buf[HEADER_SIZE + MAX_DATA_LEN * 2 + 2]; buf[0] = 0xAA; buf[1] = 0x55; buf[2] = frame->type; buf[3] = frame->ch_count; buf[4] = frame->data_len >> 8; // 高字节在前 buf[5] = frame->data_len & 0xFF; memcpy(buf + 6, frame->data, frame->data_len * 2); uint16_t crc = calc_crc16(buf, 6 + frame->data_len * 2); buf[6 + frame->data_len * 2] = crc >> 8; buf[6 + frame->data_len * 2 + 1] = crc & 0xFF; USB_SendData(buf, HEADER_SIZE + frame->data_len * 2 + 2); }

参数说明：data_len决定单帧大小，设成 1024 点、16 位精度时，一帧约 2KB，加上头尾不到 2.1KB。USB 虚拟串口底层有缓冲区，分两次发送也可能被上位机合并，所以接收端必须按帧头解析，不能按固定长度读取。crc16的计算可以选择 CRC-16/MODBUS 或简单的查表法，不复杂；否则 USB 偶尔丢字节，波形会整段错位。

关于上行方式，优先用 USB CDC 虚拟串口。这样在 PC 端只是一个 COM 口，可以用 Python 的pyserial直接读，不依赖厂商 DLL。唯一要注意的是虚拟串口的缓冲机制：Windows 上层可能合并包，也可能拆开包，但帧头同步可以解决这个问题。如果你把 STM32 接到无头树莓派上用pySerial读取，一样适用——这本质上是链路层与协议层分离的经典思路。

3.2 上位机读取与波形显示：Python + pyQtGraph 的最小实现

上位机选型上，不要用 Matplotlib 做实时波形，那个重绘性能太差。pyQtGraph的性能足以支撑每秒 30 帧、每帧 4096 点的绘制，同时它的 API 比 Qt 原生绘图简单。再配合numpy做数据处理，整个上位机代码能控制在 300 行以内。这里说明一个常见误区：很多人喜欢把 FFT 计算放在 STM32 里，求出频率再传给上位机，这对入门没问题，但短板明显——点数一多，FFT 时间占用超过采样间隔，就会丢帧。正确做法是原始采样值上传，FFT 与显示都在上位机里实时算，STM32 只负责采集，职责单一。

上位机最小读取循环如下：

import serial import numpy as np import pyqtgraph as pg from pyqtgraph.Qt import QtCore, QtGui import struct HEADER = b'\xaa\x55' class ScopeThread(QtCore.QThread): def __init__(self, port, baud=921600): super().__init__() self.ser = serial.Serial(port, baud, timeout=0) self.running = True self.buf = b'' self.ready = False self.samples = np.zeros(1024, dtype=np.uint16) def run(self): while self.running: data = self.ser.read(4096) if not data: continue self.buf += data idx = self.buf.find(HEADER) if idx < 0: self.buf = self.buf[-2:] # 保留最后两个字节，防帧头被拆分 continue self.buf = self.buf[idx:] if len(self.buf) < 6: continue type_, ch, dlen_h, dlen_l = struct.unpack_from('>BBBB', self.buf, 2) dlen = (dlen_h << 8) | dlen_l frame_len = 6 + dlen * 2 + 2 if len(self.buf) < frame_len: continue raw = self.buf[6:6 + dlen * 2] self.samples = np.frombuffer(raw, dtype='>u2') self.ready = True self.buf = self.buf[frame_len:]

这段代码的逻辑说明：serial.read(4096)不管帧边界，读进来的字节全赖到self.buf尾部；find(HEADER)搜索帧头，找不到就把这次数据丢掉；找到了但数据长度不足，就留着等下一轮。由于上位机是 64 位系统，USB 串口驱动不会保证读取块正好等于发送块，所以解析必须带状态。struct.unpack_from('>BBBB', ...)用大端方式解析头四个字节，与下位机发送顺序一致。np.frombuffer(raw, dtype='>u2')把每两个字节拼成一个 16 位 ADC 值，转换效率远高于 Python 循环逐次取值。

显示部分，用pg.PlotCurveItem.setData刷新即可。常规做法是开一个QTimer每 33ms 触发一次读取并更新曲线。如果波形出现割裂，先检查下位机帧长度与上位机frame_len是否一致，这是最常见的错位根源。还有，pyQtGraph 的 y 轴默认自适应范围会随噪声波动，加上电压档位换算后，建议固定 y 轴范围，否则肉眼看不出真实幅值。

4. 信号调理与校准：再好的 ADC 也怕前端不匹配

4.1 模拟前端的分压电阻与带宽匹配问题

很多 STM32 示波器项目死在模拟前端。ADC 引脚能容忍的电压范围就 0~3.3V，而实际测量对象常常是 5V TTL、12V PWM 甚至 -5V 的音频信号。常见的调理方案是电阻分压网络加电压抬升电路：对正电压信号，先经过 1MΩ 与 100kΩ 分压把幅度压缩到 1/11，再经过跟随器降低输出阻抗，最后用运放做电平平移，使负半周也能落在 0~3.3V 区间。

这里有一个高频时需要注意的细节：电阻分压器不是纯电阻网络，焊盘寄生电容和运放输入电容会形成低通滤波器。如果示波器套件标称带宽只有 1MHz，随便用直插电阻问题不大；但如果你想测 PWM 的高频边沿，就必须用并联小电容补偿，例如 1MΩ 电阻旁并联 3~5pF 电容，形成一个平坦的幅频响应。更实用的做法是准备一个 BNC 接口，探头 x10 档位自带的补偿电容比你自己调电阻网络可靠得多。

推荐的前端拓扑：

外部信号 -> BNC / 香蕉头 -> [R1 1MΩ] -> [R2 100kΩ] -> [运放跟随] -> [ADC引脚] | | +---> 钳位二极管至 3.3V/GND

R1 与 R2 选值注意：总输入阻抗 1.1MΩ 接近台式示波器标准，但 R1 阻值太大会引入热噪声，R2 太大会造成分压网络带载能力差，跟随器输入偏置电流产生失调电压。一般 R1=1MΩ，R2=100kΩ，运算放大器选 OPA350 或 MCP6022 这类轨到轨单电源运放，供电 3.3V，输出范围尽量覆盖 0~3.3V。

4.2 零点校准与增益校准：没有“大概准确”的示波器

套件首次上电时，必须校准零点和增益，否则测直流电压偏差几百毫伏很常见。STM32 ADC 本身有工厂校准寄存器，但外部链路（分压电阻误差、运放失调）不在 ADC 校准范围内。工程上的做法是设计一个校准流程：

1. 短路信号输入端，测 ADC 原始值读取偏移offset_raw。此时理论上输入为 0V，ADC 原始值应接近 0，但由于运放输出可能不是 0，所以记录一个基准值。
2. 输入一个已知精密电压，例如 1.000V（可以用 TL431 或台式电源），测 ADC 原始值ref_raw。
3. 计算增益系数gain = (1.000V / 3.3V * 4096) / (ref_raw - offset_raw)。
4. 上位机实际显示电压时，用(raw - offset_raw) * gain * 3.3V / 4096换算。

这里给出一个上位机校准对话框中会用到的最小公式与代码：

class Calibration: def __init__(self, offset_raw=0, ref_raw=2048, ref_voltage=1.0): self.offset_raw = offset_raw self.scale = (ref_voltage / 3.3 * 4096) / (ref_raw - offset_raw) def raw_to_voltage(self, raw): return ((raw - self.offset_raw) * self.scale) * 3.3 / 4096

参数说明：offset_raw是短路信号输入时采集 1000 次的平均原始值，ref_raw是接上已知参考电压后的平均原始值。scale的含义是“每 LSB 对应的电压系数”，这个系数同时吸收了分压比误差和运放增益误差。换算时先减零点再乘比例，最后乘 3.3V 基准，才是真正的实际电压。此方法校准后，直流精度通常在 2% 以内，满足绝大多数示波器测量需求。校准数据建议保存在 STM32 内部 Flash 或上位机配置文件里，不要每次开机都重来。

这章里最后提醒一点：如果你看到 ADC 值在信号为零时依然有 100~200 数的跳动，那不是校准能解决的，而是参考电压或地平面噪声。此时先用 3.3V 电源到 ADC 引脚接入一个干净的信号源，确认 ADC 原始值稳定，再去排查前端电路。校准的前提是硬件链路噪声足够低，否则校准系数本身会跟着抖动漂移。

5. 触发模式与参数测量：让波形不再来回乱飘

5.1 上升沿触发怎么在 STM32 端实现，而不是靠上位机硬找

没有触发的示波器，波形会在屏幕上横向滚动，测频率尚可，看毛刺和占空比就很吃力。对于这套件，低成本方案是用 STM32 的模拟看门狗（AWD）或比较器实现简单电平触发：当 ADC 值超过设定的阈值，立即开启 DMA 传输采样数据，采样若干点后再停止。上位机收到一帧数据时，第一个点并不一定在波形的固定相位，但可以保证每帧都从偏离阈值的位置开始，这样显示效果就稳定多了。

更精确的做法是用定时器输入捕获模式检测外部波形边沿，再以边沿为基准启动 ADC 采样。例如对 PWM 信号，将信号同时接到定时器输入捕获引脚和 ADC 输入引脚；检测到上升沿时，TIM2 主控制器输出一个更新事件，触发 ADC 在第一拍就采样。这个方案的时序关系要清楚：捕获中断里启动 ADC，中断响应延迟可能引入抖动，但对大多数教学级套件来说完全够用。

当你在上位机看到一个完整正弦波左右滑动，且滑动速度与信号频率不同步时，就说明没有触发。先用 STM32 的模拟看门狗快速实现一个可用的触发，代码大致如下：

/* 配置 ADC 模拟看门狗 */ ADC_AnalogWDGConfTypeDef awd = {0}; awd.Channel = ADC_CHANNEL_0; awd.ITMode = ADC_IT_EOC; // 看门狗中断使能 awd.Mode = ADC_ANALOGWATCHDOG_SINGLE_REG; // 仅监测单通道 awd.HighThreshold = 2048 + 300; // 阈值上限，对应 1.65V 附近 awd.LowThreshold = 2048 - 300; // 阈值下限 HAL_ADC_AnalogWDGConfig(&hadc1, &awd);

阈值计算逻辑：ADC 是 12 位，满量程 4096，3.3V 参考。2048 对应 1.65V。设阈值范围 ±300 LSB，相当于 ±240mV 的滞回区间，防止信号在阈值附近抖动造成反复触发。你要测的波形如果摆幅较小，把阈值范围缩到 ±50 LSB，不然触发电平永远跨越不过去。

5.2 频率、周期、占空比和峰峰值：上位机测量算法的四个细节

上位机做参数测量时，常用 numpy 加速。以下四个参数是示波器标配，但实现细节坑很多：

• 频率与周期：找到信号穿越中值（通常取平均值）的点。连续两个上升穿越点之间的时间差就是周期。穿越点用插值计算，否则采样率不够时频率测出来是一顿一顿的。
• 占空比：计算高电平持续时间占一个周期的比例。高电平判断也要用中值阈值，不能用 0，因为信号可能有直流偏置。
• 峰峰值：直接取最大值减最小值，但噪声尖峰会夸大峰峰值。推荐用百分位数，例如取 0.1% 和 99.9% 分位数之间的差值，抗脉冲干扰。
• 有效值与真有效值：对标准正弦波，RMS 等于峰值除以根号 2；对 PWM 或任意波形，必须逐点平方求均值再开方。上位机里np.sqrt(np.mean(signal.astype(np.float64) ** 2))一步到位。

测量代码示例：

def measure(signal, sample_rate): mid = np.mean(signal) crosses = np.diff((signal > mid).astype(int)) rising = np.where(crosses > 0)[0] if len(rising) >= 2: period = (rising[-1] - rising[0]) / sample_rate freq = 1.0 / period else: freq = 0.0 p2p = np.percentile(signal, 99.9) - np.percentile(signal, 0.1) rms = np.sqrt(np.mean((signal - mid) ** 2)) return freq, p2p, rms

说明：np.diff((signal > mid).astype(int))将布尔数组转成 0/1 并做差分，差分从 1 变 0 是下降沿，0 变 1 是上升沿。取rising[-1] - rising[0]而不是rising[1] - rising[0]，目的是用多个周期平均降低单周期抖动误差。如果period是 0，说明信号幅度没穿过阈值或者信号不对，界面提示用户调整触发电平或垂直档位。占空比的测量可以用等宽的阈值判断，但快速估算法是统计signal > mid的样本数占总样本数的比例。两者结果有差异，原因是插值效应，对教学演示就够了。

6. 进阶校验：用已知信号验证采样时序与幅值精度

最后一招，不是写更多功能，而是教你如何验证整套件“测得到底准不准”。没有校验的示波器，测量的数字只能算猜测。用 STM32 内部 DAC 生成一个已知频率和幅值的正弦波，再把 DAC 输出接到 ADC 输入，做一次“回环自测”，这是最方便且不需要额外仪器的方案。

具体操作：STM32 自带 12 位 DAC，使用定时器触发输出一个正弦波查表值。DAC 输出电压范围 0~3.3V，叠加一个 1.65V 直流偏置，输出 500Hz、幅度 1Vpp 的信号。将 PA4（DAC_OUT1）与 PA0（ADC_IN0）之间用一根杜邦线直连。然后运行采集流程，上位机如果正确计算出频率约 500Hz、峰峰值约 1V，且波形看起来是标准正弦，那说明 ADC 触发时序、DMA 传输、上位机帧解析全部正常。如果频率显示 495Hz，优先查晶振频率精度；如果峰峰值差了 10%，回头查增益校准系数。

DAC 生成正弦波的代码段：

const uint16_t sine_table[256] = { 2048 + (int)(2047 * sin(2 * M_PI * i / 256)) // 预生成 }; void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) { if (htim->Instance == TIM3) { static uint8_t idx = 0; HAL_DAC_SetValue(&hdac, DAC_CHANNEL_1, DAC_ALIGN_12B_R, sine_table[idx]); idx++; } }

逻辑与参数说明：TIM3 定时中断频率设为 256 * 500Hz，即 128kHz，每进一次中断更新一个采样点，完整查完 256 个点便产生一个 500Hz 正弦波周期。2048是零点，2047 * sin(...)保证峰值不超过 DAC 满量程，避免削顶失真。这里不用开 DMA，因为查表输出一个点只占几十周期，主频 72MHz 下处理器能轻松应付。用这个方法自检时，如果波形上部或下部出现削平，说明 DAC 输出偏置接近电源轨，把正弦表幅度降到 1800 左右重新试。

如果这套件的板子上没有 DAC 引脚，也可以用 PWM 加二阶 RC 滤波生成近似正弦波，但谐波含量高，ADC 自检得到的频率仍然准确，峰峰值会偏低一些。两个方案都可以用来验证信号链；重点是观察测量结果与设定值之间的误差方向：频率不准多半是时钟问题，幅值不准多半是增益校准问题，显示在屏幕上的波形有相位断裂则多半是触发配置问题。把这三类误差源头定位清楚，这套虚拟信号分析仪示波器套件对你来说才是真正跑通了。

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