Update getting-started.md

Wiznet · Oct 20, 2023 · 4084961 · 4084961
1 parent e79115d
commit 4084961
Showing 1 changed file with 95 additions and 107 deletions.
diff --git a/docs/Product/Open-Source-Hardware/surf5/getting-started.md b/docs/Product/Open-Source-Hardware/surf5/getting-started.md
@@ -60,197 +60,185 @@ The entire list of parts of the board is available at the [WIZ750SR Overview: Pr
 •	Visual Studio Code
 
 •	Xpack Build Tools
-
-
-
+
+
+
+
 (1)	Install ARM GCC Compiler
 [Download link](https://developer.arm.com/downloads/-/gnu-rm)
- 
-  
+
+
 <a target="_blank" href={require('/img/osh/surf5/vsset1.png').default}><img src={require('/img/osh/surf5/vsset1.png').default} alt="Surf5"/></a>
- 
+
 <a target="_blank" href={require('/img/osh/surf5/vsset2.png').default}><img src={require('/img/osh/surf5/vsset2.png').default} alt="Surf5"/></a>
+ <a target="_blank" href={require('/img/osh/surf5/vsset3.png').default}><img src={require('/img/osh/surf5/vsset3.png').default} alt="Surf5"/></a>
 
-<a target="_blank" href={require('/img/osh/surf5/vsset3.png').default}><img src={require('/img/osh/surf5/vsset3.png').default} alt="Surf5"/></a>
-
-<a target="_blank" href={require('/img/osh/surf5/vsset4.png').default}><img src={require('/img/osh/surf5/vsset4.png').default} alt="Surf5"/></a>
-
+ <a target="_blank" href={require('/img/osh/surf5/vsset4.png').default}><img src={require('/img/osh/surf5/vsset4.png').default} alt="Surf5"/></a>
 
-
 
 
-(2) CMake
+ (2) Install CMake
 [Download link](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2019)
-  
- 
+
+
 <a target="_blank" href={require('/img/osh/surf5/vsset5.png').default}><img src={require('/img/osh/surf5/vsset5.png').default} alt="Surf5"/></a>
- 
+
 <a target="_blank" href={require('/img/osh/surf5/vsset6.png').default}><img src={require('/img/osh/surf5/vsset6.png').default} alt="Surf5"/></a>
- 
+
 <a target="_blank" href={require('/img/osh/surf5/vsset7.png').default}><img src={require('/img/osh/surf5/vsset7.png').default} alt="Surf5"/></a>
- 
+
 <a target="_blank" href={require('/img/osh/surf5/vsset8.png').default}><img src={require('/img/osh/surf5/vsset8.png').default} alt="Surf5"/></a>
- 
+
 <a target="_blank" href={require('/img/osh/surf5/vsset9.png').default}><img src={require('/img/osh/surf5/vsset9.png').default} alt="Surf5"/></a>
-
-
-
-
-
 
-(3)	Build Tools for Visual Studio 2019
+
+
+(3)	Install Build Tools for Visual Studio 2019
 [Download link](https://visualstudio.microsoft.com/ko/downloads/)
-
-
+
 <a target="_blank" href={require('/img/osh/surf5/vsset10.png').default}><img src={require('/img/osh/surf5/vsset10.png').default} alt="Surf5"/></a>
- 
+
 <a target="_blank" href={require('/img/osh/surf5/vsset11.png').default}><img src={require('/img/osh/surf5/vsset11.png').default} alt="Surf5"/></a>
- 
+
 <a target="_blank" href={require('/img/osh/surf5/vsset12.png').default}><img src={require('/img/osh/surf5/vsset12.png').default} alt="Surf5"/></a>
- 
+
 <a target="_blank" href={require('/img/osh/surf5/vsset13.png').default}><img src={require('/img/osh/surf5/vsset13.png').default} alt="Surf5"/></a>
-
-<a target="_blank" href={require('/img/osh/surf5/vsset14.png').default}><img src={require('/img/osh/surf5/vsset14.png').default} alt="Surf5"/></a>    
-
-
-
-
-
+
+<a target="_blank" href={require('/img/osh/surf5/vsset14.png').default}><img src={require('/img/osh/surf5/vsset14.png').default} alt="Surf5"/></a>
+
 
 
-(4)	Visual Studio Code
+(4)	Install Visual Studio Code
 [Download link](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2019)
- 
+
 
 <a target="_blank" href={require('/img/osh/surf5/vsset15.png').default}><img src={require('/img/osh/surf5/vsset15.png').default} alt="Surf5"/></a>
- 
+
 <a target="_blank" href={require('/img/osh/surf5/vsset16.png').default}><img src={require('/img/osh/surf5/vsset16.png').default} alt="Surf5"/></a>
- 
+
 <a target="_blank" href={require('/img/osh/surf5/vsset17.png').default}><img src={require('/img/osh/surf5/vsset17.png').default} alt="Surf5"/></a>
- 
+
 <a target="_blank" href={require('/img/osh/surf5/vsset18.png').default}><img src={require('/img/osh/surf5/vsset18.png').default} alt="Surf5"/></a>
- 
+
 <a target="_blank" href={require('/img/osh/surf5/vsset19.png').default}><img src={require('/img/osh/surf5/vsset19.png').default} alt="Surf5"/></a>
-
-
-
-
-
 
 
-(5)	Xpack Build Tools
+
+(5)	Install Xpack Build Tools
 [Download link](https://github.com/xpack-dev-tools/windows-build-tools-xpack/releases/)
- 
-  
+
+
 Click “Download Now” Button
- 
+
 <a target="_blank" href={require('/img/osh/surf5/vsset20.png').default}><img src={require('/img/osh/surf5/vsset20.png').default} alt="Surf5"/></a>
-
 
 
 
-          
+
+
 **2. Extract xpack-windows-build-tools-4.x.x.x**
-  
-  
+
+
 <a target="_blank" href={require('/img/osh/surf5/vsset21.png').default}><img src={require('/img/osh/surf5/vsset21.png').default} alt="Surf5"/></a>
-
+
+
 Extract the xpack-windows-build-tool-4.x.x.x.zip archive. Save the extracted folder to the recommended path below.
-  
+
 **Recommended storage path for the xpack-windows-build-tools folder** : C:\Program Files (x86)\xpack-windows-build-tools-4.x.x.
-
 
 
 
-          
+
+
 **3. Create a New Workspace (Prevent Changes to Existing Settings)**
-  
-  
+
+
 Create a new workspace. The reason for creating a new workspace is to prevent changes to the existing settings.
-  
-  
+
+
 <a target="_blank" href={require('/img/osh/surf5/vsset22.png').default}><img src={require('/img/osh/surf5/vsset22.png').default} alt="Surf5"/></a>
-  
+
 First, select "File -> Add Folder to Workspace."
-  
-  
+
+
 <a target="_blank" href={require('/img/osh/surf5/vsset23.png').default}><img src={require('/img/osh/surf5/vsset23.png').default} alt="Surf5"/></a>
-  
+
 Select the "W7500P" project folder as the target for the workspace, and then click the "Add" button.
 (The "W7500P" should be the top-level directory.)
-  
-  
+
+
 <a target="_blank" href={require('/img/osh/surf5/vsset24.png').default}><img src={require('/img/osh/surf5/vsset24.png').default} alt="Surf5"/></a>
-  
+
 If you've added the workspace with the W7500P folder path, then click on "File -> Save Workspace As..." again.
-  
-  
+
+
 <a target="_blank" href={require('/img/osh/surf5/vsset25.png').default}><img src={require('/img/osh/surf5/vsset25.png').default} alt="Surf5"/></a>
-  
+
 Simply press "Save" with the same file name.
-
 
 
 
-          
+
+
 **4.  Save the CMake Extension Settings for the stored workspace.**
-  
-  
+
+
 <a target="_blank" href={require('/img/osh/surf5/vsset26.png').default}><img src={require('/img/osh/surf5/vsset26.png').default} alt="Surf5"/></a>
 <a target="_blank" href={require('/img/osh/surf5/vsset27.png').default}><img src={require('/img/osh/surf5/vsset27.png').default} alt="Surf5"/></a>
-  
+
 In CMake Tools, go to the gear icon (settings) -> Extension Settings -> Navigate to the Workspace tab. In the top search bar, type "@ext:ms-vscode.cmake-tools" to search.
-  
-  
+
+
 <a target="_blank" href={require('/img/osh/surf5/vsset28.png').default}><img src={require('/img/osh/surf5/vsset28.png').default} alt="Surf5"/></a>
-  
+
 In the options, press "Add Item" in the Configure Args section and add the following two definitions:
-  
+
 CMAKE_MAKE_PROGRAM is the location of the make executable (inside the previously extracted xpack folder).
-  
+
 ARM_TOOLCHAIN_DIR is the location of the GNU Arm compiler's executable files that you previously downloaded.
-  
+
 For example, the author used:
-
+
+
 -DARM_TOOLCHAIN_DIR=C:/Program Files (x86)/GNU Arm Embedded Toolchain/10 2021.10/bin
 -DCMAKE_MAKE_PROGRAM=C:/Program Files (x86)/xpack-windows-build-tools-4.4.0-1/bin/make.exe
-  
-  
+
+
 Adjust the Configure Args to match your own file paths according to your setup.
-  
-  
+
+
 <a target="_blank" href={require('/img/osh/surf5/vsset29.png').default}><img src={require('/img/osh/surf5/vsset29.png').default} alt="Surf5"/></a>
-  
+
 Once you have completed the path configuration, enter "Unix Makefiles" in the "CMake: Generator" field.
-
 
 
 
-          
+
+
 **5. Build Project in VS Code**
-  
-  
+
+
 <a target="_blank" href={require('/img/osh/surf5/vsset30.png').default}><img src={require('/img/osh/surf5/vsset30.png').default} alt="Surf5"/></a>
-  
+
 Press the F1 key, and then click on "CMake: Select a Kit."
-  
-  
+
+
 <a target="_blank" href={require('/img/osh/surf5/vsset31.png').default}><img src={require('/img/osh/surf5/vsset31.png').default} alt="Surf5"/></a>
-  
+
 Select "GCC Arm Embedded" to configure the kit.
-  
-  
+
+
 <a target="_blank" href={require('/img/osh/surf5/vsset32.png').default}><img src={require('/img/osh/surf5/vsset32.png').default} alt="Surf5"/></a>
-  
+
 Click the "Build" button at the bottom or press F7 to start the build process.
-  
-  
+
+
 <a target="_blank" href={require('/img/osh/surf5/vsset33.png').default}><img src={require('/img/osh/surf5/vsset33.png').default} alt="Surf5"/></a>
-  
+
 Once the build is completed, you will see a message like the one above in the OUTPUT window.
-  
-  
+
+
 <a target="_blank" href={require('/img/osh/surf5/vsset34.png').default}><img src={require('/img/osh/surf5/vsset34.png').default} alt="Surf5"/></a>
-  
+
 You will also be able to confirm that the Build directory has been created. The project folder within the Build directory contains the generated bin files. You can save these bin files to the W7500 device and use the project.