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]
[--cfgDir configfile_dir]
[--device device_name]
[compileOptions compile_options_str (should be the last option]
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.
- --cfgDir
- Root directory containing the configuration file
The directory is searched for configuration file (with extension .cfg).
The directory should contain only one configuration file. In case of
multiple configuration files, only the first configuration file in
the alphabetical order will be passed to xdc.tools.configuro.
- --device
- The name of the device
The device name has to be passed to the xdc.tools.configuro tool.
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.
- --cfgDir configfile_ dir
-
The directory that contains RTSC configuration file. Only one config
file is expected to be in the directory.
- --device device_name_string
-
The name of the device.
- compileOptions compile_options_string
-
The command line options passed to the compiler. This should be the last
option. Any option after the compileOptions string is considered to be
command line compile options.
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>"
--cfgDir "<configfile_dir>" --device "<device_name>"
compileOptions "<compiler_options>"
generated on Wed, 12 Jun 2013 00:51:35 GMT