Skip to main content

IAR Embedded Workbench for Arm 10.10.x

Adding a CMSIS-Toolbox project to the IDE

In this section:

  1. Download and install a version of CMSIS-Toolbox that is compatible with the project you are going to import.

  2. Download and install CMake (version 3.31 or later).

  3. Only if you are using IAR Embedded Workbench/Build Tools for Linux:

    1. Install the version of Ruby that corresponds to the Linux version you are using.

    2. Navigate to the common/bin/pack2iar directory in the installation directory and run bundle install to download and install the bundles needed to run the pack conversion steps.

  4. If you are using IAR Embedded Workbench/Build Tools for Windows:

    1. Install Ruby version 4.0 or later and add it to your system PATH. For more information, see www.ruby-lang.org.

    2. Download and install the required associated bundles:

      For a local installation, navigate to common/bin/pack2iar and run, in the given order:

      bundle config set --local path installpath
bundle install

      This downloads and installs the bundles needed to run the pack conversion steps.

    3. Set these environment variables:

      GEM_PATH=installpath/ruby/version/gems
GEM_HOME=installpath/ruby/version

  5. Choose Tools>Options>CMake/CMSIS-Toolbox to open the settings page for CMake/CMSIS-Toolbox and specify the paths to the:

    • CMake executable

    • CMSIS-Toolbox installation

    • Pack root folder (the local PACK repository)

  6. To prepare for adding a csolution.yml project file to the IDE, choose Project>Create New Project to open the Create New Project dialog box.

  7. Select the template Import csolution.yml, located under the CMake for Arm folder.

  8. Navigate to the csolution.yml file that belongs to the CMSIS-Toolbox project you want to add. Adding it can take a few minutes.

  9. Save the project file in a suitable location.

    Now all files should be displayed in the Workspace window.

    The project can now be analyzed and debugged as a regular Embedded Workbench project. In a project with multiple executable targets, select the target to debug on the Project>Options>CMake>Target page.

    You can also use the template Empty project and import a csolution.yml file into the IDE later, using the command Project>Add CMake Connector>CSolution. Note that you can only add one csolution.yml file!