4. UWB设备固件开发环境搭建
好，咱们正式开始动手了。这一章我带你搭开发环境。
很多初学者一上来就急着写代码，结果编译报错半天找不到原因——八成是环境没配好。我当年第一次用Keil时，连芯片包都没装就点了编译，那错误刷了满屏。嗯，咱们别走弯路。
本章核心目标：装好IDE、拿到SDK、跑通第一个例程、会用调试器。一套下来，你就能在硬件上跑UWB测距了。
4.1 IDE选型：Keil、IAR、Arduino IDE怎么选？
目前UWB定位设备的主流方案，MCU大多是STM32或Nordic系列。对应的IDE也就那几款。我列个表，你一看就明白。
| IDE | 适用芯片 | 优点 | 缺点 |
|---|---|---|---|
| Keil MDK | ARM Cortex-M全系列 | 生态最全、例程多、编译快 | 代码大小限制（免费版32KB） |
| IAR EWARM | ARM Cortex-M全系列 | 优化强、调试功能丰富 | 界面老旧、许可证贵 |
| Arduino IDE | 部分STM32/ESP32 | 上手快、社区资源多 | 调试弱、不适合量产项目 |
我个人习惯用Keil。为什么？因为DW1000和STM32的官方SDK基本都是Keil工程，拿来就能用。IAR也不错，但如果你刚入门，我建议先选Keil。
我的建议：如果只是验证UWB模块能不能通信，Arduino IDE也能凑合。但要做产品级固件，老老实实用Keil或IAR。
4.2 Keil MDK安装与配置
咱们以Keil为例，走一遍完整流程。
4.2.1 下载与安装
- 去Keil官网下载MDK-Arm最新版（目前是5.38）。
- 双击安装，一路Next。注意安装路径不要有中文。
- 安装完成后，打开Keil uVision5。
4.2.2 安装芯片包
这一步很多人会忘。Keil本身不带芯片支持包，你得单独装。
- 点击菜单栏 Pack Installer 图标。
- 搜索你用的MCU型号，比如STM32F103或STM32L4系列。
- 点击 Install，等它下载完成。
注意：芯片包版本要和SDK匹配。我曾经遇到过SDK要求用2.0.0的包，我装了2.1.0，结果编译报了一堆结构体对齐错误。折腾了半天才发现是版本不兼容。
4.2.3 配置编译器和调试器
装好之后，还要告诉Keil用哪个编译器、哪个调试器。
- 打开 Project → Options for Target。
- 在 Device 标签页确认芯片型号选对了。
- 在 Debug 标签页选择调试器：J-Link或ST-Link。
- 在 Utilities 标签页同样选好调试器，用于下载。
4.3 SDK获取与导入
SDK是芯片厂商或模块厂商提供的开发包。UWB定位常用的SDK有几种：
| SDK名称 | 来源 | 适用芯片 | 包含内容 |
|---|---|---|---|
| DW1000 SDK | Decawave官方 | DW1000 + STM32 | 驱动、测距例程、API文档 |
| STM32Cube FW | ST官方 | STM32全系列 | HAL库、中间件、例程 |
| Nordic nRF5 SDK | Nordic官方 | nRF52系列 | BLE协议栈、UWB驱动 |
4.3.1 获取SDK
以DW1000 SDK为例：
- 去Decawave官网（或Qorvo官网）注册下载。
- 解压后你会看到
dw1000_api、examples、platform等文件夹。
4.3.2 导入Keil工程
SDK里一般自带Keil工程文件（.uvprojx）。直接双击打开就行。
如果SDK没有现成工程，你需要手动建一个：
- 新建一个Keil工程，选好芯片型号。
- 把SDK的源文件（.c）和头文件路径加进去。
- 在 C/C++ 标签页的 Include Paths 里添加所有头文件目录。
小技巧：我习惯把SDK的源文件按功能分组，放到不同的文件夹里。比如 Driver、App、Platform。这样工程结构清晰，后期维护也方便。
4.4 编译与烧录流程
环境搭好了，SDK也导入了。接下来就是编译和烧录。
4.4.1 编译
- 点击Keil的 Build 按钮（或按F7）。
- 看底部的 Build Output 窗口。如果显示
0 Error(s), 0 Warning(s)，恭喜你。 - 如果有错误，双击错误信息，Keil会自动跳转到出问题的代码行。
常见编译错误：
- “undefined symbol”：某个函数没定义。检查源文件有没有加进工程。
- “cannot open source input file”：头文件路径没加对。去Include Paths里补上。
- “error: #5”：语法错误。多半是少了个分号或括号。
4.4.2 烧录
编译通过后，把固件下载到芯片里。
- 用J-Link或ST-Link连接开发板。注意接线：SWDIO、SWCLK、GND，这三根线必须接。
- 点击 Download 按钮（或按F8）。
- 如果下载成功，底部会显示
Flash Download Complete。
我第一次烧录时，板子死活连不上。后来发现是SWDIO和SWCLK接反了。嗯，这种低级错误，犯过一次就记住了。
4.5 调试工具使用：J-Link与ST-Link
烧录只是第一步。真正开发时，调试才是重头戏。
4.5.1 J-Link vs ST-Link
| 特性 | J-Link | ST-Link |
|---|---|---|
| 速度 | 快（最高50 MHz） | 中等（最高4 MHz） |
| 兼容性 | 支持几乎所有ARM芯片 | 仅支持ST芯片 |
| 价格 | 贵（正版几百到上千） | 便宜（几十块） |
| 调试功能 | 断点、单步、变量监视、RTT | 断点、单步、变量监视 |
我个人推荐J-Link。虽然贵一点，但RTT（实时传输）功能在调试UWB通信时特别好用。你可以一边跑测距，一边看日志，不用串口线。
4.5.2 调试操作
在Keil里调试很简单：
- 点击 Debug 按钮（或按Ctrl+F5）。
- 程序会停在
main()的第一行。 - 用 Step Over（F10）单步执行，用 Step Into（F11）进入函数内部。
- 在 Watch 窗口添加变量，实时查看它的值。
调试UWB时的常用技巧：
- 在测距函数入口和出口各加一个断点，看能不能跑进去。
- 用 Call Stack 窗口看函数调用关系，排查死循环。
- 如果程序跑飞了，检查堆栈指针（SP）和程序计数器（PC）的值。
4.6 本章知识体系总览
下面这张图，把整个开发环境搭建的流程串起来了。你可以把它当路线图用。
4.7 避坑指南
最后，我把自己踩过的坑列出来。你遇到了直接对照，能省不少时间。
- 芯片包版本不匹配：我曾经用SDK里的旧工程，配了新版的芯片包，结果编译报错。解决办法：去Pack Installer里装SDK要求的版本。
- 调试器驱动没装：J-Link和ST-Link都需要装驱动。插上调试器后，如果电脑没识别，去官网下载驱动。
- 烧录时提示“No Cortex-M SW Device Found”：八成是接线问题。检查SWDIO、SWCLK、GND三根线，再检查板子有没有上电。
- 编译通过但运行不正常：先检查晶振配置对不对。UWB对时间精度要求高，晶振不对，测距全是错的。
一句话总结：环境搭建不难，但细节多。按流程走，每一步确认没问题了再往下。跑通第一个例程后，你会觉得——嗯，也就这么回事。