begriffs open source - cmsis/blob - dev/v6.0.0-dev53/Driver/html/theoryOperation.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-Driver: Theory of Operation</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-Driver
  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">Peripheral Interface for Middleware and Application Code</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('theoryOperation.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><div class="header">
 130   <div class="headertitle"><div class="title">Theory of Operation </div></div>
 131 </div><!--header-->
 132 <div class="contents">
 133 <div class="toc"><h3>Table of Contents</h3>
 134 <ul><li class="level1"><a href="#DriverFunctions">Common Driver Functions</a></li>
 135 <li class="level1"><a href="#ProcessorMode">Cortex-M Processor Mode</a></li>
 136 <li class="level1"><a href="#CallSequence">Function Call Sequence</a><ul><li class="level2"><a href="#CS_start">Start Sequence</a></li>
 137 <li class="level2"><a href="#CS_stop">Stop Sequence</a></li>
 138 </ul>
 139 </li>
 140 <li class="level1"><a href="#Share_IO">Shared I/O Pins</a></li>
 141 <li class="level1"><a href="#Data_Xfer_Functions">Data Transfer Functions</a></li>
 142 <li class="level1"><a href="#AccessStruct">Access Struct</a><ul><li class="level2"><a href="#DriverInstances">Driver Instances</a></li>
 143 </ul>
 144 </li>
 145 <li class="level1"><a href="#cmsis_driver_files">CMSIS-Driver Files</a></li>
 146 <li class="level1"><a href="#DriverConfiguration">Driver Configuration</a></li>
 147 <li class="level1"><a href="#CodeExample">Code Example</a></li>
 148 </ul>
 149 </div>
 150 <div class="textblock"><p><a class="anchor" id="md_src_operation"></a></p>
 151 <p>This section gives an overview of the general operation of CMSIS-Drivers. It explains the <a class="el" href="theoryOperation.html#DriverFunctions">Common Driver Functions</a> that are common in all CMSIS-Drivers along with the <a class="el" href="theoryOperation.html#CallSequence">Function Call Sequence</a>. The topic <a class="el" href="theoryOperation.html#Data_Xfer_Functions">Data Transfer Functions</a> describes how data read/write operations to the peripheral are implemented.</p>
 152 <p>Each CMSIS-Driver defines an <a class="el" href="theoryOperation.html#AccessStruct">Access Struct</a> for calling the various driver functions and each peripheral (that is accessed via a CMSIS-Driver) has one <a class="el" href="theoryOperation.html#DriverInstances">Driver Instance</a>.</p>
 153 <h1><a class="anchor" id="DriverFunctions"></a>
 154 Common Driver Functions</h1>
 155 <p>Each CMSIS-Driver contains these functions:</p>
 156 <ul>
 157 <li><code>GetVersion</code>: can be called at any time to obtain version information of the driver interface.</li>
 158 <li><code>GetCapabilities</code>: can be called at any time to obtain capabilities of the driver interface.</li>
 159 <li><code>Initialize</code>: must be called before powering the peripheral using <code>PowerControl</code>. This function performs the following:<ul>
 160 <li>allocate I/O resources.</li>
 161 <li>register an optional <code>SignalEvent</code> callback function.</li>
 162 </ul>
 163 </li>
 164 <li><code>SignalEvent</code>: is an optional callback function that is registered with the <code>Initialize</code> function. This callback function is initiated from interrupt service routines and indicates hardware events or the completion of a data block transfer operation.</li>
 165 <li><code>PowerControl</code>: Controls the power profile of the peripheral and needs to be called after <code>Initialize</code>. Typically, three power options are available (see <a class="el" href="group__common__drv__gr.html#ga47d6d7c31f88f3b8ae4aaf9d8444afa5">ARM_POWER_STATE</a>):<ul>
 166 <li><code>ARM_POWER_FULL</code>: Peripheral is turned on and fully operational. The driver initializes the peripheral registers, interrupts, and (optionally) DMA.</li>
 167 <li><code>ARM_POWER_LOW</code> : (optional) Peripheral is in low power mode and partially operational; usually, it can detect external events and wake-up.</li>
 168 <li><code>ARM_POWER_OFF</code>: Peripheral is turned off and not operational (pending operations are terminated). This is the state after device reset.</li>
 169 </ul>
 170 </li>
 171 <li><code>Uninitialize</code>: Complementary function to Initialize. Releases the I/O pin resources used by the interface.</li>
 172 <li><code>Control</code>: Several drivers provide a control function to configure communication parameters or execute miscellaneous control functions.</li>
 173 </ul>
 174 <p>The section <a class="el" href="theoryOperation.html#CallSequence">Function Call Sequence</a> contains more information on the operation of each function. Additional functions are specific to each driver interface and are described in the individual sections of each driver.</p>
 175 <h1><a class="anchor" id="ProcessorMode"></a>
 176 Cortex-M Processor Mode</h1>
 177 <p>The CMSIS-Driver functions access peripherals and interrupts and are designed to execute in <b>Privileged</b> mode. When calling CMSIS-Driver functions from RTOS threads, it should be ensure that these threads execute in <b>Privileged</b> mode.</p>
 178 <h1><a class="anchor" id="CallSequence"></a>
 179 Function Call Sequence</h1>
 180 <p>For normal operation of the driver, the API functions <code>GetVersion</code>, <code>GetCapabilities</code>, <code>Initialize</code>, <code>PowerControl</code>, <code>Uninitialize</code> are called in the following order:</p>
 181 <div class="mscgraph">
 182 <img src="msc_inline_mscgraph_1.png" alt="msc_inline_mscgraph_1" border="0"/>
 183 </div>
 184 <p>The functions <code>GetVersion</code> and <code>GetCapabilities</code> can be called any time to obtain the required information from the driver. These functions return always the same information.</p>
 185 <h2><a class="anchor" id="CS_start"></a>
 186 Start Sequence</h2>
 187 <p>To start working with a peripheral the functions <code>Initialize</code> and <code>PowerControl</code> need to be called in this order: </p><div class="fragment"><div class="line">drv-&gt;Initialize (...);                 <span class="comment">// Allocate I/O pins</span></div>
 188 <div class="line">drv-&gt;PowerControl (<a class="code hl_enumvalue" href="Driver__Common_8h.html#ga47d6d7c31f88f3b8ae4aaf9d8444afa5abed52b77a9ce4775570e44a842b1295e">ARM_POWER_FULL</a>);    <span class="comment">// Power up peripheral, setup IRQ/DMA</span></div>
 189 <div class="ttc" id="aDriver__Common_8h_html_ga47d6d7c31f88f3b8ae4aaf9d8444afa5abed52b77a9ce4775570e44a842b1295e"><div class="ttname"><a href="Driver__Common_8h.html#ga47d6d7c31f88f3b8ae4aaf9d8444afa5abed52b77a9ce4775570e44a842b1295e">ARM_POWER_FULL</a></div><div class="ttdeci">@ ARM_POWER_FULL</div><div class="ttdoc">Power on: full operation at maximum performance.</div><div class="ttdef"><b>Definition:</b> Driver_Common.h:66</div></div>
 190 </div><!-- fragment --><ul>
 191 <li><code>Initialize</code> typically allocates the I/O resources (pins) for the peripheral. The function can be called multiple times; if the I/O resources are already initialized it performs no operation and just returns with <a class="el" href="group__execution__status.html#ga85752c5de59e8adeb001e35ff5be6be7">ARM_DRIVER_OK</a>.</li>
 192 <li><code>PowerControl</code> (<code>ARM_POWER_FULL</code>) sets the peripheral registers including interrupt (NVIC) and optionally DMA. The function can be called multiple times; if the registers are already set it performs no operation and just returns with <a class="el" href="group__execution__status.html#ga85752c5de59e8adeb001e35ff5be6be7">ARM_DRIVER_OK</a>.</li>
 193 </ul>
 194 <h2><a class="anchor" id="CS_stop"></a>
 195 Stop Sequence</h2>
 196 <p>To stop working with a peripheral the functions <code>PowerControl</code> and <code>Uninitialize</code> need to be called in this order: </p><div class="fragment"><div class="line">drv-&gt;PowerControl (<a class="code hl_enumvalue" href="Driver__Common_8h.html#ga47d6d7c31f88f3b8ae4aaf9d8444afa5ab6f5becc85ebd51c3dd2524a95d2ca35">ARM_POWER_OFF</a>);     <span class="comment">// Terminate any pending transfers, reset IRQ/DMA, power off peripheral</span></div>
 197 <div class="line">drv-&gt;Uninitialize (...);               <span class="comment">// Release I/O pins</span></div>
 198 <div class="ttc" id="aDriver__Common_8h_html_ga47d6d7c31f88f3b8ae4aaf9d8444afa5ab6f5becc85ebd51c3dd2524a95d2ca35"><div class="ttname"><a href="Driver__Common_8h.html#ga47d6d7c31f88f3b8ae4aaf9d8444afa5ab6f5becc85ebd51c3dd2524a95d2ca35">ARM_POWER_OFF</a></div><div class="ttdeci">@ ARM_POWER_OFF</div><div class="ttdoc">Power off: no operation possible.</div><div class="ttdef"><b>Definition:</b> Driver_Common.h:64</div></div>
 199 </div><!-- fragment --><p>The functions <code>PowerControl</code> and <code>Uninitialize</code> always execute and can be used to put the peripheral into a <b>Safe State</b>, for example after any data transmission errors. To restart the peripheral in a error condition, you should first execute the <a class="el" href="theoryOperation.html#CS_stop">Stop Sequence</a> and then the <a class="el" href="theoryOperation.html#CS_start">Start Sequence</a>.</p>
 200 <ul>
 201 <li><code>PowerControl</code> (<code>ARM_POWER_OFF</code>) terminates any pending data transfers with the peripheral, disables the peripheral and leaves it in a defined mode (typically the reset state).<ul>
 202 <li>when DMA is used it is disabled (including the interrupts)</li>
 203 <li>peripheral interrupts are disabled on NVIC level</li>
 204 <li>the peripheral is reset using a dedicated reset mechanism (if available) or by clearing the peripheral registers</li>
 205 <li>pending peripheral interrupts are cleared on NVIC level</li>
 206 <li>driver variables are cleared</li>
 207 </ul>
 208 </li>
 209 <li><code>Uninitialize</code> always releases I/O pin resources.</li>
 210 </ul>
 211 <h1><a class="anchor" id="Share_IO"></a>
 212 Shared I/O Pins</h1>
 213 <p>All CMSIS-Driver provide a <a class="el" href="theoryOperation.html#CS_start">Start Sequence</a> and <a class="el" href="theoryOperation.html#CS_stop">Stop Sequence</a>. Therefore two different drivers can share the same I/O pins, for example UART1 and SPI1 can have overlapping I/O pins. In this case the communication channels can be used as shown below:</p>
 214 <div class="fragment"><div class="line">SPI1drv-&gt;Initialize (...);                <span class="comment">// Start SPI1</span></div>
 215 <div class="line">SPI1drv-&gt;PowerControl (<a class="code hl_enumvalue" href="Driver__Common_8h.html#ga47d6d7c31f88f3b8ae4aaf9d8444afa5abed52b77a9ce4775570e44a842b1295e">ARM_POWER_FULL</a>);</div>
 216 <div class="line"> ...                                      <span class="comment">// Do operations with SPI1</span></div>
 217 <div class="line">SPI1drv-&gt;PowerControl (<a class="code hl_enumvalue" href="Driver__Common_8h.html#ga47d6d7c31f88f3b8ae4aaf9d8444afa5ab6f5becc85ebd51c3dd2524a95d2ca35">ARM_POWER_OFF</a>);    <span class="comment">// Stop SPI1</span></div>
 218 <div class="line">SPI1drv-&gt;Uninitialize ();</div>
 219 <div class="line"> ...</div>
 220 <div class="line">USART1drv-&gt;Initialize (...);              <span class="comment">// Start USART1</span></div>
 221 <div class="line">USART1drv-&gt;PowerControl (<a class="code hl_enumvalue" href="Driver__Common_8h.html#ga47d6d7c31f88f3b8ae4aaf9d8444afa5abed52b77a9ce4775570e44a842b1295e">ARM_POWER_FULL</a>);</div>
 222 <div class="line"> ...                                      <span class="comment">// Do operations with USART1</span></div>
 223 <div class="line">USART1drv-&gt;PowerControl (<a class="code hl_enumvalue" href="Driver__Common_8h.html#ga47d6d7c31f88f3b8ae4aaf9d8444afa5ab6f5becc85ebd51c3dd2524a95d2ca35">ARM_POWER_OFF</a>);  <span class="comment">// Stop USART1</span></div>
 224 <div class="line">USART1drv-&gt;Uninitialize ();</div>
 225 </div><!-- fragment --><h1><a class="anchor" id="Data_Xfer_Functions"></a>
 226 Data Transfer Functions</h1>
 227 <p>A CMSIS-Driver implements non-blocking functions to transfer data to a peripheral. This means that the driver configures the read or write access to the peripheral and instantly returns to the calling application. The function names for data transfer end with:</p><ul>
 228 <li><code>Send</code> to write data to a peripheral.</li>
 229 <li><code>Receive</code> to read data from a peripheral.</li>
 230 <li><code>Transfer</code> to indicate combined read/write operations to a peripheral.</li>
 231 </ul>
 232 <p>During a data transfer, the application can query the number of transferred data items using functions named <b>Get<em>xxx</em>Count</b>. On completion of a data transfer, the driver calls a callback function with a specific event code.</p>
 233 <p>During the data exchange with the peripheral, the application can decide to:</p><ul>
 234 <li>Wait (using an RTOS scheduler) for the callback completion event. The RTOS is controlled by the application code which makes the driver itself RTOS independent.</li>
 235 <li>Use polling functions that return the number of transferred data items to show progress information or partly read or fill data transfer buffers.</li>
 236 <li>Prepare another data transfer buffer for the next data transfer.</li>
 237 </ul>
 238 <p>The following diagram shows the basic communication flow when using the <code>_Send</code> function in an application.</p>
 239 <div class="image">
 240 <img src="Non_blocking_transmit_small.png" alt=""/>
 241 <div class="caption">
 242 Non-blocking Send Function</div></div>
 243     <h1><a class="anchor" id="AccessStruct"></a>
 244 Access Struct</h1>
 245 <p>A CMSIS-Driver publishes an <a class="el" href="theoryOperation.html#AccessStruct">Access Struct</a> with the data type name <code>ARM_DRIVER_xxxx</code> that gives to access the driver functions.</p>
 246 <p><b>Code Example:</b> Function Access of the SPI driver </p><div class="fragment"><div class="line"><span class="keyword">typedef</span> <span class="keyword">struct </span>_ARM_DRIVER_SPI {</div>
 247 <div class="line">  <a class="code hl_struct" href="group__common__drv__gr.html#structARM__DRIVER__VERSION">ARM_DRIVER_VERSION</a>   (*GetVersion)      (void);</div>
 248 <div class="line">  <a class="code hl_struct" href="group__spi__interface__gr.html#structARM__SPI__CAPABILITIES">ARM_SPI_CAPABILITIES</a> (*GetCapabilities) (void);</div>
 249 <div class="line">  int32_t              (*Initialize)      (<a class="code hl_typedef" href="group__spi__interface__gr.html#gafde9205364241ee81290adc0481c6640">ARM_SPI_SignalEvent_t</a> cb_event);</div>
 250 <div class="line">  int32_t              (*Uninitialize)    (void);</div>
 251 <div class="line">  int32_t              (*PowerControl)    (<a class="code hl_enumeration" href="group__common__drv__gr.html#ga47d6d7c31f88f3b8ae4aaf9d8444afa5">ARM_POWER_STATE</a> state);</div>
 252 <div class="line">  int32_t              (*Send)            (<span class="keyword">const</span> <span class="keywordtype">void</span> *data, uint32_t num);</div>
 253 <div class="line">  int32_t              (*Receive)         (      <span class="keywordtype">void</span> *data, uint32_t num);</div>
 254 <div class="line">  int32_t              (*Transfer)        (<span class="keyword">const</span> <span class="keywordtype">void</span> *data_out, <span class="keywordtype">void</span> *data_in, uint32_t num);</div>
 255 <div class="line">  uint32_t             (*GetDataCount)    (void);</div>
 256 <div class="line">  int32_t              (*Control)         (uint32_t control, uint32_t arg);</div>
 257 <div class="line">  <a class="code hl_struct" href="group__spi__interface__gr.html#structARM__SPI__STATUS">ARM_SPI_STATUS</a>       (*GetStatus)       (void);</div>
 258 <div class="line">} <span class="keyword">const</span> <a class="code hl_struct" href="group__spi__interface__gr.html#structARM__DRIVER__SPI">ARM_DRIVER_SPI</a>;</div>
 259 <div class="ttc" id="agroup__common__drv__gr_html_ga47d6d7c31f88f3b8ae4aaf9d8444afa5"><div class="ttname"><a href="group__common__drv__gr.html#ga47d6d7c31f88f3b8ae4aaf9d8444afa5">ARM_POWER_STATE</a></div><div class="ttdeci">ARM_POWER_STATE</div><div class="ttdoc">General power states.</div><div class="ttdef"><b>Definition:</b> Driver_Common.h:63</div></div>
 260 <div class="ttc" id="agroup__common__drv__gr_html_structARM__DRIVER__VERSION"><div class="ttname"><a href="group__common__drv__gr.html#structARM__DRIVER__VERSION">ARM_DRIVER_VERSION</a></div><div class="ttdoc">Driver Version.</div><div class="ttdef"><b>Definition:</b> Driver_Common.h:46</div></div>
 261 <div class="ttc" id="agroup__spi__interface__gr_html_gafde9205364241ee81290adc0481c6640"><div class="ttname"><a href="group__spi__interface__gr.html#gafde9205364241ee81290adc0481c6640">ARM_SPI_SignalEvent_t</a></div><div class="ttdeci">void(* ARM_SPI_SignalEvent_t)(uint32_t event)</div><div class="ttdoc">Pointer to ARM_SPI_SignalEvent : Signal SPI Event.</div><div class="ttdef"><b>Definition:</b> Driver_SPI.h:216</div></div>
 262 <div class="ttc" id="agroup__spi__interface__gr_html_structARM__DRIVER__SPI"><div class="ttname"><a href="group__spi__interface__gr.html#structARM__DRIVER__SPI">ARM_DRIVER_SPI</a></div><div class="ttdoc">Access structure of the SPI Driver.</div><div class="ttdef"><b>Definition:</b> Driver_SPI.h:234</div></div>
 263 <div class="ttc" id="agroup__spi__interface__gr_html_structARM__SPI__CAPABILITIES"><div class="ttname"><a href="group__spi__interface__gr.html#structARM__SPI__CAPABILITIES">ARM_SPI_CAPABILITIES</a></div><div class="ttdoc">SPI Driver Capabilities.</div><div class="ttdef"><b>Definition:</b> Driver_SPI.h:222</div></div>
 264 <div class="ttc" id="agroup__spi__interface__gr_html_structARM__SPI__STATUS"><div class="ttname"><a href="group__spi__interface__gr.html#structARM__SPI__STATUS">ARM_SPI_STATUS</a></div><div class="ttdoc">SPI Status.</div><div class="ttdef"><b>Definition:</b> Driver_SPI.h:137</div></div>
 265 </div><!-- fragment --><h2><a class="anchor" id="DriverInstances"></a>
 266 Driver Instances</h2>
 267 <p>A device may offer several peripherals of the same type. For such devices, the CMSIS-Driver publishes multiple instances of the <a class="el" href="theoryOperation.html#AccessStruct">Access Struct</a>. The name of each driver instance reflects the names of the peripheral available in the device.</p>
 268 <p><b>Code Example:</b> <a class="el" href="theoryOperation.html#AccessStruct">Access Struct</a> for three SPIs in a microcontroller device. </p><div class="fragment"><div class="line"><a class="code hl_struct" href="group__spi__interface__gr.html#structARM__DRIVER__SPI">ARM_DRIVER_SPI</a> Driver_SPI1;     <span class="comment">// access functions for SPI1 interface</span></div>
 269 <div class="line"><a class="code hl_struct" href="group__spi__interface__gr.html#structARM__DRIVER__SPI">ARM_DRIVER_SPI</a> Driver_SPI2;     <span class="comment">// access functions for SPI2 interface</span></div>
 270 <div class="line"><a class="code hl_struct" href="group__spi__interface__gr.html#structARM__DRIVER__SPI">ARM_DRIVER_SPI</a> Driver_SPI3;     <span class="comment">// access functions for SPI3 interface</span></div>
 271 </div><!-- fragment --><p>The access functions can be passed to middleware to specify the driver instance that the middleware should use for communication.</p>
 272 <p><b>Naming Convention</b></p>
 273 <p>The access structs need to follow this naming convention: the keyword <code>Driver</code> followed by an underscore <code>_</code>, the interface name <code>IFNAME</code> (usually in upper case letters), and the instance number <code>n</code>. Here's the full list of access struct names for all drivers (n to be replaced with the actual instance number): </p><div class="fragment"><div class="line">Driver_CANn</div>
 274 <div class="line">Driver_ETH_MACn</div>
 275 <div class="line">Driver_ETH_PHYn</div>
 276 <div class="line">Driver_Flashn</div>
 277 <div class="line">Driver_GPIOn</div>
 278 <div class="line">Driver_I2Cn</div>
 279 <div class="line">Driver_MCIn</div>
 280 <div class="line">Driver_NANDn</div>
 281 <div class="line">Driver_SAIn</div>
 282 <div class="line">Driver_SPIn</div>
 283 <div class="line">Driver_Storagen</div>
 284 <div class="line">Driver_USARTn</div>
 285 <div class="line">Driver_USBDn</div>
 286 <div class="line">Driver_USBHn</div>
 287 <div class="line">Driver_WiFin</div>
 288 </div><!-- fragment --><p><b>Example:</b> </p><div class="fragment"><div class="line"><span class="keywordtype">void</span> init_middleware (<a class="code hl_struct" href="group__spi__interface__gr.html#structARM__DRIVER__SPI">ARM_DRIVER_SPI</a> *Drv_spi) ...</div>
 289 <div class="line">\\ inside the middleware the SPI driver functions are called with:</div>
 290 <div class="line">\\   Drv_spi-&gt;function (...);</div>
 291 </div><!-- fragment --><div class="fragment"><div class="line">\\ setup middleware</div>
 292 <div class="line">init_middleware (&amp;Driver_SPI1);      <span class="comment">// connect middleware to SPI1 interface</span></div>
 293 <div class="line">  :</div>
 294 <div class="line">init_middleware (&amp;Driver_SPI2);      <span class="comment">// connect middleware to SPI2 interface</span></div>
 295 </div><!-- fragment --><h1><a class="anchor" id="cmsis_driver_files"></a>
 296 CMSIS-Driver Files</h1>
 297 <p>The API of each CMSIS-Driver peripheral is published in a corresponding header file in the directory <code>.\CMSIS\Driver\Include\</code> It is recommended to include such header file in the implementation file of the CMSIS-Driver.</p>
 298 <p>Template files are available to simplify the development of a CMSIS-Driver. These are code skeletons that provide the structure of a CMSIS-Driver. They are available in the directory<code>.\CMSIS\Driver\DriverTemplates\</code>. You can also refer to working <a class="el" href="listOfImplementations.html">CMSIS-Driver Implementations</a> to see how CMSIS-Drivers get implemented on real devices.</p>
 299 <p>The table below summarizes the API header and template files for CMSIS-Driver interfaces, with links to GitHub and API references.</p>
 300 <table class="markdownTable">
 301 <tr class="markdownTableHead">
 302 <th class="markdownTableHeadLeft">Header File   </th><th class="markdownTableHeadLeft">Template File   </th><th class="markdownTableHeadLeft">API Reference    </th></tr>
 303 <tr class="markdownTableRowOdd">
 304 <td class="markdownTableBodyLeft"><a href="https://github.com/ARM-software/CMSIS_6/blob/main/CMSIS/Driver/Include/Driver_Common.h">Driver_Common.h</a>   </td><td class="markdownTableBodyLeft">Not applicable   </td><td class="markdownTableBodyLeft"><a class="el" href="group__common__drv__gr.html">Common Driver Definitions</a>    </td></tr>
 305 <tr class="markdownTableRowEven">
 306 <td class="markdownTableBodyLeft"><a href="https://github.com/ARM-software/CMSIS_6/blob/main/CMSIS/Driver/Include/Driver_CAN.h">Driver_CAN.h</a>   </td><td class="markdownTableBodyLeft"><a href="https://github.com/ARM-software/CMSIS_6/blob/main/CMSIS/Driver/DriverTemplates/Driver_CAN.c">Driver_CAN.c</a>   </td><td class="markdownTableBodyLeft"><a class="el" href="group__can__interface__gr.html">CAN Interface</a>    </td></tr>
 307 <tr class="markdownTableRowOdd">
 308 <td class="markdownTableBodyLeft"><a href="https://github.com/ARM-software/CMSIS_6/blob/main/CMSIS/Driver/Include/Driver_ETH.h">Driver_ETH.h</a>   </td><td class="markdownTableBodyLeft">-   </td><td class="markdownTableBodyLeft"><a class="el" href="group__eth__interface__gr.html">Ethernet Interface</a>    </td></tr>
 309 <tr class="markdownTableRowEven">
 310 <td class="markdownTableBodyLeft"><a href="https://github.com/ARM-software/CMSIS_6/blob/main/CMSIS/Driver/Include/Driver_ETH_MAC.h">Driver_ETH_MAC.h</a>   </td><td class="markdownTableBodyLeft"><a href="https://github.com/ARM-software/CMSIS_6/blob/main/CMSIS/Driver/DriverTemplates/Driver_ETH_MAC.c">Driver_ETH_MAC.c</a>   </td><td class="markdownTableBodyLeft"><a class="el" href="group__eth__mac__interface__gr.html">Ethernet MAC Interface</a>    </td></tr>
 311 <tr class="markdownTableRowOdd">
 312 <td class="markdownTableBodyLeft"><a href="https://github.com/ARM-software/CMSIS_6/blob/main/CMSIS/Driver/Include/Driver_ETH_MAC.h">Driver_ETH_PHY.h</a>   </td><td class="markdownTableBodyLeft"><a href="https://github.com/ARM-software/CMSIS_6/blob/main/CMSIS/Driver/DriverTemplates/Driver_ETH_PHY.c">Driver_ETH_PHY.c</a>   </td><td class="markdownTableBodyLeft"><a class="el" href="group__eth__phy__interface__gr.html">Ethernet PHY Interface</a>    </td></tr>
 313 <tr class="markdownTableRowEven">
 314 <td class="markdownTableBodyLeft"><a href="https://github.com/ARM-software/CMSIS_6/blob/main/CMSIS/Driver/Include/Driver_Flash.h">Driver_Flash.h</a>   </td><td class="markdownTableBodyLeft"><a href="https://github.com/ARM-software/CMSIS_6/blob/main/CMSIS/Driver/DriverTemplates/Driver_Flash.c">Driver_Flash.c</a>   </td><td class="markdownTableBodyLeft"><a class="el" href="group__flash__interface__gr.html">Flash Interface</a>    </td></tr>
 315 <tr class="markdownTableRowOdd">
 316 <td class="markdownTableBodyLeft"><a href="https://github.com/ARM-software/CMSIS_6/blob/main/CMSIS/Driver/Include/Driver_GPIO.h">Driver_GPIO.h</a>   </td><td class="markdownTableBodyLeft"><a href="https://github.com/ARM-software/CMSIS_6/blob/main/CMSIS/Driver/DriverTemplates/Driver_GPIO.c">Driver_GPIO.c</a>   </td><td class="markdownTableBodyLeft"><a class="el" href="group__gpio__interface__gr.html">GPIO Interface</a>    </td></tr>
 317 <tr class="markdownTableRowEven">
 318 <td class="markdownTableBodyLeft"><a href="https://github.com/ARM-software/CMSIS_6/blob/main/CMSIS/Driver/Include/Driver_I2C.h">Driver_I2C.h</a>   </td><td class="markdownTableBodyLeft"><a href="https://github.com/ARM-software/CMSIS_6/blob/main/CMSIS/Driver/DriverTemplates/Driver_I2C.c">Driver_I2C.c</a>   </td><td class="markdownTableBodyLeft"><a class="el" href="group__i2c__interface__gr.html">I2C Interface</a>    </td></tr>
 319 <tr class="markdownTableRowOdd">
 320 <td class="markdownTableBodyLeft"><a href="https://github.com/ARM-software/CMSIS_6/blob/main/CMSIS/Driver/Include/Driver_MCI.h">Driver_MCI.h</a>   </td><td class="markdownTableBodyLeft"><a href="https://github.com/ARM-software/CMSIS_6/blob/main/CMSIS/Driver/DriverTemplates/Driver_MCI.c">Driver_MCI.c</a>   </td><td class="markdownTableBodyLeft"><a class="el" href="group__mci__interface__gr.html">MCI Interface</a>    </td></tr>
 321 <tr class="markdownTableRowEven">
 322 <td class="markdownTableBodyLeft"><a href="https://github.com/ARM-software/CMSIS_6/blob/main/CMSIS/Driver/Include/Driver_NAND.h">Driver_NAND.h</a>   </td><td class="markdownTableBodyLeft"><a href="https://github.com/ARM-software/CMSIS_6/blob/main/CMSIS/Driver/DriverTemplates/Driver_NAND.c">Driver_NAND.c</a>   </td><td class="markdownTableBodyLeft"><a class="el" href="group__nand__interface__gr.html">NAND Interface</a>    </td></tr>
 323 <tr class="markdownTableRowOdd">
 324 <td class="markdownTableBodyLeft"><a href="https://github.com/ARM-software/CMSIS_6/blob/main/CMSIS/Driver/Include/Driver_SAI.h">Driver_SAI.h</a>   </td><td class="markdownTableBodyLeft"><a href="https://github.com/ARM-software/CMSIS_6/blob/main/CMSIS/Driver/DriverTemplates/Driver_SAI.c">Driver_SAI.c</a>   </td><td class="markdownTableBodyLeft"><a class="el" href="group__sai__interface__gr.html">SAI Interface</a>    </td></tr>
 325 <tr class="markdownTableRowEven">
 326 <td class="markdownTableBodyLeft"><a href="https://github.com/ARM-software/CMSIS_6/blob/main/CMSIS/Driver/Include/Driver_SPI.h">Driver_SPI.h</a>   </td><td class="markdownTableBodyLeft"><a href="https://github.com/ARM-software/CMSIS_6/blob/main/CMSIS/Driver/DriverTemplates/Driver_SPI.c">Driver_SPI.c</a>   </td><td class="markdownTableBodyLeft"><a class="el" href="group__spi__interface__gr.html">SPI Interface</a>    </td></tr>
 327 <tr class="markdownTableRowOdd">
 328 <td class="markdownTableBodyLeft"><a href="https://github.com/ARM-software/CMSIS_6/blob/main/CMSIS/Driver/Include/Driver_Storage.h">Driver_Storage.h</a>   </td><td class="markdownTableBodyLeft"><a href="https://github.com/ARM-software/CMSIS_6/blob/main/CMSIS/Driver/DriverTemplates/Driver_Storage.c">Driver_Storage.c</a>   </td><td class="markdownTableBodyLeft"><a class="el" href="group__storage__interface__gr.html">Storage Interface</a>    </td></tr>
 329 <tr class="markdownTableRowEven">
 330 <td class="markdownTableBodyLeft"><a href="https://github.com/ARM-software/CMSIS_6/blob/main/CMSIS/Driver/Include/Driver_USART.h">Driver_USART.h</a>   </td><td class="markdownTableBodyLeft"><a href="https://github.com/ARM-software/CMSIS_6/blob/main/CMSIS/Driver/DriverTemplates/Driver_USART.c">Driver_USART.c</a>   </td><td class="markdownTableBodyLeft"><a class="el" href="group__usart__interface__gr.html">USART Interface</a>    </td></tr>
 331 <tr class="markdownTableRowOdd">
 332 <td class="markdownTableBodyLeft"><a href="https://github.com/ARM-software/CMSIS_6/blob/main/CMSIS/Driver/Include/Driver_USB.h">Driver_USB.h</a>   </td><td class="markdownTableBodyLeft">-   </td><td class="markdownTableBodyLeft"><a class="el" href="group__usb__interface__gr.html">USB Interface</a>    </td></tr>
 333 <tr class="markdownTableRowEven">
 334 <td class="markdownTableBodyLeft"><a href="https://github.com/ARM-software/CMSIS_6/blob/main/CMSIS/Driver/Include/Driver_USBD.h">Driver_USBD.h</a>   </td><td class="markdownTableBodyLeft"><a href="https://github.com/ARM-software/CMSIS_6/blob/main/CMSIS/Driver/DriverTemplates/Driver_USBD.c">Driver_USBD.c</a>   </td><td class="markdownTableBodyLeft"><a class="el" href="group__usbd__interface__gr.html">USB Device Interface</a>    </td></tr>
 335 <tr class="markdownTableRowOdd">
 336 <td class="markdownTableBodyLeft"><a href="https://github.com/ARM-software/CMSIS_6/blob/main/CMSIS/Driver/Include/Driver_USBH.h">Driver_USBH.h</a>   </td><td class="markdownTableBodyLeft"><a href="https://github.com/ARM-software/CMSIS_6/blob/main/CMSIS/Driver/DriverTemplates/Driver_USBH.c">Driver_USBH.c</a>   </td><td class="markdownTableBodyLeft"><a class="el" href="group__usbh__interface__gr.html">USB Host Interface</a>    </td></tr>
 337 <tr class="markdownTableRowEven">
 338 <td class="markdownTableBodyLeft"><a href="https://github.com/ARM-software/CMSIS_6/blob/main/CMSIS/Driver/Include/Driver_WiFi.h">Driver_WiFi.h</a>   </td><td class="markdownTableBodyLeft"><a href="https://github.com/ARM-software/CMSIS_6/blob/main/CMSIS/Driver/DriverTemplates/Driver_WiFi.c">Driver_WiFi.c</a>   </td><td class="markdownTableBodyLeft"><a class="el" href="group__wifi__interface__gr.html">WiFi Interface</a>   </td></tr>
 339 </table>
 340 <h1><a class="anchor" id="DriverConfiguration"></a>
 341 Driver Configuration</h1>
 342 <p>For a device family, the drivers may be configurable, but the configuration of the drivers itself is not part of the CMSIS-Driver specification.</p>
 343 <h1><a class="anchor" id="CodeExample"></a>
 344 Code Example</h1>
 345 <p>The following example code shows the usage of the SPI interface.</p>
 346 <div class="fragment"><div class="line"><span class="preprocessor">#include &quot;<a class="code" href="Driver__SPI_8h.html">Driver_SPI.h</a>&quot;</span></div>
 347 <div class="line"><span class="preprocessor">#include &quot;cmsis_os.h&quot;</span>                   <span class="comment">// ARM::CMSIS:RTOS:Keil RTX</span></div>
 348 <div class="line"> </div>
 349 <div class="line"> </div>
 350 <div class="line"><span class="keywordtype">void</span> mySPI_Thread(<span class="keywordtype">void</span> <span class="keyword">const</span> *argument);</div>
 351 <div class="line">osThreadId tid_mySPI_Thread;</div>
 352 <div class="line"> </div>
 353 <div class="line"> </div>
 354 <div class="line"><span class="comment">/* SPI Driver */</span></div>
 355 <div class="line"><span class="keyword">extern</span> <a class="code hl_struct" href="group__spi__interface__gr.html#structARM__DRIVER__SPI">ARM_DRIVER_SPI</a> Driver_SPI0;</div>
 356 <div class="line"> </div>
 357 <div class="line"> </div>
 358 <div class="line"><span class="keywordtype">void</span> mySPI_callback(uint32_t event)</div>
 359 <div class="line">{</div>
 360 <div class="line">    <span class="keywordflow">switch</span> (event)</div>
 361 <div class="line">    {</div>
 362 <div class="line">    <span class="keywordflow">case</span> <a class="code hl_define" href="group__SPI__events.html#gaabdfc9e17641144cd50d36d15511a1b8">ARM_SPI_EVENT_TRANSFER_COMPLETE</a>:</div>
 363 <div class="line">        <span class="comment">/* Success: Wakeup Thread */</span></div>
 364 <div class="line">        osSignalSet(tid_mySPI_Thread, 0x01);</div>
 365 <div class="line">        <span class="keywordflow">break</span>;</div>
 366 <div class="line">    <span class="keywordflow">case</span> <a class="code hl_define" href="group__SPI__events.html#ga8e63d99c80ea56de596a8d0a51fd8244">ARM_SPI_EVENT_DATA_LOST</a>:</div>
 367 <div class="line">        <span class="comment">/*  Occurs in slave mode when data is requested/sent by master</span></div>
 368 <div class="line"><span class="comment">            but send/receive/transfer operation has not been started</span></div>
 369 <div class="line"><span class="comment">            and indicates that data is lost. Occurs also in master mode</span></div>
 370 <div class="line"><span class="comment">            when driver cannot transfer data fast enough. */</span></div>
 371 <div class="line">        __breakpoint(0);  <span class="comment">/* Error: Call debugger or replace with custom error handling */</span></div>
 372 <div class="line">        <span class="keywordflow">break</span>;</div>
 373 <div class="line">    <span class="keywordflow">case</span> <a class="code hl_define" href="group__SPI__events.html#ga7eaa229003689aa18598273490b3e630">ARM_SPI_EVENT_MODE_FAULT</a>:</div>
 374 <div class="line">        <span class="comment">/*  Occurs in master mode when Slave Select is deactivated and</span></div>
 375 <div class="line"><span class="comment">            indicates Master Mode Fault. */</span></div>
 376 <div class="line">        __breakpoint(0);  <span class="comment">/* Error: Call debugger or replace with custom error handling */</span></div>
 377 <div class="line">        <span class="keywordflow">break</span>;</div>
 378 <div class="line">    }</div>
 379 <div class="line">}</div>
 380 <div class="line"> </div>
 381 <div class="line"><span class="comment">/* Test data buffers */</span></div>
 382 <div class="line"><span class="keyword">const</span> uint8_t testdata_out[8] = { 0, 1, 2, 3, 4, 5, 6, 7 }; </div>
 383 <div class="line">uint8_t       testdata_in [8];</div>
 384 <div class="line"> </div>
 385 <div class="line"><span class="keywordtype">void</span> mySPI_Thread(<span class="keywordtype">void</span> <span class="keyword">const</span>* arg)</div>
 386 <div class="line">{</div>
 387 <div class="line">    <a class="code hl_struct" href="group__spi__interface__gr.html#structARM__DRIVER__SPI">ARM_DRIVER_SPI</a>* SPIdrv = &amp;Driver_SPI0;</div>
 388 <div class="line">    osEvent evt;</div>
 389 <div class="line"> </div>
 390 <div class="line"><span class="preprocessor">#ifdef DEBUG</span></div>
 391 <div class="line">    <a class="code hl_struct" href="group__common__drv__gr.html#structARM__DRIVER__VERSION">ARM_DRIVER_VERSION</a>   version;</div>
 392 <div class="line">    <a class="code hl_struct" href="group__spi__interface__gr.html#structARM__SPI__CAPABILITIES">ARM_SPI_CAPABILITIES</a> drv_capabilities;</div>
 393 <div class="line"> </div>
 394 <div class="line">    version = SPIdrv-&gt;<a class="code hl_variable" href="group__spi__interface__gr.html#a30afd9cb3113c037b5f1926f5ef93b59">GetVersion</a>();</div>
 395 <div class="line">    <span class="keywordflow">if</span> (version.<a class="code hl_variable" href="group__common__drv__gr.html#ad180da20fbde1d3dafc074af87c19540">api</a> &lt; 0x200) <span class="comment">/* requires at minimum API version 2.00 or higher */</span></div>
 396 <div class="line">    {                        <span class="comment">/* error handling                                 */</span></div>
 397 <div class="line">        <span class="keywordflow">return</span>;</div>
 398 <div class="line">    }</div>
 399 <div class="line"> </div>
 400 <div class="line">    drv_capabilities = SPIdrv-&gt;<a class="code hl_variable" href="group__spi__interface__gr.html#a806a8a77ab11c714b769a754501c6062">GetCapabilities</a>();</div>
 401 <div class="line">    <span class="keywordflow">if</span> (drv_capabilities.<a class="code hl_variable" href="group__spi__interface__gr.html#a309619714f0c4febaa497ebdb9b7e3ca">event_mode_fault</a> == 0)</div>
 402 <div class="line">    {                        <span class="comment">/* error handling */</span></div>
 403 <div class="line">        <span class="keywordflow">return</span>;</div>
 404 <div class="line">    }</div>
 405 <div class="line"><span class="preprocessor">#endif</span></div>
 406 <div class="line"> </div>
 407 <div class="line">    <span class="comment">/* Initialize the SPI driver */</span></div>
 408 <div class="line">    SPIdrv-&gt;<a class="code hl_variable" href="group__spi__interface__gr.html#a31866b083830420451c5ca7049166698">Initialize</a>(mySPI_callback);</div>
 409 <div class="line">    <span class="comment">/* Power up the SPI peripheral */</span></div>
 410 <div class="line">    SPIdrv-&gt;<a class="code hl_variable" href="group__spi__interface__gr.html#a24ebae5c6011631f76027f9a16eaf5ce">PowerControl</a>(<a class="code hl_enumvalue" href="Driver__Common_8h.html#ga47d6d7c31f88f3b8ae4aaf9d8444afa5abed52b77a9ce4775570e44a842b1295e">ARM_POWER_FULL</a>);</div>
 411 <div class="line">    <span class="comment">/* Configure the SPI to Master, 8-bit mode @10000 kBits/sec */</span></div>
 412 <div class="line">    SPIdrv-&gt;<a class="code hl_variable" href="group__spi__interface__gr.html#a5e96d73d3a3c366aba50bf5304edb029">Control</a>(<a class="code hl_define" href="group__spi__mode__ctrls.html#ga3143ef07c1607b9bc57e29df35cf2fa8">ARM_SPI_MODE_MASTER</a> | <a class="code hl_define" href="group__spi__frame__format__ctrls.html#ga7fab572b2fec303e979e47eb2d13ca74">ARM_SPI_CPOL1_CPHA1</a> | <a class="code hl_define" href="group__spi__bit__order__ctrls.html#ga98228a708cbab6e214c7ac696f77dab6">ARM_SPI_MSB_LSB</a> | <a class="code hl_define" href="group__spi__slave__select__mode__ctrls.html#gab5e319aa3f9d4d8c9ed92f0fe865f624">ARM_SPI_SS_MASTER_SW</a> | <a class="code hl_define" href="group__spi__data__bits__ctrls.html#gaf6c099a1d67256a32010120c66c55250">ARM_SPI_DATA_BITS</a>(8), 10000000);</div>
 413 <div class="line"> </div>
 414 <div class="line">    <span class="comment">/* SS line = INACTIVE = HIGH */</span></div>
 415 <div class="line">    SPIdrv-&gt;<a class="code hl_variable" href="group__spi__interface__gr.html#a5e96d73d3a3c366aba50bf5304edb029">Control</a>(<a class="code hl_define" href="group__spi__misc__ctrls.html#ga5776272b82decff92da003568540c92f">ARM_SPI_CONTROL_SS</a>, <a class="code hl_define" href="group__spi__ss__signals.html#ga335b448e07422e9c25616a693ec581cc">ARM_SPI_SS_INACTIVE</a>);</div>
 416 <div class="line"> </div>
 417 <div class="line">    <span class="comment">/* thread loop */</span></div>
 418 <div class="line">    <span class="keywordflow">while</span> (1)</div>
 419 <div class="line">    {</div>
 420 <div class="line">        <span class="comment">/* SS line = ACTIVE = LOW */</span></div>
 421 <div class="line">        SPIdrv-&gt;<a class="code hl_variable" href="group__spi__interface__gr.html#a5e96d73d3a3c366aba50bf5304edb029">Control</a>(<a class="code hl_define" href="group__spi__misc__ctrls.html#ga5776272b82decff92da003568540c92f">ARM_SPI_CONTROL_SS</a>, <a class="code hl_define" href="group__spi__ss__signals.html#ga3f465cdbd1238ddd74f78e14457076c4">ARM_SPI_SS_ACTIVE</a>);</div>
 422 <div class="line">        <span class="comment">/* Transmit some data */</span></div>
 423 <div class="line">        SPIdrv-&gt;<a class="code hl_variable" href="group__spi__interface__gr.html#a6e880dae8e9733a3c0f152a131076ca4">Send</a>(testdata_out, <span class="keyword">sizeof</span>(testdata_out));</div>
 424 <div class="line">        <span class="comment">/* Wait for completion */</span></div>
 425 <div class="line">        evt = osSignalWait(0x01, 100);</div>
 426 <div class="line">        <span class="keywordflow">if</span> (evt.status == osEventTimeout) {</div>
 427 <div class="line">            __breakpoint(0); <span class="comment">/* Timeout error: Call debugger */</span></div>
 428 <div class="line">        }</div>
 429 <div class="line">        <span class="comment">/* SS line = INACTIVE = HIGH */</span></div>
 430 <div class="line">        SPIdrv-&gt;<a class="code hl_variable" href="group__spi__interface__gr.html#a5e96d73d3a3c366aba50bf5304edb029">Control</a>(<a class="code hl_define" href="group__spi__misc__ctrls.html#ga5776272b82decff92da003568540c92f">ARM_SPI_CONTROL_SS</a>, <a class="code hl_define" href="group__spi__ss__signals.html#ga335b448e07422e9c25616a693ec581cc">ARM_SPI_SS_INACTIVE</a>);</div>
 431 <div class="line"> </div>
 432 <div class="line">        <span class="comment">/* SS line = ACTIVE = LOW */</span></div>
 433 <div class="line">        SPIdrv-&gt;<a class="code hl_variable" href="group__spi__interface__gr.html#a5e96d73d3a3c366aba50bf5304edb029">Control</a>(<a class="code hl_define" href="group__spi__misc__ctrls.html#ga5776272b82decff92da003568540c92f">ARM_SPI_CONTROL_SS</a>, <a class="code hl_define" href="group__spi__ss__signals.html#ga3f465cdbd1238ddd74f78e14457076c4">ARM_SPI_SS_ACTIVE</a>);</div>
 434 <div class="line">        <span class="comment">/* Receive 8 bytes of reply */</span></div>
 435 <div class="line">        SPIdrv-&gt;<a class="code hl_variable" href="group__spi__interface__gr.html#a784cafe08ad8f9052dca8cd8071d2a9b">Receive</a>(testdata_in, 8);</div>
 436 <div class="line">        evt = osSignalWait(0x01, 100);</div>
 437 <div class="line">        <span class="keywordflow">if</span> (evt.status == osEventTimeout) {</div>
 438 <div class="line">            __breakpoint(0); <span class="comment">/* Timeout error: Call debugger */</span></div>
 439 <div class="line">        }</div>
 440 <div class="line">        <span class="comment">/* SS line = INACTIVE = HIGH */</span></div>
 441 <div class="line">        SPIdrv-&gt;<a class="code hl_variable" href="group__spi__interface__gr.html#a5e96d73d3a3c366aba50bf5304edb029">Control</a>(<a class="code hl_define" href="group__spi__misc__ctrls.html#ga5776272b82decff92da003568540c92f">ARM_SPI_CONTROL_SS</a>, <a class="code hl_define" href="group__spi__ss__signals.html#ga335b448e07422e9c25616a693ec581cc">ARM_SPI_SS_INACTIVE</a>);</div>
 442 <div class="line">    }</div>
 443 <div class="line">}</div>
 444 <div class="ttc" id="aDriver__SPI_8h_html"><div class="ttname"><a href="Driver__SPI_8h.html">Driver_SPI.h</a></div></div>
 445 <div class="ttc" id="agroup__SPI__events_html_ga7eaa229003689aa18598273490b3e630"><div class="ttname"><a href="group__SPI__events.html#ga7eaa229003689aa18598273490b3e630">ARM_SPI_EVENT_MODE_FAULT</a></div><div class="ttdeci">#define ARM_SPI_EVENT_MODE_FAULT</div><div class="ttdoc">Master Mode Fault (SS deactivated when Master)</div></div>
 446 <div class="ttc" id="agroup__SPI__events_html_ga8e63d99c80ea56de596a8d0a51fd8244"><div class="ttname"><a href="group__SPI__events.html#ga8e63d99c80ea56de596a8d0a51fd8244">ARM_SPI_EVENT_DATA_LOST</a></div><div class="ttdeci">#define ARM_SPI_EVENT_DATA_LOST</div><div class="ttdoc">Data lost: Receive overflow / Transmit underflow.</div></div>
 447 <div class="ttc" id="agroup__SPI__events_html_gaabdfc9e17641144cd50d36d15511a1b8"><div class="ttname"><a href="group__SPI__events.html#gaabdfc9e17641144cd50d36d15511a1b8">ARM_SPI_EVENT_TRANSFER_COMPLETE</a></div><div class="ttdeci">#define ARM_SPI_EVENT_TRANSFER_COMPLETE</div><div class="ttdoc">Data Transfer completed.</div></div>
 448 <div class="ttc" id="agroup__common__drv__gr_html_ad180da20fbde1d3dafc074af87c19540"><div class="ttname"><a href="group__common__drv__gr.html#ad180da20fbde1d3dafc074af87c19540">ARM_DRIVER_VERSION::api</a></div><div class="ttdeci">uint16_t api</div><div class="ttdoc">API version.</div><div class="ttdef"><b>Definition:</b> Driver_Common.h:47</div></div>
 449 <div class="ttc" id="agroup__spi__bit__order__ctrls_html_ga98228a708cbab6e214c7ac696f77dab6"><div class="ttname"><a href="group__spi__bit__order__ctrls.html#ga98228a708cbab6e214c7ac696f77dab6">ARM_SPI_MSB_LSB</a></div><div class="ttdeci">#define ARM_SPI_MSB_LSB</div><div class="ttdoc">SPI Bit order from MSB to LSB (default)</div></div>
 450 <div class="ttc" id="agroup__spi__data__bits__ctrls_html_gaf6c099a1d67256a32010120c66c55250"><div class="ttname"><a href="group__spi__data__bits__ctrls.html#gaf6c099a1d67256a32010120c66c55250">ARM_SPI_DATA_BITS</a></div><div class="ttdeci">#define ARM_SPI_DATA_BITS(n)</div><div class="ttdoc">Number of Data bits.</div></div>
 451 <div class="ttc" id="agroup__spi__frame__format__ctrls_html_ga7fab572b2fec303e979e47eb2d13ca74"><div class="ttname"><a href="group__spi__frame__format__ctrls.html#ga7fab572b2fec303e979e47eb2d13ca74">ARM_SPI_CPOL1_CPHA1</a></div><div class="ttdeci">#define ARM_SPI_CPOL1_CPHA1</div><div class="ttdoc">Clock Polarity 1, Clock Phase 1.</div></div>
 452 <div class="ttc" id="agroup__spi__interface__gr_html_a24ebae5c6011631f76027f9a16eaf5ce"><div class="ttname"><a href="group__spi__interface__gr.html#a24ebae5c6011631f76027f9a16eaf5ce">ARM_DRIVER_SPI::PowerControl</a></div><div class="ttdeci">int32_t(* PowerControl)(ARM_POWER_STATE state)</div><div class="ttdoc">Pointer to ARM_SPI_PowerControl : Control SPI Interface Power.</div><div class="ttdef"><b>Definition:</b> Driver_SPI.h:239</div></div>
 453 <div class="ttc" id="agroup__spi__interface__gr_html_a309619714f0c4febaa497ebdb9b7e3ca"><div class="ttname"><a href="group__spi__interface__gr.html#a309619714f0c4febaa497ebdb9b7e3ca">ARM_SPI_CAPABILITIES::event_mode_fault</a></div><div class="ttdeci">uint32_t event_mode_fault</div><div class="ttdoc">Signal Mode Fault event: ARM_SPI_EVENT_MODE_FAULT.</div><div class="ttdef"><b>Definition:</b> Driver_SPI.h:226</div></div>
 454 <div class="ttc" id="agroup__spi__interface__gr_html_a30afd9cb3113c037b5f1926f5ef93b59"><div class="ttname"><a href="group__spi__interface__gr.html#a30afd9cb3113c037b5f1926f5ef93b59">ARM_DRIVER_SPI::GetVersion</a></div><div class="ttdeci">ARM_DRIVER_VERSION(* GetVersion)(void)</div><div class="ttdoc">Pointer to ARM_SPI_GetVersion : Get driver version.</div><div class="ttdef"><b>Definition:</b> Driver_SPI.h:235</div></div>
 455 <div class="ttc" id="agroup__spi__interface__gr_html_a31866b083830420451c5ca7049166698"><div class="ttname"><a href="group__spi__interface__gr.html#a31866b083830420451c5ca7049166698">ARM_DRIVER_SPI::Initialize</a></div><div class="ttdeci">int32_t(* Initialize)(ARM_SPI_SignalEvent_t cb_event)</div><div class="ttdoc">Pointer to ARM_SPI_Initialize : Initialize SPI Interface.</div><div class="ttdef"><b>Definition:</b> Driver_SPI.h:237</div></div>
 456 <div class="ttc" id="agroup__spi__interface__gr_html_a5e96d73d3a3c366aba50bf5304edb029"><div class="ttname"><a href="group__spi__interface__gr.html#a5e96d73d3a3c366aba50bf5304edb029">ARM_DRIVER_SPI::Control</a></div><div class="ttdeci">int32_t(* Control)(uint32_t control, uint32_t arg)</div><div class="ttdoc">Pointer to ARM_SPI_Control : Control SPI Interface.</div><div class="ttdef"><b>Definition:</b> Driver_SPI.h:246</div></div>
 457 <div class="ttc" id="agroup__spi__interface__gr_html_a6e880dae8e9733a3c0f152a131076ca4"><div class="ttname"><a href="group__spi__interface__gr.html#a6e880dae8e9733a3c0f152a131076ca4">ARM_DRIVER_SPI::Send</a></div><div class="ttdeci">int32_t(* Send)(const void *data, uint32_t num)</div><div class="ttdoc">Pointer to ARM_SPI_Send : Start sending data to SPI Interface.</div><div class="ttdef"><b>Definition:</b> Driver_SPI.h:240</div></div>
 458 <div class="ttc" id="agroup__spi__interface__gr_html_a784cafe08ad8f9052dca8cd8071d2a9b"><div class="ttname"><a href="group__spi__interface__gr.html#a784cafe08ad8f9052dca8cd8071d2a9b">ARM_DRIVER_SPI::Receive</a></div><div class="ttdeci">int32_t(* Receive)(void *data, uint32_t num)</div><div class="ttdoc">Pointer to ARM_SPI_Receive : Start receiving data from SPI Interface.</div><div class="ttdef"><b>Definition:</b> Driver_SPI.h:241</div></div>
 459 <div class="ttc" id="agroup__spi__interface__gr_html_a806a8a77ab11c714b769a754501c6062"><div class="ttname"><a href="group__spi__interface__gr.html#a806a8a77ab11c714b769a754501c6062">ARM_DRIVER_SPI::GetCapabilities</a></div><div class="ttdeci">ARM_SPI_CAPABILITIES(* GetCapabilities)(void)</div><div class="ttdoc">Pointer to ARM_SPI_GetCapabilities : Get driver capabilities.</div><div class="ttdef"><b>Definition:</b> Driver_SPI.h:236</div></div>
 460 <div class="ttc" id="agroup__spi__misc__ctrls_html_ga5776272b82decff92da003568540c92f"><div class="ttname"><a href="group__spi__misc__ctrls.html#ga5776272b82decff92da003568540c92f">ARM_SPI_CONTROL_SS</a></div><div class="ttdeci">#define ARM_SPI_CONTROL_SS</div><div class="ttdoc">Control Slave Select; arg: 0=inactive, 1=active.</div></div>
 461 <div class="ttc" id="agroup__spi__mode__ctrls_html_ga3143ef07c1607b9bc57e29df35cf2fa8"><div class="ttname"><a href="group__spi__mode__ctrls.html#ga3143ef07c1607b9bc57e29df35cf2fa8">ARM_SPI_MODE_MASTER</a></div><div class="ttdeci">#define ARM_SPI_MODE_MASTER</div><div class="ttdoc">SPI Master (Output on MOSI, Input on MISO); arg = Bus Speed in bps.</div></div>
 462 <div class="ttc" id="agroup__spi__slave__select__mode__ctrls_html_gab5e319aa3f9d4d8c9ed92f0fe865f624"><div class="ttname"><a href="group__spi__slave__select__mode__ctrls.html#gab5e319aa3f9d4d8c9ed92f0fe865f624">ARM_SPI_SS_MASTER_SW</a></div><div class="ttdeci">#define ARM_SPI_SS_MASTER_SW</div><div class="ttdoc">SPI Slave Select when Master: Software controlled.</div></div>
 463 <div class="ttc" id="agroup__spi__ss__signals_html_ga335b448e07422e9c25616a693ec581cc"><div class="ttname"><a href="group__spi__ss__signals.html#ga335b448e07422e9c25616a693ec581cc">ARM_SPI_SS_INACTIVE</a></div><div class="ttdeci">#define ARM_SPI_SS_INACTIVE</div><div class="ttdoc">SPI Slave Select Signal Inactive.</div></div>
 464 <div class="ttc" id="agroup__spi__ss__signals_html_ga3f465cdbd1238ddd74f78e14457076c4"><div class="ttname"><a href="group__spi__ss__signals.html#ga3f465cdbd1238ddd74f78e14457076c4">ARM_SPI_SS_ACTIVE</a></div><div class="ttdeci">#define ARM_SPI_SS_ACTIVE</div><div class="ttdoc">SPI Slave Select Signal Active.</div></div>
 465 </div><!-- fragment --> </div></div><!-- contents -->
 466 </div><!-- PageDoc -->
 467 </div><!-- doc-content -->
 468 <!-- start footer part -->
 469 <div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
 470   <ul>
 471     <li class="footer">
 472       <script type="text/javascript">
 473         <!--
 474         writeFooter.call(this);
 475         //-->
 476       </script>
 477     </li>
 478   </ul>
 479 </div>
 480 </body>
 481 </html>