dun_8h.html

BlueLab3 bluetooth API 说明文档

  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> enum <a class="el" href="dun_8h.html#a39">dun_connect_status</a>          </td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Return status for the DUN_CONNECT_CFM message. 
<p>
<dl compact><dt><b>Enumeration values: </b></dt><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em><a class="anchor" name="a39a16" doxytag="dun_connect_success" ></a>dun_connect_success</em>&nbsp;</td><td>
Successful connection. </td></tr>
<tr><td valign=top><em><a class="anchor" name="a39a17" doxytag="dun_connect_sdp_fail" ></a>dun_connect_sdp_fail</em>&nbsp;</td><td>
Unsuccessful due to a service search failure. </td></tr>
<tr><td valign=top><em><a class="anchor" name="a39a18" doxytag="dun_connect_slc_failed" ></a>dun_connect_slc_failed</em>&nbsp;</td><td>
Unsuccessful due to a service level connection failure. </td></tr>
<tr><td valign=top><em><a class="anchor" name="a39a19" doxytag="dun_connect_failed_busy" ></a>dun_connect_failed_busy</em>&nbsp;</td><td>
Unsuccessful due to service level connection already established. </td></tr>
<tr><td valign=top><em><a class="anchor" name="a39a20" doxytag="dun_connect_failed" ></a>dun_connect_failed</em>&nbsp;</td><td>
Unsuccessful due to RFCOMM connection failing to be established. </td></tr>
<tr><td valign=top><em><a class="anchor" name="a39a21" doxytag="dun_connect_server_channel_not_registered" ></a>dun_connect_server_channel_not_registered</em>&nbsp;</td><td>
Unsuccessful due to attempt to connect to unallocated server channel. </td></tr>
<tr><td valign=top><em><a class="anchor" name="a39a22" doxytag="dun_connect_timeout" ></a>dun_connect_timeout</em>&nbsp;</td><td>
Unsuccessful due to connection attempt timing out. </td></tr>
<tr><td valign=top><em><a class="anchor" name="a39a23" doxytag="dun_connect_rejected" ></a>dun_connect_rejected</em>&nbsp;</td><td>
Unsuccessful due to remote device rejecting connection. </td></tr>
<tr><td valign=top><em><a class="anchor" name="a39a24" doxytag="dun_connect_normal_disconnect" ></a>dun_connect_normal_disconnect</em>&nbsp;</td><td>
Unsuccessful due to remote device terminating the connection. </td></tr>
<tr><td valign=top><em><a class="anchor" name="a39a25" doxytag="dun_connect_abnormal_disconnect" ></a>dun_connect_abnormal_disconnect</em>&nbsp;</td><td>
Unsuccessful due to an abnormal disconnect while establishing an rfcomm connection. </td></tr>
<tr><td valign=top><em><a class="anchor" name="a39a26" doxytag="dun_connect_invalid" ></a>dun_connect_invalid</em>&nbsp;</td><td>
Unsuccessful due to being an invalid request. DUN DCE cannot initial connection. </td></tr>
</table>
</dl>
    </td>
  </tr>
</table>
<a class="anchor" name="a40" doxytag="dun.h::dun_disconnect_status" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> enum <a class="el" href="dun_8h.html#a40">dun_disconnect_status</a>          </td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Possible status codes for the disconnect message. 
<p>
<dl compact><dt><b>Enumeration values: </b></dt><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em><a class="anchor" name="a40a27" doxytag="dun_disconnect_success" ></a>dun_disconnect_success</em>&nbsp;</td><td>
Successful disconnection. </td></tr>
<tr><td valign=top><em><a class="anchor" name="a40a28" doxytag="dun_disconnect_link_loss" ></a>dun_disconnect_link_loss</em>&nbsp;</td><td>
Unsuccessful due to the link being lost. </td></tr>
<tr><td valign=top><em><a class="anchor" name="a40a29" doxytag="dun_disconnect_no_slc" ></a>dun_disconnect_no_slc</em>&nbsp;</td><td>
Unsuccessful due to no service level connection. </td></tr>
<tr><td valign=top><em><a class="anchor" name="a40a30" doxytag="dun_disconnect_timeout" ></a>dun_disconnect_timeout</em>&nbsp;</td><td>
Unsuccessful due to time out. </td></tr>
<tr><td valign=top><em><a class="anchor" name="a40a31" doxytag="dun_disconnect_error" ></a>dun_disconnect_error</em>&nbsp;</td><td>
Unsuccessful for some other reason. </td></tr>
</table>
</dl>
    </td>
  </tr>
</table>
<hr><h2>Function Documentation</h2>
<a class="anchor" name="a32" doxytag="dun.h::DunInit" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> void DunInit           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="struct_task_data.html">Task</a>&nbsp;</td>
          <td class="mdname" nowrap> <em>theAppTask</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td></td>
          <td class="md" nowrap><a class="el" href="dun_8h.html#a37">dun_device_type</a>&nbsp;</td>
          <td class="mdname" nowrap> <em>type_of_device</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td></td>
          <td class="md" nowrap><a class="el" href="csrtypes_8h.html#a4">uint16</a>&nbsp;</td>
          <td class="mdname" nowrap> <em>RI</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td></td>
          <td class="md" nowrap><a class="el" href="csrtypes_8h.html#a4">uint16</a>&nbsp;</td>
          <td class="mdname" nowrap> <em>DTR</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td></td>
          <td class="md" nowrap><a class="el" href="csrtypes_8h.html#a4">uint16</a>&nbsp;</td>
          <td class="mdname" nowrap> <em>DCD</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td></td>
          <td class="md" nowrap><a class="el" href="csrtypes_8h.html#a4">uint16</a>&nbsp;</td>
          <td class="mdname" nowrap> <em>DSR</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td></td>
          <td class="md" nowrap><a class="el" href="csrtypes_8h.html#a4">uint16</a>&nbsp;</td>
          <td class="mdname" nowrap> <em>priority</em></td>
        </tr>
        <tr>
          <td></td>
          <td class="md">)&nbsp;</td>
          <td class="md" colspan="2"></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Initialise the DUN library. 
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td></td><td valign=top><em>theAppTask</em>&nbsp;</td><td>The current application task. </td></tr>
    <tr><td></td><td valign=top><em>type_of_device</em>&nbsp;</td><td>dunlibDCE(Master) or dunlibDTE(Slave). </td></tr>
    <tr><td></td><td valign=top><em>RI</em>&nbsp;</td><td>Pio Assignments for RI pin. </td></tr>
    <tr><td></td><td valign=top><em>DTR</em>&nbsp;</td><td>Pio Assignments for DTR pin. </td></tr>
    <tr><td></td><td valign=top><em>DCD</em>&nbsp;</td><td>Pio Assignments for DCD pin. </td></tr>
    <tr><td></td><td valign=top><em>DSR</em>&nbsp;</td><td>Pio Assignments for DSR. </td></tr>
    <tr><td></td><td valign=top><em>priority</em>&nbsp;</td><td>The profile instance low power mode priority. For a set of profile instances with connections on a given ACL the instance with the highest priority value wins and the low power mode on the ACL is set according to it's power table.</td></tr>
  </table>
</dl>
A DUN_INIT_CFM message will be returned on completion. If a modem signalling pin is not connected, use DUN_NO_PIN.     </td>
  </tr>
</table>
<a class="anchor" name="a33" doxytag="dun.h::DunConnect" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> void DunConnect           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="dun_8h.html#a2">DUN</a> *&nbsp;</td>
          <td class="mdname" nowrap> <em>dun</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td></td>
          <td class="md" nowrap>const <a class="el" href="structbdaddr.html">bdaddr</a> *&nbsp;</td>
          <td class="mdname" nowrap> <em>bd_addr</em></td>
        </tr>
        <tr>
          <td></td>
          <td class="md">)&nbsp;</td>
          <td class="md" colspan="2"></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Handle Connect request by sending an internal message. 
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td></td><td valign=top><em>sun</em>&nbsp;</td><td>DUN Profile structure. </td></tr>
    <tr><td></td><td valign=top><em>bd_addr</em>&nbsp;</td><td>Bluetooth address of device to connect to.</td></tr>
  </table>
</dl>
A DUN_CONNECT_CFM message will be returned on completion.     </td>
  </tr>
</table>
<a class="anchor" name="a34" doxytag="dun.h::DunConnectResponse" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> void DunConnectResponse           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="dun_8h.html#a2">DUN</a> *&nbsp;</td>
          <td class="mdname" nowrap> <em>dun</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td></td>
          <td class="md" nowrap><a class="el" href="csrtypes_8h.html#a9">bool</a>&nbsp;</td>
          <td class="mdname" nowrap> <em>response</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td></td>
          <td class="md" nowrap>const <a class="el" href="structbdaddr.html">bdaddr</a> *&nbsp;</td>
          <td class="mdname" nowrap> <em>bd_addr</em></td>
        </tr>
        <tr>
          <td></td>
          <td class="md">)&nbsp;</td>
          <td class="md" colspan="2"></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Handle response to a connection request by sending an internal message. 
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td></td><td valign=top><em>dun</em>&nbsp;</td><td>DUN Profile structure. </td></tr>
    <tr><td></td><td valign=top><em>response</em>&nbsp;</td><td>TRUE to connect, FALSE to refuse the connection. </td></tr>
    <tr><td></td><td valign=top><em>bd_addr</em>&nbsp;</td><td>Bluetooth address of the device to connect to.</td></tr>
  </table>
</dl>
Should be called in response to a DUN_CONNECT_IND message.     </td>
  </tr>
</table>
<a class="anchor" name="a35" doxytag="dun.h::DunDisconnect" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> void DunDisconnect           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="dun_8h.html#a2">DUN</a> *&nbsp;</td>
          <td class="mdname1" valign="top" nowrap> <em>dun</em>          </td>
          <td class="md" valign="top">&nbsp;)&nbsp;</td>
          <td class="md" nowrap></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Disconnect the service level connection for the supported profile. 
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td></td><td valign=top><em>dun</em>&nbsp;</td><td>DUN Profile structure.</td></tr>
  </table>
</dl>
A DUN_DISCONNECT_IND message will be returned on completion.     </td>
  </tr>
</table>

</body>
</html>