octodemo/vscode-get-started

Get started example for CMSIS-Toolbox in Visual Studio Code

GetStarted project

This project prints "GetStarted World" and a counter value via semihosting output. It is configured for Arm Virtual Hardware (Cortex-M3).

Prerequisites

Tools

• CMSIS-Toolbox 1.4.0 or later
• GNU Arm Embedded Toolchain 12.2.rel1 or later
• Keil MDK 5.38a or later
  • Arm Compiler 6.18 (part of MDK, Eval Version sufficient for compilation)
  • Arm Virtual Hardware for Cortex-M55 v11.18.1 (requires MDK - Professional)

Packs

Required packs are listed in the file GetStarted.csolution.yml

Project Structure

The project is generated using the CMSIS-Toolbox and is defined in csolution format:

• GetStarted.csolution.yml lists the required packs and defines the hardware target and build-types (along with the compiler).
• GetStarted.cproject.yml defines the source files and the software components.

Generated Project

1. Use then csolution and cpackget commands to install missing packs.

   ./ $ csolution list maps -s GetStarted.csolution.yml > packs.txt
   ./ $ cpackget add -f packs.txt

2. Use the csolution command to create .cprj project file.

   ./ $ csolution convert -s GetStarted.csolution.yml
   
   ./build/GetStarted/GCC/Debug+AVH/GetStarted.Debug+AVH.cprj - info csolution: file generated successfully
   ./build/GetStarted/GCC/Release+AVH/GetStarted.Release+AVH.cprj - info csolution: file generated successfully
   ./GetStarted.cbuild-idx.yml - info csolution: file generated successfully
   ./build/GetStarted/GCC/Debug+AVH/GetStarted.Debug+AVH.cbuild.yml - info csolution: file generated successfully
   ./build/GetStarted/GCC/Release+AVH/GetStarted.Release+AVH.cbuild.yml - info csolution: file generated successfully

3. Use the cbuild command to an executable file, here fore the Debug build.

   ./ $ cbuild build/GetStarted/GCC/Debug+AVH/GetStarted.Debug+AVH.cprj
   
   info cbuild: Build Invocation 1.0.0 (C) 2022 ARM
      :    // output of the build steps
   info cbuild: build finished successfully!

Note: During the build process required packs may be downloaded.

Execute Project

The project is configured for execution on Arm Virtual Hardware which removes the requirement for a physical hardware board.

• When using MDK-Professional, you may execute it with the command:

  ./ $ VHT_MPS2_Cortex-M3 -f vht-config.txt -a build/GetStarted/GCC/Debug+AVH/outdir/GetStarted.Debug+AVH.elf