MAC/Linux环境下STM32H743基础BSP搭建

发布于 2019-08-26 22:59:39 浏览：5908 订阅该版

[tocm]

目前RTT主流的开发环境是Windows+Keil,如果一些朋友喜欢用linux或者macOS又该如何去做RT-Thread+STM32的硬件开发呢？我看整个论坛这样的帖子就非常少，所以今天决定写一篇基于macOS环境下的STM32H743，rt-thread移植教程，希望能在rt-thread的推广上做出自己的一点小小贡献，给大家抛砖引玉。Linux环境下与macOS基本一致。

## 一、素材准备

* Armfly-V7 STM32H743XIH6开发板
* RT-Thread 长期支持版 lts-v3.1.x
* Macbook Pro
* scons
* macOS下的ARM交叉编译工具

## 二、MAC下开发环境搭建

* 安装scons

在Windows环境下，有官方直接制作好的[ENV工具](https://pan.baidu.com/s/1cg28rk#list/path=%2F)，按照工具内的使用说明基本上就是开箱即用。

在MAC环境下，需要自己安装scons软件，才能达到Windows下的效果。MAC下在终端内输入如下命令安装scons:

```
brew install scons
```

目前最新的scons版本应该是3.1.1，安装好可查看socns版本：
![WechatIMG110.png](/uploads/201908/26/213102k25iud5iu7aibzh5.png)

### * 安装ARM交叉编译工具链

在MAC下编译STM32的程序，要用ARM-GCC交叉编译工具，这里直接从ARM官网下载。[点我下载](https://developer.arm.com/tools-and-software/open-source-software/developer-tools/gnu-toolchain/gnu-rm/downloads)

我用的是8-2-18-q4-major，记得选Mac OSX-64bit版本。下载好之后自己定义一个目录解压之，然后把它添加到环境变量（PATH）
这是我的解压目录位置：
![WechatIMG112.png](/uploads/201908/26/213855flkxrr0ptnlw9faz.png)

将上述目录添加到用户的环境变量里，即在用户目录下的.bash_profile文件中加上如下语句：
![WechatIMG113.png](/uploads/201908/26/214226bzlyggu6sqmyyk46.png)

重启终端或者在用户目录下（~ 目录，懂Unix的应该都懂 ~）执行 source .bash_profile 即可
在终端内执行如下命令即可看到arm-gcc的版本号：

```
arm-none-eabi-gcc -v
```       
![WechatIMG114.png](/uploads/201908/26/214631fsn3f638nndhc6bh.png)

### * 安装VS Code (可选)

至此，MacOS下所用的软件和环境都已经准备好了

## 三、RT-Thread在STM32H743XI上的移植

### * rt-thread源代码瘦身大作战

下载 [rt-thread-lts-v3.1.x](https://github.com/RT-Thread/rt-thread) 并解压，进入到bsp目录内，除了保留stm32文件夹外，删掉所有其他不相关的bsp文件，你会发现rtt会清爽很多

进入stm32目录下，除保留doc、libraries和stm32h743-atk-apollo文件夹外，其余全部删除，你会发现又清爽很多

### 继续瘦身+换血
进入libraries目录，除保留HAL_Drivers文件夹、Kconfig文件、STM32H7xx_HAL文件夹 和 templates文件夹外，其余全部删除，又清爽很多

更新STM32H7最新的HAL库文件，目前能从STM32CubeMX下载下来最新的HAL文件版本是1.5.0 。 进入STM32H7xx_HAL文件夹内，删除CMSIS和STM32H7xx_HAL_Driver文件夹，将从STM32CubeMX中下载的最新CMSIS和STM32H7xx_HAL_Driver拷贝至该目录内。删除 `../STM32H7xx_HAL_Driver/Src/`目录下带template名的4个.c文件（那是给STM32官方板用的，我们基本无用）；
删除`../STM32H7xx_HAL_Driver/Inc/`目录下stm32_assert_template.h头文件。至此，HAL库更新完毕

其他部分参考stm32/doc目录下的BSP制作教程基本上就可以了，但是还是不能用，有些坑我来教大家填平！！！

### 填坑之路

- 参考文档，将template文件夹内的全部文件拷贝至自己新建的文件夹姑且叫stm32h743xi-armfly内，该目录以下简称bsp开发目录
- 我们开发用的是GCC环境，所以你可以把bsp开发目录下所有keil和IAR相关的工程文件全部删掉，真的会清爽很多很多
- 修改bsp开发目录下的rtconfig.py文件内的第20行，指定ARM-GCC编译链的目录，如下图所示，此路径在MAC环境搭建条目下有设置，不要忘了哦。
![WechatIMG115.png](/uploads/201908/26/222431f4wwlpyje1pg7z1m.png)

- 此处是天坑，官方文档没有说明（我的同事没有改，你可以认为我也是官方人士:lol）

天坑来了！ 在`bsp\stm32\libraries\STM32H7xx_HAL\CMSIS\Device\ST\STM32H7xx\Source\Templates\gcc`目录下，打开startup_stm32h743xx.s文件，作如下修改：
![WechatIMG116.png](/uploads/201908/26/223007lg6t3s76z3hb1a30.png)

注释掉第95行，__libc_init_array这个是libc的初始化，我们不用libc
第97行，将 bl main 改为 bl entry ，entry是rtt的入口

如果你不做上述修改，真的，你编译绝对不会报错，但是下载进板子，板子没任何反应起不来，跟砖头没两样

- 基本就这些操作，我不打算上传我做好的BSP，我真心希望您自己走一遍，这里面可能有些点我没有提到，但都是小问题，看下sconscript或者是kconfig文件都能解决，如果实在不能解决，欢迎留言，我一一解答

## 四、BSP配置、编译、烧录下载

### 配置

进入bsp开发目录（看上文，确认请我说的是哪个目录），执行 scons --menuconfig 就可以实现在Windows下ENV中menuconfig命令的作用

![WechatIMG117.png](/uploads/201908/26/223933uf5qegbybpbx8zb2.png)

配置完保存，会自动生成rtconfig.h文件，非常方便

### 编译

在bsp开发目录，输入  scons ，此时会自动开始编译链接，输入 scons -j32 ,相信我，你的编译速度会飞起来的:lol

编译成功如下图所示：
![WechatIMG118.png](/uploads/201908/26/224342k6ayzneiat3j1vwi.png)

编译完自动会生成rtthread.elf和rtthread.bin文件，这两个文件都是可以直接下载使用的，但是唯独没有hex文件，如下有两个方法生成hex文件

1. 修改rtconfig.py文件第63行，将其中的binary改为ihex即可，如图：
![WechatIMG119.png](/uploads/201908/26/224723q47u8848li8m87o6.png)

2. 这是第二种方法，我自己写了个脚本，可以适用于多种开发条件，不仅仅是编译rtt可以用到，做其他ARM相关开发直接能用。

```
#!/bin/sh
# Author: Wei Zhou

if [ $# -ne 1 ]
then
        echo "Usage: You need specify a format to transform -> hex or bin"
        exit 1
elif [ $1 = hex ]
then
        arm-none-eabi-objcopy -O ihex *.elf frimware.hex
        exit 0
elif [ $1 = bin ]
then
        arm-none-eabi-objcopy -O binary *.elf frimware.bin
        exit 0
else
        echo "Usage: You need specify a format to transform -> hex or bin"
        exit 1
fi
```
把上述代码保存为elf2hex-bin文件，给与其可执行权限，并加入到环境变量中（PATH路径），您在任何地方只要执行上述脚本命令即可。
比如，在bsp开发目录下，scons命令编译完成后，执行 elf2hex-bin hex 命令，即可生成frimware.hex文件用于下载
![WechatIMG120.png](/uploads/201908/26/225253dlqlc9mp2pyovqzp.png)

### 烧录

下载SEGGER的MacOS下的[Jlink驱动](https://www.segger.com/downloads/jlink/#J-LinkSoftwareAndDocumentationPack)，完成安装

可下载.bin文件或者是.hex文件。这里要注意一点，下载.bin文件要制定烧录地址为0x08000000, .hex不用指定
![WechatIMG121.png](/uploads/201908/26/225725nysa3o50dya155z5.png)

![WechatIMG122.png](/uploads/201908/26/225828ygujyo5un5g8yh89.png)

至此，享受MacOS下RT-Thread开发给您带来的快感吧

DaZhou
2019年8月26日23:00