调试环境搭建：硬件连接、电源、示波器、逻辑分析仪、调试器
做硬件调试，头一件事不是写代码，而是把台子搭稳。我见过太多朋友，代码写得挺漂亮，结果板子上电就冒烟，或者信号根本抓不到。说白了，调试环境就是你的主战场，设备没接对，后面全是瞎忙活。
1. 硬件连接——先把路打通
连接之前，先看看板子的供电需求。我习惯先量一下主电源对地阻抗，别上来就插电。用万用表的二极管档，正极接地，负极接电源，正常应该在几百欧到几千欧。如果直接短路——嗯，那我建议你先别上电，查查焊接。
- 核心连接清单：电源线（注意正负极）、调试器（JTAG/SWD）、串口（TX/RX/GND）、备用IO引出。
- 地线是命根子：所有测试设备的地线必须与板子共地。我用示波器时，经常先夹一个地线夹在板子的GND测试点上。
- 线缆长度：高速信号线尽量短，超过10cm就可能反射。我曾经在一次I2C调试中，因为杜邦线太长，数据死活读不对，换了绞合线立马解决。
小经验：调试时我通常先只接最小系统：MCU + 电源 + 调试器 + 一颗LED。外围器件都断开，等核心跑起来再一个个挂上。
2. 电源——别让“电”坑了你
很多新手上来就用可调电源调到3.3V直接怼。这么做其实有点危险。我建议先空载调好电压，再通过限流功能把电流限制在200mA左右。万一板子有短路，电流一超就自动截断，至少不烧片子。
| 电源场景 | 推荐设置 | 注意事项 |
|---|---|---|
| 首次上电 | 电压设定值 + 限流50mA | 电流突增立即断电，排查短路 |
| 正常运行 | 电压标称值 + 限流略大于峰值 | 用万用表串测实际电流 |
| USB供电 | 5V / 500mA | 注意USB线压降，长线可能掉到4.5V |
注意：板子上的LDO（低压差线性稳压器）输出端一定要加电容，至少10µF钽电容+100nF瓷片。空载时电压可能跳动，我曾经因为这个原因误判了ADC采样值整整半天。
3. 示波器——眼睛要亮
示波器是调试的“眼睛”。你想想看，一个方波在探头端是完美的，到了芯片引脚却圆了，这说明什么？要么探头补偿没调，要么走线寄生电容太大。
我常用的四步操作：
- 探头补偿：把探头接到自带的1kHz方波测试端，调整补偿电容，直到屏幕上方波直角清晰，没有过冲或圆角。
- 地线最短：用弹簧地线，别用长鳄鱼夹。长地线会引入噪声，尤其测量高频信号时。
- 垂直档位：先设到1V/div，再根据信号幅度微调。别让信号顶到屏幕顶部，留20%余量。
- 触发设置：边沿触发，电平设在信号幅度的50%处。我习惯把触发模式设成“正常”，避免自动触发乱抓信号。
重要原则：示波器的带宽应该是被测信号最高频率的5倍。测10MHz的SPI时钟，至少用50MHz带宽的示波器，否则上升沿会失真。
4. 逻辑分析仪——看时序的好帮手
逻辑分析仪和示波器是搭档。示波器看电压波形，逻辑分析仪看数字时序。我调试SPI或I2C的时候，两个一起上：逻辑分析仪捕获时序，同时示波器抓某个引脚的信号质量。
常见的逻辑分析仪设置：
- 采样率：至少是总线时钟的4倍，推荐8倍。比如SPI时钟10MHz，采样率设到80MHz以上。
- 触发通道：可以用片选信号作为触发源，下降沿开始捕获，这样每次通讯的起始帧不会漏。
- 解码协议：设置好SPI模式（CPOL/CPHA）、I2C地址、UART波特率。有一次我忘了设置停止位位数，解码出来的数据全是乱码，折腾了半小时才发现。
实用技巧：调试I2C时，把SCL和SDA同时接入逻辑分析仪，用“触发条件”设置成SDA下降沿且SCL高电平——这就是起始条件。捕获后直接看协议解码，比数波形快多了。
5. 调试器——打通MCU的任督二脉
调试器（比如J-Link、ST-Link、DAPLink）负责把PC和MCU连起来。我建议优先用SWD接口，只用两线（SWDIO + SWCLK）加一个GND，比JTAG（4线）省引脚，而且速度一样可以跑到10MHz以上。
连接注意：
- SWDIO上拉：部分MCU的SWDIO需要4.7kΩ上拉到3.3V，否则调试器可能识别不到芯片。我曾在第一次用GD32时踩过这个坑，加了上拉立马解决。
- SWCLK下拉：有些调试器要求SWCLK对地接10kΩ下拉，防止浮空时误触发。
- 复位信号：如果调试器有nRST引脚，接上它，这样可以在连接失败时硬件复位芯片。我调试时经常用这个功能，省得每次都拔电。
// 调试器连接检查示例（使用OpenOCD）
openocd -f interface/jlink.cfg -f target/stm32f4x.cfg
// 成功输出应包含：target halted due to debug-request
// 如果报错：Error: init mode failed，先检查硬件连接6. 整张调试环境关系图
下面这张图可以帮你理清各个设备之间的连接关系——电源怎么进，信号怎么走，调试器控制什么。我每次搭建新平台时都会照这个结构过一遍。
再提醒一次：不要同时给板子供电又插USB，可能通过地环路烧毁USB口。我习惯只用一路供电，调试器通过SWD供电也尽量不用，除非确认板子功耗特别小。
好了，设备都接好、电源也调对之后，下一步就可以上电检查时钟复位了。记住：环境搭得好，后面少烦恼。