Brunno Oliveira / pulga-lorawan-drv

Driver for SX1272 connected to Pulga devices using only DIO0 pins and polling (error states and timeout).

Dependents:   pulga-mbed-lorawan-gps mbed-lorawan-pulga mbed-lorawan-pulga-testing-channel mbed-lorawan-pulga-serial_rx ... more

SX126X/SX126X_LoRaRadio.h@5:3da1a3924c65, 2021-03-30 (annotated)

Committer:
brunnobbco
Date:
Tue Mar 30 20:08:17 2021 +0000
Revision:
5:3da1a3924c65
Parent:
0:561d07a737bc 
Forget to change another gpio occurrence.

Who changed what in which revision?

UserRevisionLine numberNew contents of line
brunnobbco 0:561d07a737bc 1 /**
brunnobbco 0:561d07a737bc 2 / _____) _ | |
brunnobbco 0:561d07a737bc 3 ( (____ _____ ____ _| |_ _____ ____| |__
brunnobbco 0:561d07a737bc 4 \____ \| ___ | (_ _) ___ |/ ___) _ \
brunnobbco 0:561d07a737bc 5 _____) ) ____| | | || |_| ____( (___| | | |
brunnobbco 0:561d07a737bc 6 (______/|_____)_|_|_| \__)_____)\____)_| |_|
brunnobbco 0:561d07a737bc 7 (C)2015 Semtech
brunnobbco 0:561d07a737bc 8 ___ _____ _ ___ _ _____ ___ ___ ___ ___
brunnobbco 0:561d07a737bc 9 / __|_ _/_\ / __| |/ / __/ _ \| _ \/ __| __|
brunnobbco 0:561d07a737bc 10 \__ \ | |/ _ \ (__| ' <| _| (_) | / (__| _|
brunnobbco 0:561d07a737bc 11 |___/ |_/_/ \_\___|_|\_\_| \___/|_|_\\___|___|
brunnobbco 0:561d07a737bc 12 embedded.connectivity.solutions===============
brunnobbco 0:561d07a737bc 13
brunnobbco 0:561d07a737bc 14 Description: LoRaWAN stack layer that controls both MAC and PHY underneath
brunnobbco 0:561d07a737bc 15
brunnobbco 0:561d07a737bc 16 License: Revised BSD License, see LICENSE.TXT file include in the project
brunnobbco 0:561d07a737bc 17
brunnobbco 0:561d07a737bc 18 Maintainer: Miguel Luis, Gregory Cristian & Gilbert Menth
brunnobbco 0:561d07a737bc 19
brunnobbco 0:561d07a737bc 20 Copyright (c) 2019, Arm Limited and affiliates.
brunnobbco 0:561d07a737bc 21
brunnobbco 0:561d07a737bc 22 SPDX-License-Identifier: BSD-3-Clause
brunnobbco 0:561d07a737bc 23 */
brunnobbco 0:561d07a737bc 24
brunnobbco 0:561d07a737bc 25 #ifndef MBED_LORA_RADIO_DRV_SX126X_LORARADIO_H_
brunnobbco 0:561d07a737bc 26 #define MBED_LORA_RADIO_DRV_SX126X_LORARADIO_H_
brunnobbco 0:561d07a737bc 27
brunnobbco 0:561d07a737bc 28 #include "mbed_critical.h"
brunnobbco 0:561d07a737bc 29 #include "PinNames.h"
brunnobbco 0:561d07a737bc 30 #include "InterruptIn.h"
brunnobbco 0:561d07a737bc 31 #include "DigitalOut.h"
brunnobbco 0:561d07a737bc 32 #include "DigitalInOut.h"
brunnobbco 0:561d07a737bc 33 #include "DigitalIn.h"
brunnobbco 0:561d07a737bc 34 #include "AnalogIn.h"
brunnobbco 0:561d07a737bc 35 #include "SPI.h"
brunnobbco 0:561d07a737bc 36 #include "platform/PlatformMutex.h"
brunnobbco 0:561d07a737bc 37 #ifdef MBED_CONF_RTOS_PRESENT
brunnobbco 0:561d07a737bc 38 #include "rtos/Thread.h"
brunnobbco 0:561d07a737bc 39 #include "rtos/ThisThread.h"
brunnobbco 0:561d07a737bc 40 #endif
brunnobbco 0:561d07a737bc 41 #include "sx126x_ds.h"
brunnobbco 0:561d07a737bc 42 #include "lorawan/LoRaRadio.h"
brunnobbco 0:561d07a737bc 43
brunnobbco 0:561d07a737bc 44 #ifdef MBED_CONF_SX126X_LORA_DRIVER_BUFFER_SIZE
brunnobbco 0:561d07a737bc 45 #define MAX_DATA_BUFFER_SIZE_SX126X MBED_CONF_SX126X_LORA_DRIVER_BUFFER_SIZE
brunnobbco 0:561d07a737bc 46 #else
brunnobbco 0:561d07a737bc 47 #define MAX_DATA_BUFFER_SIZE_SX126X 255
brunnobbco 0:561d07a737bc 48 #endif
brunnobbco 0:561d07a737bc 49
brunnobbco 0:561d07a737bc 50 class SX126X_LoRaRadio : public LoRaRadio {
brunnobbco 0:561d07a737bc 51
brunnobbco 0:561d07a737bc 52 public:
brunnobbco 0:561d07a737bc 53 SX126X_LoRaRadio(PinName mosi,
brunnobbco 0:561d07a737bc 54 PinName miso,
brunnobbco 0:561d07a737bc 55 PinName sclk,
brunnobbco 0:561d07a737bc 56 PinName nss,
brunnobbco 0:561d07a737bc 57 PinName reset,
brunnobbco 0:561d07a737bc 58 PinName dio1,
brunnobbco 0:561d07a737bc 59 PinName busy,
brunnobbco 0:561d07a737bc 60 PinName freq_select,
brunnobbco 0:561d07a737bc 61 PinName device_select,
brunnobbco 0:561d07a737bc 62 PinName crystal_select,
brunnobbco 0:561d07a737bc 63 PinName ant_switch);
brunnobbco 0:561d07a737bc 64
brunnobbco 0:561d07a737bc 65 virtual ~SX126X_LoRaRadio();
brunnobbco 0:561d07a737bc 66
brunnobbco 0:561d07a737bc 67 /**
brunnobbco 0:561d07a737bc 68 * Registers radio events with the Mbed LoRaWAN stack and
brunnobbco 0:561d07a737bc 69 * undergoes initialization steps if any
brunnobbco 0:561d07a737bc 70 *
brunnobbco 0:561d07a737bc 71 * @param events Structure containing the driver callback functions
brunnobbco 0:561d07a737bc 72 */
brunnobbco 0:561d07a737bc 73 virtual void init_radio(radio_events_t *events);
brunnobbco 0:561d07a737bc 74
brunnobbco 0:561d07a737bc 75 /**
brunnobbco 0:561d07a737bc 76 * Resets the radio module
brunnobbco 0:561d07a737bc 77 */
brunnobbco 0:561d07a737bc 78 virtual void radio_reset();
brunnobbco 0:561d07a737bc 79
brunnobbco 0:561d07a737bc 80 /**
brunnobbco 0:561d07a737bc 81 * Put the RF module in sleep mode
brunnobbco 0:561d07a737bc 82 */
brunnobbco 0:561d07a737bc 83 virtual void sleep(void);
brunnobbco 0:561d07a737bc 84
brunnobbco 0:561d07a737bc 85 /**
brunnobbco 0:561d07a737bc 86 * Sets the radio in standby mode
brunnobbco 0:561d07a737bc 87 */
brunnobbco 0:561d07a737bc 88 virtual void standby(void);
brunnobbco 0:561d07a737bc 89
brunnobbco 0:561d07a737bc 90 /**
brunnobbco 0:561d07a737bc 91 * Sets the reception parameters
brunnobbco 0:561d07a737bc 92 *
brunnobbco 0:561d07a737bc 93 * @param modem Radio modem to be used [0: FSK, 1: LoRa]
brunnobbco 0:561d07a737bc 94 * @param bandwidth Sets the bandwidth
brunnobbco 0:561d07a737bc 95 * FSK : >= 2600 and <= 250000 Hz
brunnobbco 0:561d07a737bc 96 * LoRa: [0: 125 kHz, 1: 250 kHz,
brunnobbco 0:561d07a737bc 97 * 2: 500 kHz, 3: Reserved]
brunnobbco 0:561d07a737bc 98 * @param datarate Sets the Datarate
brunnobbco 0:561d07a737bc 99 * FSK : 600..300000 bits/s
brunnobbco 0:561d07a737bc 100 * LoRa: [6: 64, 7: 128, 8: 256, 9: 512,
brunnobbco 0:561d07a737bc 101 * 10: 1024, 11: 2048, 12: 4096 chips]
brunnobbco 0:561d07a737bc 102 * @param coderate Sets the coding rate ( LoRa only )
brunnobbco 0:561d07a737bc 103 * FSK : N/A ( set to 0 )
brunnobbco 0:561d07a737bc 104 * LoRa: [1: 4/5, 2: 4/6, 3: 4/7, 4: 4/8]
brunnobbco 0:561d07a737bc 105 * @param bandwidth_afc Sets the AFC Bandwidth ( FSK only )
brunnobbco 0:561d07a737bc 106 * FSK : >= 2600 and <= 250000 Hz
brunnobbco 0:561d07a737bc 107 * LoRa: N/A ( set to 0 )
brunnobbco 0:561d07a737bc 108 * @param preamble_len Sets the Preamble length ( LoRa only )
brunnobbco 0:561d07a737bc 109 * FSK : N/A ( set to 0 )
brunnobbco 0:561d07a737bc 110 * LoRa: Length in symbols ( the hardware adds 4 more symbols )
brunnobbco 0:561d07a737bc 111 * @param symb_timeout Sets the RxSingle timeout value
brunnobbco 0:561d07a737bc 112 * FSK : timeout number of bytes
brunnobbco 0:561d07a737bc 113 * LoRa: timeout in symbols
brunnobbco 0:561d07a737bc 114 * @param fixLen Fixed length packets [0: variable, 1: fixed]
brunnobbco 0:561d07a737bc 115 * @param payload_len Sets payload length when fixed lenght is used
brunnobbco 0:561d07a737bc 116 * @param crc_on Enables/Disables the CRC [0: OFF, 1: ON]
brunnobbco 0:561d07a737bc 117 * @param freq_hop_on Enables disables the intra-packet frequency hopping [0: OFF, 1: ON] (LoRa only)
brunnobbco 0:561d07a737bc 118 * @param hop_period Number of symbols bewteen each hop (LoRa only)
brunnobbco 0:561d07a737bc 119 * @param iq_inverted Inverts IQ signals ( LoRa only )
brunnobbco 0:561d07a737bc 120 * FSK : N/A ( set to 0 )
brunnobbco 0:561d07a737bc 121 * LoRa: [0: not inverted, 1: inverted]
brunnobbco 0:561d07a737bc 122 * @param rx_continuous Sets the reception in continuous mode
brunnobbco 0:561d07a737bc 123 * [false: single mode, true: continuous mode]
brunnobbco 0:561d07a737bc 124 */
brunnobbco 0:561d07a737bc 125 virtual void set_rx_config (radio_modems_t modem, uint32_t bandwidth,
brunnobbco 0:561d07a737bc 126 uint32_t datarate, uint8_t coderate,
brunnobbco 0:561d07a737bc 127 uint32_t bandwidth_afc, uint16_t preamble_len,
brunnobbco 0:561d07a737bc 128 uint16_t symb_timeout, bool fix_len,
brunnobbco 0:561d07a737bc 129 uint8_t payload_len,
brunnobbco 0:561d07a737bc 130 bool crc_on, bool freq_hop_on, uint8_t hop_period,
brunnobbco 0:561d07a737bc 131 bool iq_inverted, bool rx_continuous);
brunnobbco 0:561d07a737bc 132
brunnobbco 0:561d07a737bc 133 /**
brunnobbco 0:561d07a737bc 134 * Sets the transmission parameters
brunnobbco 0:561d07a737bc 135 *
brunnobbco 0:561d07a737bc 136 * @param modem Radio modem to be used [0: FSK, 1: LoRa]
brunnobbco 0:561d07a737bc 137 * @param power Sets the output power [dBm]
brunnobbco 0:561d07a737bc 138 * @param fdev Sets the frequency deviation ( FSK only )
brunnobbco 0:561d07a737bc 139 * FSK : [Hz]
brunnobbco 0:561d07a737bc 140 * LoRa: 0
brunnobbco 0:561d07a737bc 141 * @param bandwidth Sets the bandwidth ( LoRa only )
brunnobbco 0:561d07a737bc 142 * FSK : 0
brunnobbco 0:561d07a737bc 143 * LoRa: [0: 125 kHz, 1: 250 kHz,
brunnobbco 0:561d07a737bc 144 * 2: 500 kHz, 3: Reserved]
brunnobbco 0:561d07a737bc 145 * @param datarate Sets the Datarate
brunnobbco 0:561d07a737bc 146 * FSK : 600..300000 bits/s
brunnobbco 0:561d07a737bc 147 * LoRa: [6: 64, 7: 128, 8: 256, 9: 512,
brunnobbco 0:561d07a737bc 148 * 10: 1024, 11: 2048, 12: 4096 chips]
brunnobbco 0:561d07a737bc 149 * @param coderate Sets the coding rate ( LoRa only )
brunnobbco 0:561d07a737bc 150 * FSK : N/A ( set to 0 )
brunnobbco 0:561d07a737bc 151 * LoRa: [1: 4/5, 2: 4/6, 3: 4/7, 4: 4/8]
brunnobbco 0:561d07a737bc 152 * @param preamble_len Sets the preamble length
brunnobbco 0:561d07a737bc 153 * @param fix_len Fixed length packets [0: variable, 1: fixed]
brunnobbco 0:561d07a737bc 154 * @param crc_on Enables disables the CRC [0: OFF, 1: ON]
brunnobbco 0:561d07a737bc 155 * @param freq_hop_on Enables disables the intra-packet frequency hopping [0: OFF, 1: ON] (LoRa only)
brunnobbco 0:561d07a737bc 156 * @param hop_period Number of symbols bewteen each hop (LoRa only)
brunnobbco 0:561d07a737bc 157 * @param iq_inverted Inverts IQ signals ( LoRa only )
brunnobbco 0:561d07a737bc 158 * FSK : N/A ( set to 0 )
brunnobbco 0:561d07a737bc 159 * LoRa: [0: not inverted, 1: inverted]
brunnobbco 0:561d07a737bc 160 * @param timeout Transmission timeout [ms]
brunnobbco 0:561d07a737bc 161 */
brunnobbco 0:561d07a737bc 162 virtual void set_tx_config(radio_modems_t modem, int8_t power, uint32_t fdev,
brunnobbco 0:561d07a737bc 163 uint32_t bandwidth, uint32_t datarate,
brunnobbco 0:561d07a737bc 164 uint8_t coderate, uint16_t preamble_len,
brunnobbco 0:561d07a737bc 165 bool fix_len, bool crc_on, bool freq_hop_on,
brunnobbco 0:561d07a737bc 166 uint8_t hop_period, bool iq_inverted, uint32_t timeout);
brunnobbco 0:561d07a737bc 167
brunnobbco 0:561d07a737bc 168 /**
brunnobbco 0:561d07a737bc 169 * Sends the buffer of size
brunnobbco 0:561d07a737bc 170 *
brunnobbco 0:561d07a737bc 171 * Prepares the packet to be sent and sets the radio in transmission
brunnobbco 0:561d07a737bc 172 *
brunnobbco 0:561d07a737bc 173 * @param buffer Buffer pointer
brunnobbco 0:561d07a737bc 174 * @param size Buffer size
brunnobbco 0:561d07a737bc 175 */
brunnobbco 0:561d07a737bc 176 virtual void send(uint8_t *buffer, uint8_t size);
brunnobbco 0:561d07a737bc 177
brunnobbco 0:561d07a737bc 178 /**
brunnobbco 0:561d07a737bc 179 * Sets the radio to receive
brunnobbco 0:561d07a737bc 180 *
brunnobbco 0:561d07a737bc 181 * All necessary configuration options for reception are set in
brunnobbco 0:561d07a737bc 182 * 'set_rx_config(parameters)' API.
brunnobbco 0:561d07a737bc 183 */
brunnobbco 0:561d07a737bc 184 virtual void receive(void);
brunnobbco 0:561d07a737bc 185
brunnobbco 0:561d07a737bc 186 /**
brunnobbco 0:561d07a737bc 187 * Sets the carrier frequency
brunnobbco 0:561d07a737bc 188 *
brunnobbco 0:561d07a737bc 189 * @param freq Channel RF frequency
brunnobbco 0:561d07a737bc 190 */
brunnobbco 0:561d07a737bc 191 virtual void set_channel(uint32_t freq);
brunnobbco 0:561d07a737bc 192
brunnobbco 0:561d07a737bc 193 /**
brunnobbco 0:561d07a737bc 194 * Generates a 32 bits random value based on the RSSI readings
brunnobbco 0:561d07a737bc 195 *
brunnobbco 0:561d07a737bc 196 * Remark this function sets the radio in LoRa modem mode and disables
brunnobbco 0:561d07a737bc 197 * all interrupts.
brunnobbco 0:561d07a737bc 198 * After calling this function either Radio.SetRxConfig or
brunnobbco 0:561d07a737bc 199 * Radio.SetTxConfig functions must be called.
brunnobbco 0:561d07a737bc 200 *
brunnobbco 0:561d07a737bc 201 * @return 32 bits random value
brunnobbco 0:561d07a737bc 202 */
brunnobbco 0:561d07a737bc 203 virtual uint32_t random(void);
brunnobbco 0:561d07a737bc 204
brunnobbco 0:561d07a737bc 205 /**
brunnobbco 0:561d07a737bc 206 * Get radio status
brunnobbco 0:561d07a737bc 207 *
brunnobbco 0:561d07a737bc 208 * @param status Radio status [RF_IDLE, RF_RX_RUNNING, RF_TX_RUNNING]
brunnobbco 0:561d07a737bc 209 * @return Return current radio status
brunnobbco 0:561d07a737bc 210 */
brunnobbco 0:561d07a737bc 211 virtual uint8_t get_status(void);
brunnobbco 0:561d07a737bc 212
brunnobbco 0:561d07a737bc 213 /**
brunnobbco 0:561d07a737bc 214 * Sets the maximum payload length
brunnobbco 0:561d07a737bc 215 *
brunnobbco 0:561d07a737bc 216 * @param modem Radio modem to be used [0: FSK, 1: LoRa]
brunnobbco 0:561d07a737bc 217 * @param max Maximum payload length in bytes
brunnobbco 0:561d07a737bc 218 */
brunnobbco 0:561d07a737bc 219 virtual void set_max_payload_length(radio_modems_t modem, uint8_t max);
brunnobbco 0:561d07a737bc 220
brunnobbco 0:561d07a737bc 221 /**
brunnobbco 0:561d07a737bc 222 * Sets the network to public or private
brunnobbco 0:561d07a737bc 223 *
brunnobbco 0:561d07a737bc 224 * Updates the sync byte. Applies to LoRa modem only
brunnobbco 0:561d07a737bc 225 *
brunnobbco 0:561d07a737bc 226 * @param enable if true, it enables a public network
brunnobbco 0:561d07a737bc 227 */
brunnobbco 0:561d07a737bc 228 virtual void set_public_network(bool enable);
brunnobbco 0:561d07a737bc 229
brunnobbco 0:561d07a737bc 230 /**
brunnobbco 0:561d07a737bc 231 * Computes the packet time on air for the given payload
brunnobbco 0:561d07a737bc 232 *
brunnobbco 0:561d07a737bc 233 * Remark can only be called once SetRxConfig or SetTxConfig have been called
brunnobbco 0:561d07a737bc 234 *
brunnobbco 0:561d07a737bc 235 * @param modem Radio modem to be used [0: FSK, 1: LoRa]
brunnobbco 0:561d07a737bc 236 * @param pkt_len Packet payload length
brunnobbco 0:561d07a737bc 237 * @return Computed airTime for the given packet payload length
brunnobbco 0:561d07a737bc 238 */
brunnobbco 0:561d07a737bc 239 virtual uint32_t time_on_air(radio_modems_t modem, uint8_t pkt_len);
brunnobbco 0:561d07a737bc 240
brunnobbco 0:561d07a737bc 241 /**
brunnobbco 0:561d07a737bc 242 * Perform carrier sensing
brunnobbco 0:561d07a737bc 243 *
brunnobbco 0:561d07a737bc 244 * Checks for a certain time if the RSSI is above a given threshold.
brunnobbco 0:561d07a737bc 245 * This threshold determines if there is already a transmission going on
brunnobbco 0:561d07a737bc 246 * in the channel or not.
brunnobbco 0:561d07a737bc 247 *
brunnobbco 0:561d07a737bc 248 * @param modem Type of the radio modem
brunnobbco 0:561d07a737bc 249 * @param freq Carrier frequency
brunnobbco 0:561d07a737bc 250 * @param rssi_threshold Threshold value of RSSI
brunnobbco 0:561d07a737bc 251 * @param max_carrier_sense_time time to sense the channel
brunnobbco 0:561d07a737bc 252 *
brunnobbco 0:561d07a737bc 253 * @return true if there is no active transmission
brunnobbco 0:561d07a737bc 254 * in the channel, false otherwise
brunnobbco 0:561d07a737bc 255 */
brunnobbco 0:561d07a737bc 256 virtual bool perform_carrier_sense(radio_modems_t modem,
brunnobbco 0:561d07a737bc 257 uint32_t freq,
brunnobbco 0:561d07a737bc 258 int16_t rssi_threshold,
brunnobbco 0:561d07a737bc 259 uint32_t max_carrier_sense_time);
brunnobbco 0:561d07a737bc 260
brunnobbco 0:561d07a737bc 261 /**
brunnobbco 0:561d07a737bc 262 * Sets the radio in CAD mode
brunnobbco 0:561d07a737bc 263 *
brunnobbco 0:561d07a737bc 264 */
brunnobbco 0:561d07a737bc 265 virtual void start_cad(void);
brunnobbco 0:561d07a737bc 266
brunnobbco 0:561d07a737bc 267 /**
brunnobbco 0:561d07a737bc 268 * Check if the given RF is in range
brunnobbco 0:561d07a737bc 269 *
brunnobbco 0:561d07a737bc 270 * @param frequency frequency needed to be checked
brunnobbco 0:561d07a737bc 271 */
brunnobbco 0:561d07a737bc 272 virtual bool check_rf_frequency(uint32_t frequency);
brunnobbco 0:561d07a737bc 273
brunnobbco 0:561d07a737bc 274 /** Sets the radio in continuous wave transmission mode
brunnobbco 0:561d07a737bc 275 *
brunnobbco 0:561d07a737bc 276 * @param freq Channel RF frequency
brunnobbco 0:561d07a737bc 277 * @param power Sets the output power [dBm]
brunnobbco 0:561d07a737bc 278 * @param time Transmission mode timeout [s]
brunnobbco 0:561d07a737bc 279 */
brunnobbco 0:561d07a737bc 280 virtual void set_tx_continuous_wave(uint32_t freq, int8_t power, uint16_t time);
brunnobbco 0:561d07a737bc 281
brunnobbco 0:561d07a737bc 282 /**
brunnobbco 0:561d07a737bc 283 * Acquire exclusive access
brunnobbco 0:561d07a737bc 284 */
brunnobbco 0:561d07a737bc 285 virtual void lock(void);
brunnobbco 0:561d07a737bc 286
brunnobbco 0:561d07a737bc 287 /**
brunnobbco 0:561d07a737bc 288 * Release exclusive access
brunnobbco 0:561d07a737bc 289 */
brunnobbco 0:561d07a737bc 290 virtual void unlock(void);
brunnobbco 0:561d07a737bc 291
brunnobbco 0:561d07a737bc 292 private:
brunnobbco 0:561d07a737bc 293
brunnobbco 0:561d07a737bc 294 // SPI and chip select control
brunnobbco 0:561d07a737bc 295 mbed::SPI _spi;
brunnobbco 0:561d07a737bc 296 mbed::DigitalOut _chip_select;
brunnobbco 0:561d07a737bc 297
brunnobbco 0:561d07a737bc 298 // module rest control
brunnobbco 0:561d07a737bc 299 mbed::DigitalInOut _reset_ctl;
brunnobbco 0:561d07a737bc 300
brunnobbco 0:561d07a737bc 301 // Interrupt controls
brunnobbco 0:561d07a737bc 302 mbed::InterruptIn _dio1_ctl;;
brunnobbco 0:561d07a737bc 303
brunnobbco 0:561d07a737bc 304 // module busy control
brunnobbco 0:561d07a737bc 305 mbed::DigitalIn _busy;
brunnobbco 0:561d07a737bc 306
brunnobbco 0:561d07a737bc 307 // module frequency selection
brunnobbco 0:561d07a737bc 308 mbed::AnalogIn _freq_select;
brunnobbco 0:561d07a737bc 309
brunnobbco 0:561d07a737bc 310 // module device variant selection
brunnobbco 0:561d07a737bc 311 mbed::AnalogIn _dev_select;
brunnobbco 0:561d07a737bc 312
brunnobbco 0:561d07a737bc 313 // module TCXO/XTAL control
brunnobbco 0:561d07a737bc 314 mbed::DigitalIn _crystal_select;
brunnobbco 0:561d07a737bc 315
brunnobbco 0:561d07a737bc 316 // Radio specific controls (TX/RX duplexer switch control)
brunnobbco 0:561d07a737bc 317 mbed::DigitalInOut _ant_switch;
brunnobbco 0:561d07a737bc 318
brunnobbco 0:561d07a737bc 319 // Structure containing function pointers to the stack callbacks
brunnobbco 0:561d07a737bc 320 radio_events_t *_radio_events;
brunnobbco 0:561d07a737bc 321
brunnobbco 0:561d07a737bc 322 // Data buffer used for both TX and RX
brunnobbco 0:561d07a737bc 323 // Size of this buffer is configurable via Mbed config system
brunnobbco 0:561d07a737bc 324 // Default is 255 bytes
brunnobbco 0:561d07a737bc 325 uint8_t _data_buffer[MAX_DATA_BUFFER_SIZE_SX126X];
brunnobbco 0:561d07a737bc 326
brunnobbco 0:561d07a737bc 327 #ifdef MBED_CONF_RTOS_PRESENT
brunnobbco 0:561d07a737bc 328 // Thread to handle interrupts
brunnobbco 0:561d07a737bc 329 rtos::Thread irq_thread;
brunnobbco 0:561d07a737bc 330 #endif
brunnobbco 0:561d07a737bc 331
brunnobbco 0:561d07a737bc 332 // Access protection
brunnobbco 0:561d07a737bc 333 PlatformMutex mutex;
brunnobbco 0:561d07a737bc 334
brunnobbco 0:561d07a737bc 335 // helper functions
brunnobbco 0:561d07a737bc 336 void wakeup();
brunnobbco 0:561d07a737bc 337 void read_opmode_command(uint8_t cmd, uint8_t *buffer, uint16_t size);
brunnobbco 0:561d07a737bc 338 void write_opmode_command(uint8_t cmd, uint8_t *buffer, uint16_t size);
brunnobbco 0:561d07a737bc 339 void set_dio2_as_rfswitch_ctrl(uint8_t enable);
brunnobbco 0:561d07a737bc 340 void set_dio3_as_tcxo_ctrl(radio_TCXO_ctrl_voltage_t voltage, uint32_t timeout);
brunnobbco 0:561d07a737bc 341 uint8_t get_device_variant(void);
brunnobbco 0:561d07a737bc 342 void set_device_ready(void);
brunnobbco 0:561d07a737bc 343 int8_t get_rssi();
brunnobbco 0:561d07a737bc 344 uint8_t get_fsk_bw_reg_val(uint32_t bandwidth);
brunnobbco 0:561d07a737bc 345 void write_to_register(uint16_t addr, uint8_t data);
brunnobbco 0:561d07a737bc 346 void write_to_register(uint16_t addr, uint8_t *data, uint8_t size);
brunnobbco 0:561d07a737bc 347 uint8_t read_register(uint16_t addr);
brunnobbco 0:561d07a737bc 348 void read_register(uint16_t addr, uint8_t *buffer, uint8_t size);
brunnobbco 0:561d07a737bc 349 void write_fifo(uint8_t *buffer, uint8_t size);
brunnobbco 0:561d07a737bc 350 void read_fifo(uint8_t *buffer, uint8_t size, uint8_t offset);
brunnobbco 0:561d07a737bc 351 void rf_irq_task(void);
brunnobbco 0:561d07a737bc 352 void set_modem(uint8_t modem);
brunnobbco 0:561d07a737bc 353 uint8_t get_modem();
brunnobbco 0:561d07a737bc 354 uint16_t get_irq_status(void);
brunnobbco 0:561d07a737bc 355 uint8_t get_frequency_support(void);
brunnobbco 0:561d07a737bc 356
brunnobbco 0:561d07a737bc 357 // ISR
brunnobbco 0:561d07a737bc 358 void dio1_irq_isr();
brunnobbco 0:561d07a737bc 359
brunnobbco 0:561d07a737bc 360 // Handler called by thread in response to signal
brunnobbco 0:561d07a737bc 361 void handle_dio1_irq();
brunnobbco 0:561d07a737bc 362
brunnobbco 0:561d07a737bc 363 void set_modulation_params(modulation_params_t *modulationParams);
brunnobbco 0:561d07a737bc 364 void set_packet_params(packet_params_t *packet_params);
brunnobbco 0:561d07a737bc 365 void set_cad_params(lora_cad_symbols_t nb_symbols, uint8_t det_peak,
brunnobbco 0:561d07a737bc 366 uint8_t det_min, cad_exit_modes_t exit_mode,
brunnobbco 0:561d07a737bc 367 uint32_t timeout);
brunnobbco 0:561d07a737bc 368 void set_buffer_base_addr(uint8_t tx_base_addr, uint8_t rx_base_addr);
brunnobbco 0:561d07a737bc 369 void get_rx_buffer_status(uint8_t *payload_len, uint8_t *rx_buffer_ptr);
brunnobbco 0:561d07a737bc 370 void get_packet_status(packet_status_t *pkt_status);
brunnobbco 0:561d07a737bc 371 radio_error_t get_device_errors(void);
brunnobbco 0:561d07a737bc 372 void clear_device_errors(void);
brunnobbco 0:561d07a737bc 373 void clear_irq_status(uint16_t irq);
brunnobbco 0:561d07a737bc 374 void set_crc_seed(uint16_t seed);
brunnobbco 0:561d07a737bc 375 void set_crc_polynomial(uint16_t polynomial);
brunnobbco 0:561d07a737bc 376 void set_whitening_seed(uint16_t seed);
brunnobbco 0:561d07a737bc 377 void set_pa_config( uint8_t pa_DC, uint8_t hp_max, uint8_t device_type,
brunnobbco 0:561d07a737bc 378 uint8_t pa_LUT );
brunnobbco 0:561d07a737bc 379 void set_tx_power(int8_t power);
brunnobbco 0:561d07a737bc 380 void calibrate_image(uint32_t freq);
brunnobbco 0:561d07a737bc 381 void configure_dio_irq(uint16_t irq_mask, uint16_t dio1_mask,
brunnobbco 0:561d07a737bc 382 uint16_t dio2_mask, uint16_t dio3_mask);
brunnobbco 0:561d07a737bc 383 void cold_start_wakeup();
brunnobbco 0:561d07a737bc 384
brunnobbco 0:561d07a737bc 385 private:
brunnobbco 0:561d07a737bc 386 uint8_t _active_modem;
brunnobbco 0:561d07a737bc 387 uint8_t _standby_mode;
brunnobbco 0:561d07a737bc 388 uint8_t _operation_mode;
brunnobbco 0:561d07a737bc 389 uint8_t _reception_mode;
brunnobbco 0:561d07a737bc 390 uint32_t _tx_timeout;
brunnobbco 0:561d07a737bc 391 uint32_t _rx_timeout;
brunnobbco 0:561d07a737bc 392 uint8_t _rx_timeout_in_symbols;
brunnobbco 0:561d07a737bc 393 int8_t _tx_power;
brunnobbco 0:561d07a737bc 394 bool _image_calibrated;
brunnobbco 0:561d07a737bc 395 bool _force_image_calibration;
brunnobbco 0:561d07a737bc 396 bool _network_mode_public;
brunnobbco 0:561d07a737bc 397
brunnobbco 0:561d07a737bc 398 // Structure containing all user and network specified settings
brunnobbco 0:561d07a737bc 399 // for radio module
brunnobbco 0:561d07a737bc 400 modulation_params_t _mod_params;
brunnobbco 0:561d07a737bc 401 packet_params_t _packet_params;
brunnobbco 0:561d07a737bc 402 };
brunnobbco 0:561d07a737bc 403
brunnobbco 0:561d07a737bc 404 #endif /* MBED_LORA_RADIO_DRV_SX126X_LORARADIO_H_ */