ESP32-C3自制低成本示波器：从采样原理到波形显示全攻略

如果你在搜索框里输入“esp32c3 示波器”，大概率是两种情况：一是手里已经有一块 ESP32-C3 开发板，想拿它做一个低成本波形采集工具；二是准备测 I2C、PWM、音频这类低速信号，但不想每次都搬台式示波器。这次我们就把这个项目讲清楚：ESP32-C3 示波器到底能测什么、硬件门槛在哪、怎么烧录固件、怎么把波形显示到电脑上，以及实际使用中会遇到哪些坑。

先说结论：这类项目本质不是对标几百兆带宽的商用示波器，而是用 ESP32-C3 的 ADC 加串口或者 Wi-Fi，把模拟信号变成数字采样点，再交给上位机绘制。它的优势是便宜、便携、二次开发方便，弱点是采样率和精度有限。只要你对这两点有心理预期，整个项目做下来会非常顺手。

本文会从零给出一套可复制的方案，包括开发板选型、前端分压电路、固件代码、上位机脚本、以及波形验证方法。如果你是把 ESP32-C3 当学习工具用，或者要搭一个批量采集信号的环境，这篇文章可以直接跳到你需要的章节。

1. 核心能力速览

这里先说明一个最重要的边界：ESP32-C3 内置 ADC 不是为高速示波器设计的。不要拿它和泰克、鼎阳这类商用示波器做同等比较。它更适合“信号到底有没有、频率大概是多少、电平对不对、通信是否卡住”这类定性加半定量分析。真实参数需要在你的开发板上跑实际采样程序，再通过上位机校准，不能只看芯片手册上的理论值。

2. 适用场景与使用边界

2.1 适合做什么

如果你在调试一个 STM32 或者 ESP32-C3 项目，经常遇到 I2C 总线拉死、PWM 占空比不对、音频信号异常、电源纹波偏大这类问题，直接用 ESP32-C3 做一个简易示波器是最快的手段。它的输入阻抗问题可以通过前端电路优化，开发板加两根杜邦线就能接入被测点，不需要等待笨重仪器开机。

这个项目也非常适合教学。很多新手第一次接触示波器时，会被商用仪器的触发、存储深度、探头补偿这些概念搞懵。ESP32-C3 示波器把整条链路简化成“ADC 采样 → 串口发送 → 上位机绘图”，概念透明，所有代码都能看到。理解了数字示波器的基本逻辑之后，再上手商用示波器会轻松很多。

2.2 不适合做什么

ESP32-C3 示波器不适合测量高频载波、高速差分信号、射频信号，也不适合做任何与市电直接相关的测量。芯片内部 ADC 的采样带宽有限，输入引脚耐压也有限。如果直接把 220 V 交流电或者未隔离的开关电源热端接进开发板，会烧毁芯片，甚至带来安全风险。

高频方波在 ESP32-C3 示波器上通常会被整形得非常圆滑，上升时间明显变长。这是采样率不够导致的，不是被测信号本身的问题。需要测高频细节时，老老实实换商用示波器，或者给前端增加高速比较器和 FPGA 采样方案。

2.3 测量安全边界

自己做示波器，必须加隔离和限幅意识。任何输入信号都必须先经过分压、限幅、钳位保护，再进入 ESP32-C3 的 GPIO。测量电池、3.3 V 逻辑、音频信号这类低电压源相对安全，但仍建议串联 1 kΩ 电阻，防止误接高压。被测系统和开发板之间如果存在不同地电位，必须共地或使用隔离方案。文章后面会给出一个保守的前端电路，但请把它当作最小保护，而不是万无一失的方案。

3. 硬件准备与接线设计

3.1 开发板与工具清单

做 ESP32-C3 示波器，最方便的是带板载 USB 转串口的一体开发板，例如常见的 ESP32-C3 SuperMini 或者官方 DevKitM-1 类形态。不同型号虽然引脚排布有差异，但烧录逻辑基本一致，只要确认板子上有 USB-C 或 USB-A 接口即可。

3.2 输入前端电路设计

为什么不能直接把信号接到 ADC 引脚？因为被测信号范围可能超过 3.3 V，而 GPIO 内部保护二极管并不可靠。一个最基本的前端电路是电阻分压加钳位。

假设你希望测量 0 到 30 V 范围内的直流或低频信号，可以使用 9 kΩ 和 1 kΩ 电阻分压，分压后电压是原始电压的十分之一。采样引脚处再并联一个 3.3 V 稳压二极管到地。实际接线如下：

被测信号 V_in ── 9 kΩ ──┬── 1 kΩ ── GND │ ├── ESP32-C3 GPIO0 │ 3.3V 稳压二极管 │ GND

这个电路的理解要点是：10 V 输入经过分压后约等于 1 V，20 V 输入约等于 2 V。超过 3.3 V 后，稳压二极管开始钳位，保护内部 ADC。测量 3.3 V 逻辑信号时，可以跳过 9 kΩ，只串一个 1 kΩ 限流电阻，避免高频方波因分压电阻的寄生电容而变形严重。

如果你要测量的是音频麦克风信号这类弱信号，分压电路就不合适了。更稳妥的方案是先加一个运放跟随器或者放大电路，再送入 ADC。运放选型可以根据你的信号频段和供电电压决定，不需要特别高端，常见轨到轨运放即可。

3.3 引脚映射

ESP32-C3 的 ADC 引脚不是随便找个 GPIO 就能用。不同开发板可以使用的 ADC 通道由芯片内部 ADC1 决定，一般 GPIO0 到 GPIO4 之间会有多个通道。为了图纸清楚，下面以 GPIO0 作为模拟输入示例：

共地是整个测量链路里最容易忽略的一步。被测开发板如果使用电池供电，ESP32-C3 示波器使用 USB 供电，两个系统之间必须有共同的地电位，否则采样值会漂移甚至完全错误。接线时先保证 GND 相通，再检查信号线。

3.4 软件依赖

烧录 ESP32-C3 需要先安装对应工具链。如果使用 Arduino IDE，在开发板管理器中添加 ESP32 开发板地址，然后安装 esp32 by Espressif Systems，版本按 IDE 实际可用版本选择。如果使用 PlatformIO，通过 Boards Manager 搜索 Espressif ESP32-C3 Dev Module 创建工程。ESP-IDF 方式适合对采样率和连续 ADC 模式有更高要求的开发者，但搭建速度会慢一些。

没有把握时，建议第一版用 Arduino IDE 跑通，再逐步迁移到 ESP-IDF。项目需要验证的是“能不能采到波形、能不能把数据送出来”，而不是一开始就追求极限采样率。

4. 固件编写与启动方式

4.1 用 Arduino 实现最小采样固件

ESP32-C3 的 Arduino core 可以用 analogRead 读取引脚，但 analogRead 每次调用开销比较大，不适合追求高采样率。一个简单做法是“固定采样点数量，集中采集，采集完成后再一次性通过串口发送”。这样可以避免上位机端显示缓慢，也让固件逻辑更清晰。

下面是一段适用于 Arduino IDE 的最小采样代码。代码逻辑是：电脑发送字符s，开发板连续采集 1024 个点，每次采样之间延迟由sampleDelayUs控制，采集完成后按 CSV 格式输出：

#define ADC_PIN 0 #define SAMPLE_NUM 1024 #define SAMPLE_DELAY_US 20 void setup() { Serial.begin(115200); pinMode(ADC_PIN, INPUT); } void loop() { if (Serial.available() > 0) { char cmd = Serial.read(); if (cmd == 's') { unsigned int values[SAMPLE_NUM]; for (int i = 0; i < SAMPLE_NUM; i++) { values[i] = analogRead(ADC_PIN); delayMicroseconds(SAMPLE_DELAY_US); } Serial.println("DATA_BEGIN"); for (int i = 0; i < SAMPLE_NUM; i++) { Serial.println(values[i]); } Serial.println("DATA_END"); } } }

这段代码最需要注意的地方是采样点数和采样间隔。ESP32-C3 的 Arduino core 内部对 analogRead 做了校准和平滑处理，所以单点采样时间不稳定是正常的。把 1024 个点全部存到内存，再发回到电脑，能最大程度减小传输对采样的干扰。

如果你想提高采样率，可以把SAMPLE_DELAY_US改成更小的值，但不要直接改成 0 然后希望获得极限采样率。实际能达到的采样间隔受 ADC 转换时间、模拟多路开关切换和 Arduino core 实现共同影响，需要逐个测试。

4.2 使用 ESP-IDF 连续 ADC 模式

Arduino 版本的analogRead适合学习，但它很难发挥芯片最大采样能力。ESP32-C3 的 ESP-IDF 支持 ADC 连续采样模式，可以配合 DMA 把数据放入内存，再通过串口或 Wi-Fi 发出去。这个方案更适合需要稳定采样率和更高吞吐量的场景。

ESP-IDF 的 ADC 接口配置感很强，这里给出一段不依赖具体版本的总体流程，让你在查阅官方示例时有方向：

1. 初始化 ADC 连续模式驱动 2. 创建 ADC 通道，设置衰减倍数 3. 配置采样帧大小 4. 注册 DMA 接收回调 5. 循环读取转换结果

具体到代码，需要引入esp_adc/adc_continuous.h，先定义句柄，再配置adc_continuous_handle_cfg_t，包括max_store_buf_size、conv_frame_size等参数。不同 ESP-IDF 版本之间函数结构有变化，优先参考你本机 IDF 目录里的examples/peripherals/adc/示例。

第一次跑通 ESP-IDF 版本时，不要直接加复杂的前端电路和信号调理，先用一个电位器或者固定电压测试。连续模式下数据会以批量方式进入内存，如果不理解帧结构，容易出现上位机波形错位的问题。

4.3 编译烧录与启动服务

Arduino IDE 编译烧录流程非常简单，开发板选型时选择 ESP32C3 Dev Module，设置正确串口后点击上传。PlatformIO 的命令需要按实际项目调整，通用模板如下：

# 在项目目录中执行编译 pio run # 上传固件到板子，串口号需要替换为实际端口 pio run -t upload --upload-port /dev/ttyACM0

烧录完成后，打开串口监视器，波特率设为 115200，输入字母s，如果能看到类似下面的输出，说明固件和接线都正常：

DATA_BEGIN 1024 2048 3072 2048 1024 DATA_END

如果数据卡在DATA_BEGIN后没有结束，通常是数组过大或者串口缓冲区没清空导致。可以减小SAMPLE_NUM，或者在发送前delayMicroseconds(500)让串口稳定。

5. 上位机显示与效果验证

固件能把数据发出来，接下来就是上位机的问题。ESP32-C3 示波器能不能好用，很大程度取决于上位机软件做得好不好。你可以选择开源串口绘图工具，也可以直接用 Python 读取串口并显示，后者便于集成到自己的测试系统里。

5.1 Python 串口波形显示

下面这段 Python 代码使用pyserial读取串口，调用matplotlib绘制波形。它会在收到s命令后等待数据，识别DATA_BEGIN与DATA_END之间的整数值，再把 ADC 原始值转换成电压值显示。

import serial import matplotlib.pyplot as plt PORT = "COM3" # Windows 使用 COM 口，Linux 用 /dev/ttyACM0 BAUD = 115200 ser = serial.Serial(PORT, BAUD, timeout=2) started = False values = [] ser.write(b"s") for line in ser: line = line.strip().decode("utf-8", errors="ignore") if line == "DATA_BEGIN": started = True values = [] continue if line == "DATA_END": started = False break if started: values.append(int(line)) ser.close() if values: voltage = [v * 3.3 / 4095 for v in values] plt.plot(voltage) plt.xlabel("sample index") plt.ylabel("voltage (V)") plt.title("ESP32-C3 oscilloscope capture") plt.grid(True) plt.show() else: print("no data received")

跑这段代码之前，需要先在终端确认串口名。如果开发板插入后没有任何串口，可能是 USB 驱动没装好，也可能是数据线不支持数据传输。判断方法很简单：打开设备管理器看有没有新串口，没有就换线或者换 USB 口。

5.2 波形验证：方波与正弦

启动上位机后，第一件事不是直接测实际电路，而是先接已知测试源校准。最常见的方式是用另一块开发板输出 PWM 方波。

用 ESP32 输出 1 kHz、50% 占空比、3.3 V 方波的代码非常简单：

void setup() { pinMode(2, OUTPUT); } void loop() { digitalWrite(2, HIGH); delayMicroseconds(500); digitalWrite(2, LOW); delayMicroseconds(500); }

将 ESP32-C3 示波器的输入接到输出引脚，共地后触发采集。正常情况应看到 0 V 和 3.3 V 两个平台，周期约为 1 ms。如果波形频率显示两倍，说明代码里读取间隔比预期小，导致一个实际周期被拆成两个显示周期；如果幅度不到 3.3 V，可能因为分压电阻选择不当或者接线太长。

用手机耳机孔输出 1 kHz 正弦测试信号也可以。由于 ESP32-C3 的输入范围和音频信号叠加了直流偏置，你看到的可能不是以 0 V 为中心的纯正弦，而是被抬升后的波形。这是正常的，上位机可以再做一次直流偏移修正。

5.3 功能验证标准

判断整个系统是否跑通，不是看一次波形，而是看同一信号多次触发的稳定性。如果每次采集都能稳定看到同一个相位位置，说明触发逻辑基本可用；如果波形左右漂移，那是因为采样时间基准和外部信号不同步，需要在上位机加入同步处理。

5.4 与商用示波器的同场景对比

很多人在上手自制的 ESP32-C3 示波器后，会拿它和实验室里的泰克 1012、鼎阳系列示波器做对比。对比时注意看三点：首先是带宽，商用示波器能显示 100 MHz 方波细节，ESP32-C3 只能看到平滑波形；第二是触发方式，商用示波器有边沿、脉宽、视频等丰富触发，ESP32-C3 只能靠软件扫描找最大最小值；第三是存储深度，商用示波器能保存很长的波形，ESP32-C3 受内存限制只能取有限个采样点。

但这不代表 ESP32-C3 示波器没有意义。很多调试场景不需要高带宽，比如调试 I2C 时钟频率是否在规格范围内，看 GPIO 翻转是否卡死，检查 PMW 占空比是否因为中断误触发而抖动。这些场景用 ESP32-C3 示波器已经足够，而且成本远低于一台入门商用示波器。

6. 信号测量效果与计量边界

6.1 为什么高频波形上升时间会“大一倍”

示波器测上升时间，很大程度上由采样率和前端放大器的压摆率共同决定。如果有人用 ESP32-C3 示波器测量一个高速信号的上升时间，测出来的值比数据手册的理论值大一倍，这个现象非常常见。原理很简单：数字示波器相邻两个采样点之间的时间隔太长，而真实信号的上升沿恰好夹在两个采样点中间，显示出来的波形就呈现出一个更缓的斜坡。

所以这类项目里谈“上升时间”没有绝对意义。如果你想粗略判断信号有没有异常，可以用同一套系统测两块不同的开发板，靠相对比较来判断；不要拿 ESP32-C3 测到的上升时间当作严肃计量数据。

6.2 I2C 波形干扰检查

ESP32-C3 示波器在 I2C 调试场景里有实用价值。I2C 信号本身频率不高，通常在几十 kHz 到几 MHz 之间，SCL 和 SDA 的低电平逻辑很容易通过 ADC 分辨。你可以同时把 SCL 接入 GPIO0，SDA 接入另一个 ADC 通道，固件改成双通道采样，上位机显示两条波形。

实际抓 I2C 波形时，重点是看低电平和起始位。I2C 起始位是 SCL 高电平期间 SDA 从高到低的下降沿，如果看到 SDA 线上有毛刺，或者在数据速率确认时波形不干净，可以判断是上拉电阻选得过大、总线电容过大，或者从机拉低时间不够。用 ESP32-C3 抓这些低频问题足够直观。

6.3 电源纹波测量要注意什么

测量电源纹波是另一个常见需求。直接把示波器探头接到电源输出端，往往看到的不是真实的纹波，而是探头地线夹引入的噪声。ESP32-C3 示波器同样存在这个问题。接线时要让输入地尽量靠近被测电源的输出电容两端，避免地线环过大。

测量前先用万用表确认被测电压不超过前端分压的安全范围。如果被测点是 12 V 电源，分压比不够，会把芯片打坏。先降低期望，第一次只测 3.3 V LDO 的纹波，验证读数稳定后，再考虑测量更高电压。

7. 测量自动化、批量采集与接口服务化

7.1 连续采集与自动触发

普通示波器只能手动点一次采集一次，但实际测试中经常需要“等到某个电平出现再记录”。ESP32-C3 的优势是可以很容易做成自动化触发。上位机代码可以持续读串口数据，当检测到电压低于某个阈值后开始记录，再把这段时间的数据保存到文件。

下面是一段 Python 自动化触发流程的伪代码，适合你自己扩展：

import serial SAMPLE_THRESHOLD = 0.5 # 电压阈值 SAMPLE_COUNT = 512 def wait_and_capture(ser): started = False values = [] while len(values) < SAMPLE_COUNT: line = ser.readline() if not line: continue try: v = int(line) * 3.3 / 4095 except ValueError: continue if not started and v < SAMPLE_THRESHOLD: started = True if started: values.append(v) return values

这种捕获逻辑适合脉冲测试、异常电压记录、掉电时序检查等场景。比商用示波器灵活的地方在于你可以把这套脚本接入生产测试流程，比如按下按键后自动保存若干组波形到指定文件夹。

7.2 通过串口或 WebSocket 封装 API

如果你想让其他程序也能获取波形，可以给固件加一个简单的串口命令协议。例如电脑发送r表示读取当前采样，发送c清除缓冲区，发送f 1000设置采样频率。上位机层面再把串口命令包装成 HTTP API 或者 Python 函数。

这里给出一种 API 服务化设计思路，不依赖具体框架：

采集服务进程： 1. 启动后连接 ESP32-C3 串口 2. 循环接收传感器信号或人工触发 3. 将波形保存为 JSON 或 CSV 4. 提供 HTTP 接口：GET /wave/latest 5. 业务系统调用接口拿到最新波形数据

{ "channel": 0, "adsr": 1, "sample_num": 1024, "voltage_max": 3.29, "voltage_min": 0.01 }

只要固件和上位机的通信协议固定，ESP32-C3 示波器就能接入到你的现有测试平台。这个能力是单片机示波器优于很多商用简易设备的点，适合做产线自动测试、长时间数据记录和远程观测。

7.3 批量波形采集与文件管理

批量任务并不是只能保存在一个 CSV 里。更好的做法是每次采集都生成一个独立文件，文件名包含日期、通道号和测试编号，方便后续分析。采集脚本的目录结构建议如下：

./data/ 2025-01-01/ ch0_run0001.csv ch0_run0002.csv ... meta.json

批量采集时最容易遇到的问题是串口缓冲溢出。如果上位机读取速度跟不上芯片发送速度，会丢数据。实践中建议把发送速度调慢，每次只发 512 个点，上位机收完再发下一批，这样比一次发几千点更稳定。

8. 资源占用与性能观察

多数人拿到一块 ESP32-C3 开发板后，第一反应是“这板子内存很小，能存多少波形”。ESP32-C3 的片上 RAM 一般在几百 KB 级别，但 Arduino core 启动后能用的连续内存要比理论值小很多。如果把采样数组直接定义成全局变量，最高能存多少点取决于同时运行的其他功能。这里有几种非常影响内存的用法：

• 同时开启 Wi-Fi 和 BLE，内存占用明显上升；
• 使用 Arduino 的 String 类型频繁拼接，内存碎片会越来越大；
• 串口波特率高时，发送缓冲区若配置过小会丢数据。

建议固件里把所有采样点保存为uint16_t或uint32_t数组，不要在采样循环里做字符串转换。需要发数据时，先发一个启动标记，再一次性把整块数组内容写入串口。在上位机端再做电压转换，这样能最大化减轻芯片开销。

Wi-Fi 场景下，建议只保留一个 Wi-Fi TCP 或 WebSocket 连接。固件太弱，传输带宽多少会限制帧率。把采样和发送分成两个状态机：采样时关闭发送或者强制 CPU 占用；发送时停止采样。不要想同时高速采样又高速传输，C3 没那么强。

判断当前固件性能是否合理，可以通过输出实际循环耗时来看。用micros()记录一次完整采集任务所需的时间，再除采样点数，就能得到近似平均采样间隔。不要靠感觉调参，用这个数据做对比。

上线后建议开启核心日志并观察复位原因。如果出现定时器看门狗复位或任务看门狗复位，说明单个循环里被死等太久，需要把耗时操作移到后台任务，并在关键位置vTaskDelay让出 CPU。

9. 常见问题与排查方法

如果你测试时发现测上升时间比平时大一倍，最可能的两个原因就是采样率不足和前端电阻电容形成了低通滤波。要验证这点，降低信号频率后如果显示正常，就说明是被测频率超出了当前采样能力。

10. 最佳实践与测量安全

第一次开板，先用小信号和低频信号测试，不要直接去测电源管理模块或者电机驱动板。准备几个固定电压点，比如 1.65 V、3.3 V、2.5 V，先验证 ADC 换算逻辑准确。对这个项目而言，降低预期不是坏事，稳定能用的工具比纸面指标高但抓不到数据的工具更有价值。

焊接前端电路时，尽量把分压电阻靠近开发板焊接，不要用长杜邦线飞线。ADC 输入是高阻接口，长线容易捡到开关电源噪声和 Wi-Fi 干扰，导致波形显示一团噪声。如果出现干扰，可以尝试给采样引脚并联一个 100 pF 到 1 nF 的电容，但要注意这会降低信号带宽，仅对低频测量有利。

接入被测系统前，先测量三个电压：被测信号最大电压、开发板供电电压、两个系统之间的地电位差。所有测量都应在开发板断电时完成接线，上电后再插信号线。如果信号源可能突然产生尖峰，可以在信号线上串联一个 10 kΩ 电阻，牺牲一点带宽换安全。

如果你想把波形数据保存成图片用于博客或者报告，注意在标注里写明是 ESP32-C3 低成本示波器采集，不要让人误以为是商用高带宽示波器结果。代码和固件建议放到版本仓库里管理，做到同一个测试板能复现相同测试，而不是每次手工调参数。

遇到批量采集需求时，加入简单的错误重试机制：如果 2 秒内没收到 DATA_END，就重新发一次触发命令。批量任务不要只保存在内存，采集完马上写入文件，否则异常退出时全部数据都会丢失。保存策略坚持“先完整采样、再格式化写入”，不要边采边写，避免串口读写阻塞采样。

有一点尤其重要：如果你的 ESP32-C3 示波器接入了私有通信总线的数据，抓到 I2C 数据或者 UART 数据后，如果涉及个人信息或版权代码，要注意数据使用的边界。不要把自己抓到的总线数据用于未授权场景。调试别人设备时先确认是否拥有测试授权。

11. 总结与下一步

ESP32-C3 示波器这个项目最值得尝试的一点，是它让“示波器”变得不再神秘。整条链路从引脚采样到上位机画图，每一步都可以用代码解释清楚，这对理解数字示波器的采样、触发和存储概念非常有帮助。如果只是为了看到波形，最初的 Arduino 加串口方案已经足够。

拿到板子的第一轮测试建议从 1 kHz 方波开始，验证电压精度和采集稳定，然后逐步加大采样点数，尝试加入触发和批量保存。最容易踩的坑是前端接线和共地问题，以及把采样率预期放得太高。遇到波形不对时先检查接线和电源，而不是先怀疑代码。

下一步可以做的事情不少：把采样数据改成 DMA 连续传输，加入双通道支持，把上位机从串口脚本升级为 WebSocket 实时网页，或者封装一个 HTTP 接口接入自己的测试平台。硬件端也可以尝试外置高速 ADC 芯片来提升带宽，但那时系统的调试重点会从软件转移到模拟前端设计。

先把基础链路跑通，再按需扩展，这个方向不会错。如果正在做一个 I2C 传感器调试或者 PWM 电机控制项目，建议把这个小工具当成备用示波器放在手边，会比自己用万用表盲猜省很多时间。