IAR Embedded Workbench for ARM

beLow is compatible with IAR Embedded Workbench for ARM. To make a project compatible with beLow, the iarbuild command must be used in the Build script.

IAR Embedded Workbench for ARM creates a project metadata file with extension .ewp.

Commands to build your project

• Incremental build

Incremental build (recommended)

iarbuild .\path\to\MyProject.ewp -make "MyConfig"

• Clean build

Clean build

iarbuild .\path\to\MyProject.ewp -build "MyConfig"

We recommend using the incremental build for better performance.

iarbuild must be in your PATH when running beLow. Also the IAR ARM tools (for example iccarm) must be in your PATH as well.

Default installation paths (IAR Embedded Workbench 9.2)

• Default path of iarbuild:

C:\Program Files\IAR Systems\Embedded Workbench 9.2\common\bin

• Default path of ARM tools (including iccarm):

C:\Program Files\IAR Systems\Embedded Workbench 9.2\arm\bin

For beLow to work properly with IAR Embedded Workbench for ARM, add these paths to your user's Path environment variable.

Edit your user's environment variables

Edit your user's environment variables

1

Add IAR tools to your PATH

Add the following directories to your user's Path environment variable:

• C:\Program Files\IAR Systems\Embedded Workbench 9.2\common\bin

• C:\Program Files\IAR Systems\Embedded Workbench 9.2\arm\bin

2

Verify commands in a new terminal

After updating the environment, open a new terminal and verify the commands work:

Verify commands

iarbuild --help
iccarm --help

3

Restart beLowCTL

beLowCTL should be restarted after changing the user's environment for the changes to be recognized.

4

Test building your project

In a terminal, check that your project can be built using iarbuild (example incremental build):

Test build

iarbuild .\path\to\MyProject.ewp -make "MyConfig"

Configuring beLow project scripts

• Configure section: leave blank.

• Clean section:

  • Script content:

Clean script

iarbuild .\path\to\MyProject.ewp -clean "MyConfig"

• Script execution path: In the target directory

• Shell: Pwsh

• Build section:

  • Script content:

Build script

iarbuild .\path\to\MyProject.ewp -make "MyConfig"

• Script execution path: In the target directory

• Shell: Pwsh

Do not wrap your iarbuild command in another script: beLow needs to recognize the iarbuild command directly in the script to perform instrumentation for compilation database generation. The iarbuild command must appear directly in your script.