1    /*
     2     *  Copyright (c) 2014 by Texas Instruments and others.
     3     *  All rights reserved. This program and the accompanying materials
     4     *  are made available under the terms of the Eclipse Public License v1.0
     5     *  which accompanies this distribution, and is available at
     6     *  http://www.eclipse.org/legal/epl-v10.html
     7     *
     8     *  Contributors:
     9     *      Texas Instruments - initial implementation
    10     *
    11     * */
    12    
    13    /*
    14     *  ======== Platform.xdc ========
    15     */
    16    package ti.platforms.stellaris;
    17    
    18    /*!
    19     *  ======== Platform ========
    20     *  A generic platform that supports any Stellaris device
    21     *
    22     *  The device to be used by this platform is passed as the platform instance
    23     *  name. On the `xdc.tools.configuro` command line, it is done in the
    24     *  following way:
    25     *  @p(code)
    26     *  xs xdc.tools.configuro ... -p "ti.platforms.stellaris:LM3S8971"
    27     *  @p
    28     *
    29     *  In package.bld, the platform instance is selected as in:
    30     *  @p(code)
    31     *  Pkg.addExecutable("test", target, "ti.platforms.stellaris:LM3S8971");
    32     *  @p
    33     */
    34    metaonly module Platform inherits xdc.platform.IPlatform
    35    {
    36        config xdc.platform.IPlatform.Board BOARD = {
    37            id:             "0",
    38            boardName:      "stellaris",
    39            boardFamily:    null,
    40            boardRevision:  null
    41        };
    42    
    43        /*!
    44         *  ======== nameFormat ========
    45         *  Encoding of instance creation parameters in the instance's name
    46         *
    47         *  For this platform, the parameters `deviceName`, `includeLinkCmdFile`
    48         *  and `clockRate` can be encoded in the instance name supplied on
    49         *  `xdc.tools.configuro` command line, for example:
    50         *  @p(code)
    51         *      xs xdc.tools.configuro ... -p ti.platforms.stellaris:LM3S8971:1:20
    52         *  @p
    53         *  Optional parameters can be omitted:
    54         *  @p(code)
    55         *      xs xdc.tools.configuro ... -p ti.platforms.stellaris:LM3S8971
    56         *  @p
    57         */
    58         readonly config string nameFormat
    59             = "$(deviceName):$(includeLinkCmdFile):$(clockRate)";
    60    
    61    instance:
    62    
    63        /*
    64         *  This platform supports either Cortex M3 or M4 cores.
    65         *  The corresponding "actual" catalogName is overwritten
    66         *  in Platform.instance$meta$init() based on the device name
    67         */
    68        config xdc.platform.IExeContext.Cpu CPU = {
    69            id:             "0",
    70            clockRate:      1.0,
    71            catalogName:    "ti.catalog.arm.cortexm3",
    72            deviceName:     "Stellaris",
    73            revision:       "",
    74        };
    75    
    76        /*!
    77         *  ======== deviceName ========
    78         *  The name of an `ICpuDataSheet` module for the device
    79         *
    80         *  This parameter is required, but it does not have to be set explicitly;
    81         *  it can be encoded in the instance's name.
    82         */
    83        config string deviceName;
    84    
    85        /*!
    86         *  ======== clockRate ========
    87         *  The clock rate for this device.
    88         */
    89        config Double clockRate;
    90    
    91        override config string codeMemory = null;
    92    
    93        override config string dataMemory = null;
    94    
    95        override config string stackMemory = null;
    96    
    97        /*!
    98         *  ======== includeLinkCmdFile ========
    99         *  The flag that specifies if the platform should include a linker command
   100         *  file.
   101         *
   102         *  By default, a user is responsible for adding a linker command file to
   103         *  the project, or to the linker command line. However, if this flag is
   104         *  set, this platform will include a default linker command file for the
   105         *  selected device.
   106         */
   107        config Bool includeLinkCmdFile = false;
   108    };
   109    /*
   110     *  @(#) ti.platforms.stellaris; 1, 0, 0,113; 3-22-2014 18:58:48; /db/ztree/library/trees/platform/platform-o48x/src/
   111     */
   112