begriffs open source - cmsis/blob - v6.1.0-rc0/Driver/group__wifi__control__gr.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: WiFi Control</title>
   9 <link href="doxygen.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="tabs.js"></script>
  13 <script type="text/javascript" src="footer.js"></script>
  14 <script type="text/javascript" src="navtree.js"></script>
  15 <link href="navtree.css" rel="stylesheet" type="text/css"/>
  16 <script type="text/javascript" src="resize.js"></script>
  17 <script type="text/javascript" src="navtreedata.js"></script>
  18 <script type="text/javascript" src="navtree.js"></script>
  19 <link href="search/search.css" rel="stylesheet" type="text/css"/>
  20 <script type="text/javascript" src="search/searchdata.js"></script>
  21 <script type="text/javascript" src="search/search.js"></script>
  22 <script type="text/javascript">
  23 /* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
  24   $(document).ready(function() { init_search(); });
  25 /* @license-end */
  26 </script>
  27 <script type="text/javascript" src="darkmode_toggle.js"></script>
  28 <link href="extra_stylesheet.css" rel="stylesheet" type="text/css"/>
  29 <link href="extra_navtree.css" rel="stylesheet" type="text/css"/>
  30 <link href="extra_search.css" rel="stylesheet" type="text/css"/>
  31 <link href="extra_tabs.css" rel="stylesheet" type="text/css"/>
  32 <link href="version.css" rel="stylesheet" type="text/css"/>
  33 <script type="text/javascript" src="../../version.js"></script>
  34 </head>
  35 <body>
  36 <div id="top"><!-- do not remove this div, it is closed by doxygen! -->
  37 <div id="titlearea">
  38 <table cellspacing="0" cellpadding="0">
  39  <tbody>
  40  <tr style="height: 55px;">
  41   <td id="projectlogo" style="padding: 1.5em;"><img alt="Logo" src="cmsis_logo_white_small.png"/></td>
  42   <td style="padding-left: 1em; padding-bottom: 1em;padding-top: 1em;">
  43    <div id="projectname">CMSIS-Driver
  44    &#160;<span id="projectnumber"><script type="text/javascript">
  45      <!--
  46      writeHeader.call(this);
  47      writeVersionDropdown.call(this, "CMSIS-Driver");
  48      //-->
  49     </script>
  50    </span>
  51    </div>
  52    <div id="projectbrief">Peripheral Interface for Middleware and Application Code</div>
  53   </td>
  54    <td>        <div id="MSearchBox" class="MSearchBoxInactive">
  55         <span class="left">
  56           <span id="MSearchSelect"                onmouseover="return searchBox.OnSearchSelectShow()"                onmouseout="return searchBox.OnSearchSelectHide()">&#160;</span>
  57           <input type="text" id="MSearchField" value="" placeholder="Search" accesskey="S"
  58                onfocus="searchBox.OnSearchFieldFocus(true)"
  59                onblur="searchBox.OnSearchFieldFocus(false)"
  60                onkeyup="searchBox.OnSearchFieldChange(event)"/>
  61           </span><span class="right">
  62             <a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.svg" alt=""/></a>
  63           </span>
  64         </div>
  65 </td>
  66   <!--END !PROJECT_NAME-->
  67  </tr>
  68  </tbody>
  69 </table>
  70 </div>
  71 <!-- end header part -->
  72 <div id="CMSISnav" class="tabs1">
  73   <ul class="tablist">
  74     <script type="text/javascript">
  75       writeComponentTabs.call(this);
  76     </script>
  77   </ul>
  78 </div>
  79 <script type="text/javascript">
  80   writeSubComponentTabs.call(this);
  81 </script>
  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__wifi__control__gr.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="#groups">Content</a> &#124;
 129 <a href="#nested-classes">Data Structures</a> &#124;
 130 <a href="#typedef-members">Typedefs</a> &#124;
 131 <a href="#func-members">Functions</a>  </div>
 132   <div class="headertitle"><div class="title">WiFi Control<div class="ingroups"><a class="el" href="group__wifi__interface__gr.html">WiFi Interface</a></div></div></div>
 133 </div><!--header-->
 134 <div class="contents">
 135
 136 <p>Control functions for the WiFi module.
 137 <a href="#details">More...</a></p>
 138 <table class="memberdecls">
 139 <tr class="heading"><td colspan="2"><h2 class="groupheader"><a id="groups" name="groups"></a>
 140 Content</h2></td></tr>
 141 <tr class="memitem:group__wifi__event"><td class="memItemLeft" align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__wifi__event.html">WiFi Events</a></td></tr>
 142 <tr class="memdesc:group__wifi__event"><td class="mdescLeft">&#160;</td><td class="mdescRight">The WiFi driver generates call back events that are notified via the function <a class="el" href="group__wifi__control__gr.html#ga0c8243dee4bb161132692516f048bcec">ARM_WIFI_SignalEvent</a>. <br /></td></tr>
 143 <tr class="separator:"><td class="memSeparator" colspan="2">&#160;</td></tr>
 144 </table><table class="memberdecls">
 145 <tr class="heading"><td colspan="2"><h2 class="groupheader"><a id="nested-classes" name="nested-classes"></a>
 146 Data Structures</h2></td></tr>
 147 <tr class="memitem:structARM__WIFI__CAPABILITIES"><td class="memItemLeft" align="right" valign="top">struct &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__wifi__control__gr.html#structARM__WIFI__CAPABILITIES">ARM_WIFI_CAPABILITIES</a></td></tr>
 148 <tr class="memdesc:structARM__WIFI__CAPABILITIES"><td class="mdescLeft">&#160;</td><td class="mdescRight">WiFi Driver Capabilities.  <a href="group__wifi__control__gr.html#structARM__WIFI__CAPABILITIES">More...</a><br /></td></tr>
 149 <tr class="separator:structARM__WIFI__CAPABILITIES"><td class="memSeparator" colspan="2">&#160;</td></tr>
 150 </table><table class="memberdecls">
 151 <tr class="heading"><td colspan="2"><h2 class="groupheader"><a id="typedef-members" name="typedef-members"></a>
 152 Typedefs</h2></td></tr>
 153 <tr class="memitem:gac0f04bbdd431c87a680626154c3e0a41"><td class="memItemLeft" align="right" valign="top">typedef void(*&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__wifi__control__gr.html#gac0f04bbdd431c87a680626154c3e0a41">ARM_WIFI_SignalEvent_t</a>) (uint32_t event, void *arg)</td></tr>
 154 <tr class="memdesc:gac0f04bbdd431c87a680626154c3e0a41"><td class="mdescLeft">&#160;</td><td class="mdescRight">Pointer to <a class="el" href="group__wifi__control__gr.html#ga0c8243dee4bb161132692516f048bcec">ARM_WIFI_SignalEvent</a> : Signal WiFi Event.  <br /></td></tr>
 155 <tr class="separator:gac0f04bbdd431c87a680626154c3e0a41"><td class="memSeparator" colspan="2">&#160;</td></tr>
 156 </table><table class="memberdecls">
 157 <tr class="heading"><td colspan="2"><h2 class="groupheader"><a id="func-members" name="func-members"></a>
 158 Functions</h2></td></tr>
 159 <tr class="memitem:gad349fb835926a508e2a33501c0dff6a2"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__common__drv__gr.html#structARM__DRIVER__VERSION">ARM_DRIVER_VERSION</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__wifi__control__gr.html#gad349fb835926a508e2a33501c0dff6a2">ARM_WIFI_GetVersion</a> (void)</td></tr>
 160 <tr class="memdesc:gad349fb835926a508e2a33501c0dff6a2"><td class="mdescLeft">&#160;</td><td class="mdescRight">Get driver version.  <br /></td></tr>
 161 <tr class="separator:gad349fb835926a508e2a33501c0dff6a2"><td class="memSeparator" colspan="2">&#160;</td></tr>
 162 <tr class="memitem:ga3496996799a4762e9958a8b6af683b4b"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__wifi__control__gr.html#structARM__WIFI__CAPABILITIES">ARM_WIFI_CAPABILITIES</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__wifi__control__gr.html#ga3496996799a4762e9958a8b6af683b4b">ARM_WIFI_GetCapabilities</a> (void)</td></tr>
 163 <tr class="memdesc:ga3496996799a4762e9958a8b6af683b4b"><td class="mdescLeft">&#160;</td><td class="mdescRight">Get driver capabilities.  <br /></td></tr>
 164 <tr class="separator:ga3496996799a4762e9958a8b6af683b4b"><td class="memSeparator" colspan="2">&#160;</td></tr>
 165 <tr class="memitem:gadc4b9aaae0fdf7d489b1d81e3c2f3474"><td class="memItemLeft" align="right" valign="top">int32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__wifi__control__gr.html#gadc4b9aaae0fdf7d489b1d81e3c2f3474">ARM_WIFI_Initialize</a> (<a class="el" href="group__wifi__control__gr.html#gac0f04bbdd431c87a680626154c3e0a41">ARM_WIFI_SignalEvent_t</a> cb_event)</td></tr>
 166 <tr class="memdesc:gadc4b9aaae0fdf7d489b1d81e3c2f3474"><td class="mdescLeft">&#160;</td><td class="mdescRight">Initialize WiFi Module.  <br /></td></tr>
 167 <tr class="separator:gadc4b9aaae0fdf7d489b1d81e3c2f3474"><td class="memSeparator" colspan="2">&#160;</td></tr>
 168 <tr class="memitem:gae1e488d4ecc365e30712e6b1711a9c5d"><td class="memItemLeft" align="right" valign="top">int32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__wifi__control__gr.html#gae1e488d4ecc365e30712e6b1711a9c5d">ARM_WIFI_Uninitialize</a> (void)</td></tr>
 169 <tr class="memdesc:gae1e488d4ecc365e30712e6b1711a9c5d"><td class="mdescLeft">&#160;</td><td class="mdescRight">De-initialize WiFi Module.  <br /></td></tr>
 170 <tr class="separator:gae1e488d4ecc365e30712e6b1711a9c5d"><td class="memSeparator" colspan="2">&#160;</td></tr>
 171 <tr class="memitem:ga48d4cb7c00e96d2b928cc4468d4e623b"><td class="memItemLeft" align="right" valign="top">int32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__wifi__control__gr.html#ga48d4cb7c00e96d2b928cc4468d4e623b">ARM_WIFI_PowerControl</a> (<a class="el" href="group__common__drv__gr.html#ga47d6d7c31f88f3b8ae4aaf9d8444afa5">ARM_POWER_STATE</a> state)</td></tr>
 172 <tr class="memdesc:ga48d4cb7c00e96d2b928cc4468d4e623b"><td class="mdescLeft">&#160;</td><td class="mdescRight">Control WiFi Module Power.  <br /></td></tr>
 173 <tr class="separator:ga48d4cb7c00e96d2b928cc4468d4e623b"><td class="memSeparator" colspan="2">&#160;</td></tr>
 174 <tr class="memitem:gabdc4c9966a3f22ac6e53119e71e67579"><td class="memItemLeft" align="right" valign="top">int32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__wifi__control__gr.html#gabdc4c9966a3f22ac6e53119e71e67579">ARM_WIFI_GetModuleInfo</a> (char *module_info, uint32_t max_len)</td></tr>
 175 <tr class="memdesc:gabdc4c9966a3f22ac6e53119e71e67579"><td class="mdescLeft">&#160;</td><td class="mdescRight">Get Module information.  <br /></td></tr>
 176 <tr class="separator:gabdc4c9966a3f22ac6e53119e71e67579"><td class="memSeparator" colspan="2">&#160;</td></tr>
 177 <tr class="memitem:ga0c8243dee4bb161132692516f048bcec"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__wifi__control__gr.html#ga0c8243dee4bb161132692516f048bcec">ARM_WIFI_SignalEvent</a> (uint32_t event, void *arg)</td></tr>
 178 <tr class="memdesc:ga0c8243dee4bb161132692516f048bcec"><td class="mdescLeft">&#160;</td><td class="mdescRight">Signal WiFi Events.  <br /></td></tr>
 179 <tr class="separator:ga0c8243dee4bb161132692516f048bcec"><td class="memSeparator" colspan="2">&#160;</td></tr>
 180 </table>
 181 <a name="details" id="details"></a><h2 class="groupheader">Description</h2>
 182 <p>Control functions for the WiFi module. </p>
 183 <p><br  />
 184  The <a class="el" href="group__wifi__control__gr.html">WiFi Control</a> functions setup and control the WiFi module. </p>
 185 <hr/><h2 class="groupheader">Data Structure Documentation</h2>
 186 <a name="structARM__WIFI__CAPABILITIES" id="structARM__WIFI__CAPABILITIES"></a>
 187 <h2 class="memtitle"><span class="permalink"><a href="#structARM__WIFI__CAPABILITIES">&#9670;&#160;</a></span>ARM_WIFI_CAPABILITIES</h2>
 188
 189 <div class="memitem">
 190 <div class="memproto">
 191       <table class="memname">
 192         <tr>
 193           <td class="memname">struct ARM_WIFI_CAPABILITIES</td>
 194         </tr>
 195       </table>
 196 </div><div class="memdoc">
 197 <div class="textblock"><p>WiFi Driver Capabilities. </p>
 198 <p>A WiFi driver can be implemented with different capabilities. The data fields of this structure encode the capabilities implemented by this driver.</p>
 199 <p><b>Returned by:</b></p><ul>
 200 <li><a class="el" href="group__wifi__control__gr.html#ga3496996799a4762e9958a8b6af683b4b">ARM_WIFI_GetCapabilities</a> </li>
 201 </ul>
 202 </div><table class="fieldtable">
 203 <tr><th colspan="3">Data Fields</th></tr>
 204 <tr><td class="fieldtype">
 205 <a id="a3c9e76f6560429efd6dcc41ffd4b67b9" name="a3c9e76f6560429efd6dcc41ffd4b67b9"></a>uint32_t</td>
 206 <td class="fieldname">
 207 station: 1</td>
 208 <td class="fielddoc">
 209 Station. </td></tr>
 210 <tr><td class="fieldtype">
 211 <a id="ae980bcb85233b9c5904072246ac71dd7" name="ae980bcb85233b9c5904072246ac71dd7"></a>uint32_t</td>
 212 <td class="fieldname">
 213 ap: 1</td>
 214 <td class="fielddoc">
 215 Access Point. </td></tr>
 216 <tr><td class="fieldtype">
 217 <a id="ad280904e2429375205c09e53fe8cdcb1" name="ad280904e2429375205c09e53fe8cdcb1"></a>uint32_t</td>
 218 <td class="fieldname">
 219 station_ap: 1</td>
 220 <td class="fielddoc">
 221 Concurrent Station and Access Point. </td></tr>
 222 <tr><td class="fieldtype">
 223 <a id="a87476544767703fc9f45f81b16cd4429" name="a87476544767703fc9f45f81b16cd4429"></a>uint32_t</td>
 224 <td class="fieldname">
 225 wps_station: 1</td>
 226 <td class="fielddoc">
 227 WiFi Protected Setup (WPS) for Station. </td></tr>
 228 <tr><td class="fieldtype">
 229 <a id="a7689c7dd824016b1962854a86d23d141" name="a7689c7dd824016b1962854a86d23d141"></a>uint32_t</td>
 230 <td class="fieldname">
 231 wps_ap: 1</td>
 232 <td class="fielddoc">
 233 WiFi Protected Setup (WPS) for Access Point. </td></tr>
 234 <tr><td class="fieldtype">
 235 <a id="a9fc191093a9bc356c3d85e9cbf185620" name="a9fc191093a9bc356c3d85e9cbf185620"></a>uint32_t</td>
 236 <td class="fieldname">
 237 event_ap_connect: 1</td>
 238 <td class="fielddoc">
 239 Access Point: event generated on Station connect. </td></tr>
 240 <tr><td class="fieldtype">
 241 <a id="a18a7e7fe3a4f48548af6db6c825cc427" name="a18a7e7fe3a4f48548af6db6c825cc427"></a>uint32_t</td>
 242 <td class="fieldname">
 243 event_ap_disconnect: 1</td>
 244 <td class="fielddoc">
 245 Access Point: event generated on Station disconnect. </td></tr>
 246 <tr><td class="fieldtype">
 247 <a id="ac4c6eadec013cf8a11b8eca66b809431" name="ac4c6eadec013cf8a11b8eca66b809431"></a>uint32_t</td>
 248 <td class="fieldname">
 249 event_eth_rx_frame: 1</td>
 250 <td class="fielddoc">
 251 Event generated on Ethernet frame reception in bypass mode. </td></tr>
 252 <tr><td class="fieldtype">
 253 <a id="adbcc47408fb8c50d262a3be535108186" name="adbcc47408fb8c50d262a3be535108186"></a>uint32_t</td>
 254 <td class="fieldname">
 255 bypass_mode: 1</td>
 256 <td class="fielddoc">
 257 Bypass or pass-through mode (Ethernet interface) </td></tr>
 258 <tr><td class="fieldtype">
 259 <a id="a69ddb9c845da426f636d9dd0dbed4e7e" name="a69ddb9c845da426f636d9dd0dbed4e7e"></a>uint32_t</td>
 260 <td class="fieldname">
 261 ip: 1</td>
 262 <td class="fielddoc">
 263 IP (UDP/TCP) (Socket interface) </td></tr>
 264 <tr><td class="fieldtype">
 265 <a id="aad13478539ad093fabafd1804acac4a2" name="aad13478539ad093fabafd1804acac4a2"></a>uint32_t</td>
 266 <td class="fieldname">
 267 ip6: 1</td>
 268 <td class="fielddoc">
 269 IPv6 (Socket interface) </td></tr>
 270 <tr><td class="fieldtype">
 271 <a id="aef01bbaa48bdb4fba71684d8f31eb0b1" name="aef01bbaa48bdb4fba71684d8f31eb0b1"></a>uint32_t</td>
 272 <td class="fieldname">
 273 ping: 1</td>
 274 <td class="fielddoc">
 275 Ping (ICMP) </td></tr>
 276 <tr><td class="fieldtype">
 277 <a id="aa43c4c21b173ada1b6b7568956f0d650" name="aa43c4c21b173ada1b6b7568956f0d650"></a>uint32_t</td>
 278 <td class="fieldname">
 279 reserved: 20</td>
 280 <td class="fielddoc">
 281 Reserved (must be zero) </td></tr>
 282 </table>
 283
 284 </div>
 285 </div>
 286 <h2 class="groupheader">Typedef Documentation</h2>
 287 <a id="gac0f04bbdd431c87a680626154c3e0a41" name="gac0f04bbdd431c87a680626154c3e0a41"></a>
 288 <h2 class="memtitle"><span class="permalink"><a href="#gac0f04bbdd431c87a680626154c3e0a41">&#9670;&#160;</a></span>ARM_WIFI_SignalEvent_t</h2>
 289
 290 <div class="memitem">
 291 <div class="memproto">
 292       <table class="memname">
 293         <tr>
 294           <td class="memname">ARM_WIFI_SignalEvent_t</td>
 295         </tr>
 296       </table>
 297 </div><div class="memdoc">
 298
 299 <p>Pointer to <a class="el" href="group__wifi__control__gr.html#ga0c8243dee4bb161132692516f048bcec">ARM_WIFI_SignalEvent</a> : Signal WiFi Event. </p>
 300 <p>Provides the typedef for the callback function <a class="el" href="group__wifi__control__gr.html#ga0c8243dee4bb161132692516f048bcec">ARM_WIFI_SignalEvent</a>.</p>
 301 <p><b>Parameter for:</b></p><ul>
 302 <li><a class="el" href="group__wifi__control__gr.html#gadc4b9aaae0fdf7d489b1d81e3c2f3474">ARM_WIFI_Initialize</a> </li>
 303 </ul>
 304
 305 </div>
 306 </div>
 307 <h2 class="groupheader">Function Documentation</h2>
 308 <a id="gad349fb835926a508e2a33501c0dff6a2" name="gad349fb835926a508e2a33501c0dff6a2"></a>
 309 <h2 class="memtitle"><span class="permalink"><a href="#gad349fb835926a508e2a33501c0dff6a2">&#9670;&#160;</a></span>ARM_WIFI_GetVersion()</h2>
 310
 311 <div class="memitem">
 312 <div class="memproto">
 313       <table class="memname">
 314         <tr>
 315           <td class="memname"><a class="el" href="group__common__drv__gr.html#structARM__DRIVER__VERSION">ARM_DRIVER_VERSION</a> ARM_WIFI_GetVersion </td>
 316           <td>(</td>
 317           <td class="paramtype">void&#160;</td>
 318           <td class="paramname"></td><td>)</td>
 319           <td></td>
 320         </tr>
 321       </table>
 322 </div><div class="memdoc">
 323
 324 <p>Get driver version. </p>
 325 <dl class="section return"><dt>Returns</dt><dd><a class="el" href="group__common__drv__gr.html#structARM__DRIVER__VERSION">ARM_DRIVER_VERSION</a></dd></dl>
 326 <p>The function <b>ARM_WIFI_GetVersion</b> returns version information of the driver implementation in <a class="el" href="group__common__drv__gr.html#structARM__DRIVER__VERSION">ARM_DRIVER_VERSION</a>.</p>
 327 <p>API version is the version of the CMSIS-Driver specification used to implement this driver. Driver version is source code version of the actual driver implementation.</p>
 328 <p><b>Example:</b> </p><div class="fragment"><div class="line"><span class="keyword">extern</span> <a class="code hl_struct" href="group__wifi__interface__gr.html#structARM__DRIVER__WIFI">ARM_DRIVER_WIFI</a> Driver_WiFi0;</div>
 329 <div class="line"><span class="keyword">static</span> <a class="code hl_struct" href="group__wifi__interface__gr.html#structARM__DRIVER__WIFI">ARM_DRIVER_WIFI</a> *wifi;</div>
 330 <div class="line"> </div>
 331 <div class="line"><span class="keywordtype">void</span> get_wifi_version (<span class="keywordtype">void</span>)  {</div>
 332 <div class="line">  <a class="code hl_struct" href="group__common__drv__gr.html#structARM__DRIVER__VERSION">ARM_DRIVER_VERSION</a> version;</div>
 333 <div class="line"> </div>
 334 <div class="line">  wifi= &amp;Driver_WiFi0;  </div>
 335 <div class="line">  version = wifi-&gt;<a class="code hl_variable" href="group__wifi__interface__gr.html#a30afd9cb3113c037b5f1926f5ef93b59">GetVersion</a> ();</div>
 336 <div class="line">  <span class="keywordflow">if</span> (version.<a class="code hl_variable" href="group__common__drv__gr.html#ad180da20fbde1d3dafc074af87c19540">api</a> &lt; 0x100U) {        <span class="comment">// requires at minimum API version 1.0 or higher</span></div>
 337 <div class="line">    <span class="comment">// error handling</span></div>
 338 <div class="line">    <span class="keywordflow">return</span>;</div>
 339 <div class="line">  }</div>
 340 <div class="line">}</div>
 341 <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>
 342 <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>
 343 <div class="ttc" id="agroup__wifi__interface__gr_html_a30afd9cb3113c037b5f1926f5ef93b59"><div class="ttname"><a href="group__wifi__interface__gr.html#a30afd9cb3113c037b5f1926f5ef93b59">ARM_DRIVER_WIFI::GetVersion</a></div><div class="ttdeci">ARM_DRIVER_VERSION(* GetVersion)(void)</div><div class="ttdef"><b>Definition:</b> Driver_WiFi.h:626</div></div>
 344 <div class="ttc" id="agroup__wifi__interface__gr_html_structARM__DRIVER__WIFI"><div class="ttname"><a href="group__wifi__interface__gr.html#structARM__DRIVER__WIFI">ARM_DRIVER_WIFI</a></div><div class="ttdoc">Access structure of the WiFi Driver.</div><div class="ttdef"><b>Definition:</b> Driver_WiFi.h:625</div></div>
 345 </div><!-- fragment -->
 346 </div>
 347 </div>
 348 <a id="ga3496996799a4762e9958a8b6af683b4b" name="ga3496996799a4762e9958a8b6af683b4b"></a>
 349 <h2 class="memtitle"><span class="permalink"><a href="#ga3496996799a4762e9958a8b6af683b4b">&#9670;&#160;</a></span>ARM_WIFI_GetCapabilities()</h2>
 350
 351 <div class="memitem">
 352 <div class="memproto">
 353       <table class="memname">
 354         <tr>
 355           <td class="memname"><a class="el" href="group__wifi__control__gr.html#structARM__WIFI__CAPABILITIES">ARM_WIFI_CAPABILITIES</a> ARM_WIFI_GetCapabilities </td>
 356           <td>(</td>
 357           <td class="paramtype">void&#160;</td>
 358           <td class="paramname"></td><td>)</td>
 359           <td></td>
 360         </tr>
 361       </table>
 362 </div><div class="memdoc">
 363
 364 <p>Get driver capabilities. </p>
 365 <dl class="section return"><dt>Returns</dt><dd><a class="el" href="group__wifi__control__gr.html#structARM__WIFI__CAPABILITIES">ARM_WIFI_CAPABILITIES</a></dd></dl>
 366 <p>The function <b>ARM_WIFI_GetCapabilities</b> retrieves information about capabilities in this driver implementation. The data fields of the struct <a class="el" href="group__wifi__control__gr.html#structARM__WIFI__CAPABILITIES">ARM_WIFI_CAPABILITIES</a> encode various capabilities, for example if a WiFi module supports the Access Point mode or the bypass mode, or is capable to signal events using the <a class="el" href="group__wifi__control__gr.html#ga0c8243dee4bb161132692516f048bcec">ARM_WIFI_SignalEvent</a> callback function.</p>
 367 <p><b>Example:</b> </p><div class="fragment"><div class="line"><span class="keyword">extern</span> <a class="code hl_struct" href="group__wifi__interface__gr.html#structARM__DRIVER__WIFI">ARM_DRIVER_WIFI</a> Driver_WiFi0;</div>
 368 <div class="line"><span class="keyword">static</span> <a class="code hl_struct" href="group__wifi__interface__gr.html#structARM__DRIVER__WIFI">ARM_DRIVER_WIFI</a> *wifi;</div>
 369 <div class="line">  </div>
 370 <div class="line"><span class="keywordtype">void</span> get_wifi_capabilities (<span class="keywordtype">void</span>)  {</div>
 371 <div class="line">  <a class="code hl_struct" href="group__wifi__control__gr.html#structARM__WIFI__CAPABILITIES">ARM_WIFI_CAPABILITIES</a> capabilities;</div>
 372 <div class="line"> </div>
 373 <div class="line">  wifi = &amp;Driver_WiFi0;  </div>
 374 <div class="line">  capabilities = wifi-&gt;<a class="code hl_variable" href="group__wifi__interface__gr.html#a10f74a292db2275b28b6b0eb6b22bea8">GetCapabilities</a> ();</div>
 375 <div class="line">  <span class="comment">// interrogate capabilities</span></div>
 376 <div class="line">   :</div>
 377 <div class="line">}</div>
 378 <div class="ttc" id="agroup__wifi__control__gr_html_structARM__WIFI__CAPABILITIES"><div class="ttname"><a href="group__wifi__control__gr.html#structARM__WIFI__CAPABILITIES">ARM_WIFI_CAPABILITIES</a></div><div class="ttdoc">WiFi Driver Capabilities.</div><div class="ttdef"><b>Definition:</b> Driver_WiFi.h:606</div></div>
 379 <div class="ttc" id="agroup__wifi__interface__gr_html_a10f74a292db2275b28b6b0eb6b22bea8"><div class="ttname"><a href="group__wifi__interface__gr.html#a10f74a292db2275b28b6b0eb6b22bea8">ARM_DRIVER_WIFI::GetCapabilities</a></div><div class="ttdeci">ARM_WIFI_CAPABILITIES(* GetCapabilities)(void)</div><div class="ttdef"><b>Definition:</b> Driver_WiFi.h:627</div></div>
 380 </div><!-- fragment -->
 381 </div>
 382 </div>
 383 <a id="gadc4b9aaae0fdf7d489b1d81e3c2f3474" name="gadc4b9aaae0fdf7d489b1d81e3c2f3474"></a>
 384 <h2 class="memtitle"><span class="permalink"><a href="#gadc4b9aaae0fdf7d489b1d81e3c2f3474">&#9670;&#160;</a></span>ARM_WIFI_Initialize()</h2>
 385
 386 <div class="memitem">
 387 <div class="memproto">
 388       <table class="memname">
 389         <tr>
 390           <td class="memname">int32_t ARM_WIFI_Initialize </td>
 391           <td>(</td>
 392           <td class="paramtype"><a class="el" href="group__wifi__control__gr.html#gac0f04bbdd431c87a680626154c3e0a41">ARM_WIFI_SignalEvent_t</a>&#160;</td>
 393           <td class="paramname"><em>cb_event</em></td><td>)</td>
 394           <td></td>
 395         </tr>
 396       </table>
 397 </div><div class="memdoc">
 398
 399 <p>Initialize WiFi Module. </p>
 400 <dl class="params"><dt>Parameters</dt><dd>
 401   <table class="params">
 402     <tr><td class="paramdir">[in]</td><td class="paramname">cb_event</td><td>Pointer to <a class="el" href="group__wifi__control__gr.html#gac0f04bbdd431c87a680626154c3e0a41">ARM_WIFI_SignalEvent_t</a> </td></tr>
 403   </table>
 404   </dd>
 405 </dl>
 406 <dl class="section return"><dt>Returns</dt><dd>execution status<ul>
 407 <li><a class="el" href="group__execution__status.html#ga85752c5de59e8adeb001e35ff5be6be7">ARM_DRIVER_OK</a> : Operation successful</li>
 408 <li><a class="el" href="group__execution__status.html#ga2f627075447749bb368d3b768be107cb">ARM_DRIVER_ERROR</a> : Operation failed</li>
 409 </ul>
 410 </dd></dl>
 411 <p>The function <b>ARM_WIFI_Initialize</b> initializes the WiFi module.</p>
 412 <p>It is called when the middleware component starts operation.</p>
 413 <p>The <a class="el" href="group__wifi__control__gr.html#gadc4b9aaae0fdf7d489b1d81e3c2f3474">ARM_WIFI_Initialize</a> function performs the following operations:</p><ul>
 414 <li>Initializes the resources and peripherals required for the WiFi module.</li>
 415 <li>Registers the <a class="el" href="group__wifi__control__gr.html#ga0c8243dee4bb161132692516f048bcec">ARM_WIFI_SignalEvent</a> callback function.</li>
 416 </ul>
 417 <p>The parameter <em>cb_event</em> is a pointer to the <a class="el" href="group__wifi__control__gr.html#ga0c8243dee4bb161132692516f048bcec">ARM_WIFI_SignalEvent</a> callback function; use a <span class="XML-Token">NULL</span> pointer when no callback signals are required.</p>
 418 <p><b>Example:</b> </p><div class="fragment"><div class="line"><span class="keyword">extern</span> <a class="code hl_struct" href="group__wifi__interface__gr.html#structARM__DRIVER__WIFI">ARM_DRIVER_WIFI</a> Driver_WiFi0;</div>
 419 <div class="line"><span class="keyword">static</span> <a class="code hl_struct" href="group__wifi__interface__gr.html#structARM__DRIVER__WIFI">ARM_DRIVER_WIFI</a> *wifi;</div>
 420 <div class="line"><span class="keyword">static</span> <a class="code hl_struct" href="group__eth__interface__gr.html#structARM__ETH__MAC__ADDR">ARM_ETH_MAC_ADDR</a> own_mac_address;</div>
 421 <div class="line"> </div>
 422 <div class="line"><span class="keywordtype">void</span> initialize_wifi (<span class="keywordtype">void</span>) {</div>
 423 <div class="line">  wifi = &amp;Driver_WiFi0;</div>
 424 <div class="line"> </div>
 425 <div class="line">  <span class="comment">// Initialize and Power-on WiFi Module</span></div>
 426 <div class="line">  wifi-&gt;<a class="code hl_variable" href="group__wifi__interface__gr.html#afe313d2860cfecd7b235dfa4a75ad0f9">Initialize</a> (NULL);</div>
 427 <div class="line">  wifi-&gt;<a class="code hl_variable" href="group__wifi__interface__gr.html#a24ebae5c6011631f76027f9a16eaf5ce">PowerControl</a> (<a class="code hl_enumvalue" href="Driver__Common_8h.html#ga47d6d7c31f88f3b8ae4aaf9d8444afa5abed52b77a9ce4775570e44a842b1295e">ARM_POWER_FULL</a>);</div>
 428 <div class="line"> </div>
 429 <div class="line">  <span class="comment">// Populate own_mac_address with the address to use</span></div>
 430 <div class="line">  wifi-&gt;<a class="code hl_variable" href="group__wifi__interface__gr.html#aee3ad2b5a66b88a9d66352b6429c69a3">SetOption</a>(<a class="code hl_define" href="group__WiFi__option.html#gafefb0fe1e5cdfb71f7f8cc7606840865">ARM_WIFI_MAC</a>, &amp;own_mac_address, 6U);</div>
 431 <div class="line">}</div>
 432 <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>
 433 <div class="ttc" id="agroup__WiFi__option_html_gafefb0fe1e5cdfb71f7f8cc7606840865"><div class="ttname"><a href="group__WiFi__option.html#gafefb0fe1e5cdfb71f7f8cc7606840865">ARM_WIFI_MAC</a></div><div class="ttdeci">#define ARM_WIFI_MAC</div><div class="ttdoc">Station/AP Set/Get MAC; data = &amp;mac, len = 6, uint8_t[6].</div></div>
 434 <div class="ttc" id="agroup__eth__interface__gr_html_structARM__ETH__MAC__ADDR"><div class="ttname"><a href="group__eth__interface__gr.html#structARM__ETH__MAC__ADDR">ARM_ETH_MAC_ADDR</a></div><div class="ttdoc">Ethernet MAC Address.</div><div class="ttdef"><b>Definition:</b> Driver_ETH.h:83</div></div>
 435 <div class="ttc" id="agroup__wifi__interface__gr_html_a24ebae5c6011631f76027f9a16eaf5ce"><div class="ttname"><a href="group__wifi__interface__gr.html#a24ebae5c6011631f76027f9a16eaf5ce">ARM_DRIVER_WIFI::PowerControl</a></div><div class="ttdeci">int32_t(* PowerControl)(ARM_POWER_STATE state)</div><div class="ttdef"><b>Definition:</b> Driver_WiFi.h:630</div></div>
 436 <div class="ttc" id="agroup__wifi__interface__gr_html_aee3ad2b5a66b88a9d66352b6429c69a3"><div class="ttname"><a href="group__wifi__interface__gr.html#aee3ad2b5a66b88a9d66352b6429c69a3">ARM_DRIVER_WIFI::SetOption</a></div><div class="ttdeci">int32_t(* SetOption)(uint32_t interface, uint32_t option, const void *data, uint32_t len)</div><div class="ttdef"><b>Definition:</b> Driver_WiFi.h:632</div></div>
 437 <div class="ttc" id="agroup__wifi__interface__gr_html_afe313d2860cfecd7b235dfa4a75ad0f9"><div class="ttname"><a href="group__wifi__interface__gr.html#afe313d2860cfecd7b235dfa4a75ad0f9">ARM_DRIVER_WIFI::Initialize</a></div><div class="ttdeci">int32_t(* Initialize)(ARM_WIFI_SignalEvent_t cb_event)</div><div class="ttdef"><b>Definition:</b> Driver_WiFi.h:628</div></div>
 438 </div><!-- fragment -->
 439 </div>
 440 </div>
 441 <a id="gae1e488d4ecc365e30712e6b1711a9c5d" name="gae1e488d4ecc365e30712e6b1711a9c5d"></a>
 442 <h2 class="memtitle"><span class="permalink"><a href="#gae1e488d4ecc365e30712e6b1711a9c5d">&#9670;&#160;</a></span>ARM_WIFI_Uninitialize()</h2>
 443
 444 <div class="memitem">
 445 <div class="memproto">
 446       <table class="memname">
 447         <tr>
 448           <td class="memname">int32_t ARM_WIFI_Uninitialize </td>
 449           <td>(</td>
 450           <td class="paramtype">void&#160;</td>
 451           <td class="paramname"></td><td>)</td>
 452           <td></td>
 453         </tr>
 454       </table>
 455 </div><div class="memdoc">
 456
 457 <p>De-initialize WiFi Module. </p>
 458 <dl class="section return"><dt>Returns</dt><dd>execution status<ul>
 459 <li><a class="el" href="group__execution__status.html#ga85752c5de59e8adeb001e35ff5be6be7">ARM_DRIVER_OK</a> : Operation successful</li>
 460 <li><a class="el" href="group__execution__status.html#ga2f627075447749bb368d3b768be107cb">ARM_DRIVER_ERROR</a> : Operation failed</li>
 461 </ul>
 462 </dd></dl>
 463 <p>The function <b>ARM_WIFI_Uninitialize</b> de-initializes the resources of the WiFi module.</p>
 464 <p>It is called when the middleware component stops operation and releases the software resources used by the module.</p>
 465 <p><b>Example:</b> </p><div class="fragment"><div class="line"><span class="keyword">extern</span> <a class="code hl_struct" href="group__wifi__interface__gr.html#structARM__DRIVER__WIFI">ARM_DRIVER_WIFI</a> Driver_WiFi0;</div>
 466 <div class="line"><span class="keyword">static</span> <a class="code hl_struct" href="group__wifi__interface__gr.html#structARM__DRIVER__WIFI">ARM_DRIVER_WIFI</a> *wifi;</div>
 467 <div class="line"> </div>
 468 <div class="line"><span class="keywordtype">void</span> uninitialize_wifi (<span class="keywordtype">void</span>) {</div>
 469 <div class="line">  wifi = &amp;Driver_WiFi0;</div>
 470 <div class="line"> </div>
 471 <div class="line">  <span class="comment">// Power off and De-initialize WiFi Module</span></div>
 472 <div class="line">  wifi-&gt;<a class="code hl_variable" href="group__wifi__interface__gr.html#a24ebae5c6011631f76027f9a16eaf5ce">PowerControl</a> (<a class="code hl_enumvalue" href="Driver__Common_8h.html#ga47d6d7c31f88f3b8ae4aaf9d8444afa5ab6f5becc85ebd51c3dd2524a95d2ca35">ARM_POWER_OFF</a>);</div>
 473 <div class="line">  wifi-&gt;<a class="code hl_variable" href="group__wifi__interface__gr.html#a5ce2b3d7a3a07099bf07d1eb253e92e3">Uninitialize</a> ();</div>
 474 <div class="line">}</div>
 475 <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>
 476 <div class="ttc" id="agroup__wifi__interface__gr_html_a5ce2b3d7a3a07099bf07d1eb253e92e3"><div class="ttname"><a href="group__wifi__interface__gr.html#a5ce2b3d7a3a07099bf07d1eb253e92e3">ARM_DRIVER_WIFI::Uninitialize</a></div><div class="ttdeci">int32_t(* Uninitialize)(void)</div><div class="ttdef"><b>Definition:</b> Driver_WiFi.h:629</div></div>
 477 </div><!-- fragment -->
 478 </div>
 479 </div>
 480 <a id="ga48d4cb7c00e96d2b928cc4468d4e623b" name="ga48d4cb7c00e96d2b928cc4468d4e623b"></a>
 481 <h2 class="memtitle"><span class="permalink"><a href="#ga48d4cb7c00e96d2b928cc4468d4e623b">&#9670;&#160;</a></span>ARM_WIFI_PowerControl()</h2>
 482
 483 <div class="memitem">
 484 <div class="memproto">
 485       <table class="memname">
 486         <tr>
 487           <td class="memname">int32_t ARM_WIFI_PowerControl </td>
 488           <td>(</td>
 489           <td class="paramtype"><a class="el" href="group__common__drv__gr.html#ga47d6d7c31f88f3b8ae4aaf9d8444afa5">ARM_POWER_STATE</a>&#160;</td>
 490           <td class="paramname"><em>state</em></td><td>)</td>
 491           <td></td>
 492         </tr>
 493       </table>
 494 </div><div class="memdoc">
 495
 496 <p>Control WiFi Module Power. </p>
 497 <dl class="params"><dt>Parameters</dt><dd>
 498   <table class="params">
 499     <tr><td class="paramdir">[in]</td><td class="paramname">state</td><td>Power state<ul>
 500 <li><a class="el" href="Driver__Common_8h.html#ga47d6d7c31f88f3b8ae4aaf9d8444afa5ab6f5becc85ebd51c3dd2524a95d2ca35">ARM_POWER_OFF</a> : Power off: no operation possible</li>
 501 <li><a class="el" href="Driver__Common_8h.html#ga47d6d7c31f88f3b8ae4aaf9d8444afa5a9ef9e57cbcc948d0e22314e73dc8c434">ARM_POWER_LOW</a> : Low-power mode: sleep or deep-sleep depending on <a class="el" href="group__WiFi__option.html#ga77e38a3d5d2fe8c04aebaf8d24e1b8d4">ARM_WIFI_LP_TIMER</a> option set</li>
 502 <li><a class="el" href="Driver__Common_8h.html#ga47d6d7c31f88f3b8ae4aaf9d8444afa5abed52b77a9ce4775570e44a842b1295e">ARM_POWER_FULL</a> : Power on: full operation at maximum performance </li>
 503 </ul>
 504 </td></tr>
 505   </table>
 506   </dd>
 507 </dl>
 508 <dl class="section return"><dt>Returns</dt><dd>execution status<ul>
 509 <li><a class="el" href="group__execution__status.html#ga85752c5de59e8adeb001e35ff5be6be7">ARM_DRIVER_OK</a> : Operation successful</li>
 510 <li><a class="el" href="group__execution__status.html#ga2f627075447749bb368d3b768be107cb">ARM_DRIVER_ERROR</a> : Operation failed</li>
 511 <li><a class="el" href="group__execution__status.html#ga2efa59e480d82697795439220e6884e4">ARM_DRIVER_ERROR_UNSUPPORTED</a> : Operation not supported</li>
 512 <li><a class="el" href="group__execution__status.html#gac781d4b70ce17c4c2efe2db045be751c">ARM_DRIVER_ERROR_PARAMETER</a> : Parameter error (invalid state)</li>
 513 </ul>
 514 </dd></dl>
 515 <p>The function <b>ARM_WIFI_PowerControl</b> allows you to configure the power modes of the WiFi module.</p>
 516 <p>The parameter <em>state</em> specifies the <a class="el" href="group__common__drv__gr.html#ga47d6d7c31f88f3b8ae4aaf9d8444afa5">ARM_POWER_STATE</a>.</p>
 517 <p>Low-power mode depends on additional options set by <a class="el" href="group__wifi__management__gr.html#gaf38a7aeb470eec596febc850c8b69ccf">ARM_WIFI_SetOption</a> :</p><ul>
 518 <li>Deep-sleep mode is entered when <a class="el" href="group__WiFi__option.html#ga77e38a3d5d2fe8c04aebaf8d24e1b8d4">ARM_WIFI_LP_TIMER</a> option is set to a value different than 0</li>
 519 <li>Sleep mode is entered otherwise</li>
 520 </ul>
 521 <p><b>Deep-sleep</b> mode (only for station): Module turns off the radio and also internal CPU thus reducing power consumption to minimum, only the timer is running that wakes-up the module after specified time. When timer expires the module reconnects to the access point.</p>
 522 <p>This mode is used when power consumption is a priority (battery powered devices) and when WiFi is used in short intervals that do not occur very often (example: sending a temperature from a sensor to a cloud every 10 seconds).</p>
 523 <p><b>Sleep</b> mode (only for station): Module reduces power consumption by going into sleep and waking up periodically to listen for beacons.</p>
 524 <p>Delivery Traffic Indication Message (DTIM) interval can be configured with option <a class="el" href="group__WiFi__option.html#ga947c297f1364993524bf515beba296f1">ARM_WIFI_DTIM</a> (station and access point) and beacon interval with option <a class="el" href="group__WiFi__option.html#ga6171d24c661b54465ced2dae7980897c">ARM_WIFI_BEACON</a> (only for access point).</p>
 525 <p>Default module intervals are used when those options are not explicitly set.</p>
 526 <p>If power <em>state</em> specifies an unsupported mode, the function returns <a class="el" href="group__execution__status.html#ga2efa59e480d82697795439220e6884e4">ARM_DRIVER_ERROR_UNSUPPORTED</a> as status information and the previous power state of the peripheral is unchanged. Multiple calls with the same <em>state</em> generate no error.</p>
 527 <p><b>Example:</b> </p><ul>
 528 <li>see <a class="el" href="group__wifi__control__gr.html#gadc4b9aaae0fdf7d489b1d81e3c2f3474">ARM_WIFI_Initialize</a></li>
 529 <li>see <a class="el" href="group__wifi__control__gr.html#gae1e488d4ecc365e30712e6b1711a9c5d">ARM_WIFI_Uninitialize</a> </li>
 530 </ul>
 531
 532 </div>
 533 </div>
 534 <a id="gabdc4c9966a3f22ac6e53119e71e67579" name="gabdc4c9966a3f22ac6e53119e71e67579"></a>
 535 <h2 class="memtitle"><span class="permalink"><a href="#gabdc4c9966a3f22ac6e53119e71e67579">&#9670;&#160;</a></span>ARM_WIFI_GetModuleInfo()</h2>
 536
 537 <div class="memitem">
 538 <div class="memproto">
 539       <table class="memname">
 540         <tr>
 541           <td class="memname">int32_t ARM_WIFI_GetModuleInfo </td>
 542           <td>(</td>
 543           <td class="paramtype">char *&#160;</td>
 544           <td class="paramname"><em>module_info</em>, </td>
 545         </tr>
 546         <tr>
 547           <td class="paramkey"></td>
 548           <td></td>
 549           <td class="paramtype">uint32_t&#160;</td>
 550           <td class="paramname"><em>max_len</em>&#160;</td>
 551         </tr>
 552         <tr>
 553           <td></td>
 554           <td>)</td>
 555           <td></td><td></td>
 556         </tr>
 557       </table>
 558 </div><div class="memdoc">
 559
 560 <p>Get Module information. </p>
 561 <dl class="params"><dt>Parameters</dt><dd>
 562   <table class="params">
 563     <tr><td class="paramdir">[out]</td><td class="paramname">module_info</td><td>Pointer to character buffer were info string will be returned </td></tr>
 564     <tr><td class="paramdir">[in]</td><td class="paramname">max_len</td><td>Maximum length of string to return (including null terminator) </td></tr>
 565   </table>
 566   </dd>
 567 </dl>
 568 <dl class="section return"><dt>Returns</dt><dd>execution status<ul>
 569 <li><a class="el" href="group__execution__status.html#ga85752c5de59e8adeb001e35ff5be6be7">ARM_DRIVER_OK</a> : Operation successful</li>
 570 <li><a class="el" href="group__execution__status.html#ga2f627075447749bb368d3b768be107cb">ARM_DRIVER_ERROR</a> : Operation failed</li>
 571 <li><a class="el" href="group__execution__status.html#ga2efa59e480d82697795439220e6884e4">ARM_DRIVER_ERROR_UNSUPPORTED</a> : Operation not supported</li>
 572 <li><a class="el" href="group__execution__status.html#gac781d4b70ce17c4c2efe2db045be751c">ARM_DRIVER_ERROR_PARAMETER</a> : Parameter error (NULL module_info pointer or max_len equals to 0)</li>
 573 </ul>
 574 </dd></dl>
 575 <p>The function <b>ARM_WIFI_GetModuleInfo</b> retrieves string containing information about the WiFi module.</p>
 576 <p>The information might include module name, firmware version, ...</p>
 577 <dl class="section note"><dt>Note</dt><dd>Module must be initialized and powered before module information can be retrieved.</dd></dl>
 578 <p><b>Example:</b> </p><div class="fragment"><div class="line"><span class="keyword">extern</span> <a class="code hl_struct" href="group__wifi__interface__gr.html#structARM__DRIVER__WIFI">ARM_DRIVER_WIFI</a> Driver_WiFi0;</div>
 579 <div class="line"><span class="keyword">static</span> <a class="code hl_struct" href="group__wifi__interface__gr.html#structARM__DRIVER__WIFI">ARM_DRIVER_WIFI</a> *wifi;</div>
 580 <div class="line"> </div>
 581 <div class="line"><span class="keywordtype">void</span> initialize_wifi (<span class="keywordtype">void</span>) {</div>
 582 <div class="line">  <span class="keywordtype">char</span> info[32];</div>
 583 <div class="line"> </div>
 584 <div class="line">  wifi = &amp;Driver_WiFi0;</div>
 585 <div class="line"> </div>
 586 <div class="line">  <span class="comment">// Initialize and Power-on WiFi Module</span></div>
 587 <div class="line">  wifi-&gt;<a class="code hl_variable" href="group__wifi__interface__gr.html#afe313d2860cfecd7b235dfa4a75ad0f9">Initialize</a> (NULL);</div>
 588 <div class="line">  wifi-&gt;<a class="code hl_variable" href="group__wifi__interface__gr.html#a24ebae5c6011631f76027f9a16eaf5ce">PowerControl</a> (<a class="code hl_enumvalue" href="Driver__Common_8h.html#ga47d6d7c31f88f3b8ae4aaf9d8444afa5abed52b77a9ce4775570e44a842b1295e">ARM_POWER_FULL</a>);</div>
 589 <div class="line"> </div>
 590 <div class="line">  <span class="comment">// Retrieve module information</span></div>
 591 <div class="line">  wifi-&gt;<a class="code hl_variable" href="group__wifi__interface__gr.html#a94076d882dce618464fe785352a50596">GetModuleInfo</a>(&amp;info, <span class="keyword">sizeof</span>(info));</div>
 592 <div class="line">}</div>
 593 <div class="ttc" id="agroup__wifi__interface__gr_html_a94076d882dce618464fe785352a50596"><div class="ttname"><a href="group__wifi__interface__gr.html#a94076d882dce618464fe785352a50596">ARM_DRIVER_WIFI::GetModuleInfo</a></div><div class="ttdeci">int32_t(* GetModuleInfo)(char *module_info, uint32_t max_len)</div><div class="ttdef"><b>Definition:</b> Driver_WiFi.h:631</div></div>
 594 </div><!-- fragment -->
 595 </div>
 596 </div>
 597 <a id="ga0c8243dee4bb161132692516f048bcec" name="ga0c8243dee4bb161132692516f048bcec"></a>
 598 <h2 class="memtitle"><span class="permalink"><a href="#ga0c8243dee4bb161132692516f048bcec">&#9670;&#160;</a></span>ARM_WIFI_SignalEvent()</h2>
 599
 600 <div class="memitem">
 601 <div class="memproto">
 602       <table class="memname">
 603         <tr>
 604           <td class="memname">void ARM_WIFI_SignalEvent </td>
 605           <td>(</td>
 606           <td class="paramtype">uint32_t&#160;</td>
 607           <td class="paramname"><em>event</em>, </td>
 608         </tr>
 609         <tr>
 610           <td class="paramkey"></td>
 611           <td></td>
 612           <td class="paramtype">void *&#160;</td>
 613           <td class="paramname"><em>arg</em>&#160;</td>
 614         </tr>
 615         <tr>
 616           <td></td>
 617           <td>)</td>
 618           <td></td><td></td>
 619         </tr>
 620       </table>
 621 </div><div class="memdoc">
 622
 623 <p>Signal WiFi Events. </p>
 624 <dl class="params"><dt>Parameters</dt><dd>
 625   <table class="params">
 626     <tr><td class="paramdir">[in]</td><td class="paramname">event</td><td><a class="el" href="group__wifi__event.html">WiFi Events</a> notification mask </td></tr>
 627     <tr><td class="paramdir">[in]</td><td class="paramname">arg</td><td>Pointer to argument of signaled event</td></tr>
 628   </table>
 629   </dd>
 630 </dl>
 631 <p>The function <b>ARM_WIFI_SignalEvent</b> is a callback function registered by the function <a class="el" href="group__wifi__control__gr.html#gadc4b9aaae0fdf7d489b1d81e3c2f3474">ARM_WIFI_Initialize</a>. It is called by the WiFi driver to notify the application about WiFi Events occurred during operation.</p>
 632 <p>The parameter <em>event</em> indicates the event that occurred during driver operation.</p>
 633 <p>The parameter <em>arg</em> provides additional information about the event.</p>
 634 <p>The following events can be generated:</p>
 635 <table class="markdownTable">
 636 <tr class="markdownTableHead">
 637 <th class="markdownTableHeadLeft">Parameter <em>event</em>   </th><th class="markdownTableHeadLeft">Description    </th></tr>
 638 <tr class="markdownTableRowOdd">
 639 <td class="markdownTableBodyLeft"><a class="el" href="group__wifi__event.html#ga4a87b9a3c3a404e3917d54df98469a62">ARM_WIFI_EVENT_AP_CONNECT</a>   </td><td class="markdownTableBodyLeft">Occurs in access point mode when a station has connected to the access point.    </td></tr>
 640 <tr class="markdownTableRowEven">
 641 <td class="markdownTableBodyLeft"><a class="el" href="group__wifi__event.html#ga271e73cda122e7ec3c5a5ca71d44eae3">ARM_WIFI_EVENT_AP_DISCONNECT</a>   </td><td class="markdownTableBodyLeft">Occurs in access point mode when a station has disconnected from the access point.    </td></tr>
 642 <tr class="markdownTableRowOdd">
 643 <td class="markdownTableBodyLeft"><a class="el" href="group__wifi__event.html#ga833f2c7a47bd2523d7a62ff6506a997f">ARM_WIFI_EVENT_ETH_RX_FRAME</a>   </td><td class="markdownTableBodyLeft">Occurs in <a class="el" href="group__wifi__bypass__gr.html">WiFi Bypass Mode</a> when an ethernet frame is received.   </td></tr>
 644 </table>
 645
 646 </div>
 647 </div>
 648 </div><!-- contents -->
 649 </div><!-- doc-content -->
 650 <!-- start footer part -->
 651 <div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
 652   <ul>
 653     <li class="footer">
 654       <script type="text/javascript">
 655         <!--
 656         writeFooter.call(this);
 657         //-->
 658       </script>
 659     </li>
 660   </ul>
 661 </div>
 662 </body>
 663 </html>