162 lines
4.6 KiB
C++
162 lines
4.6 KiB
C++
/*
|
|
RadioLib LR11x0 Transmit with Interrupts Example
|
|
|
|
This example transmits LoRa packets with one second delays
|
|
between them. Each packet contains up to 256 bytes
|
|
of data, in the form of:
|
|
- Arduino String
|
|
- null-terminated char array (C-string)
|
|
- arbitrary binary data (byte array)
|
|
|
|
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.
|
|
|
|
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);
|
|
|
|
// or detect the pinout automatically using RadioBoards
|
|
// https://github.com/radiolib-org/RadioBoards
|
|
/*
|
|
#define RADIO_BOARD_AUTO
|
|
#include <RadioBoards.h>
|
|
Radio radio = new RadioModule();
|
|
*/
|
|
|
|
// 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,
|
|
};
|
|
|
|
// save transmission state between loops
|
|
int transmissionState = RADIOLIB_ERR_NONE;
|
|
|
|
// flag to indicate that a packet was sent
|
|
volatile bool transmittedFlag = false;
|
|
|
|
// this function is called when a complete packet
|
|
// is transmitted by the module
|
|
// IMPORTANT: this function MUST be 'void' type
|
|
// and MUST NOT have any arguments!
|
|
#if defined(ESP8266) || defined(ESP32)
|
|
ICACHE_RAM_ATTR
|
|
#endif
|
|
void setFlag(void) {
|
|
// we sent a packet, set the flag
|
|
transmittedFlag = true;
|
|
}
|
|
|
|
void setup() {
|
|
Serial.begin(9600);
|
|
|
|
// 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) { delay(10); }
|
|
}
|
|
|
|
// set RF switch control configuration
|
|
radio.setRfSwitchTable(rfswitch_dio_pins, rfswitch_table);
|
|
|
|
// set the function that will be called
|
|
// when packet transmission is finished
|
|
radio.setPacketSentAction(setFlag);
|
|
|
|
// start transmitting the first packet
|
|
Serial.print(F("[LR1110] Sending first packet ... "));
|
|
|
|
// you can transmit C-string or Arduino string up to
|
|
// 256 characters long
|
|
transmissionState = radio.startTransmit("Hello World!");
|
|
|
|
// you can also transmit byte array up to 256 bytes long
|
|
/*
|
|
byte byteArr[] = {0x01, 0x23, 0x45, 0x67,
|
|
0x89, 0xAB, 0xCD, 0xEF};
|
|
state = radio.startTransmit(byteArr, 8);
|
|
*/
|
|
}
|
|
|
|
// counter to keep track of transmitted packets
|
|
int count = 0;
|
|
|
|
void loop() {
|
|
// check if the previous transmission finished
|
|
if(transmittedFlag) {
|
|
// reset flag
|
|
transmittedFlag = false;
|
|
|
|
if (transmissionState == RADIOLIB_ERR_NONE) {
|
|
// packet was successfully sent
|
|
Serial.println(F("transmission finished!"));
|
|
|
|
// NOTE: when using interrupt-driven transmit method,
|
|
// it is not possible to automatically measure
|
|
// transmission data rate using getDataRate()
|
|
|
|
} else {
|
|
Serial.print(F("failed, code "));
|
|
Serial.println(transmissionState);
|
|
|
|
}
|
|
|
|
// clean up after transmission is finished
|
|
// this will ensure transmitter is disabled,
|
|
// RF switch is powered down etc.
|
|
radio.finishTransmit();
|
|
|
|
// wait a second before transmitting again
|
|
delay(1000);
|
|
|
|
// send another one
|
|
Serial.print(F("[LR1110] Sending another packet ... "));
|
|
|
|
// you can transmit C-string or Arduino string up to
|
|
// 256 characters long
|
|
String str = "Hello World! #" + String(count++);
|
|
transmissionState = radio.startTransmit(str);
|
|
|
|
// you can also transmit byte array up to 256 bytes long
|
|
/*
|
|
byte byteArr[] = {0x01, 0x23, 0x45, 0x67,
|
|
0x89, 0xAB, 0xCD, 0xEF};
|
|
transmissionState = radio.startTransmit(byteArr, 8);
|
|
*/
|
|
}
|
|
}
|