moteapifunctions.html

MatLab图像传感器网络仿真平台WiSNAP

<table border=1 cellpadding=0 width="100%" style='width:100.0%;mso-cellspacing:
 1.5pt;mso-padding-alt:0in 0in 0in 0in'>
 <tr>
  <td valign=top style='padding:.75pt .75pt .75pt .75pt'><pre>device</pre></td>
  <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
  <p class=MsoNormal>See function <a href="moteapifunctions.html#open">open</a>.
  </p>
  </td>
 </tr>
 <tr>
  <td valign=top style='padding:.75pt .75pt .75pt .75pt'><pre>handle</pre></td>
  <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
  <p class=MsoNormal>Device handle (positive integer).</p>
  </td>
 </tr>
 <tr>
  <td valign=top style='padding:.75pt .75pt .75pt .75pt'><pre>PhyInfo</pre>
  <p class=MsoNormal><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></p>
  </td>
  <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
  <p class=MsoNormal>PHY information (structure):</p>
  <p class=MsoNormal style='margin-left:30.0pt'>PhyInfo.Channel &#8211; Transceiver
  ISM channel (integer).<br>
  PhyInfo.Address &#8211; Mote's node address (integer).<br>
  PhyInfo.PanID &#8211; Personal Area Network (PAN) ID (integer).</p>
  </td>
 </tr>
</table>

<h3>Output(s)</h3>

<table border=1 cellpadding=0 width="100%" style='width:100.0%;mso-cellspacing:
 1.5pt;mso-padding-alt:0in 0in 0in 0in'>
 <tr>
  <td valign=top style='padding:.75pt .75pt .75pt .75pt'><pre>status</pre></td>
  <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
  <p class=MsoNormal>Success status (-1 = error, +1 = success).</p>
  </td>
 </tr>
</table>

<h3>Example(s)</h3>

<pre style='margin-left:30.0pt'>status = wireless_mote_api(<span
style='font-family:"Times New Roman"'>'</span>CC2420DB','init',mhandle,PhyInfo)</pre>

<p class=MsoNormal><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></p>


<div class=MsoNormal align=center style='text-align:center'>

<hr size=2 width="100%" align=center>

</div>


<h2><a name=recv></a>Function: recv</h2>

<p class=MsoNormal>Receives a MAC packet from a wireless mote.</p>

<h3>Syntax</h3>

<pre>RxMacPckt = wireless_mote_api(device,'recv',handle)</pre>

<h3>Input(s)</h3>

<table border=1 cellpadding=0 width="100%" style='width:100.0%;mso-cellspacing:
 1.5pt;mso-padding-alt:0in 0in 0in 0in'>
 <tr>
  <td valign=top style='padding:.75pt .75pt .75pt .75pt'><pre>device</pre></td>
  <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
  <p class=MsoNormal>See function <a href="moteapifunctions.html#open">open</a>.
  </p>
  </td>
 </tr>
 <tr>
  <td valign=top style='padding:.75pt .75pt .75pt .75pt'><pre>handle</pre></td>
  <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
  <p class=MsoNormal>Device handle (positive integer).</p>
  </td>
 </tr>
</table>

<h3>Output(s)</h3>

<table border=1 cellpadding=0 width="100%" style='width:100.0%;mso-cellspacing:
 1.5pt;mso-padding-alt:0in 0in 0in 0in'>
 <tr>
  <td valign=top style='padding:.75pt .75pt .75pt .75pt'><pre>RxMacPckt</pre></td>
  <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
  <p class=MsoNormal>RxMacPckt = -1 &#8211; if packet receive buffer empty.<br>
  Otherwise MAC receive packet (structure):</p>
  <p class=MsoNormal style='margin-left:30.0pt'>RxMacPckt.seqNumber &#8211; Sequence
  number (integer).<br>
  RxMacPckt.scrAddress &#8211; Source address (integer).<br>
  RxMacPckt.scrPanID &#8211; Source PAN ID (integer).<br>
  RxMacPckt.length &#8211; Payload length in bytes (positive integer).<br>
  RxMacPckt.pPayload &#8211; Payload (1xlength vector).<br>
  RxMacPckt.ackRequest &#8211; Acknowledge request (0 = no, 1 = yes).<br>
  RxMacPckt.rssi &#8211; Received signal strength indicator (integer).</p>
  </td>
 </tr>
</table>

<h3>Example(s)</h3>

<pre style='margin-left:30.0pt'>RxMacPckt = wireless_mote_api('CC2420DB','recv',mhandle)</pre>

<p class=MsoNormal><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></p>


<div class=MsoNormal align=center style='text-align:center'>

<hr size=2 width="100%" align=center>

</div>


<h2><a name=send></a>Function: send</h2>

<p class=MsoNormal>Transmits a MAC packet to a wireless mote.</p>

<h3>Syntax</h3>

<pre>status = wireless_mote_api(device,'send',handle,TxMacPckt)</pre>

<h3>Input(s)</h3>

<table border=1 cellpadding=0 width="100%" style='width:100.0%;mso-cellspacing:
 1.5pt;mso-padding-alt:0in 0in 0in 0in'>
 <tr>
  <td valign=top style='padding:.75pt .75pt .75pt .75pt'><pre>device</pre></td>
  <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
  <p class=MsoNormal>See function <a href="moteapifunctions.html#open">open</a>.
  </p>
  </td>
 </tr>
 <tr>
  <td valign=top style='padding:.75pt .75pt .75pt .75pt'><pre>handle</pre></td>
  <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
  <p class=MsoNormal>Device handle (positive integer).</p>
  </td>
 </tr>
 <tr>
  <td valign=top style='padding:.75pt .75pt .75pt .75pt'><pre>TxMacPckt</pre>
  <p class=MsoNormal><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></p>
  </td>
  <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
  <p class=MsoNormal>MAC transmit packet (structure):</p>
  <p class=MsoNormal style='margin-left:30.0pt'>TxMacPckt.destAddress &#8211; Destination
  address (integer).<br>
  TxMacPckt.destPanID &#8211; Destination PAN ID (integer).<br>
  TxMacPckt.length &#8211; Payload length in bytes (positive integer).<br>
  TxMacPckt.pPayload &#8211; Payload (1xlength vector).<br>
  TxMacPckt.ackRequest &#8211; Acknowledge request (0 = no, 1 = yes).</p>
  </td>
 </tr>
</table>

<h3>Output(s)</h3>

<table border=1 cellpadding=0 width="100%" style='width:100.0%;mso-cellspacing:
 1.5pt;mso-padding-alt:0in 0in 0in 0in'>
 <tr>
  <td valign=top style='padding:.75pt .75pt .75pt .75pt'><pre>status</pre></td>
  <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
  <p class=MsoNormal>Success status (-1 = error, +1 = success).</p>
  </td>
 </tr>
</table>

<h3>Example(s)</h3>

<pre style='margin-left:30.0pt'>status = wireless_mote_api(<span
style='font-family:"Times New Roman"'>'</span>CC2420DB','send',mhandle,TxMacPckt)</pre>

<p class=MsoNormal><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></p>


<div class=MsoNormal align=center style='text-align:center'>

<hr size=2 width="100%" align=center>

</div>


<h2><a name=close></a>Function: close</h2>

<p class=MsoNormal>Closes the communications session with the wireless mote.</p>

<h3>Syntax</h3>

<pre>status = wireless_mote_api(device,'close',handle)</pre>

<h3>Input(s)</h3>

<table border=1 cellpadding=0 width="100%" style='width:100.0%;mso-cellspacing:
 1.5pt;mso-padding-alt:0in 0in 0in 0in'>
 <tr>
  <td valign=top style='padding:.75pt .75pt .75pt .75pt'><pre>device</pre></td>
  <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
  <p class=MsoNormal>See function <a href="moteapifunctions.html#open">open</a>.
  </p>
  </td>
 </tr>
 <tr>
  <td valign=top style='padding:.75pt .75pt .75pt .75pt'><pre>handle</pre></td>
  <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
  <p class=MsoNormal>Device handle (positive integer).</p>
  </td>
 </tr>
</table>

<h3>Output(s)</h3>

<table border=1 cellpadding=0 width="100%" style='width:100.0%;mso-cellspacing:
 1.5pt;mso-padding-alt:0in 0in 0in 0in'>
 <tr>
  <td valign=top style='padding:.75pt .75pt .75pt .75pt'><pre>status</pre></td>
  <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
  <p class=MsoNormal>Success status (-1 = error, +1 = success).</p>
  </td>
 </tr>
</table>

<h3>Example(s)</h3>

<pre style='margin-left:30.0pt'>status = wireless_mote_api('CC2420DB','close',mhandle)</pre>

<p class=MsoNormal><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></p>

<u1:p></u1:p>

<div class=MsoNormal align=center style='text-align:center'>

<hr size=2 width="100%" align=center>

</div>


<p class=MsoNormal align=center style='mso-margin-top-alt:auto;mso-margin-bottom-alt:
auto;text-align:center'><u1:p></u1:p>[ <a href="moteapidescription.html">Previous</a>
| <a href="contents.html" target="_top">Contents</a> | <a
href="cc2420dblib.html">Next</a> ]</p>

<p class=MsoNormal><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></p>

</div>

</body>

</html>