Updated files.

[tinyos-2.x.git] / tos / chips / cc2420_lpl / CC2420Packet.nc

diff --git a/tos/chips/cc2420_lpl/CC2420Packet.nc b/tos/chips/cc2420_lpl/CC2420Packet.nc
new file mode 100644 (file)
index 0000000..5eee2ae
--- /dev/null
+++ b/tos/chips/cc2420_lpl/CC2420Packet.nc
@@ -0,0 +1,71 @@
+/*\r
+ * Copyright (c) 2005-2006 Arch Rock Corporation\r
+ * All rights reserved.\r
+ *\r
+ * Redistribution and use in source and binary forms, with or without\r
+ * modification, are permitted provided that the following conditions\r
+ * are met:\r
+ * - Redistributions of source code must retain the above copyright\r
+ *   notice, this list of conditions and the following disclaimer.\r
+ * - Redistributions in binary form must reproduce the above copyright\r
+ *   notice, this list of conditions and the following disclaimer in the\r
+ *   documentation and/or other materials provided with the\r
+ *   distribution.\r
+ * - Neither the name of the Arch Rock Corporation nor the names of\r
+ *   its contributors may be used to endorse or promote products derived\r
+ *   from this software without specific prior written permission.\r
+ *\r
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS\r
+ * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT\r
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS\r
+ * FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE\r
+ * ARCHED ROCK OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,\r
+ * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES\r
+ * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR\r
+ * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)\r
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,\r
+ * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)\r
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED\r
+ * OF THE POSSIBILITY OF SUCH DAMAGE\r
+ */\r
+\r
+/**\r
+ * @author Jonathan Hui <jhui@archrock.com>\r
+ * @version $Revision$ $Date$\r
+ */\r
+\r
+interface CC2420Packet {\r
+  \r
+  /**\r
+   * Get transmission power setting for current packet.\r
+   *\r
+   * @param the message\r
+   */\r
+  async command uint8_t getPower( message_t* p_msg );\r
+\r
+  /**\r
+   * Set transmission power for a given packet. Valid ranges are\r
+   * between 0 and 31.\r
+   *\r
+   * @param p_msg the message.\r
+   * @param power transmission power.\r
+   */\r
+  async command void setPower( message_t* p_msg, uint8_t power );\r
+  \r
+  /**\r
+   * Get rssi value for a given packet. For received packets, it is\r
+   * the received signal strength when receiving that packet. For sent\r
+   * packets, it is the received signal strength of the ack if an ack\r
+   * was received.\r
+   */\r
+  async command int8_t getRssi( message_t* p_msg );\r
+\r
+  /**\r
+   * Get lqi value for a given packet. For received packets, it is the\r
+   * link quality indicator value when receiving that packet. For sent\r
+   * packets, it is the link quality indicator value of the ack if an\r
+   * ack was received.\r
+   */\r
+  async command uint8_t getLqi( message_t* p_msg );\r
+  \r
+}\r