diff --git a/rt-thread-version/rt-thread-standard/application-note/setup/qemu/windows/an0006-qemu-windows.md b/rt-thread-version/rt-thread-standard/application-note/setup/qemu/windows/an0006-qemu-windows.md index e0d9e360bfb57feff22e85d8eed6a5ffeb955f01..41427ad2d24e337cd3c1bbfef86b29c28df26690 100644 --- a/rt-thread-version/rt-thread-standard/application-note/setup/qemu/windows/an0006-qemu-windows.md +++ b/rt-thread-version/rt-thread-standard/application-note/setup/qemu/windows/an0006-qemu-windows.md @@ -16,9 +16,9 @@ ## 准备工作 -* [下载 RT-Thread 源码](https://www.rt-thread.org/download.html)，推荐下载3.1.0及以上版本。 +* [下载 RT-Thread 源码](https://www.rt-thread.org/download.html)，推荐下载 3.1.0 及以上版本。 -* 下载 RT-Thread Env 工具，推荐下载1.0.0及以上版本。参考编程指南-《Env 用户手册》，了解如何下载及使用。 +* 下载 RT-Thread Env 工具，推荐下载 1.0.0 及以上版本。参考编程指南《Env 用户手册》，了解如何下载及使用。 RT-Thread 提供的 QEMU 模拟的 ARM vexpress A9 开发板的板级支持包 (BSP) 位于 RT-Thread 源码 BSP 目录下的 qemu-vexpress-a9 文件夹，此 BSP 实现了 LCD、键盘、鼠标、SD 卡、以太网卡、串口等相关驱动，文件夹内容如下图所示。 @@ -59,7 +59,7 @@ qemu-vexpress-a9 BSP 主要文件及目录描述如下所示： ![虚拟机](figures/qemu.png) -**注意事项：**若电脑安装有 360 安全卫士会有警告，请点击允许程序运行。 +**注意事项**：若电脑安装有 360 安全卫士会有警告，请点击允许程序运行。 ## 运行 Finsh 控制台 @@ -67,7 +67,7 @@ RT-Thread 支持 Finsh，用户可以在命令行模式使用命令操作。输 ![查看 Finsh 命令 ](figures/finsh-cmd.png) -如下图所示，比如输入`list_thread`命令可以查看当前运行的线程，以及线程状态和堆栈大小等信息。输入`list_timer`可以查看定时器的状态。 +如下图所示，比如输入 `list_thread` 命令可以查看当前运行的线程，以及线程状态和堆栈大小等信息。输入 `list_timer` 可以查看定时器的状态。 ![查看系统线程情况 ](figures/finsh-thread.png) @@ -79,7 +79,7 @@ RT-Thread 支持 Finsh，用户可以在命令行模式使用命令操作。输 ![格式化 sd 卡](figures/mkfs-sd0.png) -第一次格式化 sd 卡后文件系统不会马上装载上，第二次启动才会被正确装载。我们退出虚拟机，然后在 Env 命令行界面输入 `qemu.bat` 重新启动虚拟机及工程，输入 `ls` 命令可以看到新增了 Directory 目录，文件系统已经装载上，然后可以使用 RT-Thread 提供的其他命令体验文件系统 +第一次格式化 sd 卡后文件系统不会马上装载上，第二次启动才会被正确装载。我们退出虚拟机，然后在 Env 命令行界面输入 `qemu.bat` 重新启动虚拟机及工程，输入 `ls` 命令可以看到新增了 Directory 目录，文件系统已经装载上，然后可以使用 RT-Thread 提供的其他命令体验文件系统。 ![文件系统其他命令](figures/echo-cat.png) @@ -87,37 +87,39 @@ RT-Thread 支持 Finsh，用户可以在命令行模式使用命令操作。输 ### 步骤一 安装和配置 TAP 网卡 -1、下载 TAP 网卡 [tap-windows-9.21.2.exe](https://pan.baidu.com/s/1h2BmdL9myK6S0g8TlfSW0g)。下载好后双击安装程序，默认安装即可。 +1、下载 TAP 网卡 [tap-windows-9.21.2.exe](https://pan.baidu.com/s/1h2BmdL9myK6S0g8TlfSW0g)。下载好后双击安装程序，默认安装即可。 2、打开网络和共享中心更改适配器设置，将安装的虚拟网卡重命名为 tap，如下图所示： ![tap_rename](figures/tap_rename.png) -**方法A:**右键当前能上网的网络连接（本文使用以太网），打开属性 -> 共享，选择家庭网络连接为 tap，点击确定完成设置，如下图所示： + **方法A**：右键当前能上网的网络连接（本文使用以太网），打开属性 -> 共享，选择家庭网络连接为 tap，点击确定完成设置，如下图所示： ![tap_share_internet](figures/tap_share_internet.png) - **方法B：**也可以将一个能正常连接网络的物理网卡与 tap 进行桥接，桥接成功后会出现一个网桥。如下面图片所示： + **方法B**：也可以将一个能正常连接网络的物理网卡与 tap 进行桥接，桥接成功后会出现一个网桥。如下面图片所示： -![tap_桥接](./figures/tap_bridge1.png) + ![tap_桥接](./figures/tap_bridge1.png) -![tap_桥接成功](./figures/tap_bridge2.png) + ![tap_桥接成功](./figures/tap_bridge2.png) -**注意事项：** tap 网卡和 VMware 的虚拟网卡可能会冲突，如果出现无法开启网络共享，或者 ping 不通网络的情况，请在删除 VMware 虚拟网卡之后再尝试一次。 +**注意事项**：tap 网卡和 VMware 的虚拟网卡可能会冲突，如果出现无法开启网络共享，或者 ping 不通网络的情况，请在删除 VMware 虚拟网卡之后再尝试一次。 ### 步骤二 修改 qemu.bat 脚本文件 打开 qemu-vexpress-a9 BSP 目录下的 qemu.bat 文件，在下图所示位置添加以下配置内容： -`-net nic -net tap,ifname=tap` +```bash +-net nic -net tap,ifname=tap +``` -其中 ifname=tap 的意思是网卡的名称是 tap。 +其中 `ifname=tap` 的意思是网卡的名称是 tap。 ![qemu_modify](figures/qemu_modify.png) ### 步骤三 查看 IP 地址 -输入 `qemu.bat` 命令运行工程，在 shell 中输入 `ifconfig`命令查看网络状态，正常获取到 IP 即表示网络驱动正常，配置工作完成，效果如下图所示： +输入 `qemu.bat` 命令运行工程，在 shell 中输入 `ifconfig` 命令查看网络状态，正常获取到 IP 即表示网络驱动正常，配置工作完成，效果如下图所示： ![ifconfig](figures/ifconfig.png) @@ -125,7 +127,7 @@ RT-Thread 支持 Finsh，用户可以在命令行模式使用命令操作。输 * 当出现获取不到 IP 地址的情况时，先将以太网的共享关闭，然后再次打开即可。 -* 如果获取到的 IP 是 10.0.x,x，是因为没有为 QEMU 添加启动参数 `-net nic -net tap,ifname=tap` 。 +* 如果获取到的 IP 是 10.0.x,x，是因为没有为 QEMU 添加启动参数 `-net nic -net tap,ifname=tap` 。 * 虚拟机刚开始运行的时候并不会立刻获取到 IP 地址，有时需要等待几秒钟才会获取到 IP。 @@ -135,7 +137,7 @@ RT-Thread 支持 Finsh，用户可以在命令行模式使用命令操作。输 ### 步骤一 下载网络工具软件包 -1、在路径`bsp\qemu-vexpress-a9`下打开 Env 工具，执行 menuconfig，如下图所示: +1、在路径 `bsp\qemu-vexpress-a9` 下打开 Env 工具，执行 menuconfig，如下图所示： ![Env_menuconfig](figures/env_menuconfig.png) @@ -157,11 +159,11 @@ RT-Thread 支持 Finsh，用户可以在命令行模式使用命令操作。输 ### 步骤二 运行 ping 工具 -在 shell 中输入 `ifconfig`命令查看网络状态，正常获取到 IP 即表示网络驱动正常： +在 shell 中输入 `ifconfig` 命令查看网络状态，正常获取到 IP 即表示网络驱动正常： ![ifconfig](figures/ifconfig.png) -在 shell 中输入 ping www.rt-thread.com 可以看到 ping 通的返回结果， 表示网络配置成功，能够 ping 通，如下图所示： +在 shell 中输入 `ping www.rt-thread.com` 可以看到 ping 通的返回结果，表示网络配置成功，能够 ping 通，如下图所示： ![ping](figures/ping.png) @@ -169,7 +171,7 @@ RT-Thread 支持 Finsh，用户可以在命令行模式使用命令操作。输 ### 步骤一 下载 GUI 引擎软件包 -关掉 QEMU 虚拟机，回到 ENV 控制台，输入 `menuconfig` 命令进入配置界面: +关掉 QEMU 虚拟机，回到 ENV 控制台，输入 `menuconfig` 命令进入配置界面： ![menuconfig](figures/menuconfig.png) @@ -194,13 +196,11 @@ RT-Thread 支持 Finsh，用户可以在命令行模式使用命令操作。输 ## 参考资料 * 《Env 用户手册》 - * 《文件系统》 ## 常见问题 * **Env 工具的相关问题请参考编程指南-《Env 用户手册》章节。** - * **编译工程提示 fatal error: rtgui/driver.h: No such file or directory** > 提示：解决方法：使用 menuconfig 使能 “Enable GUI Engine”后需要使用命令`pkgs --update`下载 GUI 软件包。