Domů Procházet Nápověda
Přihlásit se
ARM-software
/
CMSIS_5
zrcadlo https://github-proxy.rt-thread.io/ARM-software/CMSIS_5.git
2
0
Rozštěpit 0
Soubory Úkoly 0 Wiki
Strom: 5.7.0
Větve Značky
CMSIS_5
/
docs
/
Driver
/
html
/
group__eth__interface__gr.html

group__eth__interface__gr.html 26 KB
Trvalý odkaz Historie Surový

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363 
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
    2. 

  2. <html xmlns="http://www.w3.org/1999/xhtml">
    3. 

  3. <head>
    4. 

  4. <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
    5. 

  5. <meta http-equiv="X-UA-Compatible" content="IE=9"/>
    6. 

  6. <title>Ethernet Interface</title>
    7. 

  7. <title>CMSIS-Driver: Ethernet Interface</title>
    8. 

  8. <link href="tabs.css" rel="stylesheet" type="text/css"/>
    9. 

  9. <link href="cmsis.css" rel="stylesheet" type="text/css" />
    10. 

  10. <script type="text/javascript" src="jquery.js"></script>
    11. 

  11. <script type="text/javascript" src="dynsections.js"></script>
    12. 

  12. <script type="text/javascript" src="printComponentTabs.js"></script>
    13. 

  13. <link href="navtree.css" rel="stylesheet" type="text/css"/>
    14. 

  14. <script type="text/javascript" src="resize.js"></script>
    15. 

  15. <script type="text/javascript" src="navtree.js"></script>
    16. 

  16. <script type="text/javascript">
    17. 

  17.   $(document).ready(initResizable);
    18. 

  18.   $(window).load(resizeHeight);
    19. 

  19. </script>
    20. 

  20. <link href="search/search.css" rel="stylesheet" type="text/css"/>
    21. 

  21. <script type="text/javascript" src="search/search.js"></script>
    22. 

  22. <script type="text/javascript">
    23. 

  23.   $(document).ready(function() { searchBox.OnSelectItem(0); });
    24. 

  24. </script>
    25. 

  25. </head>
    26. 

  26. <body>
    27. 

  27. <div id="top"><!-- do not remove this div, it is closed by doxygen! -->
    28. 

  28. <div id="titlearea">
    29. 

  29. <table cellspacing="0" cellpadding="0">
    30. 

  30.  <tbody>
    31. 

  31.  <tr style="height: 46px;">
    32. 

  32.   <td id="projectlogo"><img alt="Logo" src="CMSIS_Logo_Final.png"/></td>
    33. 

  33.   <td style="padding-left: 0.5em;">
    34. 

  34.    <div id="projectname">CMSIS-Driver
    35. 

  35.    &#160;<span id="projectnumber">Version 2.8.0</span>
    36. 

  36.    </div>
    37. 

  37.    <div id="projectbrief">Peripheral Interface for Middleware and Application Code</div>
    38. 

  38.   </td>
    39. 

  39.  </tr>
    40. 

  40.  </tbody>
    41. 

  41. </table>
    42. 

  42. </div>
    43. 

  43. <!-- end header part -->
    44. 

  44. <div id="CMSISnav" class="tabs1">
    45. 

  45.     <ul class="tablist">
    46. 

  46.       <script type="text/javascript">
    47. 

  47. 		<!--
    48. 

  48. 		writeComponentTabs.call(this);
    49. 

  49. 		//-->
    50. 

  50.       </script>
    51. 

  51. 	  </ul>
    52. 

  52. </div>
    53. 

  53. <!-- Generated by Doxygen 1.8.6 -->
    54. 

  54. <script type="text/javascript">
    55. 

  55. var searchBox = new SearchBox("searchBox", "search",false,'Search');
    56. 

  56. </script>
    57. 

  57.   <div id="navrow1" class="tabs">
    58. 

  58.     <ul class="tablist">
    59. 

  59.       <li><a href="index.html"><span>Main&#160;Page</span></a></li>
    60. 

  60.       <li><a href="pages.html"><span>Usage&#160;and&#160;Description</span></a></li>
    61. 

  61.       <li><a href="modules.html"><span>Reference</span></a></li>
    62. 

  62.       <li>
    63. 

  63.         <div id="MSearchBox" class="MSearchBoxInactive">
    64. 

  64.         <span class="left">
    65. 

  65.           <img id="MSearchSelect" src="search/mag_sel.png"
    66. 

  66.                onmouseover="return searchBox.OnSearchSelectShow()"
    67. 

  67.                onmouseout="return searchBox.OnSearchSelectHide()"
    68. 

  68.                alt=""/>
    69. 

  69.           <input type="text" id="MSearchField" value="Search" accesskey="S"
    70. 

  70.                onfocus="searchBox.OnSearchFieldFocus(true)" 
    71. 

  71.                onblur="searchBox.OnSearchFieldFocus(false)" 
    72. 

  72.                onkeyup="searchBox.OnSearchFieldChange(event)"/>
    73. 

  73.           </span><span class="right">
    74. 

  74.             <a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
    75. 

  75.           </span>
    76. 

  76.         </div>
    77. 

  77.       </li>
    78. 

  78.     </ul>
    79. 

  79.   </div>
    80. 

  80. </div><!-- top -->
    81. 

  81. <div id="side-nav" class="ui-resizable side-nav-resizable">
    82. 

  82.   <div id="nav-tree">
    83. 

  83.     <div id="nav-tree-contents">
    84. 

  84.       <div id="nav-sync" class="sync"></div>
    85. 

  85.     </div>
    86. 

  86.   </div>
    87. 

  87.   <div id="splitbar" style="-moz-user-select:none;" 
    88. 

  88.        class="ui-resizable-handle">
    89. 

  89.   </div>
    90. 

  90. </div>
    91. 

  91. <script type="text/javascript">
    92. 

  92. $(document).ready(function(){initNavTree('group__eth__interface__gr.html','');});
    93. 

  93. </script>
    94. 

  94. <div id="doc-content">
    95. 

  95. <!-- window showing the filter options -->
    96. 

  96. <div id="MSearchSelectWindow"
    97. 

  97.      onmouseover="return searchBox.OnSearchSelectShow()"
    98. 

  98.      onmouseout="return searchBox.OnSearchSelectHide()"
    99. 

  99.      onkeydown="return searchBox.OnSearchSelectKey(event)">
    100. 

  100. <a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(0)"><span class="SelectionMark">&#160;</span>All</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(1)"><span class="SelectionMark">&#160;</span>Data Structures</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(2)"><span class="SelectionMark">&#160;</span>Files</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(3)"><span class="SelectionMark">&#160;</span>Functions</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(4)"><span class="SelectionMark">&#160;</span>Variables</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(5)"><span class="SelectionMark">&#160;</span>Typedefs</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(6)"><span class="SelectionMark">&#160;</span>Enumerations</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(7)"><span class="SelectionMark">&#160;</span>Enumerator</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(8)"><span class="SelectionMark">&#160;</span>Macros</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(9)"><span class="SelectionMark">&#160;</span>Groups</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(10)"><span class="SelectionMark">&#160;</span>Pages</a></div>
    101. 

  101. 

  102. <!-- iframe showing the search results (closed by default) -->
    103. 

  103. <div id="MSearchResultsWindow">
    104. 

  104. <iframe src="javascript:void(0)" frameborder="0" 
    105. 

  105.         name="MSearchResults" id="MSearchResults">
    106. 

  106. </iframe>
    107. 

  107. </div>
    108. 

  108. 

  109. <div class="header">
    110. 

  110.   <div class="summary">
    111. 

  111. <a href="#groups">Content</a> &#124;
    112. 

  112. <a href="#nested-classes">Data Structures</a> &#124;
    113. 

  113. <a href="#enum-members">Enumerations</a>  </div>
    114. 

  114.   <div class="headertitle">
    115. 

  115. <div class="title">Ethernet Interface</div>  </div>
    116. 

  116. </div><!--header-->
    117. 

  117. <div class="contents">
    118. 

  118. 

  119. <p>Ethernet common definitions (Driver_ETH.h)  
    120. 

  120. <a href="#details">More...</a></p>
    121. 

  121. <table class="memberdecls">
    122. 

  122. <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="groups"></a>
    123. 

  123. Content</h2></td></tr>
    124. 

  124. <tr class="memitem:group__eth__interface__types1"><td class="memItemLeft" align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__eth__interface__types1.html">Media Interface Types</a></td></tr>
    125. 

  125. <tr class="memdesc:group__eth__interface__types1"><td class="mdescLeft">&#160;</td><td class="mdescRight">Ethernet Media Interface type. <br/></td></tr>
    126. 

  126. <tr class="separator:"><td class="memSeparator" colspan="2">&#160;</td></tr>
    127. 

  127. <tr class="memitem:group__eth__mac__interface__gr"><td class="memItemLeft" align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__eth__mac__interface__gr.html">Ethernet MAC Interface</a></td></tr>
    128. 

  128. <tr class="memdesc:group__eth__mac__interface__gr"><td class="mdescLeft">&#160;</td><td class="mdescRight">Driver API for Ethernet MAC Peripheral (Driver_ETH_MAC.h) <br/></td></tr>
    129. 

  129. <tr class="separator:"><td class="memSeparator" colspan="2">&#160;</td></tr>
    130. 

  130. <tr class="memitem:group__eth__phy__interface__gr"><td class="memItemLeft" align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__eth__phy__interface__gr.html">Ethernet PHY Interface</a></td></tr>
    131. 

  131. <tr class="memdesc:group__eth__phy__interface__gr"><td class="mdescLeft">&#160;</td><td class="mdescRight">Driver API for Ethernet PHY Peripheral (Driver_ETH_PHY.h) <br/></td></tr>
    132. 

  132. <tr class="separator:"><td class="memSeparator" colspan="2">&#160;</td></tr>
    133. 

  133. </table><table class="memberdecls">
    134. 

  134. <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="nested-classes"></a>
    135. 

  135. Data Structures</h2></td></tr>
    136. 

  136. <tr class="memitem:structARM__ETH__LINK__INFO"><td class="memItemLeft" align="right" valign="top">struct &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__eth__interface__gr.html#structARM__ETH__LINK__INFO">ARM_ETH_LINK_INFO</a></td></tr>
    137. 

  137. <tr class="memdesc:structARM__ETH__LINK__INFO"><td class="mdescLeft">&#160;</td><td class="mdescRight">Ethernet link information.  <a href="group__eth__interface__gr.html#structARM__ETH__LINK__INFO">More...</a><br/></td></tr>
    138. 

  138. <tr class="separator:structARM__ETH__LINK__INFO"><td class="memSeparator" colspan="2">&#160;</td></tr>
    139. 

  139. <tr class="memitem:structARM__ETH__MAC__ADDR"><td class="memItemLeft" align="right" valign="top">struct &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__eth__interface__gr.html#structARM__ETH__MAC__ADDR">ARM_ETH_MAC_ADDR</a></td></tr>
    140. 

  140. <tr class="memdesc:structARM__ETH__MAC__ADDR"><td class="mdescLeft">&#160;</td><td class="mdescRight">Ethernet MAC Address.  <a href="group__eth__interface__gr.html#structARM__ETH__MAC__ADDR">More...</a><br/></td></tr>
    141. 

  141. <tr class="separator:structARM__ETH__MAC__ADDR"><td class="memSeparator" colspan="2">&#160;</td></tr>
    142. 

  142. </table><table class="memberdecls">
    143. 

  143. <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="enum-members"></a>
    144. 

  144. Enumerations</h2></td></tr>
    145. 

  145. <tr class="memitem:gacf7db5320eb841b462a4af3c56cc9291"><td class="memItemLeft" align="right" valign="top">enum &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__eth__interface__gr.html#gacf7db5320eb841b462a4af3c56cc9291">ARM_ETH_LINK_STATE</a> { <br/>
    146. 

  146. &#160;&#160;<a class="el" href="group__eth__interface__gr.html#gacf7db5320eb841b462a4af3c56cc9291a5f635c9352db6cb6fa9ad95660850487">ARM_ETH_LINK_DOWN</a>, 
    147. 

  147. <br/>
    148. 

  148. &#160;&#160;<a class="el" href="group__eth__interface__gr.html#gacf7db5320eb841b462a4af3c56cc9291ab5e5b02c3c8a5a0fefcf69f3be7e31c1">ARM_ETH_LINK_UP</a>
    149. 

  149. <br/>
    150. 

  150.  }</td></tr>
    151. 

  151. <tr class="memdesc:gacf7db5320eb841b462a4af3c56cc9291"><td class="mdescLeft">&#160;</td><td class="mdescRight">Ethernet link state.  <a href="group__eth__interface__gr.html#gacf7db5320eb841b462a4af3c56cc9291">More...</a><br/></td></tr>
    152. 

  152. <tr class="separator:gacf7db5320eb841b462a4af3c56cc9291"><td class="memSeparator" colspan="2">&#160;</td></tr>
    153. 

  153. </table>
    154. 

  154. <a name="details" id="details"></a><h2 class="groupheader">Description</h2>
    155. 

  155. <p>Ethernet common definitions (Driver_ETH.h) </p>
    156. 

  156. <p><b>Ethernet</b> is a networking technology for exchanging data packages between computer systems. Several microcontrollers integrate an Ethernet MAC (Media Access Control) data-link layer that interfaces to an Ethernet PHY (Physical Interface Transceiver).</p>
    157. 

  157. <p>Wikipedia offers more information about the <a href="http://en.wikipedia.org/wiki/Ethernet" target="_blank"><b>Ethernet</b></a>.</p>
    158. 

  158. <p><b>Block Diagram</b></p>
    159. 

  159. <p>The Ethernet PHY connects typically to the Ethernet MAC using an MII (Media Independent Interface) or RMII (Reduced Media Independent Interface).</p>
    160. 

  160. <p><br/>
    161. 

  161. </p>
    162. 

  162. <div class="image">
    163. 

  163. <img src="EthernetSchematic.png" alt="EthernetSchematic.png"/>
    164. 

  164. <div class="caption">
    165. 

  165. Block Diagram of a typical Ethernet Interface</div></div>
    166. 

  166. <p><b>Ethernet API</b></p>
    167. 

  167. <p>The following header files define the Application Programming Interface (API) for the <b>Ethernet</b> interface:</p>
    168. 

  168. <ul>
    169. 

  169. <li><b>Driver_ETH.h</b> : Common definitions of the Ethernet PHY and MAC part</li>
    170. 

  170. <li><b>Driver_ETH_MAC.h</b> : API for the Ethernet MAC</li>
    171. 

  171. <li><b>Driver_ETH_PHY.h</b> : API for the Ethernet PHY</li>
    172. 

  172. </ul>
    173. 

  173. <p>The driver implementation of the Ethernet MAC is a typical part of a Device Family Pack (DFP) that supports the peripherals of the microcontroller family. The driver implementation of the Ethernet PHY is a typical part of a <b>Network</b> Software Pack, since PHY is typically not integrated into the microcontroller.</p>
    174. 

  174. <dl class="section note"><dt>Note</dt><dd>For parameters, the value marked with (default) is the setting after the driver initialization.</dd></dl>
    175. 

  175. <p><b>Driver Functions</b></p>
    176. 

  176. <p>The driver functions are published in the access struct as explained in <a class="el" href="theoryOperation.html#DriverFunctions">Common Driver Functions</a></p>
    177. 

  177. <ul>
    178. 

  178. <li><a class="el" href="group__eth__mac__interface__gr.html#structARM__DRIVER__ETH__MAC">ARM_DRIVER_ETH_MAC</a> : access struct for <b>Ethernet MAC</b> driver functions.</li>
    179. 

  179. <li><a class="el" href="group__eth__phy__interface__gr.html#structARM__DRIVER__ETH__PHY">ARM_DRIVER_ETH_PHY</a> : access struct for <b>Ethernet PHY</b> driver functions.</li>
    180. 

  180. </ul>
    181. 

  181. <p>Both drivers are used in combination and usually the Ethernet MAC provides a media interface to the Ethernet PHY. A typical setup sequence for the drivers is shown below:</p>
    182. 

  182. <p><b>Example Code</b></p>
    183. 

  183. <p>The following example code shows the usage of the Ethernet interface.</p>
    184. 

  184. <div class="fragment"><div class="line"><span class="keyword">extern</span> <a class="code" href="group__eth__mac__interface__gr.html#structARM__DRIVER__ETH__MAC">ARM_DRIVER_ETH_MAC</a> Driver_ETH_MAC0;</div>
    185. 

  185. <div class="line"><span class="keyword">extern</span> <a class="code" href="group__eth__phy__interface__gr.html#structARM__DRIVER__ETH__PHY">ARM_DRIVER_ETH_PHY</a> Driver_ETH_PHY0;</div>
    186. 

  186. <div class="line"> </div>
    187. 

  187. <div class="line"><span class="keyword">static</span> <a class="code" href="group__eth__mac__interface__gr.html#structARM__DRIVER__ETH__MAC">ARM_DRIVER_ETH_MAC</a> *mac;</div>
    188. 

  188. <div class="line"><span class="keyword">static</span> <a class="code" href="group__eth__phy__interface__gr.html#structARM__DRIVER__ETH__PHY">ARM_DRIVER_ETH_PHY</a> *phy;</div>
    189. 

  189. <div class="line"><span class="keyword">static</span> <a class="code" href="group__eth__interface__gr.html#structARM__ETH__MAC__ADDR">ARM_ETH_MAC_ADDR</a>          own_mac_address;</div>
    190. 

  190. <div class="line"><span class="keyword">static</span> <a class="code" href="group__eth__mac__interface__gr.html#structARM__ETH__MAC__CAPABILITIES">ARM_ETH_MAC_CAPABILITIES</a>  capabilities;</div>
    191. 

  191. <div class="line"> </div>
    192. 

  192. <div class="line"><span class="keywordtype">void</span> ethernet_mac_notify (uint32_t event)  {</div>
    193. 

  193. <div class="line">  <span class="keywordflow">switch</span> (event)  {</div>
    194. 

  194. <div class="line">     :</div>
    195. 

  195. <div class="line">  }  </div>
    196. 

  196. <div class="line">}</div>
    197. 

  197. <div class="line"> </div>
    198. 

  198. <div class="line"> </div>
    199. 

  199. <div class="line"><span class="keywordtype">void</span> initialize_ethernet_interface (<span class="keywordtype">void</span>) {</div>
    200. 

  200. <div class="line">  mac = &amp;Driver_ETH_MAC0;</div>
    201. 

  201. <div class="line">  phy = &amp;Driver_ETH_PHY0;</div>
    202. 

  202. <div class="line"> </div>
    203. 

  203. <div class="line">  <span class="comment">// Initialize Media Access Controller</span></div>
    204. 

  204. <div class="line">  capabilities = mac-&gt;<a class="code" href="group__eth__mac__interface__gr.html#a9fd725bb058c584a9ced9c579561cdf1">GetCapabilities</a> ();</div>
    205. 

  205. <div class="line">   </div>
    206. 

  206. <div class="line">  mac-&gt;<a class="code" href="group__eth__mac__interface__gr.html#aa34417c70cb8b43567c59aa530866cc7">Initialize</a> (ethernet_mac_notify);</div>
    207. 

  207. <div class="line">  mac-&gt;<a class="code" href="group__eth__mac__interface__gr.html#aba8f1c8019af95ffe19c32403e3240ef">PowerControl</a> (<a class="code" href="Driver__Common_8h.html#ga47d6d7c31f88f3b8ae4aaf9d8444afa5abed52b77a9ce4775570e44a842b1295e">ARM_POWER_FULL</a>);</div>
    208. 

  208. <div class="line"> </div>
    209. 

  209. <div class="line">  <span class="keywordflow">if</span> (capabilities.<a class="code" href="group__eth__mac__interface__gr.html#a7fdea04bacd9c0e12792751055ef6238">mac_address</a> == 0)  {</div>
    210. 

  210. <div class="line">    <span class="comment">// populate own_mac_address with the address to use</span></div>
    211. 

  211. <div class="line">    mac-&gt;<a class="code" href="group__eth__mac__interface__gr.html#ac640f929dc4d5bde3e4282c75b25c00d">SetMacAddress</a>(&amp;own_mac_address);</div>
    212. 

  212. <div class="line">  }</div>
    213. 

  213. <div class="line">  <span class="keywordflow">else</span> {</div>
    214. 

  214. <div class="line">    mac-&gt;<a class="code" href="group__eth__mac__interface__gr.html#a02837059933cd04b04bf795a7138f218">GetMacAddress</a>(&amp;own_mac_address);</div>
    215. 

  215. <div class="line">  }</div>
    216. 

  216. <div class="line"> </div>
    217. 

  217. <div class="line">  <span class="comment">// Initialize Physical Media Interface</span></div>
    218. 

  218. <div class="line">  <span class="keywordflow">if</span> (phy-&gt;<a class="code" href="group__eth__phy__interface__gr.html#a9f9e7173bf8fed4d774fa48da53739ba">Initialize</a> (mac-&gt;<a class="code" href="group__eth__mac__interface__gr.html#a0f2ddb734e4242077275761400b26e35">PHY_Read</a>, mac-&gt;<a class="code" href="group__eth__mac__interface__gr.html#ac3efe9bdc31c3b1d7fd8eb82bbfb4c13">PHY_Write</a>) == <a class="code" href="group__execution__status.html#ga85752c5de59e8adeb001e35ff5be6be7">ARM_DRIVER_OK</a>) {</div>
    219. 

  219. <div class="line">    phy-&gt;<a class="code" href="group__eth__phy__interface__gr.html#aba8f1c8019af95ffe19c32403e3240ef">PowerControl</a> (<a class="code" href="Driver__Common_8h.html#ga47d6d7c31f88f3b8ae4aaf9d8444afa5abed52b77a9ce4775570e44a842b1295e">ARM_POWER_FULL</a>);</div>
    220. 

  220. <div class="line">    phy-&gt;<a class="code" href="group__eth__phy__interface__gr.html#a7dfc7cf346c80e7fdb2fe4cea2c61161">SetInterface</a> (capabilities.<a class="code" href="group__eth__mac__interface__gr.html#a3c5cb74e086417a01d0079f847a3fc8d">media_interface</a>);</div>
    221. 

  221. <div class="line">    phy-&gt;<a class="code" href="group__eth__phy__interface__gr.html#ae6686344f4d6afa0881d1e545c898a3d">SetMode</a> (<a class="code" href="group__eth__phy__mode__ctrls.html#ga6a8c54f8fed3e5f68bd04eb715d10ab9">ARM_ETH_PHY_AUTO_NEGOTIATE</a>);</div>
    222. 

  222. <div class="line">  }</div>
    223. 

  223. <div class="line">    :</div>
    224. 

  224. <div class="line">    :</div>
    225. 

  225. <div class="line">}</div>
    226. 

  226. <div class="line"> </div>
    227. 

  227. <div class="line"> </div>
    228. 

  228. <div class="line"><span class="keyword">static</span> <a class="code" href="group__eth__interface__gr.html#gacf7db5320eb841b462a4af3c56cc9291">ARM_ETH_LINK_STATE</a> ethernet_link;   <span class="comment">// current link status</span></div>
    229. 

  229. <div class="line"> </div>
    230. 

  230. <div class="line"><span class="keywordtype">void</span> ethernet_check_link_status (<span class="keywordtype">void</span>) {</div>
    231. 

  231. <div class="line">  <a class="code" href="group__eth__interface__gr.html#gacf7db5320eb841b462a4af3c56cc9291">ARM_ETH_LINK_STATE</a> link;</div>
    232. 

  232. <div class="line"> </div>
    233. 

  233. <div class="line">  link = phy-&gt;<a class="code" href="group__eth__phy__interface__gr.html#a0e25b2f267edc874f1bd785175fcf08a">GetLinkState</a> ();</div>
    234. 

  234. <div class="line">  <span class="keywordflow">if</span> (link == ethernet_link) {    </div>
    235. 

  235. <div class="line">    <span class="keywordflow">return</span>;                                <span class="comment">// link state unchanged</span></div>
    236. 

  236. <div class="line">  }</div>
    237. 

  237. <div class="line">                                           <span class="comment">// link state changed</span></div>
    238. 

  238. <div class="line">  ethernet_link = link;   </div>
    239. 

  239. <div class="line">  <span class="keywordflow">if</span> (link == <a class="code" href="Driver__ETH_8h.html#gacf7db5320eb841b462a4af3c56cc9291ab5e5b02c3c8a5a0fefcf69f3be7e31c1">ARM_ETH_LINK_UP</a>) {      <span class="comment">// start transfer</span></div>
    240. 

  240. <div class="line">    <a class="code" href="group__eth__interface__gr.html#structARM__ETH__LINK__INFO">ARM_ETH_LINK_INFO</a> info = phy-&gt;<a class="code" href="group__eth__phy__interface__gr.html#ac162bfaf93512fa0966bfbb923c45463">GetLinkInfo</a> ();</div>
    241. 

  241. <div class="line">    mac-&gt;<a class="code" href="group__eth__mac__interface__gr.html#a6e0f47a92f626a971c5197fca6545505">Control</a>(<a class="code" href="group__eth__mac__ctrls.html#ga7819c7a1aa7bbc13dc42d0fd7e75a23c">ARM_ETH_MAC_CONFIGURE</a>,</div>
    242. 

  242. <div class="line">                 info.<a class="code" href="group__eth__interface__gr.html#a220859a8b5da0232739a11cbe7f79fc5">speed</a>  &lt;&lt; <a class="code" href="Driver__ETH__MAC_8h.html#ad7fd5c5f4d4f39a56466c2d34cb699ef">ARM_ETH_MAC_SPEED_Pos</a>  |</div>
    243. 

  243. <div class="line">                 info.<a class="code" href="group__eth__interface__gr.html#a44b6cae894d7311dcdae7e93969c3c09">duplex</a> &lt;&lt; <a class="code" href="Driver__ETH__MAC_8h.html#a245688f6265e8d017435dc6d2c233b87">ARM_ETH_MAC_DUPLEX_Pos</a> |</div>
    244. 

  244. <div class="line">                 <a class="code" href="group__eth__mac__configuration__ctrls.html#ga43792feab641c3c87eafb943351ab0f4">ARM_ETH_MAC_ADDRESS_BROADCAST</a>);</div>
    245. 

  245. <div class="line">    mac-&gt;<a class="code" href="group__eth__mac__interface__gr.html#a6e0f47a92f626a971c5197fca6545505">Control</a>(<a class="code" href="group__eth__mac__ctrls.html#ga3a98c8a7ee5ed4b1ffd250eecaeefe5c">ARM_ETH_MAC_CONTROL_TX</a>, 1);</div>
    246. 

  246. <div class="line">    mac-&gt;<a class="code" href="group__eth__mac__interface__gr.html#a6e0f47a92f626a971c5197fca6545505">Control</a>(<a class="code" href="group__eth__mac__ctrls.html#gae0964364b81b38b6e1fbf7196f3be869">ARM_ETH_MAC_CONTROL_RX</a>, 1);</div>
    247. 

  247. <div class="line">  }</div>
    248. 

  248. <div class="line">  <span class="keywordflow">else</span> {                                   <span class="comment">// stop transfer</span></div>
    249. 

  249. <div class="line">    mac-&gt;<a class="code" href="group__eth__mac__interface__gr.html#a6e0f47a92f626a971c5197fca6545505">Control</a>(<a class="code" href="group__eth__mac__ctrls.html#ga530812ef349a2e297f23de72e660fe27">ARM_ETH_MAC_FLUSH</a>, <a class="code" href="group__eth__mac__flush__flag__ctrls.html#ga2d10ff33f4f4927820c6a17a2262b120">ARM_ETH_MAC_FLUSH_TX</a> | <a class="code" href="group__eth__mac__flush__flag__ctrls.html#gac18950811038319960756f063e1ef6d4">ARM_ETH_MAC_FLUSH_RX</a>);</div>
    250. 

  250. <div class="line">    mac-&gt;<a class="code" href="group__eth__mac__interface__gr.html#a6e0f47a92f626a971c5197fca6545505">Control</a>(<a class="code" href="group__eth__mac__ctrls.html#ga3a98c8a7ee5ed4b1ffd250eecaeefe5c">ARM_ETH_MAC_CONTROL_TX</a>, 0);</div>
    251. 

  251. <div class="line">    mac-&gt;<a class="code" href="group__eth__mac__interface__gr.html#a6e0f47a92f626a971c5197fca6545505">Control</a>(<a class="code" href="group__eth__mac__ctrls.html#gae0964364b81b38b6e1fbf7196f3be869">ARM_ETH_MAC_CONTROL_RX</a>, 0);</div>
    252. 

  252. <div class="line">  }</div>
    253. 

  253. <div class="line">}</div>
    254. 

  254. </div><!-- fragment --> <hr/><h2 class="groupheader">Data Structure Documentation</h2>
    255. 

  255. <a name="structARM__ETH__LINK__INFO" id="structARM__ETH__LINK__INFO"></a>
    256. 

  256. <div class="memitem">
    257. 

  257. <div class="memproto">
    258. 

  258.       <table class="memname">
    259. 

  259.         <tr>
    260. 

  260.           <td class="memname">struct ARM_ETH_LINK_INFO</td>
    261. 

  261.         </tr>
    262. 

  262.       </table>
    263. 

  263. </div><div class="memdoc">
    264. 

  264. <div class="textblock"><p>Ethernet link information. </p>
    265. 

  265. <p>The Ethernet Link information provides parameters about the current established communication.</p>
    266. 

  266. <p><b>Returned by:</b></p>
    267. 

  267. <ul>
    268. 

  268. <li><a class="el" href="group__eth__phy__interface__gr.html#ga8c79dcd7a12656403f3befab3c8605a2">ARM_ETH_PHY_GetLinkInfo</a> </li>
    269. 

  269. </ul>
    270. 

  270. </div><table class="fieldtable">
    271. 

  271. <tr><th colspan="3">Data Fields</th></tr>
    272. 

  272. <tr><td class="fieldtype">
    273. 

  273. <a class="anchor" id="a220859a8b5da0232739a11cbe7f79fc5"></a>uint32_t</td>
    274. 

  274. <td class="fieldname">
    275. 

  275. speed: 2</td>
    276. 

  276. <td class="fielddoc">
    277. 

  277. Link speed: 0= 10 MBit, 1= 100 MBit, 2= 1 GBit. </td></tr>
    278. 

  278. <tr><td class="fieldtype">
    279. 

  279. <a class="anchor" id="a44b6cae894d7311dcdae7e93969c3c09"></a>uint32_t</td>
    280. 

  280. <td class="fieldname">
    281. 

  281. duplex: 1</td>
    282. 

  282. <td class="fielddoc">
    283. 

  283. Duplex mode: 0= Half, 1= Full. </td></tr>
    284. 

  284. <tr><td class="fieldtype">
    285. 

  285. <a class="anchor" id="aa43c4c21b173ada1b6b7568956f0d650"></a>uint32_t</td>
    286. 

  286. <td class="fieldname">
    287. 

  287. reserved: 29</td>
    288. 

  288. <td class="fielddoc">
    289. 

  289. </td></tr>
    290. 

  290. </table>
    291. 

  291. 

  292. </div>
    293. 

  293. </div>
    294. 

  294. <a name="structARM__ETH__MAC__ADDR" id="structARM__ETH__MAC__ADDR"></a>
    295. 

  295. <div class="memitem">
    296. 

  296. <div class="memproto">
    297. 

  297.       <table class="memname">
    298. 

  298.         <tr>
    299. 

  299.           <td class="memname">struct ARM_ETH_MAC_ADDR</td>
    300. 

  300.         </tr>
    301. 

  301.       </table>
    302. 

  302. </div><div class="memdoc">
    303. 

  303. <div class="textblock"><p>Ethernet MAC Address. </p>
    304. 

  304. <p>Stores the MAC Address of the Ethernet interface as defined by IEEE 802. Wikipedia offers more information about the <a href="http://en.wikipedia.org/wiki/MAC_address" target="_blank"><b>MAC Address</b></a>.</p>
    305. 

  305. <p><b>Parameter for:</b></p>
    306. 

  306. <ul>
    307. 

  307. <li><a class="el" href="group__eth__mac__interface__gr.html#ga66308c1e791952047e974bd653037fae">ARM_ETH_MAC_GetMacAddress</a>, <a class="el" href="group__eth__mac__interface__gr.html#ga7cc3d17c7312c5032202dfd9a915f24a">ARM_ETH_MAC_SetMacAddress</a>, <a class="el" href="group__eth__mac__interface__gr.html#ga150fe30290275a4b32756f94208124e8">ARM_ETH_MAC_SetAddressFilter</a> </li>
    308. 

  308. </ul>
    309. 

  309. </div><table class="fieldtable">
    310. 

  310. <tr><th colspan="3">Data Fields</th></tr>
    311. 

  311. <tr><td class="fieldtype">
    312. 

  312. <a class="anchor" id="ab590318ac859d0e57e15c3dd6c62a605"></a>uint8_t</td>
    313. 

  313. <td class="fieldname">
    314. 

  314. b[6]</td>
    315. 

  315. <td class="fielddoc">
    316. 

  316. MAC Address (6 bytes), MSB first. </td></tr>
    317. 

  317. </table>
    318. 

  318. 

  319. </div>
    320. 

  320. </div>
    321. 

  321. <h2 class="groupheader">Enumeration Type Documentation</h2>
    322. 

  322. <a class="anchor" id="gacf7db5320eb841b462a4af3c56cc9291"></a>
    323. 

  323. <div class="memitem">
    324. 

  324. <div class="memproto">
    325. 

  325.       <table class="memname">
    326. 

  326.         <tr>
    327. 

  327.           <td class="memname">enum <a class="el" href="group__eth__interface__gr.html#gacf7db5320eb841b462a4af3c56cc9291">ARM_ETH_LINK_STATE</a></td>
    328. 

  328.         </tr>
    329. 

  329.       </table>
    330. 

  330. </div><div class="memdoc">
    331. 

  331. 

  332. <p>Ethernet link state. </p>
    333. 

  333. <p>The Ethernet Link status shows if the communication is currently established (up) or interrupted (down).</p>
    334. 

  334. <p><b>Returned by:</b></p>
    335. 

  335. <ul>
    336. 

  336. <li><a class="el" href="group__eth__phy__interface__gr.html#ga4085cd24ebe33b78d51a3c003da4a5ba">ARM_ETH_PHY_GetLinkState</a> </li>
    337. 

  337. </ul>
    338. 

  338. <table class="fieldtable">
    339. 

  339. <tr><th colspan="2">Enumerator</th></tr><tr><td class="fieldname"><em><a class="anchor" id="gacf7db5320eb841b462a4af3c56cc9291a5f635c9352db6cb6fa9ad95660850487"></a>ARM_ETH_LINK_DOWN</em>&#160;</td><td class="fielddoc">
    340. 

  340. <p>Link is down. </p>
    341. 

  341. </td></tr>
    342. 

  342. <tr><td class="fieldname"><em><a class="anchor" id="gacf7db5320eb841b462a4af3c56cc9291ab5e5b02c3c8a5a0fefcf69f3be7e31c1"></a>ARM_ETH_LINK_UP</em>&#160;</td><td class="fielddoc">
    343. 

  343. <p>Link is up. </p>
    344. 

  344. </td></tr>
    345. 

  345. </table>
    346. 

  346. 

  347. </div>
    348. 

  348. </div>
    349. 

  349. </div><!-- contents -->
    350. 

  350. </div><!-- doc-content -->
    351. 

  351. <!-- start footer part -->
    352. 

  352. <div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
    353. 

  353.   <ul>
    354. 

  354.     <li class="footer">Generated on Thu Apr 9 2020 15:49:14 for CMSIS-Driver Version 2.8.0 by Arm Ltd. All rights reserved.
    355. 

  355. 	<!--
    356. 

  356.     <a href="http://www.doxygen.org/index.html">
    357. 

  357.     <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.8.6 
    358. 

  358. 	-->
    359. 

  359. 	</li>
    360. 

  360.   </ul>
    361. 

  361. </div>
    362. 

  362. </body>
    363. 

  363. </html>
    364.