1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31
32 33 34 35 36
37
38 package ti.sysbios.family.arm.f28m35x;
39
40 import xdc.runtime.Types;
41
42 /*!
43 * ======== TimestampProvider ========
44 *
45 * @p(html)
46 * <h3> Calling Context </h3>
47 * <table border="1" cellpadding="3">
48 * <colgroup span="1"></colgroup> <colgroup span="5" align="center"></colgroup>
49 *
50 * <tr><th> Function </th><th> Hwi </th><th> Swi </th><th> Task </th><th> Main </th><th> Startup </th></tr>
51 * <!-- -->
52 * <tr><td> {@link #get32} </td><td> Y </td><td> Y </td><td> Y </td><td> Y </td><td> N </td></tr>
53 * <tr><td> {@link #get64} </td><td> Y </td><td> Y </td><td> Y </td><td> Y </td><td> N </td></tr>
54 * <tr><td> {@link #getFreq} </td><td> Y </td><td> Y </td><td> Y </td><td> Y </td><td> N </td></tr>
55 * <tr><td> {@link #setFreq} </td><td> Y </td><td> Y </td><td> Y </td><td> Y </td><td> N </td></tr>
56 * <tr><td colspan="6"> Definitions: <br />
57 * <ul>
58 * <li> <b>Hwi</b>: API is callable from a Hwi thread. </li>
59 * <li> <b>Swi</b>: API is callable from a Swi thread. </li>
60 * <li> <b>Task</b>: API is callable from a Task thread. </li>
61 * <li> <b>Main</b>: API is callable during any of these phases: </li>
62 * <ul>
63 * <li> In your module startup after this module is started (e.g. TimestampProvider_Module_startupDone() returns TRUE). </li>
64 * <li> During xdc.runtime.Startup.lastFxns. </li>
65 * <li> During main().</li>
66 * <li> During BIOS.startupFxns.</li>
67 * </ul>
68 * <li> <b>Startup</b>: API is callable during any of these phases:</li>
69 * <ul>
70 * <li> During xdc.runtime.Startup.firstFxns.</li>
71 * <li> In your module startup before this module is started (e.g. TimestampProvider_Module_startupDone() returns FALSE).</li>
72 * </ul>
73 * </ul>
74 * </td></tr>
75 *
76 * </table>
77 * @p
78 *
79 */
80
81
82 module TimestampProvider inherits ti.sysbios.interfaces.ITimestamp
83 {
84
85 86 87
88 metaonly config Types.FreqHz freq;
89
90 /*!
91 * ======== setFreq ========
92 * Set the timestamp frequency (in Hz)
93 *
94 * @param(freq) pointer to a 64-bit structure
95 *
96 * This parameter is a pointer to a structure representing a 64-bit
97 * wide frequency value (in Hz); see `{@link xdc.runtime.Types#FreqHz}`
98 * This function provides a way of converting timestamp
99 * values into units of real time.
100 *
101 */
102 Void setFreq(xdc.runtime.Types.FreqHz *freq);
103
104 internal:
105
106 const UInt32 MIPCCOUNTERL = 0x400FB718;
107 const UInt32 MIPCCOUNTERH = 0x400FB71C;
108
109 110 111
112 struct Module_State {
113 Types.FreqHz freq;
114 };
115
116 }
117