diff --git a/bsp/stm32/stm32f401-st-nucleo/How to create a new project.md b/bsp/stm32/docs/How to create a RT-Studio project.md similarity index 53% rename from bsp/stm32/stm32f401-st-nucleo/How to create a new project.md rename to bsp/stm32/docs/How to create a RT-Studio project.md index 353c1c32ce..6c2cde72d7 100644 --- a/bsp/stm32/stm32f401-st-nucleo/How to create a new project.md +++ b/bsp/stm32/docs/How to create a RT-Studio project.md @@ -1,51 +1,50 @@ -## [STM32F401] How to create a new project +# How to create a RT-Studio project -***info:*** -:bulb: Download the latest RT-Thread studio from link - -https://www.rt-thread.io/studio.html -and follow the instructions to install it on your windows machine. +[Download the latest RT-Thread studio](https://www.rt-thread.io/studio.html) and follow the instructions to install it on your windows machine. + +This article use STM32F401-Nucleo as an example. ## 1 Create a new project ### 1.1 Go to File -> Import. -![](./figures_en/Import_bsp.png) +![](figures_en/Import_bsp.png) ### 1.2 Select RT-Thread Bsp Project into Workspace. -![](./figures_en/Workspace.png) +![](figures_en/Workspace.png) ### 1.3 Import Projects from BSP. -![](./figures_en/Import_prj.png) +![](figures_en/Import_prj.png) ### 1.4 Browse Bsp Location to rt-threadx\bsp\stm32\stm32f401-st-nucleo, then click Select Folder. -![](./figures_en/Folder.png) +![](figures_en/Folder.png) ### 1.5 Fill up the rest of the information and select ST-LINK for debugger. Then, click finish button. There will be a newly created project at the workspace. -![](./figures_en/Info.png) +![](figures_en/Info.png) -![](./figures_en/Import.png) +![](figures_en/Import.png) -![](./figures_en/Project.png) +![](figures_en/Project.png) ## 2 Tool Chain ### 2.1 Select the latest tool chain version to resolve the warning. -![](./figures_en/BuildSetting.png) +![](figures_en/BuildSetting.png) -![](./figures_en/GUN_Tools.png) +![](figures_en/GUN_Tools.png) ### 2.2 If there is no latest tool chain version, click SDK manager to download the latest version. -![](./figures_en/SDK.png) +![](figures_en/SDK.png) > Select the latest version from the RT-Thread SDK Manager window and click install packages button. After installation, click Exit SDK Manger button again. -![](./figures_en/SDK_ver.png) +![](figures_en/SDK_ver.png) > Then select the latest version from the Open Build Settings Dialog. @@ -53,35 +52,45 @@ and follow the instructions to install it on your windows machine. ### 3.1 In order to configure kernel and to enable add-on software packages, click RT-Thread Settings. Then, click detail button. -![](./figures_en/config.png) +![](figures_en/rt-studio-settings.png) -![](./figures_en/softpkgs.png) +![](figures_en/softpkgs.png) -![](./figures_en/select.png) +![](figures_en/select.png) ### 3.2 After configuration, click save to update the latest configuration. -![](./figures_en/save_select.png) +![](figures_en/save_select.png) -![](./figures_en/saveing.png) +![](figures_en/saveing.png) ## 4 Compilation ### 4.1 In order to complie the project, select the project and ensure that it is [Active - Debug ] state. -![](./figures_en/select_prj.png) +![](figures_en/select_prj.png) ### 4.2 Click compilation icon at the menu bar to compile the project. -![](./figures_en/build.png) +![](figures_en/build.png) -![](./figures_en/build_finish.png) +![](figures_en/build_finish.png) + +### 4.3 Reset Mode Setup + +By default, it is selected as hardware reset. After downloading the code, it is required to press the reset physical button on the board. However, this can be done automatically by selecting system reset option at the dropdown list. + +To select system reset, click the configuration icon at menubar. Then, go to download tab. At the reset mode setup, you can either select hardware or system reset. + +![](figures_en/setting.png) + +![](figures_en/rst.png) ## 5 Terminal To access the development board, click terminal icon at the menu ba and select the correct serial port. -![](./figures_en/terminal.png) +![](figures_en/terminal.png) ## 6 Additional Info @@ -89,7 +98,6 @@ If you need addtional information, visit to https://www.rt-thread.io/document/site/programming-manual/interrupt/interrupt/ -## +## 7 Author -###### Author -###### Stanley Lwin [04 / 11 / 2023] \ No newline at end of file +[Stanley Lwin](https://github.com/byte-me-stan) diff --git a/bsp/stm32/stm32f401-st-nucleo/figures_en/BuildSetting.png b/bsp/stm32/docs/figures_en/BuildSetting.png similarity index 100% rename from bsp/stm32/stm32f401-st-nucleo/figures_en/BuildSetting.png rename to bsp/stm32/docs/figures_en/BuildSetting.png diff --git a/bsp/stm32/stm32f401-st-nucleo/figures_en/Folder.png b/bsp/stm32/docs/figures_en/Folder.png similarity index 100% rename from bsp/stm32/stm32f401-st-nucleo/figures_en/Folder.png rename to bsp/stm32/docs/figures_en/Folder.png diff --git a/bsp/stm32/stm32f401-st-nucleo/figures_en/GUN_Tools.png b/bsp/stm32/docs/figures_en/GUN_Tools.png similarity index 100% rename from bsp/stm32/stm32f401-st-nucleo/figures_en/GUN_Tools.png rename to bsp/stm32/docs/figures_en/GUN_Tools.png diff --git a/bsp/stm32/stm32f401-st-nucleo/figures_en/Import.png b/bsp/stm32/docs/figures_en/Import.png similarity index 100% rename from bsp/stm32/stm32f401-st-nucleo/figures_en/Import.png rename to bsp/stm32/docs/figures_en/Import.png diff --git a/bsp/stm32/stm32f401-st-nucleo/figures_en/Import_bsp.png b/bsp/stm32/docs/figures_en/Import_bsp.png similarity index 100% rename from bsp/stm32/stm32f401-st-nucleo/figures_en/Import_bsp.png rename to bsp/stm32/docs/figures_en/Import_bsp.png diff --git a/bsp/stm32/stm32f401-st-nucleo/figures_en/Import_prj.png b/bsp/stm32/docs/figures_en/Import_prj.png similarity index 100% rename from bsp/stm32/stm32f401-st-nucleo/figures_en/Import_prj.png rename to bsp/stm32/docs/figures_en/Import_prj.png diff --git a/bsp/stm32/stm32f401-st-nucleo/figures_en/Info.png b/bsp/stm32/docs/figures_en/Info.png similarity index 100% rename from bsp/stm32/stm32f401-st-nucleo/figures_en/Info.png rename to bsp/stm32/docs/figures_en/Info.png diff --git a/bsp/stm32/stm32f401-st-nucleo/figures_en/Project.png b/bsp/stm32/docs/figures_en/Project.png similarity index 100% rename from bsp/stm32/stm32f401-st-nucleo/figures_en/Project.png rename to bsp/stm32/docs/figures_en/Project.png diff --git a/bsp/stm32/stm32f401-st-nucleo/figures_en/SDK.png b/bsp/stm32/docs/figures_en/SDK.png similarity index 100% rename from bsp/stm32/stm32f401-st-nucleo/figures_en/SDK.png rename to bsp/stm32/docs/figures_en/SDK.png diff --git a/bsp/stm32/stm32f401-st-nucleo/figures_en/SDK_ver.png b/bsp/stm32/docs/figures_en/SDK_ver.png similarity index 100% rename from bsp/stm32/stm32f401-st-nucleo/figures_en/SDK_ver.png rename to bsp/stm32/docs/figures_en/SDK_ver.png diff --git a/bsp/stm32/stm32f401-st-nucleo/figures_en/Workspace.png b/bsp/stm32/docs/figures_en/Workspace.png similarity index 100% rename from bsp/stm32/stm32f401-st-nucleo/figures_en/Workspace.png rename to bsp/stm32/docs/figures_en/Workspace.png diff --git a/bsp/stm32/stm32f401-st-nucleo/figures_en/build.png b/bsp/stm32/docs/figures_en/build.png similarity index 100% rename from bsp/stm32/stm32f401-st-nucleo/figures_en/build.png rename to bsp/stm32/docs/figures_en/build.png diff --git a/bsp/stm32/stm32f401-st-nucleo/figures_en/build_finish.png b/bsp/stm32/docs/figures_en/build_finish.png similarity index 100% rename from bsp/stm32/stm32f401-st-nucleo/figures_en/build_finish.png rename to bsp/stm32/docs/figures_en/build_finish.png diff --git a/bsp/stm32/docs/figures_en/rst.png b/bsp/stm32/docs/figures_en/rst.png new file mode 100644 index 0000000000..57fea9ddd7 Binary files /dev/null and b/bsp/stm32/docs/figures_en/rst.png differ diff --git a/bsp/stm32/stm32f401-st-nucleo/figures_en/config.png b/bsp/stm32/docs/figures_en/rt-studio-settings.png similarity index 100% rename from bsp/stm32/stm32f401-st-nucleo/figures_en/config.png rename to bsp/stm32/docs/figures_en/rt-studio-settings.png diff --git a/bsp/stm32/stm32f401-st-nucleo/figures_en/save_select.png b/bsp/stm32/docs/figures_en/save_select.png similarity index 100% rename from bsp/stm32/stm32f401-st-nucleo/figures_en/save_select.png rename to bsp/stm32/docs/figures_en/save_select.png diff --git a/bsp/stm32/stm32f401-st-nucleo/figures_en/saveing.png b/bsp/stm32/docs/figures_en/saveing.png similarity index 100% rename from bsp/stm32/stm32f401-st-nucleo/figures_en/saveing.png rename to bsp/stm32/docs/figures_en/saveing.png diff --git a/bsp/stm32/stm32f401-st-nucleo/figures_en/select.png b/bsp/stm32/docs/figures_en/select.png similarity index 100% rename from bsp/stm32/stm32f401-st-nucleo/figures_en/select.png rename to bsp/stm32/docs/figures_en/select.png diff --git a/bsp/stm32/stm32f401-st-nucleo/figures_en/select_prj.png b/bsp/stm32/docs/figures_en/select_prj.png similarity index 100% rename from bsp/stm32/stm32f401-st-nucleo/figures_en/select_prj.png rename to bsp/stm32/docs/figures_en/select_prj.png diff --git a/bsp/stm32/docs/figures_en/setting.png b/bsp/stm32/docs/figures_en/setting.png new file mode 100644 index 0000000000..27e08df1b4 Binary files /dev/null and b/bsp/stm32/docs/figures_en/setting.png differ diff --git a/bsp/stm32/stm32f401-st-nucleo/figures_en/softpkgs.png b/bsp/stm32/docs/figures_en/softpkgs.png similarity index 100% rename from bsp/stm32/stm32f401-st-nucleo/figures_en/softpkgs.png rename to bsp/stm32/docs/figures_en/softpkgs.png diff --git a/bsp/stm32/stm32f401-st-nucleo/figures_en/terminal.png b/bsp/stm32/docs/figures_en/terminal.png similarity index 100% rename from bsp/stm32/stm32f401-st-nucleo/figures_en/terminal.png rename to bsp/stm32/docs/figures_en/terminal.png