lriot 2.1.0.0
|
Radio driver types for LR1110. More...
#include <stdbool.h>
#include <stdint.h>
Go to the source code of this file.
Data Structures | |
struct | lr1110_radio_cad_params_s |
Channel Activity Detection parameters. More... | |
struct | lr1110_radio_pkt_status_gfsk_s |
Status of GFSK received packet. More... | |
struct | lr1110_radio_pkt_status_lora_s |
Status of received packet. More... | |
struct | lr1110_radio_rx_buffer_status_s |
Length and offset of received packet. More... | |
struct | lr1110_radio_stats_gfsk_s |
GFSK packet statistic structure. More... | |
struct | lr1110_radio_stats_lora_s |
LoRa packet statistic structure. More... | |
struct | lr1110_radio_mod_params_gfsk_s |
Modulation configuration for GFSK packet. More... | |
struct | lr1110_radio_mod_params_lora_s |
Modulation configuration for LoRa packet. More... | |
struct | lr1110_radio_pkt_params_gfsk_s |
Packet parameter configuration for GFSK packets. More... | |
struct | lr1110_radio_pkt_params_lora_s |
Packet parameter configuration for LoRa packets. More... | |
struct | lr1110_radio_pa_cfg_s |
Configuration of Power Amplifier. More... | |
Radio driver types for LR1110.
The Clear BSD License Copyright Semtech Corporation 2021. All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted (subject to the limitations in the disclaimer below) provided that the following conditions are met:
NO EXPRESS OR IMPLIED LICENSES TO ANY PARTY'S PATENT RIGHTS ARE GRANTED BY THIS LICENSE. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SEMTECH CORPORATION BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
typedef struct lr1110_radio_cad_params_s lr1110_radio_cad_params_t |
Channel Activity Detection parameters.
Parameters detPeak and detMin are to be used for tuning the sensitivity of Channel Activity Detection. It depends on Spreading Factor, Bandwidth and symbolNum.
For detPeak, the 5 MSBits are encoding the integer part, the 3 LSBits are encoding 1/8 of the decimal part. For instance, (= 0x32) leads to a ratio being .
detMin is unit free and represents the ratio between the minimal power of a correlation peak and measurement gain that can be considered as a peak detection. It helps to avoid detection on noise. Authorized values a from 0 to 181.
typedef struct lr1110_radio_mod_params_gfsk_s lr1110_radio_mod_params_gfsk_t |
Modulation configuration for GFSK packet.
typedef struct lr1110_radio_mod_params_lora_s lr1110_radio_mod_params_lora_t |
Modulation configuration for LoRa packet.
typedef struct lr1110_radio_pa_cfg_s lr1110_radio_pa_cfg_t |
Configuration of Power Amplifier.
pa_duty_cycle controls the duty cycle of Power Amplifier according to: It can be used to adapt the TX multi-band operation using a single-matching network.
The allowed duty cycle values for LPA are from 0.2 to 0.48 (by step of 0.04). Therefore possible values for pa_duty_cycle go from 0 to 7.
The allowed duty cycle values for HPA go from 0.2 to 0.36 (by step of 0.04). Therefore in this case, the possible values for pa_duty_cycle go from 0 to 4.
pa_hp_sel controls the number of slices for HPA according to:
typedef struct lr1110_radio_pkt_params_gfsk_s lr1110_radio_pkt_params_gfsk_t |
Packet parameter configuration for GFSK packets.
typedef struct lr1110_radio_pkt_params_lora_s lr1110_radio_pkt_params_lora_t |
Packet parameter configuration for LoRa packets.
typedef struct lr1110_radio_pkt_status_gfsk_s lr1110_radio_pkt_status_gfsk_t |
Status of GFSK received packet.
typedef struct lr1110_radio_pkt_status_lora_s lr1110_radio_pkt_status_lora_t |
Status of received packet.
typedef struct lr1110_radio_rx_buffer_status_s lr1110_radio_rx_buffer_status_t |
Length and offset of received packet.
typedef struct lr1110_radio_stats_gfsk_s lr1110_radio_stats_gfsk_t |
GFSK packet statistic structure.
typedef struct lr1110_radio_stats_lora_s lr1110_radio_stats_lora_t |
LoRa packet statistic structure.
Possible automatic actions when Channel Activity Detection operations terminate.
For RADIO_EXIT_MODE_CAD_RX, LR1110 enters RX mode on activity detected. The timeout value for this RX operation is defined as:
With defined in RadioCadParams_t::timeout
If the CAD operation is negative with RADIO_CAD_EXIT_MODE_RX or if CAD operation is positive with RADIO_CAD_EXIT_MODE_TX, therefore the LR1110 enters Standby RC mode.
GFSK Address Filtering configurations.
If Address Filtering is enabled but a wrong address is received, therefore the reception is aborted and the address error flag of packet status is set.
GFSK Bandwidth configurations.
GFSK Cyclic Redundancy Check configurations.
If this value is set to something other than CRC_OFF, a CRC is automatically computed and added after the end of the payload on transmitter side. On receiver side, the CRC check is automatically processed.
Enumerator | |
---|---|
LR1110_RADIO_GFSK_CRC_OFF | CRC check deactivated. |
LR1110_RADIO_GFSK_CRC_1_BYTE | |
LR1110_RADIO_GFSK_CRC_2_BYTES | |
LR1110_RADIO_GFSK_CRC_1_BYTE_INV | |
LR1110_RADIO_GFSK_CRC_2_BYTES_INV |
GFSK Header Type configurations.
This parameter indicates whether or not the payload length is sent and read over the air.
If the payload length is known beforehand by both transmitter and receiver, therefore there is no need to send it over the air. Otherwise, setting this parameter to LR1110_RADIO_GFSK_PKT_VAR_LEN will make the modem to automatically prepand a byte containing the payload length to the the payload on transmitter side. On receiver side, this first byte is read to set the payload length to read.
This configuration is only available for GFSK packet types.
Enumerator | |
---|---|
LR1110_RADIO_GFSK_PKT_FIX_LEN | Payload length is not sent/read over the air. |
LR1110_RADIO_GFSK_PKT_VAR_LEN | Payload length is sent/read over the air. |
GFSK Preamble Detector Length configurations.
This parameter sets the minimum length of preamble bits to be received to continue reception of incoming packet. If a packet with preamble length lower than this value is being received, the reception stops without generating IRQ.
This parameter has no impact on TX operations.
Pulse shape configurations.
LoRa Bandwidth configurations.
LoRa Coding Rate configurations.
LoRa Spreading Factor configurations.
Ramping time for PA.
This parameter is the ramping time of the PA. A high value improves spectral quality.