Create SX127x LoRa receiver callback examples

Author: chandrawi

examples/SX126x_LoRa_receiver_callback/SX126x_LoRa_receiver_callback.ino

@@ -53,7 +53,7 @@ void setup() {
  Serial.println("Set syncronize word to 0x3444");
  LoRa.setLoRaSyncWord(0x3444);
 
- Serial.println("\n-- LoRa RECEIVER --\n");
+ Serial.println("\n-- LoRa RECEIVER CALLBACK --\n");
 
  // Register callback function to be called every RX done
  LoRa.onReceive(getReceiveData);

examples/SX127x_LoRa_receiver_callback/SX127x_LoRa_receiver_callback.ino

@@ -0,0 +1,89 @@
+#include <SX127x.h>
+
+SX127x LoRa;
+
+// receive data length and pointer
+const uint8_t packetLength = 15;
+uint8_t packetData[packetLength];
+volatile bool flag = false;
+
+void setup() {
+
+ // Begin serial communication
+ Serial.begin(38400);
+
+ // Begin LoRa radio and set NSS, reset, txen, and rxen pin with connected arduino pins
+ Serial.println("Begin LoRa radio");
+ int8_t nssPin = 10, resetPin = 9, irqPin = 2, txenPin = 8, rxenPin = 7;
+ if (!LoRa.begin(nssPin, resetPin, irqPin, txenPin, rxenPin)){
+ Serial.println("Something wrong, can't begin LoRa radio");
+ while(1);
+ }
+
+ // Set frequency to 915 Mhz
+ Serial.println("Set frequency to 915 Mhz");
+ LoRa.setFrequency(915E6);
+
+ // Set RX gain. RX gain option are power saving gain or boosted gain 
+ Serial.println("Set RX gain to power saving gain");
+ LoRa.setRxGain(SX127X_RX_GAIN_AUTO, false);
+
+ // Configure modulation parameter including spreading factor (SF), bandwidth (BW), and coding rate (CR)
+ // Transmitter must have same SF and BW setting so receiver can receive LoRa packet
+ Serial.println("Set modulation parameters:\n\tSpreading factor = 7\n\tBandwidth = 125 kHz\n\tCoding rate = 4/5");
+ LoRa.setSpreadingFactor(7);
+ LoRa.setBandwidth(125000);
+ LoRa.setCodeRate(5);
+
+ // Configure packet parameter including header type, preamble length, payload length, and CRC type
+ // The explicit packet includes header contain CR, number of byte, and CRC type
+ // Packet with explicit header can't be received by receiver with implicit header mode
+ Serial.println("Set packet parameters:\n\tExplicit header type\n\tPreamble length = 12\n\tPayload Length = 15\n\tCRC on");
+ LoRa.setHeaderType(SX127X_HEADER_EXPLICIT);
+ LoRa.setPreambleLength(12);
+ LoRa.setPayloadLength(15);
+ LoRa.setCrcType(true);
+
+ // Set syncronize word for public network (0x3444)
+ Serial.println("Set syncronize word to 0x3444");
+ LoRa.setSyncWord(0x34);
+
+ Serial.println("\n-- LoRa RECEIVER CALLBACK --\n");
+
+ // Register callback function to be called every RX done
+ LoRa.onReceive(getReceiveData);
+
+ // Begin request LoRa packet in continuous mode
+ LoRa.request(SX127X_RX_CONTINUOUS);
+}
+
+void loop() {
+
+ if (flag) {
+ // Print received package
+ Serial.write(packetData, packetLength - 1);
+ Serial.print(" ");
+ Serial.println(packetData[packetLength - 1]);
+
+ // Print packet/signal status including RSSI, SNR, and signalRSSI
+ Serial.print("Packet status: RSSI = ");
+ Serial.print(LoRa.packetRssi());
+ Serial.print(" dBm | SNR = ");
+ Serial.print(LoRa.snr());
+ Serial.println(" dB");
+ Serial.println();
+
+ // Reset flag
+ flag = false;
+ }
+}
+
+void getReceiveData() {
+
+ // set flag
+ flag = true;
+ // Store received data
+ for (uint8_t i=0; i<packetLength; i++) {
+ packetData[i] = LoRa.read();
+ }
+}