128 lines
3.6 KiB
C++
128 lines
3.6 KiB
C++
/*
|
|
RadioLib LR11x0 Blocking Receive Example
|
|
|
|
This example listens for LoRa transmissions using LR11x0 Lora modules.
|
|
To successfully receive data, the following settings have to be the same
|
|
on both transmitter and receiver:
|
|
- carrier frequency
|
|
- bandwidth
|
|
- spreading factor
|
|
- coding rate
|
|
- sync word
|
|
- preamble length
|
|
|
|
Other modules from LR11x0 family can also be used.
|
|
|
|
This example assumes Seeed Studio Wio WM1110 is used.
|
|
For other LR11x0 modules, some configuration such as
|
|
RF switch control may have to be adjusted.
|
|
|
|
Using blocking receive is not recommended, as it will lead
|
|
to significant amount of timeouts, inefficient use of processor
|
|
time and can some miss packets!
|
|
Instead, interrupt receive is recommended.
|
|
|
|
For default module settings, see the wiki page
|
|
https://github.com/jgromes/RadioLib/wiki/Default-configuration#lr11x0---lora-modem
|
|
|
|
For full API reference, see the GitHub Pages
|
|
https://jgromes.github.io/RadioLib/
|
|
*/
|
|
|
|
// include the library
|
|
#include <RadioLib.h>
|
|
|
|
// LR1110 has the following connections:
|
|
// NSS pin: 10
|
|
// IRQ pin: 2
|
|
// NRST pin: 3
|
|
// BUSY pin: 9
|
|
LR1110 radio = new Module(10, 2, 3, 9);
|
|
|
|
// set RF switch configuration for Wio WM1110
|
|
// Wio WM1110 uses DIO5 and DIO6 for RF switching
|
|
// NOTE: other boards may be different!
|
|
static const uint32_t rfswitch_dio_pins[] = {
|
|
RADIOLIB_LR11X0_DIO5, RADIOLIB_LR11X0_DIO6,
|
|
RADIOLIB_NC, RADIOLIB_NC, RADIOLIB_NC
|
|
};
|
|
|
|
static const Module::RfSwitchMode_t rfswitch_table[] = {
|
|
// mode DIO5 DIO6
|
|
{ LR11x0::MODE_STBY, { LOW, LOW } },
|
|
{ LR11x0::MODE_RX, { HIGH, LOW } },
|
|
{ LR11x0::MODE_TX, { HIGH, HIGH } },
|
|
{ LR11x0::MODE_TX_HP, { LOW, HIGH } },
|
|
{ LR11x0::MODE_TX_HF, { LOW, LOW } },
|
|
{ LR11x0::MODE_GNSS, { LOW, LOW } },
|
|
{ LR11x0::MODE_WIFI, { LOW, LOW } },
|
|
END_OF_MODE_TABLE,
|
|
};
|
|
|
|
void setup() {
|
|
Serial.begin(9600);
|
|
|
|
// set RF switch control configuration
|
|
// this has to be done prior to calling begin()
|
|
radio.setRfSwitchTable(rfswitch_dio_pins, rfswitch_table);
|
|
|
|
// initialize LR1110 with default settings
|
|
Serial.print(F("[LR1110] Initializing ... "));
|
|
int state = radio.begin();
|
|
if (state == RADIOLIB_ERR_NONE) {
|
|
Serial.println(F("success!"));
|
|
} else {
|
|
Serial.print(F("failed, code "));
|
|
Serial.println(state);
|
|
while (true);
|
|
}
|
|
}
|
|
|
|
void loop() {
|
|
Serial.print(F("[LR1110] Waiting for incoming transmission ... "));
|
|
|
|
// you can receive data as an Arduino String
|
|
String str;
|
|
int state = radio.receive(str);
|
|
|
|
// you can also receive data as byte array
|
|
/*
|
|
byte byteArr[8];
|
|
int state = radio.receive(byteArr, 8);
|
|
*/
|
|
|
|
if (state == RADIOLIB_ERR_NONE) {
|
|
// packet was successfully received
|
|
Serial.println(F("success!"));
|
|
|
|
// print the data of the packet
|
|
Serial.print(F("[LR1110] Data:\t\t"));
|
|
Serial.println(str);
|
|
|
|
// print the RSSI (Received Signal Strength Indicator)
|
|
// of the last received packet
|
|
Serial.print(F("[LR1110] RSSI:\t\t"));
|
|
Serial.print(radio.getRSSI());
|
|
Serial.println(F(" dBm"));
|
|
|
|
// print the SNR (Signal-to-Noise Ratio)
|
|
// of the last received packet
|
|
Serial.print(F("[LR1110] SNR:\t\t"));
|
|
Serial.print(radio.getSNR());
|
|
Serial.println(F(" dB"));
|
|
|
|
} else if (state == RADIOLIB_ERR_RX_TIMEOUT) {
|
|
// timeout occurred while waiting for a packet
|
|
Serial.println(F("timeout!"));
|
|
|
|
} else if (state == RADIOLIB_ERR_CRC_MISMATCH) {
|
|
// packet was received, but is malformed
|
|
Serial.println(F("CRC error!"));
|
|
|
|
} else {
|
|
// some other error occurred
|
|
Serial.print(F("failed, code "));
|
|
Serial.println(state);
|
|
|
|
}
|
|
}
|