Command - xdc.tools.configuro

From RTSC-Pedia

Jump to: navigation, search
revision tip
—— LANDSCAPE orientation
spacer [printable version]  [offline version]offline version generated on 13-May-2015 10:05 UTCspacer

Command - xdc.tools.configuro

Target content configuration tool

Contents

  • 1 Synopsis
  • 2 Description
  • 3 Examples

Synopsis

 
xs xdc.tools.configuro [options ...] prog.cfg

For a complete description of this tool's options, see its reference documentation page xdc.tools.configuro.

Description

The xdc.tools.configuro tool processes configuration files and generates several files that must be integrated into the build of applications that use RTSC components. This tool is itself a RTSC component: the xdc.tools.configuro package. For details about using this tool, see Consuming Configurable Content.

Running the configuro command generates a subdirectory with the same name as your CFG file minus the ".cfg" extension; for example, mycfg for the mycfg.cfg file. This subdirectory is in fact a RTSC package. The configuro command allows you to import RTSC content, in the form of reusable modules built using XDCtools, into your application.

This tool is the recommended method for integrating RTSC components into traditional command-line based build environments.

Configuro lets you identify and customize the RTSC components you want to use. It computes a set of libraries, command-line flags, and other artifacts to include in your application build. By changing values of configuration settings, you can trade off the functionality, memory footprint, and even performance of the RTSC components to best meet the needs of your application.

To generate files from a configuration, use this command line syntax:

xs xdc.tools.configuro [-v | --help] [-@ optionsfile]
                       [-b config_bld | -c codegen_dir | --cb]
                       [-t target] [-p platform[:instance]] [-r profile] [--linkTemplate template]
                       [-Dname=value] [-w | -x regexp] [--rtsName pkg_name] [--cfgArgs args_string]
                       [-o outdir] prog.cfg

The common configuro command line options available include:

-b
Specifies the name of the config.bld file.
-c
Specifies root directory of the code generation tools or compiler.
--cb
Use a config.bld found along the package path
--cfgArgs
Optional arguments passed to configuration script
-D
Set Java properties in the configuration environment
--linkTemplate
Linker command file template
-o
Specifies the name of the output directory.
-p
Specifies the platform to use.
-r
Specifies the build profile to use.
--rtsName
Specify RTSC runtime package name
-t
Specifies the target to use.
-v
Show details during build.
-w
Treat incompatibilities only as warnings.
-x
Exclude specified packages from compatibility checking.

For more information see the reference documentation for the xdc.tools.configuro package.

Examples

The following command configures a program compiled using the ti.targets.C64 target to run on the ti.platforms.sim6xxx platform with a compiler tool-chain installed in c:/CCStudio_v3.3/C6000/cgtools according to the configuration script mycfg.cfg.

xs xdc.tools.configuro -t ti.targets.C64 -p ti.platforms.sim6xxx \
                       -c c:/CCStudio_v3.3/C6000/cgtools mycfg.cfg
spacer [printable version]  [offline version]offline version generated on 13-May-2015 10:05 UTCspacer
Copyright © 2008 The Eclipse Foundation. All Rights Reserved
Retrieved from "rtsc.eclipse.org/docs-tip/Command_-_xdc.tools.configuro"
Views
  • Article
  • Discussion
  • View source
  • History
Personal tools
  • Log in / create account
Navigation
  • RTSC-pedia home
  • RTSC project home
  • News & support
  • Help
binders
  • General Information
  • RTSC Programming
  • User's Guide
  • Reference Manual
package reference
  • XDCtools packages
lists
  • Master doc-map
  • Category query
  • Redirected pages
tools
  • Find+Replace (grep)
  • RSS feed
more tools
  • What links here
  • Related changes
  • Upload file
  • Special pages
  • Printable version
gipoco.com is neither affiliated with the authors of this page nor responsible for its contents. This is a safe-cache copy of the original web site.