Merge branch 'jgromes:master' into FIFO-Refill
This commit is contained in:
commit
e517fdc5f2
12 changed files with 401 additions and 111 deletions
|
@ -1,96 +0,0 @@
|
||||||
/*
|
|
||||||
RadioLib SX126x LR-FHSS Modem Example
|
|
||||||
|
|
||||||
This example shows how to use LR-FHSS modem in SX126x chips.
|
|
||||||
This modem can only transmit data, and is not able to receive.
|
|
||||||
|
|
||||||
NOTE: The sketch below is just a guide on how to use
|
|
||||||
LR-FHSS modem, so this code should not be run directly!
|
|
||||||
Instead, modify the other examples to use LR-FHSS
|
|
||||||
modem and use the appropriate configuration
|
|
||||||
methods.
|
|
||||||
|
|
||||||
For default module settings, see the wiki page
|
|
||||||
https://github.com/jgromes/RadioLib/wiki/Default-configuration#sx126x---lr-fhss-modem
|
|
||||||
|
|
||||||
For full API reference, see the GitHub Pages
|
|
||||||
https://jgromes.github.io/RadioLib/
|
|
||||||
*/
|
|
||||||
|
|
||||||
// include the library
|
|
||||||
#include <RadioLib.h>
|
|
||||||
|
|
||||||
// SX1262 has the following connections:
|
|
||||||
// NSS pin: 10
|
|
||||||
// IRQ pin: 2
|
|
||||||
// NRST pin: 3
|
|
||||||
// BUSY pin: 9
|
|
||||||
SX1262 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();
|
|
||||||
*/
|
|
||||||
|
|
||||||
void setup() {
|
|
||||||
Serial.begin(9600);
|
|
||||||
|
|
||||||
// initialize SX1262 with default settings
|
|
||||||
Serial.print(F("[SX1262] Initializing ... "));
|
|
||||||
int state = radio.beginLRFHSS();
|
|
||||||
if (state == RADIOLIB_ERR_NONE) {
|
|
||||||
Serial.println(F("success!"));
|
|
||||||
} else {
|
|
||||||
Serial.print(F("failed, code "));
|
|
||||||
Serial.println(state);
|
|
||||||
while (true) { delay(10); }
|
|
||||||
}
|
|
||||||
|
|
||||||
// if needed, you can switch between any of the modems
|
|
||||||
//
|
|
||||||
// radio.begin() start LoRa modem (and disable LR-FHSS)
|
|
||||||
// radio.beginLRFHSS() start LR-FHSS modem (and disable LoRa)
|
|
||||||
|
|
||||||
// the following settings can also
|
|
||||||
// be modified at run-time
|
|
||||||
state = radio.setFrequency(433.5);
|
|
||||||
state = radio.setLrFhssConfig(RADIOLIB_SX126X_LR_FHSS_BW_1523_4, // bandwidth
|
|
||||||
RADIOLIB_SX126X_LR_FHSS_CR_1_2, // coding rate
|
|
||||||
3, // header count
|
|
||||||
0x13A); // hopping sequence seed
|
|
||||||
state = radio.setOutputPower(10.0);
|
|
||||||
uint8_t syncWord[] = {0x01, 0x23, 0x45, 0x67};
|
|
||||||
state = radio.setSyncWord(syncWord, 4);
|
|
||||||
if (state != RADIOLIB_ERR_NONE) {
|
|
||||||
Serial.print(F("Unable to set configuration, code "));
|
|
||||||
Serial.println(state);
|
|
||||||
while (true) { delay(10); }
|
|
||||||
}
|
|
||||||
|
|
||||||
#warning "This sketch is just an API guide! Read the note at line 6."
|
|
||||||
}
|
|
||||||
|
|
||||||
void loop() {
|
|
||||||
// LR-FHSS modem can only transmit!
|
|
||||||
// transmit LR-FHSS packet
|
|
||||||
int state = radio.transmit("Hello World!");
|
|
||||||
/*
|
|
||||||
byte byteArr[] = {0x01, 0x23, 0x45, 0x67,
|
|
||||||
0x89, 0xAB, 0xCD, 0xEF};
|
|
||||||
int state = radio.transmit(byteArr, 8);
|
|
||||||
*/
|
|
||||||
if (state == RADIOLIB_ERR_NONE) {
|
|
||||||
Serial.println(F("[SX1262] Packet transmitted successfully!"));
|
|
||||||
} else if (state == RADIOLIB_ERR_PACKET_TOO_LONG) {
|
|
||||||
Serial.println(F("[SX1262] Packet too long!"));
|
|
||||||
} else if (state == RADIOLIB_ERR_TX_TIMEOUT) {
|
|
||||||
Serial.println(F("[SX1262] Timed out while transmitting!"));
|
|
||||||
} else {
|
|
||||||
Serial.println(F("[SX1262] Failed to transmit packet, code "));
|
|
||||||
Serial.println(state);
|
|
||||||
}
|
|
||||||
|
|
||||||
}
|
|
|
@ -0,0 +1,113 @@
|
||||||
|
/*
|
||||||
|
RadioLib SX126x LR-FHSS Modem Example
|
||||||
|
|
||||||
|
This example shows how to use LR-FHSS modem in SX126x chips.
|
||||||
|
This modem can only transmit data, and is not able to receive.
|
||||||
|
|
||||||
|
This example transmits packets using SX1262 LoRa radio module.
|
||||||
|
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 SX126x family can also be used.
|
||||||
|
|
||||||
|
Using blocking transmit is not recommended, as it will lead
|
||||||
|
to inefficient use of processor time!
|
||||||
|
Instead, interrupt transmit is recommended.
|
||||||
|
|
||||||
|
For default module settings, see the wiki page
|
||||||
|
https://github.com/jgromes/RadioLib/wiki/Default-configuration#sx126x---lr-fhss-modem
|
||||||
|
|
||||||
|
For full API reference, see the GitHub Pages
|
||||||
|
https://jgromes.github.io/RadioLib/
|
||||||
|
*/
|
||||||
|
|
||||||
|
// include the library
|
||||||
|
#include <RadioLib.h>
|
||||||
|
|
||||||
|
// SX1262 has the following connections:
|
||||||
|
// NSS pin: 10
|
||||||
|
// IRQ pin: 2
|
||||||
|
// NRST pin: 3
|
||||||
|
// BUSY pin: 9
|
||||||
|
SX1262 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();
|
||||||
|
*/
|
||||||
|
|
||||||
|
void setup() {
|
||||||
|
Serial.begin(9600);
|
||||||
|
|
||||||
|
// initialize SX1262 with default settings
|
||||||
|
Serial.print(F("[SX1262] Initializing ... "));
|
||||||
|
int state = radio.beginLRFHSS();
|
||||||
|
if (state == RADIOLIB_ERR_NONE) {
|
||||||
|
Serial.println(F("success!"));
|
||||||
|
} else {
|
||||||
|
Serial.print(F("failed, code "));
|
||||||
|
Serial.println(state);
|
||||||
|
while (true) { delay(10); }
|
||||||
|
}
|
||||||
|
|
||||||
|
// some modules have an external RF switch
|
||||||
|
// controlled via two pins (RX enable, TX enable)
|
||||||
|
// to enable automatic control of the switch,
|
||||||
|
// call the following method
|
||||||
|
// RX enable: 4
|
||||||
|
// TX enable: 5
|
||||||
|
/*
|
||||||
|
radio.setRfSwitchPins(4, 5);
|
||||||
|
*/
|
||||||
|
}
|
||||||
|
|
||||||
|
// counter to keep track of transmitted packets
|
||||||
|
int count = 0;
|
||||||
|
|
||||||
|
void loop() {
|
||||||
|
// LR-FHSS modem can only transmit!
|
||||||
|
Serial.print(F("[SX1262] Transmitting packet ... "));
|
||||||
|
|
||||||
|
// you can transmit C-string or Arduino string up to
|
||||||
|
// 256 characters long
|
||||||
|
String str = "Hello World! #" + String(count++);
|
||||||
|
int state = radio.transmit(str);
|
||||||
|
|
||||||
|
// you can also transmit byte array up to 256 bytes long
|
||||||
|
/*
|
||||||
|
byte byteArr[] = {0x01, 0x23, 0x45, 0x56, 0x78, 0xAB, 0xCD, 0xEF};
|
||||||
|
int state = radio.transmit(byteArr, 8);
|
||||||
|
*/
|
||||||
|
|
||||||
|
if (state == RADIOLIB_ERR_NONE) {
|
||||||
|
// the packet was successfully transmitted
|
||||||
|
Serial.println(F("success!"));
|
||||||
|
|
||||||
|
// print measured data rate
|
||||||
|
Serial.print(F("[SX1262] Datarate:\t"));
|
||||||
|
Serial.print(radio.getDataRate());
|
||||||
|
Serial.println(F(" bps"));
|
||||||
|
|
||||||
|
} else if (state == RADIOLIB_ERR_PACKET_TOO_LONG) {
|
||||||
|
// the supplied packet was longer than 256 bytes
|
||||||
|
Serial.println(F("too long!"));
|
||||||
|
|
||||||
|
} else if (state == RADIOLIB_ERR_TX_TIMEOUT) {
|
||||||
|
// timeout occurred while transmitting packet
|
||||||
|
Serial.println(F("timeout!"));
|
||||||
|
|
||||||
|
} else {
|
||||||
|
// some other error occurred
|
||||||
|
Serial.print(F("failed, code "));
|
||||||
|
Serial.println(state);
|
||||||
|
|
||||||
|
}
|
||||||
|
|
||||||
|
// wait for a second before transmitting again
|
||||||
|
delay(1000);
|
||||||
|
}
|
|
@ -0,0 +1,151 @@
|
||||||
|
/*
|
||||||
|
RadioLib SX126x LR-FHSS Transmit with Interrupts Example
|
||||||
|
|
||||||
|
This example shows how to use LR-FHSS modem in SX126x chips.
|
||||||
|
This modem can only transmit data, and is not able to receive.
|
||||||
|
|
||||||
|
This example transmits packets using SX1262 LoRa radio module.
|
||||||
|
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 SX126x family can also be used.
|
||||||
|
|
||||||
|
For default module settings, see the wiki page
|
||||||
|
https://github.com/jgromes/RadioLib/wiki/Default-configuration#sx126x---lr-fhss-modem
|
||||||
|
|
||||||
|
For full API reference, see the GitHub Pages
|
||||||
|
https://jgromes.github.io/RadioLib/
|
||||||
|
*/
|
||||||
|
|
||||||
|
// include the library
|
||||||
|
#include <RadioLib.h>
|
||||||
|
|
||||||
|
// SX1262 has the following connections:
|
||||||
|
// NSS pin: 10
|
||||||
|
// IRQ pin: 2
|
||||||
|
// NRST pin: 3
|
||||||
|
// BUSY pin: 9
|
||||||
|
SX1262 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();
|
||||||
|
*/
|
||||||
|
|
||||||
|
// save transmission state between loops
|
||||||
|
int transmissionState = RADIOLIB_ERR_NONE;
|
||||||
|
|
||||||
|
// flag to indicate that a packet was sent
|
||||||
|
// or a frequency hop is needed
|
||||||
|
volatile bool flag = 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 or need to hop, set the flag
|
||||||
|
flag = true;
|
||||||
|
}
|
||||||
|
|
||||||
|
void setup() {
|
||||||
|
Serial.begin(9600);
|
||||||
|
|
||||||
|
// initialize SX1262 with default settings
|
||||||
|
Serial.print(F("[SX1262] Initializing ... "));
|
||||||
|
int state = radio.beginLRFHSS();
|
||||||
|
if (state == RADIOLIB_ERR_NONE) {
|
||||||
|
Serial.println(F("success!"));
|
||||||
|
} else {
|
||||||
|
Serial.print(F("failed, code "));
|
||||||
|
Serial.println(state);
|
||||||
|
while (true) { delay(10); }
|
||||||
|
}
|
||||||
|
|
||||||
|
// set the function that will be called
|
||||||
|
// when packet transmission is finished
|
||||||
|
radio.setPacketSentAction(setFlag);
|
||||||
|
|
||||||
|
// start transmitting the first packet
|
||||||
|
Serial.print(F("[SX1262] 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() {
|
||||||
|
// LR-FHSS modem can only transmit!
|
||||||
|
|
||||||
|
// check if the previous transmission finished
|
||||||
|
if(flag) {
|
||||||
|
// reset flag
|
||||||
|
flag = false;
|
||||||
|
|
||||||
|
// check if this was caused by hopping or transmission finished
|
||||||
|
if(radio.getIrqFlags() & RADIOLIB_SX126X_IRQ_LR_FHSS_HOP) {
|
||||||
|
radio.hopLRFHSS();
|
||||||
|
|
||||||
|
} else {
|
||||||
|
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("[SX1262] 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);
|
||||||
|
*/
|
||||||
|
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
18
extras/cppcheck/check_file.sh
Executable file
18
extras/cppcheck/check_file.sh
Executable file
|
@ -0,0 +1,18 @@
|
||||||
|
#!/bin/bash
|
||||||
|
|
||||||
|
if [[ $@ -lt 1 ]]; then
|
||||||
|
echo "Usage: $0 <path to check>"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
path=$1
|
||||||
|
|
||||||
|
cppcheck --version
|
||||||
|
cppcheck $path --enable=all \
|
||||||
|
--force \
|
||||||
|
--inline-suppr \
|
||||||
|
--suppress=ConfigurationNotChecked \
|
||||||
|
--suppress=unusedFunction \
|
||||||
|
--suppress=missingIncludeSystem \
|
||||||
|
--suppress=missingInclude \
|
||||||
|
--quiet
|
|
@ -246,6 +246,7 @@ spectralScanAbort KEYWORD2
|
||||||
spectralScanGetStatus KEYWORD2
|
spectralScanGetStatus KEYWORD2
|
||||||
spectralScanGetResult KEYWORD2
|
spectralScanGetResult KEYWORD2
|
||||||
setPaRampTime KEYWORD2
|
setPaRampTime KEYWORD2
|
||||||
|
hopLRFHSS KEYWORD2
|
||||||
|
|
||||||
# nRF24
|
# nRF24
|
||||||
setIrqAction KEYWORD2
|
setIrqAction KEYWORD2
|
||||||
|
|
|
@ -37,6 +37,56 @@ int16_t LLCC68::begin(float freq, float bw, uint8_t sf, uint8_t cr, uint8_t sync
|
||||||
return(state);
|
return(state);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
int16_t LLCC68::beginFSK(float freq, float br, float freqDev, float rxBw, int8_t power, uint16_t preambleLength, float tcxoVoltage, bool useRegulatorLDO) {
|
||||||
|
// execute common part
|
||||||
|
int16_t state = SX126x::beginFSK(br, freqDev, rxBw, preambleLength, tcxoVoltage, useRegulatorLDO);
|
||||||
|
if(state == RADIOLIB_ERR_CHIP_NOT_FOUND) {
|
||||||
|
// bit of a hack, but some LLCC68 chips report as "SX1261", try that
|
||||||
|
// for full discussion, see https://github.com/jgromes/RadioLib/issues/1329
|
||||||
|
chipType = RADIOLIB_SX1261_CHIP_TYPE;
|
||||||
|
state = SX126x::beginFSK(br, freqDev, rxBw, preambleLength, tcxoVoltage, useRegulatorLDO);
|
||||||
|
RADIOLIB_DEBUG_PRINTLN("LLCC68 version string not found, using SX1261 instead");
|
||||||
|
}
|
||||||
|
RADIOLIB_ASSERT(state);
|
||||||
|
|
||||||
|
// configure publicly accessible settings
|
||||||
|
state = setFrequency(freq);
|
||||||
|
RADIOLIB_ASSERT(state);
|
||||||
|
|
||||||
|
state = SX126x::fixPaClamping();
|
||||||
|
RADIOLIB_ASSERT(state);
|
||||||
|
|
||||||
|
state = setOutputPower(power);
|
||||||
|
RADIOLIB_ASSERT(state);
|
||||||
|
|
||||||
|
return(state);
|
||||||
|
}
|
||||||
|
|
||||||
|
int16_t LLCC68::beginLRFHSS(float freq, uint8_t bw, uint8_t cr, bool narrowGrid, int8_t power, float tcxoVoltage, bool useRegulatorLDO) {
|
||||||
|
// execute common part
|
||||||
|
int16_t state = SX126x::beginLRFHSS(bw, cr, narrowGrid, tcxoVoltage, useRegulatorLDO);
|
||||||
|
if(state == RADIOLIB_ERR_CHIP_NOT_FOUND) {
|
||||||
|
// bit of a hack, but some LLCC68 chips report as "SX1261", try that
|
||||||
|
// for full discussion, see https://github.com/jgromes/RadioLib/issues/1329
|
||||||
|
chipType = RADIOLIB_SX1261_CHIP_TYPE;
|
||||||
|
state = SX126x::beginLRFHSS(bw, cr, narrowGrid, tcxoVoltage, useRegulatorLDO);
|
||||||
|
RADIOLIB_DEBUG_PRINTLN("LLCC68 version string not found, using SX1261 instead");
|
||||||
|
}
|
||||||
|
RADIOLIB_ASSERT(state);
|
||||||
|
|
||||||
|
// configure publicly accessible settings
|
||||||
|
state = setFrequency(freq);
|
||||||
|
RADIOLIB_ASSERT(state);
|
||||||
|
|
||||||
|
state = SX126x::fixPaClamping();
|
||||||
|
RADIOLIB_ASSERT(state);
|
||||||
|
|
||||||
|
state = setOutputPower(power);
|
||||||
|
RADIOLIB_ASSERT(state);
|
||||||
|
|
||||||
|
return(state);
|
||||||
|
}
|
||||||
|
|
||||||
int16_t LLCC68::setBandwidth(float bw) {
|
int16_t LLCC68::setBandwidth(float bw) {
|
||||||
RADIOLIB_CHECK_RANGE(bw, 100.0f, 510.0f, RADIOLIB_ERR_INVALID_BANDWIDTH);
|
RADIOLIB_CHECK_RANGE(bw, 100.0f, 510.0f, RADIOLIB_ERR_INVALID_BANDWIDTH);
|
||||||
return(SX1262::setBandwidth(bw));
|
return(SX1262::setBandwidth(bw));
|
||||||
|
|
|
@ -39,8 +39,39 @@ class LLCC68: public SX1262 {
|
||||||
\param useRegulatorLDO Whether to use only LDO regulator (true) or DC-DC regulator (false). Defaults to false.
|
\param useRegulatorLDO Whether to use only LDO regulator (true) or DC-DC regulator (false). Defaults to false.
|
||||||
\returns \ref status_codes
|
\returns \ref status_codes
|
||||||
*/
|
*/
|
||||||
int16_t begin(float freq = 434.0, float bw = 125.0, uint8_t sf = 9, uint8_t cr = 7, uint8_t syncWord = RADIOLIB_SX126X_SYNC_WORD_PRIVATE, int8_t pwr = 10, uint16_t preambleLength = 8, float tcxoVoltage = 0, bool useRegulatorLDO = false);
|
int16_t begin(float freq = 434.0, float bw = 125.0, uint8_t sf = 9, uint8_t cr = 7, uint8_t syncWord = RADIOLIB_SX126X_SYNC_WORD_PRIVATE, int8_t power = 10, uint16_t preambleLength = 8, float tcxoVoltage = 0, bool useRegulatorLDO = false) override;
|
||||||
|
|
||||||
|
/*!
|
||||||
|
\brief Initialization method for FSK modem.
|
||||||
|
\param freq Carrier frequency in MHz. Defaults to 434.0 MHz.
|
||||||
|
\param br FSK bit rate in kbps. Defaults to 4.8 kbps.
|
||||||
|
\param freqDev Frequency deviation from carrier frequency in kHz. Defaults to 5.0 kHz.
|
||||||
|
\param rxBw Receiver bandwidth in kHz. Defaults to 156.2 kHz.
|
||||||
|
\param power Output power in dBm. Defaults to 10 dBm.
|
||||||
|
\param preambleLength FSK preamble length in bits. Defaults to 16 bits.
|
||||||
|
\param tcxoVoltage TCXO reference voltage to be set on DIO3. Defaults to 0 V (XTAL).
|
||||||
|
If you are seeing -706/-707 error codes, it likely means you are using non-0 value for module with XTAL.
|
||||||
|
To use XTAL, either set this value to 0, or set SX126x::XTAL to true.
|
||||||
|
\param useRegulatorLDO Whether to use only LDO regulator (true) or DC-DC regulator (false). Defaults to false.
|
||||||
|
\returns \ref status_codes
|
||||||
|
*/
|
||||||
|
int16_t beginFSK(float freq = 434.0, float br = 4.8, float freqDev = 5.0, float rxBw = 156.2, int8_t power = 10, uint16_t preambleLength = 16, float tcxoVoltage = 0, bool useRegulatorLDO = false) override;
|
||||||
|
|
||||||
|
/*!
|
||||||
|
\brief Initialization method for LR-FHSS modem. This modem only supports transmission!
|
||||||
|
\param freq Carrier frequency in MHz. Defaults to 434.0 MHz.
|
||||||
|
\param bw LR-FHSS bandwidth, one of RADIOLIB_SX126X_LR_FHSS_BW_* values. Defaults to 722.66 kHz.
|
||||||
|
\param cr LR-FHSS coding rate, one of RADIOLIB_SX126X_LR_FHSS_CR_* values. Defaults to 2/3 coding rate.
|
||||||
|
\param narrowGrid Whether to use narrow (3.9 kHz) or wide (25.39 kHz) grid spacing. Defaults to true (narrow/non-FCC) grid.
|
||||||
|
\param power Output power in dBm. Defaults to 10 dBm.
|
||||||
|
\param tcxoVoltage TCXO reference voltage to be set. Defaults to 0 V (XTAL).
|
||||||
|
If you are seeing -706/-707 error codes, it likely means you are using non-0 value for module with XTAL.
|
||||||
|
To use XTAL, either set this value to 0, or set SX126x::XTAL to true.
|
||||||
|
\param useRegulatorLDO Whether to use only LDO regulator (true) or DC-DC regulator (false). Defaults to false.
|
||||||
|
\returns \ref status_codes
|
||||||
|
*/
|
||||||
|
int16_t beginLRFHSS(float freq = 434.0, uint8_t bw = RADIOLIB_SX126X_LR_FHSS_BW_722_66, uint8_t cr = RADIOLIB_SX126X_LR_FHSS_CR_2_3, bool narrowGrid = true, int8_t power = 10, float tcxoVoltage = 0, bool useRegulatorLDO = false) override;
|
||||||
|
|
||||||
// configuration methods
|
// configuration methods
|
||||||
|
|
||||||
/*!
|
/*!
|
||||||
|
|
|
@ -75,7 +75,7 @@ class SX1262: public SX126x {
|
||||||
\param useRegulatorLDO Whether to use only LDO regulator (true) or DC-DC regulator (false). Defaults to false.
|
\param useRegulatorLDO Whether to use only LDO regulator (true) or DC-DC regulator (false). Defaults to false.
|
||||||
\returns \ref status_codes
|
\returns \ref status_codes
|
||||||
*/
|
*/
|
||||||
int16_t beginLRFHSS(float freq = 434.0, uint8_t bw = RADIOLIB_SX126X_LR_FHSS_BW_722_66, uint8_t cr = RADIOLIB_SX126X_LR_FHSS_CR_2_3, bool narrowGrid = true, int8_t power = 10, float tcxoVoltage = 1.6, bool useRegulatorLDO = false);
|
virtual int16_t beginLRFHSS(float freq = 434.0, uint8_t bw = RADIOLIB_SX126X_LR_FHSS_BW_722_66, uint8_t cr = RADIOLIB_SX126X_LR_FHSS_CR_2_3, bool narrowGrid = true, int8_t power = 10, float tcxoVoltage = 1.6, bool useRegulatorLDO = false);
|
||||||
|
|
||||||
// configuration methods
|
// configuration methods
|
||||||
|
|
||||||
|
|
|
@ -235,8 +235,7 @@ int16_t SX126x::transmit(const uint8_t* data, size_t len, uint8_t addr) {
|
||||||
break;
|
break;
|
||||||
} else {
|
} else {
|
||||||
// handle frequency hop
|
// handle frequency hop
|
||||||
this->setLRFHSSHop(this->lrFhssHopNum % 16);
|
this->hopLRFHSS();
|
||||||
clearIrqStatus();
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
@ -477,6 +476,16 @@ int16_t SX126x::standby(uint8_t mode, bool wakeup) {
|
||||||
return(this->mod->SPIwriteStream(RADIOLIB_SX126X_CMD_SET_STANDBY, data, 1));
|
return(this->mod->SPIwriteStream(RADIOLIB_SX126X_CMD_SET_STANDBY, data, 1));
|
||||||
}
|
}
|
||||||
|
|
||||||
|
int16_t SX126x::hopLRFHSS() {
|
||||||
|
if(!(this->getIrqFlags() & RADIOLIB_SX126X_IRQ_LR_FHSS_HOP)) {
|
||||||
|
return(RADIOLIB_ERR_TX_TIMEOUT);
|
||||||
|
}
|
||||||
|
|
||||||
|
int16_t state = this->setLRFHSSHop(this->lrFhssHopNum % 16);
|
||||||
|
RADIOLIB_ASSERT(state);
|
||||||
|
return(clearIrqStatus());
|
||||||
|
}
|
||||||
|
|
||||||
void SX126x::setDio1Action(void (*func)(void)) {
|
void SX126x::setDio1Action(void (*func)(void)) {
|
||||||
this->mod->hal->attachInterrupt(this->mod->hal->pinToInterrupt(this->mod->getIrq()), func, this->mod->hal->GpioInterruptRising);
|
this->mod->hal->attachInterrupt(this->mod->hal->pinToInterrupt(this->mod->getIrq()), func, this->mod->hal->GpioInterruptRising);
|
||||||
}
|
}
|
||||||
|
|
|
@ -628,6 +628,13 @@ class SX126x: public PhysicalLayer {
|
||||||
*/
|
*/
|
||||||
int16_t standby(uint8_t mode, bool wakeup = true);
|
int16_t standby(uint8_t mode, bool wakeup = true);
|
||||||
|
|
||||||
|
/*!
|
||||||
|
\brief Handle LR-FHSS hop.
|
||||||
|
When using LR-FHSS in interrupt-driven mode, this method MUST be called each time an interrupt is triggered!
|
||||||
|
\returns \ref status_codes
|
||||||
|
*/
|
||||||
|
int16_t hopLRFHSS();
|
||||||
|
|
||||||
// interrupt methods
|
// interrupt methods
|
||||||
|
|
||||||
/*!
|
/*!
|
||||||
|
|
|
@ -1718,14 +1718,14 @@ int16_t LoRaWANNode::parseDownlink(uint8_t* data, size_t* len, LoRaWANEvent_t* e
|
||||||
cid = *mPtr; // MAC id is the first byte
|
cid = *mPtr; // MAC id is the first byte
|
||||||
|
|
||||||
// fetch length of MAC downlink payload
|
// fetch length of MAC downlink payload
|
||||||
state = this->getMacLen(cid, &fLen, RADIOLIB_LORAWAN_DOWNLINK, true);
|
state = this->getMacLen(cid, &fLen, RADIOLIB_LORAWAN_DOWNLINK, true, mPtr + 1);
|
||||||
if(state != RADIOLIB_ERR_NONE) {
|
if(state != RADIOLIB_ERR_NONE) {
|
||||||
RADIOLIB_DEBUG_PROTOCOL_PRINTLN("WARNING: Unknown MAC CID %02x", cid);
|
RADIOLIB_DEBUG_PROTOCOL_PRINTLN("WARNING: Unknown MAC CID %02x", cid);
|
||||||
RADIOLIB_DEBUG_PROTOCOL_PRINTLN("WARNING: Skipping remaining MAC commands");
|
RADIOLIB_DEBUG_PROTOCOL_PRINTLN("WARNING: Skipping remaining MAC commands");
|
||||||
break;
|
break;
|
||||||
}
|
}
|
||||||
|
|
||||||
// already fetch length of MAC answer payload (if any)
|
// already fetch length of MAC answer payload (if any), include CID
|
||||||
uint8_t fLenRe = 0;
|
uint8_t fLenRe = 0;
|
||||||
(void)this->getMacLen(cid, &fLenRe, RADIOLIB_LORAWAN_UPLINK, true);
|
(void)this->getMacLen(cid, &fLenRe, RADIOLIB_LORAWAN_UPLINK, true);
|
||||||
// don't care about return value: the previous getMacLen() would have failed anyway
|
// don't care about return value: the previous getMacLen() would have failed anyway
|
||||||
|
@ -2484,17 +2484,21 @@ int16_t LoRaWANNode::getMacDeviceTimeAns(uint32_t* gpsEpoch, uint8_t* fraction,
|
||||||
return(RADIOLIB_ERR_NONE);
|
return(RADIOLIB_ERR_NONE);
|
||||||
}
|
}
|
||||||
|
|
||||||
int16_t LoRaWANNode::getMacLen(uint8_t cid, uint8_t* len, uint8_t dir, bool inclusive) {
|
int16_t LoRaWANNode::getMacLen(uint8_t cid, uint8_t* len, uint8_t dir, bool inclusive, uint8_t* payload) {
|
||||||
|
(void)payload;
|
||||||
|
|
||||||
|
*len = 0;
|
||||||
|
if(inclusive) {
|
||||||
|
*len += 1; // add one byte for CID
|
||||||
|
}
|
||||||
|
|
||||||
LoRaWANMacCommand_t cmd = RADIOLIB_LORAWAN_MAC_COMMAND_NONE;
|
LoRaWANMacCommand_t cmd = RADIOLIB_LORAWAN_MAC_COMMAND_NONE;
|
||||||
int16_t state = this->getMacCommand(cid, &cmd);
|
int16_t state = this->getMacCommand(cid, &cmd);
|
||||||
RADIOLIB_ASSERT(state);
|
RADIOLIB_ASSERT(state);
|
||||||
if(dir == RADIOLIB_LORAWAN_UPLINK) {
|
if(dir == RADIOLIB_LORAWAN_UPLINK) {
|
||||||
*len = cmd.lenUp;
|
*len += cmd.lenUp;
|
||||||
} else {
|
} else {
|
||||||
*len = cmd.lenDn;
|
*len += cmd.lenDn;
|
||||||
}
|
|
||||||
if(inclusive) {
|
|
||||||
*len += 1; // add one byte for CID
|
|
||||||
}
|
}
|
||||||
return(RADIOLIB_ERR_NONE);
|
return(RADIOLIB_ERR_NONE);
|
||||||
}
|
}
|
||||||
|
@ -2596,7 +2600,8 @@ void LoRaWANNode::clearMacCommands(uint8_t* inOut, uint8_t* lenInOut, uint8_t di
|
||||||
uint8_t numDeleted = 0;
|
uint8_t numDeleted = 0;
|
||||||
while(i < *lenInOut) {
|
while(i < *lenInOut) {
|
||||||
uint8_t id = inOut[i];
|
uint8_t id = inOut[i];
|
||||||
uint8_t fLen = 1; // if there is an incorrect MAC command, we should at least move forward by one byte
|
uint8_t fLen = 0;
|
||||||
|
// include CID byte, so if command fails, we still move one byte forward
|
||||||
(void)this->getMacLen(id, &fLen, dir, true);
|
(void)this->getMacLen(id, &fLen, dir, true);
|
||||||
|
|
||||||
// only clear MAC command if it should not persist until a downlink is received
|
// only clear MAC command if it should not persist until a downlink is received
|
||||||
|
|
|
@ -1030,7 +1030,8 @@ class LoRaWANNode {
|
||||||
|
|
||||||
// get the length of a certain MAC command in a specific direction (up/down)
|
// get the length of a certain MAC command in a specific direction (up/down)
|
||||||
// if inclusive is true, add one for the CID byte
|
// if inclusive is true, add one for the CID byte
|
||||||
int16_t getMacLen(uint8_t cid, uint8_t* len, uint8_t dir, bool inclusive = false);
|
// include payload in case the MAC command has a dynamic length
|
||||||
|
virtual int16_t getMacLen(uint8_t cid, uint8_t* len, uint8_t dir, bool inclusive = false, uint8_t* payload = NULL);
|
||||||
|
|
||||||
// find out of a MAC command should persist destruction
|
// find out of a MAC command should persist destruction
|
||||||
// in uplink direction, some commands must persist if no downlink is received
|
// in uplink direction, some commands must persist if no downlink is received
|
||||||
|
|
Loading…
Add table
Reference in a new issue