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?
User | Revision | Line number | New 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_ */ |