本帖最后由 Fillmore 于 2019-7-19 10:09 编辑
移植RT-Thread到STM32L475VET6的笔记.pdf
(573.61 KB)
关注了解更多
从本文开始,记录自己的RT-Thread学习笔记,基于STM32L475VET6讲解,相关开发板用RTT&正点原子的潘多拉IoT Board开发板。本文先从Nano开始学起,个人觉得对于初学者,还是先学会Nano的移植,把内核部分向学一遍,再去学组件和设备驱动以及其他的东西,这里包括RT-Thread的内核移植、FinSH移植,相关代码到GitHub下载:https://github.com/sanjaywu/STM32L475_PANDORA_RT-Thread_DEMO
一、获取裸机工程
1、裸机工程可到GitHub下载:https://github.com/sanjaywu/STM32L475_PANDORA_DEMO,下载完成之后,打开工程文件夹,可以发现如下文件:
2、接着我们把HARDWARE、SYSTEM和USMART这三个文件删除,HARDWARE文件夹是裸机的外设驱动,在讲解移植的时候不需要用到,SYSTEM文件夹有delay延时、串口驱动和相关类型宏定义,在移植RT-Thread的时候,我们会重新实现delay延时和串口驱动以及类型宏定义。
二、下载 RT-Thread Nano 源码
1、RT-Thread Master 的源码可从 RT-Thread GitHub 仓库下载,Nano 就是从里面扣出来的,去掉了一些组件和各种开发板的 BSP,保留了 OS的核心功能,但足够我们使用。RT-Thread 官方并没有将抠出来的Nano 放 到 他 们 的 官 方 网 站 , 而 是 作 为 一 个 Package 放 在 了 KEIL 网 站:http://www.keil.com/dd2/pack/,目前最新的是3.1.1版本,打开这条连接,然后拉到下面找到RT-Thread的Package:
2、点击箭头下载,弹出窗口点击OK,然后开始下载:
3、下载完成之后双击安装这个pack,安装的路径和你安装MDK5的时候是一样的,我安装的是默认路径。
4、安装完成之后,找到你安装MDK5的路径,然后按这个路径找到RT-Thread的源码:C:\Keil_v5\ARM\PACK\RealThread\RT-Thread\3.1.1:
三、往裸机工程添加 RT-Thread 源码
1、在前面下载好的裸机工程里,再新建一个文件夹为RT-Thread的,然后将上面下载好的Nano版源码拷贝到这个文件:
2、对于Nano源码各个文件内容删减:
(1)打开bsp,这里RT-Thread是放底层驱动的东西:
除了board.c和rtconfig.h这两个文件,其他都删除,然后再新建一个board.h头文件。
(2)打开components,RT-Thread组件放置的地方,只有一个finsh,保留它,这个finsh非常好用:
(3)打开libcpu —> arm,因为用的是STM32L4xx,时候cortex-m4,所以只需保留cortex-m4即可,其它都删除:
(4)剩下的include和src文件设RT-Thread的头文件和内核源码,不能删除,保留完整。
(5)接着,新建一个文件夹来放设备驱动,命名device_drivers。这里为什么要用RT-Thread设备驱动呢,因为RT-Thread的finsh功能实现需要串口,这里就用先只设备驱动里面的串口驱动来实现,自己产品能够RT-Thread的master版本中整理出来,代码可以看工程(https://github.com/sanjaywu/STM32L475_PANDORA_RT-Thread_DEMO)里面的,这样既能实现finsh也能实现rt_kprintf。当然你也可以自己写一个串口驱动,只不过后面一直finsh就会很麻烦,读写函数都要改掉,而且容易出错。
最终移植整理好之后,RT-Thread的文件如下:
四、修改rt_config.h
#ifndef __RTTHREAD_CFG_H__
#define __RTTHREAD_CFG_H__
/* RT-Thread内核部分 */
#define RT_NAME_MAX 8 //内核对象名称最大长度,大于该长度的名称多余部分会被自动裁掉
#define RT_ALIGN_SIZE 4 //字节对齐时设定对齐的字节个数。常使用ALIGN(RT_ALIGN_SIZE)进行字节对齐
#define RT_THREAD_PRIORITY_MAX 32 //定义系统线程优先级数;通常用RT_THREAD_PRIORITY_MAX-1定义空闲线程的优先级
#define RT_TICK_PER_SECOND 1000 //定义时钟节拍,为1000时表示1000个tick每 秒,一个tick为1ms
#define RT_USING_OVERFLOW_CHECK //检查栈是否溢出,未定义则关闭
#define RT_DEBUG //定义该宏开启debug模式,未定义则关闭
#define RT_DEBUG_INIT 0 //开启debug模式时:该宏定义为0时表示关闭打印组件初始化信息,定义为1时表示启用
#define RT_DEBUG_THREAD 0 //开启debug模式时:该宏定义为0时表示关闭打印线程切换信息,定义为1时表示启用
#define RT_USING_HOOK //定义该宏表示开启钩子函数的使用,未定义则关闭
#define IDLE_THREAD_STACK_SIZE 256 //定义了空闲线程的栈大小
/*
线程间同步与通信部分,
该部分会使用到的对象有信号量、
互斥量、事件、邮箱、消息队列、信号等
*/
#define RT_USING_SEMAPHORE //定义该宏可开启信号量的使用,未定义则关闭
#define RT_USING_MUTEX //定义该宏可开启互斥量的使用,未定义则关闭
#define RT_USING_EVENT //定义该宏可开启事件集的使用,未定义则关闭
#define RT_USING_MAILBOX //定义该宏可开启邮箱的使用,未定义则关闭
#define RT_USING_MESSAGEQUEUE //定义该宏可开启消息队列的使用,未定义则关闭
#define RT_USING_SIGNALS //定义该宏可开启信号的使用,未定义则关 闭
/* 内存管理部分 */
#define RT_USING_MEMPOOL //定义该宏可开启静态内存池的使用,未定义则关闭
#define RT_USING_MEMHEAP //定义该宏可开启两个或以上内存堆拼接的使用,未定义则关闭
#define RT_USING_SMALL_MEM //定义该宏可开启开启小内存管理算法,未定义则关闭
//#define RT_USING_SLAB //定义该宏可开启SLAB内存管理算法,未定义则关闭
#define RT_USING_HEAP //定义该宏可开启堆的使用,未定义则关闭
/* 内核设备对象 */
#define RT_USING_DEVICE //表示开启了系统设备的使用,使用设备驱动
#define RT_USING_CONSOLE //定义该宏可开启系统控制台设备的使用,未定义则关闭
#define RT_CONSOLEBUF_SIZE 128 //定义控制台设备的缓冲区大小
#define RT_CONSOLE_DEVICE_NAME "uart1" //控制台设备的名称
/* 自动初始化方式 */
#define RT_USING_COMPONENTS_INIT //定义该宏开启自动初始化机制,未定义则关闭
#define RT_USING_USER_MAIN //定义该宏 启设置应用入口为main函数
#define RT_MAIN_THREAD_STACK_SIZE 2048 //定义main线程的栈大小
/* FinSH */
#define RT_USING_FINSH //定义该宏可开启系统FinSH调试工具的使用,未定义则关闭
#ifdef RT_USING_FINSH
#define FINSH_THREAD_NAME "tshell" //开启系统FinSH时:将该线程名称定义为tshell
#define FINSH_USING_HISTORY //开启系统FinSH时:使用历史命令
#define FINSH_HISTORY_LINES 5 //开启系统FinSH时:对历史命令行数的定义
#define FINSH_USING_SYMTAB //开启系统FinSH时:定义该宏开启使用Tab键,未定义则关闭
#define FINSH_THREAD_PRIORITY 20 //开启系统FinSH时:定义该线程的优先级
#define FINSH_THREAD_STACK_SIZE 4096 //开启系统FinSH时:定义该线程的栈大小
#define FINSH_CMD_SIZE 80 //开启系统FinSH时:定义命令字符长度
#define FINSH_USING_MSH //开启系统FinSH时:定义该宏开启MSH功能
#define FINSH_USING_MSH_DEFAULT //开启系统FinSH时:开启MSH功能时,定义该宏默认使用MSH功能
#define FINSH_USING_MSH_ONLY //开启系统FinSH时:定义该宏,仅使用MSH功能
#endif
/* 关于 MCU */
#define STM32L475VE //定义该工程使用的MCU为STM32L475VE
#define RT_HSE_VALUE 8000000 //定义时钟源频率
#define RT_USING_LED //定义该宏开启LED的使用
#define RT_USING_SERIAL //定义该宏开启串口的使用
#define BSP_USING_UART1 //定义该宏开启UART1的使用
#endif/* __RTTHREAD_CFG_H__ */
|