未验证 提交 2a8e92b8 编写于 作者: 陈迎春 提交者: GitHub

[docs] bsp/qemu_vexpress_a9 update README.md (#6109)

* [docs] bsp/qemu_vexpress_a9 update README.md
上级 9429b0f0
# QEMU/VExpress A9板级支持包说明
# QEMU VExpress A9板级支持包说明
## 1. 简介
## 简介
Versatile Express系统由ARM Ltd提供,作为CortexA9四核处理器的开发环境,硬件由uATX主板和CoreTile Express A9x4子板组成。有关该系统的详细信息,可以访问 [ARM官方页面][1]
- Versatile Express系统由ARM Ltd提供,作为CortexA9四核处理器的开发环境,硬件由uATX主板和CoreTile Express A9x4子板组成。有关该系统的详细信息,可以访问 [ARM官方页面][1]
Versatile Express的核心是一套FPGA的开发环境,Cortex-A芯片基于FPGA上的硬件逻辑,所以本身是不存在这么一款真实芯片。
- Versatile Express的核心是一套FPGA的开发环境,Cortex-A芯片基于FPGA上的硬件逻辑,所以本身是不存在这么一款真实芯片。
QEMU/VExpress A9是QEMU模拟器针对ARM VExpress-A9 FPGA开发板进行软件模拟的指令级虚拟机。QEMU/VExpress因为是软件仿真模式,可以配置成多种模式,例如单核Cortex-A9,多核Cortex-A9,以及多核Cortex-A15等。同时也能够模拟出VExpress FPGA开发板上大多数的外设。
- QEMU/VExpress A9是QEMU模拟器针对ARM VExpress-A9 FPGA开发板进行软件模拟的指令级虚拟机。QEMU/VExpress因为是软件仿真模式,可以配置成多种模式,例如单核Cortex-A9,多核Cortex-A9,以及多核Cortex-A15等。同时也能够模拟出VExpress FPGA开发板上大多数的外设。
这份RT-Thread BSP是针对QEMU/VExpress-A9的一份移植,也并未在真实的VExpress FPGA开发板上运行过,主要是提供给开发者一定的便利,能够使用、验证一定的功能。对于真实FPGA开发板的执行情况,不做任何假设。
- 这份RT-Thread BSP是针对QEMU/VExpress-A9的一份移植,也并未在真实的VExpress FPGA开发板上运行过,主要是提供给开发者一定的便利,能够使用、验证一定的功能。对于真实FPGA开发板的执行情况,不做任何假设。
当前QEMU/VExpress-A9对应的硬件特性:
......@@ -18,23 +18,33 @@ QEMU/VExpress A9是QEMU模拟器针对ARM VExpress-A9 FPGA开发板进行软件
| 主频 | NA |
| Memory | 128MB(0x60000000 - 0x68000000) |
## 2. 编译说明
## 编译说明
推荐使用[env工具][2],可以在console下进入到`bsp/qemu-vexpress-a9`目录中,运行以下命令:
- 推荐使用[env工具][2]编译工程,在`bsp/qemu-vexpress-a9`目录中打开env环境,运行命令`scons -j4`
scons
![image-20220626114422344](figures/image-20220626114422344.png)
来编译这个板级支持包。如果编译正确无误,会产生rtthread.elf、rtthread.bin文件。在QEMU中一般使用elf方式来运行,所以只需要使用rtthread.elf文件即可。
**注:** RT-Thread/ENV中携带的工具版本是:
gcc version 5.4.1 20160919 (release) [ARM/embedded-5-branch revision 240496]
- 如果编译正确无误,会产生rtthread.elf、rtthread.bin文件。在QEMU中一般使用elf方式来运行,所以只需要使用rtthread.elf文件即可。
如果在Linux下使用,请自行下载[GNU GCC工具链][3]
![image-20220626114611158](figures/image-20220626114611158.png)
## 3. 执行和退出
### 3.1 执行脚本文件说明
- 当前测试使用的RT-Thread Env版本
![image-20220626113747893](figures/image-20220626113747893.png)
- 当前测试使用的GCC 交叉编译工具链版本
![image-20220626114020634](figures/image-20220626114020634.png)
- 如果在Linux下使用,请自行下载[GNU GCC工具链][3]
## 执行和退出
### 执行脚本文件说明
在这个bsp目录下已经提供了下面几个执行脚本文件,具体的说明如下表所示:
......@@ -47,28 +57,49 @@ QEMU/VExpress A9是QEMU模拟器针对ARM VExpress-A9 FPGA开发板进行软件
| qemu-nographic.bat | Windows | 以不带界面的模式启动运行 |
| qemu-nographic.sh | Linux | 同上 |
### 3.2 Windows下执行RT-Thread
### RT-Studio IDE下运行RT-Thread
#### 3.2.1 启动QEMU运行
推荐使用该方式进行学习,简单易用
当要执行编译好的RT-Thread时,可以在bsp目录下运行env,在env中敲入qemu.bat即可直接运行。
- 创建QEMU工程,创建RT-Thread项目,选择基于开发板,选择QEMU-VEXPRESS-A9
这个执行脚本默认把串口输出到stdio(即控制台)上,所以直接执行脚本后就可以输出结果了。
![image-20220626125511399](figures/image-20220626125511399.png)
```text
\ | /
- RT - Thread Operating System
/ | \ 3.0.4 build May 4 2018
2006 - 2018 Copyright by rt-thread team
SD card capacity 65536 KB
probe mmcsd block device!
hello rt-thread
msh />
```
- 创建好工程后,点击完成,选中qemu-a9工程,编译工程
![image-20220626125644099](figures/image-20220626125644099.png)
- 调试工程,发现程序停在了main函数开头处
![image-20220626125717698](figures/image-20220626125717698.png)
- 点击全速运行,发现程序正常运行起来
![image-20220626125837849](figures/image-20220626125837849.png)
### Windows ENV下运行RT-Thread
#### 启动QEMU运行
- 当要运行编译好的RT-Thread时,可以在bsp目录下运行env,在env中敲入qemu.bat即可直接运行。这个执行脚本默认把串口输出到stdio(即控制台)上,所以直接执行脚本后就可以输出结果了。
- 默认情况下,我们发现已经成功挂载SD卡
> 注意一下,默认情况下,由于SD中没有文件系统存在,因此挂载失败,程序中检测到文件系统挂载失败后,会自动执行mkfs对文件系统进行格式化操作,格式化完后,再次执行mount操作,文件系统挂载成功
当然你也可以尝试使用其他两个**.bat**文件启动运行。
![image-20220626115233881](figures/image-20220626115233881.png)
#### 3.2.2 退出QEMU运行
![image-20220626115854706](figures/image-20220626115854706.png)
- 文件系统操作,测试文件系统是否可以正常读写
![image-20220626115504981](figures/image-20220626115504981.png)
- 当然你也可以尝试使用其他两个**.bat**文件启动运行。
#### 退出QEMU运行
在msh提示输入的状态下,按下 **CTRL+C** ,有以下提示之后,按下 **y** ,即可退出 QEMU 。
......@@ -79,9 +110,15 @@ msh />
msh />Terminate batch job (Y/N)? y
```
### 3.3 Linux下执行RT-Thread
### Windows VSCode 中运行RT-Thread
参考文档:[使用VS Code开发RT-Thread](https://www.rt-thread.org/document/site/#/rt-thread-version/rt-thread-standard/application-note/setup/qemu/vscode/an0021-qemu-vscode?id=%e4%bd%bf%e7%94%a8-vs-code-%e5%bc%80%e5%8f%91-rt-thread)
#### 3.3.1 安装QEMU工具包
### Linux下执行RT-Thread
#### 安装QEMU工具包
在Linux下调试启动与Windows下稍微有点点区别,由于Windows下安装了**env**工具就自带了**qemu-system-arm**,而Linux下默认是没有这个工具的,所以执行执行`./qemu.sh`会报错:
......@@ -123,7 +160,7 @@ QEMU emulator version 4.2.1 (Debian 1:4.2-3ubuntu6.17)
Copyright (c) 2003-2019 Fabrice Bellard and the QEMU Project developers
```
#### 3.3.2 启动QEMU运行
#### 启动QEMU运行
由于Linux平台一般都是不带界面的服务器,所以推荐使用`qemu-nographic.sh`脚本来启动运行,参考运行示例如下:
......@@ -175,7 +212,7 @@ msh />
**注意**: 前面的错误信息可以忽略,能看到RT-Thread的启动logo输出,以及msh能正常输入输出,即可进行代码调试了。
#### 3.3.3 退出QEMU运行
#### 退出QEMU运行
Linux下退出QEMU的方式与Windows下有些不一样;在msh提示输入的状态下,按下 **CTRL+A** ,再按下 **X** ,即可退出 QEMU 。
......@@ -186,6 +223,8 @@ msh />
msh />QEMU: Terminated
```
## 4. 支持情况
| 驱动 | 支持情况 | 备注 |
......@@ -197,40 +236,7 @@ msh />QEMU: Terminated
| Mouse | 支持 | |
| EMAC | 支持 | |
### 4.1 使用VSCode编辑、编译、调试
在qemu-vexpress-a9中已经携带了部分vscode的配置,需要配合着env一起来使用。步骤包括:
先使用env打开console,然后在console中切换都qemu-vexpress-a9 bsp的目录下,
```bash
scons --target=vsc -s
```
更新vscode需要用到的C/C++头文件搜索路径信息(不是每次都需要更新,只有在使用了menuconfig重新配置了RT-Thread或更改了rtconfig.h头文件时才需要)
然后在console下输入
```bash
code .
```
启动vscode。使用vscode,目前包含如下的一些功能:
* 编译 `Ctrl+Shift+B` - 开启vscode内置终端,调用scons进行编译;如果有编译错误也会侦测问题,双击问题跳到指定代码文件、代码行;
* 包含执行`qemu`模拟器,`scons -c`进行目标文件清理的任务
* `F5` 一键开启QEMU调试模式,并断点停留在`main`函数上;(需要更改下qemu-dbg.bat文件,在qemu-system-arm前加入`start`),即
```batch
@echo off
if exist sd.bin goto run
qemu-img create -f raw sd.bin 64M
:run
start qemu-system-arm -M vexpress-a9 -kernel rtthread.elf -serial stdio -sd sd.bin -S -s
```
**已知问题** 如果在vscode的目录中额外添加了文件夹,会导致调试不能够启动。
## 5. 联系人信息
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册