package iar.tools.configuro |
 |
Command-line configuration tool for IAR Embedded Workbench
This command-line tool computes the appropriate configuro options from the
set of options passed from the IAR Workbench (for ex. target/platform
from compile options). With these options, the xdc.tools.configuro tool
is executed to compute the set of libraries, command-line flags and
the other artifacts needed to build the application in IAR Workbench.
[
more ... ]
package iar.tools.configuro [1, 0, 0] {
// Command implementation
}
USAGE
xs iar.tools.configuro [--help]
[-o outdir (optional)]
[-c codegen_dir]
[--cc compiler_name_string]
[--device device_name]
[--compileOptions compile_options_string]
[--linkOptions linker_options_string]
[--profile profile]
[--projFile project_file (optional)]
infile.cfg (optional)
OPTIONS
- -o
- Pathname of the output directory
A directory containing the generated build artifacts, in particular
the compiler.defs and linker.cmd files.
The last component of the output directory path must be a valid
ANSI C identifier; i.e., it must consist entirely of alphanumeric or
'_' characters and must not start with a number. So, the names
'0app' and 'app-test' are not valid but '0app/config' and
'app-test/config' are valid.
This is optional parameter. By default, the output directory has the
name configPkg and will be within the {#cfgDir} directory.
- -c
- Root directory of the code generation tools
The path to the installation directory of the compiler and linker
for the selected target. The definition of "installation directory"
can vary from compiler to compiler, but is most commonly the
directory that contains a "bin" subdirectory.
- --cc
- The name of the compiler
The compiler name is required to find the target and platform
xdc.tools.configuro options.
- --device
- The name of the device
The device name has to be passed to the xdc.tools.configuro tool.
- --compileOptions
- Compile options used for building C files
The compiler options are required to find the target and platform
options for xdc.tools.configuro.
- --linkOptions
- Linker options used for linking libraries
The linker options are required to pull in the correct libraries
during link.
- --profile
- Build profile
- --projFile
- IAR Embedded project file
This file is searched for the RTSC configuration file (.cfg).
DETAILS
This command-line tool computes the appropriate configuro options from the
set of options passed from the IAR Workbench (for ex. target/platform
from compile options). With these options, the xdc.tools.configuro tool
is executed to compute the set of libraries, command-line flags and
the other artifacts needed to build the application in IAR Workbench.
INPUTS
- -o outdir (Optional)
-
Optionally a output directory can be provided.
- -c codegen_dir
-
Root directory of the code generation tools.
- --cc compiler_name_string
-
The name of the compiler.
- --device device_name_string
-
The name of the device.
- --compileOptions compile_options_string
-
The command line options passed to the compiler.
- --linkOptions linker_options_string
-
The command line options passed to the linker.
- --profile profile
-
The build profile.
- --projFile project_file (Optional)
-
IAR Embedded Workbench project file. This is optional when
infile.cfg is passed on command line.
- infile.cfg (Optional)
-
A user-supplied configuration script that names a set of RTSC
modules, and optionally changes their configuration settings.
If provided, it will override the --projFile option.
OUTPUTS
- outdir/
-
A directory containing all generated build artifacts.
- outdir/compiler.defs
-
A file containing C compiler command-line flags. These flags must
included on the compiler command line for any C source file that
directly accesses the RTSC content. The flags define the header file
and include paths to ensure object code compatibility between all
all included content.
- outdir/linker.cmd
-
A file containing linker command-line flags. These flags must be
included on the linker command line for the final link of the
application. The flags list needed libraries and object files,
and on some platforms define the embedded system memory map.
For example:
xs iar.tools.configuro -c "<codegen_dir>" --cc "<compiler>"
--device "<device_name>" -compileOptions "<compiler_options>"
--linkOptions "<link_options>" --profile "<profile>" infile.cfg
generated on Wed, 09 Apr 2014 00:38:14 GMT