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.

-nologo

don't display archiver copyright

-c

don't link

-nologo

don't display macro assembler copyright

      t.stdTypes.t_Int.size * t.bitsPerChar

-W3

enable all warnings recommended for production purposes.

-c

don't link

-nologo

don't display compiler copyright

-Zp1

Packs structure members on 1-byte boundry

-nologo

Don't display linker copyright

      // 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.

-G5 (removed because it is incompatible with VC8.0)

Optimizes code to favor the Pentium processor

-Ob1

Expand only functions marked as inline or, in a C++ member function, defined within a class declaration

-Gs

Probe stack to automatically grow stack as necessary

-GX (removed because it is incompatible with VC8.0)

Enables synchronous exception handling

-WL

Write errors/warnings on a single output line

	    Program.gen.debuggerFiles = true;

	    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"];

-I$(rootDir)/$(compilerDir)/include

include compiler specific headers

-libpath...

directories to search for toolchain specific libraries

-nodefaultlib

don't search for default libraries when linking; all libraries used must be explicitly named

-incremental:no

link for execution (no subsequent link will occur)

-machine:ix86

link for the Intel x86 architecture

-map:$(XDCCFGDIR)/$@.map

output any link map information to the specified file ($(XDCCFGDIR) is usually package/cfg)

-pdb:$(XDCCFGDIR)/$@.pdb

output any program debug information to the specified file ($(XDCCFGDIR) is usually package/cfg)

      Win32.vcPath = [ 
          ["Visual Studio 7", 
              { 
                  compilerDir: "Vc7", 
                  dllPath: "Common7/IDE;VisualStudio.NETProfessional-English", 
                  sdkPath: "C:/PlatformSDK", 
                  libs: " msvcrt.lib setargv.obj oldnames.lib ole32.lib oleaut32.lib olepro32.lib uuid.lib kernel32.lib user32.lib gdi32.lib advapi32.lib shell32.lib comctl32.lib mfc70.lib msvcirt.lib" 
              } 
          ], 
          ["Visual Studio C++ 2005", 
              { 
                  compilerDir: "VC", 
                  dllPath: "Common7/IDE", 
                  sdkPath: "VC/PlatformSDK", 
                  libs: " msvcrt.lib setargv.obj oldnames.lib ole32.lib oleaut32.lib olepro32.lib uuid.lib kernel32.lib user32.lib gdi32.lib advapi32.lib shell32.lib comctl32.lib" 
              } 
          ] 
      ]; 

      var Win32 = xdc.module('microsoft.targets.Win32'); 
      Win32.vcPath["VC8"].sdkPath = "C:/WindowsSDK"; 

      var Win32 = xdc.module('microsoft.targets.Win32'); 
      Win32.vcPath = [ 
          ["VC8", 
              { 
                  compilerDir: "VC", 
                  dllPath: "Common7/IDE", 
                  sdkPath: "", 
                  libs: " msvcrt.lib setargv.obj oldnames.lib" 
              } 
          ], 
      ]; 

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.