RF69 - Updated examples

examples/RF69_Receive_Address/RF69_Receive_Address.ino

@@ -0,0 +1,117 @@
+/*
+ * KiteLib RF69 Receive with Address Example
+ * 
+ * This example receives packets using RF69 FSK radio module.
+ * Packets can have 1-byte address of the destination node.
+ * After setting node (or broadcast) address, this node will 
+ * automatically filter out any packets that do not contain 
+ * either node address or broadcast address.
+ */
+
+// include the library
+#include <KiteLib.h>
+
+// RF69 module is in slot A on the shield
+RF69 rf = Kite.ModuleA;
+
+void setup() {
+  Serial.begin(9600);
+
+  // initialize RF69 with default settings
+  Serial.print(F("[RF69] Initializing ... "));
+  // carrier frequency:                   434.0 MHz
+  // bit rate:                            48.0 kbps
+  // Rx bandwidth:                        125.0 kHz
+  // frequency deviation:                 50.0 kHz
+  // output power:                        13 dBm
+  // sync word:                           0x2D  0x01
+  byte state = rf.begin();
+  if(state == ERR_NONE) {
+    Serial.println(F("success!"));
+  } else {
+    Serial.print(F("failed, code 0x"));
+    Serial.println(state, HEX);
+    while(true);
+  }
+
+  // set node address
+  // NOTE: calling this method will autmatically enable
+  // address filtering (node address only)
+  Serial.print(F("[RF69] Setting node address ... "));
+  state == rf.setNodeAddress(0x02);
+  if(state == ERR_NONE) {
+    Serial.println(F("success!"));
+  } else {
+    Serial.print(F("failed, code 0x"));
+    Serial.println(state, HEX);
+    while(true);
+  }
+
+  // set broadcast address
+  // NOTE: calling this method will autmatically enable
+  // address filtering (node or broadcast address)
+  Serial.print(F("[RF69] Setting broadcast address ... "));
+  state == rf.setBroadcastAddress(0xFF);
+  if(state == ERR_NONE) {
+    Serial.println(F("success!"));
+  } else {
+    Serial.print(F("failed, code 0x"));
+    Serial.println(state, HEX);
+    while(true);
+  }
+
+  // address filtering can also be disabled
+  // NOTE: calling this method will also erase previously set
+  // node and broadcast address
+  /*
+  Serial.print(F("[RF69] Disabling address filtering ... "));
+  state == rf.disableAddressFiltering();
+  if(state == ERR_NONE) {
+    Serial.println(F("success!"));
+  } else {
+    Serial.print(F("failed, code 0x"));
+    Serial.println(state, HEX);
+    while(true);
+  }
+  */
+}
+
+void loop() {
+  Serial.print(F("[RF69] Waiting for incoming transmission ... "));
+
+  // you can receive data as an Arduino String
+  String str;
+  byte state = rf.receive(str);
+
+  // you can also receive data as byte array
+  /*
+  byte byteArr[8];
+  byte state = rf.receive(byteArr, 8);
+  */
+
+  if(state == ERR_NONE) {
+    // packet was successfully received
+    Serial.println(F("success!"));
+
+    // print the data of the packet
+    Serial.print(F("[RF69] Data:\t\t"));
+    Serial.println(str);
+    /*
+    for(int i = 0; i < 8; i++) {
+      Serial.print("0x");
+      Serial.print(byteArr[i], HEX);
+      Serial.print(' ');
+    }
+    Serial.println();
+    */
+    
+  } else if(state == ERR_RX_TIMEOUT) {
+    // timeout occurred while waiting for a packet
+    Serial.println(F("timeout!"));
+    
+  } else if(state == ERR_CRC_MISMATCH) {
+    // packet was received, but is malformed
+    Serial.println(F("CRC error!"));
+    
+  }
+}

examples/RF69_Transmit/RF69_Transmit.ino

@@ -34,12 +34,12 @@ void setup() {
 void loop() {
   Serial.print(F("[RF69] Transmitting packet ... "));
 
-  // you can transmit C-string or Arduino string up to 256 characters long
+  // you can transmit C-string or Arduino string up to 64 characters long
   byte state = rf.transmit("Hello World!");
   
-  // you can also transmit byte array up to 256 bytes long
+  // you can also transmit byte array up to 64 bytes long
   /*
-  byte byteArr[] = {0x01, 0x23, 0x45, 0x56, 0x78, 0xAB, 0xCD, 0xEF};
+  byte byteArr[] = {0x01, 0x23, 0x45, 0x67, 0x89, 0xAB, 0xCD, 0xEF};
   byte state = rf.transmit(byteArr, 8);
   */
   

examples/RF69_Transmit_Address/RF69_Transmit_Address.ino

@@ -0,0 +1,114 @@
+/*
+ * KiteLib RF69 Transmit to Address Example
+ * 
+ * This example transmits packets using RF69 FSK radio module.
+ * Packets can have 1-byte address of the destination node.
+ * After setting node (or broadcast) address, this node will 
+ * automatically filter out any packets that do not contain 
+ * either node address or broadcast address.
+ */
+
+// include the library
+#include <KiteLib.h>
+
+// RF69 module is in slot A on the shield
+RF69 rf = Kite.ModuleA;
+
+void setup() {
+  Serial.begin(9600);
+
+  // initialize RF69 with default settings
+  Serial.print(F("[RF69] Initializing ... "));
+  // carrier frequency:                   434.0 MHz
+  // bit rate:                            48.0 kbps
+  // Rx bandwidth:                        125.0 kHz
+  // frequency deviation:                 50.0 kHz
+  // output power:                        13 dBm
+  // sync word:                           0x2D  0x01
+  byte state = rf.begin();
+  if(state == ERR_NONE) {
+    Serial.println(F("success!"));
+  } else {
+    Serial.print(F("failed, code 0x"));
+    Serial.println(state, HEX);
+    while(true);
+  }
+
+  // set node address
+  // NOTE: calling this method will autmatically enable
+  // address filtering (node address only)
+  Serial.print(F("[RF69] Setting node address ... "));
+  state == rf.setNodeAddress(0x01);
+  if(state == ERR_NONE) {
+    Serial.println(F("success!"));
+  } else {
+    Serial.print(F("failed, code 0x"));
+    Serial.println(state, HEX);
+    while(true);
+  }
+
+  // set broadcast address
+  // NOTE: calling this method will autmatically enable
+  // address filtering (node or broadcast address)
+  Serial.print(F("[RF69] Setting broadcast address ... "));
+  state == rf.setBroadcastAddress(0xFF);
+  if(state == ERR_NONE) {
+    Serial.println(F("success!"));
+  } else {
+    Serial.print(F("failed, code 0x"));
+    Serial.println(state, HEX);
+    while(true);
+  }
+
+  // address filtering can also be disabled
+  // NOTE: calling this method will also erase previously set
+  // node and broadcast address
+  /*
+  Serial.print(F("[RF69] Disabling address filtering ... "));
+  state == rf.disableAddressFiltering();
+  if(state == ERR_NONE) {
+    Serial.println(F("success!"));
+  } else {
+    Serial.print(F("failed, code 0x"));
+    Serial.println(state, HEX);
+    while(true);
+  }
+  */
+}
+
+void loop() {
+  Serial.print(F("[RF69] Transmitting packet ... "));
+
+  // transmit C-string or Arduino string to node with address 0x02
+  //byte state = rf.transmit("Hello World!", 0x02);
+  
+  // transmit byte array to node with address 0x02
+  
+  byte byteArr[] = {0x01, 0x23, 0x45, 0x67, 0x89, 0xAB, 0xCD, 0xEF};
+  byte state = rf.transmit(byteArr, 8, 0x02);
+  
+
+  // transmit C-string or Arduino string in broadcast mode
+  /*
+  byte state = rf.transmit("Hello World!", 0xFF);
+  */
+
+  // transmit byte array in broadcast mode
+  /*
+  byte byteArr[] = {0x01, 0x23, 0x45, 0x56, 0x78, 0xAB, 0xCD, 0xEF};
+  byte state = rf.transmit(byteArr, 8, 0xFF);
+  */
+  
+  if(state == ERR_NONE) {
+    // the packet was successfully transmitted
+    Serial.println(" success!");
+    
+  } else if(state == ERR_PACKET_TOO_LONG) {
+    // the supplied packet was longer than 256 bytes
+    Serial.println(" too long!");
+    
+  }
+
+  // wait for a second before transmitting again
+  delay(1000);
+}