4. 开发环境搭建：基于STM32CubeMX + Keil/IAR的工程创建、RTOS组件集成

好，咱们正式开始动手。这一章的目标很明确：把开发环境搭起来，跑通第一个带RTOS的工程。我见过不少学员卡在这一步，不是因为技术难，而是因为工具链的版本匹配问题。咱们一步步来，把坑提前填上。

4.1 工具链选型与版本匹配

先说说我个人的习惯。STM32CubeMX负责生成初始化代码，Keil MDK或IAR EWARM负责编译调试，再加上一个RTOS组件（比如FreeRTOS或RT-Thread Nano）。这三者的版本需要对齐，否则你会遇到一些莫名其妙的编译错误。

4.2 使用STM32CubeMX生成基础工程

打开CubeMX，新建工程，选择你的芯片型号。我一般用STM32F407VET6做教学，性价比高，外设也够用。

1. 配置时钟树：HSE选8MHz晶振，PLL倍频到168MHz。注意APB1和APB2的时钟分频，别让外设跑超了。
2. 配置调试接口：Serial Wire模式，占用SWDIO和SWCLK两个引脚。如果你用JTAG，记得把PB3/PB4留出来。
3. 配置一个串口：USART1，波特率115200，用于打印调试信息。我习惯把TX/RX映射到PA9/PA10。
4. 配置一个LED引脚：比如PD12，推挽输出，初始电平低。这是咱们的“心跳灯”。

配置完成后，点击Project Manager，设置工程名和路径。Toolchain选MDK-ARM V5或IAR。生成代码前，我建议勾选“Generate peripheral initialization as a pair of .c/.h files per peripheral”，这样每个外设独立文件，后期好维护。

4.3 集成RTOS组件：两种方式

RTOS的集成方式有两种，我分别讲一下。

方式一：CubeMX内置FreeRTOS

这是最省事的办法。在CubeMX的Middleware列表里找到FreeRTOS，勾选。然后配置几个关键参数：

• Kernel settings：Tick rate (Hz) 默认1000，也就是1ms一个tick。我建议保持这个值，除非你有特殊需求。
• Tasks and Queues：创建一个默认任务，比如defaultTask，栈大小512 words，优先级Normal。
• Memory management：选heap_4.c，支持碎片合并，适合动态创建任务。

生成代码后，你会看到FreeRTOS的源码被自动复制到工程目录下。主函数里已经包含了osKernelStart()调用。你只需要在任务函数里写自己的逻辑就行。

// CubeMX生成的默认任务入口
void StartDefaultTask(void *argument)
{
    for(;;)
    {
        HAL_GPIO_TogglePin(LED_GPIO_Port, LED_Pin);
        osDelay(500);
    }
}

方式二：手动移植FreeRTOS源码

如果你用的是旧版CubeMX，或者想用最新版FreeRTOS，那就手动移植。步骤也不复杂：

1. 从FreeRTOS官网下载源码，把Source文件夹复制到工程目录。
2. 在Keil/IAR里添加分组：FreeRTOS_Core、FreeRTOS_Portable、FreeRTOS_Heap。
3. 选择对应的port文件：ARM_CM4F（带FPU的M4内核）。
4. 在FreeRTOSConfig.h里配置宏定义，比如configTICK_RATE_HZ、configTOTAL_HEAP_SIZE。
5. 修改启动文件，把PendSV和SVC中断处理函数指向FreeRTOS的port实现。

4.4 工程结构解析

工程生成后，目录结构大概是这样的。我画了一张图，帮你快速理解各文件的作用。

4.5 编译与调试：第一行RTOS代码

工程生成后，先别急着写代码。编译一次，确保零错误零警告。我遇到过很多次，CubeMX生成的代码里会有一些未使用的变量警告，可以在Keil里把警告级别调低，或者直接注释掉。

然后，在默认任务里加一行打印：

void StartDefaultTask(void *argument)
{
    printf("RTOS is running!\r\n");
    for(;;)
    {
        HAL_GPIO_TogglePin(LED_GPIO_Port, LED_Pin);
        osDelay(1000);
    }
}

下载到板子，打开串口助手。如果看到“RTOS is running!”打印，并且LED以1秒间隔闪烁，恭喜你，环境搭建成功了。

4.6 避坑指南：常见问题与解决

我把这些年遇到的环境搭建问题整理了一下，你遇到类似情况可以直接对照排查。