Instructions for building a demo

1. Install Visual Studio Code: VSCode

   • Download the VSCode version for Windows (x64).
   • Manually run the installation file (.exe) if it does not start automatically.
   • Accept terms of use.
   • Choose the installation folder. The default selected folder is recommended.
   • Remember to check the “Add to Path” box to add the path to VSCode in the environment variables.

     

2. Download QEMU: QEMU

   • Enter the folder called "2023/".
   • Click on “qemu-w64-setup-20231224.exe.” The download will start automatically.
   • After the installation is complete, add the path to QEMU in the system variables.
     • Note: the path is the installation folder chosen during the installation phase.
     • Open "Environment Variables".
     • Click on “New” in the System Variables.
     • Add variable name and path to QEMU.

       

3. Download and install the GNU Arm Embedded Toolchain: Arm GNU Toolchain

   • Install the version "gcc-arm-none-eabi-10.3-2021.10-win32.exe".
   • Choose the installation folder. The default selected folder is recommended.
   • Remember to check the “Add to Path” box to add the path to GNU in the environment variables.

     

4. Install the FreeRTOS version 202212.01: FreeRTOS

5. Download and install Make for Windows: MAKE

6. Install MinGW version 11.0.0: MinGW

   • MinGW is created to support the GCC compiler on Windows systems and it is useful to avoid error during the compilation.

7. Add these paths to "Path" User Variable if they don't exist:

   • For make: C:\Program Files (x86)\GnuWin32\bin
   • Fot qemu: C:\Program Files\qemu
   • For the debugger used into the demo: C:\Program Files (x86)\Arm GNU Toolchain arm-none-eabi\13.2 Rel1\bin
     • Note: the paths are related to the installation on Windows, check that they are the same on your pc or if they are different, change them appropriately.

8. Open the folder "C:\yourPath\FreeRTOSv202212.01\FreeRTOSv202212.01\FreeRTOS\Demo\CORTEX_MPS2_QEMU_IAR_GCC" as VSCode Project.

9. Navigate to the .vscode folder.

10. Open the file "launch.json" and change the “miDebuggerPath” to the path to the new debugger in the GNU Arm Embedded Toolchain downloaded earlier. The new debugger will be “GNU Arm Embedded Toolchain/10 2021.10/bin/arm-none-eabi-gdb.exe”.

    

11. Navigate within the build\gcc subfolder and open an Integrated Terminal here (right click and then "Open in Integrated Terminal"). Execute the "make" command.

12. Open a shell and execute the code:

    qemu-system-arm -machine mps2-an385 -cpu cortex-m3 -kernel "C:\*yourPath*\FreeRTOSv202212.01\FreeRTOS\Demo\CORTEX_MPS2_QEMU_IAR_GCC\build\gcc\output\RTOSDemo.out" -monitor none -nographic -serial stdio
    

13. A simple demo will start automatically.