RT-Thread在STM32F103上的实战：从CubeMX到多线程LED控制

1. 环境搭建与工程初始化

对于嵌入式开发者来说，将RT-Thread实时操作系统移植到STM32F103平台是一个极具实用价值的技能。这个过程中，STM32CubeMX作为图形化配置工具能大幅简化前期准备工作。

首先需要准备以下开发环境：

• STM32CubeMX V6.0.1或更高版本
• Keil MDK V5.28（建议使用ARMCC V6编译器）
• ST-LINK/V2调试器
• STM32F103C8T6最小系统板（蓝色药丸开发板）

提示：安装CubeMX时建议勾选STM32F1系列支持包，避免在线下载延迟

创建基础工程的步骤如下：

1. 启动CubeMX，点击"New Project"
2. 在芯片选择器中输入"STM32F103C8"，双击C8T6型号
3. 在Pinout & Configuration标签页进行关键配置：
   • SYS → Debug: Serial Wire
   • RCC → High Speed Clock (HSE): Crystal/Ceramic Resonator
4. 时钟树配置中，将HCLK设置为72MHz（输入72后回车自动配置）

// 生成的时钟配置代码片段（SystemClock_Config函数）
RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSE;
RCC_OscInitStruct.HSEState = RCC_HSE_ON;
RCC_OscInitStruct.PLL.PLLState = RCC_PLL_ON;
RCC_OscInitStruct.PLL.PLLSource = RCC_PLLSOURCE_HSE;
RCC_OscInitStruct.PLL.PLLMUL = RCC_PLL_MUL9;

2. RT-Thread软件包集成

传统RT-Thread移植需要手动修改大量文件，而通过CubeMX的软件包管理可以自动化完成大部分工作。以下是详细操作流程：

1. 在CubeMX界面点击"Software Packs" → "Select Components"
2. 点击"From Url"按钮添加RT-Thread仓库：

   https://www.rt-thread.org/download/cube/RealThread.RT-Thread.pdsc
   

3. 勾选以下组件：
   • RT-Thread Kernel
   • Device Drivers
   • finsh组件（可选，用于命令行交互）

配置完成后，工程中会自动添加RT-Thread的源码目录结构：

├── RT-Thread
│   ├── include
│   ├── kernel
│   ├── libcpu
│   └── src
└── drivers

注意：首次生成工程时可能出现组件下载缓慢的情况，建议提前配置好网络代理

3. 多线程任务开发实践

RT-Thread的核心优势在于其轻量级的多任务管理能力。我们以控制LED为例，演示如何创建并管理多个线程。

3.1 基础线程创建

首先在main.c中添加必要的头文件和线程控制块：

/* Private includes ----------------------------------------------------------*/
#include <rtthread.h>
#include "gpio.h"

/* Private variables ---------------------------------------------------------*/
static struct rt_thread led1_thread;
static rt_uint8_t led1_stack[256];
static struct rt_thread led2_thread; 
static rt_uint8_t led2_stack[256];

然后定义线程入口函数：

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

static void led2_thread_entry(void *parameter) 
{
    while (1) {
        HAL_GPIO_TogglePin(GPIOB, GPIO_PIN_12);
        rt_thread_mdelay(300);
    }
}

3.2 线程初始化与启动

在main函数中初始化并启动线程：

int main(void)
{
    /* 初始化LED1线程 */
    rt_thread_init(&led1_thread,
                  "led1",
                  led1_thread_entry,
                  RT_NULL,
                  &led1_stack[0],
                  sizeof(led1_stack),
                  6,  // 优先级
                  20); // 时间片
    
    /* 初始化LED2线程 */
    rt_thread_init(&led2_thread,
                  "led2", 
                  led2_thread_entry,
                  RT_NULL,
                  &led2_stack[0],
                  sizeof(led2_stack),
                  7,
                  20);
    
    /* 启动线程 */
    rt_thread_startup(&led1_thread);
    rt_thread_startup(&led2_thread);
    
    /* 启动调度器 */
    return RT_EOK;
}

线程参数配置建议：

参数	说明	推荐值
优先级	数值越小优先级越高	3-10
时间片	相同优先级任务的时间分配	5-50
栈大小	根据任务复杂度调整	256-1024

4. 调试与性能优化

4.1 常见问题排查

在实际开发中可能会遇到以下典型问题：

1. HardFault异常：

   • 注释掉stm32f1xx_it.c中的默认中断处理函数
   • 确保RT-Thread接管了SysTick中断

2. 线程栈溢出：

   • 使用rt_thread_mdelay代替HAL_Delay
   • 通过list_thread命令查看栈使用情况

3. 优先级反转：

   • 合理设置线程优先级
   • 考虑使用互斥锁的优先级继承特性

4.2 系统监控技巧

启用finsh组件后，可以通过串口输入命令监控系统状态：

msh >list_thread
thread   pri  status      sp     stack size max used left tick  error
------   ---  ------      --     ---------- -------- --------- ---
led1      6    running 0x00000060 0x00000100 28%   0x0000000a 000
led2      7    running 0x00000060 0x00000100 31%   0x00000006 000
tshell    20   ready   0x00000080 0x00000800 15%   0x0000000a 000

性能优化建议：

• 对于高频任务，考虑使用软件定时器代替独立线程
• 共享资源访问使用信号量保护
• 合理设置空闲线程钩子进行低功耗管理

5. 进阶应用：事件驱动编程

RT-Thread提供了丰富的事件驱动机制，下面演示如何使用事件集协调多个LED的闪烁模式：

/* 定义事件标志 */
#define LED_EVENT_BLINK_SLOW (1 << 0)
#define LED_EVENT_BLINK_FAST (1 << 1)

/* 创建事件控制块 */
static struct rt_event led_event;

void event_handler_thread(void *parameter)
{
    rt_uint32_t e;
    
    while (1) {
        /* 等待事件发生 */
        if (rt_event_recv(&led_event, 
                         LED_EVENT_BLINK_SLOW | LED_EVENT_BLINK_FAST,
                         RT_EVENT_FLAG_OR | RT_EVENT_FLAG_CLEAR,
                         RT_WAITING_FOREVER, &e) == RT_EOK) {
            
            if (e & LED_EVENT_BLINK_SLOW) {
                // 慢速闪烁逻辑
            }
            if (e & LED_EVENT_BLINK_FAST) {
                // 快速闪烁逻辑
            }
        }
    }
}

/* 初始化事件对象 */
rt_event_init(&led_event, "ledevt", RT_IPC_FLAG_FIFO);

/* 发送事件示例 */
rt_event_send(&led_event, LED_EVENT_BLINK_FAST);

这种模式特别适合需要响应外部触发条件的应用场景，如按键控制LED模式切换等。