xdc_bld__profile_{profile_name}

this symbol is always defined and {profile_name} is the compile goal's (see CompileGoal) profile name.

this

the configured program object (xdc.cfg.Program); i.e., the program object *after* the program's configuration script completes.

$args

array of arguments passed to the template

$args[1]

the name of the executable being produced for this configuration.

environment

hash table of XDC global parameters; e.g., "xdc.path", "xdc.root", ...

this

the "package contents" object (i.e., xdc.bld.PackageContents) *after* the package's build script (package.bld) completes.

$args

array of arguments passed to the template

$args[0]

the target (a module implementing the xdc.bld.ITarget interface)

$args[1]

hash-table of all package sources

environment

hash table of XDC global parameters; e.g., "xdc.path", "xdc.root", ...

cfgName

the name of the generated configuration file (without any directory prefix);

cfgDir

the name of the directory containing the config file;

exeName

the name of the executable file (without any directory prefix);

exeDir

the directory containing the executable file.

pkgName

the package's name (e.g., "ti.targets");

trgName

the target's name property;

trgSuffix

the target's suffix property.

      T.stdTypes.t_Int.size * T.bitsPerChar

      // if target macros are not already defined, 
      #if !defined(xdc_target_macros_include__)
          // include target-specific definitions
          #if defined(TARGET1)
              #include "target1.h"
          #elif defined(TARGET2)
              #include "target2.h"
          #elif ...
              :
          #else
              #error unsupported target
          #endif
      #endif
      // include common definitions
          :

".a<suffix>"

archive files (i.e., libraries)

".o<suffix>"

object files

".s<suffix>"

assembly language source (see scompile())

".x<suffix>"

executable files This suffix should be chosen to globally and uniquely identify the EABI (Embedded Application Binary Interface) of the objects produced by this target. Targets with the same suffix should should produce 100% EABI compatible objects and, targets with different suffixes should produce objects with incompatible EABIs.

  var GCArmv6 = xdc.module("gnu.targets.arm.GCArmv6");
  GCArmv6.rootDir = "C:/CodeSourcery/arm-2010q1"; 
  GCArmv6.LONGNAME = "bin/arm-none-linux-gnueabi-gcc";

	    Program.gen.debuggerFiles = true;

trgName

the target's name property

trgSuffix

the target's suffix property

platPName

the executable's platform package name

platIName

the executable's platform instance name

      var C64P = xdc.module('ti.targets.C64P');
      C64P.extensions[".s64"] = {
          suf: ".s64", typ: "asm"
      };

  Note that individual targets may add additional language types.

  It is also possible to remove default extensions.  For example, to
  remove the "`.asm`" extension from the target `ti.targets.C64P`, add
  the following lines to the build model startup script:

      var C64P = xdc.module('ti.targets.C64P');
      delete C64P.extensions[".asm"];

      local-machine-name user-name

1. if this target's suffix is in the list, that suffix is returned.
2. suffixes from compatibleSuffixes are matched against the list from the first to the last, and the first one with the match is returned.

1. pre-define macro definitions that enable code to be conditionally compiled based on compatible versions of a target's ISA.
2. locate appropriate source files during makefile generation; each ISA named in a chain causes the extensions ".s"isa to be added to the ITarget.extensions table (in the reverse order that they appear in the chain). For example, if a target's ISA is "64P" and the returned chain is ["62", "64", "64P"], the following assembly language suffixes are added to the target's extensions table: ".s64P", ".s64", ".s62".
3. determine the assembly language suffix used during legacy BIOS configuration; the first element of the target's ISA chain defines the suffix. For example, if a target's ISA is "64P" and the returned chain is ["62", "64", "64P"], the assembly suffix is ".s62".

      "<pkg>.<mod>{<d0>,<d1>,<d2>,<d3>"

1. if this target's suffix is in the list, that suffix is returned.
2. suffixes from compatibleSuffixes are matched against the list from the first to the last, and the first one with the match is returned.