1    /*
     2     *  Copyright (c) 2013 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 M3 or M4.  M3 or M4 is selected
    65         *  in Platform.xs based on target.isa.
    66         */
    67        config xdc.platform.IExeContext.Cpu M3 = {
    68            id:             "0",
    69            clockRate:      1.0,
    70            catalogName:    "ti.catalog.arm.cortexm3",
    71            deviceName:     "Stellaris",
    72            revision:       "",
    73        };
    74    
    75        config xdc.platform.IExeContext.Cpu M4 = {
    76            id:             "0",
    77            clockRate:      1.0,
    78            catalogName:    "ti.catalog.arm.cortexm4",
    79            deviceName:     "Stellaris",
    80            revision:       "",
    81        };
    82    
    83        /*!
    84         *  ======== deviceName ========
    85         *  The name of an `ICpuDataSheet` module for the device
    86         *
    87         *  This parameter is required, but it does not have to be set explicitly;
    88         *  it can be encoded in the instance's name.
    89         */
    90        config string deviceName;
    91    
    92        /*!
    93         *  ======== clockRate ========
    94         *  The clock rate for this device.
    95         */
    96        config Double clockRate = 20;
    97    
    98        override config string codeMemory = null;
    99    
   100        override config string dataMemory = null;
   101    
   102        override config string stackMemory = null;
   103    
   104        /*!
   105         *  ======== includeLinkCmdFile ========
   106         *  The flag that specifies if the platform should include a linker command
   107         *  file.
   108         *
   109         *  By default, a user is responsible for adding a linker command file to
   110         *  the project, or to the linker command line. However, if this flag is
   111         *  set, this platform will include a default linker command file for the
   112         *  selected device.
   113         */
   114        config Bool includeLinkCmdFile = false;
   115    };
   116    /*
   117     *  @(#) ti.platforms.stellaris; 1, 0, 0,75; 3-12-2013 12:52:55; /db/ztree/library/trees/platform/platform-o14x/src/
   118     */
   119