LoRaRadio Class Reference

Checks whether the given RF is in range.

Parameters:

frequency

The frequency to be checked.

Gets the radio status.

Returns:

The current radio status.

Registers radio events with the Mbed LoRaWAN stack and undergoes the initialization steps if any.

Parameters:

events

The structure containing the driver callback functions.

Acquires exclusive access to this radio.

Performs carrier sensing.

Checks for a certain time if the RSSI is above a given threshold. This threshold determines whether or not there is a transmission going on in the channel already.

Parameters:

modem	The type of the radio modem.
freq	The carrier frequency.
rssi_threshold	The threshold value of RSSI.
max_carrier_sense_time	The time set for sensing the channel (ms).

Returns:

True if there is no active transmission in the channel, otherwise false.

Resets the radio module.

Generates a 32 bit random value based on the RSSI readings.

Remarks:

This function sets the radio in LoRa modem mode and disables all interrupts. After calling this function, either `Radio.SetRxConfig` or `Radio.SetTxConfig` functions must be called.

Returns:

A 32 bit random value.

Sets the radio in reception mode for a given time.

If the timeout is set to 0, it essentially puts the receiver in continuous mode and it should be treated as if in continuous mode. However, an appropriate way to set the receiver in continuous mode is to use the `set_rx_config()` API.

Parameters:

timeout

Reception timeout [ms].

Sends the buffer of size.

Prepares the packet to be sent and sets the radio in transmission.

Parameters:

buffer	A pointer to the buffer.
size	The buffer size.

Sets the carrier frequency.

Parameters:

freq	Channel RF frequency.

Sets the maximum payload length.

Parameters:

modem	The radio modem to be used [0: FSK, 1: LoRa].
max	The maximum payload length in bytes.

Sets the network to public or private.

Updates the sync byte. Applies to LoRa modem only.

Parameters:

enable

If true, it enables a public network.

Sets the reception parameters.

Parameters:

modem	The radio modem to be used [0: FSK, 1: LoRa].
bandwidth	Sets the bandwidth. FSK : >= 2600 and <= 250000 Hz LoRa: [0: 125 kHz, 1: 250 kHz, 2: 500 kHz, 3: Reserved]
datarate	Sets the datarate. FSK : 600..300000 bits/s LoRa: [6: 64, 7: 128, 8: 256, 9: 512, 10: 1024, 11: 2048, 12: 4096 chips]
coderate	Sets the coding rate (LoRa only). FSK : N/A ( set to 0 ) LoRa: [1: 4/5, 2: 4/6, 3: 4/7, 4: 4/8]
bandwidth_afc	Sets the AFC bandwidth (FSK only). FSK : >= 2600 and <= 250000 Hz LoRa: N/A (set to 0)
preamble_len	Sets the preamble length (LoRa only). FSK : N/A (set to 0) LoRa: Length in symbols (the hardware adds four more symbols).
symb_timeout	Sets the RxSingle timeout value. FSK : Timeout number of bytes LoRa: Timeout in symbols
fix_len	Fixed length packets [0: variable, 1: fixed].
payload_len	Sets the payload length when fixed length is used.
crc_on	Enables/disables the CRC [0: OFF, 1: ON].
freq_hop_on	Enables/disables the intra-packet frequency hopping [0: OFF, 1: ON] (LoRa only).
hop_period	The number of symbols bewteen each hop (LoRa only).
iq_inverted	Inverts the IQ signals (LoRa only). FSK : N/A (set to 0) LoRa: [0: not inverted, 1: inverted]
rx_continuous	Sets the reception in continuous mode. [false: single mode, true: continuous mode]

Sets the transmission parameters.

Parameters:

modem	The radio modem to be used [0: FSK, 1: LoRa].
power	Sets the output power [dBm].
fdev	Sets the frequency deviation (FSK only). FSK : [Hz] LoRa: 0
bandwidth	Sets the bandwidth (LoRa only). FSK : 0 LoRa: [0: 125 kHz, 1: 250 kHz, 2: 500 kHz, 3: Reserved]
datarate	Sets the datarate. FSK : 600..300000 bits/s LoRa: [6: 64, 7: 128, 8: 256, 9: 512, 10: 1024, 11: 2048, 12: 4096 chips]
coderate	Sets the coding rate (LoRa only). FSK : N/A ( set to 0 ) LoRa: [1: 4/5, 2: 4/6, 3: 4/7, 4: 4/8]
preamble_len	Sets the preamble length.
fix_len	Fixed length packets [0: variable, 1: fixed].
crc_on	Enables/disables the CRC [0: OFF, 1: ON].
freq_hop_on	Enables/disables the intra-packet frequency hopping [0: OFF, 1: ON] (LoRa only).
hop_period	The number of symbols between each hop (LoRa only).
iq_inverted	Inverts IQ signals (LoRa only) FSK : N/A (set to 0). LoRa: [0: not inverted, 1: inverted]
timeout	The transmission timeout [us].

Sets the radio in continuous wave transmission mode.

Parameters:

freq	The RF frequency of the channel.
power	The output power [dBm].
time	The transmission mode timeout [s].

Put the RF module in the sleep mode.

Sets the radio in the standby mode.

Sets the radio in CAD mode.

Computes the packet time on air for the given payload.

Remarks:

This can only be called once `SetRxConfig` or `SetTxConfig` have been called.

Parameters:

modem	The radio modem to be used [0: FSK, 1: LoRa].
pkt_len	The packet payload length.

Returns:

The computed `airTime` for the given packet payload length.

Releases the exclusive access to this radio.