Accueil Explorer Aide
Connexion
SoftwareDesign
/
csu3_am335x
8
0
Fork 0
Fichiers Tickets 0 Pull Requests 0 Wiki
Branche: master
Branches Tags
csu3_am335x
/
EVSE
/
GPL
/
open-plc-utils-0.3
/
docbook
/
ch07s04.html

ch07s04.html 8.7 KB
Lien permanent Historique Raw

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253 
  1. <html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Network Functions</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><meta name="keywords" content="Intellon, Atheros, Qualcomm, HomePlug, powerline, communications, INT6000, INT6300, INT6400, AR7400, AR7420"><link rel="home" href="index.html" title="Qualcomm Atheros Open Powerline Toolkit"><link rel="up" href="ch07.html" title="Chapter 7.  Support Function Reference"><link rel="prev" href="ch07s03.html" title="Ethernet Functions"><link rel="next" href="ch07s05.html" title="Generic Functions"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">
    2. 

  2. 		Network Functions
    3. 

  3. 		</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch07s03.html">Prev</a> </td><th width="60%" align="center">Chapter 7. 
    4. 

  4. 		Support Function Reference
    5. 

  5. 		</th><td width="20%" align="right"> <a accesskey="n" href="ch07s05.html">Next</a></td></tr></table><hr></div><div class="section" title="Network Functions"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="support-network"></a>
    6. 

  6. 		Network Functions
    7. 

  7. 		</h2></div></div></div><div class="section" title="NetworkBridges"><div class="titlepage"><div><div><h3 class="title"><a name="support-networkbridges"></a>
    8. 

  8. 			NetworkBridges
    9. 

  9. 			</h3></div></div></div><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" class="funcprototype-table"><tr><td><code class="funcdef">size_t <b class="fsfunc">NetworkBridges</b>(</code></td><td><var class="pdparam">channel</var>, </td><td> </td></tr><tr><td> </td><td><var class="pdparam">memory</var>, </td><td> </td></tr><tr><td> </td><td><var class="pdparam">extent</var><code>)</code>;</td><td> </td></tr></table><div class="paramdef-list"><code>struct channel * <var class="pdparam">channel</var></code>;<br><code>void  * <var class="pdparam">memory</var></code>;<br><code>size_t <var class="pdparam">extent</var></code>;</div><div class="funcprototype-spacer"> </div></div><p>
    10. 

  10. 			Search a channel for local powerline devices (bridges) and store their Ethernet hardware in consecutive <code class="varname">memory</code> locations. The memory <code class="varname">extent</code> is specified in bytes. The number of devices found is returned as the function value,  provided enough space is available to store all addressed. Unlike function <a class="link" href="ch07s04.html#support-networkdevices" title="NetworkDevices">NetworkDevices</a>, the channel <code class="varname">peer</code> address is ignored. 
    11. 

  11. 			</p><p>
    12. 

  12. 			We call local devices <span class="quote">“<span class="quote">bridges</span>”</span> because each serves as an Ethernet-to-Powerline bridge for the local host.
    13. 

  13. 			</p><div class="example"><a name="idp23363184"></a><p class="title"><b>Example 7.1. 
    14. 

  14. 				Enumerating Local Devices
    15. 

  15. 				</b></p><div class="example-contents"><pre class="programlisting">
    16. 

  16. #include &lt;net/if.h&gt;
    17. 

  17. #include "../ether/channel.h"
    18. 

  18. extern struct channel <code class="varname">channel</code>; 
    19. 

  19. uint8_t <code class="varname">address</code> [<code class="constant">255</code>][<code class="constant">ETHER_ADDR_LEN</code>]; 
    20. 

  20. size_t <code class="varname">bridges</code> = <code class="function">NetworkBridges</code> (&amp;<code class="varname">channel</code>, <code class="varname">address</code>, sizeof (<code class="varname">address</code>));
    21. 

  21. size_t <code class="varname">bridge</code> = 0; 
    22. 

  22. while (<code class="varname">bridge</code> &lt; <code class="varname">bridges</code>)
    23. 

  23. {
    24. 

  24.    <code class="function">binout</code> (<code class="varname">address</code> [<code class="varname">bridge</code>], <code class="constant">ETHER_ADDR_LEN</code>, <code class="constant">':'</code>, stdout);
    25. 

  25.    <code class="function">putc</code> (<code class="constant">'\n'</code>, <code class="varname">stdout</code>);  
    26. 

  26. } 
    27. 

  27. </pre><p>
    28. 

  28. 				The code segment shown above illustrates how to use function <code class="varname">NetworkBridges</code> to identify all local devices. We do not need to set the <a class="link" href="ch07s03.html#support-channel" title="channel">channel</a> <code class="varname">peer</code> because <code class="varname">NetworkBridges</code> always uses the Atheros <code class="varname">localcast</code> address. Array <code class="varname">address</code> is declared with two dimensions to simplify access to individual addresses on return.  
    29. 

  29. 				</p></div></div><br class="example-break"></div><div class="section" title="NetworkDevices"><div class="titlepage"><div><div><h3 class="title"><a name="support-networkdevices"></a>
    30. 

  30. 			NetworkDevices
    31. 

  31. 			</h3></div></div></div><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" class="funcprototype-table"><tr><td><code class="funcdef">size_t <b class="fsfunc">NetworkDevices</b>(</code></td><td><var class="pdparam">channel</var>, </td><td> </td></tr><tr><td> </td><td><var class="pdparam">memory</var>, </td><td> </td></tr><tr><td> </td><td><var class="pdparam">extent</var><code>)</code>;</td><td> </td></tr></table><div class="paramdef-list"><code>struct channel * <var class="pdparam">channel</var></code>;<br><code>void * <var class="pdparam">memory</var></code>;<br><code>size_t <var class="pdparam">extent</var></code>;</div><div class="funcprototype-spacer"> </div></div><p>
    32. 

  32. 			Query a powerline device, specified by <a class="link" href="ch07s03.html#support-channel" title="channel">channel</a>, for neighboring network devices and store their Ethernet addresses in consecutive <code class="varname">memory</code> locations. The memory <code class="varname">extent</code> is specified in bytes. The number of devices found is returned as the function value, provided sufficient space is available to store all addresses. Unlike function <a class="link" href="ch07s04.html#support-networkbridges" title="NetworkBridges">NetworkBridges</a>, the <span class="structname">channel</span> <code class="varname">peer</code> address is identifies the device to be queried. 
    33. 

  33. 			</p><div class="example"><a name="idp23376368"></a><p class="title"><b>Example 7.2. 
    34. 

  34. 				Enumerating Network Devices
    35. 

  35. 				</b></p><div class="example-contents"><pre class="programlisting">
    36. 

  36. #include &lt;net/if.h&gt;
    37. 

  37. #include "../ether/channel.h"
    38. 

  38. extern struct channel <code class="varname">channel</code>; 
    39. 

  39. uint8_t <code class="varname">address</code> [<code class="constant">255</code>][<code class="constant">ETHER_ADDR_LEN</code>]; 
    40. 

  40. size_t <code class="varname">devices</code> = <code class="function">NetworkDevices</code> (&amp;<code class="varname">channel</code>, <code class="varname">address</code>, sizeof (<code class="varname">address</code>));
    41. 

  41. size_t <code class="varname">device</code> = <code class="constant">0</code>; 
    42. 

  42. while (<code class="varname">device</code> &lt; <code class="varname">devices</code>)
    43. 

  43. {
    44. 

  44.    <code class="function">binout</code> (<code class="varname">address</code> [<code class="varname">device</code>], <code class="constant">ETHER_ADDR_LEN</code>, <code class="constant">':'</code>, <code class="varname">stdout</code>);
    45. 

  45.    <code class="function">putc</code> (<code class="constant">'\n'</code>;, <code class="varname">stdout</code>);  
    46. 

  46. } 
    47. 

  47. </pre><p>
    48. 

  48. 				The code segment shown above illustrates how to use function <code class="varname">NetworkDevices</code> to identify all devices on a specific network. You must set the <a class="link" href="ch07s03.html#support-channel" title="channel">channel</a> <code class="varname">peer</code> address before calling <code class="varname">NetworkDevices</code>. Array <code class="varname">address</code> is declared with two dimensions to simplify access to individual addresses on return. If the <a class="link" href="ch07s03.html#support-channel" title="channel">channel</a> <code class="varname">peer</code> address is not the Ethernet <code class="varname">broadcast</code> or Atheros <code class="varname">localcast</code> address then the first address returned will be the <a class="link" href="ch07s03.html#support-channel" title="channel">channel</a> <code class="varname">peer</code> address.
    49. 

  49. 				</p></div></div><br class="example-break"></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch07s03.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch07.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch07s05.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">
    50. 

  50. 		Ethernet Functions
    51. 

  51. 		 </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 
    52. 

  52. 		Generic Functions
    53. 

  53. 		</td></tr></table></div></body></html>
    54.