📚 课程目录第3章开发环境搭建

3. 开发环境搭建

RT-Thread 的设备驱动开发并不是“打开编辑器写 C 文件”这么简单，它背后有一套完整的工具链协同：图形化 IDE 负责工程管理与调试，Env 工具负责配置与包管理，scons 负责把 Kconfig 配置、源码、启动文件、链接脚本组织成可执行镜像，交叉编译工具链负责生成目标架构机器码，调试器则把镜像烧录到芯片并支持断点、单步、变量观察。理解这五者的分工与数据流，是后续驱动开发不“卡在环境”的前提。

一、核心原理：五件套的分工与数据流

RT-Thread 的构建体系可以概括为“配置驱动构建”。用户在 menuconfig 中修改 rtconfig.h 与 .config，scons 读取这些配置后决定编译哪些源文件、链接哪些库、使用哪个链接脚本；交叉编译工具链把 C 源码、汇编启动文件编译为目标文件，再由链接器生成 .elf 与 .bin；调试器通过 SWD/JTAG 把镜像写入 Flash，并借助 GDB Server 实现源码级调试。RT-Thread Studio 则把上述流程封装为图形化操作，同时保留 Env 与 scons 的命令行能力，方便自动化与 CI。

二、方法流程：从零创建可编译工程

以 STM32F407 为例，推荐流程如下：

安装 RT-Thread Studio：从官网下载安装包，安装时勾选对应芯片支持包（如 STM32F4 系列）。Studio 内置 GCC 工具链与调试插件，首次启动会自动下载 SDK。
创建工程：菜单 文件 → 新建 → RT-Thread 项目，选择“基于芯片”或“基于开发板”，填写工程名、芯片型号、调试器类型（ST-Link），点击完成。
配置内核与组件：双击工程中的 RT-Thread Settings，打开图形化配置界面，勾选需要的设备驱动框架（如 PIN、UART、SPI、I2C）与软件包。
使用 Env 进行命令行配置：在工程根目录右键打开 Env，执行 menuconfig 可进行更细粒度配置；执行 pkgs --update 下载软件包。
编译：Studio 中点击“构建”按钮，底层实际调用 scons；也可在 Env 中执行 scons 或 scons -j8 并行编译。
烧录与调试：配置调试器为 ST-Link，点击“下载”烧录 .bin；点击“调试”进入 GDB 会话，可打断点、查看 rt_device 结构体。

# Env 中常用命令
menuconfig          # 图形化配置内核与组件
pkgs --update       # 更新软件包
scons               # 编译工程
scons -j8           # 8 线程并行编译
scons --target=mdk5 # 生成 MDK5 工程
scons --dist        # 导出独立工程包

三、案例场景：为 UART 驱动准备环境

假设要开发一个基于 STM32 的 UART 设备驱动，环境准备阶段需要确认三件事：第一，在 RT-Thread Settings 中开启 RT_USING_SERIAL 与 BSP_USING_UART1；第二，确认 rtconfig.h 中已生成对应宏；第三，确认链接脚本 link.lds 中串口中断向量已正确映射。若使用 Env，可执行 scons --menuconfig 后搜索 UART 快速定位。编译成功后，在 rtthread.bin 同级目录会生成 rtthread.elf，调试时加载该文件即可看到源码行号。

提示：Studio 与 Env 的配置是双向同步的。在 Studio 中修改 Settings 后，rtconfig.h 会更新；在 Env 中执行 menuconfig 后，Studio 重新打开工程也会识别新配置。若出现配置不一致，优先以 rtconfig.h 为准，并执行一次 scons --clean 后重新编译。

四、误区与复盘：环境搭建常见坑

现象	可能原因	排查方法
编译报 “arm-none-eabi-gcc not found”	工具链未加入 PATH 或 Studio 未识别	在 Env 中执行 `gcc -v`，检查 `EXEC_PATH` 配置
scons 报 “No SConstruct file found”	未在工程根目录执行	确认当前目录存在 `SConstruct` 与 `rtconfig.h`
烧录后串口无输出	时钟配置错误或串口引脚未复用	检查 `board.c` 中 `SystemClock_Config` 与 GPIO 复用
调试时无法命中断点	优化等级过高或未加载 .elf	将优化设为 `-O0`，调试配置中指定 `rtthread.elf`
pkgs --update 失败	网络无法访问 GitHub 或包源	配置国内镜像源或手动下载包放入 `packages`

注意：不要混用不同版本的 GCC 工具链与 RT-Thread 源码。例如用较新的 arm-none-eabi-gcc 12 编译老版本 BSP，可能因 -nostdlib 或链接脚本语法变化导致链接失败。建议使用 Studio 自带工具链，或在 Env 中通过 RTT_EXEC_PATH 显式指定。

环境搭建完成后，建议做一次“最小验证”：新建一个线程，每隔 500ms 打印一次 rt_tick_get()，编译烧录后观察串口输出。若能看到稳定递增的 tick，说明工具链、scons、调试器、串口驱动均已打通，可以进入后续设备驱动框架的学习与开发。