RT-Thread移植到STM32F407

news2025/7/19 21:53:53

文章目录

- - 第一步：获取RT-Thread源码
  - 第二步：项目结构介绍
  - 第三步：拷贝示例代码到裸机工程
  - 第四步：删除无用文件
  - 第五步：修改工程目录结构
  - 第六步：添加工程文件路径
  - 第七步：编译
  - 第八步：修改配置文件
  - 第九步：编写测试程序
  - 第十步：重映射串口到rt_kprintf函数

第一步：获取RT-Thread源码

首先到rtthread官网下载rt-thread nano后解压

解压后打开后内容如下

第二步：项目结构介绍

各文件夹的作用如下：

第三步：拷贝示例代码到裸机工程

拷贝一份到Keil工程的工程根目录下，示例工程采用野火STM32F407霸天虎的使用固件库点亮LED灯的代码，示例代码可以去野火官网下载。

第四步：删除无用文件

bsp里面存放了不同板子的示例，我们只需要保留board.c和rtconfig.h这两个配置文件即可，其他的均可删除
docs存放了移植教程的地址，可以删掉
libcpu里存放与处理器相关的接口文件，因为本次是移植到STM32F407，所以我们只需要保留``libcpu/arm/cortex-m4`这一个文件夹即可，其他皆可删除。
将rt-thread目录下的bsp文件夹下的board.c和rtconfig.h移动到USER目录下，USER存放供我们自行修改的一些文件。board.c和rtconfig.h是提供的配置文件

第五步：修改工程目录结构

打开工程
打开工程项目管理 Manage Project Items
在Groups中选择USER,在右边Files中添加\rt-thread\rt-thread-3.1.3\bsp文件中的board.c文件
在Groups中选择USER,在右边Files中添加\rt-thread\rt-thread-3.1.3\bsp文件中的rtconfig.h文件
在Groups中选择新建，新建rtt/source组,在右边Files中添加\rt-thread\rt-thread-3.1.3\src文件夹中的所有.c文件
在Groups中选择新建，新建rtt/port组,在右边Files中添加rt-thread\rt-thread-3.1.3\libcpu\arm\cortex-m3文件夹下的context_rvds.S和cpuport.c文件
给工程添加头文件路径，凡是文件夹中包含.h文件，就需要将文件夹路径添加进去

          ..\rt-thread\rt-thread-3.1.3\components\finsh

           ..\rt-thread\rt-thread-3.1.3\include\libc

           ..\rt-thread\rt-thread-3.1.3\include

第六步：添加工程文件路径

第七步：编译

编译后发现没有RTE_Components.h这个文件，头文件 RTE_Components.h是在 MDK中添加 RT-Thead Package 时由 MDK 自动生成的，目前我们没有使用 MDK 中自带的 RT-Thread 的 Package，所以这个头文件不存在，如果包含了该头文件，编译的时候会报错，需要修改 rtconfig.h 头文件，将相关代码注释掉。

打开rtconfig.h找到#include "RTE_Components.h"将其注释

之后再编译一次

这时候错误就剩下了三个了,提示是有三个中断函数重复定义了。这时因为RT-Thread系统把这三个中断函数已经实现了，但是在stm32f10x_it.c这个文件中,也有这个三个中断函数，但是函数内是空的，没有实现。需要将 stm32f4xx_it.c 文件中的这个三个中断函数注释掉。

再编译一次，没有问题了

第八步：修改配置文件

board.c和rtconfig.h是两个配置文件。

在文件目录下新建一个board.h文件并添加到工程目录中添加如下代码：

#ifndef __BOARD_H__
#define __BOARD_H__
 
/* STM32 固件库头文件 */
#include "stm32f4xx.h"
 
/* RT-Thread相关头文件 */
#include <rthw.h>
#include <rtthread.h>
 
/* 开发板硬件bsp头文件 */
#include "./led/bsp_led.h"
 
 
#endif /* __BOARD_H__ */

以后所有需要添加进工程的头文件添加到board.h中即可。

在board.c中，因为刚才把头文件都添加到board.h中了，所以board.c中包含的头文件删除，添加#include "board.h"即可，main.c同理

注释或者删除和时钟相关的宏定义和时钟配置函数

屏蔽掉rt_hw_board_init()函数中的 SystemCoreClockUpdate(); 和 _SysTick_Config( SystemCoreClock / RT_TICK_PER_SECOND ); 函数调用。

重新添加时钟初始化语句 SysTick_Config( SystemCoreClock / RT_TICK_PER_SECOND );

将LED初始化代码从主函数中剪切到时钟初始化语句下面。

第九步：编写测试程序

RT-Thread中习惯使用动态内存堆新建线程，因此在rt_config.h中取消掉#define RT_USING_HEAP的注释

现在我们可以使用动态内存堆新建线程了

将下述代码拷贝到main.c中，编译下载可以看到红灯和绿灯交替闪烁，系统移植成功。

#include "board.h"

/* 声明线程1、2入口函数 */
static void led1_thread_entry(void *parameter);
static void led2_thread_entry(void *parameter);

/* 定义线程控制块 */
static rt_thread_t led1_thread = RT_NULL;
static rt_thread_t led2_thread = RT_NULL;

/**
  * @brief  主函数
  * @param  无
  * @retval 无
  */
int main(void)
{
	/* 创建线程 */
	led1_thread = rt_thread_create("led1",/* 线程名字 */
									led1_thread_entry, /* 线程入口函数 */ 
									RT_NULL, /* 线程入口函数参数 */ 
									512, /* 线程栈大小 */ 
									3, /* 线程的优先级 */
									20); /* 线程时间片 */
	led2_thread = rt_thread_create("led2",/* 线程名字 */
									led2_thread_entry, /* 线程入口函数 */ 
									RT_NULL, /* 线程入口函数参数 */ 
									512, /* 线程栈大小 */ 
									3, /* 线程的优先级 */
									20); /* 线程时间片 */
	
	/* 启动线程 */
	if(led1_thread != RT_NULL)
		rt_thread_startup(led1_thread);
	else
		return -1;
	if(led2_thread != RT_NULL)
		rt_thread_startup(led2_thread);
	else
		return -1;
}
static void led1_thread_entry(void *parameter)
{
	while(1)
	{
		LED1_ON;
		rt_thread_delay(500);
		LED1_OFF;
		rt_thread_delay(500);
	}
}
static void led2_thread_entry(void *parameter)
{
	while(1)
	{
		LED2_OFF;
		rt_thread_delay(500);
		LED2_ON;
		rt_thread_delay(500);
	}
	
}
/*********************************************END OF FILE**********************/

第十步：重映射串口到rt_kprintf函数

在平时调试代码的时候，经常需要用到串口的打印功能。RT-Thread提供了一个专用的打印函数rt_kprintf(),该函数在kservice.c中声明，这个函数的功能和printf()一样。要实现串口打印功能，首先需要给工程添加串口初始化相关代码，串口初始化和裸机中串口的使用是一模一样的。这里串口只需要使能接收功能，发送功能和发送中断可以不使用。