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, "CMSIS-RTOS2");
  51      //-->
  52     </script>
  53    </span>
  54    </div>
  55    <div id="projectbrief">Real-Time Operating System: API and RTX Reference Implementation</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 <!-- Generated by Doxygen 1.9.6 -->
  83 <script type="text/javascript">
  84 /* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
  85 var searchBox = new SearchBox("searchBox", "search/",'.html');
  86 /* @license-end */
  87 </script>
  88 </div><!-- top -->
  89 <div id="side-nav" class="ui-resizable side-nav-resizable">
  90   <div id="nav-tree">
  91     <div id="nav-tree-contents">
  92       <div id="nav-sync" class="sync"></div>
  93     </div>
  94   </div>
  95   <div id="splitbar" style="-moz-user-select:none;"
  96        class="ui-resizable-handle">
  97   </div>
  98 </div>
  99 <script type="text/javascript">
 100 /* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
 101 $(document).ready(function(){initNavTree('group__CMSIS__RTOS__TickAPI.html',''); initResizable(); });
 102 /* @license-end */
 103 </script>
 104 <div id="doc-content">
 105 <!-- window showing the filter options -->
 106 <div id="MSearchSelectWindow"
 107      onmouseover="return searchBox.OnSearchSelectShow()"
 108      onmouseout="return searchBox.OnSearchSelectHide()"
 109      onkeydown="return searchBox.OnSearchSelectKey(event)">
 110 </div>
 111
 112 <!-- iframe showing the search results (closed by default) -->
 113 <div id="MSearchResultsWindow">
 114 <div id="MSearchResults">
 115 <div class="SRPage">
 116 <div id="SRIndex">
 117 <div id="SRResults"></div>
 118 <div class="SRStatus" id="Loading">Loading...</div>
 119 <div class="SRStatus" id="Searching">Searching...</div>
 120 <div class="SRStatus" id="NoMatches">No Matches</div>
 121 </div>
 122 </div>
 123 </div>
 124 </div>
 125
 126 <div class="header">
 127   <div class="summary">
 128 <a href="#func-members">Functions</a>  </div>
 129   <div class="headertitle"><div class="title">OS Tick API</div></div>
 130 </div><!--header-->
 131 <div class="contents">
 132
 133 <p>System tick timer interface for periodic RTOS Kernel Ticks defined in <b>os_tick.h</b>
 134 <a href="#details">More...</a></p>
 135 <table class="memberdecls">
 136 <tr class="heading"><td colspan="2"><h2 class="groupheader"><a id="func-members" name="func-members"></a>
 137 Functions</h2></td></tr>
 138 <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>
 139 <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>
 140 <tr class="separator:ga5eeffb4d9dc6c6802fee8898096d9a59"><td class="memSeparator" colspan="2">&#160;</td></tr>
 141 <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>
 142 <tr class="memdesc:gaaa0d6ddef6816e8e5650fde3daf191e7"><td class="mdescLeft">&#160;</td><td class="mdescRight">Enable OS Tick timer interrupt.  <br /></td></tr>
 143 <tr class="separator:gaaa0d6ddef6816e8e5650fde3daf191e7"><td class="memSeparator" colspan="2">&#160;</td></tr>
 144 <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>
 145 <tr class="memdesc:ga50fc040b66fabd1945d2bd1d0d05661d"><td class="mdescLeft">&#160;</td><td class="mdescRight">Disable OS Tick timer interrupt.  <br /></td></tr>
 146 <tr class="separator:ga50fc040b66fabd1945d2bd1d0d05661d"><td class="memSeparator" colspan="2">&#160;</td></tr>
 147 <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>
 148 <tr class="memdesc:ga14c430d2b363ebd9f904b0822a9314e7"><td class="mdescLeft">&#160;</td><td class="mdescRight">Acknowledge execution of OS Tick timer interrupt.  <br /></td></tr>
 149 <tr class="separator:ga14c430d2b363ebd9f904b0822a9314e7"><td class="memSeparator" colspan="2">&#160;</td></tr>
 150 <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>
 151 <tr class="memdesc:gaa8b4eca23e3ffe2df403291958cdc905"><td class="mdescLeft">&#160;</td><td class="mdescRight">Get OS Tick timer IRQ number.  <br /></td></tr>
 152 <tr class="separator:gaa8b4eca23e3ffe2df403291958cdc905"><td class="memSeparator" colspan="2">&#160;</td></tr>
 153 <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>
 154 <tr class="memdesc:ga936217ea28236fb57648973e0d8f627a"><td class="mdescLeft">&#160;</td><td class="mdescRight">Get OS Tick timer clock frequency.  <br /></td></tr>
 155 <tr class="separator:ga936217ea28236fb57648973e0d8f627a"><td class="memSeparator" colspan="2">&#160;</td></tr>
 156 <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>
 157 <tr class="memdesc:ga123151dc19d5a94a68f12cdbf61a9bb5"><td class="mdescLeft">&#160;</td><td class="mdescRight">Get OS Tick timer interval reload value.  <br /></td></tr>
 158 <tr class="separator:ga123151dc19d5a94a68f12cdbf61a9bb5"><td class="memSeparator" colspan="2">&#160;</td></tr>
 159 <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>
 160 <tr class="memdesc:gaa64a145a554f1e5077848938d7f39c92"><td class="mdescLeft">&#160;</td><td class="mdescRight">Get OS Tick timer counter value.  <br /></td></tr>
 161 <tr class="separator:gaa64a145a554f1e5077848938d7f39c92"><td class="memSeparator" colspan="2">&#160;</td></tr>
 162 <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>
 163 <tr class="memdesc:ga1f9a593126b7f0b66fc526c2cebd6192"><td class="mdescLeft">&#160;</td><td class="mdescRight">Get OS Tick timer overflow status.  <br /></td></tr>
 164 <tr class="separator:ga1f9a593126b7f0b66fc526c2cebd6192"><td class="memSeparator" colspan="2">&#160;</td></tr>
 165 </table>
 166 <a name="details" id="details"></a><h2 class="groupheader">Description</h2>
 167 <p>The <b>OS Tick API</b> is an interface to a system timer that generates the Kernel Ticks.</p>
 168 <p>All Cortex-M processors provide an unified System Tick Timer that is typically used to generate the RTOS Kernel Tick.</p>
 169 <p>The Cortex-A processors do not implement an unified system timer and required a device specific implementation. </p>
 170 <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>
 171 <table class="markdownTable">
 172 <tr class="markdownTableHead">
 173 <th class="markdownTableHeadLeft">Filename   </th><th class="markdownTableHeadLeft">OS Tick Implementation for...    </th></tr>
 174 <tr class="markdownTableRowOdd">
 175 <td class="markdownTableBodyLeft"><b>os_systick.c</b>   </td><td class="markdownTableBodyLeft">Cortex-M SysTick timer   </td></tr>
 176 </table>
 177 <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>
 178 <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>
 179 <h2 class="groupheader">Function Documentation</h2>
 180 <a id="ga5eeffb4d9dc6c6802fee8898096d9a59" name="ga5eeffb4d9dc6c6802fee8898096d9a59"></a>
 181 <h2 class="memtitle"><span class="permalink"><a href="#ga5eeffb4d9dc6c6802fee8898096d9a59">&#9670;&#160;</a></span>OS_Tick_Setup()</h2>
 182
 183 <div class="memitem">
 184 <div class="memproto">
 185       <table class="memname">
 186         <tr>
 187           <td class="memname">int32_t OS_Tick_Setup </td>
 188           <td>(</td>
 189           <td class="paramtype">uint32_t&#160;</td>
 190           <td class="paramname"><em>freq</em>, </td>
 191         </tr>
 192         <tr>
 193           <td class="paramkey"></td>
 194           <td></td>
 195           <td class="paramtype"><a class="el" href="os__tick_8h.html#a27589275c894aa295615df4764404b98">IRQHandler_t</a>&#160;</td>
 196           <td class="paramname"><em>handler</em>&#160;</td>
 197         </tr>
 198         <tr>
 199           <td></td>
 200           <td>)</td>
 201           <td></td><td></td>
 202         </tr>
 203       </table>
 204 </div><div class="memdoc">
 205 <dl class="params"><dt>Parameters</dt><dd>
 206   <table class="params">
 207     <tr><td class="paramdir">[in]</td><td class="paramname">freq</td><td>tick frequency in Hz </td></tr>
 208     <tr><td class="paramdir">[in]</td><td class="paramname">handler</td><td>tick IRQ handler </td></tr>
 209   </table>
 210   </dd>
 211 </dl>
 212 <dl class="section return"><dt>Returns</dt><dd>0 on success, -1 on error.</dd></dl>
 213 <p>Setup OS Tick timer to generate periodic RTOS Kernel Ticks.</p>
 214 <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>
 215 <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>
 216 <p><b>Cortex-M SysTick implementation:</b> </p><div class="fragment"><div class="line"><span class="preprocessor">#ifndef SYSTICK_IRQ_PRIORITY</span></div>
 217 <div class="line"><span class="preprocessor">#define SYSTICK_IRQ_PRIORITY    0xFFU</span></div>
 218 <div class="line"><span class="preprocessor">#endif</span></div>
 219 <div class="line"> </div>
 220 <div class="line"><span class="keyword">static</span> uint8_t PendST;</div>
 221 <div class="line"> </div>
 222 <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>
 223 <div class="line">  (void)handler;</div>
 224 <div class="line">  uint32_t load;</div>
 225 <div class="line"> </div>
 226 <div class="line">  <span class="keywordflow">if</span> (freq == 0U) {</div>
 227 <div class="line">    <span class="keywordflow">return</span> (-1);</div>
 228 <div class="line">  }</div>
 229 <div class="line"> </div>
 230 <div class="line">  load = (SystemCoreClock / freq) - 1U;</div>
 231 <div class="line">  <span class="keywordflow">if</span> (load &gt; 0x00FFFFFFU) {</div>
 232 <div class="line">    <span class="keywordflow">return</span> (-1);</div>
 233 <div class="line">  }</div>
 234 <div class="line"> </div>
 235 <div class="line">  NVIC_SetPriority(SysTick_IRQn, SYSTICK_IRQ_PRIORITY);</div>
 236 <div class="line"> </div>
 237 <div class="line">  SysTick-&gt;CTRL =  SysTick_CTRL_CLKSOURCE_Msk | SysTick_CTRL_TICKINT_Msk;</div>
 238 <div class="line">  SysTick-&gt;LOAD =  load;</div>
 239 <div class="line">  SysTick-&gt;VAL  =  0U;</div>
 240 <div class="line"> </div>
 241 <div class="line">  PendST = 0U;</div>
 242 <div class="line"> </div>
 243 <div class="line">  <span class="keywordflow">return</span> (0);</div>
 244 <div class="line">}</div>
 245 <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>
 246 <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>
 247 </div><!-- fragment -->
 248 </div>
 249 </div>
 250 <a id="gaaa0d6ddef6816e8e5650fde3daf191e7" name="gaaa0d6ddef6816e8e5650fde3daf191e7"></a>
 251 <h2 class="memtitle"><span class="permalink"><a href="#gaaa0d6ddef6816e8e5650fde3daf191e7">&#9670;&#160;</a></span>OS_Tick_Enable()</h2>
 252
 253 <div class="memitem">
 254 <div class="memproto">
 255       <table class="memname">
 256         <tr>
 257           <td class="memname">void OS_Tick_Enable </td>
 258           <td>(</td>
 259           <td class="paramtype">void&#160;</td>
 260           <td class="paramname"></td><td>)</td>
 261           <td></td>
 262         </tr>
 263       </table>
 264 </div><div class="memdoc">
 265 <p>Enable OS Tick timer interrupt.</p>
 266 <p>Enable and start the OS Tick timer to generate periodic RTOS Kernel Tick interrupts.</p>
 267 <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>
 268 <div class="line"> </div>
 269 <div class="line">  <span class="keywordflow">if</span> (PendST != 0U) {</div>
 270 <div class="line">    PendST = 0U;</div>
 271 <div class="line">    SCB-&gt;ICSR = SCB_ICSR_PENDSTSET_Msk;</div>
 272 <div class="line">  }</div>
 273 <div class="line"> </div>
 274 <div class="line">  SysTick-&gt;CTRL |=  SysTick_CTRL_ENABLE_Msk;</div>
 275 <div class="line"> </div>
 276 <div class="line">}</div>
 277 <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>
 278 </div><!-- fragment -->
 279 </div>
 280 </div>
 281 <a id="ga50fc040b66fabd1945d2bd1d0d05661d" name="ga50fc040b66fabd1945d2bd1d0d05661d"></a>
 282 <h2 class="memtitle"><span class="permalink"><a href="#ga50fc040b66fabd1945d2bd1d0d05661d">&#9670;&#160;</a></span>OS_Tick_Disable()</h2>
 283
 284 <div class="memitem">
 285 <div class="memproto">
 286       <table class="memname">
 287         <tr>
 288           <td class="memname">void OS_Tick_Disable </td>
 289           <td>(</td>
 290           <td class="paramtype">void&#160;</td>
 291           <td class="paramname"></td><td>)</td>
 292           <td></td>
 293         </tr>
 294       </table>
 295 </div><div class="memdoc">
 296 <p>Disable OS Tick timer interrupt.</p>
 297 <p>Stop the OS Tick timer and disable generation of RTOS Kernel Tick interrupts.</p>
 298 <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>
 299 <div class="line"> </div>
 300 <div class="line">  SysTick-&gt;CTRL &amp;= ~SysTick_CTRL_ENABLE_Msk;</div>
 301 <div class="line"> </div>
 302 <div class="line">  <span class="keywordflow">if</span> ((SCB-&gt;ICSR &amp; SCB_ICSR_PENDSTSET_Msk) != 0U) {</div>
 303 <div class="line">    SCB-&gt;ICSR = SCB_ICSR_PENDSTCLR_Msk;</div>
 304 <div class="line">    PendST = 1U;</div>
 305 <div class="line">  }</div>
 306 <div class="line"> </div>
 307 <div class="line">}</div>
 308 <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>
 309 </div><!-- fragment -->
 310 </div>
 311 </div>
 312 <a id="ga14c430d2b363ebd9f904b0822a9314e7" name="ga14c430d2b363ebd9f904b0822a9314e7"></a>
 313 <h2 class="memtitle"><span class="permalink"><a href="#ga14c430d2b363ebd9f904b0822a9314e7">&#9670;&#160;</a></span>OS_Tick_AcknowledgeIRQ()</h2>
 314
 315 <div class="memitem">
 316 <div class="memproto">
 317       <table class="memname">
 318         <tr>
 319           <td class="memname">void OS_Tick_AcknowledgeIRQ </td>
 320           <td>(</td>
 321           <td class="paramtype">void&#160;</td>
 322           <td class="paramname"></td><td>)</td>
 323           <td></td>
 324         </tr>
 325       </table>
 326 </div><div class="memdoc">
 327 <p>Acknowledge execution of OS Tick timer interrupt.</p>
 328 <p>Acknowledge the execution of the OS Tick timer interrupt function, for example clear the pending flag.</p>
 329 <p><b>Cortex-M SysTick implementation:</b></p>
 330 <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>
 331 <div class="line"> </div>
 332 <div class="line">  (void)SysTick-&gt;CTRL;</div>
 333 <div class="line"> </div>
 334 <div class="line">}</div>
 335 <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>
 336 </div><!-- fragment -->
 337 </div>
 338 </div>
 339 <a id="gaa8b4eca23e3ffe2df403291958cdc905" name="gaa8b4eca23e3ffe2df403291958cdc905"></a>
 340 <h2 class="memtitle"><span class="permalink"><a href="#gaa8b4eca23e3ffe2df403291958cdc905">&#9670;&#160;</a></span>OS_Tick_GetIRQn()</h2>
 341
 342 <div class="memitem">
 343 <div class="memproto">
 344       <table class="memname">
 345         <tr>
 346           <td class="memname">int32_t OS_Tick_GetIRQn </td>
 347           <td>(</td>
 348           <td class="paramtype">void&#160;</td>
 349           <td class="paramname"></td><td>)</td>
 350           <td></td>
 351         </tr>
 352       </table>
 353 </div><div class="memdoc">
 354 <dl class="section return"><dt>Returns</dt><dd>OS Tick IRQ number</dd></dl>
 355 <p>Get OS Tick timer IRQ number.</p>
 356 <p>Return the numeric value that identifies the interrupt called by the OS Tick timer.</p>
 357 <p><b>Cortex-M SysTick implementation:</b></p>
 358 <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>
 359 <div class="line">  <span class="keywordflow">return</span> ((int32_t)SysTick_IRQn);</div>
 360 <div class="line">}</div>
 361 <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>
 362 </div><!-- fragment -->
 363 </div>
 364 </div>
 365 <a id="ga936217ea28236fb57648973e0d8f627a" name="ga936217ea28236fb57648973e0d8f627a"></a>
 366 <h2 class="memtitle"><span class="permalink"><a href="#ga936217ea28236fb57648973e0d8f627a">&#9670;&#160;</a></span>OS_Tick_GetClock()</h2>
 367
 368 <div class="memitem">
 369 <div class="memproto">
 370       <table class="memname">
 371         <tr>
 372           <td class="memname">uint32_t OS_Tick_GetClock </td>
 373           <td>(</td>
 374           <td class="paramtype">void&#160;</td>
 375           <td class="paramname"></td><td>)</td>
 376           <td></td>
 377         </tr>
 378       </table>
 379 </div><div class="memdoc">
 380 <dl class="section return"><dt>Returns</dt><dd>OS Tick timer clock frequency in Hz</dd></dl>
 381 <p>Get OS Tick timer clock frequency.</p>
 382 <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>
 383 <p><b>Cortex-M SysTick implementation:</b></p>
 384 <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>
 385 <div class="line">  <span class="keywordflow">return</span> (SystemCoreClock);</div>
 386 <div class="line">}</div>
 387 <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>
 388 </div><!-- fragment -->
 389 </div>
 390 </div>
 391 <a id="ga123151dc19d5a94a68f12cdbf61a9bb5" name="ga123151dc19d5a94a68f12cdbf61a9bb5"></a>
 392 <h2 class="memtitle"><span class="permalink"><a href="#ga123151dc19d5a94a68f12cdbf61a9bb5">&#9670;&#160;</a></span>OS_Tick_GetInterval()</h2>
 393
 394 <div class="memitem">
 395 <div class="memproto">
 396       <table class="memname">
 397         <tr>
 398           <td class="memname">uint32_t OS_Tick_GetInterval </td>
 399           <td>(</td>
 400           <td class="paramtype">void&#160;</td>
 401           <td class="paramname"></td><td>)</td>
 402           <td></td>
 403         </tr>
 404       </table>
 405 </div><div class="memdoc">
 406 <dl class="section return"><dt>Returns</dt><dd>OS Tick timer interval reload value</dd></dl>
 407 <p>Get OS Tick timer interval reload value.</p>
 408 <p>Return the number of counter ticks between to periodic OS Tick timer interrupts.</p>
 409 <p><b>Cortex-M SysTick implementation:</b></p>
 410 <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>
 411 <div class="line">  <span class="keywordflow">return</span> (SysTick-&gt;LOAD + 1U);</div>
 412 <div class="line">}</div>
 413 <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>
 414 </div><!-- fragment -->
 415 </div>
 416 </div>
 417 <a id="gaa64a145a554f1e5077848938d7f39c92" name="gaa64a145a554f1e5077848938d7f39c92"></a>
 418 <h2 class="memtitle"><span class="permalink"><a href="#gaa64a145a554f1e5077848938d7f39c92">&#9670;&#160;</a></span>OS_Tick_GetCount()</h2>
 419
 420 <div class="memitem">
 421 <div class="memproto">
 422       <table class="memname">
 423         <tr>
 424           <td class="memname">uint32_t OS_Tick_GetCount </td>
 425           <td>(</td>
 426           <td class="paramtype">void&#160;</td>
 427           <td class="paramname"></td><td>)</td>
 428           <td></td>
 429         </tr>
 430       </table>
 431 </div><div class="memdoc">
 432 <dl class="section return"><dt>Returns</dt><dd>OS Tick timer counter value</dd></dl>
 433 <p>Get OS Tick timer counter value.</p>
 434 <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>
 435 <p><b>Cortex-M SysTick implementation:</b></p>
 436 <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>
 437 <div class="line">  uint32_t val;</div>
 438 <div class="line">  uint32_t count;</div>
 439 <div class="line"> </div>
 440 <div class="line">  val = SysTick-&gt;VAL;</div>
 441 <div class="line">  <span class="keywordflow">if</span> (val != 0U) {</div>
 442 <div class="line">    count = (SysTick-&gt;LOAD - val) + 1U;</div>
 443 <div class="line">  } <span class="keywordflow">else</span> {</div>
 444 <div class="line">    count = 0U;</div>
 445 <div class="line">  }</div>
 446 <div class="line"> </div>
 447 <div class="line">  <span class="keywordflow">return</span> (count);</div>
 448 <div class="line">}</div>
 449 <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>
 450 </div><!-- fragment -->
 451 </div>
 452 </div>
 453 <a id="ga1f9a593126b7f0b66fc526c2cebd6192" name="ga1f9a593126b7f0b66fc526c2cebd6192"></a>
 454 <h2 class="memtitle"><span class="permalink"><a href="#ga1f9a593126b7f0b66fc526c2cebd6192">&#9670;&#160;</a></span>OS_Tick_GetOverflow()</h2>
 455
 456 <div class="memitem">
 457 <div class="memproto">
 458       <table class="memname">
 459         <tr>
 460           <td class="memname">OS_Tick_GetOverflow </td>
 461           <td>(</td>
 462           <td class="paramtype">void&#160;</td>
 463           <td class="paramname"></td><td>)</td>
 464           <td></td>
 465         </tr>
 466       </table>
 467 </div><div class="memdoc">
 468 <dl class="section return"><dt>Returns</dt><dd>OS Tick overflow status (1 - overflow, 0 - no overflow).</dd></dl>
 469 <p>Get OS Tick timer overflow status.</p>
 470 <p>Return the state of OS Tick timer interrupt pending bit that indicates timer overflows to adjust SysTimer calculations.</p>
 471 <p><b>Cortex-M SysTick implementation:</b></p>
 472 <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>
 473 <div class="line">  <span class="keywordflow">return</span> ((SCB-&gt;ICSR &amp; SCB_ICSR_PENDSTSET_Msk) &gt;&gt; SCB_ICSR_PENDSTSET_Pos);</div>
 474 <div class="line">}</div>
 475 <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>
 476 </div><!-- fragment -->
 477 </div>
 478 </div>
 479 </div><!-- contents -->
 480 </div><!-- doc-content -->
 481 <!-- start footer part -->
 482 <div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
 483   <ul>
 484     <li class="footer">
 485       <script type="text/javascript">
 486         <!--
 487         writeFooter.call(this);
 488         //-->
 489       </script>
 490     </li>
 491   </ul>
 492 </div>
 493 </body>
 494 </html>