STM32实战：CubeMX快速配置FreeRTOS与RT-Thread双系统点亮LED

当你第一次拿到STM32开发板时，最兴奋的瞬间莫过于让那颗小小的LED闪烁起来。但如果你想让这颗LED以更智能的方式工作——比如按照特定节奏闪烁，或者响应多个任务——实时操作系统（RTOS）就是你的不二之选。本文将带你用STM32CubeMX这个瑞士军刀般的工具，在同一个开发板上分别配置FreeRTOS和RT-Thread两大主流RTOS，从零开始创建任务控制LED。不同于枯燥的理论讲解，我们会用完全相同的硬件环境，对比两种系统在配置流程、代码结构和API调用上的差异，让你在实操中快速掌握RTOS的核心使用技巧。

1. 环境准备与工程创建

在开始前，请确保你的开发环境已经就绪。我们需要以下硬件和软件：

• 硬件：STM32F103C8T6开发板（Blue Pill）或其他STM32系列开发板
• 软件：
  • STM32CubeMX 6.x
  • Keil MDK-ARM或STM32CubeIDE
  • 串口调试工具（如PuTTY）

提示：本文以STM32F103C8T6为例，但操作步骤适用于大多数STM32系列芯片，只需在CubeMX中选择对应型号即可。

1.1 安装必要的软件包

打开CubeMX后，首先需要安装对应的芯片支持包和RTOS组件：

# 在CubeMX中安装STM32F1系列HAL库
Help -> Manage embedded software packages -> STM32F1 -> 安装最新版本

# 安装FreeRTOS和RT-Thread中间件
Middleware -> FreeRTOS -> 选择版本
Middleware -> RT-Thread -> 选择最新版本

安装完成后，你会看到Middleware菜单下出现了FreeRTOS和RT-Thread的选项。这两个RTOS的配置将分别在两个独立的工程中进行，但硬件基础配置（时钟、GPIO）可以保持一致。

1.2 基础硬件配置

无论使用哪种RTOS，硬件基础配置都是相同的。在CubeMX中按以下步骤操作：

1. 选择MCU型号：STM32F103C8T6
2. 配置时钟源：
   • HSE：8MHz（根据开发板晶振实际值）
   • LSE：32.768kHz（可选）
3. 时钟树配置：
   • SYSCLK：72MHz
   • HCLK：72MHz
   • APB1：36MHz
   • APB2：72MHz
4. GPIO配置：
   • 将PC13配置为GPIO_Output（LED引脚）
   • 模式：Output push pull
   • 初始电平：High（根据LED电路设计）

// 生成的HAL库GPIO初始化代码片段
__HAL_RCC_GPIOC_CLK_ENABLE();
GPIO_InitStruct.Pin = GPIO_PIN_13;
GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;
GPIO_InitStruct.Pull = GPIO_NOPULL;
GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW;
HAL_GPIO_Init(GPIOC, &GPIO_InitStruct);

2. FreeRTOS工程配置与LED任务实现

FreeRTOS以其轻量级和易用性著称，特别适合资源受限的STM32F1系列。让我们从CubeMX配置开始。

2.1 FreeRTOS基础配置

在Middleware中启用FreeRTOS后，进入配置界面。关键参数设置如下：

配置项	推荐值	说明
USE_PREEMPTION	Enabled	启用抢占式调度
CPU_CLOCK_HZ	72000000	与系统时钟一致
TICK_RATE_HZ	1000	系统时钟节拍频率
MAX_PRIORITIES	7	任务优先级数量
MINIMAL_STACK_SIZE	128	最小任务栈大小
TOTAL_HEAP_SIZE	4096	堆内存大小

注意：TICK_RATE_HZ决定了任务调度的粒度，1000Hz（1ms）是常用值，但会带来一定CPU开销。资源紧张时可降低到100Hz。

2.2 创建LED闪烁任务

在FreeRTOS配置页面的"Tasks and Queues"选项卡中，添加一个新任务：

• Task Name: LED_Task
• Entry Function: StartLEDTask
• Stack Size: 128
• Priority: osPriorityNormal

生成的代码框架会自动创建任务函数原型：

void StartLEDTask(void *argument) {
  for(;;) {
    HAL_GPIO_TogglePin(GPIOC, GPIO_PIN_13);
    osDelay(500);  // 500ms延迟
  }
}

2.3 生成代码与编译

点击"Generate Code"后，CubeMX会生成完整的工程文件。关键改动点包括：

1. freertos.c中包含了RTOS配置和任务定义
2. main.c中增加了RTOS初始化代码：

   MX_FreeRTOS_Init();
   osKernelStart();  // 启动调度器
   

编译并下载程序后，你会看到LED以1Hz频率稳定闪烁。如果遇到问题，检查以下常见错误：

• LED引脚配置错误（确认PC13对应开发板上的LED）
• 堆栈大小不足（增大Stack Size）
• 系统时钟配置错误（确认时钟树设置）

3. RT-Thread工程配置与LED任务实现

RT-Thread作为国产RTOS的代表，提供了更丰富的组件支持。让我们看看它在CubeMX中的配置有何不同。

3.1 RT-Thread基础配置

在Middleware中启用RT-Thread后，配置界面与FreeRTOS有明显差异：

配置项	推荐值	说明
RT_NAME_MAX	8	线程名称最大长度
RT_ALIGN_SIZE	4	内存对齐大小
RT_TICK_PER_SECOND	100	系统时钟节拍频率
RT_THREAD_PRIORITY_MAX	8	最大优先级数
RT_USING_HEAP	Enabled	启用动态内存管理

提示：RT-Thread默认使用100Hz的系统节拍，比FreeRTOS配置低，这减少了调度开销但降低了时间精度。

3.2 创建LED闪烁线程

RT-Thread中不直接通过CubeMX创建任务，而是需要在代码中手动添加。在rtthread.c中添加：

static void led_thread_entry(void *parameter) {
    while (1) {
        HAL_GPIO_TogglePin(GPIOC, GPIO_PIN_13);
        rt_thread_mdelay(500);  // RT-Thread专用延时函数
    }
}

void MX_RT_Thread_Init(void) {
    rt_thread_t tid;
    tid = rt_thread_create("led", 
                          led_thread_entry, 
                          RT_NULL,
                          256,  // 栈大小
                          20,   // 优先级
                          10);  // 时间片
    if (tid != RT_NULL) rt_thread_startup(tid);
}

3.3 代码结构与编译

RT-Thread生成的工程结构更复杂，包含了组件初始化代码。关键文件：

• rtthread.c：内核配置和初始化
• board.c：硬件相关初始化
• applications/：用户应用代码目录

编译时会发现RT-Thread占用的Flash和RAM比FreeRTOS略大，这是因为它默认包含了更多组件功能。下载程序后，LED同样会以1Hz频率闪烁，但背后的调度机制已经完全不同。

4. 双系统对比与进阶技巧

现在我们已经成功在同一个硬件上运行了两种RTOS，让我们从开发者角度对比它们的异同。

4.1 CubeMX配置界面差异

功能项	FreeRTOS	RT-Thread
任务创建	可视化配置	需手动编码
内存管理	简单配置	多选项配置
组件支持	基础内核	丰富组件
调试支持	基础功能	内置shell

4.2 API调用对比

任务创建：

// FreeRTOS
xTaskCreate(LED_Task, "LED", 128, NULL, 1, NULL);

// RT-Thread
rt_thread_create("led", led_thread_entry, NULL, 256, 20, 10);

延时函数：

// FreeRTOS
vTaskDelay(pdMS_TO_TICKS(500));

// RT-Thread
rt_thread_mdelay(500);

4.3 性能优化建议

根据实际项目需求，可以考虑以下优化方向：

• FreeRTOS优化：

  • 调整configTOTAL_HEAP_SIZE精确控制内存使用
  • 使用configUSE_TIME_SLICING控制时间片轮转
  • 启用configUSE_TICKLESS_IDLE降低功耗

• RT-Thread优化：

  • 通过rtconfig.h裁剪不需要的组件
  • 使用RT_USING_OVERFLOW_CHECK检测栈溢出
  • 利用msh命令行进行运行时诊断

4.4 常见问题解决

FreeRTOS常见问题：

1. 任务无法调度：检查osKernelStart()是否调用
2. 堆空间不足：增大configTOTAL_HEAP_SIZE
3. 优先级反转：使用互斥量的优先级继承功能

RT-Thread常见问题：

1. 线程创建失败：检查栈大小是否足够
2. 组件初始化失败：确认Kconfig配置正确
3. 内存泄漏：使用memtrace工具检测

5. 从LED扩展到实际项目

掌握了基础任务创建后，可以进一步探索RTOS的强大功能。以下是几个实际项目方向：

5.1 多任务协同控制

创建一个包含三个任务的系统：

• LED控制任务（优先级20）
• 传感器读取任务（优先级15）
• 通信处理任务（优先级10）

// RT-Thread示例
void sensor_thread_entry(void *p) {
    while(1) {
        float temp = read_temperature();
        rt_mb_send(temp_mb, (rt_uint32_t)&temp);
        rt_thread_mdelay(1000);
    }
}

5.2 使用系统服务

FreeRTOS队列示例：

QueueHandle_t xQueue = xQueueCreate(5, sizeof(float));

void producer_task(void *p) {
    float data = 0.0f;
    while(1) {
        xQueueSend(xQueue, &data, portMAX_DELAY);
        data += 0.5f;
        vTaskDelay(pdMS_TO_TICKS(500));
    }
}

RT-Thread消息队列示例：

static rt_mq_t temp_mq;
temp_mq = rt_mq_create("temp_mq", sizeof(float), 5, RT_IPC_FLAG_FIFO);

void consumer_thread_entry(void *p) {
    float temp;
    while(1) {
        if(rt_mq_recv(temp_mq, &temp, sizeof(temp), RT_WAITING_FOREVER) == RT_EOK) {
            rt_kprintf("Temperature: %.1f\n", temp);
        }
    }
}

5.3 添加Shell交互

RT-Thread的msh功能特别适合调试：

MSH_CMD_EXPORT(led_control, "Control LED: led_control [on|off|toggle]");
int led_control(int argc, char **argv) {
    if(argc != 2) return -1;
    if(!strcmp(argv[1], "on")) HAL_GPIO_WritePin(GPIOC, GPIO_PIN_13, GPIO_PIN_RESET);
    else if(!strcmp(argv[1], "off")) HAL_GPIO_WritePin(GPIOC, GPIO_PIN_13, GPIO_PIN_SET);
    else if(!strcmp(argv[1], "toggle")) HAL_GPIO_TogglePin(GPIOC, GPIO_PIN_13);
    return 0;
}