begriffs open source - cmsis-driver-validation/blob - docs/html/group__usart__tests__drv__mgmt.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
   2 <html xmlns="http://www.w3.org/1999/xhtml">
   3 <head>
   4 <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
   5 <meta http-equiv="X-UA-Compatible" content="IE=9"/>
   6 <title>Driver Management</title>
   7 <title>CMSIS-Driver Validation: Driver Management</title>
   8 <link href="tabs.css" rel="stylesheet" type="text/css"/>
   9 <link href="drv.css" rel="stylesheet" type="text/css" />
  10 <script type="text/javascript" src="jquery.js"></script>
  11 <script type="text/javascript" src="dynsections.js"></script>
  12 <script type="text/javascript" src="printComponentTabs.js"></script>
  13 <link href="navtree.css" rel="stylesheet" type="text/css"/>
  14 <script type="text/javascript" src="resize.js"></script>
  15 <script type="text/javascript" src="navtree.js"></script>
  16 <script type="text/javascript">
  17   $(document).ready(initResizable);
  18   $(window).load(resizeHeight);
  19 </script>
  20 <link href="search/search.css" rel="stylesheet" type="text/css"/>
  21 <script type="text/javascript" src="search/search.js"></script>
  22 <script type="text/javascript">
  23   $(document).ready(function() { searchBox.OnSelectItem(0); });
  24 </script>
  25 <link href="stylsheetf" rel="stylesheet" type="text/css" />
  26 </head>
  27 <body>
  28 <div id="top"><!-- do not remove this div, it is closed by doxygen! -->
  29 <div id="titlearea">
  30 <table cellspacing="0" cellpadding="0">
  31  <tbody>
  32  <tr style="height: 46px;">
  33   <td id="projectlogo"><img alt="Logo" src="keilarm.png"/></td>
  34   <td style="padding-left: 0.5em;">
  35    <div id="projectname">CMSIS-Driver Validation
  36    &#160;<span id="projectnumber">Version 3.0.0</span>
  37    </div>
  38    <div id="projectbrief">Driver Validation</div>
  39   </td>
  40  </tr>
  41  </tbody>
  42 </table>
  43 </div>
  44 <!-- end header part -->
  45 <div id="DRVnav" class="tabs1">
  46     <ul class="tablist">
  47       <script type="text/javascript">
  48                 <!--
  49                 writeComponentTabs.call(this);
  50                 //-->
  51       </script>
  52           </ul>
  53 </div>
  54 <!-- Generated by Doxygen 1.8.6 -->
  55 <script type="text/javascript">
  56 var searchBox = new SearchBox("searchBox", "search",false,'Search');
  57 </script>
  58   <div id="navrow1" class="tabs">
  59     <ul class="tablist">
  60       <li><a href="index.html"><span>Main&#160;Page</span></a></li>
  61       <li><a href="pages.html"><span>Usage&#160;and&#160;Description</span></a></li>
  62       <li><a href="modules.html"><span>Reference</span></a></li>
  63       <li>
  64         <div id="MSearchBox" class="MSearchBoxInactive">
  65         <span class="left">
  66           <img id="MSearchSelect" src="search/mag_sel.png"
  67                onmouseover="return searchBox.OnSearchSelectShow()"
  68                onmouseout="return searchBox.OnSearchSelectHide()"
  69                alt=""/>
  70           <input type="text" id="MSearchField" value="Search" accesskey="S"
  71                onfocus="searchBox.OnSearchFieldFocus(true)"
  72                onblur="searchBox.OnSearchFieldFocus(false)"
  73                onkeyup="searchBox.OnSearchFieldChange(event)"/>
  74           </span><span class="right">
  75             <a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
  76           </span>
  77         </div>
  78       </li>
  79     </ul>
  80   </div>
  81 </div><!-- top -->
  82 <div id="side-nav" class="ui-resizable side-nav-resizable">
  83   <div id="nav-tree">
  84     <div id="nav-tree-contents">
  85       <div id="nav-sync" class="sync"></div>
  86     </div>
  87   </div>
  88   <div id="splitbar" style="-moz-user-select:none;"
  89        class="ui-resizable-handle">
  90   </div>
  91 </div>
  92 <script type="text/javascript">
  93 $(document).ready(function(){initNavTree('group__usart__tests__drv__mgmt.html','');});
  94 </script>
  95 <div id="doc-content">
  96 <!-- window showing the filter options -->
  97 <div id="MSearchSelectWindow"
  98      onmouseover="return searchBox.OnSearchSelectShow()"
  99      onmouseout="return searchBox.OnSearchSelectHide()"
 100      onkeydown="return searchBox.OnSearchSelectKey(event)">
 101 <a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(0)"><span class="SelectionMark">&#160;</span>All</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(1)"><span class="SelectionMark">&#160;</span>Files</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(2)"><span class="SelectionMark">&#160;</span>Functions</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(3)"><span class="SelectionMark">&#160;</span>Variables</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(4)"><span class="SelectionMark">&#160;</span>Macros</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(5)"><span class="SelectionMark">&#160;</span>Groups</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(6)"><span class="SelectionMark">&#160;</span>Pages</a></div>
 102
 103 <!-- iframe showing the search results (closed by default) -->
 104 <div id="MSearchResultsWindow">
 105 <iframe src="javascript:void(0)" frameborder="0"
 106         name="MSearchResults" id="MSearchResults">
 107 </iframe>
 108 </div>
 109
 110 <div class="header">
 111   <div class="summary">
 112 <a href="#func-members">Functions</a>  </div>
 113   <div class="headertitle">
 114 <div class="title">Driver Management<div class="ingroups"><a class="el" href="group__usart__tests.html">Tests</a></div></div>  </div>
 115 </div><!--header-->
 116 <div class="contents">
 117 <table class="memberdecls">
 118 <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="func-members"></a>
 119 Functions</h2></td></tr>
 120 <tr class="memitem:ga0dab21ba670a410575aec5fcd97b4a93"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__usart__tests__drv__mgmt.html#ga0dab21ba670a410575aec5fcd97b4a93">USART_GetVersion</a> (void)</td></tr>
 121 <tr class="memdesc:ga0dab21ba670a410575aec5fcd97b4a93"><td class="mdescLeft">&#160;</td><td class="mdescRight">Function: Function USART_GetVersion.  <a href="#ga0dab21ba670a410575aec5fcd97b4a93">More...</a><br/></td></tr>
 122 <tr class="separator:ga0dab21ba670a410575aec5fcd97b4a93"><td class="memSeparator" colspan="2">&#160;</td></tr>
 123 <tr class="memitem:ga037e730d991dec7457bb6c772591b030"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__usart__tests__drv__mgmt.html#ga037e730d991dec7457bb6c772591b030">USART_GetCapabilities</a> (void)</td></tr>
 124 <tr class="memdesc:ga037e730d991dec7457bb6c772591b030"><td class="mdescLeft">&#160;</td><td class="mdescRight">Function: Function USART_GetCapabilities.  <a href="#ga037e730d991dec7457bb6c772591b030">More...</a><br/></td></tr>
 125 <tr class="separator:ga037e730d991dec7457bb6c772591b030"><td class="memSeparator" colspan="2">&#160;</td></tr>
 126 <tr class="memitem:gae1bab8095aea7b1c0c0abb233ea91ffa"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__usart__tests__drv__mgmt.html#gae1bab8095aea7b1c0c0abb233ea91ffa">USART_Initialize_Uninitialize</a> (void)</td></tr>
 127 <tr class="memdesc:gae1bab8095aea7b1c0c0abb233ea91ffa"><td class="mdescLeft">&#160;</td><td class="mdescRight">Function: Function USART_Initialize_Uninitialize.  <a href="#gae1bab8095aea7b1c0c0abb233ea91ffa">More...</a><br/></td></tr>
 128 <tr class="separator:gae1bab8095aea7b1c0c0abb233ea91ffa"><td class="memSeparator" colspan="2">&#160;</td></tr>
 129 <tr class="memitem:ga6230d1a7f159dd1ffbb68cc3f24af71c"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__usart__tests__drv__mgmt.html#ga6230d1a7f159dd1ffbb68cc3f24af71c">USART_PowerControl</a> (void)</td></tr>
 130 <tr class="memdesc:ga6230d1a7f159dd1ffbb68cc3f24af71c"><td class="mdescLeft">&#160;</td><td class="mdescRight">Function: Function USART_PowerControl.  <a href="#ga6230d1a7f159dd1ffbb68cc3f24af71c">More...</a><br/></td></tr>
 131 <tr class="separator:ga6230d1a7f159dd1ffbb68cc3f24af71c"><td class="memSeparator" colspan="2">&#160;</td></tr>
 132 </table>
 133 <a name="details" id="details"></a><h2 class="groupheader">Description</h2>
 134 <p>These tests verify API and operation of the USART driver management functions.</p>
 135 <p>The driver management tests verify the following driver functions (<a href="http://www.keil.com/pack/doc/CMSIS/Driver/html/group__usart__interface__gr.html" target="_blank">USART Driver function documentation</a>):</p>
 136 <ul>
 137 <li><b>GetVersion</b> <div class="fragment"><div class="line">ARM_DRIVER_VERSION     GetVersion      (<span class="keywordtype">void</span>);</div>
 138 </div><!-- fragment --></li>
 139 <li><b>GetCapabilities</b> <div class="fragment"><div class="line">ARM_USART_CAPABILITIES GetCapabilities (<span class="keywordtype">void</span>);</div>
 140 </div><!-- fragment --></li>
 141 <li><b>Initialize</b> <div class="fragment"><div class="line">int32_t                Initialize      (ARM_USART_SignalEvent_t cb_event);</div>
 142 </div><!-- fragment --></li>
 143 <li><b>Uninitialize</b> <div class="fragment"><div class="line">int32_t                Uninitialize    (<span class="keywordtype">void</span>);</div>
 144 </div><!-- fragment --></li>
 145 <li><b>PowerControl</b> <div class="fragment"><div class="line">int32_t                PowerControl    (ARM_POWER_STATE state);</div>
 146 </div><!-- fragment --> </li>
 147 </ul>
 148 <h2 class="groupheader">Function Documentation</h2>
 149 <a class="anchor" id="ga0dab21ba670a410575aec5fcd97b4a93"></a>
 150 <div class="memitem">
 151 <div class="memproto">
 152       <table class="memname">
 153         <tr>
 154           <td class="memname">void USART_GetVersion </td>
 155           <td>(</td>
 156           <td class="paramtype">void&#160;</td>
 157           <td class="paramname"></td><td>)</td>
 158           <td></td>
 159         </tr>
 160       </table>
 161 </div><div class="memdoc">
 162 <p>The function <b>UDSART_GetVersion</b> verifies the <b>GetVersion</b> function. </p>
 163 <div class="fragment"><div class="line">ARM_DRIVER_VERSION GetVersion (<span class="keywordtype">void</span>);</div>
 164 </div><!-- fragment --><p>Testing sequence:</p>
 165 <ul>
 166 <li>Driver is uninitialized and peripheral is powered-off:<ul>
 167 <li>Call GetVersion function</li>
 168 <li>Assert that GetVersion function returned version structure with API and implementation versions higher or equal to 1.0 </li>
 169 </ul>
 170 </li>
 171 </ul>
 172
 173 </div>
 174 </div>
 175 <a class="anchor" id="ga037e730d991dec7457bb6c772591b030"></a>
 176 <div class="memitem">
 177 <div class="memproto">
 178       <table class="memname">
 179         <tr>
 180           <td class="memname">void USART_GetCapabilities </td>
 181           <td>(</td>
 182           <td class="paramtype">void&#160;</td>
 183           <td class="paramname"></td><td>)</td>
 184           <td></td>
 185         </tr>
 186       </table>
 187 </div><div class="memdoc">
 188 <p>The function <b>USART_GetCapabilities</b> verifies the <b>GetCapabilities</b> function. </p>
 189 <div class="fragment"><div class="line">ARM_USART_CAPABILITIES GetCapabilities (<span class="keywordtype">void</span>);</div>
 190 </div><!-- fragment --><p>Testing sequence:</p>
 191 <ul>
 192 <li>Driver is uninitialized and peripheral is powered-off:<ul>
 193 <li>Call GetCapabilities function</li>
 194 <li>Assert that GetCapabilities function returned capabilities structure with reserved field 0 </li>
 195 </ul>
 196 </li>
 197 </ul>
 198
 199 </div>
 200 </div>
 201 <a class="anchor" id="gae1bab8095aea7b1c0c0abb233ea91ffa"></a>
 202 <div class="memitem">
 203 <div class="memproto">
 204       <table class="memname">
 205         <tr>
 206           <td class="memname">void USART_Initialize_Uninitialize </td>
 207           <td>(</td>
 208           <td class="paramtype">void&#160;</td>
 209           <td class="paramname"></td><td>)</td>
 210           <td></td>
 211         </tr>
 212       </table>
 213 </div><div class="memdoc">
 214 <p>The function <b>USART_Initialize_Uninitialize</b> verifies the <b>Initialize</b> and <b>Uninitialize</b> functions. </p>
 215 <div class="fragment"><div class="line">int32_t Initialize (ARM_USART_SignalEvent_t cb_event);</div>
 216 </div><!-- fragment --> <div class="fragment"><div class="line">int32_t Uninitialize (<span class="keywordtype">void</span>);</div>
 217 </div><!-- fragment --><p>Testing sequence:</p>
 218 <ul>
 219 <li>Driver is uninitialized and peripheral is powered-off:<ul>
 220 <li>Call PowerControl(ARM_POWER_FULL) function and assert that it returned ARM_DRIVER_ERROR status</li>
 221 <li>Call PowerControl(ARM_POWER_LOW) function and assert that it returned ARM_DRIVER_ERROR status</li>
 222 <li>Call PowerControl(ARM_POWER_OFF) function and assert that it returned ARM_DRIVER_ERROR status</li>
 223 <li>Call Send function and assert that it returned ARM_DRIVER_ERROR status</li>
 224 <li>Call Receive function and assert that it returned ARM_DRIVER_ERROR status</li>
 225 <li>Call Transfer function and assert that it returned ARM_DRIVER_ERROR status</li>
 226 <li>Call GetTxCount function and assert that it returned 0</li>
 227 <li>Call GetRxCount function and assert that it returned 0</li>
 228 <li>Call Control function and assert that it returned ARM_DRIVER_ERROR status</li>
 229 <li>Call GetStatus function</li>
 230 <li>Assert that GetStatus function returned status structure with tx_busy flag 0</li>
 231 <li>Assert that GetStatus function returned status structure with rx_busy flag 0</li>
 232 <li>Assert that GetStatus function returned status structure with tx_underflow flag 0</li>
 233 <li>Assert that GetStatus function returned status structure with rx_overflow flag 0</li>
 234 <li>Assert that GetStatus function returned status structure with rx_break flag 0</li>
 235 <li>Assert that GetStatus function returned status structure with rx_framing_error flag 0</li>
 236 <li>Assert that GetStatus function returned status structure with rx_parity_error flag 0</li>
 237 <li>Assert that GetStatus function returned status structure with reserved field 0</li>
 238 <li>Call Initialize function (without callback specified) and assert that it returned ARM_DRIVER_OK status</li>
 239 </ul>
 240 </li>
 241 <li>Driver is initialized and peripheral is powered-off:<ul>
 242 <li>Call Initialize function (without callback specified) again and assert that it returned ARM_DRIVER_OK status</li>
 243 <li>Call Uninitialize function and assert that it returned ARM_DRIVER_OK status</li>
 244 </ul>
 245 </li>
 246 <li>Driver is uninitialized and peripheral is powered-off:<ul>
 247 <li>Call Initialize function (with callback specified) and assert that it returned ARM_DRIVER_OK status</li>
 248 </ul>
 249 </li>
 250 <li>Driver is initialized and peripheral is powered-off:<ul>
 251 <li>Call Initialize function (with callback specified) again and assert that it returned ARM_DRIVER_OK status</li>
 252 <li>Call Uninitialize function and assert that it returned ARM_DRIVER_OK status</li>
 253 </ul>
 254 </li>
 255 <li>Driver is uninitialized and peripheral is powered-off:<ul>
 256 <li>Call Uninitialize function again and assert that it returned ARM_DRIVER_OK status</li>
 257 <li>Call Initialize function (without callback specified) and assert that it returned ARM_DRIVER_OK status</li>
 258 </ul>
 259 </li>
 260 <li>Driver is initialized and peripheral is powered-off:<ul>
 261 <li>Call PowerControl(ARM_POWER_FULL) function and assert that it returned ARM_DRIVER_OK status</li>
 262 </ul>
 263 </li>
 264 <li>Driver is initialized and peripheral is powered-on:<ul>
 265 <li>Call Control function and assert that it returned ARM_DRIVER_OK status</li>
 266 <li>Call Uninitialize function and assert that it returned ARM_DRIVER_OK status<br/>
 267  (this must unconditionally terminate active send/receive/transfer, power-off the peripheral and uninitialize the driver)</li>
 268 </ul>
 269 </li>
 270 <li>Driver is uninitialized and peripheral is powered-off:<ul>
 271 <li>Call GetStatus function</li>
 272 <li>Assert that GetStatus function returned status structure with tx_busy flag 0</li>
 273 <li>Assert that GetStatus function returned status structure with rx_busy flag 0 </li>
 274 </ul>
 275 </li>
 276 </ul>
 277
 278 </div>
 279 </div>
 280 <a class="anchor" id="ga6230d1a7f159dd1ffbb68cc3f24af71c"></a>
 281 <div class="memitem">
 282 <div class="memproto">
 283       <table class="memname">
 284         <tr>
 285           <td class="memname">void USART_PowerControl </td>
 286           <td>(</td>
 287           <td class="paramtype">void&#160;</td>
 288           <td class="paramname"></td><td>)</td>
 289           <td></td>
 290         </tr>
 291       </table>
 292 </div><div class="memdoc">
 293 <p>The function <b>USART_PowerControl</b> verifies the <b>PowerControl</b> function. </p>
 294 <div class="fragment"><div class="line">int32_t PowerControl (ARM_POWER_STATE state);</div>
 295 </div><!-- fragment --><p>Testing sequence:</p>
 296 <ul>
 297 <li>Driver is initialized and peripheral is powered-off:<ul>
 298 <li>Call Send function and assert that it returned ARM_DRIVER_ERROR status</li>
 299 <li>Call Receive function and assert that it returned ARM_DRIVER_ERROR status</li>
 300 <li>Call Transfer function and assert that it returned ARM_DRIVER_ERROR status</li>
 301 <li>Call GetTxCount function and assert that it returned 0</li>
 302 <li>Call GetRxCount function and assert that it returned 0</li>
 303 <li>Call Control function and assert that it returned ARM_DRIVER_ERROR status</li>
 304 <li>Call GetStatus function</li>
 305 <li>Assert that GetStatus function returned status structure with tx_busy flag 0</li>
 306 <li>Assert that GetStatus function returned status structure with rx_busy flag 0</li>
 307 <li>Assert that GetStatus function returned status structure with tx_underflow flag 0</li>
 308 <li>Assert that GetStatus function returned status structure with rx_overflow flag 0</li>
 309 <li>Assert that GetStatus function returned status structure with rx_break flag 0</li>
 310 <li>Assert that GetStatus function returned status structure with rx_framing_error flag 0</li>
 311 <li>Assert that GetStatus function returned status structure with rx_parity_error flag 0</li>
 312 <li>Assert that GetStatus function returned status structure with reserved field 0</li>
 313 <li>Call PowerControl(ARM_POWER_OFF) and assert that it returned ARM_DRIVER_OK status</li>
 314 <li>Call PowerControl(ARM_POWER_OFF) again and assert that it returned ARM_DRIVER_OK status</li>
 315 <li>Call PowerControl(ARM_POWER_FULL) function and assert that it returned ARM_DRIVER_OK status</li>
 316 </ul>
 317 </li>
 318 <li>Driver is initialized and peripheral is powered-on:<ul>
 319 <li>Call PowerControl(ARM_POWER_FULL) function again and assert that it returned ARM_DRIVER_OK status</li>
 320 <li>Call PowerControl(ARM_POWER_OFF) and assert that it returned ARM_DRIVER_OK status</li>
 321 </ul>
 322 </li>
 323 <li>Driver is initialized and peripheral is powered-off:<ul>
 324 <li>Call PowerControl(ARM_POWER_OFF) again and assert that it returned ARM_DRIVER_OK status</li>
 325 <li>Call PowerControl(ARM_POWER_LOW) function</li>
 326 </ul>
 327 </li>
 328 <li>Driver is initialized and peripheral is powered-on or in low-power mode:<ul>
 329 <li>Assert that PowerControl(ARM_POWER_LOW) function returned ARM_DRIVER_OK or ARM_DRIVER_ERROR_UNSUPPORTED status</li>
 330 <li>Call PowerControl(ARM_POWER_FULL) function and assert that it returned ARM_DRIVER_OK status</li>
 331 </ul>
 332 </li>
 333 <li>Driver is initialized and peripheral is powered-on:<ul>
 334 <li>Call Control function and assert that it returned ARM_DRIVER_OK status</li>
 335 <li>Call PowerControl(ARM_POWER_OFF) function and assert that it returned ARM_DRIVER_OK status<br/>
 336  (this must unconditionally terminate active send/receive/transfer and power-off the peripheral)</li>
 337 </ul>
 338 </li>
 339 <li>Driver is initialized and peripheral is powered-off:<ul>
 340 <li>Call GetStatus function</li>
 341 <li>Assert that GetStatus function returned status structure with tx_busy flag 0</li>
 342 <li>Assert that GetStatus function returned status structure with rx_busy flag 0 </li>
 343 </ul>
 344 </li>
 345 </ul>
 346
 347 </div>
 348 </div>
 349 </div><!-- contents -->
 350 </div><!-- doc-content -->
 351 <!-- start footer part -->
 352 <div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
 353   <ul>
 354     <li class="footer">Generated on Fri Jul 15 2022 08:42:09 for CMSIS-Driver Validation by ARM Ltd. All rights reserved.
 355         <!--
 356     <a href="http://www.doxygen.org/index.html">
 357     <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.8.6
 358         -->
 359         </li>
 360   </ul>
 361 </div>
 362 </body>
 363 </html>