Build

<< Click to Display Table of Contents >>

Navigation:  Program Windows > Documents Window > Project Properties >

Build

CC5X C Compiler

Compiler Path

Path to the compiler. Initial location is set automatically during IDE installation to enable access to free compiler version (which is a part of the installation).

oClick the icon to open the compiler User´s Guide.

oClick the icon to open the compiler web page.

 

Options

Compiler options. See the compiler User's guide. Default factory settings can be restored by the Default button.

oClick the icon to open the compiler User´s Guide - chapter: Command Line Options (only if the Acrobat Reader is set as a default to open PDF files).

 

It is also possible to control these compiler options from the source code by the #message '±CC5X [option]'.

Example:

o#message '+CC5X -bu' // Adds the -bu compiler option

o#message '-CC5X -bu' // Removes the -bu compiler option

 

Build option consultant

If checked, monitors optimal CC5X option settings and generates warnings to the Build window.


 

Show Build Window

Select when the Build window should be displayed after compilation.

Never

Always

After an error only

After an error or a warning (recommended)

 

Warnings and errors are issued not only by the compiler but also by the IQRF IDE itself.


 

Build Target + Upload

Allow warnings on Upload

If active, the Build Target + Upload function performs Upload even if there is a warning issued during the compilation.


 

Pre-Build Step / Post-Build Step

Enter a command line or file to be executed before / after a build. If the exit code is not equal to zero the build process is interrupted. Possible terminal output is displayed in the Build - Info window.

Parameters generated by IQRF IDE

 

%pfe%

Full path to .c file selected in the Project window, e.g. C:\path\file.c

%pf%

Full path to .c file without extension, e.g. C:\path\file

%p%

Full path to a directory with c. file, e.g. C:\path\

%fe%

Only .c file, e.g. file.c

%f%

Only .c file name without extension, e.g. file

%tr%

Selected TR module type, e.g. TR52D

%os%

Version of selected IQRF OS, e.g. 304

%dpa%

Version of selected DPA, e.g. 102

%cfg%

Full path to .xml file (TR configuration) selected in the Project window, e.g. C:\path\file.xml

%hex%

Full path to .hex file selected in the Project window, e.g. C:\path\file.hex

%iqrf%

Full paths to .iqrf files selected in the Project window. If there is more files selected the paths are separated by a semicolon. If no file is selected the parameter does not return any value. Example: C:\path\file_1.iqrf;C:\path\file_2.iqrf

The parameter must be enclosed in quotation marks if the path or file name contain a space e.g. "%p%".

 

Using of command

cmd /c command parameters

Examples:

oCopy compiled file to C:\backup\ directory: cmd /c copy "%pfe%" C:\backup\

oList of commands in Build window: cmd /c Help

oList of parameters in Build window: cmd /?

 

Using of file

file parameters

Example:

oExecuting the post_build.bat file with parameters: post_build.bat %p% %f%

creates output directory

copies file.c to output directory

clears file.fcs and file.asm files

 

Content of post_build.bat file:

REM File path %1

REM File name %2

if not exist %1%output mkdir output

SET FILE_NAME=%2

copy %FILE_NAME%.hex% output /Y

DEL %FILE_NAME%.fcs%

DEL %FILE_NAME%.asm%