xref: /bsp/phytium/aarch32/

# 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`
- 使用`scons --attach=?`查看当前支持的开发板
![](./figures/scons_attach.png)

- 以`E2000Q_DEMO`开发板为例，进入aarch64目录后，运行`scons --attach=board.e2000q_demo_rtthread`加载默认的`rtconfig.h`, 然后输入下列命令，进入`menuconfig`进一步配置

```shell
scons --menuconfig
```

## 3. 如何选择驱动

```shell
scons --menuconfig
```

开发者通过以下选项进行驱动的使能
```
Hardware Drivers Config > On-chip Peripheral Drivers
```

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

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

```shell
scons --menuconfig
```

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

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

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

- 输入下列命令，进入`menuconfig`进一步配置
```shell
scons --menuconfig
```
- 在RT-Thread Kernel菜单中勾选以下选项

![](./figures/rtsmart_config.png)
## 6. 启动镜像程序

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

Last Index update Fri Aug 22 02:45:11 CST 2025