RT-Thread编程指南 要点摘录（八）——内核移植

——理论忠于实践——

9内核移植

移植可分为 CPU 架构移植和 BSP（Board support package，板级支持包）移植两部分。

9.0移植前的准备

在移植之前，应该对RT-Thread的目录结构有一定的了解：

1. include和src目录用于放置RT-Thread的实时核心代码文件；
2. components目录用于放置各类组件；
3. tools是用于放置RT-Thread的构建环境scons的一些扩展脚本；
4. bsp和libcpu则是移植相关的部分。

components文件夹内的文件并非全部需要移植，由用户自行选定。

bsp文件夹内的文件针对各类常用的开发板编写，一般不能现成使用。

SConscript是Scons的一个脚本文件，Scons是一个开放源码、以Python语言编码的自动化构建工具

下图为RT-Thread的文件目录

以stm32f4移植为例：
在bsp中保留board.c和rtconfig.h
components中保留所需组件如finsh、fds等；
libcpu中保留cortex-m4和common文件夹;
保留include和src；
新建“device_drivers”，放置RT-Thread的设备驱动框架，保留所需文件（文件路径：compontents\drivers)；需保留drivers\src全部文件

*当不使用RT-Thread中的libcpu目录时：
•applications，用于放置用户应用的目录；
•components，用于放置用户自己的组件；
• cpu，替代原来的 libcpu目录，放置芯片移植相关的代码、驱动；
• driver，用户自行编写的驱动；
• documents，用户文档；
• Libraries，一些相对固定的库文件；

通常来说，对于一个移植，除了bsp、libcpu目录以外，其他的目录和文件不应该被修改；

9.1CPU 架构移植

RT-Thread 提供了一个 libcpu 抽象层来适配不同的 CPU 架构。
libcpu 层向上对内核提供统一的接口，向下提供了一套统一的 CPU 架构移植接口。

1. 实现全局中断开关
2. 实现线程栈初始化
3. 实现上下文切换
4. 实现时钟节拍

对于一种已知完成移植的内核(比如Cortex-M3,Cortex-M4等),其libcpu部分也已经存在,完全没有重写的必要,只要完成相关bsp移植部分即可。

以Cortex-M4为例，创建相关文件夹，添加：

1. rt-thread\libcpu\arm\common目录下所有文件

backtrace.c:回溯堆栈,用于程序异常退出时寻找错误原因
div0.c
showmem.c:显示内存

2. rt-thread\libcpu\arm\cortex-m4目录下所有文件

cpuport.c
context_rvds.S:RVDS（RealView Development Suite）是ARM公司最新推出的面向SOC和大型复杂应用程序的高端开发工具。

9.2BSP 移植

RT-Thread 提供了 BSP 抽象层来适配常见的板卡。
为了建立让操作系统运行的基本环境，需要完成的主要工作是：

1. 初始化 CPU 内部寄存器，设定 RAM 工作时序。
2. 实现时钟驱动及中断控制器驱动，完善中断管理。
3. 实现串口和 GPIO 驱动。
4. 初始化动态内存堆，实现动态堆内存管理。

9.3移植基本步骤

1.创建文件夹

1. application :存放应用程序

2. drivers :用户自行编写的驱动

3. components :存放RT-Thread组件

4. DeviceDrivers :存放RT-Thread的设备驱动框架

5. libcpu :CPU架构移植代码

6. kenel :存放RT-Thread的相关内核文件

2.修改配置文件

以下文件位于rt-thread\bsp\stm32，在该文件夹中选取与自己设计的板子最接近的开发板型号文件夹。

修改rtconfig.h
修改board.c：
添加系统时钟初始函数；
修改Tick相关函数；
修改rt_hw_board_init函数，初始化SysTick；
增加RT-Thread堆空间大小；

BSP外设驱动

以下摘自rt-thread\bsp\stm32\docs

在 RT-Thread 实时操作系统中，各种各样的设备驱动是通过一套 I/O 设备管理框架来管理的。设备管理框架给上层应用提供了一套标准的设备操作 API，开发者通过调用这些标准设备操作 API，可以高效地完成和底层硬件外设的交互。

对于一个BSP而言，有以下三类驱动：

1. 板载外设驱动
2. 片上外设驱动
3. 扩展外设驱动

当前 RT-Thread 提供的驱动库已经支持 STM32 多个系列的 BSP。通过使用 ENV 工具对 BSP 进行配置，可以开启更多板载资源，实现更多高级功能。

组件移植

组件文件位置：rt-thread\components

常用的组件有dfs（虚拟文件系统）、FinSH、libc等；
这些文件夹需添加至components内。
——
在drivers文件夹中，用户可自行添加所需驱动；

finsh功能实现需要串口 serial.c

其中src文件夹必须被添加：

即在DeviceDrivers文件夹中添加：

1. rt-thread\components\用户所需驱动
2. rt-thread\components\src文件夹下全部文件

——
在组件文件夹中还有一个文件夹libc，是Linux下的ANSI C的函数库。

系统内核移植

在kernel文件夹中添加：rt-thread\src文件夹内所有文件

移植相关文件统计

cm3

rtthread/
rtthread/bsp
rtthread/cortex-m3
rtthread/cortex-m3/context_gcc.S
rtthread/cortex-m3/context_iar.S
rtthread/cortex-m3/context_rvds.S
rtthread/cortex-m3/cpuport.c
rtthread/cortex-m3/SConscript
rtthread/include
rtthread/include/libc
rtthread/include/libc/libc_dirent.h
rtthread/include/libc/libc_errno.h
rtthread/include/libc/libc_fcntl.h
rtthread/include/libc/libc_fdset.h
rtthread/include/libc/libc_ioctl.h
rtthread/include/libc/libc_signal.h
rtthread/include/libc/libc_stat.h
rtthread/include/rtdbg.h
rtthread/include/rtdebug.h
rtthread/include/rtdef.h
rtthread/include/rthw.h
rtthread/include/rtlibc.h
rtthread/include/rtm.h
rtthread/include/rtservice.h
rtthread/include/rtthread.h
rtthread/rtconfig.h
rtthread/src
rtthread/src/clock.c
rtthread/src/cpu.c
rtthread/src/device.c
rtthread/src/idle.c
rtthread/src/ipc.c
rtthread/src/irq.c
rtthread/src/Kconfig
rtthread/src/kservice.c
rtthread/src/mem.c
rtthread/src/memheap.c
rtthread/src/mempool.c
rtthread/src/object.c
rtthread/src/scheduler.c
rtthread/src/SConscript
rtthread/src/signal.c
rtthread/src/slab.c
rtthread/src/thread.c
rtthread/src/timer.c

参考https://www.jianshu.com/p/3e4926b5a4c1

推荐阅读：https://blog.csdn.net/Sanjay_Wu/article/details/86582759

——待续——