Base class for LR11x0 series. All derived classes for LR11x0 (e.g. LR1110 or LR1120) inherit from this base class. This class should not be instantiated directly from user code, only from its derived classes. More...

#include <LR11x0.h>

Inheritance diagram for LR11x0:

Public Types
enum	OpMode_t { MODE_END_OF_TABLE = Module::MODE_END_OF_TABLE , MODE_STBY = Module::MODE_IDLE , MODE_RX = Module::MODE_RX , MODE_TX = Module::MODE_TX , MODE_TX_HP , MODE_TX_HF , MODE_GNSS , MODE_WIFI }
	Custom operation modes for LR11x0. Needed because LR11x0 has several modems (sub-GHz, 2.4 GHz etc.) in one package. More...

Public Member Functions
	LR11x0 (Module *mod)
	Default constructor. More...

int16_t	begin (float bw, uint8_t sf, uint8_t cr, uint8_t syncWord, uint16_t preambleLength, float tcxoVoltage, bool high=false)
	Initialization method for LoRa modem. More...

int16_t	beginGFSK (float br, float freqDev, float rxBw, uint16_t preambleLength, float tcxoVoltage)
	Initialization method for FSK modem. More...

int16_t	beginLRFHSS (uint8_t bw, uint8_t cr, bool narrowGrid, float tcxoVoltage)
	Initialization method for LR-FHSS modem. More...

int16_t	beginGNSS (uint8_t constellations=RADIOLIB_LR11X0_GNSS_CONSTELLATION_GPS\|RADIOLIB_LR11X0_GNSS_CONSTELLATION_BEIDOU, float tcxoVoltage=1.6)
	Initialization method for GNSS scanning. More...

int16_t	reset ()
	Reset method. Will reset the chip to the default state using RST pin. More...

int16_t	transmit (const uint8_t *data, size_t len, uint8_t addr=0) override
	Blocking binary transmit method. Overloads for string-based transmissions are implemented in PhysicalLayer. More...

int16_t	receive (uint8_t *data, size_t len) override
	Blocking binary receive method. Overloads for string-based transmissions are implemented in PhysicalLayer. More...

int16_t	transmitDirect (uint32_t frf=0) override
	Starts direct mode transmission. More...

int16_t	receiveDirect () override
	Starts direct mode reception. Only implemented for PhysicalLayer compatibility, as SX126x series does not support direct mode reception. Will always return RADIOLIB_ERR_UNKNOWN. More...

int16_t	scanChannel () override
	Performs scan for LoRa transmission in the current channel. Detects both preamble and payload. More...

int16_t	scanChannel (const ChannelScanConfig_t &config) override
	Performs scan for LoRa transmission in the current channel. Detects both preamble and payload. More...

int16_t	standby () override
	Sets the module to standby mode (overload for PhysicalLayer compatibility, uses 13 MHz RC oscillator). More...

int16_t	standby (uint8_t mode, bool wakeup=true)
	Sets the module to standby mode. More...

int16_t	sleep () override
	Sets the module to sleep mode. To wake the device up, call standby(). Overload with warm start enabled for PhysicalLayer compatibility. More...

int16_t	sleep (bool retainConfig, uint32_t sleepTime)
	Sets the module to sleep mode. To wake the device up, call standby(). More...

void	setIrqAction (void(*func)(void))
	Sets interrupt service routine to call when IRQ1 activates. More...

void	clearIrqAction ()
	Clears interrupt service routine to call when IRQ1 activates.

void	setPacketReceivedAction (void(*func)(void)) override
	Sets interrupt service routine to call when a packet is received. More...

void	clearPacketReceivedAction () override
	Clears interrupt service routine to call when a packet is received.

void	setPacketSentAction (void(*func)(void)) override
	Sets interrupt service routine to call when a packet is sent. More...

void	clearPacketSentAction () override
	Clears interrupt service routine to call when a packet is sent.

int16_t	startTransmit (const uint8_t *data, size_t len, uint8_t addr=0) override
	Interrupt-driven binary transmit method. Overloads for string-based transmissions are implemented in PhysicalLayer. More...

int16_t	finishTransmit () override
	Clean up after transmission is done. More...

int16_t	startReceive () override
	Interrupt-driven receive method with default parameters. Implemented for compatibility with PhysicalLayer. More...

int16_t	startReceive (uint32_t timeout, uint32_t irqFlags=RADIOLIB_LR11X0_IRQ_RX_DONE, uint32_t irqMask=0, size_t len=0)
	Interrupt-driven receive method. IRQ1 will be activated when full packet is received. More...

uint32_t	getIrqStatus ()
	Reads the current IRQ status. More...

int16_t	readData (uint8_t *data, size_t len) override
	Reads data received after calling startReceive method. When the packet length is not known in advance, getPacketLength method must be called BEFORE calling readData! More...

int16_t	startChannelScan () override
	Interrupt-driven channel activity detection method. IRQ1 will be activated when LoRa preamble is detected, or upon timeout. Defaults to CAD parameter values recommended by AN1200.48. More...

int16_t	startChannelScan (const ChannelScanConfig_t &config) override
	Interrupt-driven channel activity detection method. IRQ pin will be activated when LoRa preamble is detected, or upon timeout. More...

int16_t	getChannelScanResult () override
	Read the channel scan result. More...

int16_t	setBandwidth (float bw, bool high=false)
	Sets LoRa bandwidth. Allowed values are 62.5, 125.0, 250.0 and 500.0 kHz. (default, high = false) More...

int16_t	setSpreadingFactor (uint8_t sf, bool legacy=false)
	Sets LoRa spreading factor. Allowed values range from 5 to 12. More...

int16_t	setCodingRate (uint8_t cr, bool longInterleave=false)
	Sets LoRa coding rate denominator. Allowed values range from 5 to 8. More...

int16_t	setSyncWord (uint8_t syncWord)
	Sets LoRa sync word. More...

int16_t	setBitRate (float br) override
	Sets GFSK bit rate. Allowed values range from 0.6 to 300.0 kbps. More...

int16_t	setFrequencyDeviation (float freqDev) override
	Sets GFSK frequency deviation. Allowed values range from 0.0 to 200.0 kHz. More...

int16_t	setRxBandwidth (float rxBw)
	Sets GFSK receiver bandwidth. Allowed values are 4.8, 5.8, 7.3, 9.7, 11.7, 14.6, 19.5, 23.4, 29.3, 39.0, 46.9, 58.6, 78.2, 93.8, 117.3, 156.2, 187.2, 234.3, 312.0, 373.6 and 467.0 kHz. More...

int16_t	setSyncWord (uint8_t *syncWord, size_t len) override
	Sets GFSK sync word in the form of array of up to 8 bytes. More...

int16_t	setSyncBits (uint8_t *syncWord, uint8_t bitsLen)
	Sets GFSK sync word in the form of array of up to 8 bytes. More...

int16_t	setNodeAddress (uint8_t nodeAddr)
	Sets node address. Calling this method will also enable address filtering for node address only. More...

int16_t	setBroadcastAddress (uint8_t broadAddr)
	Sets broadcast address. Calling this method will also enable address filtering for node and broadcast address. More...

int16_t	disableAddressFiltering ()
	Disables address filtering. Calling this method will also erase previously set addresses. More...

int16_t	setDataShaping (uint8_t sh) override
	Sets time-bandwidth product of Gaussian filter applied for shaping. Allowed values are RADIOLIB_SHAPING_0_3, RADIOLIB_SHAPING_0_5, RADIOLIB_SHAPING_0_7 or RADIOLIB_SHAPING_1_0. Set to RADIOLIB_SHAPING_NONE to disable data shaping. More...

int16_t	setEncoding (uint8_t encoding) override
	Sets transmission encoding. Available in GFSK mode only. Serves only as alias for PhysicalLayer compatibility. More...

int16_t	fixedPacketLengthMode (uint8_t len=RADIOLIB_LR11X0_MAX_PACKET_LENGTH)
	Set modem in fixed packet length mode. Available in GFSK mode only. More...

int16_t	variablePacketLengthMode (uint8_t maxLen=RADIOLIB_LR11X0_MAX_PACKET_LENGTH)
	Set modem in variable packet length mode. Available in GFSK mode only. More...

int16_t	setWhitening (bool enabled, uint16_t initial=0x01FF)
	Sets GFSK whitening parameters. More...

int16_t	setDataRate (DataRate_t dr) override
	Set data. More...

int16_t	checkDataRate (DataRate_t dr) override
	Check the data rate can be configured by this module. More...

int16_t	setPreambleLength (size_t preambleLength) override
	Sets preamble length for LoRa or GFSK modem. Allowed values range from 1 to 65535. More...

int16_t	setTCXO (float voltage, uint32_t delay=5000)
	Sets TCXO (Temperature Compensated Crystal Oscillator) configuration. More...

int16_t	setCRC (uint8_t len, uint32_t initial=0x00001D0FUL, uint32_t polynomial=0x00001021UL, bool inverted=true)
	Sets CRC configuration. More...

int16_t	invertIQ (bool enable) override
	Enable/disable inversion of the I and Q signals. More...

float	getRSSI () override
	Gets RSSI (Recorded Signal Strength Indicator) of the last received packet. Only available for LoRa or GFSK modem. More...

float	getSNR () override
	Gets SNR (Signal to Noise Ratio) of the last received packet. Only available for LoRa modem. More...

float	getFrequencyError ()
	Gets frequency error of the latest received packet. More...

size_t	getPacketLength (bool update=true) override
	Query modem for the packet length of received payload. More...

size_t	getPacketLength (bool update, uint8_t *offset)
	Query modem for the packet length of received payload. More...

RadioLibTime_t	getTimeOnAir (size_t len) override
	Get expected time-on-air for a given size of payload. More...

RadioLibTime_t	calculateRxTimeout (RadioLibTime_t timeoutUs) override
	Calculate the timeout value for this specific module / series (in number of symbols or units of time) More...

uint32_t	getIrqFlags () override
	Read currently active IRQ flags. More...

int16_t	setIrqFlags (uint32_t irq) override
	Set interrupt on IRQ pin to be sent on a specific IRQ bit (e.g. RxTimeout, CadDone). More...

int16_t	clearIrqFlags (uint32_t irq) override
	Clear interrupt on a specific IRQ bit (e.g. RxTimeout, CadDone). More...

uint8_t	randomByte () override
	Get one truly random byte from RSSI noise. More...

int16_t	implicitHeader (size_t len)
	Set implicit header mode for future reception/transmission. More...

int16_t	explicitHeader ()
	Set explicit header mode for future reception/transmission. More...

float	getDataRate () const
	Gets effective data rate for the last transmitted packet. The value is calculated only for payload bytes. More...

int16_t	setRegulatorLDO ()
	Set regulator mode to LDO. More...

int16_t	setRegulatorDCDC ()
	Set regulator mode to DC-DC. More...

int16_t	setRxBoostedGainMode (bool en)
	Enables or disables Rx Boosted Gain mode (additional Rx gain for increased power consumption). More...

void	setRfSwitchTable (const uint32_t(&pins)[Module::RFSWITCH_MAX_PINS], const Module::RfSwitchMode_t table[])
	Some modules contain external RF switch controlled by pins. This function gives RadioLib control over those pins to automatically switch between various modes. More...

int16_t	forceLDRO (bool enable)
	Forces LoRa low data rate optimization. Only available in LoRa mode. After calling this method, LDRO will always be set to the provided value, regardless of symbol length. To re-enable automatic LDRO configuration, call LR11x0::autoLDRO() More...

int16_t	autoLDRO ()
	Re-enables automatic LDRO configuration. Only available in LoRa mode. After calling this method, LDRO will be enabled automatically when symbol length exceeds 16 ms. More...

int16_t	setLrFhssConfig (uint8_t bw, uint8_t cr, uint8_t hdrCount=3, uint16_t hopSeed=0x13A)
	Sets LR-FHSS configuration. More...

int16_t	startWifiScan (char wifiType, uint8_t mode=RADIOLIB_LR11X0_WIFI_ACQ_MODE_FULL_BEACON, uint16_t chanMask=RADIOLIB_LR11X0_WIFI_ALL_CHANNELS, uint8_t numScans=16, uint16_t timeout=100)
	Start passive WiFi scan. BUSY pin will be de-activated when the scan is finished. More...

void	setWiFiScanAction (void(*func)(void))
	Sets interrupt service routine to call when a WiFi scan is completed. More...

void	clearWiFiScanAction ()
	Clears interrupt service routine to call when a WiFi scan is completed.

int16_t	getWifiScanResultsCount (uint8_t *count)
	Get number of WiFi scan results after the scan is finished. More...

int16_t	getWifiScanResult (LR11x0WifiResult_t *result, uint8_t index, bool brief=false)
	Retrieve passive WiFi scan result. More...

int16_t	wifiScan (uint8_t wifiType, uint8_t *count, uint8_t mode=RADIOLIB_LR11X0_WIFI_ACQ_MODE_FULL_BEACON, uint16_t chanMask=RADIOLIB_LR11X0_WIFI_ALL_CHANNELS, uint8_t numScans=16, uint16_t timeout=100)
	Blocking WiFi scan method. Performs a full passive WiFi scan. This method may block for several seconds! More...

int16_t	getVersionInfo (LR11x0VersionInfo_t *info)
	Retrieve LR11x0 hardware, device and firmware version information. More...

int16_t	updateFirmware (const uint32_t *image, size_t size, bool nonvolatile=true)
	Method to upload new firmware image to the device. The device will be automatically erased, a new firmware will be uploaded, written to flash and executed. More...

int16_t	isGnssScanCapable ()
	Method to check whether the device is capable of performing a GNSS scan. More...

int16_t	gnssScan (LR11x0GnssResult_t *res=NULL)
	Performs GNSS scan. More...

int16_t	getGnssAlmanacStatus (LR11x0GnssAlmanacStatus_t *stat)
	Read information about the almanac. More...

int16_t	gnssDelayUntilSubframe (LR11x0GnssAlmanacStatus_t *stat, uint8_t constellation)
	Blocking wait until the next subframe with almanac data is available. Used to control timing during almanac update from satellite. More...

int16_t	updateGnssAlmanac (uint8_t constellation)
	Perform almanac update. Must be called immediately after gnssDelayUntilSubframe. More...

int16_t	getGnssPosition (LR11x0GnssPosition_t *pos, bool filtered=true)
	Get GNSS position. Called after gnssScan to retrieve the position calculated by the internal solver. More...

int16_t	getGnssSatellites (LR11x0GnssSatellite_t *sats, uint8_t numSats)
	Get GNSS satellites found during the last scan. More...

int16_t	getModem (ModemType_t *modem) override
	Get modem currently in use by the radio. More...

int16_t	calibrateImageRejection (float freqMin, float freqMax)
	Perform image rejection calibration for the specified frequency band. WARNING: Use at your own risk! Setting incorrect values may lead to decreased performance. More...

int16_t	transmit (const char *str, uint8_t addr=0)
	C-string transmit method. More...

virtual int16_t	transmit (const uint8_t *data, size_t len, uint8_t addr=0)
	Binary transmit method. Must be implemented in module class. More...

virtual int16_t	receive (uint8_t *data, size_t len)
	Binary receive method. Must be implemented in module class. More...

int16_t	startTransmit (const char *str, uint8_t addr=0)
	Interrupt-driven Arduino String transmit method. Unlike the standard transmit method, this one is non-blocking. Interrupt pin will be activated when transmission finishes. More...

virtual int16_t	startTransmit (const uint8_t *data, size_t len, uint8_t addr=0)
	Interrupt-driven binary transmit method. More...

virtual int16_t	readData (uint8_t *data, size_t len)
	Reads data that was received after calling startReceive method. More...

Public Member Functions inherited from PhysicalLayer
	PhysicalLayer (float step, size_t maxLen)
	Default constructor. More...

int16_t	transmit (const char *str, uint8_t addr=0)
	C-string transmit method. More...

virtual int16_t	standby (uint8_t mode)
	Sets module to a specific standby mode. More...

int16_t	startTransmit (const char *str, uint8_t addr=0)
	Interrupt-driven Arduino String transmit method. Unlike the standard transmit method, this one is non-blocking. Interrupt pin will be activated when transmission finishes. More...

virtual int16_t	setFrequency (float freq)
	Sets carrier frequency. Must be implemented in module class. More...

virtual int16_t	setOutputPower (int8_t power)
	Set output power. Must be implemented in module class if the module supports it. More...

virtual int16_t	checkOutputPower (int8_t power, int8_t *clipped)
	Check if output power is configurable. Must be implemented in module class if the module supports it. More...

float	getFreqStep () const
	Gets the module frequency step size that was set in constructor. More...

uint32_t	getIrqMapped (RadioLibIrqFlags_t irq)
	Convert from radio-agnostic IRQ flags to radio-specific flags. More...

int16_t	checkIrq (RadioLibIrqType_t irq)
	Check whether a specific IRQ bit is set (e.g. RxTimeout, CadDone). More...

int16_t	setIrq (RadioLibIrqFlags_t irq)
	Set interrupt on specific IRQ bit(s) (e.g. RxTimeout, CadDone). Keep in mind that not all radio modules support all RADIOLIB_IRQ_ flags! More...

int16_t	clearIrq (RadioLibIrqFlags_t irq)
	Clear interrupt on a specific IRQ bit (e.g. RxTimeout, CadDone). Keep in mind that not all radio modules support all RADIOLIB_IRQ_ flags! More...

int32_t	random (int32_t max)
	Get truly random number in range 0 - max. More...

int32_t	random (int32_t min, int32_t max)
	Get truly random number in range min - max. More...

int16_t	startDirect ()
	Configure module parameters for direct modes. Must be called prior to "ham" modes like RTTY or AX.25. Only available in FSK mode. More...

int16_t	setDirectSyncWord (uint32_t syncWord, uint8_t len)
	Set sync word to be used to determine start of packet in direct reception mode. More...

virtual void	setDirectAction (void(*func)(void))
	Set interrupt service routine function to call when data bit is received in direct mode. Must be implemented in module class. More...

virtual void	readBit (uint32_t pin)
	Function to read and process data bit in direct reception mode. Must be implemented in module class. More...

int16_t	available ()
	Get the number of direct mode bytes currently available in buffer. More...

void	dropSync ()
	Forcefully drop synchronization.

uint8_t	read (bool drop=true)
	Get data from direct mode buffer. More...

virtual int16_t	setDIOMapping (uint32_t pin, uint32_t value)
	Configure DIO pin mapping to get a given signal on a DIO pin (if available). More...

virtual void	setChannelScanAction (void(*func)(void))
	Sets interrupt service routine to call when a channel scan is finished. More...

virtual void	clearChannelScanAction ()
	Clears interrupt service routine to call when a channel scan is finished.

virtual int16_t	setModem (ModemType_t modem)
	Set modem for the radio to use. Will perform full reset and reconfigure the radio using its default parameters. More...

Public Attributes
bool	XTAL
	Whether the module has an XTAL (true) or TCXO (false). Defaults to false.

Detailed Description

Base class for LR11x0 series. All derived classes for LR11x0 (e.g. LR1110 or LR1120) inherit from this base class. This class should not be instantiated directly from user code, only from its derived classes.

Member Enumeration Documentation

◆ OpMode_t

enum LR11x0::OpMode_t

Custom operation modes for LR11x0. Needed because LR11x0 has several modems (sub-GHz, 2.4 GHz etc.) in one package.

Enumerator
MODE_END_OF_TABLE	End of table marker, use END_OF_MODE_TABLE constant instead
MODE_STBY	Standby/idle mode
MODE_RX	Receive mode
MODE_TX	Low power transmission mode
MODE_TX_HP	High power transmission mode
MODE_TX_HF	High frequency transmission mode
MODE_GNSS	GNSS scanning mode
MODE_WIFI	WiFi scanning mode

Constructor & Destructor Documentation

◆ LR11x0()

LR11x0::LR11x0 ( Module * mod )

explicit

Default constructor.

Parameters

mod	Instance of Module that will be used to communicate with the radio.

Member Function Documentation

◆ autoLDRO()

int16_t LR11x0::autoLDRO ( )

Re-enables automatic LDRO configuration. Only available in LoRa mode. After calling this method, LDRO will be enabled automatically when symbol length exceeds 16 ms.

Returns: Status Codes

◆ begin()

int16_t LR11x0::begin	(	float	bw,
		uint8_t	sf,
		uint8_t	cr,
		uint8_t	syncWord,
		uint16_t	preambleLength,
		float	tcxoVoltage,
		bool	high = `false`
	)

Initialization method for LoRa modem.

Parameters

bw	LoRa bandwidth in kHz.
sf	LoRa spreading factor.
cr	LoRa coding rate denominator.
syncWord	1-byte LoRa sync word.
preambleLength	LoRa preamble length in symbols
tcxoVoltage	TCXO reference voltage to be set.
high	defaults to false for Sub-GHz band, true for frequencies above 1GHz

Returns: Status Codes

◆ beginGFSK()

int16_t LR11x0::beginGFSK	(	float	br,
		float	freqDev,
		float	rxBw,
		uint16_t	preambleLength,
		float	tcxoVoltage
	)

Initialization method for FSK modem.

Parameters

br	FSK bit rate in kbps.
freqDev	Frequency deviation from carrier frequency in kHz.
rxBw	Receiver bandwidth in kHz.
preambleLength	FSK preamble length in bits.
tcxoVoltage	TCXO reference voltage to be set.

Returns: Status Codes

◆ beginGNSS()

int16_t LR11x0::beginGNSS	(	uint8_t	constellations = `RADIOLIB_LR11X0_GNSS_CONSTELLATION_GPS \| RADIOLIB_LR11X0_GNSS_CONSTELLATION_BEIDOU`,
		float	tcxoVoltage = `1.6`
	)

Initialization method for GNSS scanning.

Parameters

constellations	GNSS constellations to use (GPS, BeiDou or both). Defaults to both.
tcxoVoltage	TCXO reference voltage to be set.

Returns: Status Codes

◆ beginLRFHSS()

int16_t LR11x0::beginLRFHSS	(	uint8_t	bw,
		uint8_t	cr,
		bool	narrowGrid,
		float	tcxoVoltage
	)

Initialization method for LR-FHSS modem.

Parameters

bw	LR-FHSS bandwidth, one of RADIOLIB_LR11X0_LR_FHSS_BW_* values.
cr	LR-FHSS coding rate, one of RADIOLIB_LR11X0_LR_FHSS_CR_* values.
narrowGrid	Whether to use narrow (3.9 kHz) or wide (25.39 kHz) grid spacing.
tcxoVoltage	TCXO reference voltage to be set.

Returns: Status Codes

◆ calculateRxTimeout()

RadioLibTime_t LR11x0::calculateRxTimeout ( RadioLibTime_t timeoutUs )

overridevirtual

Calculate the timeout value for this specific module / series (in number of symbols or units of time)

Parameters

timeoutUs Timeout in microseconds to listen for

Returns: Timeout value in a unit that is specific for the used module

Reimplemented from PhysicalLayer.

◆ calibrateImageRejection()

int16_t LR11x0::calibrateImageRejection	(	float	freqMin,
		float	freqMax
	)

Perform image rejection calibration for the specified frequency band. WARNING: Use at your own risk! Setting incorrect values may lead to decreased performance.

Parameters

freqMin	Frequency band lower bound.
freqMax	Frequency band upper bound.

Returns: Status Codes

◆ checkDataRate()

int16_t LR11x0::checkDataRate ( DataRate_t dr )

overridevirtual

Check the data rate can be configured by this module.

Parameters

dr	Data rate struct. Interpretation depends on currently active modem (GFSK or LoRa).

Returns: Status Codes

Reimplemented from PhysicalLayer.

◆ clearIrqFlags()

int16_t LR11x0::clearIrqFlags ( uint32_t irq )

overridevirtual

Clear interrupt on a specific IRQ bit (e.g. RxTimeout, CadDone).

Parameters

irq	Module-specific IRQ flags.

Returns: Status Codes

Reimplemented from PhysicalLayer.

◆ disableAddressFiltering()

int16_t LR11x0::disableAddressFiltering ( )

Disables address filtering. Calling this method will also erase previously set addresses.

Returns: Status Codes

◆ explicitHeader()

int16_t LR11x0::explicitHeader ( )

Set explicit header mode for future reception/transmission.

Returns: Status Codes

◆ finishTransmit()

int16_t LR11x0::finishTransmit ( )

overridevirtual

Clean up after transmission is done.

Returns: Status Codes

Reimplemented from PhysicalLayer.

◆ fixedPacketLengthMode()

int16_t LR11x0::fixedPacketLengthMode ( uint8_t len = RADIOLIB_LR11X0_MAX_PACKET_LENGTH )

Set modem in fixed packet length mode. Available in GFSK mode only.

Parameters

len	Packet length.

Returns: Status Codes

◆ forceLDRO()

int16_t LR11x0::forceLDRO ( bool enable )

Forces LoRa low data rate optimization. Only available in LoRa mode. After calling this method, LDRO will always be set to the provided value, regardless of symbol length. To re-enable automatic LDRO configuration, call LR11x0::autoLDRO()

Parameters

enable Force LDRO to be always enabled (true) or disabled (false).

Returns: Status Codes

◆ getChannelScanResult()

int16_t LR11x0::getChannelScanResult ( )

overridevirtual

Read the channel scan result.

Returns: Status Codes

Reimplemented from PhysicalLayer.

◆ getDataRate()

float LR11x0::getDataRate ( ) const

Gets effective data rate for the last transmitted packet. The value is calculated only for payload bytes.

Returns: Effective data rate in bps.

◆ getFrequencyError()

float LR11x0::getFrequencyError ( )

Gets frequency error of the latest received packet.

Returns: Frequency error in Hz.

◆ getGnssAlmanacStatus()

int16_t LR11x0::getGnssAlmanacStatus ( LR11x0GnssAlmanacStatus_t * stat )

Read information about the almanac.

Parameters

stat	Pointer to structure to save the almanac status into. This is not the actual almanac, just a structure providing information about it.

Returns: Status Codes

◆ getGnssPosition()

int16_t LR11x0::getGnssPosition	(	LR11x0GnssPosition_t *	pos,
		bool	filtered = `true`
	)

Get GNSS position. Called after gnssScan to retrieve the position calculated by the internal solver.

Parameters

pos	Pointer to LR11x0GnssPosition_t structure to populate.
filtered	Whether to save the filtered, or unfiltered values. Defaults to true (filtered).

Returns: Status Codes

◆ getGnssSatellites()

int16_t LR11x0::getGnssSatellites	(	LR11x0GnssSatellite_t *	sats,
		uint8_t	numSats
	)

Get GNSS satellites found during the last scan.

Parameters

sats	Pointer to array of LR11x0GnssSatellite_t structures to populate.
numSats	Number of satellites to read. Can be retrieved from LR11x0GnssResult_t passed to gnssScan.

Returns: Status Codes

◆ getIrqFlags()

uint32_t LR11x0::getIrqFlags ( )

overridevirtual

Read currently active IRQ flags.

Returns: IRQ flags.

Reimplemented from PhysicalLayer.

◆ getIrqStatus()

uint32_t LR11x0::getIrqStatus ( )

Reads the current IRQ status.

Returns: IRQ status bits

◆ getModem()

int16_t LR11x0::getModem ( ModemType_t * modem )

overridevirtual

Get modem currently in use by the radio.

Parameters

modem Pointer to a variable to save the retrieved configuration into.

Returns: Status Codes

Reimplemented from PhysicalLayer.

◆ getPacketLength() [1/2]

size_t LR11x0::getPacketLength	(	bool	update,
		uint8_t *	offset
	)

Query modem for the packet length of received payload.

Parameters

update Update received packet length. Will return cached value when set to false.

Returns: Length of last received packet in bytes.

◆ getPacketLength() [2/2]

size_t LR11x0::getPacketLength ( bool update = true )

overridevirtual

Query modem for the packet length of received payload.

Parameters

update Update received packet length. Will return cached value when set to false.

Returns: Length of last received packet in bytes.

Reimplemented from PhysicalLayer.

◆ getRSSI()

float LR11x0::getRSSI ( )

overridevirtual

Gets RSSI (Recorded Signal Strength Indicator) of the last received packet. Only available for LoRa or GFSK modem.

Returns: RSSI of the last received packet in dBm.

Reimplemented from PhysicalLayer.

◆ getSNR()

float LR11x0::getSNR ( )

overridevirtual

Gets SNR (Signal to Noise Ratio) of the last received packet. Only available for LoRa modem.

Returns: SNR of the last received packet in dB.

Reimplemented from PhysicalLayer.

◆ getTimeOnAir()

RadioLibTime_t LR11x0::getTimeOnAir ( size_t len )

overridevirtual

Get expected time-on-air for a given size of payload.

Parameters

len	Payload length in bytes.

Returns: Expected time-on-air in microseconds.

Todo:: implement this mess - SX1280 datasheet v3.0 section 7.4.4.2

Reimplemented from PhysicalLayer.

◆ getVersionInfo()

int16_t LR11x0::getVersionInfo ( LR11x0VersionInfo_t * info )

Retrieve LR11x0 hardware, device and firmware version information.

Parameters

info	Pointer to LR11x0VersionInfo_t structure to populate.

Returns: Status Codes

◆ getWifiScanResult()

int16_t LR11x0::getWifiScanResult	(	LR11x0WifiResult_t *	result,
		uint8_t	index,
		bool	brief = `false`
	)

Retrieve passive WiFi scan result.

Parameters

result	Pointer to structure to hold the result data.
index	Result index, starting from 0. The number of scan results can be retrieved by calling getWifiScanResultsCount.
brief	Whether to only retrieve the results in brief format. If set to false, only information in LR11x0WifiResult_t will be retrieved. If set to true, information in LR11x0WifiResultFull_t will be retrieved. In addition, if WiFi scan mode was set to RADIOLIB_LR11X0_WIFI_ACQ_MODE_FULL_BEACON, all information in LR11x0WifiResultExtended_t will be retrieved.

Returns: Status Codes

◆ getWifiScanResultsCount()

int16_t LR11x0::getWifiScanResultsCount ( uint8_t * count )

Get number of WiFi scan results after the scan is finished.

Parameters

count Pointer to a variable that will hold the number of scan results.

Returns: Status Codes

◆ gnssDelayUntilSubframe()

int16_t LR11x0::gnssDelayUntilSubframe	(	LR11x0GnssAlmanacStatus_t *	stat,
		uint8_t	constellation
	)

Blocking wait until the next subframe with almanac data is available. Used to control timing during almanac update from satellite.

Parameters

stat	Pointer to structure containing the almanac status read by getGnssAlmanacStatus. This is not the actual almanac, just a structure providing information about it.
constellation	Constellation to wait for, one of RADIOLIB_LR11X0_GNSS_CONSTELLATION_*. Constellations cannot be updated at the same time, but rather must be updated sequentially!

Returns: Status Codes

◆ gnssScan()

int16_t LR11x0::gnssScan ( LR11x0GnssResult_t * res = NULL )

Performs GNSS scan.

Parameters

res	Pointer to LR11x0GnssPosition_t structure to populate. Will not be saved if set to NULL, defaults to NULL.

Returns: Status Codes

◆ implicitHeader()

int16_t LR11x0::implicitHeader ( size_t len )

Set implicit header mode for future reception/transmission.

Parameters

len	Payload length in bytes.

Returns: Status Codes

◆ invertIQ()

int16_t LR11x0::invertIQ ( bool enable )

overridevirtual

Enable/disable inversion of the I and Q signals.

Parameters

enable QI inversion enabled (true) or disabled (false);

Returns: Status Codes

Reimplemented from PhysicalLayer.

◆ isGnssScanCapable()

int16_t LR11x0::isGnssScanCapable ( )

Method to check whether the device is capable of performing a GNSS scan.

Returns: Status Codes

◆ randomByte()

uint8_t LR11x0::randomByte ( )

overridevirtual

Get one truly random byte from RSSI noise.

Returns: TRNG byte.

Reimplemented from PhysicalLayer.

◆ readData() [1/2]

int16_t PhysicalLayer::readData

Reads data that was received after calling startReceive method.

Parameters

data	Pointer to array to save the received binary data.
len	Number of bytes that will be read. When set to 0, the packet length will be retrieved automatically. When more bytes than received are requested, only the number of bytes requested will be returned.

Returns: Status Codes

◆ readData() [2/2]

int16_t LR11x0::readData	(	uint8_t *	data,
		size_t	len
	)

overridevirtual

Reads data received after calling startReceive method. When the packet length is not known in advance, getPacketLength method must be called BEFORE calling readData!

Parameters

data	Pointer to array to save the received binary data.
len	Number of bytes that will be read. When set to 0, the packet length will be retrieved automatically. When more bytes than received are requested, only the number of bytes requested will be returned.

Returns: Status Codes

Reimplemented from PhysicalLayer.

◆ receive() [1/2]

int16_t PhysicalLayer::receive

Binary receive method. Must be implemented in module class.

Parameters

data	Pointer to array to save the received binary data.
len	Packet length, needed for some modules under special circumstances (e.g. LoRa implicit header mode).

Returns: Status Codes

◆ receive() [2/2]

int16_t LR11x0::receive	(	uint8_t *	data,
		size_t	len
	)

overridevirtual

Blocking binary receive method. Overloads for string-based transmissions are implemented in PhysicalLayer.

Parameters

data	Binary data to be sent.
len	Number of bytes to send.

Returns: Status Codes

Reimplemented from PhysicalLayer.

◆ receiveDirect()

int16_t LR11x0::receiveDirect ( )

overridevirtual

Starts direct mode reception. Only implemented for PhysicalLayer compatibility, as SX126x series does not support direct mode reception. Will always return RADIOLIB_ERR_UNKNOWN.

Returns: Status Codes

Reimplemented from PhysicalLayer.

◆ reset()

int16_t LR11x0::reset ( )

Reset method. Will reset the chip to the default state using RST pin.

Returns: Status Codes

◆ scanChannel() [1/2]

int16_t LR11x0::scanChannel ( )

overridevirtual

Performs scan for LoRa transmission in the current channel. Detects both preamble and payload.

Returns: Status Codes

Reimplemented from PhysicalLayer.

◆ scanChannel() [2/2]

int16_t LR11x0::scanChannel ( const ChannelScanConfig_t & config )

overridevirtual

Performs scan for LoRa transmission in the current channel. Detects both preamble and payload.

Parameters

config CAD configuration structure.

Returns: Status Codes

Reimplemented from PhysicalLayer.

◆ setBandwidth()

int16_t LR11x0::setBandwidth	(	float	bw,
		bool	high = `false`
	)

Sets LoRa bandwidth. Allowed values are 62.5, 125.0, 250.0 and 500.0 kHz. (default, high = false)

Parameters

bw	LoRa bandwidth to be set in kHz.
high	if set to true, allowed bandwidth is 203.125, 406.25 and 812.5 kHz, frequency must be above 1GHz

Returns: Status Codes

◆ setBitRate()

int16_t LR11x0::setBitRate ( float br )

overridevirtual

Sets GFSK bit rate. Allowed values range from 0.6 to 300.0 kbps.

Parameters

br	FSK bit rate to be set in kbps.

Returns: Status Codes

Reimplemented from PhysicalLayer.

◆ setBroadcastAddress()

int16_t LR11x0::setBroadcastAddress ( uint8_t broadAddr )

Sets broadcast address. Calling this method will also enable address filtering for node and broadcast address.

Parameters

broadAddr Node address to be set.

Returns: Status Codes

◆ setCodingRate()

int16_t LR11x0::setCodingRate	(	uint8_t	cr,
		bool	longInterleave = `false`
	)

Sets LoRa coding rate denominator. Allowed values range from 5 to 8.

Parameters

cr	LoRa coding rate denominator to be set.
longInterleave	Enable long interleaver when set to true. Note that CR 4/7 is not possible with long interleaver enabled!

Returns: Status Codes

◆ setCRC()

int16_t LR11x0::setCRC	(	uint8_t	len,
		uint32_t	initial = `0x00001D0FUL`,
		uint32_t	polynomial = `0x00001021UL`,
		bool	inverted = `true`
	)

Sets CRC configuration.

Parameters

len	CRC length in bytes, Allowed values are 1 or 2, set to 0 to disable CRC.
initial	Initial CRC value. GFSK only. Defaults to 0x1D0F (CCIT CRC).
polynomial	Polynomial for CRC calculation. GFSK only. Defaults to 0x1021 (CCIT CRC).
inverted	Invert CRC bytes. GFSK only. Defaults to true (CCIT CRC).

Returns: Status Codes

◆ setDataRate()

int16_t LR11x0::setDataRate ( DataRate_t dr )

overridevirtual

Set data.

Parameters

dr	Data rate struct. Interpretation depends on currently active modem (GFSK or LoRa).

Returns: Status Codes

Reimplemented from PhysicalLayer.

◆ setDataShaping()

int16_t LR11x0::setDataShaping ( uint8_t sh )

overridevirtual

Sets time-bandwidth product of Gaussian filter applied for shaping. Allowed values are RADIOLIB_SHAPING_0_3, RADIOLIB_SHAPING_0_5, RADIOLIB_SHAPING_0_7 or RADIOLIB_SHAPING_1_0. Set to RADIOLIB_SHAPING_NONE to disable data shaping.

Parameters

sh	Time-bandwidth product of Gaussian filter to be set.

Returns: Status Codes

Reimplemented from PhysicalLayer.

◆ setEncoding()

int16_t LR11x0::setEncoding ( uint8_t encoding )

overridevirtual

Sets transmission encoding. Available in GFSK mode only. Serves only as alias for PhysicalLayer compatibility.

Parameters

encoding Encoding to be used. Set to 0 for NRZ, and 2 for whitening.

Returns: Status Codes

Reimplemented from PhysicalLayer.

◆ setFrequencyDeviation()

int16_t LR11x0::setFrequencyDeviation ( float freqDev )

overridevirtual

Sets GFSK frequency deviation. Allowed values range from 0.0 to 200.0 kHz.

Parameters

freqDev GFSK frequency deviation to be set in kHz.

Returns: Status Codes

Reimplemented from PhysicalLayer.

◆ setIrqAction()

void LR11x0::setIrqAction ( void(*)(void) func )

Sets interrupt service routine to call when IRQ1 activates.

Parameters

func	ISR to call.

◆ setIrqFlags()

int16_t LR11x0::setIrqFlags ( uint32_t irq )

overridevirtual

Set interrupt on IRQ pin to be sent on a specific IRQ bit (e.g. RxTimeout, CadDone).

Parameters

irq	Module-specific IRQ flags.

Returns: Status Codes

Reimplemented from PhysicalLayer.

◆ setLrFhssConfig()

int16_t LR11x0::setLrFhssConfig	(	uint8_t	bw,
		uint8_t	cr,
		uint8_t	hdrCount = `3`,
		uint16_t	hopSeed = `0x13A`
	)

Sets LR-FHSS configuration.

Parameters

bw	LR-FHSS bandwidth, one of RADIOLIB_LR11X0_LR_FHSS_BW_* values.
cr	LR-FHSS coding rate, one of RADIOLIB_LR11X0_LR_FHSS_CR_* values.
hdrCount	Header packet count, 1 - 4. Defaults to 3.
hopSeed	9-bit seed number for PRNG generation of the hopping sequence. Defaults to 0x13A.

Returns: Status Codes

◆ setNodeAddress()

int16_t LR11x0::setNodeAddress ( uint8_t nodeAddr )

Sets node address. Calling this method will also enable address filtering for node address only.

Parameters

nodeAddr Node address to be set.

Returns: Status Codes

◆ setPacketReceivedAction()

void LR11x0::setPacketReceivedAction ( void(*)(void) func )

overridevirtual

Sets interrupt service routine to call when a packet is received.

Parameters

func	ISR to call.

Reimplemented from PhysicalLayer.

◆ setPacketSentAction()

void LR11x0::setPacketSentAction ( void(*)(void) func )

overridevirtual

Sets interrupt service routine to call when a packet is sent.

Parameters

func	ISR to call.

Reimplemented from PhysicalLayer.

◆ setPreambleLength()

int16_t LR11x0::setPreambleLength ( size_t preambleLength )

overridevirtual

Sets preamble length for LoRa or GFSK modem. Allowed values range from 1 to 65535.

Parameters

preambleLength Preamble length to be set in symbols (LoRa) or bits (GFSK).

Returns: Status Codes

Reimplemented from PhysicalLayer.

◆ setRegulatorDCDC()

int16_t LR11x0::setRegulatorDCDC ( )

Set regulator mode to DC-DC.

Returns: Status Codes

◆ setRegulatorLDO()

int16_t LR11x0::setRegulatorLDO ( )

Set regulator mode to LDO.

Returns: Status Codes

◆ setRfSwitchTable()

void LR11x0::setRfSwitchTable	(	const uint32_t(&)	pins[Module::RFSWITCH_MAX_PINS],
		const Module::RfSwitchMode_t	table[]
	)

Some modules contain external RF switch controlled by pins. This function gives RadioLib control over those pins to automatically switch between various modes.

Radiolib will automatically set the pin mode and value of these pins, so do not control them from the sketch.

Parameters

pins	A reference to an array of pins to control. This should always be an array of 3 elements. If you need less pins, use RADIOLIB_NC for the unused elements.
table	A reference to an array of pin values to use for each supported mode. Each element is an RfSwitchMode_T struct that lists the mode for which it applies and the values for each of the pins passed in the pins argument respectively.

The pins array will be copied into the Module object, so the original array can be deallocated after this call. However, a reference to the table array will be stored, so that array must remain valid as long RadioLib is being used.

The mode field in each table row should normally use any of the MODE_* constants from the Module::OpMode_t enum. However, some radios support additional modes and will define their own OpMode_t enum.

The length of the table is variable (to support radios that add additional modes), so the table must always be terminated with the special END_OF_MODE_TABLE value.

Normally all modes should be listed in the table, but for some radios, modes can be omitted to indicate they are not supported (e.g. when a radio has a high power and low power TX mode but external circuitry only supports low power). If applicable, this is documented in the radio class itself.

Example

For example, on a board that has an RF switch with an enable pin connected to PA0 and a TX/RX select pin connected to PA1:

// In global scope, define the pin array and mode table
static const uint32_t rfswitch_pins[] =
                       {PA0,  PA1,  RADIOLIB_NC};
static const Module::RfSwitchMode_t rfswitch_table[] = {
  {Module::MODE_IDLE,  {LOW,  LOW}},
  {Module::MODE_RX,    {HIGH, LOW}},
  {Module::MODE_TX,    {HIGH, HIGH}},
   Module::END_OF_MODE_TABLE,
};
 
void setup() {
  ...
  // Then somewhere in setup, pass them to radiolib
  radio.setRfSwitchTable(rfswitch_pins, rfswitch_table);
  ...
}

◆ setRxBandwidth()

int16_t LR11x0::setRxBandwidth ( float rxBw )

Sets GFSK receiver bandwidth. Allowed values are 4.8, 5.8, 7.3, 9.7, 11.7, 14.6, 19.5, 23.4, 29.3, 39.0, 46.9, 58.6, 78.2, 93.8, 117.3, 156.2, 187.2, 234.3, 312.0, 373.6 and 467.0 kHz.

Parameters

rxBw	GFSK receiver bandwidth to be set in kHz.

Returns: Status Codes

◆ setRxBoostedGainMode()

int16_t LR11x0::setRxBoostedGainMode ( bool en )

Enables or disables Rx Boosted Gain mode (additional Rx gain for increased power consumption).

Parameters

en	True for Rx Boosted Gain, false for Rx Power Saving Gain

Returns: Status Codes

◆ setSpreadingFactor()

int16_t LR11x0::setSpreadingFactor	(	uint8_t	sf,
		bool	legacy = `false`
	)

Sets LoRa spreading factor. Allowed values range from 5 to 12.

Parameters

sf	LoRa spreading factor to be set.
legacy	Enable legacy mode for SF6 - this allows to communicate with SX127x at SF6.

Returns: Status Codes

◆ setSyncBits()

int16_t LR11x0::setSyncBits	(	uint8_t *	syncWord,
		uint8_t	bitsLen
	)

Sets GFSK sync word in the form of array of up to 8 bytes.

Parameters

syncWord	GFSK sync word to be set.
bitsLen	GFSK sync word length in bits. If length is not divisible by 8, least significant bits of syncWord will be ignored.

Returns: Status Codes

◆ setSyncWord() [1/2]

int16_t LR11x0::setSyncWord	(	uint8_t *	syncWord,
		size_t	len
	)

overridevirtual

Sets GFSK sync word in the form of array of up to 8 bytes.

Parameters

syncWord	GFSK sync word to be set.
len	GFSK sync word length in bytes.

Returns: Status Codes

Reimplemented from PhysicalLayer.

◆ setSyncWord() [2/2]

int16_t LR11x0::setSyncWord ( uint8_t syncWord )

Sets LoRa sync word.

Parameters

syncWord LoRa sync word to be set.

Returns: Status Codes

◆ setTCXO()

int16_t LR11x0::setTCXO	(	float	voltage,
		uint32_t	delay = `5000`
	)

Sets TCXO (Temperature Compensated Crystal Oscillator) configuration.

Parameters

voltage	TCXO reference voltage in volts. Allowed values are 1.6, 1.7, 1.8, 2.2. 2.4, 2.7, 3.0 and 3.3 V. Set to 0 to disable TCXO. NOTE: After setting this parameter to 0, the module will be reset (since there's no other way to disable TCXO).
delay	TCXO timeout in us. Defaults to 5000 us.

Returns: Status Codes

◆ setWhitening()

int16_t LR11x0::setWhitening	(	bool	enabled,
		uint16_t	initial = `0x01FF`
	)

Sets GFSK whitening parameters.

Parameters

enabled	True = Whitening enabled
initial	Initial value used for the whitening LFSR in GFSK mode. By default set to 0x01FF for compatibility with SX127x and LoRaWAN.

Returns: Status Codes

◆ setWiFiScanAction()

void LR11x0::setWiFiScanAction ( void(*)(void) func )

Sets interrupt service routine to call when a WiFi scan is completed.

Parameters

func	ISR to call.

◆ sleep() [1/2]

int16_t LR11x0::sleep ( )

overridevirtual

Sets the module to sleep mode. To wake the device up, call standby(). Overload with warm start enabled for PhysicalLayer compatibility.

Returns: Status Codes

Reimplemented from PhysicalLayer.

◆ sleep() [2/2]

int16_t LR11x0::sleep	(	bool	retainConfig,
		uint32_t	sleepTime
	)

Sets the module to sleep mode. To wake the device up, call standby().

Parameters

retainConfig	Set to true to retain configuration of the currently active modem ("warm start") or to false to discard current configuration ("cold start"). Defaults to true.
sleepTime	Sleep duration (enables automatic wakeup), in multiples of 30.52 us. Ignored if set to 0.

Returns: Status Codes

◆ standby() [1/2]

int16_t LR11x0::standby ( )

overridevirtual

Sets the module to standby mode (overload for PhysicalLayer compatibility, uses 13 MHz RC oscillator).

Returns: Status Codes

Reimplemented from PhysicalLayer.

◆ standby() [2/2]

int16_t LR11x0::standby	(	uint8_t	mode,
		bool	wakeup = `true`
	)

Sets the module to standby mode.

Parameters

mode	Oscillator to be used in standby mode. Can be set to RADIOLIB_LR11X0_STANDBY_RC (13 MHz RC oscillator) or RADIOLIB_LR11X0_STANDBY_XOSC (32 MHz external crystal oscillator).
wakeup	Whether to force the module to wake up. Setting to true will immediately attempt to wake up the module.

Returns: Status Codes

◆ startChannelScan() [1/2]

int16_t LR11x0::startChannelScan ( )

overridevirtual

Interrupt-driven channel activity detection method. IRQ1 will be activated when LoRa preamble is detected, or upon timeout. Defaults to CAD parameter values recommended by AN1200.48.

Returns: Status Codes

Reimplemented from PhysicalLayer.

◆ startChannelScan() [2/2]

int16_t LR11x0::startChannelScan ( const ChannelScanConfig_t & config )

overridevirtual

Interrupt-driven channel activity detection method. IRQ pin will be activated when LoRa preamble is detected, or upon timeout.

Parameters

config CAD configuration structure.

Returns: Status Codes

Reimplemented from PhysicalLayer.

◆ startReceive() [1/2]

int16_t LR11x0::startReceive ( )

overridevirtual

Interrupt-driven receive method with default parameters. Implemented for compatibility with PhysicalLayer.

Returns: Status Codes

Reimplemented from PhysicalLayer.

◆ startReceive() [2/2]

int16_t LR11x0::startReceive	(	uint32_t	timeout,
		uint32_t	irqFlags = `RADIOLIB_LR11X0_IRQ_RX_DONE`,
		uint32_t	irqMask = `0`,
		size_t	len = `0`
	)

virtual

Interrupt-driven receive method. IRQ1 will be activated when full packet is received.

Parameters

timeout	Raw timeout value, expressed as multiples of 1/32.768 kHz (approximately 30.52 us). Defaults to RADIOLIB_LR11X0_RX_TIMEOUT_INF for infinite timeout (Rx continuous mode), set to RADIOLIB_LR11X0_RX_TIMEOUT_NONE for no timeout (Rx single mode). If timeout other than infinite is set, signal will be generated on IRQ1.
irqFlags	Sets the IRQ flags that will trigger IRQ1, defaults to RADIOLIB_LR11X0_IRQ_RX_DONE.
irqMask	Only for PhysicalLayer compatibility, not used.
len	Only for PhysicalLayer compatibility, not used.

Returns: Status Codes

Reimplemented from PhysicalLayer.

◆ startTransmit() [1/3]

int16_t PhysicalLayer::startTransmit

Interrupt-driven Arduino String transmit method. Unlike the standard transmit method, this one is non-blocking. Interrupt pin will be activated when transmission finishes.

Parameters

str	C-string that will be transmitted.
addr	Node address to transmit the packet to. Only used in FSK mode.

Returns: Status Codes

◆ startTransmit() [2/3]

int16_t PhysicalLayer::startTransmit

Interrupt-driven binary transmit method.

Parameters

data	Binary data that will be transmitted.
len	Length of binary data to transmit (in bytes).
addr	Node address to transmit the packet to. Only used in FSK mode.

Returns: Status Codes

◆ startTransmit() [3/3]

int16_t LR11x0::startTransmit	(	const uint8_t *	data,
		size_t	len,
		uint8_t	addr = `0`
	)

overridevirtual

Interrupt-driven binary transmit method. Overloads for string-based transmissions are implemented in PhysicalLayer.

Parameters

data	Binary data to be sent.
len	Number of bytes to send.
addr	Address to send the data to. Will only be added if address filtering was enabled.

Returns: Status Codes

Reimplemented from PhysicalLayer.

◆ startWifiScan()

int16_t LR11x0::startWifiScan	(	char	wifiType,
		uint8_t	mode = `RADIOLIB_LR11X0_WIFI_ACQ_MODE_FULL_BEACON`,
		uint16_t	chanMask = `RADIOLIB_LR11X0_WIFI_ALL_CHANNELS`,
		uint8_t	numScans = `16`,
		uint16_t	timeout = `100`
	)

Start passive WiFi scan. BUSY pin will be de-activated when the scan is finished.

Parameters

wifiType	Type of WiFi (802.11) signals to scan, 'b', 'n', 'g' or '*' for all signals.
mode	Scan acquisition mode, one of RADIOLIB_LR11X0_WIFI_ACQ_MODE_*. The type of results available after the scan depends on this mode. Defaults to RADIOLIB_LR11X0_WIFI_ACQ_MODE_FULL_BEACON, which provides the most information.
chanMask	Bit mask of WiFi channels to scan, defaults to all channels. More channels leads to longer overall scan duration.
numScans	Number of scans to perform per each enabled channel. Defaults to 16 scans. More scans leads to longer overall scan duration.
timeout	Timeout of each scan in milliseconds. Defaults to 100 ms Longer timeout leads to longer overall scan duration.

Returns: Status Codes

◆ transmit() [1/3]

int16_t PhysicalLayer::transmit

C-string transmit method.

Parameters

str	C-string that will be transmitted.
addr	Node address to transmit the packet to. Only used in FSK mode.

Returns: Status Codes

◆ transmit() [2/3]

int16_t PhysicalLayer::transmit

Binary transmit method. Must be implemented in module class.

Parameters

data	Binary data that will be transmitted.
len	Length of binary data to transmit (in bytes).
addr	Node address to transmit the packet to. Only used in FSK mode.

Returns: Status Codes

◆ transmit() [3/3]

int16_t LR11x0::transmit	(	const uint8_t *	data,
		size_t	len,
		uint8_t	addr = `0`
	)

overridevirtual

Blocking binary transmit method. Overloads for string-based transmissions are implemented in PhysicalLayer.

Parameters

data	Binary data to be sent.
len	Number of bytes to send.
addr	Address to send the data to. Will only be added if address filtering was enabled.

Returns: Status Codes

Reimplemented from PhysicalLayer.

◆ transmitDirect()

int16_t LR11x0::transmitDirect ( uint32_t frf = 0 )

overridevirtual

Starts direct mode transmission.

Parameters

frf	Raw RF frequency value. Defaults to 0, required for quick frequency shifts in RTTY.

Returns: Status Codes

Reimplemented from PhysicalLayer.

◆ updateFirmware()

int16_t LR11x0::updateFirmware	(	const uint32_t *	image,
		size_t	size,
		bool	nonvolatile = `true`
	)

Method to upload new firmware image to the device. The device will be automatically erased, a new firmware will be uploaded, written to flash and executed.

Parameters

image	Pointer to the image to upload.
size	Size of the image in 32-bit words.
nonvolatile	Set to true when the image is saved in non-volatile memory of the host processor, or to false when the patch is in its RAM. Defaults to true.

Returns: Status Codes

◆ updateGnssAlmanac()

int16_t LR11x0::updateGnssAlmanac ( uint8_t constellation )

Perform almanac update. Must be called immediately after gnssDelayUntilSubframe.

Parameters

constellation Constellation to update, one of RADIOLIB_LR11X0_GNSS_CONSTELLATION_*. Constellations cannot be updated at the same time, but rather must be updated sequentially!

Returns: Status Codes

◆ variablePacketLengthMode()

int16_t LR11x0::variablePacketLengthMode ( uint8_t maxLen = RADIOLIB_LR11X0_MAX_PACKET_LENGTH )

Set modem in variable packet length mode. Available in GFSK mode only.

Parameters

maxLen Maximum packet length.

Returns: Status Codes

◆ wifiScan()

int16_t LR11x0::wifiScan	(	uint8_t	wifiType,
		uint8_t *	count,
		uint8_t	mode = `RADIOLIB_LR11X0_WIFI_ACQ_MODE_FULL_BEACON`,
		uint16_t	chanMask = `RADIOLIB_LR11X0_WIFI_ALL_CHANNELS`,
		uint8_t	numScans = `16`,
		uint16_t	timeout = `100`
	)

Blocking WiFi scan method. Performs a full passive WiFi scan. This method may block for several seconds!

Parameters

wifiType	Type of WiFi (802.11) signals to scan, 'b', 'n', 'g' or '*' for all signals.
count	Pointer to a variable that will hold the number of scan results.
mode	Scan acquisition mode, one of RADIOLIB_LR11X0_WIFI_ACQ_MODE_*. The type of results available after the scan depends on this mode. Defaults to RADIOLIB_LR11X0_WIFI_ACQ_MODE_FULL_BEACON, which provides the most information.
chanMask	Bit mask of WiFi channels to scan, defaults to all channels. More channels leads to longer overall scan duration.
numScans	Number of scans to perform per each enabled channel. Defaults to 16 scans. More scans leads to longer overall scan duration.
timeout	Timeout of each scan in milliseconds. Defaults to 100 ms Longer timeout leads to longer overall scan duration.

Returns: Status Codes

The documentation for this class was generated from the following files:

src/modules/LR11x0/LR11x0.h
src/modules/LR11x0/LR11x0.cpp

Public Types

Public Member Functions

Public Attributes

Detailed Description

Member Enumeration Documentation

◆ OpMode_t

Constructor & Destructor Documentation

◆ LR11x0()

Member Function Documentation

◆ autoLDRO()

◆ begin()

◆ beginGFSK()

◆ beginGNSS()

◆ beginLRFHSS()

◆ calculateRxTimeout()

◆ calibrateImageRejection()

◆ checkDataRate()

◆ clearIrqFlags()

◆ disableAddressFiltering()

◆ explicitHeader()

◆ finishTransmit()

◆ fixedPacketLengthMode()

◆ forceLDRO()

◆ getChannelScanResult()

◆ getDataRate()

◆ getFrequencyError()

◆ getGnssAlmanacStatus()

◆ getGnssPosition()

◆ getGnssSatellites()

◆ getIrqFlags()

◆ getIrqStatus()

◆ getModem()

◆ getPacketLength() [1/2]

◆ getPacketLength() [2/2]

◆ getRSSI()

◆ getSNR()

◆ getTimeOnAir()

◆ getVersionInfo()

◆ getWifiScanResult()

◆ getWifiScanResultsCount()

◆ gnssDelayUntilSubframe()

◆ gnssScan()

◆ implicitHeader()

◆ invertIQ()

◆ isGnssScanCapable()

◆ randomByte()

◆ readData() [1/2]

◆ readData() [2/2]

◆ receive() [1/2]

◆ receive() [2/2]

◆ receiveDirect()

◆ reset()

◆ scanChannel() [1/2]

◆ scanChannel() [2/2]

◆ setBandwidth()

◆ setBitRate()

◆ setBroadcastAddress()

◆ setCodingRate()

◆ setCRC()

◆ setDataRate()

◆ setDataShaping()

◆ setEncoding()

◆ setFrequencyDeviation()

◆ setIrqAction()

◆ setIrqFlags()

◆ setLrFhssConfig()

◆ setNodeAddress()

◆ setPacketReceivedAction()

◆ setPacketSentAction()

◆ setPreambleLength()

◆ setRegulatorDCDC()

◆ setRegulatorLDO()

◆ setRfSwitchTable()

Example

◆ setRxBandwidth()

◆ setRxBoostedGainMode()

◆ setSpreadingFactor()

◆ setSyncBits()

◆ setSyncWord() [1/2]

◆ setSyncWord() [2/2]