begriffs open source - cmsis/blob - main/RTOS2/html/group__CMSIS__RTOS__TickAPI.html

   1 <!-- HTML header for doxygen 1.9.6-->
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml" lang="en-US">
   4 <head>
   5 <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
   6 <meta http-equiv="X-UA-Compatible" content="IE=11"/>
   7 <meta name="viewport" content="width=device-width, initial-scale=1"/>
   8 <title>CMSIS-RTOS2: OS Tick API</title>
   9 <link href="doxygen.css" rel="stylesheet" type="text/css"/>
  10 <link href="tabs.css" rel="stylesheet" type="text/css"/>
  11 <link href="extra_navtree.css" rel="stylesheet" type="text/css"/>
  12 <link href="extra_stylesheet.css" rel="stylesheet" type="text/css"/>
  13 <link href="extra_search.css" rel="stylesheet" type="text/css"/>
  14 <script type="text/javascript" src="jquery.js"></script>
  15 <script type="text/javascript" src="dynsections.js"></script>
  16 <script type="text/javascript" src="printComponentTabs.js"></script>
  17 <script type="text/javascript" src="footer.js"></script>
  18 <script type="text/javascript" src="navtree.js"></script>
  19 <link href="navtree.css" rel="stylesheet" type="text/css"/>
  20 <script type="text/javascript" src="resize.js"></script>
  21 <script type="text/javascript" src="navtreedata.js"></script>
  22 <script type="text/javascript" src="navtree.js"></script>
  23 <link href="search/search.css" rel="stylesheet" type="text/css"/>
  24 <script type="text/javascript" src="search/searchdata.js"></script>
  25 <script type="text/javascript" src="search/search.js"></script>
  26 <script type="text/javascript">
  27 /* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
  28   $(document).ready(function() { init_search(); });
  29 /* @license-end */
  30 </script>
  31 <script type="text/javascript" src="darkmode_toggle.js"></script>
  32 <link href="extra_stylesheet.css" rel="stylesheet" type="text/css"/>
  33 <link href="extra_navtree.css" rel="stylesheet" type="text/css"/>
  34 <link href="extra_search.css" rel="stylesheet" type="text/css"/>
  35 <link href="version.css" rel="stylesheet" type="text/css" />
  36 <script type="text/javascript" src="../../../version.js"></script>
  37 </head>
  38 <body>
  39 <div id="top"><!-- do not remove this div, it is closed by doxygen! -->
  40 <div id="titlearea">
  41 <table cellspacing="0" cellpadding="0">
  42  <tbody>
  43  <tr style="height: 55px;">
  44   <td id="projectlogo" style="padding: 1.5em;"><img alt="Logo" src="cmsis_logo_white_small.png"/></td>
  45   <td style="padding-left: 1em; padding-bottom: 1em;padding-top: 1em;">
  46    <div id="projectname">CMSIS-RTOS2
  47    &#160;<span id="projectnumber"><script type="text/javascript">
  48      <!--
  49      writeHeader.call(this);
  50      writeVersionDropdown.call(this);
  51      //-->
  52     </script>
  53    </span>
  54    </div>
  55    <div id="projectbrief">Real-Time Operating System API</div>
  56   </td>
  57    <td>        <div id="MSearchBox" class="MSearchBoxInactive">
  58         <span class="left">
  59           <span id="MSearchSelect"                onmouseover="return searchBox.OnSearchSelectShow()"                onmouseout="return searchBox.OnSearchSelectHide()">&#160;</span>
  60           <input type="text" id="MSearchField" value="" placeholder="Search" accesskey="S"
  61                onfocus="searchBox.OnSearchFieldFocus(true)"
  62                onblur="searchBox.OnSearchFieldFocus(false)"
  63                onkeyup="searchBox.OnSearchFieldChange(event)"/>
  64           </span><span class="right">
  65             <a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.svg" alt=""/></a>
  66           </span>
  67         </div>
  68 </td>
  69   <!--END !PROJECT_NAME-->
  70  </tr>
  71  </tbody>
  72 </table>
  73 </div>
  74 <!-- end header part -->
  75 <div id="CMSISnav" class="tabs1">
  76   <ul class="tablist">
  77     <script type="text/javascript">
  78       writeComponentTabs.call(this);
  79     </script>
  80   </ul>
  81 </div>
  82 <script type="text/javascript">
  83   writeSubComponentTabs.call(this);
  84 </script>
  85 <!-- Generated by Doxygen 1.9.6 -->
  86 <script type="text/javascript">
  87 /* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
  88 var searchBox = new SearchBox("searchBox", "search/",'.html');
  89 /* @license-end */
  90 </script>
  91 </div><!-- top -->
  92 <div id="side-nav" class="ui-resizable side-nav-resizable">
  93   <div id="nav-tree">
  94     <div id="nav-tree-contents">
  95       <div id="nav-sync" class="sync"></div>
  96     </div>
  97   </div>
  98   <div id="splitbar" style="-moz-user-select:none;"
  99        class="ui-resizable-handle">
 100   </div>
 101 </div>
 102 <script type="text/javascript">
 103 /* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
 104 $(document).ready(function(){initNavTree('group__CMSIS__RTOS__TickAPI.html',''); initResizable(); });
 105 /* @license-end */
 106 </script>
 107 <div id="doc-content">
 108 <!-- window showing the filter options -->
 109 <div id="MSearchSelectWindow"
 110      onmouseover="return searchBox.OnSearchSelectShow()"
 111      onmouseout="return searchBox.OnSearchSelectHide()"
 112      onkeydown="return searchBox.OnSearchSelectKey(event)">
 113 </div>
 114
 115 <!-- iframe showing the search results (closed by default) -->
 116 <div id="MSearchResultsWindow">
 117 <div id="MSearchResults">
 118 <div class="SRPage">
 119 <div id="SRIndex">
 120 <div id="SRResults"></div>
 121 <div class="SRStatus" id="Loading">Loading...</div>
 122 <div class="SRStatus" id="Searching">Searching...</div>
 123 <div class="SRStatus" id="NoMatches">No Matches</div>
 124 </div>
 125 </div>
 126 </div>
 127 </div>
 128
 129 <div class="header">
 130   <div class="summary">
 131 <a href="#func-members">Functions</a>  </div>
 132   <div class="headertitle"><div class="title">OS Tick API</div></div>
 133 </div><!--header-->
 134 <div class="contents">
 135
 136 <p>System tick timer interface for periodic RTOS Kernel Ticks defined in <b>os_tick.h</b>
 137 <a href="#details">More...</a></p>
 138 <table class="memberdecls">
 139 <tr class="heading"><td colspan="2"><h2 class="groupheader"><a id="func-members" name="func-members"></a>
 140 Functions</h2></td></tr>
 141 <tr class="memitem:ga5eeffb4d9dc6c6802fee8898096d9a59"><td class="memItemLeft" align="right" valign="top">int32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__CMSIS__RTOS__TickAPI.html#ga5eeffb4d9dc6c6802fee8898096d9a59">OS_Tick_Setup</a> (uint32_t freq, <a class="el" href="os__tick_8h.html#a27589275c894aa295615df4764404b98">IRQHandler_t</a> handler)</td></tr>
 142 <tr class="memdesc:ga5eeffb4d9dc6c6802fee8898096d9a59"><td class="mdescLeft">&#160;</td><td class="mdescRight">Setup OS Tick timer to generate periodic RTOS Kernel Ticks.  <br /></td></tr>
 143 <tr class="separator:ga5eeffb4d9dc6c6802fee8898096d9a59"><td class="memSeparator" colspan="2">&#160;</td></tr>
 144 <tr class="memitem:gaaa0d6ddef6816e8e5650fde3daf191e7"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__CMSIS__RTOS__TickAPI.html#gaaa0d6ddef6816e8e5650fde3daf191e7">OS_Tick_Enable</a> (void)</td></tr>
 145 <tr class="memdesc:gaaa0d6ddef6816e8e5650fde3daf191e7"><td class="mdescLeft">&#160;</td><td class="mdescRight">Enable OS Tick timer interrupt.  <br /></td></tr>
 146 <tr class="separator:gaaa0d6ddef6816e8e5650fde3daf191e7"><td class="memSeparator" colspan="2">&#160;</td></tr>
 147 <tr class="memitem:ga50fc040b66fabd1945d2bd1d0d05661d"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__CMSIS__RTOS__TickAPI.html#ga50fc040b66fabd1945d2bd1d0d05661d">OS_Tick_Disable</a> (void)</td></tr>
 148 <tr class="memdesc:ga50fc040b66fabd1945d2bd1d0d05661d"><td class="mdescLeft">&#160;</td><td class="mdescRight">Disable OS Tick timer interrupt.  <br /></td></tr>
 149 <tr class="separator:ga50fc040b66fabd1945d2bd1d0d05661d"><td class="memSeparator" colspan="2">&#160;</td></tr>
 150 <tr class="memitem:ga14c430d2b363ebd9f904b0822a9314e7"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__CMSIS__RTOS__TickAPI.html#ga14c430d2b363ebd9f904b0822a9314e7">OS_Tick_AcknowledgeIRQ</a> (void)</td></tr>
 151 <tr class="memdesc:ga14c430d2b363ebd9f904b0822a9314e7"><td class="mdescLeft">&#160;</td><td class="mdescRight">Acknowledge execution of OS Tick timer interrupt.  <br /></td></tr>
 152 <tr class="separator:ga14c430d2b363ebd9f904b0822a9314e7"><td class="memSeparator" colspan="2">&#160;</td></tr>
 153 <tr class="memitem:gaa8b4eca23e3ffe2df403291958cdc905"><td class="memItemLeft" align="right" valign="top">int32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__CMSIS__RTOS__TickAPI.html#gaa8b4eca23e3ffe2df403291958cdc905">OS_Tick_GetIRQn</a> (void)</td></tr>
 154 <tr class="memdesc:gaa8b4eca23e3ffe2df403291958cdc905"><td class="mdescLeft">&#160;</td><td class="mdescRight">Get OS Tick timer IRQ number.  <br /></td></tr>
 155 <tr class="separator:gaa8b4eca23e3ffe2df403291958cdc905"><td class="memSeparator" colspan="2">&#160;</td></tr>
 156 <tr class="memitem:ga936217ea28236fb57648973e0d8f627a"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__CMSIS__RTOS__TickAPI.html#ga936217ea28236fb57648973e0d8f627a">OS_Tick_GetClock</a> (void)</td></tr>
 157 <tr class="memdesc:ga936217ea28236fb57648973e0d8f627a"><td class="mdescLeft">&#160;</td><td class="mdescRight">Get OS Tick timer clock frequency.  <br /></td></tr>
 158 <tr class="separator:ga936217ea28236fb57648973e0d8f627a"><td class="memSeparator" colspan="2">&#160;</td></tr>
 159 <tr class="memitem:ga123151dc19d5a94a68f12cdbf61a9bb5"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__CMSIS__RTOS__TickAPI.html#ga123151dc19d5a94a68f12cdbf61a9bb5">OS_Tick_GetInterval</a> (void)</td></tr>
 160 <tr class="memdesc:ga123151dc19d5a94a68f12cdbf61a9bb5"><td class="mdescLeft">&#160;</td><td class="mdescRight">Get OS Tick timer interval reload value.  <br /></td></tr>
 161 <tr class="separator:ga123151dc19d5a94a68f12cdbf61a9bb5"><td class="memSeparator" colspan="2">&#160;</td></tr>
 162 <tr class="memitem:gaa64a145a554f1e5077848938d7f39c92"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__CMSIS__RTOS__TickAPI.html#gaa64a145a554f1e5077848938d7f39c92">OS_Tick_GetCount</a> (void)</td></tr>
 163 <tr class="memdesc:gaa64a145a554f1e5077848938d7f39c92"><td class="mdescLeft">&#160;</td><td class="mdescRight">Get OS Tick timer counter value.  <br /></td></tr>
 164 <tr class="separator:gaa64a145a554f1e5077848938d7f39c92"><td class="memSeparator" colspan="2">&#160;</td></tr>
 165 <tr class="memitem:ga1f9a593126b7f0b66fc526c2cebd6192"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__CMSIS__RTOS__TickAPI.html#ga1f9a593126b7f0b66fc526c2cebd6192">OS_Tick_GetOverflow</a> (void)</td></tr>
 166 <tr class="memdesc:ga1f9a593126b7f0b66fc526c2cebd6192"><td class="mdescLeft">&#160;</td><td class="mdescRight">Get OS Tick timer overflow status.  <br /></td></tr>
 167 <tr class="separator:ga1f9a593126b7f0b66fc526c2cebd6192"><td class="memSeparator" colspan="2">&#160;</td></tr>
 168 </table>
 169 <a name="details" id="details"></a><h2 class="groupheader">Description</h2>
 170 <p>The <b>OS Tick API</b> is an interface to a system timer that generates the Kernel Ticks.</p>
 171 <p>All Cortex-M processors provide an unified System Tick Timer that is typically used to generate the RTOS Kernel Tick.</p>
 172 <p>The Cortex-A processors do not implement an unified system timer and required a device specific implementation. </p>
 173 <p>CMSIS-RTOS2 provides in the directory <a class="el" href="index.html#directory">CMSIS/RTOS2/Source</a> several OS Tick implementations that can be used by any RTOS kernel.</p>
 174 <table class="markdownTable">
 175 <tr class="markdownTableHead">
 176 <th class="markdownTableHeadLeft">Filename   </th><th class="markdownTableHeadLeft">OS Tick Implementation for...    </th></tr>
 177 <tr class="markdownTableRowOdd">
 178 <td class="markdownTableBodyLeft"><b>os_systick.c</b>   </td><td class="markdownTableBodyLeft">Cortex-M SysTick timer   </td></tr>
 179 </table>
 180 <p><b>os_tick_gtim.c</b> | Cortex-A Generic Timer (available in some devices) <b>os_tick_ptim.c</b> | Cortex-A Private Timer (available in some devices) </p>
 181 <dl class="section note"><dt>Note</dt><dd>The above OS Tick source files implement <code>weak</code> functions which may be overwritten by user-specific implementations. </dd></dl>
 182 <h2 class="groupheader">Function Documentation</h2>
 183 <a id="ga5eeffb4d9dc6c6802fee8898096d9a59" name="ga5eeffb4d9dc6c6802fee8898096d9a59"></a>
 184 <h2 class="memtitle"><span class="permalink"><a href="#ga5eeffb4d9dc6c6802fee8898096d9a59">&#9670;&#160;</a></span>OS_Tick_Setup()</h2>
 185
 186 <div class="memitem">
 187 <div class="memproto">
 188       <table class="memname">
 189         <tr>
 190           <td class="memname">int32_t OS_Tick_Setup </td>
 191           <td>(</td>
 192           <td class="paramtype">uint32_t&#160;</td>
 193           <td class="paramname"><em>freq</em>, </td>
 194         </tr>
 195         <tr>
 196           <td class="paramkey"></td>
 197           <td></td>
 198           <td class="paramtype"><a class="el" href="os__tick_8h.html#a27589275c894aa295615df4764404b98">IRQHandler_t</a>&#160;</td>
 199           <td class="paramname"><em>handler</em>&#160;</td>
 200         </tr>
 201         <tr>
 202           <td></td>
 203           <td>)</td>
 204           <td></td><td></td>
 205         </tr>
 206       </table>
 207 </div><div class="memdoc">
 208 <dl class="params"><dt>Parameters</dt><dd>
 209   <table class="params">
 210     <tr><td class="paramdir">[in]</td><td class="paramname">freq</td><td>tick frequency in Hz </td></tr>
 211     <tr><td class="paramdir">[in]</td><td class="paramname">handler</td><td>tick IRQ handler </td></tr>
 212   </table>
 213   </dd>
 214 </dl>
 215 <dl class="section return"><dt>Returns</dt><dd>0 on success, -1 on error.</dd></dl>
 216 <p>Setup OS Tick timer to generate periodic RTOS Kernel Ticks.</p>
 217 <p>The timer should be configured to generate periodic interrupts at frequency specified by <em>freq</em>. The parameter <em>handler</em> defines the interrupt handler function that is called.</p>
 218 <p>The timer should only be initialized and configured but must not be started to create interrupts. The RTOS kernel calls the function <a class="el" href="group__CMSIS__RTOS__TickAPI.html#gaaa0d6ddef6816e8e5650fde3daf191e7">OS_Tick_Enable</a> to start the timer interrupts.</p>
 219 <p><b>Cortex-M SysTick implementation:</b> </p><div class="fragment"><div class="line"><span class="preprocessor">#ifndef SYSTICK_IRQ_PRIORITY</span></div>
 220 <div class="line"><span class="preprocessor">#define SYSTICK_IRQ_PRIORITY    0xFFU</span></div>
 221 <div class="line"><span class="preprocessor">#endif</span></div>
 222 <div class="line"> </div>
 223 <div class="line"><span class="keyword">static</span> uint8_t PendST;</div>
 224 <div class="line"> </div>
 225 <div class="line">int32_t  <a class="code hl_function" href="group__CMSIS__RTOS__TickAPI.html#ga5eeffb4d9dc6c6802fee8898096d9a59">OS_Tick_Setup</a> (uint32_t freq, <a class="code hl_typedef" href="os__tick_8h.html#a27589275c894aa295615df4764404b98">IRQHandler_t</a> handler) {</div>
 226 <div class="line">  (void)handler;</div>
 227 <div class="line">  uint32_t load;</div>
 228 <div class="line"> </div>
 229 <div class="line">  <span class="keywordflow">if</span> (freq == 0U) {</div>
 230 <div class="line">    <span class="keywordflow">return</span> (-1);</div>
 231 <div class="line">  }</div>
 232 <div class="line"> </div>
 233 <div class="line">  load = (SystemCoreClock / freq) - 1U;</div>
 234 <div class="line">  <span class="keywordflow">if</span> (load &gt; 0x00FFFFFFU) {</div>
 235 <div class="line">    <span class="keywordflow">return</span> (-1);</div>
 236 <div class="line">  }</div>
 237 <div class="line"> </div>
 238 <div class="line">  NVIC_SetPriority(SysTick_IRQn, SYSTICK_IRQ_PRIORITY);</div>
 239 <div class="line"> </div>
 240 <div class="line">  SysTick-&gt;CTRL =  SysTick_CTRL_CLKSOURCE_Msk | SysTick_CTRL_TICKINT_Msk;</div>
 241 <div class="line">  SysTick-&gt;LOAD =  load;</div>
 242 <div class="line">  SysTick-&gt;VAL  =  0U;</div>
 243 <div class="line"> </div>
 244 <div class="line">  PendST = 0U;</div>
 245 <div class="line"> </div>
 246 <div class="line">  <span class="keywordflow">return</span> (0);</div>
 247 <div class="line">}</div>
 248 <div class="ttc" id="agroup__CMSIS__RTOS__TickAPI_html_ga5eeffb4d9dc6c6802fee8898096d9a59"><div class="ttname"><a href="group__CMSIS__RTOS__TickAPI.html#ga5eeffb4d9dc6c6802fee8898096d9a59">OS_Tick_Setup</a></div><div class="ttdeci">int32_t OS_Tick_Setup(uint32_t freq, IRQHandler_t handler)</div><div class="ttdoc">Setup OS Tick timer to generate periodic RTOS Kernel Ticks.</div></div>
 249 <div class="ttc" id="aos__tick_8h_html_a27589275c894aa295615df4764404b98"><div class="ttname"><a href="os__tick_8h.html#a27589275c894aa295615df4764404b98">IRQHandler_t</a></div><div class="ttdeci">void(* IRQHandler_t)(void)</div><div class="ttdef"><b>Definition:</b> os_tick.h:38</div></div>
 250 </div><!-- fragment -->
 251 </div>
 252 </div>
 253 <a id="gaaa0d6ddef6816e8e5650fde3daf191e7" name="gaaa0d6ddef6816e8e5650fde3daf191e7"></a>
 254 <h2 class="memtitle"><span class="permalink"><a href="#gaaa0d6ddef6816e8e5650fde3daf191e7">&#9670;&#160;</a></span>OS_Tick_Enable()</h2>
 255
 256 <div class="memitem">
 257 <div class="memproto">
 258       <table class="memname">
 259         <tr>
 260           <td class="memname">void OS_Tick_Enable </td>
 261           <td>(</td>
 262           <td class="paramtype">void&#160;</td>
 263           <td class="paramname"></td><td>)</td>
 264           <td></td>
 265         </tr>
 266       </table>
 267 </div><div class="memdoc">
 268 <p>Enable OS Tick timer interrupt.</p>
 269 <p>Enable and start the OS Tick timer to generate periodic RTOS Kernel Tick interrupts.</p>
 270 <p><b>Cortex-M SysTick implementation:</b> </p><div class="fragment"><div class="line"><span class="keywordtype">void</span>  <a class="code hl_function" href="group__CMSIS__RTOS__TickAPI.html#gaaa0d6ddef6816e8e5650fde3daf191e7">OS_Tick_Enable</a> (<span class="keywordtype">void</span>) {</div>
 271 <div class="line"> </div>
 272 <div class="line">  <span class="keywordflow">if</span> (PendST != 0U) {</div>
 273 <div class="line">    PendST = 0U;</div>
 274 <div class="line">    SCB-&gt;ICSR = SCB_ICSR_PENDSTSET_Msk;</div>
 275 <div class="line">  }</div>
 276 <div class="line"> </div>
 277 <div class="line">  SysTick-&gt;CTRL |=  SysTick_CTRL_ENABLE_Msk;</div>
 278 <div class="line"> </div>
 279 <div class="line">}</div>
 280 <div class="ttc" id="agroup__CMSIS__RTOS__TickAPI_html_gaaa0d6ddef6816e8e5650fde3daf191e7"><div class="ttname"><a href="group__CMSIS__RTOS__TickAPI.html#gaaa0d6ddef6816e8e5650fde3daf191e7">OS_Tick_Enable</a></div><div class="ttdeci">void OS_Tick_Enable(void)</div><div class="ttdoc">Enable OS Tick timer interrupt.</div></div>
 281 </div><!-- fragment -->
 282 </div>
 283 </div>
 284 <a id="ga50fc040b66fabd1945d2bd1d0d05661d" name="ga50fc040b66fabd1945d2bd1d0d05661d"></a>
 285 <h2 class="memtitle"><span class="permalink"><a href="#ga50fc040b66fabd1945d2bd1d0d05661d">&#9670;&#160;</a></span>OS_Tick_Disable()</h2>
 286
 287 <div class="memitem">
 288 <div class="memproto">
 289       <table class="memname">
 290         <tr>
 291           <td class="memname">void OS_Tick_Disable </td>
 292           <td>(</td>
 293           <td class="paramtype">void&#160;</td>
 294           <td class="paramname"></td><td>)</td>
 295           <td></td>
 296         </tr>
 297       </table>
 298 </div><div class="memdoc">
 299 <p>Disable OS Tick timer interrupt.</p>
 300 <p>Stop the OS Tick timer and disable generation of RTOS Kernel Tick interrupts.</p>
 301 <p><b>Cortex-M SysTick implementation:</b> </p><div class="fragment"><div class="line"><span class="keywordtype">void</span>  <a class="code hl_function" href="group__CMSIS__RTOS__TickAPI.html#ga50fc040b66fabd1945d2bd1d0d05661d">OS_Tick_Disable</a> (<span class="keywordtype">void</span>) {</div>
 302 <div class="line"> </div>
 303 <div class="line">  SysTick-&gt;CTRL &amp;= ~SysTick_CTRL_ENABLE_Msk;</div>
 304 <div class="line"> </div>
 305 <div class="line">  <span class="keywordflow">if</span> ((SCB-&gt;ICSR &amp; SCB_ICSR_PENDSTSET_Msk) != 0U) {</div>
 306 <div class="line">    SCB-&gt;ICSR = SCB_ICSR_PENDSTCLR_Msk;</div>
 307 <div class="line">    PendST = 1U;</div>
 308 <div class="line">  }</div>
 309 <div class="line"> </div>
 310 <div class="line">}</div>
 311 <div class="ttc" id="agroup__CMSIS__RTOS__TickAPI_html_ga50fc040b66fabd1945d2bd1d0d05661d"><div class="ttname"><a href="group__CMSIS__RTOS__TickAPI.html#ga50fc040b66fabd1945d2bd1d0d05661d">OS_Tick_Disable</a></div><div class="ttdeci">void OS_Tick_Disable(void)</div><div class="ttdoc">Disable OS Tick timer interrupt.</div></div>
 312 </div><!-- fragment -->
 313 </div>
 314 </div>
 315 <a id="ga14c430d2b363ebd9f904b0822a9314e7" name="ga14c430d2b363ebd9f904b0822a9314e7"></a>
 316 <h2 class="memtitle"><span class="permalink"><a href="#ga14c430d2b363ebd9f904b0822a9314e7">&#9670;&#160;</a></span>OS_Tick_AcknowledgeIRQ()</h2>
 317
 318 <div class="memitem">
 319 <div class="memproto">
 320       <table class="memname">
 321         <tr>
 322           <td class="memname">void OS_Tick_AcknowledgeIRQ </td>
 323           <td>(</td>
 324           <td class="paramtype">void&#160;</td>
 325           <td class="paramname"></td><td>)</td>
 326           <td></td>
 327         </tr>
 328       </table>
 329 </div><div class="memdoc">
 330 <p>Acknowledge execution of OS Tick timer interrupt.</p>
 331 <p>Acknowledge the execution of the OS Tick timer interrupt function, for example clear the pending flag.</p>
 332 <p><b>Cortex-M SysTick implementation:</b></p>
 333 <div class="fragment"><div class="line"><span class="keywordtype">void</span>  <a class="code hl_function" href="group__CMSIS__RTOS__TickAPI.html#ga14c430d2b363ebd9f904b0822a9314e7">OS_Tick_AcknowledgeIRQ</a> (<span class="keywordtype">void</span>) {</div>
 334 <div class="line"> </div>
 335 <div class="line">  (void)SysTick-&gt;CTRL;</div>
 336 <div class="line"> </div>
 337 <div class="line">}</div>
 338 <div class="ttc" id="agroup__CMSIS__RTOS__TickAPI_html_ga14c430d2b363ebd9f904b0822a9314e7"><div class="ttname"><a href="group__CMSIS__RTOS__TickAPI.html#ga14c430d2b363ebd9f904b0822a9314e7">OS_Tick_AcknowledgeIRQ</a></div><div class="ttdeci">void OS_Tick_AcknowledgeIRQ(void)</div><div class="ttdoc">Acknowledge execution of OS Tick timer interrupt.</div></div>
 339 </div><!-- fragment -->
 340 </div>
 341 </div>
 342 <a id="gaa8b4eca23e3ffe2df403291958cdc905" name="gaa8b4eca23e3ffe2df403291958cdc905"></a>
 343 <h2 class="memtitle"><span class="permalink"><a href="#gaa8b4eca23e3ffe2df403291958cdc905">&#9670;&#160;</a></span>OS_Tick_GetIRQn()</h2>
 344
 345 <div class="memitem">
 346 <div class="memproto">
 347       <table class="memname">
 348         <tr>
 349           <td class="memname">int32_t OS_Tick_GetIRQn </td>
 350           <td>(</td>
 351           <td class="paramtype">void&#160;</td>
 352           <td class="paramname"></td><td>)</td>
 353           <td></td>
 354         </tr>
 355       </table>
 356 </div><div class="memdoc">
 357 <dl class="section return"><dt>Returns</dt><dd>OS Tick IRQ number</dd></dl>
 358 <p>Get OS Tick timer IRQ number.</p>
 359 <p>Return the numeric value that identifies the interrupt called by the OS Tick timer.</p>
 360 <p><b>Cortex-M SysTick implementation:</b></p>
 361 <div class="fragment"><div class="line">int32_t  <a class="code hl_function" href="group__CMSIS__RTOS__TickAPI.html#gaa8b4eca23e3ffe2df403291958cdc905">OS_Tick_GetIRQn</a> (<span class="keywordtype">void</span>) {</div>
 362 <div class="line">  <span class="keywordflow">return</span> ((int32_t)SysTick_IRQn);</div>
 363 <div class="line">}</div>
 364 <div class="ttc" id="agroup__CMSIS__RTOS__TickAPI_html_gaa8b4eca23e3ffe2df403291958cdc905"><div class="ttname"><a href="group__CMSIS__RTOS__TickAPI.html#gaa8b4eca23e3ffe2df403291958cdc905">OS_Tick_GetIRQn</a></div><div class="ttdeci">int32_t OS_Tick_GetIRQn(void)</div><div class="ttdoc">Get OS Tick timer IRQ number.</div></div>
 365 </div><!-- fragment -->
 366 </div>
 367 </div>
 368 <a id="ga936217ea28236fb57648973e0d8f627a" name="ga936217ea28236fb57648973e0d8f627a"></a>
 369 <h2 class="memtitle"><span class="permalink"><a href="#ga936217ea28236fb57648973e0d8f627a">&#9670;&#160;</a></span>OS_Tick_GetClock()</h2>
 370
 371 <div class="memitem">
 372 <div class="memproto">
 373       <table class="memname">
 374         <tr>
 375           <td class="memname">uint32_t OS_Tick_GetClock </td>
 376           <td>(</td>
 377           <td class="paramtype">void&#160;</td>
 378           <td class="paramname"></td><td>)</td>
 379           <td></td>
 380         </tr>
 381       </table>
 382 </div><div class="memdoc">
 383 <dl class="section return"><dt>Returns</dt><dd>OS Tick timer clock frequency in Hz</dd></dl>
 384 <p>Get OS Tick timer clock frequency.</p>
 385 <p>Return the input clock frequency of the OS Tick timer. This is the increment rate of the counter value returned by the function <a class="el" href="group__CMSIS__RTOS__TickAPI.html#gaa64a145a554f1e5077848938d7f39c92">OS_Tick_GetCount</a>. This function is used to by the function <a class="el" href="group__CMSIS__RTOS__KernelCtrl.html#ga4d69215a93220f72be3684cad582f16a">osKernelGetSysTimerFreq</a>.</p>
 386 <p><b>Cortex-M SysTick implementation:</b></p>
 387 <div class="fragment"><div class="line">uint32_t <a class="code hl_function" href="group__CMSIS__RTOS__TickAPI.html#ga936217ea28236fb57648973e0d8f627a">OS_Tick_GetClock</a> (<span class="keywordtype">void</span>) {</div>
 388 <div class="line">  <span class="keywordflow">return</span> (SystemCoreClock);</div>
 389 <div class="line">}</div>
 390 <div class="ttc" id="agroup__CMSIS__RTOS__TickAPI_html_ga936217ea28236fb57648973e0d8f627a"><div class="ttname"><a href="group__CMSIS__RTOS__TickAPI.html#ga936217ea28236fb57648973e0d8f627a">OS_Tick_GetClock</a></div><div class="ttdeci">uint32_t OS_Tick_GetClock(void)</div><div class="ttdoc">Get OS Tick timer clock frequency.</div></div>
 391 </div><!-- fragment -->
 392 </div>
 393 </div>
 394 <a id="ga123151dc19d5a94a68f12cdbf61a9bb5" name="ga123151dc19d5a94a68f12cdbf61a9bb5"></a>
 395 <h2 class="memtitle"><span class="permalink"><a href="#ga123151dc19d5a94a68f12cdbf61a9bb5">&#9670;&#160;</a></span>OS_Tick_GetInterval()</h2>
 396
 397 <div class="memitem">
 398 <div class="memproto">
 399       <table class="memname">
 400         <tr>
 401           <td class="memname">uint32_t OS_Tick_GetInterval </td>
 402           <td>(</td>
 403           <td class="paramtype">void&#160;</td>
 404           <td class="paramname"></td><td>)</td>
 405           <td></td>
 406         </tr>
 407       </table>
 408 </div><div class="memdoc">
 409 <dl class="section return"><dt>Returns</dt><dd>OS Tick timer interval reload value</dd></dl>
 410 <p>Get OS Tick timer interval reload value.</p>
 411 <p>Return the number of counter ticks between to periodic OS Tick timer interrupts.</p>
 412 <p><b>Cortex-M SysTick implementation:</b></p>
 413 <div class="fragment"><div class="line">uint32_t <a class="code hl_function" href="group__CMSIS__RTOS__TickAPI.html#ga123151dc19d5a94a68f12cdbf61a9bb5">OS_Tick_GetInterval</a> (<span class="keywordtype">void</span>) {</div>
 414 <div class="line">  <span class="keywordflow">return</span> (SysTick-&gt;LOAD + 1U);</div>
 415 <div class="line">}</div>
 416 <div class="ttc" id="agroup__CMSIS__RTOS__TickAPI_html_ga123151dc19d5a94a68f12cdbf61a9bb5"><div class="ttname"><a href="group__CMSIS__RTOS__TickAPI.html#ga123151dc19d5a94a68f12cdbf61a9bb5">OS_Tick_GetInterval</a></div><div class="ttdeci">uint32_t OS_Tick_GetInterval(void)</div><div class="ttdoc">Get OS Tick timer interval reload value.</div></div>
 417 </div><!-- fragment -->
 418 </div>
 419 </div>
 420 <a id="gaa64a145a554f1e5077848938d7f39c92" name="gaa64a145a554f1e5077848938d7f39c92"></a>
 421 <h2 class="memtitle"><span class="permalink"><a href="#gaa64a145a554f1e5077848938d7f39c92">&#9670;&#160;</a></span>OS_Tick_GetCount()</h2>
 422
 423 <div class="memitem">
 424 <div class="memproto">
 425       <table class="memname">
 426         <tr>
 427           <td class="memname">uint32_t OS_Tick_GetCount </td>
 428           <td>(</td>
 429           <td class="paramtype">void&#160;</td>
 430           <td class="paramname"></td><td>)</td>
 431           <td></td>
 432         </tr>
 433       </table>
 434 </div><div class="memdoc">
 435 <dl class="section return"><dt>Returns</dt><dd>OS Tick timer counter value</dd></dl>
 436 <p>Get OS Tick timer counter value.</p>
 437 <p>Return the current value of the OS Tick counter: 0 ... (reload value -1). The reload value is returned by the function <a class="el" href="group__CMSIS__RTOS__TickAPI.html#ga123151dc19d5a94a68f12cdbf61a9bb5">OS_Tick_GetInterval</a>. The OS Tick timer counter value is used to by the function <a class="el" href="group__CMSIS__RTOS__KernelCtrl.html#gae0fcaff6cecfb4013bb556c87afcd7d2">osKernelGetSysTimerCount</a>.</p>
 438 <p><b>Cortex-M SysTick implementation:</b></p>
 439 <div class="fragment"><div class="line">uint32_t <a class="code hl_function" href="group__CMSIS__RTOS__TickAPI.html#gaa64a145a554f1e5077848938d7f39c92">OS_Tick_GetCount</a> (<span class="keywordtype">void</span>) {</div>
 440 <div class="line">  uint32_t val;</div>
 441 <div class="line">  uint32_t count;</div>
 442 <div class="line"> </div>
 443 <div class="line">  val = SysTick-&gt;VAL;</div>
 444 <div class="line">  <span class="keywordflow">if</span> (val != 0U) {</div>
 445 <div class="line">    count = (SysTick-&gt;LOAD - val) + 1U;</div>
 446 <div class="line">  } <span class="keywordflow">else</span> {</div>
 447 <div class="line">    count = 0U;</div>
 448 <div class="line">  }</div>
 449 <div class="line"> </div>
 450 <div class="line">  <span class="keywordflow">return</span> (count);</div>
 451 <div class="line">}</div>
 452 <div class="ttc" id="agroup__CMSIS__RTOS__TickAPI_html_gaa64a145a554f1e5077848938d7f39c92"><div class="ttname"><a href="group__CMSIS__RTOS__TickAPI.html#gaa64a145a554f1e5077848938d7f39c92">OS_Tick_GetCount</a></div><div class="ttdeci">uint32_t OS_Tick_GetCount(void)</div><div class="ttdoc">Get OS Tick timer counter value.</div></div>
 453 </div><!-- fragment -->
 454 </div>
 455 </div>
 456 <a id="ga1f9a593126b7f0b66fc526c2cebd6192" name="ga1f9a593126b7f0b66fc526c2cebd6192"></a>
 457 <h2 class="memtitle"><span class="permalink"><a href="#ga1f9a593126b7f0b66fc526c2cebd6192">&#9670;&#160;</a></span>OS_Tick_GetOverflow()</h2>
 458
 459 <div class="memitem">
 460 <div class="memproto">
 461       <table class="memname">
 462         <tr>
 463           <td class="memname">OS_Tick_GetOverflow </td>
 464           <td>(</td>
 465           <td class="paramtype">void&#160;</td>
 466           <td class="paramname"></td><td>)</td>
 467           <td></td>
 468         </tr>
 469       </table>
 470 </div><div class="memdoc">
 471 <dl class="section return"><dt>Returns</dt><dd>OS Tick overflow status (1 - overflow, 0 - no overflow).</dd></dl>
 472 <p>Get OS Tick timer overflow status.</p>
 473 <p>Return the state of OS Tick timer interrupt pending bit that indicates timer overflows to adjust SysTimer calculations.</p>
 474 <p><b>Cortex-M SysTick implementation:</b></p>
 475 <div class="fragment"><div class="line">uint32_t <a class="code hl_function" href="group__CMSIS__RTOS__TickAPI.html#ga1f9a593126b7f0b66fc526c2cebd6192">OS_Tick_GetOverflow</a> (<span class="keywordtype">void</span>) {</div>
 476 <div class="line">  <span class="keywordflow">return</span> ((SCB-&gt;ICSR &amp; SCB_ICSR_PENDSTSET_Msk) &gt;&gt; SCB_ICSR_PENDSTSET_Pos);</div>
 477 <div class="line">}</div>
 478 <div class="ttc" id="agroup__CMSIS__RTOS__TickAPI_html_ga1f9a593126b7f0b66fc526c2cebd6192"><div class="ttname"><a href="group__CMSIS__RTOS__TickAPI.html#ga1f9a593126b7f0b66fc526c2cebd6192">OS_Tick_GetOverflow</a></div><div class="ttdeci">uint32_t OS_Tick_GetOverflow(void)</div><div class="ttdoc">Get OS Tick timer overflow status.</div></div>
 479 </div><!-- fragment -->
 480 </div>
 481 </div>
 482 </div><!-- contents -->
 483 </div><!-- doc-content -->
 484 <!-- start footer part -->
 485 <div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
 486   <ul>
 487     <li class="footer">
 488       <script type="text/javascript">
 489         <!--
 490         writeFooter.call(this);
 491         //-->
 492       </script>
 493     </li>
 494   </ul>
 495 </div>
 496 </body>
 497 </html>