如何移植RT-Thread的BSP
前言
最近RT-Thread重构了stm32的BSP，看了一下，感觉很思路很清晰
| 目录 | 简介 |
| bsp\stm32\docs | 重构BSP的介绍文档 |
| bsp\stm32\libraries | 各系列的stm32的HAL库 |
| bsp\stm32\libraries\HAL_Drivers | 基于HAL库的设备驱动 |
| bsp\stm32\libraries\HAL_Drivers\config | 外设驱动的配置文件 |
| bsp\stm32\libraries\HALDrivers\drv_flash | flash的配置文件 |
| bsp\stm32\libraries\templates | 移植BSP的模板 |
| bsp\stm32\stm32fxxx-xxx-xxx | 各开发板的适配工程 |
我觉得这就是我想要的，于是就开始移植重构后的BSP
移植流程
-
复制一个与自己开发板系列相近的BSP
-
修改Scons脚本文件
-
修改驱动文件
-
规范BSP
复制一个与自己开发板系列相近的BSP
先找一个和自己开发板MCU类似的BSP，例如我的开发板的MCU是stm32f767，所以我复制了这个目录下的工程
bsp\stm32\stm32f429-fire-challenger
修改名字为你的开发板名字，例如我的
bsp\stm32\stm32f767-fire-challenger
然后，在libraries目录下加入你使用的MCU系列的HAL库文件，比如我的f7系列就是
bsp\stm32\libraries\STM32F7xx_HAL
HAL库文件可以从STM32CubeFx中解压得到
然后参照着已经有的HAL库文件夹的情况，将一些使用不到的文件删除，特别是以下文件需要删除，否则会报错
bsp\stm32\libraries\STM32F7xx_HAL\STM32F7xx_HAL_Driver\Src\stm32f7xx_hal_msp_template.c bsp\stm32\libraries\STM32F7xx_HAL\STM32F7xx_HAL_Driver\Src\stm32f7xx_hal_timebase_rtc_alarm_template.c bsp\stm32\libraries\STM32F7xx_HAL\STM32F7xx_HAL_Driver\Src\stm32f7xx_hal_timebase_rtc_wakeup_template.c bsp\stm32\libraries\STM32F7xx_HAL\STM32F7xx_HAL_Driver\Src\stm32f7xx_hal_timebase_tim_template.c
在移植完成后，将
bsp\stm32\stm32f767-fire-challenger
复制到下面这个目录
bsp\stm32\libraries\templates
将名字更改为
bsp\stm32\libraries\templates\stm32f7xx
修改Scons脚本文件
需要修改的脚本文件有点多，不过不急，慢慢来
可以从我提交的pr中看到我修改过的脚本文件，我将他们全部列出来，免得有人遗漏了需要修改的地方
-
bsp/stm32/libraries/HAL_Drivers/SConscript
-
bsp/stm32/libraries/HALDrivers/drvconfig.h
-
bsp/stm32/libraries/Kconfig
-
bsp/stm32/libraries/STM32F7xx_HAL/SConscript
-
bsp/stm32/stm32f767-fire-challenger/Kconfig
-
bsp/stm32/stm32f767-fire-challenger/SConscript
-
bsp/stm32/stm32f767-fire-challenger/SConstruct
-
bsp/stm32/stm32f767-fire-challenger/applications/SConscript
-
bsp/stm32/stm32f767-fire-challenger/board/Kconfig
-
bsp/stm32/stm32f767-fire-challenger/board/SConscript
-
bsp/stm32/stm32f767-fire-challenger/rtconfig.py
-
bsp/stm32/libraries/templates/stm32f7xx/Kconfig
-
bsp/stm32/libraries/templates/stm32f7xx/SConscript
-
bsp/stm32/libraries/templates/stm32f7xx/SConstruct
-
bsp/stm32/libraries/templates/stm32f7xx/applications/SConscript
-
bsp/stm32/libraries/templates/stm32f7xx/board/Kconfig
-
bsp/stm32/libraries/templates/stm32f7xx/board/SConscript
-
bsp/stm32/libraries/templates/stm32f7xx/rtconfig.py
看着脚本文件很多，其实也不是太麻烦，只要参考已有的模板，该起来很容易的，那么接下来一个个来讲解吧
bsp/stm32/libraries/HAL_Drivers/SConscript
需要在这个文件中加入你的soc系列，按顺序排好，如图
bsp/stm32/libraries/HALDrivers/drvconfig.h
同上，加入你的soc系列
bsp/stm32/libraries/Kconfig
同上，加入你的soc系列
bsp/stm32/libraries/STM32F7xx_HAL/SConscript
这个文件可以从下面这个地址复制过来
bsp\stm32\libraries\STM32F4xx_HAL\SConscript
然后修改图中标记部分
bsp/stm32/stm32f767-fire-challenger/Kconfig
这个文件可以从下面这个地址复制过来
bsp\stm32\stm32f429-fire-challenger\Kconfig
bsp/stm32/stm32f767-fire-challenger/SConscript
这个文件可以从下面这个地址复制过来
bsp\stm32\stm32f429-fire-challenger\SConscript
bsp/stm32/stm32f767-fire-challenger/SConstruct
这个文件可以从下面这个地址复制过来
bsp\stm32\stm32f429-fire-challenger\SConstruct
bsp/stm32/stm32f767-fire-challenger/applications/SConscript
这个文件可以从下面这个地址复制过来
bsp\stm32\stm32f429-fire-challenger\applications\SConscript
bsp/stm32/stm32f767-fire-challenger/board/Kconfig
这个文件可以从下面这个地址复制过来
bsp\stm32\stm32f429-fire-challenger\board\Kconfig
不过需要修改图中标记部分
bsp/stm32/stm32f767-fire-challenger/board/SConscript
这个文件可以从下面这个地址复制过来
bsp\stm32\stm32f429-fire-challenger\board\SConscript
不过需要修改图中标记部分
bsp/stm32/stm32f767-fire-challenger/rtconfig.py
这个文件可以从下面这个地址复制过来
bsp\stm32f7-disco\rtconfig.py
我是从旧版BSP中找的，你也可以找找你对应型号的旧版BSP中的这个脚本
之后这个templates中的脚本修改内容和前面基本一样的
bsp/stm32/libraries/templates/stm32f7xx/Kconfig
这个文件可以从下面这个地址复制过来
bsp\stm32\libraries\templates\stm32f4xx\Kconfig
bsp/stm32/libraries/templates/stm32f7xx/SConscript
这个文件可以从下面这个地址复制过来
bsp\stm32\libraries\templates\stm32f4xx\SConscript
bsp/stm32/libraries/templates/stm32f7xx/SConstruct
这个文件可以从下面这个地址复制过来
bsp\stm32\libraries\templates\stm32f4xx\SConstruct
bsp/stm32/libraries/templates/stm32f7xx/applications/SConscript
这个文件可以从下面这个地址复制过来
bsp\stm32\libraries\templates\stm32f4xx\applications\SConscript
bsp/stm32/libraries/templates/stm32f7xx/board/Kconfig
这个文件可以从下面这个地址复制过来
bsp\stm32\libraries\templates\stm32f4xx\board\Kconfig
不过需要修改图中标记部分
bsp/stm32/libraries/templates/stm32f7xx/board/SConscript
这个文件可以从下面这个地址复制过来
bsp\stm32\libraries\templates\stm32f4xx\board\SConscript
不过需要修改图中标记部分
bsp/stm32/libraries/templates/stm32f7xx/rtconfig.py
这个文件可以从下面这个地址复制过来
bsp\stm32f7-disco\rtconfig.py
修改驱动文件
驱动文件分为：实现和配置
实现是下面这个目录下的.c文件
bsp\stm32\libraries\HAL_Drivers
配置是以下目录下的.h和部分.c文件
bsp\stm32\libraries\HAL_Drivers\config\fx bsp\stm32\libraries\HAL_Drivers\drv_flash bsp\stm32\stm32f767-fire-challenger\board\ports
我们需要做的事就是根据开发板实际情况进行修改
下面以移植uart为例子
先确认config文件是否符合开发板实际情况，同一个系列的MCU的移植不需要修改config
bsp\stm32\libraries\HAL_Drivers\config\f7\uart_config.h
根据HAL库的情况修改以下文件
bsp\stm32\libraries\HAL_Drivers\drv_usart.c
例如f7系列，参照stm32f7xxhaluart.h，看看什么drv_usart.c中使用到的API是stm32f7xx_hal_uart.h中没有的，改为stm32f7xx_hal_uart.h有的接口，可以参考下面的方式
还要注意一些寄存器是某些系列的产品特有的，要用宏定义区分，例如
其他需要修改的地方都是差不多的，可以参考一下我的修改
在移植完驱动后，需要使用Cubemx启动外设，这部分请参考如何添加更多的片上资源选项
不过串口1默认是开启的
规范BSP
这部分请参考STM32 系列 BSP 制作规范
移植到此结束，欢迎尝试
