Keil Logo

Project Information and Layers

Project Information

Add general project information using the <Project Info> item in the Info/Layer box:

Project Info/Layer tab

Specify the following:

  • The Title of the project.
  • A Brief Description of the purpose and content of the project (100 characters max.).
  • A link to the project's Documentation.
  • One or more project Categories.
  • The usage License of the project in SPDX format.
  • Provided/Consumed Interfaces are not applicable on the <Project Info> level.
  • A Board that the project was created for.


The name <Project Info> is fix and cannot be changed.

Project Layers

Layers group pre-configured software components and project files. These can be used to:

  • retarget pre-built software from an evaluation kit to a bespoke hardware design.
  • scale examples to many targets.
  • build projects with various combinations of layers in a continuous integration/continuous delivery (CI/CD) environment for a wide range of hardware.


Project layers play an important role in the CMSIS-Build flow but cannot be used further in µVision.

Creating project layers

The following steps explain how to use µVision to separate a project into several layers.

<Manage Project Items> Go to Project - Manage - Project Items... and switch to the Project Info/Layer tab:

Project Info/Layer tab

  1. Create a new layer by selecting the New (Insert) button and add a new layer, for example "Board":
    • Enter the Title of the layer.
    • Enter a brief Description of the layer (purpose, components, usage info).
    • Enter a link to the layer Documentation.
    • Enter one or more layer Categories.
    • Enter the License that is used for the layer (use the SPDX Identifier).
    • Enter one or more Provided Interfaces.
    • Enter one or more Consumed Interfaces.
    • Select Target for one layer. This layer will contain the information about the target that is used in the project.
    • Select a Board the layer is targeted at.
  2. Repeat these steps for each layer that you want to create in your project.
  3. Click OK when done.

Assigning project items to layers

In the Project window, right-click the file or software component you wish to add to a layer and select Options for 'XYZ'. In case of a software component, the Options for component window opens:

Options for component

  1. Select the component you wish to add to a layer.
  2. On the Properties tab, in the Settings section, use the Layer drop-down box to assign a layer to the software component (the list will be automatically populated with the layers that you have created before).
  3. Select another software component for layer assignment or click OK.

In case of a file, the Options for file window opens:

Options for file

On the Properties tab, use the Layer drop-down box to assign a layer to the file (the list will be automatically populated with the layers that you have created before) and click OK.

Exporting layer information

The project format specified by CMSIS, CPRJ can carry layer information. While this is not the default µVision project format, you can export your design using CPRJ.

Go to Project — Export — Save Project to CPRJ format to export. The new file will be stored in the project's root directory, named <project_name>.<target_name>.cprj.

See also:

Use this project format to run nightly build tests in CI/CD environments with the CMSIS-Build flow.

  Arm logo
Important information

This site uses cookies to store information on your computer. By continuing to use our site, you consent to our cookies.

Change Settings

Privacy Policy Update

Arm’s Privacy Policy has been updated. By continuing to use our site, you consent to Arm’s Privacy Policy. Please review our Privacy Policy to learn more about our collection, use and transfers
of your data.