文章目录
第一步:获取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()一样。要实现串口打印功能,首先需要给工程添加串口初始化相关代码,串口初始化和裸机中串口的使用是一模一样的。这里串口只需要使能接收功能,发送功能和发送中断可以不使用。
rt_kprintf通过调用rt_hw_console_output
来进行打印,而rt_hw_console_output
函数在kerveice.c中是一个空函数,因此需要我们自行定义该函数实现打印功能。
在board.c中定义rt_hw_console_output
函数,在定义该函数之前需要配置usart,并且在board.h中进行usart的初始化。
效果如下:
参考:嵌入式@hxydj