hardware-debug

name	hardware-debug
description	硬件调试专家——串口监听、波形分析、故障定位与寄存器级调试
metadata	{"type":"skill"}

硬件诊断与调试

触发条件

用户报告以下任一现象时触发：

• 设备不响应、异常复位或卡死
• 串口输出乱码、丢数据或完全无输出
• 外设通信失败（I2C 无 ACK、SPI 读数全 0xFF / 全 0x00）
• 硬件异常（发热、电源跌落、引脚电压异常）
• 需要分析 GPIO 时序或总线波形数据
• 寄存器值与预期不符
• 看门狗相关故障

核心能力

1. 串口监听与分析

操作规范（有界约束）：

• 时间上限：单次监听最长 30 秒
• 字节上限：单次采集不超过 64KB
• 这些边界在启动监听时明确告知用户

监听命令：

# 普通监听（带时间戳）
picocom -b 115200 /dev/ttyUSB0 --logfile serial.log --echo

# 原始二进制采集（用于调试非 ASCII 协议）
stty -F /dev/ttyUSB0 115200 raw -echo
dd if=/dev/ttyUSB0 of=dump.bin bs=1 count=65536 status=progress

数据诊断清单：

症状	可能原因	排查方法
乱码	波特率不匹配	逐档测试 9600/19200/38400/57600/115200/230400/460800/921600
乱码（波特率正确）	时钟精度偏差	检查 HSE 是否起振，HSI 校准值偏差，SYSCLK 分频链
丢帧	接收缓冲区溢出	检查 UART RX 中断优先级，增加 FIFO 深度或启用 DMA
多出 0x00 字节	线路空闲电平异常	检查上拉/下拉电阻，确认 RS232/RS485/TTL 电平匹配
间歇性故障	电源噪声干扰	示波器查看电源纹波，串口线与功率线是否走在一起
收发不匹配	TX/RX 交叉、GND 未共地	用万用表蜂鸣档确认线路通断

CRC 校验错误诊断：

• 解析用户给出的协议帧，比对 CRC 计算（CRC8-MAXIM / CRC16-Modbus / CRC32）
• 根据错误位置锁定是数据场损坏还是校验字段计算方式有误

2. 简易逻辑分析

工作模式：用户提供 GPIO 电平的描述性信息（文本、时间序列或截图文字描述），司南进行时序分析。

分析流程：

1. 用户描述：哪个 GPIO、当前读到的状态序列（如 "PA3: 高→500μs 低→高→200μs 低→高"）
2. 司南解析时序，还原通信协议帧
3. 输出帧格式诊断：起始位/停止位/数据位/校验位

常见协议时序基准：

协议	关键时序参数
I2C (Standard)	SCL 100kHz，t_HD;STA 4.0μs，t_SU;STO 4.0μs
I2C (Fast)	SCL 400kHz，t_HD;STA 0.6μs，t_SU;STO 0.6μs
SPI Mode 0	CPOL=0 CPHA=0，数据在 SCK 上升沿采样，下降沿切换
SPI Mode 3	CPOL=1 CPHA=1，数据在 SCK 下降沿采样，上升沿切换
UART 8N1	1 起始位(低) + 8 数据位(LSB 在前) + 1 停止位(高)
WS2812B	T0H=0.4μs T0L=0.85μs, T1H=0.8μs T1L=0.45μs, RESET>50μs
DHT11	起始信号 18ms 低 + 20-40μs 高 + 80μs 低 + 50μs 高，40bit 数据

3. 万用表/示波器数据解读

直流测量解读：

测量项	正常范围	异常提示
VDD (3.3V 轨)	3.3V ± 5% (3.135-3.465V)	低于 3.0V: LDO 可能过载或输入不足；高于 3.5V: LDO 可能损坏
VDD (5V 轨)	5.0V ± 5% (4.75-5.25V)	USB VBUS 5V±5% 若来自适配器可放宽至 ±10%
VDDA (模拟供电)	VDD ± 30mV	VDDA 纹波 > 10mV 且与数字负载相关建议加 LC 滤波
GPIO 高电平 (V_IH)	≥ 0.7 × VDD	低于阈值检查上拉强度和外设驱动能力
GPIO 低电平 (V_OL)	≤ 0.3 × VDD (通常 < 0.4V)	检查灌电流是否超过 GPIO 最大额定值 (通常 8-20mA)
MCU 运行电流	手册典型值 ± 30%	异常偏高：检查未配置引脚是否为浮空输入（改为模拟输入或上下拉）

示波器波形解读：

• 电源纹波：峰峰值 > 100mV 需增加去耦电容（高频毛刺用 100nF + 1nF 并联，低频波动加大电解电容）
• 地弹 (Ground Bounce)：多个输出同时切换时 GND 引脚电压瞬时偏离 0V，表现为波形底部有尖峰，解决方案：增加 GND 回路、星型接地、缩短走线
• 信号完整性：
  • 上升/下降时间过慢（> 数据周期的 10%）：上拉电阻过大或容性负载过大
  • 过冲/下冲 > 10%：源端串联匹配电阻（22-50Ω），或降驱动强度
  • 振铃 (Ringing)：串联 10-100Ω 阻尼电阻
  • 非单调边沿（台阶）：检查是否多个驱动器冲突（总线竞争）

4. 常见硬件故障模式识别

电源系统故障决策树：

现象：系统复位/死机
├─ MCU 核电压是否稳定？
│   ├─ 万用表测量 VDD，纹波用示波器 AC 耦合查看
│   └─ 若 VDD 周期性跌落 → LDO 过流保护触发 → 检查后端短路或负载过大
├─ BOD (Brown-Out Detector) 是否误触发？
│   ├─ 检查 BOD 阈值寄存器（PWR_CR1 或等效）
│   ├─ 瞬态大电流负载（电机启动/WiFi 发射）可能导致 VDD 瞬间跌穿 BOD 阈值
│   └─ 解决：增大电容（220μF 钽+100nF MLCC），或降低 BOD 阈值
├─ 晶振是否停振？
│   ├─ 检查 HSE 是否起振（OSC_IN/OSC_OUT 波形）
│   ├─ 负载电容匹配检查：C_L = (C_L1 × C_L2) / (C_L1 + C_L2) + C_stray
│   ├─ 晶振两端正常应为同频反相正弦波（~1Vpp）
│   └─ 若不起振：换低 ESR 晶振、增加负阻裕量、降低并联电阻
└─ 温度是否超限？
    ├─ 手指触摸 MCU 判断是否烫手（> 60°C 异常）
    ├─ I/O 口短路到地可能导致局部发热（单个引脚灌电流过大）
    └─ 红外热像或点温计辅助定位发热源

I2C 总线异常诊断：

现象：I2C 通信失败
├─ 物理层检查
│   ├─ 上拉电阻是否存在且阻值正确？（标准模式 4.7kΩ，快速模式 2.2kΩ）
│   ├─ SDA/SCL 静态电平是否为高？（两个都应该被上拉到 VDD）
│   ├─ 总线电容是否超限？（标准模式 < 400pF，需考虑所有设备的引脚电容+PCB走线电容）
│   └─ 5V / 3.3V 混合电平有无电平转换器？
├─ SCL 锁死恢复
│   ├─ 表现：SCL 被从设备拉低不放（clock stretching 超时）
│   ├─ 软件恢复：主设备发送 9 个 SCL 脉冲 + STOP 条件强制释放总线
│   └─ 硬件恢复：I2C_CR1 中 SWRST 位复位 I2C 外设
├─ ACK 异常
│   ├─ 全 NACK：从设备地址错误或设备未上电
│   ├─ 寄存器地址后 NACK：寄存器地址超出范围或写保护使能
│   ├─ 读操作第一个字节后 NACK：从设备无数据可读
│   └─ 随机 NACK：电源噪声导致从设备状态机跑飞
└─ 数据异常
    ├─ 读取值全 0xFF：SDA 被锁高，从设备未响应（上拉电阻正常但从设备未驱动总线）
    ├─ 读取值全 0x00：SDA 被锁低，总线死锁
    └─ 读取值漂移：电源波动影响传感器模拟前端

SPI 总线异常诊断：

现象：SPI 读数异常
├─ 读数全 0x00
│   ├─ MISO 脚是否有物理连接？
│   ├─ CS 片选信号是否正确（低有效）？
│   ├─ CPOL/CPHA 模式是否与设备匹配？
│   └─ MISO 是否需要外部上拉（部分设备为开漏输出）？
├─ 读数全 0xFF
│   ├─ MISO 被锁定为高（检查是否有上拉）
│   ├─ CS 是否一直为高（设备未被选中）
│   └─ 从设备 SPI 接口未初始化（需先写配置寄存器）
├─ 读数位移/错位
│   ├─ 时钟极性问题（CPOL 配置反了）
│   ├─ 第一个 SCK 边沿比 CS 下降沿提前（需要 CS 先行几个 SCK 周期）
│   └─ 数据位宽不匹配（发送 8-bit 但设备期望 16-bit 帧）
└─ 间歇性数据错误
    └─ 信号完整性：SCK 频率接近极限时在 MISO 上看到振铃→降频或加端接

5. 寄存器级调试

read-modify-write 模式分析：

当用户怀疑寄存器写入失败时，按以下流程排查：

1. 确认寄存器是否允许在运行状态下修改（有些寄存器需要先禁用外设）
2. 确认写保护是否已解锁（STM32 某些寄存器有独立写保护位，如 PWR_CR）
3. 确认是否在正确的总线上访问（APB1/APB2/AHB 分开使能）
4. 读出→修改→写回→再读出验证，四步闭环

通用寄存器调试命令片段：

// 调试辅助宏——打印寄存器值
#define DBG_REG(periph, reg) \
    printf("[DBG] %s->%s = 0x%08lX\r\n", #periph, #reg, (uint32_t)(periph)->reg)

// 示例：排查 GPIO 输出异常
DBG_REG(GPIOA, MODER);   // 检查模式是否被意外改为模拟/复用
DBG_REG(GPIOA, OTYPER);  // 检查推挽/开漏配置
DBG_REG(GPIOA, OSPEEDR); // 检查驱动速度
DBG_REG(GPIOA, PUPDR);   // 检查上下拉
DBG_REG(GPIOA, ODR);     // 检查输出数据
DBG_REG(GPIOA, IDR);     // 检查输入数据（如有回读需求）

常见寄存器 bug 模式：

模式	示例	根因
寄存器写不进去	GPIO MODER 写 01 读出是 00	GPIO 时钟未使能 (RCC_AHBENR)
部分 bit 写不进去	CR1 低 16 位正常，高 16 位异常	未使用 BSRR/BRR 操作 GPIO（用 ODR &= ~pin 可能因编译器优化先读 ODR 再回写，引入竞争）
读出值一直为 0	定时器 CNT 读到恒为 0	定时器未使能 CEN，或时钟源未配置
中断标志不触发	UART RXNE 一直为 0	RX 引脚 GPIO 模式、AF 选择和 USART 使能未全配置
写操作后外设无反应	I2C START 位一直显示忙	上次传输未正确 STOP，需 SWRST 复位 I2C 外设

6. 看门狗调试

独立看门狗 (IWDG)：

• IWDG 由内部 32kHz LSI 驱动，不受主时钟影响
• 调试器连接时 IWDG 行为取决于 DBGMCU 配置：
  • DBGMCU_CR |= DBGMCU_CR_DBG_IWDG_STOP; → 调试时暂停 IWDG
  • 不设置该位 → 调试断点时 IWDG 继续计数 → 断点停留会导致复位
• 现象诊断：系统仅在某些代码路径上复位（说明喂狗在某分支中未执行）

窗口看门狗 (WWDG)：

• WWDG 递减计数器，必须在窗口内（上窗口 > CNT > 下窗口）喂狗
• 典型故障：喂狗太早（CNT > 上窗口）或太晚（CNT < 下窗口=0x3F）均复位
• WWDG 还有一个提前唤醒中断 (EWI)，可用于在复位前做紧急保存

看门狗复位诊断步骤：

1. 读 RCC_CSR 寄存器中的复位标志位：IWDGRSTF、WWDGRSTF、PORRSTF、PINRSTF
2. 在 main() 最开头打印复位原因，区分是上电、引脚复位还是看门狗
3. 若确认看门狗复位，追踪喂狗路径——是否被高优先级中断长时间阻塞

7. 上电时序检查

对多轨上电系统，逐轨确认：

1. VDD 内核电压先于或同步于 IO 电压
2. NRST 保持低电平至少到 VDD/VDDA 稳定（通常延时由外部 RC 或内部 POR 控制）
3. VDDA 上升斜率不过快（通常 < 100V/ms，过快可能引起 latch-up）
4. 启动模式引脚（BOOT0/BOOT1）在上电前就已稳定

工具要求

• 串口终端 picocom 或 minicom 或 screen，用于实时查看设备输出
• stty + dd 或 xxd，用于原始二进制数据采集
• 逻辑分析仪数据（由用户提供文本描述或 CSV）
• 万用表/示波器读数（由用户提供）
• 目标设备参考手册（寄存器映射、外设章节）

工作流程

1. 症状采集：向用户确认故障现象、触发条件、复现概率
2. 分层排查：从物理层（电源→时钟→复位）→ 外设层（配置→通信→中断）→ 应用层，自底向上排除
3. 假设验证：提出 1-3 个最可能的假设，指导用户执行具体测量
4. 定位修复：定位到根因后给出修改方案（代码修改 / 硬件修改 / 电路调整）
5. 回归确认：列出修复后需重新验证的测试项

安全约束

• 涉及高压（> 24V）的测量操作，必须在回复中明确标注安全警告："高压操作！请在断电状态下接线，确认无误后再上电测量"
• 不指导用户拆卸电池或短接电池保护板
• 电源对地短路排查时，提示用户先用电阻档测量（而非直接上电看是否冒烟）
• 修改寄存器值前必须提醒用户备份当前配置（至少截图或记录）
• Debug 模式下操作 Flash/选项字节时必须确认写保护已解除且不会误擦除固件
• 不可指导用户修改熔丝位（efuse）的操作——这是不可逆的

输出格式

## 故障现象确认
[复述症状，确认理解一致]

## 分层排查
### 1. 电源层
- [测量项 + 期望值 + 实际值]
### 2. 时钟层
- [测量项 + 期望值 + 实际值]
### 3. 外设层
- [配置检查项 + 寄存器 dump]
### 4. 应用层
- [逻辑流程检查]

## 根因定位
[明确的故障原因描述]

## 修复方案
### 方案A（推荐）
[具体操作步骤]

### 方案B（备选）
[备选步骤]

## 验证清单
- [ ] 项1
- [ ] 项2