metaonly module ti.platforms.evmTI816X.Platform
index URL

Platform support for the evmTI816X

This module implements xdc.platform.IPlatform and defines configuration parameters that correspond to this platform's Cpu's, Board's, etc. [ more ... ]
XDCscript usage meta-domain sourced in ti/platforms/evmTI816X/Platform.xdc
var Platform = xdc.useModule('ti.platforms.evmTI816X.Platform');
module-wide constants & types
    var obj = new Platform.Board// Board-level description;
        obj.id// unique id within the platform = String  ...
        obj.boardName// name of the board = String  ...
        obj.boardFamily// optional family name = String  ...
        obj.boardRevision// optional revision string = String  ...
 
    var obj = new Platform.Memory// A named contiguous range of addresses;
        obj.comment// description of this block = String  ...
        obj.name// name of memory segment = String  ...
        obj.space// "code", "data", "code/data", etc... = String  ...
        obj.page// page of memory segment = UInt  ...
        obj.base// base address of memory segment = UInt  ...
        obj.len// length of memory segment = UInt  ...
        obj.access// attributes of memory: "RWX" = String  ...
module-wide config parameters
    const Platform.BOARD//  = IPlatform.Board {
        id: "0",
        boardName: "evmTI816X",
        boardFamily: "evmTI816X",
        boardRevision: null
    };
    const Platform.DSS//  = IExeContext.Cpu {
        id: "1",
        clockRate: 250.0,
        catalogName: "ti.catalog.arm.cortexm3",
        deviceName: "TMS320TI816X",
        revision: "1.0"
    };
    const Platform.GEM//  = IExeContext.Cpu {
        id: "0",
        clockRate: 800.0,
        catalogName: "ti.catalog.c6000",
        deviceName: "TMS320TI816X",
        revision: ""
    };
    const Platform.GPP//  = IExeContext.Cpu {
        id: "2",
        clockRate: 1000.0,
        catalogName: "ti.catalog.arm.cortexa8",
        deviceName: "TMS320TI816X",
        revision: "1.0"
    };
per-instance config parameters
    var params = new Platform.Params// Instance config-params object;
        params.codeMemory// The default segment for code sections = String undefined;
        params.customMemoryMap// A custom mapping of memory names to memory objects = IPlatform.Memory[string] undefined;
        params.dataMemory// The default segment for data sections = String undefined;
        params.externalMemoryMap// A mapping of memory names to memory objects for external memory = IPlatform.Memory[string] [
            [
                "DDR3_HOST",
                {
                    comment: "DDR3 Memory reserved for use by the A8",
                    name: "DDR3_HOST",
                    base: 0x80000000,
                    len: 0x0B000000
                }
            ],
            [
                "DDR3_DSP",
                {
                    comment: "DDR3 Memory reserved for use by the C674",
                    name: "DDR3_DSP",
                    base: 0x8B000000,
                    len: 0x02000000
                }
            ],
            [
                "DDR3_SR1",
                {
                    comment: "DDR3 Memory reserved for use by SharedRegion 1",
                    name: "DDR3_SR1",
                    base: 0x8D000000,
                    len: 0x00C00000
                }
            ],
            [
                "DDR3_HDVPSS",
                {
                    comment: "DDR3 Memory reserved for use by HDVPSS",
                    name: "DDR3_HDVPSS",
                    base: 0x8DC00000,
                    len: 0x00200000
                }
            ],
            [
                "DDR3_V4L2",
                {
                    comment: "DDR3 Memory reserved for use by V4L2",
                    name: "DDR3_V4L2",
                    base: 0x8DE00000,
                    len: 0x00200000
                }
            ],
            [
                "DDR3_SR0",
                {
                    comment: "DDR3 Memory reserved for use by SharedRegion 0",
                    name: "DDR3_SR0",
                    base: 0x8E000000,
                    len: 0x01000000
                }
            ],
            [
                "DDR3_M3",
                {
                    comment: "DDR3 Memory reserved for use by the M3 core",
                    name: "DDR3_M3",
                    base: 0x8F000000,
                    len: 0x01000000
                }
            ]
        ];
        params.l1DMode//  = String "32k";
        params.l1PMode//  = String "32k";
        params.l2Mode//  = String "0k";
        params.renameMap// A map for renaming memory objects = String[string] undefined;
        params.sectMap// A mapping of linker output section names to memory segments = String[string] undefined;
        params.stackMemory// The default segment for stack = String undefined;
per-instance creation
    var inst = Platform.create// Create an instance-object(String name, Any args, params);
per-instance functions
    inst.getExeContext// Get execution context object corresponding to the specified program(Any prog) returns Any
    inst.getExecCmd// Get the exec command used to run the program on this platform(Any prog, Any platPath) returns Any
    inst.getLinkTemplate// Get Linker Command file template used to link an executable(Any prog) returns Any
 
DETAILS
This module implements xdc.platform.IPlatform and defines configuration parameters that correspond to this platform's Cpu's, Board's, etc.
The configuration parameters are initialized in this package's configuration script (package.cfg) and "bound" to the TCOM object model. Once they are part of the model, these parameters are queried by a program's configuration script.
This particular platform has 4 CPU's, a host GPP, 2 M3's, and a C674 DSP.
 
struct Platform.Board
index URL

Board-level description

XDCscript usage meta-domain
var obj = new Platform.Board;
 
    obj.id = String  ...
    // unique id within the platform
    obj.boardName = String  ...
    // name of the board
    obj.boardFamily = String  ...
    // optional family name
    obj.boardRevision = String  ...
    // optional revision string
 
 
struct Platform.Memory
index URL

A named contiguous range of addresses

XDCscript usage meta-domain
var obj = new Platform.Memory;
 
    obj.comment = String  ...
    // description of this block
    obj.name = String  ...
    // name of memory segment
    obj.space = String  ...
    // "code", "data", "code/data", etc...
    obj.page = UInt  ...
    // page of memory segment
    obj.base = UInt  ...
    // base address of memory segment
    obj.len = UInt  ...
    // length of memory segment
    obj.access = String  ...
    // attributes of memory: "RWX"
 
DETAILS
Memory structures are used in the description of the memory available from CPUs and platforms.
 
config Platform.BOARD  // module-wide
index URL
XDCscript usage meta-domain
const Platform.BOARD = IPlatform.Board {
    id: "0",
    boardName: "evmTI816X",
    boardFamily: "evmTI816X",
    boardRevision: null
};
 
 
config Platform.DSS  // module-wide
index URL
XDCscript usage meta-domain
const Platform.DSS = IExeContext.Cpu {
    id: "1",
    clockRate: 250.0,
    catalogName: "ti.catalog.arm.cortexm3",
    deviceName: "TMS320TI816X",
    revision: "1.0"
};
 
 
config Platform.GEM  // module-wide
index URL
XDCscript usage meta-domain
const Platform.GEM = IExeContext.Cpu {
    id: "0",
    clockRate: 800.0,
    catalogName: "ti.catalog.c6000",
    deviceName: "TMS320TI816X",
    revision: ""
};
 
 
config Platform.GPP  // module-wide
index URL
XDCscript usage meta-domain
const Platform.GPP = IExeContext.Cpu {
    id: "2",
    clockRate: 1000.0,
    catalogName: "ti.catalog.arm.cortexa8",
    deviceName: "TMS320TI816X",
    revision: "1.0"
};
 
Instance Config Parameters
index URL

XDCscript usage meta-domain
var params = new Platform.Params;
// Instance config-params object
    params.codeMemory = String undefined;
    // The default segment for code sections
    params.customMemoryMap = IPlatform.Memory[string] undefined;
    // A custom mapping of memory names to memory objects
    params.dataMemory = String undefined;
    // The default segment for data sections
    params.externalMemoryMap = IPlatform.Memory[string] [
    // A mapping of memory names to memory objects for external memory
        [
            "DDR3_HOST",
            {
                comment: "DDR3 Memory reserved for use by the A8",
                name: "DDR3_HOST",
                base: 0x80000000,
                len: 0x0B000000
            }
        ],
        [
            "DDR3_DSP",
            {
                comment: "DDR3 Memory reserved for use by the C674",
                name: "DDR3_DSP",
                base: 0x8B000000,
                len: 0x02000000
            }
        ],
        [
            "DDR3_SR1",
            {
                comment: "DDR3 Memory reserved for use by SharedRegion 1",
                name: "DDR3_SR1",
                base: 0x8D000000,
                len: 0x00C00000
            }
        ],
        [
            "DDR3_HDVPSS",
            {
                comment: "DDR3 Memory reserved for use by HDVPSS",
                name: "DDR3_HDVPSS",
                base: 0x8DC00000,
                len: 0x00200000
            }
        ],
        [
            "DDR3_V4L2",
            {
                comment: "DDR3 Memory reserved for use by V4L2",
                name: "DDR3_V4L2",
                base: 0x8DE00000,
                len: 0x00200000
            }
        ],
        [
            "DDR3_SR0",
            {
                comment: "DDR3 Memory reserved for use by SharedRegion 0",
                name: "DDR3_SR0",
                base: 0x8E000000,
                len: 0x01000000
            }
        ],
        [
            "DDR3_M3",
            {
                comment: "DDR3 Memory reserved for use by the M3 core",
                name: "DDR3_M3",
                base: 0x8F000000,
                len: 0x01000000
            }
        ]
    ];
    params.l1DMode = String "32k";
    // 
    params.l1PMode = String "32k";
    // 
    params.l2Mode = String "0k";
    // 
    params.renameMap = String[string] undefined;
    // A map for renaming memory objects
    params.sectMap = String[string] undefined;
    // A mapping of linker output section names to memory segments
    params.stackMemory = String undefined;
    // The default segment for stack
 
config Platform.codeMemory  // instance
index URL

The default segment for code sections

XDCscript usage meta-domain
var params = new Platform.Params;
  ...
params.codeMemory = String undefined;
 
DETAILS
Each target has a section map with keys equal to the names of all sections that compiler and assembler for that target generate. The value for each key is either "code" or "data" or "stack". A linker template reads that map and puts all "code" sections in the segment defined by this configuration parameter.
SEE
dataMemory, stackMemory
 
config Platform.customMemoryMap  // instance
index URL

A custom mapping of memory names to memory objects

XDCscript usage meta-domain
var params = new Platform.Params;
  ...
params.customMemoryMap = IPlatform.Memory[string] undefined;
 
DETAILS
This parameter allows platform instances to completely overwrite a default memory map based on the internal memory map coming from CPU's memory map and externalMemoryMap.
Custom memory map must fit within the default memory map, unless the verification of the fit is disabled (see xdc.platform).
 
config Platform.dataMemory  // instance
index URL

The default segment for data sections

XDCscript usage meta-domain
var params = new Platform.Params;
  ...
params.dataMemory = String undefined;
 
DETAILS
Each target has a section map with keys equal to the names of all sections that compiler and assembler for that target generate. The value for each key is either "code" or "data" or "stack". A linker template reads that map and puts all "data" sections in the segment defined by this configuration parameter.
SEE
codeMemory, stackMemory
 
config Platform.externalMemoryMap  // instance
index URL

A mapping of memory names to memory objects for external memory

XDCscript usage meta-domain
var params = new Platform.Params;
  ...
const params.externalMemoryMap = IPlatform.Memory[string] [
    [
        "DDR3_HOST",
        {
            comment: "DDR3 Memory reserved for use by the A8",
            name: "DDR3_HOST",
            base: 0x80000000,
            len: 0x0B000000
        }
    ],
    [
        "DDR3_DSP",
        {
            comment: "DDR3 Memory reserved for use by the C674",
            name: "DDR3_DSP",
            base: 0x8B000000,
            len: 0x02000000
        }
    ],
    [
        "DDR3_SR1",
        {
            comment: "DDR3 Memory reserved for use by SharedRegion 1",
            name: "DDR3_SR1",
            base: 0x8D000000,
            len: 0x00C00000
        }
    ],
    [
        "DDR3_HDVPSS",
        {
            comment: "DDR3 Memory reserved for use by HDVPSS",
            name: "DDR3_HDVPSS",
            base: 0x8DC00000,
            len: 0x00200000
        }
    ],
    [
        "DDR3_V4L2",
        {
            comment: "DDR3 Memory reserved for use by V4L2",
            name: "DDR3_V4L2",
            base: 0x8DE00000,
            len: 0x00200000
        }
    ],
    [
        "DDR3_SR0",
        {
            comment: "DDR3 Memory reserved for use by SharedRegion 0",
            name: "DDR3_SR0",
            base: 0x8E000000,
            len: 0x01000000
        }
    ],
    [
        "DDR3_M3",
        {
            comment: "DDR3 Memory reserved for use by the M3 core",
            name: "DDR3_M3",
            base: 0x8F000000,
            len: 0x01000000
        }
    ]
];
 
DETAILS
This parameter defines the external portion of the platform's memory map.
 
config Platform.l1DMode  // instance
index URL
XDCscript usage meta-domain
var params = new Platform.Params;
  ...
params.l1DMode = String "32k";
 
 
config Platform.l1PMode  // instance
index URL
XDCscript usage meta-domain
var params = new Platform.Params;
  ...
params.l1PMode = String "32k";
 
 
config Platform.l2Mode  // instance
index URL
XDCscript usage meta-domain
var params = new Platform.Params;
  ...
params.l2Mode = String "0k";
 
 
config Platform.renameMap  // instance
index URL

A map for renaming memory objects

XDCscript usage meta-domain
var params = new Platform.Params;
  ...
params.renameMap = String[string] undefined;
 
DETAILS
This map renames memory objects. If you do not want to change addresses in the default memory map, but you only want to rename the existing memory objects, you should use this parameter.
This map and customMemoryMap should not be used together because this map renames the default memory, but then customMemoryMap replaces the default memory objects. The parameters codeMemory, dataMemory and stackMemory are not automatically reassigned to new names. It is the user's responsibility to set those parameters accordingly to renameMap.
 
config Platform.sectMap  // instance
index URL

A mapping of linker output section names to memory segments

XDCscript usage meta-domain
var params = new Platform.Params;
  ...
params.sectMap = String[string] undefined;
 
DETAILS
During the generation of linker command files, the templates used to create these files examine several sources of information to determine the placement of named output sections into memory segments defined by the platform. The default placement, described below, uses information from the target and this platform's codeMemory, dataMemory, and stackMemory configuration parameters.
sectMap is used to override this default placement of output sections (".text", ".cinit", etc.) to a memory segment defined by the platform's memory map. For example, even if a platform's codeMemory parameter is defined to be "SRAM" and ".cinit" output sections are "code" sections, if the platform also defines the following sectMap, the section ".cinit" will be placed into a memory segment named "DDR2".
      sectMap[] = [
          [".cinit", "DDR2"],
      ];
NOTE
If an output section has an entry in Program.sectMap, that entry overrides the placement specified by this sectMap. A program's sectMap configuration always overrides the platform's sectMap settings.
DEFAULT MAPPING
The default placement of a target's output sections into memory segments defined by the platform is determined by the following configuration parameters:
  • ITarget.sectMap used to map a named output section to either "code", "data", or "stack"
  • codeMemory names a memory segment that will contain all "code" output sections
  • dataMemory names a memory segment that will contain all "data" output sections
  • stackMemory names a memory segment that will contain all "stack" output sections
SEE
xdc.cfg.Program.sectMap, xdc.bld.ITarget.sectMap
 
config Platform.stackMemory  // instance
index URL

The default segment for stack

XDCscript usage meta-domain
var params = new Platform.Params;
  ...
params.stackMemory = String undefined;
 
DETAILS
Each target has a section map with keys equal to the names of all sections that compiler and assembler for that target generate. The value for each key is either "code" or "data" or "stack". A linker template reads that map and puts all "stack" sections in the segment defined by this configuration parameter.
SEE
dataMemory, codeMemory
Instance Creation
index URL

XDCscript usage meta-domain
var params = new Platform.Params;
// Allocate instance config-params
params.config =   ...
// Assign individual configs
 
var inst = Platform.create(String name, Any args, params);
// Create an instance-object
ARGUMENTS
name — the name of the platform instance being created
This name is the suffix of the platform specification supplied in the build script after the platform name (and optional ':') prefix has been removed. So the platform instance name "joes.platform.foo:bar" results in the name "bar" and the name "joes.platform.foo" result in the name "".
args — deprecated parameter that should not be used in a platform instance implementation
 
Platform.getExeContext()  // instance
index URL

Get execution context object corresponding to the specified program

XDCscript usage meta-domain
inst.getExeContext(Any prog) returns Any
 
ARGUMENTS
prog — the xdc.cfg.Program object representing the program being configured.
This object contains the following properties that allows the platform to determine the appropriate Cpu object to return (if there is more than one): prog.build.cpuId, prog.build.cpuArgs, prog.build.target,
DETAILS
This is called before the program's configuration script runs to get the Cpu object that is assigned to the program's cpu field.
Note: that the build script for the program is responsible for specifying the CPU; this is done by either implicitly naming the platform or explicitly naming a particular CPU on the platform (see xdc.bld.Executable.Attrs.cpuId).
This function executes in the Configuration object model.
RETURNS
Returns an xdc.platform.IExeContext instance object that corresponds to the CPU that will run the specified program.
THROWS
Error exceptions are thrown for fatal errors.
 
Platform.getExecCmd()  // instance
index URL

Get the exec command used to run the program on this platform

XDCscript usage meta-domain
inst.getExecCmd(Any prog, Any platPath) returns Any
 
ARGUMENTS
prog — the xdc.cfg.Program object representing the program being configured.
This object contains the following properties that allows the platform to determine the appropriate Cpu object to return (if there is more than one): prog.build.cpuId, prog.build.cpuArgs, prog.build.target
platPath — full path to the platform package for the program
DETAILS
This function is called after the program's configuration script runs and returns commands that are used to load and run the specified program. These commands are placed in a makefile that is included by the client package's generated makefile. Thus, the commands may refer to macros defined in this environment; e.g., $(SHELL) and $(XDCROOT), etc.
The special macro $(1) expands to test-specific arguments (xdc.bld.Test.attrs.execArgs) that are passed from the test to the platform's exec command. Thus, all platforms that support arguments to their exec command, should embed "$(1)" within the command string at the appropriate place to have these arguments interpreted by the exec command.
For example, a platform that uses a shell script to run executables and allows options to be passed to the shell script might return the following string:
	    "$(SHELL) <exec_path> $(1) <exe_name>"
where, <exec_path> is the absolute path to the platform's exec shell script, and <prog_name> is the name of the executable relative to the package's base directory (i.e., xdc.cfg.Program.name).
This function executes in the Configuration object model.
RETURNS
Returns a string of commands used to execute this program in the context of the XDC generated makefiles.
THROWS
Error exceptions are thrown for fatal errors.
 
Platform.getLinkTemplate()  // instance
index URL

Get Linker Command file template used to link an executable

XDCscript usage meta-domain
inst.getLinkTemplate(Any prog) returns Any
 
ARGUMENTS
prog — the xdc.cfg.Program object representing the program being configured.
This object contains the following properties that allows the platform to determine the appropriate link template to return:
  • prog.build.cpuId,
  • prog.build.cpuArgs,
  • prog.build.target
DETAILS
In the event that no template is provided by the program configuration script (see xdc.cfg.Program.linkTemplate), the template file identified by this method is used to generate the linker command file used to create the executable.
This function executes in the Configuration object model and is called after the program configuration script runs. The template is expanded in the context of the Configuration Object Model.
RETURNS
Returns a path string to a template file or null. If null, no linker command file is generated; otherwise this path is relative to the package path.
THROWS
Error exceptions are thrown for fatal errors.
generated on Thu, 27 Sep 2012 23:25:14 GMT