首页/资讯中心/详情

RT-Thread Nano 在 STM32F103 上的 Keil 工程实践与调试指南

RT-Thread Nano 在 STM32F103 上的 Keil 工程实践与调试指南
📅 发布时间：2026/6/30 13:16:11

1. 开发环境搭建与准备

第一次接触RT-Thread Nano时，我完全被它的小巧精悍所吸引。这个仅有3KB内存占用的实时操作系统内核，在STM32F103这类资源有限的芯片上简直是绝配。记得当时我用的是自制的STM32F103RCT6最小系统板，搭配Keil MDK V5.28开发环境，整个过程就像在玩拼图游戏，需要把各个组件严丝合缝地拼接在一起。

硬件准备清单：

  • 主控芯片：STM32F103RCT6（Cortex-M3内核，256KB Flash，48KB RAM）
  • 调试工具：J-Link或ST-Link V2
  • 串口模块：CH340G或CP2102（用于控制台输出）
  • LED指示灯：至少1个（用于基础功能验证）

软件环境配置有个小技巧：建议直接使用Keil官网下载的最新Pack包。我实测发现，通过Keil的Pack Installer安装的RT-Thread Nano版本可能较旧，最好手动下载3.1.5版本的Pack包。安装完成后，在Manage Run-Time Environment界面勾选以下组件：

  • RTOS:RT-Thread Kernel
  • RTOS:RT-Thread Kernel Settings

有个坑我踩过：如果直接使用正点原子的裸机例程作为基础工程，记得先确认工程能正常编译下载。最好先用简单的LED闪烁程序验证硬件基础功能正常，这能避免后续移植时出现硬件问题与软件问题的混淆。

2. 基础移植与系统时钟配置

移植RT-Thread Nano就像给房子打地基，时钟配置就是最重要的地基工程。在标准库环境下，我发现正点原子例程中的delay_init()函数并不适合直接用于RTOS环境，因为它依赖于SysTick的独占使用。

关键移植步骤：

  1. 在board.c中找到rt_hw_board_init()函数
  2. 替换原有的时钟初始化代码为：
SystemCoreClockUpdate(); uint32_t msCnt = SystemCoreClock / RT_TICK_PER_SECOND; SysTick_Config(msCnt);

这段代码的精妙之处在于：SystemCoreClock会自动获取当前CPU主频（比如72MHz），RT_TICK_PER_SECOND默认为1000，这样计算出来的msCnt值正好是1ms需要的时钟周期数。

常见问题排查：

  • 如果编译提示HardFault_Handler等函数重复定义，需要到stm32f10x_it.c中注释掉这三个函数：
//void HardFault_Handler(void) //void PendSV_Handler(void) //void SysTick_Handler(void)
  • 系统时钟不准确？检查是否在main()之前调用了SystemInit()函数
  • 出现Hard Fault？尝试将rtconfig.h中的栈大小从256改为512

我有个实用建议：在rt_hw_board_init()中添加一个LED闪烁的测试代码，这样能直观判断系统是否正常启动。毕竟在早期调试阶段，printf可能还不可用，LED就是最可靠的调试工具。

3. 串口控制台输出实现

让开发板"开口说话"是调试的关键一步。RT-Thread的rt_kprintf()函数比标准printf更轻量，但需要正确实现串口驱动。这里有个重要选择：使用查询方式还是中断方式？

查询方式实现步骤：

  1. 修改正点原子的串口初始化函数，去掉中断相关代码：
void myuart_init(u32 bound){ // 保留GPIO和USART初始化代码 // 删除USART_ITConfig和NVIC_Init相关代码 USART_Cmd(USART1, ENABLE); }
  1. 在board.c中添加控制台输出函数：
void rt_hw_console_output(const char *str){ rt_enter_critical(); while(*str!='\0'){ if(*str == '\n'){ USART_SendData(USART1, '\r'); while(USART_GetFlagStatus(USART1, USART_FLAG_TXE)==RESET); } USART_SendData(USART1, *(str++)); while(USART_GetFlagStatus(USART1, USART_FLAG_TXE)==RESET); } rt_exit_critical(); }

调试技巧：

  • 如果输出乱码，首先检查波特率是否匹配（建议先用115200）
  • 发送不完整？尝试改用USART_FLAG_TXE标志位
  • 记得在rtconfig.h中启用RT_USING_CONSOLE选项

我遇到过最头疼的问题是：当同时使用rt_kprintf和Finsh组件时，如果串口初始化使能了中断，会导致系统卡死。这个坑我花了整整一个下午才排查出来，所以特别提醒：在移植阶段务必使用查询方式！

4. 线程管理与优先级配置

RT-Thread的线程模型非常灵活，但优先级设置需要特别注意。不同于某些RTOS，这里的优先级数字越小优先级越高，这个设计可能让从其他RTOS转来的开发者感到困惑。

线程创建实战示例：

/* 静态线程创建 */ static rt_thread_t tid1; static rt_uint8_t thread1_stack[256]; static void thread1_entry(void *param){ while(1){ rt_kprintf("Thread1 running\n"); rt_thread_mdelay(500); } } /* 动态线程创建 */ static void thread2_entry(void *param){ while(1){ LED0 = !LED0; rt_thread_mdelay(200); } } int main(void){ /* 静态线程初始化 */ rt_thread_init(&tid1, "thread1", thread1_entry, RT_NULL, &thread1_stack[0], sizeof(thread1_stack), 15, 10); /* 动态线程创建 */ rt_thread_t tid2 = rt_thread_create("thread2", thread2_entry, RT_NULL, 256, 20, 5); /* 启动线程 */ rt_thread_startup(&tid1); rt_thread_startup(tid2); while(1){ rt_thread_mdelay(1000); } }

优先级规划建议：

  1. main线程默认优先级为最大优先级/3（如32/3≈10）
  2. Finsh组件默认优先级为21
  3. 用户线程建议设置在10-20之间
  4. 高优先级线程（<10）要谨慎使用，避免饿死低优先级线程

实测中发现：当线程栈空间不足时，不会立即崩溃，而是会出现各种诡异现象。我的经验法则是：初始调试时设置512字节栈空间，稳定后再逐步减小。

5. Finsh组件移植与调试技巧

Finsh就像是RT-Thread的"命令行终端"，有了它，调试效率能提升数倍。但移植过程需要特别注意几个关键点。

完整移植步骤：

  1. 在rtconfig.h中启用以下选项：
#define RT_USING_FINSH #define FINSH_USING_MSH #define FINSH_THREAD_PRIORITY 21 #define FINSH_THREAD_STACK_SIZE 512
  1. 从RT-Thread安装目录复制components/finsh文件夹到工程
  2. 在board.c中实现控制台输入函数：
char rt_hw_console_getchar(void){ int ch = -1; if(USART_GetFlagStatus(USART1, USART_FLAG_RXNE) != RESET){ ch = (char)USART_ReceiveData(USART1); } return ch; }

常见问题解决方案：

  • 输入无响应？检查串口初始化是否误开了中断
  • 命令执行异常？尝试增大Finsh线程栈大小
  • 字符丢失？确认USART_FLAG_TXE标志位使用正确

我最喜欢的一个调试技巧：在Finsh中使用list_thread()命令查看所有线程状态，包括每个线程的剩余栈空间。这比任何调试工具都直观，能快速发现栈溢出问题。

6. 内存管理与优化技巧

在STM32F103这类资源受限的芯片上，内存管理就是生命线。RT-Thread Nano提供了两种内存分配方式：静态内存池和动态堆管理。

内存配置实战：

  1. 在rtconfig.h中设置堆大小：
#define RT_HEAP_SIZE (4*1024) // 根据实际可用RAM调整
  1. 静态内存池使用示例：
static rt_uint8_t pool[1024]; static struct rt_memory_heap static_pool; void mem_init(void){ rt_memory_heap_init(&static_pool, "static_pool", pool, sizeof(pool)); } void *mem_alloc(rt_size_t size){ return rt_memory_heap_alloc(&static_pool, size); }

内存优化技巧：

  • 使用rt_malloc替代标准malloc（更节省空间）
  • 对于频繁分配的小内存块，建议使用内存池
  • 定期使用Finsh的free命令查看内存使用情况
  • 关键线程使用静态内存分配确保稳定性

我遇到过一个典型问题：当同时使用多个线程和Finsh时，默认的256字节栈经常不够用。解决方案是在rtconfig.h中将RT_THREAD_PRIORITY_MAX改为8，同时增大主线程栈大小。

7. 中断处理与性能优化

在实时系统中，中断处理就像交通信号灯，管理不当就会造成"交通堵塞"。RT-Thread提供了完善的中断管理机制。

中断处理最佳实践：

  1. 注册中断服务例程：
rt_isr_handler_t rt_hw_interrupt_install(int vector, rt_isr_handler_t handler, void *param, const char *name);
  1. 中断中调用RT-Thread API的注意事项：
  • 只能使用rt_interrupt_enter/exit标记中断上下文
  • 避免在中断中调用可能导致阻塞的API
  • 耗时操作应该放到线程中处理

性能优化技巧：

  1. 使用rt_kprintf要谨慎，必要时先判断：
if(rt_interrupt_get_nest() == 0){ rt_kprintf("Safe to print\n"); }
  1. 调整系统时钟频率平衡功耗与性能：
void SystemClock_Config(void){ // 根据需求选择不同时钟配置 }
  1. 合理设置RT_TICK_PER_SECOND（通常100-1000Hz）

实测发现：将SysTick中断优先级设置为最低（数值最大）可以减少中断延迟。在STM32上，可以通过NVIC_SetPriority(SysTick_IRQn, 0xF)实现。

8. 项目实战：多任务数据采集系统

最后分享一个真实项目案例：基于STM32F103的温度采集与无线传输系统。这个项目完美展现了RT-Thread Nano在多任务处理中的优势。

系统架构：

  1. 线程1：温度传感器采集（DS18B20，优先级15）
  2. 线程2：无线模块数据传输（NRF24L01，优先级16）
  3. 线程3：用户界面控制（LED+按键，优先级20）
  4. Finsh线程：系统监控与调试（优先级21）

关键代码片段：

/* 温度采集线程 */ static void temp_thread_entry(void *param){ while(1){ float temp = DS18B20_ReadTemp(); rt_mb_send(&temp_mb, (rt_uint32_t)&temp); rt_thread_mdelay(1000); } } /* 无线传输线程 */ static void rf_thread_entry(void *param){ while(1){ float *temp; if(rt_mb_recv(&temp_mb, (rt_uint32_t*)&temp, RT_WAITING_FOREVER) == RT_EOK){ NRF24L01_Send((uint8_t*)temp, sizeof(float)); } } }

项目经验总结：

  1. 使用邮箱（rt_mb）实现线程间通信比全局变量更安全
  2. 传感器读取这类可能阻塞的操作要放在独立线程
  3. 通过Finsh可以实时查看系统状态和传感器数据
  4. 合理设置线程优先级确保关键任务及时响应

这个项目最让我自豪的是：通过RT-Thread Nano的精细控制，整个系统仅占用8KB RAM就实现了复杂的多任务功能，证明了即使在资源受限的STM32F103上也能构建稳健的实时系统。