用正点原子Nano开发板，5分钟搞定RT-Thread Nano的MDK5工程配置（附串口调试技巧）
正点原子Nano开发板极速上手RT-Thread实战指南
1. 开箱即用的开发环境搭建
刚拿到正点原子Nano开发板时，最令人兴奋的莫过于快速验证硬件是否正常工作。这款基于STM32F103RBT6的开发板，以其72MHz主频和丰富的外设资源，成为嵌入式入门学习的理想选择。我们先从最基础的开发环境配置开始：
必备工具清单：
- Keil MDK5开发环境（建议5.24及以上版本）
- ST-Link驱动（开发板自带调试器）
- PuTTY或其他串口终端工具
- 最新版RT-Thread Nano源码包
安装MDK5时有个小技巧：建议默认路径安装，避免中文目录。完成后，通过USB线连接开发板的"USB转串口"接口（注意不是ST-Link接口），Windows设备管理器会出现新的COM端口。
提示：若遇到驱动安装问题，可尝试先连接ST-Link接口，让系统自动识别调试器驱动。
2. 工程配置的黄金五分钟
打开MDK5工程是第一个关键步骤，但新手常在这里踩坑。我们从正点原子提供的BSP包开始：
bsp/stm32/stm32f103-atk-nano/project.uvprojx必须检查的三个配置项：
| 配置项 | 推荐值 | 检查要点 |
|---|---|---|
| Target选项 | STM32F103RB | 芯片型号必须完全匹配 |
| C/C++预定义宏 | USE_STDPERIPH_DRIVER | 确保启用标准外设库 |
| Debug配置 | ST-Link Debugger | 勾选Reset and Run选项 |
编译时若出现头文件缺失错误，通常是路径设置问题。右键工程选择"Options for Target"，在"C/C++"标签页的Include Paths中添加：
.\Libraries\CMSIS\CM3\CoreSupport .\Libraries\CMSIS\CM3\DeviceSupport\ST\STM32F10x .\Libraries\STM32F10x_StdPeriph_Driver\inc3. 串口调试的实战技巧
看到RT-Thread的msh命令行是验证系统运行的重要标志。连接USB转串口后，需要精准配置串口参数：
PuTTY配置参数：
- 波特率：115200
- 数据位：8
- 停止位：1
- 校验位：None
- 流控制：None
当终端无输出时，按以下步骤排查：
- 确认开发板供电正常（红色电源灯常亮）
- 检查串口线是否接在"USB转串口"而非ST-Link接口
- 尝试按下复位键重新启动系统
- 在MDK5中查看Build Output窗口是否有编译警告
注意：部分Windows系统可能需要手动安装CH340G串口芯片驱动，可在正点原子资料包中找到。
4. 深度定制与功能扩展
成功运行基础工程后，可以开始探索RT-Thread的更多可能性。首先尝试修改rtconfig.h配置文件：
// 启用FinSH命令行组件 #define RT_USING_FINSH // 设置线程栈大小 #define RT_THREAD_STACK_SIZE 512 // 启用组件自动初始化 #define RT_USING_COMPONENTS_INIT常用调试命令：
list_thread- 查看当前运行线程free- 显示内存使用情况ps- 查看系统任务状态version- 显示RT-Thread版本信息
对于想要进一步开发的用户，可以尝试：
- 在
applications文件夹创建新源文件 - 使用ENV工具配置更多软件包
- 通过
rt_pin_write()控制板载LED - 添加按键中断处理逻辑
5. 典型问题解决方案
在实际操作中，有几个高频出现的问题值得特别注意：
问题1：下载程序后无任何反应
- 检查BOOT0跳线帽是否在正确位置（应接GND）
- 确认MDK5中Debug配置的Reset and Run已勾选
- 尝试全片擦除后重新下载
问题2：串口输出乱码
- 核对终端软件波特率是否为精确的115200
- 检查系统时钟配置（通常为72MHz HSE）
- 确认USART时钟源和引脚配置正确
问题3：线程创建失败
- 增加
RT_THREAD_STACK_SIZE数值 - 检查
rt_thread_init()返回值 - 使用
list_mem命令查看堆空间剩余情况
开发过程中养成良好习惯：每次修改配置后执行Clean Target，再重新编译。遇到异常时，优先查看HardFault_Handler中的调用栈信息。