Create csolution project

This learning path will introduce the steps to create a basic RTX-based RTOS application using the latest features of CMSIS .

For more information on the latest update, see the CMSIS v6 is here blog.

You will use Keil Studio for VS Code in this Learning Path.

This Learning Path is written for the supplied Cortex-M4 Fixed Virtual Platform (FVP), but you can run it on any of the 10,000+ devices supported by CMSIS-Pack .

Create a New Project

Keil Studio projects are based on the CMSIS Solution standard.

1. Open the VS Code IDE, and select File > New File from the File menu. You will be prompted for the type of file. Select New Solution (Arm CMSIS Solution).
2. The Create New Solution window will open. Click the Target Device pulldown, and search for ARMCM4.
3. From the Templates, Reference Applications, and Examples pulldown, select Blank Solution.
4. Ensure Arm Compiler 6 is the selected compiler.
5. Enter an appropriate Solution Name. This will define the folder name that the project will be created into. You can also change the folder location if necessary.
6. Click Create. You will be prompted to open the solution in the current window, or open a new window.

Configure the Solution Environment

VS Code allows complete configurability of all aspects of the project.

• Locate vcpkg-configuration.json within the project. This file defines the components used.
• Right-click on this file, and select Configure Arm Tools Environment to open the configuration panel.

From the dropdown menus, make sure to select the most up-to-date versions of the following:

• Arm CMSIS-Toolbox
• Arm Compiler for Embedded
• Arm Debugger
• Arm Virtual Hardware for Cortex-M based on Fast Models
• Kitware’s CMake tool
• Ninja Build

Set all other tools to None as they are not needed for this example.

If you open vcpkg-configuration.json in the text editor, you’ll see these selections reflected. Close the file to save your changes.

All necessary components will be downloaded and installed as necessary (if not already installed).

Configure CMSIS Options

1. Select CMSIS from the Extensions icon list in VS Code. You will see the project structure.
2. Hover over the top-level project and click Manage Software Components to add CMSIS Software Packs to your project.

Enable the following components:

• CMSIS > Core
• CMSIS > OSTick > SysTick
• CMSIS > RTOS2 > Keil RTX
• Device > Startup

You may need to select Software packs: All packs from the pull down.

If prompted in the Validation pane, select the latest available version for each. Use the CMSIS-RTX pack if others are shown.

Close this view to save.

Define the Memory Map

Use scatter-loading to define the memory map to the linker.

The memory map for the FVP is given in the documentation .

The project should be configured to use ARMCM4_ac6.sct as the scatter file. Locate this file in the CMSIS Extension view, and click to create.

Populate with the following.

    

        
        
            LOAD 0x0 0x400000 {
	ROOT 0x0 0x400000 {
		*.o (RESET, +First)
		*(InRoot$$Sections)
		.ANY (+RO)   }

	RAM 0x20000000 0x40000 {
		.ANY (+RW +ZI)     }

	ARM_LIB_HEAP  0x20040000 EMPTY 0x10000 {}

	ARM_LIB_STACK 0x20050000 EMPTY 0x10000 {}
}
        
    

Configure Debug with the FVP

1. Select Run and Debug from the Extensions icon list.
2. Click the gear icon to open launch.json. This is the file that defines the debug instance.
3. Right-click on launch.json and select Open Run and Debug Configuration.

From the Selected Configuration pull-down, select New Configuration > Launch FVP. Edit the Configuration Name if desired.

From the Target > Configuration Database Entry pull-down, select MPS2_Cortex_M4 > Cortex-M4.

Leave other fields as default. Observe that launch.json has been updated.

Close the file to save your configuration.