在MacOS下编译烧录ART-Pi

一、前言

ART-Pi是RT-Thread设计的一款搭载STM32H750XBH6 主控的开发板，由于STM32宣称 STM32H750XBH6 仅有128KB片内flash（实际上并不是），所以ART-Pi SDK使用128KB片内flash当作bootloader，将app程序放到8MB的片外QSPI flash上面运行。

ART-Pi SDK可以在RT-Thread Studio、MDK 等IDE上完美使用，但是这一切都是基于Windows。但是当我看到这篇文章的时候，我就知道ART-Pi 跨平台开发的机会来了。

二、环境要求

装有MacOS的电脑或虚拟机
装有Windows的电脑或虚拟机

需要用到的资源如下：

三、开搞

3.1 将板载ST-Link刷成J-Link

ART-Pi板载了一个ST-Link ，但是经过测试ST-Link 在非Windows系统上使用并不友好，所以需要将其重置为J-Link 以便烧录程序。

这一步需要在Windows上完成，因为ST-Link Reflash工具目前只有Windows版本。

具体操作步骤如下：

下载安装ST-Link Reflash。
连接ART-Pi ，启动STLinkReflash.exe 。
如下图所示，输入a回车、输入a回车、输入1回车 ，第三步千万不要选择2.Update J-LINK firmware ，否则无法通过USB刷回ST-Link 。

Untitled.png

正常情况下，板子上的ST-Link已经变成J-Link 了，我的ART-Pi已经刷过J-Link了所以提示找不到ST-LINK 。不要问为什么不刷回ST-Link 重刷截图，问就是懒。

3.2 编译下载Bootloader

接下来配置SDK和编译环境，进行Bootloader的编译和烧录。

使用brew install scons ，安装scons编译工具。
下载SEGGER J-Link software，用于烧录调试。
使用git clone https://github.com/RT-Thread-Studio/sdk-bsp-stm32h750-realthread-artpi克隆ART-Pi SDK到本地目录。
下载解压Arm GUN 工具链。
（可选）克隆RT-Thread Env到本地目录，主要用于开发阶段pkgs管理等操作。

设置环境变量，建议添加到.zshrc 或.bashrc

export RTT_CC=gcc
export RTT_EXEC_PATH=<ARM GUN工具链地址，包含bin目录>

使用命令行进入ART-Pi SDK的projects/art_pi_bootloader 目录，这里是ART-Pi的Bootloader项目，输入scons -c 清除编译文件之后输入scons 命令编译Bootloader。编译成功后使用<工具链路径>/arm-none-eabi-objcopy -O ihex rt-thread.elf rt-thread.hex 得到hex文件。
打开JFlashLite，选择驱动为STM32H750XB ，刚刚编译的hex文件烧录到0x08000000 。

Untitled1.png

3.3 编译APP

使用命令行进入ART-Pi SDK的projects/art_pi_blink_led 目录，同样使用scons 编译项目，编译后使用同样的方法得到hex文件。这个目录是作为demo的点灯app，开发时可以替换成自己的项目。

值得一提的是app是烧录到片外flash的，所以ROM的起始地址是0x90000000 。并且app代码内需要加入调转到该地址的向量表（这里只是作为讲解，main.c中已有无需再添加），代码如下非常简单：

#include "stm32h7xx.h"
static int vtor_config(void)
{
    /* Vector Table Relocation in Internal QSPI_FLASH */
    SCB->VTOR = QSPI_BASE;
    return 0;
}
INIT_BOARD_EXPORT(vtor_config);

3.4 新增J-Link Device

找到J-Link Software的主文件夹，参考方法如下：

➜  ~ which JLinkExe
/usr/local/bin/JLinkExe
➜  ~ ll /usr/local/bin/JLinkExe
lrwxr-xr-x  1 root  wheel    41B Mar  7  2020 /usr/local/bin/JLinkExe -> /Applications/SEGGER/JLink_V660e/JLinkExe
➜  ~ cd /Applications/SEGGER/JLink_V660e

在ART-Pi SDK中找到ART-Pi_W25Q64.FLM 文件，复制到Jlink下的Devices/ST/STM32H7 文件夹，并改名为ART-Pi_W25Q64.elf 。

➜  cd Devices/ST/STM32H7
➜  mdfind ART-Pi_W25Q64.FLM
/Users/jiy/work/sdk-bsp-stm32h750-realthread-artpi/debug/flm/ART-Pi_W25Q64.FLM
/Users/jiy/work/sdk-bsp-stm32h750-realthread-artpi/libraries/touchgfx_lib/readme.md
➜ sudo cp /Users/jiy/work/sdk-bsp-stm32h750-realthread-artpi/debug/flm/ART-Pi_W25Q64.FLM ART-Pi_W25Q64.elf
➜ ll
total 2176
-rwxr-xr-x  1 root  wheel   1.0M Feb  8 14:20 ART-Pi_W25Q64.elf
-rw-r--r--  1 root  wheel    36K Dec 16  2019 ST_STM32H745I_Disco_QSPI.elf
-rw-r--r--  1 root  wheel    36K Dec 16  2019 ST_STM32H753_Eval_QSPI.elf
-rw-r--r--  1 root  wheel   1.1K Dec 16  2019 ST_STM32H7xx.pex

找到JLinkDevices.xml 文件，备份，然后使用sudo权限编辑。

➜  mdfind JLinkDevices.xml
/Applications/SEGGER/JLink_V660e/JLinkDevices.xml
➜  cd /Applications/SEGGER/JLink_V660e
➜  sudo cp JLinkDevices.xml JLinkDevices.xml.bak
➜  sudo vim JLinkDevices.xml

然后加入ART-Pi 的Device。

  <Device>
    <ChipInfo Vendor="ST" Name="ART-PI" Core="JLINK_CORE_CORTEX_M7" WorkRAMAddr="0x20000000" WorkRAMSize="0x10000" JLinkScriptFile="Devices/ST/STM32H7/ST_STM32H7xx.pex"/>
    <FlashBankInfo Name="QSPI Flash" BaseAddr="0x90000000" MaxSize="0x00800000" Loader="Devices/ST/STM32H7/ART-Pi_W25Q64.elf" LoaderType="FLASH_ALGO_TYPE_OPEN" />
  </Device>