2. 开发环境搭建：Keil/IAR环境配置、STM32CubeMX初始化、UWB驱动库移植
说实话，做UWB定位开发，环境搭建这一步看着简单，但坑是真不少。我见过太多人卡在编译报错上，一查发现是工具链版本不对，或者驱动库路径没配好。这一章咱们就把这些基础打扎实。
我会带着你走完三个核心环节：IDE配置、CubeMX初始化、驱动库移植。每一步我都会告诉你哪些地方容易翻车，以及我自己的处理习惯。
本章核心目标：让STM32能正确编译UWB驱动库，并通过SPI与DWM1000/DW1000模块正常通信。
2.1 开发工具选型与版本匹配
先说说工具链的选择。我个人习惯用Keil MDK，因为它的调试器支持比较全，尤其是搭配J-Link时，单步跟踪UWB驱动非常方便。但如果你做的是量产项目，IAR的代码优化能力确实更强一些。
这里有个关键点——版本匹配。我踩过一个大坑：用Keil 5.36编译DW1000官方驱动，结果报了一堆“implicit declaration”警告。后来发现是ARM Compiler版本从6升级到了6.18，对C99标准的检查更严格了。
| 工具 | 推荐版本 | 注意事项 |
|---|---|---|
| Keil MDK | 5.35 ~ 5.38 | ARM Compiler选V5或V6.16+；V6.18以上需加--c99 |
| IAR EWARM | 8.40 ~ 9.30 | C/C++ Compiler选C11标准；优化等级建议High |
| STM32CubeMX | 6.8.0 + | 固件包版本与IDE的Device Family Pack对齐 |
| J-Link / ST-Link | 驱动V7.60+ | SWD速率建议4MHz，过高会导致UWB时序干扰 |
我的小技巧：在Keil里同时保留AC5和AC6两个编译器。AC5用来编译UWB驱动库（兼容性好），AC6用来编译应用层代码（代码密度小）。在工程选项里分别指定即可。
2.2 STM32CubeMX初始化——SPI与中断配置
UWB模块和MCU之间走的是SPI通信。你想想看，DW1000的SPI时钟最高能到20MHz，但STM32F1系列跑到18MHz就容易丢数据。为什么会这样？因为SPI时序的建立时间和保持时间没对齐。
下面是我在项目中验证过的CubeMX配置步骤：
- 选择MCU型号——我常用STM32F407VET6（主频168MHz，有4个SPI）或STM32F103C8T6（低成本方案）。
- 配置时钟树——HSE外部晶振8MHz，PLL倍频到168MHz（F4）或72MHz（F1）。APB2时钟不要超过84MHz，否则SPI分频后频率不准。
- SPI配置——选Full-Duplex Master模式，数据大小8位，CPOL=0、CPHA=0（模式0）。
- 中断配置——DW1000的IRQ引脚接EXTI中断，下降沿触发。优先级建议设为1（比系统滴答高，比DMA低）。
- GPIO配置——CS片选用推挽输出，RST复位引脚用开漏输出（配合外部上拉）。
/* SPI配置代码片段（HAL库） */
SPI_HandleTypeDef hspi2;
void MX_SPI2_Init(void)
{
hspi2.Instance = SPI2;
hspi2.Init.Mode = SPI_MODE_MASTER;
hspi2.Init.Direction = SPI_DIRECTION_2LINES;
hspi2.Init.DataSize = SPI_DATASIZE_8BIT;
hspi2.Init.CLKPolarity = SPI_POLARITY_LOW;
hspi2.Init.CLKPhase = SPI_PHASE_1EDGE;
hspi2.Init.NSS = SPI_NSS_SOFT;
hspi2.Init.BaudRatePrescaler = SPI_BAUDRATEPRESCALER_8;
hspi2.Init.FirstBit = SPI_FIRSTBIT_MSB;
hspi2.Init.TIMode = SPI_TIMODE_DISABLE;
hspi2.Init.CRCCalculation = SPI_CRCCALCULATION_DISABLE;
hspi2.Init.CRCPolynomial = 10;
if (HAL_SPI_Init(&hspi2) != HAL_OK)
{
Error_Handler();
}
}注意：DW1000的SPI时序要求CS拉低后至少等待200ns才能发送第一个时钟。STM32的SPI硬件不会自动插入这个延迟。我曾在F103上遇到过连续读寄存器出错，后来在CS拉低后加了一个NOP延时才解决。
2.3 UWB驱动库移植——从官方包到工程
Decawave官方提供了DW1000的驱动库，包含dw1000.c、dw1000_regs.h等文件。但直接复制到工程里是跑不起来的——你需要做三件事：
- 移植SPI读写接口——把库里的
writetospi()和readfromspi()替换成HAL库的HAL_SPI_TransmitReceive()。 - 移植延迟函数——库里的
deca_sleep()依赖硬件定时器，我一般用DWT计数器实现微秒级延时。 - 移植中断处理——DW1000的中断标志位需要在
dwt_isr()里轮询清除。
嗯，这里要注意一个细节：官方库的port_platform.h里定义了#define DECA_IRQ_HANDLER，这个宏必须和你工程里的中断服务函数名一致。我习惯写成EXTI9_5_IRQHandler，然后在里面调用dwt_isr()。
/* SPI读写接口移植示例 */
int writetospi(uint16_t headerLength, const uint8_t *headerBuffer,
uint32_t bodyLength, const uint8_t *bodyBuffer)
{
uint8_t txBuf[512];
uint8_t rxBuf[512];
uint16_t totalLen = headerLength + bodyLength;
memcpy(txBuf, headerBuffer, headerLength);
memcpy(txBuf + headerLength, bodyBuffer, bodyLength);
HAL_GPIO_WritePin(SPI_CS_GPIO_Port, SPI_CS_Pin, GPIO_PIN_RESET);
/* 插入200ns延时 */
for(volatile int i=0; i<5; i++);
HAL_SPI_TransmitReceive(&hspi2, txBuf, rxBuf, totalLen, HAL_MAX_DELAY);
HAL_GPIO_WritePin(SPI_CS_GPIO_Port, SPI_CS_Pin, GPIO_PIN_SET);
return 0;
}避坑指南：我曾经在移植时忘记修改dwt_config.h里的晶振频率。DW1000默认使用38.4MHz外部晶振，但我的板子上焊的是19.2MHz。结果测距误差直接飙到5米。后来在dwt_config.h里把DWT_XTAL_FREQ改成19200000就正常了。
2.4 工程结构组织与编译验证
我个人习惯把UWB驱动库单独放在一个文件夹里，和HAL库、应用层代码分开。这样升级驱动版本时只需要替换一个文件夹，不会影响其他代码。
Project/
├── Core/
│ ├── Inc/ (应用层头文件)
│ └── Src/ (main.c, uwb_app.c)
├── Drivers/
│ ├── STM32F4xx_HAL_Driver/
│ └── CMSIS/
├── UWB_Driver/
│ ├── dw1000.c
│ ├── dw1000_regs.h
│ ├── port_platform.h
│ └── deca_device_api.h
└── MDK-ARM/ (Keil工程文件)编译前记得检查三个地方：
- 头文件路径是否包含
UWB_Driver/目录 - 宏定义
DWT_USE_SPI是否已开启 - 优化等级是否设为-O0（调试阶段）或-O2（发布阶段）
我第一次编译时遇到undefined reference to `deca_sleep'，找了半天发现是port_platform.c没加到工程里。这种低级错误，你检查一下文件列表就能避免。
2.5 知识体系总览
下面这张图把本章的核心逻辑串起来了。你可以把它当作搭建环境时的检查清单：
这张图从工具链安装开始，到最终读取DW1000设备ID结束。你跟着这个流程走一遍，基本不会漏掉关键步骤。如果卡在某个环节，回头看看是编译器版本不对，还是SPI时序没调好。
验证方法：编译下载后，在main函数里调用dwt_check_dev_id()。如果返回0xDECA0130，说明驱动移植成功。如果返回0xFFFFFFFF，八成是SPI通信没通——检查接线和时钟配置。
环境搭建这块，说白了就是细心活。工具链版本、CubeMX配置、驱动移植，每个环节都环环相扣。你只要按照上面的步骤来，再注意我提到的那些坑，应该半小时内就能跑通。