1    /* 
     2     * Copyright (c) 2012, Texas Instruments Incorporated
     3     * All rights reserved.
     4     *
     5     * Redistribution and use in source and binary forms, with or without
     6     * modification, are permitted provided that the following conditions
     7     * are met:
     8     *
     9     * *  Redistributions of source code must retain the above copyright
    10     *    notice, this list of conditions and the following disclaimer.
    11     *
    12     * *  Redistributions in binary form must reproduce the above copyright
    13     *    notice, this list of conditions and the following disclaimer in the
    14     *    documentation and/or other materials provided with the distribution.
    15     *
    16     * *  Neither the name of Texas Instruments Incorporated nor the names of
    17     *    its contributors may be used to endorse or promote products derived
    18     *    from this software without specific prior written permission.
    19     *
    20     * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
    21     * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
    22     * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
    23     * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
    24     * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
    25     * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
    26     * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
    27     * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
    28     * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
    29     * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
    30     * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
    31     * */
    32    /*
    33     *  ======== TimestampProvider.xdc ========
    34     *
    35     */
    36    
    37    package ti.sysbios.family.arm.ducati;
    38    
    39    import xdc.rov.ViewInfo;
    40    
    41    /*!
    42     *  ======== TimestampProvider ========
    43     *  Ducati Cortex M3 TimestampProvider delegate for use 
    44     *  with {@link xdc.runtime.Timestamp}
    45     *
    46     *  The timestamp counters used in Ducati are CTM counters 2,3,4,5.
    47     *  Each core uses two counters in chained mode to achieve 64 bits.
    48     *  Core 0 uses counters 2,3.
    49     *  Core 1 uses counters 4,5.
    50     *  Which ever core is started first will start both sets of counters 
    51     *  synchronously so that both cores effectively share a common timestamp.
    52     *  By default, the CTM counters are clocked at 2 times the CPU clock.
    53     *
    54     *
    55     *  @p(html)
    56     *  <h3> Calling Context </h3>
    57     *  <table border="1" cellpadding="3">
    58     *    <colgroup span="1"></colgroup> <colgroup span="5" align="center"></colgroup>
    59     *
    60     *    <tr><th> Function                 </th><th>  Hwi   </th><th>  Swi   </th><th>  Task  </th><th>  Main**  </th><th>  Startup***  </th></tr>
    61     *    <!--                                                                                                                 -->
    62     *    <tr><td> {@link #get32}           </td><td>   Y    </td><td>   Y    </td><td>   Y    </td><td>   Y    </td><td>   N    </td></tr>
    63     *    <tr><td> {@link #get64}           </td><td>   Y    </td><td>   Y    </td><td>   Y    </td><td>   Y    </td><td>   N    </td></tr>
    64     *    <tr><td> {@link #getFreq}         </td><td>   Y    </td><td>   Y    </td><td>   Y    </td><td>   Y    </td><td>   N    </td></tr>
    65     *
    66     *  </table>
    67     *  @p
    68     */
    69    
    70    @ModuleStartup          /* To get Clock Timer Handle */
    71    
    72    module TimestampProvider inherits ti.sysbios.interfaces.ITimestamp
    73    {
    74    
    75        /*! @_nodoc */
    76        metaonly struct ModuleView {
    77            String      timestamp;
    78        }
    79    
    80        @Facet
    81        metaonly config ViewInfo.Instance rovViewInfo = 
    82            ViewInfo.create({
    83                viewMap: [
    84                [
    85                    'Module',
    86                    {
    87                        type: ViewInfo.MODULE,
    88                        viewInitFxn: 'viewInitModule',
    89                        structName: 'ModuleView'
    90                    }
    91                ],
    92                ]
    93            });
    94    
    95        /*! 
    96         * Counter Input Select. The default value of 0 selects the 
    97         * 2x CPU clock as the clock source for the timestamp counters.
    98         *
    99         * See Table 28-22 of the OMAP4430 TRM for details of the
   100         * various events that can be counted.
   101         */
   102        config UInt8 inpsel = 0;
   103    }
   104    /*
   105     *  @(#) ti.sysbios.family.arm.ducati; 2, 0, 0, 0,292; 2-24-2012 11:39:27; /db/vtree/library/trees/avala/avala-q28x/src/ xlibrary
   106    
   107     */
   108