ch07s10.html 9.0 KB

123456789101112131415161718192021222324252627282930313233
  1. <html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Procrastination 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="ch07s09.html" title="Download Functions"><link rel="next" href="ch07s11.html" title="Traffic 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. Procrastination Functions
  3. </th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch07s09.html">Prev</a> </td><th width="60%" align="center">Chapter 7. 
  4. Support Function Reference
  5. </th><td width="20%" align="right"> <a accesskey="n" href="ch07s11.html">Next</a></td></tr></table><hr></div><div class="section" title="Procrastination Functions"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="support-procrastination"></a>
  6. Procrastination Functions
  7. </h2></div></div></div><p>
  8. Procrastinations functions wait for specific events to occur or fail to occur.
  9. </p><div class="section" title="WaitForAssoc"><div class="titlepage"><div><div><h3 class="title"><a name="WaitForAssoc"></a>
  10. WaitForAssoc
  11. </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">signed <b class="fsfunc">WaitForAssoc</b>(</code></td><td><var class="pdparam">plc</var><code>)</code>;</td><td> </td></tr></table><div class="paramdef-list"><code>struct plc * <var class="pdparam">plc</var></code>;</div><div class="funcprototype-spacer"> </div></div><p>
  12. Poll a powerline device using <code class="constant">VS_NW_INFO</code> messages until the device forms or joins a network. The host ethernet interface, destination hardware address and source hardware address are specified in structure <code class="varname">plc</code>. It calls either <a class="link" href="ch07s10.html#WaitForAssoc1" title="WaitForAssoc1">WaitForAssoc1</a> or <a class="link" href="ch07s10.html#WaitForAssoc2" title="WaitForAssoc2">WaitForAssoc2</a> to procrastinate based on the <code class="varname">hardwareID</code> member of structure <code class="varname">plc</code>. The function is declared in <a class="ulink" href="plc.h.html" target="_top">plc.h</a> and defined in file <a class="ulink" href="WaitForAssoc.c.html" target="_top">WaitForAssoc.c</a>. Struct <code class="varname">plc</code> is declared in file <a class="ulink" href="plc.h.html" target="_top">plc.h</a> and defined in file <a class="ulink" href="plc.c.html" target="_top">plc.c</a>.
  13. </p></div><div class="section" title="WaitForAssoc1"><div class="titlepage"><div><div><h3 class="title"><a name="WaitForAssoc1"></a>
  14. WaitForAssoc1
  15. </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">signed <b class="fsfunc">WaitForAssoc1</b>(</code></td><td><var class="pdparam">plc</var><code>)</code>;</td><td> </td></tr></table><div class="paramdef-list"><code>struct plc * <var class="pdparam">plc</var></code>;</div><div class="funcprototype-spacer"> </div></div><p>
  16. Poll a 200mbs powerline device using <code class="constant">VS_NW_INFO</code> version <code class="constant">0</code> messages until the device joins or forms a network. The host ethernet interface, destination hardware address and source hardware address are specified in structure <code class="varname">plc</code>. The function is declared in file <a class="ulink" href="plc.h.html" target="_top">plc.h</a> and defined in file <a class="ulink" href="WaitForAssoc1.c.html" target="_top">WaitForAssoc1.c</a>. Struct <code class="varname">plc</code> is declared in file <a class="ulink" href="plc.h.html" target="_top">plc.h</a> and defined in file <a class="ulink" href="plc.c.html" target="_top">plc.c</a>.
  17. </p></div><div class="section" title="WaitForAssoc2"><div class="titlepage"><div><div><h3 class="title"><a name="WaitForAssoc2"></a>
  18. WaitForAssoc2
  19. </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">signed <b class="fsfunc">WaitForAssoc2</b>(</code></td><td><var class="pdparam">plc</var><code>)</code>;</td><td> </td></tr></table><div class="paramdef-list"><code>struct plc * <var class="pdparam">plc</var></code>;</div><div class="funcprototype-spacer"> </div></div><p>
  20. Poll a 1000mbs powerline device using <code class="constant">VS_NW_INFO</code> version <code class="constant">1</code> messages until the device joins or forms a network. The host ethernet interface, destination hardware address and source hardware address are specified in structure <code class="varname">plc</code>. Structure <code class="varname">plc</code> is declared in file <a class="ulink" href="plc.h.html" target="_top">plc.h</a> and defined in file <a class="ulink" href="plc.c.html" target="_top">plc.c</a>. The function is declared in file <a class="ulink" href="plc.h.html" target="_top">plc.h</a> and defined in file <a class="ulink" href="WaitForAssoc2.c.html" target="_top">WaitForAssoc2.c</a>.
  21. </p></div><div class="section" title="WaitForReset"><div class="titlepage"><div><div><h3 class="title"><a name="WaitForReset"></a>
  22. WaitForReset
  23. </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">signed <b class="fsfunc">WaitForReset</b>(</code></td><td><var class="pdparam">plc</var><code>)</code>;</td><td> </td></tr></table><div class="paramdef-list"><code>struct plc * <var class="pdparam">plc</var></code>;</div><div class="funcprototype-spacer"> </div></div><p>
  24. Poll a powerline device using <code class="constant">VS_SW_VER</code> messages until the device stops responding. The host ethernet interface, destination hardware address and source hardware address are specified in structure <code class="varname">plc</code>. Structure <code class="varname">plc</code> is declared in file <a class="ulink" href="plc.h.html" target="_top">plc.h</a> and define in file <a class="ulink" href="plc.c.html" target="_top">plc.c</a>. The function is declared in <a class="ulink" href="plc.h.html" target="_top">plc.h</a> and defined in file <a class="ulink" href="WaitForReset.c.html" target="_top">WaitForReset.c</a>.
  25. </p></div><div class="section" title="WaitForStart"><div class="titlepage"><div><div><h3 class="title"><a name="WaitForStart"></a>
  26. WaitForStart
  27. </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">signed <b class="fsfunc">WaitForStart</b>(</code></td><td><var class="pdparam">plc</var>, </td><td> </td></tr><tr><td> </td><td><var class="pdparam">firmware</var>, </td><td> </td></tr><tr><td> </td><td><var class="pdparam">length</var><code>)</code>;</td><td> </td></tr></table><div class="paramdef-list"><code>struct plc * <var class="pdparam">plc</var></code>;<br><code>char <var class="pdparam">firmware</var></code>;<br><code>size_t <var class="pdparam">length</var></code>;</div><div class="funcprototype-spacer"> </div></div><p>
  28. Poll a powerline device using <code class="constant">VS_SW_VER</code> messages until the device responds. The host ethernet interface, destination hardware address and source hardware address are specified in structure <code class="varname">plc</code>. Update the <code class="varname">hardwareID</code> member of the <code class="varname">plc</code> structure. Return the firmware revision string contained in the confirmation message. Structure <code class="varname">plc</code> is declared in file <a class="ulink" href="plc.h.html" target="_top">plc.h</a> and defined in file <a class="ulink" href="plc.c.html" target="_top">plc.c</a>. The function is declared in file <a class="ulink" href="plc.h.html" target="_top">plc.h</a> and defined in file <a class="ulink" href="WaitForStart.c.html" target="_top">WaitForStart.c</a>.
  29. </p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch07s09.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="ch07s11.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">
  30. Download Functions
  31.  </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 
  32. Traffic Functions
  33. </td></tr></table></div></body></html>