rt-thread/bsp/phytium/aarch32/README.md

# AARCH32 工作模式使用

- 当开发者需要基于 Phytium 系列芯片进行开发时，可以从以下几个步骤出发配置芯片

## 1. 准备编译环境

- 在aarch32目录下创建tools文件夹，用于存放编译链，目前支持在以下两种环境进行开发
```shell
mkdir tools
```
注：使用RT-Smart编译链也可编译RT-Thread，但当前不支持C++

### Ubuntu 环境

#### RT-Thread

- 点击[下载编译链工具](https://developer.arm.com/-/media/Files/downloads/gnu-a/10.3-2021.07/binrel/gcc-arm-10.3-2021.07-x86_64-arm-none-eabi.tar.xz)压缩包，放置在tools目录下

- 在tools目录下，使用tar命令解压缩
```shell
tar xvf gcc-arm-10.3-2021.07-x86_64-arm-none-eabi.tar.xz
```

![tar_toolschain_ubuntu](./figures/tar_toolschain_ubuntu.png)

- 返回`aarch32`目录，运行`thread-env.sh脚本`，生效环境变量
```shell
source ./thread-env.sh
```

- 如下所示是`aarch32`编译相关的环境变量，运行`scons`前要确保环境变量设置正确

![aarch32_thread](./figures/aarch32_thread.png)

#### RT-Smart

- 点击[下载编译链工具](https://github.com/RT-Thread/toolchains-ci/releases/tag/v1.7)压缩包，放置在tools目录下，如下所示

![aarch32_tools](./figures/aarch32_tools.png)

- 在tools目录下，使用tar命令解压缩
```shell
tar jxvf arm-linux-musleabi_for_x86_64-pc-linux-gnu_stable.tar.bz2
```

![tar_toolschain](./figures/tar_toolschain.png)

- 返回`aarch32`目录，运行smart-env.sh脚本，生效环境变量
```shell
source ./smart-env.sh
```

- 如下所示是`aarch32`编译相关的环境变量，运行`scons`前要确保环境变量设置正确

![aarch32_env](./figures/aarch32_env.png)

- 输入以下指令进行编译，初次编译会拉取`phytium_standalone_sdk工具包`，请确保当前环境下网络畅通
```shell
scons -j8
```
![ubuntu_scons](./figures/ubuntu_scons.png)

- 完成编译之后aarch32目录下将会生成以下几个文件
```
rtthread_a32.bin
rtthread_a32.elf
rtthread_a32.map
```

### RT-Thread env 环境

#### RT-Thread

- RT-Thread env 环境已经内嵌的`aarch32`编译链，运行`thread-env.bat`脚本，生效环境变量即可

```shell
.\thread-env.bat
```

#### RT-Smart

- 点击[下载编译链工具](https://pan.baidu.com/s/1p7PRhV3dTGIb7hxv34YWYw)压缩包，提取码：ndxq

- 在tools目录下，将下载好的编译链工具压缩包解压缩，如下所示

![aarch32_env_tools](./figures/aarch32_env_tools.png)

- 返回`aarch32`目录，运行smart-env.bat脚本，生效环境变量
```shell
.\smart-env.bat
```

- 输入以下指令进行编译，初次编译会拉取`phytium_standalone_sdk工具包`，请确保当前环境下网络畅通
```shell
scons -j8
```
![rtt_env_scons](./figures/rtt_env_scons.png)

- 完成编译之后aarch32目录下将会生成以下几个文件
```
rtthread_a32.bin
rtthread_a32.elf
rtthread_a32.map
```

## 2. 如何选择开发板

>注：在 RT-Thread env 环境下使用`menuconfig`指令即可打开配置菜单，在Ubuntu下需要使用`scons --menuconfig`

- 以 E2000Q RT-Thread为例，Linux 环境下，运行`make load_e2000d_demo_rtthread`加载默认的 rtconfig, 然后输入下列命令，进入 menuconfig 进一步配置

```shell
scons --menuconfig
```

开发者通过以下选择进行配置

```
Standalone Setting > Board Configuration > Chip 
```

![](./figures/board_select.png)

## 3. 如何选择驱动

```shell
scons --menuconfig
```

开发者通过以下选项进行驱动的使能

```
Hardware Drivers > On-chip Peripheral Drivers
```

![](./figures/select_driver.png)

## 4. 开启SDK中内部调试信息

```shell
scons --menuconfig
```

开发者通过以下选项开启调试信息

![](./figures/debug_info.png)


## 5. 如何切换至 RT-Thread Smart 工作模式

### Ubuntu环境下可使用以下指令加载RT-Smart默认配置

- 以E2000D_DEMO开发板为例
```shell
make load_e2000d_demo_rtsmart
```
### RT-Thread env环境不方便安装make工具，可按照以下步骤加载RT-Smart默认配置

1. 查看`makefile`文件，找到`make load_e2000d_demo_rtsmart`

![load_e2000d_rtsmart](./figures/load_e2000d_rtsmart.png)

2. 输入以下指令
```shell
cp ./configs/e2000d_demo_rtsmart ./.config -f
cp ./configs/e2000d_demo_rtsmart.h ./rtconfig.h -f
scons -c
```

## 6. 启动镜像程序

1. 完成配置后，使用以下指令进行clean和重新编译
```shell
scons -c
scons -j8
```
2. 按照指导[启动镜像程序](../doc/how_to_flashed_binary.md)