从裸机到RTOS：手把手教你用RT-Thread Nano在STM32上跑起第一个多线程LED闪烁程序
从裸机到RTOS：用RT-Thread Nano实现STM32多线程LED控制
1. 嵌入式开发的演进：从裸机到RTOS
在嵌入式系统开发领域，我们经历了从简单裸机程序到复杂实时操作系统(RTOS)的演进过程。对于STM32开发者而言，这种转变尤为明显。裸机开发虽然简单直接，但随着项目复杂度提升，其局限性逐渐显现：
- 资源竞争：多个功能模块需要共享CPU时间
- 优先级管理困难：重要任务无法及时响应
- 代码耦合度高：功能模块间相互影响
- 维护成本增加：系统规模扩大后难以管理
RT-Thread Nano作为轻量级RTOS解决方案，完美填补了裸机与完整RTOS之间的空白。它保留了RTOS的核心调度功能，同时保持了极小的资源占用（最小仅3KB ROM和1KB RAM），特别适合STM32等资源受限的MCU。
2. 环境准备与工程搭建
2.1 硬件需求
| 硬件组件 | 规格要求 | 备注 |
|---|---|---|
| STM32开发板 | Cortex-M系列 | 推荐F1/F4系列 |
| LED模块 | 至少2个LED | 用于多线程演示 |
| 调试器 | ST-Link/J-Link | 用于程序下载调试 |
| 串口模块 | 可选 | 用于调试信息输出 |
2.2 软件工具链
# 开发环境选择（二选一） 1. Keil MDK-ARM (建议V5.25+) 2. STM32CubeIDE (建议1.7.0+) # 所需软件包 - RT-Thread Nano源码包 (v3.1.5+) - STM32标准外设库/HAL库2.3 工程初始化步骤
- 创建新工程（以Keil为例）
- 添加STM32基础驱动文件
- 导入RT-Thread Nano源码：
- 复制
rt-thread/bsp到工程目录 - 添加
components、include、libcpu、src文件夹
- 复制
- 配置工程包含路径：
./rt-thread/include ./rt-thread/libcpu/arm/cortex-m3 ./rt-thread/src
3. RT-Thread Nano核心配置
3.1 系统时钟配置
RT-Thread Nano依赖SysTick作为系统时钟源，需要在board.c中进行正确初始化：
void SystemClock_Config(void) { // 标准时钟配置代码... /* 配置SysTick为1ms中断 */ SysTick_Config(SystemCoreClock / RT_TICK_PER_SECOND); }3.2 rtconfig.h关键参数
#define RT_THREAD_PRIORITY_MAX 8 // 系统优先级数量 #define RT_TICK_PER_SECOND 1000 // 系统时钟频率(Hz) #define RT_USING_HEAP 1 // 启用动态内存管理 #define RT_USING_TIMER_SOFT 0 // 禁用软件定时器(初学阶段)注意：优先级数值越小优先级越高，0为最高优先级
4. 多线程LED控制实战
4.1 线程创建基础
RT-Thread提供两种线程创建方式：
- 静态创建：预先分配好所有资源
- 动态创建：运行时动态分配资源（更灵活）
我们以动态创建为例实现双LED控制：
#include <rtthread.h> #include "stm32f1xx_hal.h" /* 定义LED引脚 */ #define LED1_PIN GPIO_PIN_0 #define LED2_PIN GPIO_PIN_1 #define LED_GPIO GPIOA /* 线程控制块指针 */ static rt_thread_t led1_thread = RT_NULL; static rt_thread_t led2_thread = RT_NULL; /* LED控制函数 */ void led1_thread_entry(void *parameter) { while(1) { HAL_GPIO_TogglePin(LED_GPIO, LED1_PIN); rt_thread_mdelay(500); // 500ms间隔 } } void led2_thread_entry(void *parameter) { while(1) { HAL_GPIO_TogglePin(LED_GPIO, LED2_PIN); rt_thread_mdelay(1000); // 1000ms间隔 } }4.2 线程启动与管理
在main函数中初始化硬件并启动线程：
int main(void) { /* 硬件初始化 */ HAL_Init(); SystemClock_Config(); /* LED GPIO初始化 */ GPIO_InitTypeDef GPIO_InitStruct = {0}; __HAL_RCC_GPIOA_CLK_ENABLE(); GPIO_InitStruct.Pin = LED1_PIN | LED2_PIN; GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP; GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW; HAL_GPIO_Init(LED_GPIO, &GPIO_InitStruct); /* 创建LED1线程 */ led1_thread = rt_thread_create( "led1", // 线程名称 led1_thread_entry, // 入口函数 RT_NULL, // 参数 256, // 栈大小 3, // 优先级 20 // 时间片 ); /* 创建LED2线程 */ led2_thread = rt_thread_create( "led2", // 线程名称 led2_thread_entry, // 入口函数 RT_NULL, // 参数 256, // 栈大小 4, // 优先级 20 // 时间片 ); /* 启动线程 */ if(led1_thread != RT_NULL) rt_thread_startup(led1_thread); if(led2_thread != RT_NULL) rt_thread_startup(led2_thread); return 0; }5. 调试与问题排查
5.1 常见编译错误
| 错误类型 | 解决方案 |
|---|---|
| 头文件找不到 | 检查包含路径，确认RT-Thread头文件位置 |
| 重复定义 | 确保没有同时包含标准库和HAL库 |
| 链接错误 | 检查是否添加了所有必要的源文件 |
| 堆栈溢出 | 增加线程栈大小或优化局部变量 |
5.2 运行时问题排查技巧
使用rt_kprintf输出调试信息：
#include <rtdbg.h> LOG_D("LED1 state changed"); // 调试级别日志检查线程状态：
# 在Finsh控制台输入 list_thread输出示例：
thread pri status sp stack size max used left tick ------ --- ------ --- ---------- ------- -------- led1 3 running 0x40 256 56% 10 led2 4 ready 0x40 256 48% 20 tshell 20 ready 0x60 512 32% 5优先级反转处理：
- 确保高优先级任务不会长期占用CPU
- 合理使用信号量等同步机制
6. 进阶应用：从闪烁LED到实际项目
掌握了基础的多线程LED控制后，我们可以进一步探索RT-Thread Nano的更多特性：
6.1 线程间通信
/* 创建信号量 */ static rt_sem_t led_sem = RT_NULL; led_sem = rt_sem_create("led_sem", 1, RT_IPC_FLAG_FIFO); /* 线程安全访问 */ void led_control_thread(void *parameter) { rt_sem_take(led_sem, RT_WAITING_FOREVER); // 安全操作LED rt_sem_release(led_sem); }6.2 硬件定时器集成
static rt_timer_t led_timer; static void led_timer_callback(void *parameter) { HAL_GPIO_TogglePin(LED_GPIO, LED1_PIN); } /* 初始化硬件定时器 */ led_timer = rt_timer_create( "led_tmr", led_timer_callback, RT_NULL, 500, // 500ms RT_TIMER_FLAG_PERIODIC | RT_TIMER_FLAG_HARD_TIMER );6.3 低功耗优化
void idle_hook(void) { /* 进入低功耗模式 */ __WFI(); } /* 在main函数中注册 */ rt_thread_idle_sethook(idle_hook);7. 性能优化与最佳实践
7.1 内存管理策略
| 策略 | 适用场景 | 优缺点 |
|---|---|---|
| 静态分配 | 确定性要求高的系统 | 无碎片，但灵活性差 |
| 小内存管理 | 频繁小内存分配 | 效率高，但大内存浪费 |
| SLAB分配器 | 固定大小对象 | 高效但配置复杂 |
7.2 线程设计原则
- 单一职责：每个线程只做一件事
- 合理优先级：关键任务设高优先级
- 适度时间片：CPU密集型任务给较小时间片
- 栈大小估算：
// 通过max used值调整 list_thread
7.3 实时性保障措施
- 中断服务程序(ISR)尽量简短
- 使用
rt_enter_critical()保护关键段 - 避免在中断中调用可能导致阻塞的RT-Thread API
8. 项目实战：智能灯光控制系统
结合所学知识，我们可以构建一个完整的智能灯光控制示例：
/* 定义工作模式 */ enum light_mode { MODE_OFF, MODE_NORMAL, MODE_BREATH, MODE_STROBE }; /* 创建消息队列 */ static rt_mq_t light_mq; light_mq = rt_mq_create("light_mq", sizeof(enum light_mode), 5, RT_IPC_FLAG_FIFO); /* 灯光控制线程 */ void light_control_thread(void *parameter) { enum light_mode mode; while(1) { if(rt_mq_recv(light_mq, &mode, sizeof(mode), RT_WAITING_FOREVER) == RT_EOK) { switch(mode) { case MODE_OFF: HAL_GPIO_WritePin(LED_GPIO, LED1_PIN|LED2_PIN, GPIO_PIN_RESET); break; case MODE_NORMAL: // 正常模式处理 break; case MODE_BREATH: // 呼吸灯效果 break; case MODE_STROBE: // 闪光效果 break; } } } } /* 网络控制线程 */ void network_ctrl_thread(void *parameter) { // 接收网络指令并发送到消息队列 enum light_mode new_mode = MODE_BREATH; rt_mq_send(light_mq, &new_mode, sizeof(new_mode)); }这个示例展示了如何将多线程、线程间通信等概念应用到实际项目中。通过消息队列解耦控制逻辑和硬件操作，系统具备良好的扩展性和维护性。