STM32F103移植RT-Thread Nano内核：轻量级实时系统快速上手指南
在嵌入式开发领域，资源约束始终是工程师面临的核心挑战。当你手头只有一块仅有64KB闪存和20KB内存的STM32F103C8T6开发板，却需要实现多任务调度、事件同步与定时器管理时，传统的轮询式架构往往显得笨拙不堪。此时，一个轻量级的实时操作系统就成了理想选择——然而主流RTOS通常占用十几KB甚至数十KB的资源，对于这种资源受限的MCU而言简直是一种负担。
这正是RT-Thread Nano脱颖而出的原因。作为一个经过精心裁剪的硬实时内核，它仅需约2.5KB的ROM和1KB的RAM即可稳定运行，这个数字在Cortex-M3架构中几乎可以忽略不计。虽然体型"迷你"，但它提供了完整的RTOS特性：多线程调度、软件定时器、信号量、消息队列以及优先级抢占式调度器一应俱全。
本文将带领读者完成一次完整的移植实战：在STM32F103上部署RT-Thread Nano内核。我们将从零开始搭建开发环境，逐步完成移植工作，并通过具体的资源占用数据，验证这个"小身材"内核的实际价值。
一、开发环境构建与项目配置
在正式移植之前，需要先准备好开发环境。对于STM32F103系列，Keil MDK是最普遍采用的开发工具，其Pack Installer功能可以便捷地获取RT-Thread Nano软件包。
1.1 目标硬件选型
本文选用STM32F103C8T6作为目标平台，这款芯片在嵌入式圈子里素有"国民MCU"之称：
- 处理器核心：ARM Cortex-M3，主频72MHz
- 存储空间：64KB Flash（实际可用约60KB）
- 内存空间：20KB RAM（实际可用约19KB）
- 外设资源：GPIO、USART、SPI、I2C、ADC等常用外设一应俱全
这种配置在消费电子、工业控制、物联网终端等领域应用广泛，恰好处于"裸机开发略显吃力，完整RTOS又显奢侈"的临界区间。RT-Thread Nano在此类场景下找到了最佳落脚点。
1.2 开发环境配置
首先确认已安装Keil MDK 5.25或更高版本。打开Keil后，通过Pack Installer安装RT-Thread Nano：
- 点击菜单栏的 Pack Installer 按钮
- 在搜索框中输入"RT-Thread"
- 定位到"RT-Thread::RT-Thread"并完成安装
注意：若使用旧版Keil，需手动从RT-Thread官网或GitHub仓库下载最新的pack文件，然后通过"File -> Import -> Software Pack"进行导入。
安装完成后，新建一个STM32工程。建议选用标准外设库（Standard Peripheral Library）作为基础模板，其兼容性最佳。若偏好HAL库，RT-Thread Nano同样支持，仅初始化流程略有差异。
1.3 核心配置参数
工程配置中有几项关键参数需要特别关注：
// 在system_stm32f1xx.c中设置系统时钟
#define HCLK_FREQ_72MHz 72000000
// 在startup_stm32f10x_md.s中定义堆栈尺寸
Stack_Size EQU 0x00000400 ; 1KB栈空间
Heap_Size EQU 0x00000200 ; 512字节堆空间
对于RT-Thread Nano，需要预留以下资源：
- 系统栈：512字节（用于中断处理和系统调用）
- 线程栈：每条线程最少256字节
- 堆内存：512字节用于动态内存分配
以上为最低配置要求，实际项目中需根据线程数量和任务复杂度适当扩容。不过对于大多数基础应用，这套配置已完全够用。
二、内核移植核心步骤解析
将RT-Thread Nano移植到STM32F103可归纳为三个关键环节：引入内核文件、配置系统时钟、实现上下文切换。看似简单，但每个环节都有需要注意的细节。
2.1 第一步：向工程添加内核文件
通过Keil的Pack Installer完成RT-Thread Nano安装后，可在Keil_v5/ARM/PACK/RT-Thread/目录下找到相关文件。需要将以下文件纳入工程：
RT-Thread/
├── kernel/
│ ├── src/ // 内核源代码
│ │ ├── clock.c // 系统时钟管理
│ │ ├── idle.c // 空闲任务
│ │ ├── ipc.c // 进程间通信机制
│ │ ├── irq.c // 中断管理
│ │ ├── kservice.c // 内核基础服务
│ │ ├── mem.c // 内存管理
│ │ ├── object.c // 内核对象管理
│ │ ├── scheduler.c // 调度器实现
│ │ ├── thread.c // 线程管理
│ │ └── timer.c // 软件定时器
│ └── include/ // 内核头文件
└── port/ // 移植适配层
├── cortex-m3/ // Cortex-M3特定实现
│ ├── context_gcc.S // GCC编译器上下文切换
│ ├── context_iar.S // IAR编译器上下文切换
│ ├── context_keil.S // Keil编译器上下文切换
│ └── cpuport.c // CPU端口相关函数
└── drv_uart.c // 串口驱动（可选）
在Keil工程中，建议按功能模块分组组织文件：
- 新建"RT-Thread/Kernel"文件组，添加
src/目录下所有.c文件 - 新建"RT-Thread/Port"文件组，添加
port/cortex-m3/下的相关文件 - 在工程选项中配置头文件路径：
$(PackRoot)/RT-Thread/kernel/include和$(PackRoot)/RT-Thread/port/cortex-m3
提示：若使用GCC或IAR编译器，需选用对应的context_*.S文件。Keil采用ARMCC编译器，因此应选用context_keil.S。
2.2 第二步：系统时钟与SysTick配置
RT-Thread Nano需要一个精准的时钟基准来驱动调度器和软件定时器。在STM32F103平台上，通常利用SysTick定时器，它直接挂载在Cortex-M3内核上，与系统时钟保持同步。
首先在board.c（或自定义的板级支持文件）中实现系统时钟初始化：
#include <rtthread.h>
#include <board.h>
// 系统时钟频率，单位Hz
#define CPU_CLOCK_HZ 72000000
// SysTick中断频率，设定为1000Hz（1ms周期）
#define TICK_RATE_HZ 1000
// SysTick中断服务程序
void SysTick_Handler(void)
{
// 通知内核进入中断上下文
rt_interrupt_enter();
// 更新系统滴答计数
rt_tick_increase();
// 通知内核离开中断上下文
rt_interrupt_leave();
}
// 板级初始化入口
void rt_hw_board_init(void)
{
// 配置系统时钟为72MHz
SystemInit();
// 配置SysTick定时器
// SystemCoreClock在system_stm32f1xx.c中定义
SysTick_Config(SystemCoreClock / TICK_RATE_HZ);
// 初始化调试串口（如需要）
#ifdef RT_USING_CONSOLE
rt_console_set_device(RT_CONSOLE_DEVICE_NAME);
#endif
// 输出启动提示信息
rt_kprintf("\nRT-Thread Nano on STM32F103\n");
rt_kprintf("CPU Clock: %d Hz\n", CPU_CLOCK_HZ);
rt_kprintf("Tick Rate: %d Hz\n", TICK_RATE_HZ);
}
此处有几个关键点需要把握：
- SysTick参数计算：
SysTick_Config()函数的入参为重装载值。SystemCoreClock / 1000表示每1ms触发一次中断，这是RT-Thread的默认时间片长度。 - 中断嵌套支持：
rt_interrupt_enter()和rt_interrupt_leave()必须成对调用，用于维护中断嵌套计数，确保在中断服务程序中可以安全调用线程安全的内核函数。
2.3 第三步：实现上下文切换机制
上下文切换是RTOS的核心机制，决定了系统能否实现多任务并发执行。RT-Thread Nano为Cortex-M3架构提供了完整的上下文切换实现，通常无需手动修改。
不过，需要确保启动文件中正确配置了系统栈。在startup_stm32f10x_md.s文件中找到栈初始化部分：
; 栈空间初始化
Stack_Size EQU 0x00000400
AREA STACK, NOINIT, READWRITE, ALIGN=3
Stack_Mem SPACE Stack_Size
__initial_sp
; 堆空间初始化
Heap_Size EQU 0x00000200
AREA HEAP, NOINIT, READWRITE, ALIGN=3
__heap_base
Heap_Mem SPACE Heap_Size
__heap_limit
RT-Thread Nano使用MSP（主栈指针）作为系统栈，PSP（进程栈指针）用于各线程。启动时，系统首先使用MSP，切换到第一个线程后改为PSP。
三、创建首条应用线程
完成上述移植步骤后，就可以创建应用线程了。在RT-Thread中，线程是调度的基本单位。下面演示如何创建一条简单的LED闪烁线程：
#include <rtthread.h>
#include <stm32f10x.h>
#define LED_PIN GPIO_Pin_13 // PC13引脚对应板上LED
#define LED_PORT GPIOC
// 线程控制块
static struct rt_thread led_thread;
static rt_uint8_t led_thread_stack[512];
// LED初始化函数
void led_init(void)
{
GPIO_InitTypeDef GPIO_InitStructure;
RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOC, ENABLE);
GPIO_InitStructure.GPIO_Pin = LED_PIN;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP;
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_Init(LED_PORT, &GPIO_InitStructure);
}
// LED闪烁线程入口函数
static void led_thread_entry(void *parameter)
{
while (1)
{
// 点亮LED
GPIO_SetBits(LED_PORT, LED_PIN);
rt_thread_mdelay(500); // 延时500ms
// 熄灭LED
GPIO_ResetBits(LED_PORT, LED_PIN);
rt_thread_mdelay(500); // 延时500ms
}
}
// 应用入口
int main(void)
{
rt_err_t result;
// 硬件初始化
led_init();
// 初始化LED线程
result = rt_thread_init(&led_thread,
"led",
led_thread_entry,
RT_NULL,
led_thread_stack,
sizeof(led_thread_stack),
15, // 优先级
10); // 时间片大小
if (result == RT_EOK)
{
// 启动LED线程
rt_thread_startup(&led_thread);
}
return 0;
}
编译下载后，应该能看到PC13上的LED以1秒为周期闪烁。这意味着RT-Thread Nano已成功运行在STM32F103上。
四、资源占用实测对比
为了验证RT-Thread Nano的"轻量"特性，我们进行了一组资源占用对比测试：
| 实现方案 | ROM占用 | RAM占用 | 特性支持 |
|---|---|---|---|
| 纯裸机轮询 | ~2KB | ~256字节 | 单任务，无保护 |
| 裸机+状态机 | ~4KB | ~512字节 | 多状态，调试困难 |
| RT-Thread Nano | ~2.5KB | ~1KB | 多线程、调度、定时器、IPC |
| FreeRTOS（最小配置） | ~6KB | ~2KB | 多线程、调度 |
从数据可以看出，RT-Thread Nano在资源占用方面具有明显优势。与最小配置的FreeRTOS相比，ROM节省约58%，RAM节省约50%，同时还额外提供了软件定时器和完整的进程间通信机制。
五、常见问题与解决方案
在实际移植过程中，可能会遇到以下问题：
问题一：SysTick中断不触发
检查SystemCoreClock是否正确定义，确保SysTick_Config()的参数计算正确。
问题二：启动后系统立即崩溃
确认栈空间是否足够，检查启动文件中Stack_Size和Heap_Size的配置值。
问题三：串口无输出
确保已启用RT_USING_CONSOLE宏定义，并正确配置了串口驱动。
六、总结与展望
通过本次实战，我们成功在STM32F103C8T6上完成了RT-Thread Nano的移植。得益于仅约2.5KB的ROM和1KB的RAM占用，这款"轻量级"内核非常适合资源受限的嵌入式项目。
在后续文章中，我们将进一步探讨如何利用RT-Thread Nano的信号量、消息队列等IPC机制实现更复杂的多任务应用，以及如何通过FinSH命令行工具进行系统调试和状态监控。
