3. SPI通信调试：SPI时序分析、寄存器读写验证、数据回环测试
SPI通信，说白了就是UWB模块和主控芯片之间的"对话通道"。通道不通，后面再好的算法也白搭。我见过不少项目，UWB芯片选型没问题，天线设计也过关，最后定位精度上不去——一查，SPI通信偶尔丢字节，导致测距数据错位。所以这一章，咱们把SPI调试这件事彻底讲透。
3.1 SPI时序分析——先看懂波形再说
拿到一块新的UWB模块，我个人的习惯是：先看时序图，再写代码。别急着上逻辑分析仪，先把芯片手册里的时序参数表读明白。
UWB芯片（比如DW1000、DWM3000）的SPI接口，通常支持Mode 0和Mode 3。区别在哪？看下面这张表：
| SPI模式 | CPOL（时钟极性） | CPHA（时钟相位） | 数据采样边沿 |
|---|---|---|---|
| Mode 0 | 0（空闲低） | 0 | 第一个边沿（上升沿） |
| Mode 1 | 0（空闲低） | 1 | 第二个边沿（下降沿） |
| Mode 2 | 1（空闲高） | 0 | 第一个边沿（下降沿） |
| Mode 3 | 1（空闲高） | 1 | 第二个边沿（上升沿） |
DW1000默认用Mode 0。但注意，有些国产UWB芯片兼容SPI Mode 3。我踩过这个坑——项目用到一款国产UWB芯片，手册写支持Mode 0，实际用逻辑分析仪抓出来，它是在下降沿采数据。后来发现是芯片内部有个配置位没设对。所以，别信手册，信波形。
时序参数关键点：
- SCLK频率：DW1000最高支持20MHz，DWM3000可以到38MHz。但实际布线长了，建议降到10MHz以下。
- CSN到SCLK建立时间：至少2ns，否则第一个字节可能错位。
- 数据保持时间：MISO数据在SCLK边沿后需要保持至少3ns。
怎么抓波形？我推荐用逻辑分析仪，采样率至少50MHz。别用示波器，4通道示波器抓SPI四根线（CSN、SCLK、MOSI、MISO）太费劲。逻辑分析仪一接，触发条件设成CSN下降沿，波形一目了然。
3.2 寄存器读写验证——从"能通"到"能控"
SPI波形对了，不代表寄存器读写就正确。我见过一个案例：波形完美，但读出来的寄存器值全是0xFF。后来发现是MISO引脚虚焊。所以，波形只是必要条件，寄存器验证才是充分条件。
寄存器读写验证，我习惯分三步走：
- 读芯片ID寄存器：每个UWB芯片都有唯一ID寄存器。比如DW1000的0x00地址，读出来应该是0xDECA0130。如果读出来是0xFFFFFFFF，说明SPI通信根本没建立。
- 写一个可读写的测试寄存器：比如DW1000的0x11地址（系统控制寄存器），先写0x00，再读回来确认。然后写0xFF，再读回来。确保每一位都能正确翻转。
- 读状态寄存器：比如中断状态寄存器，确认芯片内部状态机在正常跑。
下面是一段典型的SPI读写代码（以DW1000为例）：
// SPI写寄存器
void spi_write_reg(uint16_t header, uint32_t data, uint8_t len) {
uint8_t buf[5];
// 构造SPI帧头：2字节地址 + 1字节长度
buf[0] = (header >> 8) & 0xFF; // 高字节地址
buf[1] = header & 0xFF; // 低字节地址
buf[2] = len - 1; // 长度字段（DW1000协议）
// 数据部分
for (int i = 0; i < len; i++) {
buf[3 + i] = (data >> (8 * (len - 1 - i))) & 0xFF;
}
// CS拉低，发送
HAL_GPIO_WritePin(CSN_GPIO_Port, CSN_Pin, GPIO_PIN_RESET);
HAL_SPI_Transmit(&hspi1, buf, 3 + len, 100);
HAL_GPIO_WritePin(CSN_GPIO_Port, CSN_Pin, GPIO_PIN_SET);
}
// SPI读寄存器
uint32_t spi_read_reg(uint16_t header, uint8_t len) {
uint8_t tx_buf[3], rx_buf[3 + len];
tx_buf[0] = (header >> 8) | 0x80; // 读操作：最高位置1
tx_buf[1] = header & 0xFF;
tx_buf[2] = len - 1;
// CS拉低
HAL_GPIO_WritePin(CSN_GPIO_Port, CSN_Pin, GPIO_PIN_RESET);
HAL_SPI_TransmitReceive(&hspi1, tx_buf, rx_buf, 3 + len, 100);
HAL_GPIO_WritePin(CSN_GPIO_Port, CSN_Pin, GPIO_PIN_SET);
// 解析返回值
uint32_t val = 0;
for (int i = 0; i < len; i++) {
val = (val << 8) | rx_buf[3 + i];
}
return val;
}小技巧：调试阶段，每次读写寄存器后，都把返回值通过串口打印出来。我习惯在关键寄存器读写前后加打印，这样能快速定位是写错了还是读错了。
3.3 数据回环测试——验证整条链路
寄存器读写没问题，接下来要验证数据通路。回环测试，就是把UWB芯片的TX和RX引脚短接（或者通过内部回环模式），发一段数据，看能不能原样收回来。
DW1000内部有回环模式，配置寄存器0x0D（系统配置寄存器）的第3位即可。我建议分两种场景测：
- SPI回环：通过SPI写入一段数据到TX缓冲区，再读RX缓冲区，看数据是否一致。这验证的是SPI到芯片内部存储器的通路。
- 射频回环：配置芯片进入回环模式，发送一帧数据，芯片内部自动把TX数据路由到RX路径。这验证的是基带到射频再到基带的完整链路。
下面是我常用的回环测试流程：
- 配置芯片进入回环模式（写系统配置寄存器）。
- 构造一帧数据，写入TX缓冲区。我习惯用0x55、0xAA交替，这样容易在波形上看出来。
- 触发发送。
- 等待接收完成中断。
- 从RX缓冲区读数据，和发送数据逐字节对比。
注意：回环测试时，记得把天线断开，或者用衰减器。否则发射信号可能烧坏接收前端。我曾经有一次忘了断开天线，回环测试跑了半小时，芯片温度飙到70度——还好没烧。
回环测试通过，说明SPI通信、基带处理、射频链路都正常。这时候，你才能放心地进入下一步——测距协议调试。
3.4 知识体系总览
下面这张图，把SPI调试的完整流程串起来了：
3.5 常见问题与避坑指南
调试SPI这么多年，我总结了几条高频问题，你遇到了可以直接对照排查：
| 现象 | 可能原因 | 排查方法 |
|---|---|---|
| 读寄存器全是0xFF | MISO引脚虚焊或电平不匹配 | 用万用表测MISO引脚电压，逻辑分析仪看波形 |
| 写寄存器读回来不对 | SPI模式不匹配或时钟太快 | 降低SCLK频率，确认CPOL/CPHA |
| 回环测试数据错位 | 帧头构造错误或长度字段不对 | 对照手册检查SPI帧格式 |
| 偶尔通信失败 | CSN控制时序问题或中断冲突 | 检查CSN释放时间，关闭其他中断 |
我的调试习惯：准备一个"SPI调试工具包"——逻辑分析仪、杜邦线、3.3V稳压模块、串口转USB模块。每次调试新板子，先把这些工具摆好。别嫌麻烦，省下的时间远多于准备时间。
嗯，SPI调试这块，说白了就是耐心+细心。波形不对就调参数，寄存器不对就查手册，回环不过就逐段排查。别想着一步到位，UWB芯片的SPI接口没那么玄乎，但也没那么简单。把这一章的内容吃透，后面测距协议调试你会轻松很多。