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:

  • A Description of the purpose and content of the project.
  • A URL to retrieve the project from.
  • Keywords that are used to describe the project.
  • A project Category.
  • The usage License of the project in SPDX format.

Note

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.

Note

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

  • Create a new layer by selecting the New (Insert) button and add a new layer, for example "BSP".
  • Enter a short Description of the layer (purpose, components, usage info).
  • [Optional] Enter Keywords for search engines.
  • [Optional] Enter one or more layer Categories.
  • [Optional] Enter the License that is used for the layer (use the SPDX Identifier).
  • Repeat these steps for each layer that you want to create in your project.
  • Select Target for one layer. This layer will contain the information about the target that is used in the project.
  • 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.