MansOS Radio - Revision history

Leo: /* Examples */

2015-02-25T07:35:08Z

‎Examples

Girts: /* Examples */

2012-01-16T12:25:48Z

‎Examples

Girts at 12:21, 16 January 2012

2012-01-16T12:21:37Z

Girts: /* Examples */

2012-01-13T08:14:05Z

‎Examples

Girts: /* Function reference */

2011-12-31T05:36:36Z

‎Function reference

Girts: /* Function reference */

2011-12-31T05:35:11Z

‎Function reference

Girts: /* Function reference */

2011-12-31T05:34:03Z

‎Function reference

Girts: /* Function reference */

2011-12-31T05:32:35Z

‎Function reference

Girts: /* Function reference */

2011-12-31T05:29:34Z

‎Function reference

Girts: /* Function reference */

2011-12-31T05:27:33Z

‎Function reference

@@ Line 102: / Line 102: @@
     len = radioRecv(&counter, sizeof(counter)); // Read counter - 2 bytes
     if (len > 0) {
-        setLeds(counter); // display it on LEDs
+        ledsSet(counter); // display it on LEDs
     } else if (len < 0 ) {
         // Error - reception failed

@@ Line 81: / Line 81: @@
 == Examples ==
+ apps/demo/SimpleRadioCountToLeds
 <source lang="c">

@@ Line 1: / Line 1: @@
 __TOC__
+API header file: [http://code.google.com/p/mansos/source/browse/trunk/mos/hil/radio.h mos/hil/radio.h]
- mos/hil/radio.h
 MansOS provides API for Radio communication in [http://en.wikipedia.org/wiki/OSI_model#Layer_1:_physical_layer physical layer]. Platforms without radio modules are also supported, with NULL-radio implementation.

@@ Line 82: / Line 82: @@
 == Examples ==
+<source lang="c">
-TODO
+//-----------------------------------------------------------------------------
+//  Counter exchange application
+//  Mote broadcasts its counter which gets incremented every second.
+//  When receiving a counter value, mote displays it on leds.
+//  Implementation without threads and sockets
+//-----------------------------------------------------------------------------
+#include "stdmansos.h"
+#include "dprint.h"
+// Called when radio packet received - display received counter on LEDs
+void radioReceived() {
+    static uint16_t counter;
+    int16_t len;
+    len = radioRecv(&counter, sizeof(counter)); // Read counter - 2 bytes
+    if (len > 0) {
+        setLeds(counter); // display it on LEDs
+    } else if (len < 0 ) {
+        // Error - reception failed
+    }
+}
+//-------------------------------------------
+//      Entry point for the application
+//-------------------------------------------
+void appMain(void)
+{
+    radioInit();
+    radioOn();
+    // when a radio packet is received, call radioReceived() function
+    radioSetReceiveHandle(radioReceived);
+    sendCounter();
+}
+// Send an incrementing counter every second
+void sendCounter() {
+    uint16_t counter = 0;
+    // repeat continuously
+    while (1)
+    {
+        // send counter over radio
+        if (radioSend(&counter, sizeof(counter)) != 0) {
+            // radio sending failed - handle it!
+        }
+        msleep(1000); // sleep one second
+        ++counter;
+    }
+}
+</source>

@@ Line 68: / Line 68: @@
 void radioSetChannel(int channel)
+// Transmit power control.
+// The exact behavior of these functions is platform- and chip-dependent.
+// For CC2420, a value in range [0 .. 31] is expected,
+// where 0 corresponds to the minimal transmit power and 31 - to the maximum
+void radioSetTxPower(uint8_t power)
+// Returns true if Clear Channel Assessment (CCA) detects that transmission medium is free.
+// Always returns true if the chip does not have support for hardware CCA.
+bool radioIsChannelClear()
 </pre>

@@ Line 60: / Line 60: @@
  // Get Link Quality Indicator (LQI) of the last received packet
  int8_t radioGetLastLQI()
+// Set radio channel to use for data transmission and reception
+// The exact behavior of these functions is platform- and chip-dependent.
+// For IEEE 802.15.4 compatible radios (such as the CC2420)
+// there are 16 channels available in the 2.4 GHz band
+// in 5 MHz steps, numbered 11 through 26
+void radioSetChannel(int channel)

@@ Line 55: / Line 55: @@
  int radioGetRSSI()
- // Measure Received Signal Strength Indicator (RSSI) of the last received packet
+ // Get Received Signal Strength Indicator (RSSI) of the last received packet
  int8_t radioGetLastRSSI()
+ // Get Link Quality Indicator (LQI) of the last received packet
+ int8_t radioGetLastLQI()

@@ Line 46: / Line 46: @@
  void radioDiscard()
-//
 // Set a new radio callback function.
 // The callback function is called when a packet becomes available.
 // In general, the callback function should call radioRecv() to read the packet.
 // Returns: old callback function or NULL
-//
 RadioRecvFunction radioSetReceiveHandle(RadioRecvFunction functionHandle);
+ // Measure current Received Signal Strength Indicator (RSSI)
+ int radioGetRSSI()
+ // Measure Received Signal Strength Indicator (RSSI) of the last received packet
+ int8_t radioGetLastRSSI()

@@ Line 31: / Line 31: @@
  // Transmit <len> bytes long data buffer over radio. Radio must be turned on before calling this function!
- // Return 0 on success, error code as negative value on failure (see mos/hil/errors.h)
+ // Returns 0 on success, error code as negative value on failure (see mos/hil/errors.h)
  int8_t radioSend(const void *data, uint16_t len)
  // Transmit one byte over radio. Radio must be turned on before calling this function!
- // Return 0 on success, error code as negative value on failure (see mos/hil/errors.h)
+ // Returns 0 on success, error code as negative value on failure (see mos/hil/errors.h)
  int8_t radioSendByte(uint8_t data)
  // Write received data into the buffer. It should be called after the radio driver has signaled
  // data availability. Non-blocking function (does not wait for data to arrive)
- // Return received data length on success, error code as negative value on failure (see mos/hil/errors.h)
+ // Returns received data length on success, error code as negative value on failure (see mos/hil/errors.h)
  int16_t radioRecv(void *buffer, uint16_t bufferLength)