Project

General

Profile

Revision 1425

Added by Chris Mar over 14 years ago

updated wireless basic library code and docs

View differences:

group__xbee.html
1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
1
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2
<html xmlns="http://www.w3.org/1999/xhtml">
3
<head>
4
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
3 5
<title>libwireless: XBee</title>
4
<link href="tabs.css" rel="stylesheet" type="text/css">
5
<link href="doxygen.css" rel="stylesheet" type="text/css">
6
</head><body>
7
<!-- Generated by Doxygen 1.5.9 -->
6
<link href="tabs.css" rel="stylesheet" type="text/css"/>
7
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
8
</head>
9
<body>
10
<!-- Generated by Doxygen 1.6.1 -->
8 11
<div class="navigation" id="top">
9 12
  <div class="tabs">
10 13
    <ul>
......
16 19
  </div>
17 20
</div>
18 21
<div class="contents">
19
<h1>XBee</h1>Interface with the XBee module.  
20
<a href="#_details">More...</a>
21
<p>
22
<h1>XBee</h1>
23
<p>Interface with the XBee module.  
24
<a href="#_details">More...</a></p>
22 25
<table border="0" cellpadding="0" cellspacing="0">
23
<tr><td></td></tr>
24
<tr><td colspan="2"><br><h2>Defines</h2></td></tr>
25
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="ge6bb9bb274d6750f954762454807a5a7"></a><!-- doxytag: member="xbee::XBEE_PAN_DEFAULT" ref="ge6bb9bb274d6750f954762454807a5a7" args="" -->
26
#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__xbee.html#ge6bb9bb274d6750f954762454807a5a7">XBEE_PAN_DEFAULT</a>&nbsp;&nbsp;&nbsp;0xFFFF</td></tr>
27

  
28
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Unset PAN, uses XBee default. <br></td></tr>
29
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="g35f8b9d8e01e788f1e29928cba29f215"></a><!-- doxytag: member="xbee::XBEE_CHANNEL_DEFAULT" ref="g35f8b9d8e01e788f1e29928cba29f215" args="" -->
30
#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__xbee.html#g35f8b9d8e01e788f1e29928cba29f215">XBEE_CHANNEL_DEFAULT</a>&nbsp;&nbsp;&nbsp;0</td></tr>
31

  
32
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Unset channel, uses XBee default. <br></td></tr>
33
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="g93bbd21f7965e1697350f950cedff5c4"></a><!-- doxytag: member="xbee::XBEE_BROADCAST" ref="g93bbd21f7965e1697350f950cedff5c4" args="" -->
34
#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__xbee.html#g93bbd21f7965e1697350f950cedff5c4">XBEE_BROADCAST</a>&nbsp;&nbsp;&nbsp;0xFFFF</td></tr>
35

  
36
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Broadcast to all robots in the PAN. <br></td></tr>
37
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="gbca7356c2b8183fd41b5ca9a82dd962b"></a><!-- doxytag: member="xbee::XBEE_OPTIONS_NONE" ref="gbca7356c2b8183fd41b5ca9a82dd962b" args="" -->
38
#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__xbee.html#gbca7356c2b8183fd41b5ca9a82dd962b">XBEE_OPTIONS_NONE</a>&nbsp;&nbsp;&nbsp;0x00</td></tr>
39

  
40
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">No special options. <br></td></tr>
41
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="gcf9509013302590dca5ce3db63c64609"></a><!-- doxytag: member="xbee::XBEE_OPTIONS_DISABLE_RESPONSE" ref="gcf9509013302590dca5ce3db63c64609" args="" -->
42
#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__xbee.html#gcf9509013302590dca5ce3db63c64609">XBEE_OPTIONS_DISABLE_RESPONSE</a>&nbsp;&nbsp;&nbsp;0x01</td></tr>
43

  
44
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Do not receive a TX_STATUS message from this packet. <br></td></tr>
45
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="g57382f888360b5b19f0de3b6f1f7c5a3"></a><!-- doxytag: member="xbee::XBEE_OPTIONS_BROADCAST_ALL_PANS" ref="g57382f888360b5b19f0de3b6f1f7c5a3" args="" -->
46
#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__xbee.html#g57382f888360b5b19f0de3b6f1f7c5a3">XBEE_OPTIONS_BROADCAST_ALL_PANS</a>&nbsp;&nbsp;&nbsp;0x04</td></tr>
47

  
48
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Send the packet to all PANS. <br></td></tr>
49
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="g7840d8b64c8bec12d8b8d32e845a638a"></a><!-- doxytag: member="xbee::XBEE_TX_STATUS" ref="g7840d8b64c8bec12d8b8d32e845a638a" args="" -->
50
#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__xbee.html#g7840d8b64c8bec12d8b8d32e845a638a">XBEE_TX_STATUS</a>&nbsp;&nbsp;&nbsp;0x89</td></tr>
51

  
52
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">A transmit status packet. <br></td></tr>
53
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="gc2b1262a3a1eb4a9f7ead366af71c32c"></a><!-- doxytag: member="xbee::XBEE_RX" ref="gc2b1262a3a1eb4a9f7ead366af71c32c" args="" -->
54
#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__xbee.html#gc2b1262a3a1eb4a9f7ead366af71c32c">XBEE_RX</a>&nbsp;&nbsp;&nbsp;0x81</td></tr>
55

  
56
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">A packet received from another XBee. <br></td></tr>
57
<tr><td colspan="2"><br><h2>Functions</h2></td></tr>
58
<tr><td class="memItemLeft" nowrap align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__xbee.html#g3d5fbb6aae8dda99240ec38108a645af">xbee_lib_init</a> (void)</td></tr>
59

  
60
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Initialize the XBee library.  <a href="#g3d5fbb6aae8dda99240ec38108a645af"></a><br></td></tr>
61
<tr><td class="memItemLeft" nowrap align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__xbee.html#g9334ac71dca1ddd697b1a35a361ade6a">xbee_terminate</a> (void)</td></tr>
62

  
63
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Uninitialize the XBee library.  <a href="#g9334ac71dca1ddd697b1a35a361ade6a"></a><br></td></tr>
64
<tr><td class="memItemLeft" nowrap align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__xbee.html#g00fbdd9d849171588df736f8b608589d">xbee_get_packet</a> (unsigned char *packet)</td></tr>
65

  
66
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Get a packet from the XBee.  <a href="#g00fbdd9d849171588df736f8b608589d"></a><br></td></tr>
67
<tr><td class="memItemLeft" nowrap align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__xbee.html#g7c44bc25fda954efde574ee8d735073c">xbee_send_packet</a> (char *packet, int len, int dest, char options, char frame)</td></tr>
68

  
69
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Send a packet to the XBee.  <a href="#g7c44bc25fda954efde574ee8d735073c"></a><br></td></tr>
70
<tr><td class="memItemLeft" nowrap align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__xbee.html#gde50cbefd7ba8d7361ce2654a298748b">xbee_set_pan_id</a> (int id)</td></tr>
71

  
72
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Set the PAN ID for the XBee.  <a href="#gde50cbefd7ba8d7361ce2654a298748b"></a><br></td></tr>
73
<tr><td class="memItemLeft" nowrap align="right" valign="top">unsigned int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__xbee.html#g7755cd8db87703c9e9943153660b8052">xbee_get_pan_id</a> (void)</td></tr>
74

  
75
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Get the XBee's PAN ID.  <a href="#g7755cd8db87703c9e9943153660b8052"></a><br></td></tr>
76
<tr><td class="memItemLeft" nowrap align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__xbee.html#gb93170c493c5cdfd43a7b640c6ed1d14">xbee_set_channel</a> (int channel)</td></tr>
77

  
78
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Set the channel the XBee is currently using.  <a href="#gb93170c493c5cdfd43a7b640c6ed1d14"></a><br></td></tr>
79
<tr><td class="memItemLeft" nowrap align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__xbee.html#g133706db81f69ba0a3c169b7a3f42d2a">xbee_get_channel</a> (void)</td></tr>
80

  
81
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Get the channel the XBee is currently using.  <a href="#g133706db81f69ba0a3c169b7a3f42d2a"></a><br></td></tr>
82
<tr><td class="memItemLeft" nowrap align="right" valign="top">unsigned int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__xbee.html#g7c53e8a8492494a61ca306875d633309">xbee_get_address</a> (void)</td></tr>
83

  
84
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Get the XBee's 16-bit address.  <a href="#g7c53e8a8492494a61ca306875d633309"></a><br></td></tr>
85
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="g1e9e3c2abf0ff683ca8e591c3851cf0a"></a><!-- doxytag: member="xbee::xbee_set_com_port" ref="g1e9e3c2abf0ff683ca8e591c3851cf0a" args="(char *port)" -->
86
void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__xbee.html#g1e9e3c2abf0ff683ca8e591c3851cf0a">xbee_set_com_port</a> (char *port)</td></tr>
87

  
88
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Set the com port on a computer, undefined on the robot. <br></td></tr>
26
<tr><td colspan="2"><h2>Defines</h2></td></tr>
27
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="gae6bb9bb274d6750f954762454807a5a7"></a><!-- doxytag: member="xbee::XBEE_PAN_DEFAULT" ref="gae6bb9bb274d6750f954762454807a5a7" args="" -->
28
#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__xbee.html#gae6bb9bb274d6750f954762454807a5a7">XBEE_PAN_DEFAULT</a>&nbsp;&nbsp;&nbsp;0xFFFF</td></tr>
29
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Unset PAN, uses XBee default. <br/></td></tr>
30
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ga35f8b9d8e01e788f1e29928cba29f215"></a><!-- doxytag: member="xbee::XBEE_CHANNEL_DEFAULT" ref="ga35f8b9d8e01e788f1e29928cba29f215" args="" -->
31
#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__xbee.html#ga35f8b9d8e01e788f1e29928cba29f215">XBEE_CHANNEL_DEFAULT</a>&nbsp;&nbsp;&nbsp;0</td></tr>
32
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Unset channel, uses XBee default. <br/></td></tr>
33
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ga93bbd21f7965e1697350f950cedff5c4"></a><!-- doxytag: member="xbee::XBEE_BROADCAST" ref="ga93bbd21f7965e1697350f950cedff5c4" args="" -->
34
#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__xbee.html#ga93bbd21f7965e1697350f950cedff5c4">XBEE_BROADCAST</a>&nbsp;&nbsp;&nbsp;0xFFFF</td></tr>
35
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Broadcast to all robots in the PAN. <br/></td></tr>
36
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="gabca7356c2b8183fd41b5ca9a82dd962b"></a><!-- doxytag: member="xbee::XBEE_OPTIONS_NONE" ref="gabca7356c2b8183fd41b5ca9a82dd962b" args="" -->
37
#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__xbee.html#gabca7356c2b8183fd41b5ca9a82dd962b">XBEE_OPTIONS_NONE</a>&nbsp;&nbsp;&nbsp;0x00</td></tr>
38
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">No special options. <br/></td></tr>
39
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="gacf9509013302590dca5ce3db63c64609"></a><!-- doxytag: member="xbee::XBEE_OPTIONS_DISABLE_RESPONSE" ref="gacf9509013302590dca5ce3db63c64609" args="" -->
40
#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__xbee.html#gacf9509013302590dca5ce3db63c64609">XBEE_OPTIONS_DISABLE_RESPONSE</a>&nbsp;&nbsp;&nbsp;0x01</td></tr>
41
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Do not receive a TX_STATUS message from this packet. <br/></td></tr>
42
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ga57382f888360b5b19f0de3b6f1f7c5a3"></a><!-- doxytag: member="xbee::XBEE_OPTIONS_BROADCAST_ALL_PANS" ref="ga57382f888360b5b19f0de3b6f1f7c5a3" args="" -->
43
#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__xbee.html#ga57382f888360b5b19f0de3b6f1f7c5a3">XBEE_OPTIONS_BROADCAST_ALL_PANS</a>&nbsp;&nbsp;&nbsp;0x04</td></tr>
44
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Send the packet to all PANS. <br/></td></tr>
45
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ga7840d8b64c8bec12d8b8d32e845a638a"></a><!-- doxytag: member="xbee::XBEE_TX_STATUS" ref="ga7840d8b64c8bec12d8b8d32e845a638a" args="" -->
46
#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__xbee.html#ga7840d8b64c8bec12d8b8d32e845a638a">XBEE_TX_STATUS</a>&nbsp;&nbsp;&nbsp;0x89</td></tr>
47
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">A transmit status packet. <br/></td></tr>
48
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="gac2b1262a3a1eb4a9f7ead366af71c32c"></a><!-- doxytag: member="xbee::XBEE_RX" ref="gac2b1262a3a1eb4a9f7ead366af71c32c" args="" -->
49
#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__xbee.html#gac2b1262a3a1eb4a9f7ead366af71c32c">XBEE_RX</a>&nbsp;&nbsp;&nbsp;0x81</td></tr>
50
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">A packet received from another XBee. <br/></td></tr>
51
<tr><td colspan="2"><h2>Functions</h2></td></tr>
52
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__xbee.html#ga3d5fbb6aae8dda99240ec38108a645af">xbee_lib_init</a> (void)</td></tr>
53
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Initialize the XBee library.  <a href="#ga3d5fbb6aae8dda99240ec38108a645af"></a><br/></td></tr>
54
<tr><td class="memItemLeft" align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__xbee.html#ga9334ac71dca1ddd697b1a35a361ade6a">xbee_terminate</a> (void)</td></tr>
55
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Uninitialize the XBee library.  <a href="#ga9334ac71dca1ddd697b1a35a361ade6a"></a><br/></td></tr>
56
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__xbee.html#ga00fbdd9d849171588df736f8b608589d">xbee_get_packet</a> (unsigned char *packet)</td></tr>
57
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Get a packet from the XBee.  <a href="#ga00fbdd9d849171588df736f8b608589d"></a><br/></td></tr>
58
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__xbee.html#ga7c44bc25fda954efde574ee8d735073c">xbee_send_packet</a> (char *packet, int len, int dest, char options, char frame)</td></tr>
59
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Send a packet to the XBee.  <a href="#ga7c44bc25fda954efde574ee8d735073c"></a><br/></td></tr>
60
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__xbee.html#gade50cbefd7ba8d7361ce2654a298748b">xbee_set_pan_id</a> (int id)</td></tr>
61
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Set the PAN ID for the XBee.  <a href="#gade50cbefd7ba8d7361ce2654a298748b"></a><br/></td></tr>
62
<tr><td class="memItemLeft" align="right" valign="top">unsigned int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__xbee.html#ga7755cd8db87703c9e9943153660b8052">xbee_get_pan_id</a> (void)</td></tr>
63
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Get the XBee's PAN ID.  <a href="#ga7755cd8db87703c9e9943153660b8052"></a><br/></td></tr>
64
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__xbee.html#gab93170c493c5cdfd43a7b640c6ed1d14">xbee_set_channel</a> (int channel)</td></tr>
65
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Set the channel the XBee is currently using.  <a href="#gab93170c493c5cdfd43a7b640c6ed1d14"></a><br/></td></tr>
66
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__xbee.html#ga133706db81f69ba0a3c169b7a3f42d2a">xbee_get_channel</a> (void)</td></tr>
67
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Get the channel the XBee is currently using.  <a href="#ga133706db81f69ba0a3c169b7a3f42d2a"></a><br/></td></tr>
68
<tr><td class="memItemLeft" align="right" valign="top">unsigned int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__xbee.html#ga7c53e8a8492494a61ca306875d633309">xbee_get_address</a> (void)</td></tr>
69
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Get the XBee's 16-bit address.  <a href="#ga7c53e8a8492494a61ca306875d633309"></a><br/></td></tr>
70
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ga1e9e3c2abf0ff683ca8e591c3851cf0a"></a><!-- doxytag: member="xbee::xbee_set_com_port" ref="ga1e9e3c2abf0ff683ca8e591c3851cf0a" args="(char *port)" -->
71
void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__xbee.html#ga1e9e3c2abf0ff683ca8e591c3851cf0a">xbee_set_com_port</a> (char *port)</td></tr>
72
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Set the com port on a computer, undefined on the robot. <br/></td></tr>
89 73
</table>
90
<hr><a name="_details"></a><h2>Detailed Description</h2>
91
Interface with the XBee module. <hr><h2>Function Documentation</h2>
92
<a class="anchor" name="g7c53e8a8492494a61ca306875d633309"></a><!-- doxytag: member="xbee.h::xbee_get_address" ref="g7c53e8a8492494a61ca306875d633309" args="(void)" -->
74
<hr/><a name="_details"></a><h2>Detailed Description</h2>
75
<p>Interface with the XBee module. </p>
76
<hr/><h2>Function Documentation</h2>
77
<a class="anchor" id="ga7c53e8a8492494a61ca306875d633309"></a><!-- doxytag: member="xbee.h::xbee_get_address" ref="ga7c53e8a8492494a61ca306875d633309" args="(void)" -->
93 78
<div class="memitem">
94 79
<div class="memproto">
95 80
      <table class="memname">
96 81
        <tr>
97
          <td class="memname">unsigned int xbee_get_address           </td>
82
          <td class="memname">unsigned int xbee_get_address </td>
98 83
          <td>(</td>
99 84
          <td class="paramtype">void&nbsp;</td>
100
          <td class="paramname">          </td>
85
          <td class="paramname"></td>
101 86
          <td>&nbsp;)&nbsp;</td>
102 87
          <td></td>
103 88
        </tr>
......
105 90
</div>
106 91
<div class="memdoc">
107 92

  
108
<p>
109
Get the XBee's 16-bit address. 
110
<p>
111
Get the 16-bit address of the XBee. This is used to specify who to send messages to and who messages are from.<p>
112
<dl class="return" compact><dt><b>Returns:</b></dt><dd>the 16-bit address of the XBee. </dd></dl>
93
<p>Get the XBee's 16-bit address. </p>
94
<p>Get the 16-bit address of the XBee. This is used to specify who to send messages to and who messages are from.</p>
95
<dl class="return"><dt><b>Returns:</b></dt><dd>the 16-bit address of the XBee. </dd></dl>
113 96

  
114 97
<p>Referenced by <a class="el" href="wireless_8c_source.html#l00235">wl_get_xbee_id()</a>.</p>
115 98

  
116 99
</div>
117
</div><p>
118
<a class="anchor" name="g133706db81f69ba0a3c169b7a3f42d2a"></a><!-- doxytag: member="xbee.h::xbee_get_channel" ref="g133706db81f69ba0a3c169b7a3f42d2a" args="(void)" -->
100
</div>
101
<a class="anchor" id="ga133706db81f69ba0a3c169b7a3f42d2a"></a><!-- doxytag: member="xbee.h::xbee_get_channel" ref="ga133706db81f69ba0a3c169b7a3f42d2a" args="(void)" -->
119 102
<div class="memitem">
120 103
<div class="memproto">
121 104
      <table class="memname">
122 105
        <tr>
123
          <td class="memname">int xbee_get_channel           </td>
106
          <td class="memname">int xbee_get_channel </td>
124 107
          <td>(</td>
125 108
          <td class="paramtype">void&nbsp;</td>
126
          <td class="paramname">          </td>
109
          <td class="paramname"></td>
127 110
          <td>&nbsp;)&nbsp;</td>
128 111
          <td></td>
129 112
        </tr>
......
131 114
</div>
132 115
<div class="memdoc">
133 116

  
134
<p>
135
Get the channel the XBee is currently using. 
136
<p>
137
Returns the channel which the XBee is currently using.<p>
138
<dl class="return" compact><dt><b>Returns:</b></dt><dd>the channel the XBee is using</dd></dl>
139
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="group__xbee.html#gb93170c493c5cdfd43a7b640c6ed1d14" title="Set the channel the XBee is currently using.">xbee_set_channel</a> </dd></dl>
117
<p>Get the channel the XBee is currently using. </p>
118
<p>Returns the channel which the XBee is currently using.</p>
119
<dl class="return"><dt><b>Returns:</b></dt><dd>the channel the XBee is using</dd></dl>
120
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__xbee.html#gab93170c493c5cdfd43a7b640c6ed1d14" title="Set the channel the XBee is currently using.">xbee_set_channel</a> </dd></dl>
140 121

  
141 122
<p>Referenced by <a class="el" href="wireless_8c_source.html#l00223">wl_get_channel()</a>.</p>
142 123

  
143 124
</div>
144
</div><p>
145
<a class="anchor" name="g00fbdd9d849171588df736f8b608589d"></a><!-- doxytag: member="xbee.h::xbee_get_packet" ref="g00fbdd9d849171588df736f8b608589d" args="(unsigned char *packet)" -->
125
</div>
126
<a class="anchor" id="ga00fbdd9d849171588df736f8b608589d"></a><!-- doxytag: member="xbee.h::xbee_get_packet" ref="ga00fbdd9d849171588df736f8b608589d" args="(unsigned char *packet)" -->
146 127
<div class="memitem">
147 128
<div class="memproto">
148 129
      <table class="memname">
149 130
        <tr>
150
          <td class="memname">int xbee_get_packet           </td>
131
          <td class="memname">int xbee_get_packet </td>
151 132
          <td>(</td>
152 133
          <td class="paramtype">unsigned char *&nbsp;</td>
153
          <td class="paramname"> <em>dest</em>          </td>
134
          <td class="paramname"> <em>dest</em></td>
154 135
          <td>&nbsp;)&nbsp;</td>
155 136
          <td></td>
156 137
        </tr>
......
158 139
</div>
159 140
<div class="memdoc">
160 141

  
161
<p>
162
Get a packet from the XBee. 
163
<p>
164
Reads a packet received from the XBee. This function is non-blocking. The resulting packet is stored in dest. Only returns transmission response packets and received packets. The returned packet does not include header information or the checksum. This method also handles special packets dealt with by the XBee library, and so should be called frequently while the XBee is in use.<br>
165
<br>
166
<p>
167
The first byte of the packet will be either XBEE_TX_STATUS or XBEE_RX to indicated a response to a sent message or a received message, respectively.<br>
168
<br>
169
<p>
170
For a status response packet:<br>
171
 The first byte will be XBEE_TX_STATUS.<br>
172
 The second byte will be the frame number.<br>
173
 The third byte will be the result. 0 indicates success, and nonzero indicates that an error ocurred in transmitting the packet.<br>
174
<br>
175
<p>
176
For a received packet:<br>
177
 The first byte will be XBEE_RX.<br>
178
 The second and third bytes will be the 16-bit address of the packet's sender.<br>
179
 The fourth byte is the signal strength.<br>
180
 The fifth byte is 1 if the packet were sent to a specific address, and 2 if it is a broadcast packet.<br>
181
<br>
182
<p>
183
<dl compact><dt><b>Parameters:</b></dt><dd>
142
<p>Get a packet from the XBee. </p>
143
<p>Reads a packet received from the XBee. This function is non-blocking. The resulting packet is stored in dest. Only returns transmission response packets and received packets. The returned packet does not include header information or the checksum. This method also handles special packets dealt with by the XBee library, and so should be called frequently while the XBee is in use.<br/>
144
<br/>
145
</p>
146
<p>The first byte of the packet will be either XBEE_TX_STATUS or XBEE_RX to indicated a response to a sent message or a received message, respectively.<br/>
147
<br/>
148
</p>
149
<p>For a status response packet:<br/>
150
 The first byte will be XBEE_TX_STATUS.<br/>
151
 The second byte will be the frame number.<br/>
152
 The third byte will be the result. 0 indicates success, and nonzero indicates that an error ocurred in transmitting the packet.<br/>
153
<br/>
154
</p>
155
<p>For a received packet:<br/>
156
 The first byte will be XBEE_RX.<br/>
157
 The second and third bytes will be the 16-bit address of the packet's sender.<br/>
158
 The fourth byte is the signal strength.<br/>
159
 The fifth byte is 1 if the packet were sent to a specific address, and 2 if it is a broadcast packet.<br/>
160
<br/>
161
</p>
162
<dl><dt><b>Parameters:</b></dt><dd>
184 163
  <table border="0" cellspacing="2" cellpadding="0">
185 164
    <tr><td valign="top"></td><td valign="top"><em>dest</em>&nbsp;</td><td>set to the packet data </td></tr>
186 165
  </table>
166
  </dd>
187 167
</dl>
188
<dl class="return" compact><dt><b>Returns:</b></dt><dd>the length of the packet, or -1 if no packet is available </dd></dl>
168
<dl class="return"><dt><b>Returns:</b></dt><dd>the length of the packet, or -1 if no packet is available </dd></dl>
189 169

  
190 170
<p>Referenced by <a class="el" href="wireless_8c_source.html#l00390">wl_do()</a>, and <a class="el" href="xbee_8c_source.html#l00206">xbee_lib_init()</a>.</p>
191 171

  
192 172
</div>
193
</div><p>
194
<a class="anchor" name="g7755cd8db87703c9e9943153660b8052"></a><!-- doxytag: member="xbee.h::xbee_get_pan_id" ref="g7755cd8db87703c9e9943153660b8052" args="(void)" -->
173
</div>
174
<a class="anchor" id="ga7755cd8db87703c9e9943153660b8052"></a><!-- doxytag: member="xbee.h::xbee_get_pan_id" ref="ga7755cd8db87703c9e9943153660b8052" args="(void)" -->
195 175
<div class="memitem">
196 176
<div class="memproto">
197 177
      <table class="memname">
198 178
        <tr>
199
          <td class="memname">unsigned int xbee_get_pan_id           </td>
179
          <td class="memname">unsigned int xbee_get_pan_id </td>
200 180
          <td>(</td>
201 181
          <td class="paramtype">void&nbsp;</td>
202
          <td class="paramname">          </td>
182
          <td class="paramname"></td>
203 183
          <td>&nbsp;)&nbsp;</td>
204 184
          <td></td>
205 185
        </tr>
......
207 187
</div>
208 188
<div class="memdoc">
209 189

  
210
<p>
211
Get the XBee's PAN ID. 
212
<p>
213
Get the PAN ID for the XBee.<p>
214
<dl class="return" compact><dt><b>Returns:</b></dt><dd>the personal area network id, or XBEE_PAN_DEFAULT if it has not yet been set. </dd></dl>
190
<p>Get the XBee's PAN ID. </p>
191
<p>Get the PAN ID for the XBee.</p>
192
<dl class="return"><dt><b>Returns:</b></dt><dd>the personal area network id, or XBEE_PAN_DEFAULT if it has not yet been set. </dd></dl>
215 193

  
216 194
<p>Referenced by <a class="el" href="wireless_8c_source.html#l00195">wl_get_pan()</a>.</p>
217 195

  
218 196
</div>
219
</div><p>
220
<a class="anchor" name="g3d5fbb6aae8dda99240ec38108a645af"></a><!-- doxytag: member="xbee.h::xbee_lib_init" ref="g3d5fbb6aae8dda99240ec38108a645af" args="(void)" -->
197
</div>
198
<a class="anchor" id="ga3d5fbb6aae8dda99240ec38108a645af"></a><!-- doxytag: member="xbee.h::xbee_lib_init" ref="ga3d5fbb6aae8dda99240ec38108a645af" args="(void)" -->
221 199
<div class="memitem">
222 200
<div class="memproto">
223 201
      <table class="memname">
224 202
        <tr>
225
          <td class="memname">int xbee_lib_init           </td>
203
          <td class="memname">int xbee_lib_init </td>
226 204
          <td>(</td>
227 205
          <td class="paramtype">void&nbsp;</td>
228
          <td class="paramname">          </td>
206
          <td class="paramname"></td>
229 207
          <td>&nbsp;)&nbsp;</td>
230 208
          <td></td>
231 209
        </tr>
......
233 211
</div>
234 212
<div class="memdoc">
235 213

  
236
<p>
237
Initialize the XBee library. 
238
<p>
239
Initializes the XBee library so that other functions may be used. 
214
<p>Initialize the XBee library. </p>
215
<p>Initializes the XBee library so that other functions may be used. </p>
216

  
240 217
<p>References <a class="el" href="xbee_8c_source.html#l00725">xbee_get_packet()</a>.</p>
241 218

  
242 219
<p>Referenced by <a class="el" href="wireless_8c_source.html#l00102">wl_init()</a>.</p>
243 220

  
244 221
</div>
245
</div><p>
246
<a class="anchor" name="g7c44bc25fda954efde574ee8d735073c"></a><!-- doxytag: member="xbee.h::xbee_send_packet" ref="g7c44bc25fda954efde574ee8d735073c" args="(char *packet, int len, int dest, char options, char frame)" -->
222
</div>
223
<a class="anchor" id="ga7c44bc25fda954efde574ee8d735073c"></a><!-- doxytag: member="xbee.h::xbee_send_packet" ref="ga7c44bc25fda954efde574ee8d735073c" args="(char *packet, int len, int dest, char options, char frame)" -->
247 224
<div class="memitem">
248 225
<div class="memproto">
249 226
      <table class="memname">
250 227
        <tr>
251
          <td class="memname">int xbee_send_packet           </td>
228
          <td class="memname">int xbee_send_packet </td>
252 229
          <td>(</td>
253 230
          <td class="paramtype">char *&nbsp;</td>
254 231
          <td class="paramname"> <em>packet</em>, </td>
......
286 263
</div>
287 264
<div class="memdoc">
288 265

  
289
<p>
290
Send a packet to the XBee. 
291
<p>
292
Send the specified packet.<p>
293
<dl compact><dt><b>Parameters:</b></dt><dd>
266
<p>Send a packet to the XBee. </p>
267
<p>Send the specified packet.</p>
268
<dl><dt><b>Parameters:</b></dt><dd>
294 269
  <table border="0" cellspacing="2" cellpadding="0">
295 270
    <tr><td valign="top"></td><td valign="top"><em>packet</em>&nbsp;</td><td>the packet data to send </td></tr>
296 271
    <tr><td valign="top"></td><td valign="top"><em>len</em>&nbsp;</td><td>the number of bytes in the packet</td></tr>
......
298 273
    <tr><td valign="top"></td><td valign="top"><em>options</em>&nbsp;</td><td>a combination of the flags XBEE_OPTIONS_NONE, XBEE_OPTIONS_DISABLE_RESPONSE and XBEE_OPTIONS_BROADCAST_ALL_PANS</td></tr>
299 274
    <tr><td valign="top"></td><td valign="top"><em>frame</em>&nbsp;</td><td>the frame number to associate this packet with. This will be used to identify the response when the XBee alerts us as to whether or not our message was received. </td></tr>
300 275
  </table>
276
  </dd>
301 277
</dl>
302 278

  
303 279
</div>
304
</div><p>
305
<a class="anchor" name="gb93170c493c5cdfd43a7b640c6ed1d14"></a><!-- doxytag: member="xbee.h::xbee_set_channel" ref="gb93170c493c5cdfd43a7b640c6ed1d14" args="(int channel)" -->
280
</div>
281
<a class="anchor" id="gab93170c493c5cdfd43a7b640c6ed1d14"></a><!-- doxytag: member="xbee.h::xbee_set_channel" ref="gab93170c493c5cdfd43a7b640c6ed1d14" args="(int channel)" -->
306 282
<div class="memitem">
307 283
<div class="memproto">
308 284
      <table class="memname">
309 285
        <tr>
310
          <td class="memname">int xbee_set_channel           </td>
286
          <td class="memname">int xbee_set_channel </td>
311 287
          <td>(</td>
312 288
          <td class="paramtype">int&nbsp;</td>
313
          <td class="paramname"> <em>channel</em>          </td>
289
          <td class="paramname"> <em>channel</em></td>
314 290
          <td>&nbsp;)&nbsp;</td>
315 291
          <td></td>
316 292
        </tr>
......
318 294
</div>
319 295
<div class="memdoc">
320 296

  
321
<p>
322
Set the channel the XBee is currently using. 
323
<p>
324
Set the channel the XBee is using.<p>
325
<dl compact><dt><b>Parameters:</b></dt><dd>
297
<p>Set the channel the XBee is currently using. </p>
298
<p>Set the channel the XBee is using.</p>
299
<dl><dt><b>Parameters:</b></dt><dd>
326 300
  <table border="0" cellspacing="2" cellpadding="0">
327 301
    <tr><td valign="top"></td><td valign="top"><em>channel</em>&nbsp;</td><td>the channel the XBee will not use, between 0x0B and 0x1A</td></tr>
328 302
  </table>
303
  </dd>
329 304
</dl>
330
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="group__xbee.html#g133706db81f69ba0a3c169b7a3f42d2a" title="Get the channel the XBee is currently using.">xbee_get_channel</a> </dd></dl>
305
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__xbee.html#ga133706db81f69ba0a3c169b7a3f42d2a" title="Get the channel the XBee is currently using.">xbee_get_channel</a> </dd></dl>
331 306

  
332 307
<p>Referenced by <a class="el" href="wireless_8c_source.html#l00209">wl_set_channel()</a>.</p>
333 308

  
334 309
</div>
335
</div><p>
336
<a class="anchor" name="gde50cbefd7ba8d7361ce2654a298748b"></a><!-- doxytag: member="xbee.h::xbee_set_pan_id" ref="gde50cbefd7ba8d7361ce2654a298748b" args="(int id)" -->
310
</div>
311
<a class="anchor" id="gade50cbefd7ba8d7361ce2654a298748b"></a><!-- doxytag: member="xbee.h::xbee_set_pan_id" ref="gade50cbefd7ba8d7361ce2654a298748b" args="(int id)" -->
337 312
<div class="memitem">
338 313
<div class="memproto">
339 314
      <table class="memname">
340 315
        <tr>
341
          <td class="memname">int xbee_set_pan_id           </td>
316
          <td class="memname">int xbee_set_pan_id </td>
342 317
          <td>(</td>
343 318
          <td class="paramtype">int&nbsp;</td>
344
          <td class="paramname"> <em>id</em>          </td>
319
          <td class="paramname"> <em>id</em></td>
345 320
          <td>&nbsp;)&nbsp;</td>
346 321
          <td></td>
347 322
        </tr>
......
349 324
</div>
350 325
<div class="memdoc">
351 326

  
352
<p>
353
Set the PAN ID for the XBee. 
354
<p>
355
Sets the personal area network id.<p>
356
<dl compact><dt><b>Parameters:</b></dt><dd>
327
<p>Set the PAN ID for the XBee. </p>
328
<p>Sets the personal area network id.</p>
329
<dl><dt><b>Parameters:</b></dt><dd>
357 330
  <table border="0" cellspacing="2" cellpadding="0">
358 331
    <tr><td valign="top"></td><td valign="top"><em>id</em>&nbsp;</td><td>the new personal area network (PAN) id </td></tr>
359 332
  </table>
333
  </dd>
360 334
</dl>
361 335

  
362 336
<p>Referenced by <a class="el" href="wireless_8c_source.html#l00181">wl_set_pan()</a>.</p>
363 337

  
364 338
</div>
365
</div><p>
366
<a class="anchor" name="g9334ac71dca1ddd697b1a35a361ade6a"></a><!-- doxytag: member="xbee.h::xbee_terminate" ref="g9334ac71dca1ddd697b1a35a361ade6a" args="(void)" -->
339
</div>
340
<a class="anchor" id="ga9334ac71dca1ddd697b1a35a361ade6a"></a><!-- doxytag: member="xbee.h::xbee_terminate" ref="ga9334ac71dca1ddd697b1a35a361ade6a" args="(void)" -->
367 341
<div class="memitem">
368 342
<div class="memproto">
369 343
      <table class="memname">
370 344
        <tr>
371
          <td class="memname">void xbee_terminate           </td>
345
          <td class="memname">void xbee_terminate </td>
372 346
          <td>(</td>
373 347
          <td class="paramtype">void&nbsp;</td>
374
          <td class="paramname">          </td>
348
          <td class="paramname"></td>
375 349
          <td>&nbsp;)&nbsp;</td>
376 350
          <td></td>
377 351
        </tr>
......
379 353
</div>
380 354
<div class="memdoc">
381 355

  
382
<p>
383
Uninitialize the XBee library. 
384
<p>
385
Call when finished using the XBee library. This releases all sued resources. 
356
<p>Uninitialize the XBee library. </p>
357
<p>Call when finished using the XBee library. This releases all sued resources. </p>
358

  
386 359
<p>Referenced by <a class="el" href="wireless_8c_source.html#l00159">wl_terminate()</a>.</p>
387 360

  
388 361
</div>
389
</div><p>
390 362
</div>
391
<hr size="1"><address style="text-align: right;"><small>Generated on Tue Sep 8 19:59:17 2009 for libwireless by&nbsp;
363
</div>
364
<hr size="1"/><address style="text-align: right;"><small>Generated on Sun Sep 20 12:12:02 2009 for libwireless by&nbsp;
392 365
<a href="http://www.doxygen.org/index.html">
393
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.9 </small></address>
366
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.1 </small></address>
394 367
</body>
395 368
</html>

Also available in: Unified diff