summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMeco Man <[email protected]>2023-07-25 20:11:07 -0400
committerMeco Man <[email protected]>2023-07-25 20:28:03 -0400
commitf01fe4aacb7e7e9295e89b7aadc326bf9615372b (patch)
treeac1d5d7a4f595ac34f30224d6071c1449e23da38
parent93cd53d06fffc8c26ae569ee264463910ec9a4d2 (diff)
[docs][qemu] update quick_start_qemu_windows
-rw-r--r--documentation/quick-start/quick_start_qemu/quick_start_qemu_windows.md (renamed from documentation/quick-start/quick_start_qemu/quick_start_qemu.md)36
1 files changed, 9 insertions, 27 deletions
diff --git a/documentation/quick-start/quick_start_qemu/quick_start_qemu.md b/documentation/quick-start/quick_start_qemu/quick_start_qemu_windows.md
index 43d72a2398..524d75fda8 100644
--- a/documentation/quick-start/quick_start_qemu/quick_start_qemu.md
+++ b/documentation/quick-start/quick_start_qemu/quick_start_qemu_windows.md
@@ -4,10 +4,8 @@ The development of embedded software is inseparable from the development board.
## Preparations
-- [Download RT-Thread Source Code](https://github.com/RT-Thread/rt-thread)
-- Download Env Tool
-- [Install Git on your PC](https://www.git-scm.com/download/)
-
+- [Download RT-Thread source code](https://github.com/RT-Thread/rt-thread)
+- [Download annd install Env tool](../../env/env.md)
## Instructions for the Env tool
@@ -33,33 +31,17 @@ You can use the keyboard `↑` key and `↓` key to look up and down menu items,
pkgs --update
```
-If a package is selected in menuconfig, download the package using the `pkgs --update` command (Git needs to be installed)
-
-### Compile
-
-```
-scons
-```
-
-Compile using the `scons` command.
-
-### Generate IDE's Project Files
+If a package is selected in menuconfig, download the package using the `pkgs --update` command.
-```
-scons --target=xxx
-```
+The alternative and recommended way is by using `menuconfig -s` to select the `Auto update pkgs config` feature, so that when users exit the menuconfig, Env will automatically download and update software packages.
-If you use the MDK or IAR IDE for development, you need to regenerate project files to make the configuration work after the configuration is completed. The command is `scons --target=xxx`, as shown below, which is the generation of IAR project, MDK4 project and MDK5 project.
+### Compile
-```c
-scons --target=iar
-scons --target=mdk4
-scons --target=mdk5
-```
+Compile using the `scons` command, or `scons -j12` means 12 CPU cores compiling.
## Introduction of QEMU BSP Catalogue
-The board-level support package (BSP) provided by RT-Thread simulates ARM vexpress A9 development board is located in the `qemu-vexpress-a9` folder under the BSP directory of RT-Thread source code. This BSP implements LCD, keyboard, mouse, SD card, Ethernet card, serial port and other related drivers. The contents of the folder are shown in the following figure.
+The board-level support package (BSP) provided by RT-Thread simulates ARM vexpress A9 development board is located in the `bsp/qemu-vexpress-a9` folder under the BSP directory of RT-Thread source code. This BSP implements LCD, keyboard, mouse, SD card, Ethernet card, serial port and other related drivers. The contents of the folder are shown in the following figure.
![qemu-vexpress-a9 folder](figures/qemubsp.png)
@@ -85,7 +67,7 @@ Open the Env folder and double-click the `env.exe` file to open the Env console:
![Env folder](figures/env.png)
-Switch to the QEMU BSP directory and enter the `scons` command to compile the project. If the compilation is correct, the `rtthread.elf` file will be generated in the BSP directory, which is a target file required for QEMU to run.
+Switch to the QEMU BSP directory and enter the `scons` or `scons -j12` command to compile the project. If the compilation is correct, the `rtthread.elf` file will be generated in the BSP directory, which is a target file required for QEMU to run.
![compile the project](figures/scons.png)
@@ -141,6 +123,6 @@ You can configure more functions in the configuration interface. After the confi
![menuconfig interface](figures/menuconfig_menu.png)
1. If you choose a package, you need to use the command `pkgs --update` to download the package.
-2. Compile with `scons`.
+2. Compile with `scons` or `scons -j12`.
3. Then enter `qemu.bat` to run.
4. Use `help` to view all commands of the BSP. And then use the commands.