如何在windows和linux平台使用RT-Thread QEMU BSP，并运行RT-ThreadGUI示例

本文描述如何在windows及linux平台使用RT-Thread QEMU BSP，并运行RT-Thread GUI示例。

1 本文的目的和结构

1.1 本文的目的 和背景嵌入式软件开发离不开开发板，在没有物理开发板的情况下，可以使用QEMU等类似的虚拟机来模拟开发板。QEMU是一个支持跨平台虚拟化的虚拟机，它可以虚拟很多开发板。为了方便大家在没有开发板的情况下体验RT-Thread，RT-Thread使用QEMU模拟了ARM vexpress A9开发板，并提供了相关的板级支持包(BSP)。本文主要介绍在windows平台和linux平台使用RT-Thread提供的qemu-vexpress-a9 BSP。

1.2 本文的结构本文首先介绍qemu-vexpress-a9 BSP在windows平台的使用明细，其次介绍在linux平台的使用明细。

2 在windows平台使用qemu-vexpress-a9 BSP

2.1 准备工作

RT-Thread源码

RT-Thread env工具

env是RT-Thread推出的图形界面辅助工具，用来配置基于RT-Thread操作系统开发的项目工程。env自带有编译器和QEMU，因此在windows平台可以不用下载编译器和QEMU。请点击下面链接获取env详细信息及env运行环境要求：

解压RT-Thread源码，在BSP目录下找到qemu-vexpress-a9文件夹，RT-Thread qemu-vexpresss-a9 BSP实现了LCD、键盘、鼠标、SD卡、以太网卡、串口等相关驱动。

图 2.1 1 qemu-vexpress-a9文件夹

2.2 运行qemu-vexpress-a9 BSP工程1、打开env文件夹，根据系统类型(32位/64位)双击对应的console.exe文件打开env控制台：

图 2.2 1 env文件夹

2、在命令行模式下使用cd d:projects t-threadspqemu-vexpress-a9命令切换到RT-Thread源码文件夹下的qemu-vexpress-a9 BSP根目录，然后输入scons命令编译工程：

图 2.2 2 编译工程

3、编译完成后输入qemu.bat启动虚拟机及BSP工程，qemu.bat是windows批处理文件，此文件位于BSP文件夹下，主要包括QEMU的执行指令，第一次运行工程会在BSP文件夹下创建一份空白的sd.bin文件，这是虚拟的sd卡，大小为64M。env命令行界面显示RT-Thread系统启动过程中打印的初始化信息及版本号信息等，如下图所示：

图 2.2 3 运行工程

4、若电脑安装有360安全卫士会有警告，点击允许程序运行，这时qemu虚拟机就运行起来了。虚拟机中央的白色区域是虚拟的LCD屏，读者可以自己写些GUI相关代码，相关图形图像信息会出现在这块虚拟的LCD屏中，后面本文将演示RT-Thread提供的GUI示例代码。

图 2.2 4虚拟屏

5、RT-Thread支持finsh，用户可以在命令行模式操作，输入help或按tab键可以查看所有支持的命令，输入list_device可以查看所有设备。这里可以看到设备里包括了我们前面提到的虚拟的sd卡“sd0”，接下来我们可以使用mkfs sd0命令格式化sd卡，执行该命令会将sd卡格式化成FatFS文件系统。FatFs是专为小型嵌入式设备开发的一个兼容微软fat的文件系统，采用ANSI C编写，采用抽象的硬件I/O层以及提供持续的维护，因此具有良好的硬件无关性以及可移植性。

图 2.2 5 格式化sd卡

6、第一次格式化sd卡后文件系统不会马上装载上，第二次启动才会被正确装载。我们退出虚拟机，然后在env命令行界面输入qemu.bat重新启动虚拟机及工程，输入ls命令可以看到新增了Directory目录，文件系统已经装载上，然后可以使用RT-Thread提供的其他命令体验文件系统。

图 2.2 6 文件系统其他命令

2.3 运行RT-Thread GUI示例1、关掉QEMU虚拟机，回到ENV控制台。0.6.4版本的env工具中加入了自动更新软件包和自动生成mdk/iar工程的选项，默认不开启。可以使用menuconfig –s或者menuconfig --setting配置：

图 2.3 1 menuconfig -s命令

选中“auto update pkgs config”，在使用menuconfig功能后env会自动使用pkgs --update命令来下载并安装软件包，同时删除旧的软件包：

图 2.3 2 自动更新配置

2、使用menuconfig命令进入配置界面，进入“RT-Thread Components” ——→ “RT-Thread UI Engine”子菜单，按‘↓’键下翻选中“Enable the example of UI Engine”：

图 2.3 3 选择GUI示例

3、按‘→’键选中“save”保存配置，并按“Exit”键退出配置界面，回到命令行界面，输入scons重新编译工程：

图 2.3 4 scons命令编译工程

4、编译完成后输入qemu.bat命令启动QEMU虚拟机及工程，可以看到QEMU虚拟的显示屏上显示了示例代码展示的图片、文字和图形信息：

图 2.3 5 虚拟屏GUI 示例展示

2.4 用eclipse调试qemu-vexpress-a9 BSP工程1、首先在eclipse的Eclipse Marketplace里下载并安装支持QEMU的调试工具：

图 2.4 1 Eclipse Marketplace

图 2.4 2 调试工具安装

2、首次调试工程需要配置调试参数，如下面图片所示，打开调试配置界面及配置调试参数：

图 2.4 3 eclipse调试配置选项

图 2.4 4 创建新的调试项目

图 2.4 5 选择调试文件

图 2.4 6 选择调试工具

图 2.4 7 选择断点

3、调试相关参数配置好后就可以开始调试了，回到env命令行界面输入qemu-dbg.bat开启调试模式：

图 2.4 8 启动调试

这时候启动的QEMU虚拟机处于暂停状态，等待连接调试：

图 2.4 9 虚拟屏调试初始界面

4、点击eclipse调试配置界面的“Debug”按钮，或者点击调试项目名称，开启eclipse调试界面，这时就可以对工程进行调试了：

图 2.4 10 开始调试

图 2.4 11 eclipse调试项目选择

图 2.4 12 eclipse调试界面

3 在linux平台使用qemu-vexpress-a9 BSP

3.1 准备工作

下载RT-Thread源码，使用命令：git clone https://github.com/RT-Thread/rt-thread.git

安装QEMU，使用命令：sudo apt-get install qemu

安装scons，使用命令：sudo apt-get install scons

安装编译器，使用apt-get命令安装的编译器版本太旧会导致编译报错，可依次使用如下命令下载安装新版本.

安装ncurses库，使用命令：sudo apt-get install libncurses5-dev

编译器安装好以后需要修改qemu-vexpress-a9 BSP下面的rtconfig.py文件，修改对应路径为解压到opt目录下的编译器对应的bin目录，参考下图，目录名字因下载的编译器版本而异：

图 3.1 1 编译器路径修改

3.2 使用menuconfig配置工程1、在qemu-vexpress-a9 BSP根目录输入scons --menuconfig开启配置界面，配置操作和windows平台一样：

图 3.2 1 menuconfig配置界面

2、使用scons --menuconfig命令后会安装及初始化env工具，并在home目录下面生成“.env”文件夹，此文件夹为隐藏文件夹，切换到home目录，使用la命令可查看所有目录和文件。env.sh文件是需要执行的文件，它会配置好环境变量，让我们可以使用pkgs命令来更新软件包，输入source ~/.env/env.sh命令执行。若已经选择了在线软件包，就可以使用pkgs --update命令下载软件包到BSP目录下的packages文件夹里：

图 3.2 2 .env文件夹

图 3.2 3 pkgs --update命令下载软件包

3.3 运行qemu-vexpress-a9 BSP工程1、在qemu-vexpress-a9 BSP目录下输入scons命令编译工程：

图 3.3 1 scons命令编译工程

2、输入ls命令查看BSP下面的文件明细，绿色显示的文件是有执行权限的文件，我们需要给qemu.sh文件新增执行权限，输入chmod +x qemu.sh命令：

图 3.3 2 qemu.sh文件新增执行权限

3、输入./qemu.sh命令执行脚本文件，这时候虚拟机便运行起来，如下图所示，命令行显示了RT-Thread操作系统启动过程所打印的相关信息，白色窗口为虚拟的LCD屏，读者可参考在windows平台运行RT-Thread GUI示例和使用eclipse调试的内容，同样可以在linux平台实现，本文不在赘述。

图 3.3 3 虚拟机运行界面