Ignacio Carballeda / libxDot-mbed5-less

libxdot LESS version

SxRadio.h@15:e098cf00f502, 2019-05-03 (annotated)

Committer:
icarballeda
Date:
Fri May 03 21:37:43 2019 +0000
Revision:
15:e098cf00f502
Parent:
11:be2a6466d680 
CO2 is equal to -99 when it fails.; AppEUI, AppKEY & Radio Confs edited to work with Cisco Gateways (Multitech Compatible); Smartium: Added New message, alert string as in CDFS protocol.; Fixed: Accel & ux for errors

Who changed what in which revision?

UserRevisionLine numberNew contents of line
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 1 /*
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 2 / _____) _ | |
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 3 ( (____ _____ ____ _| |_ _____ ____| |__
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 4 \____ \| ___ | (_ _) ___ |/ ___) _ \
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 5 _____) ) ____| | | || |_| ____( (___| | | |
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 6 (______/|_____)_|_|_| \__)_____)\____)_| |_|
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 7 (C)2013 Semtech
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 8
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 9 Description: Generic radio driver definition
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 10
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 11 License: Revised BSD License, see LICENSE.TXT file include in the project
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 12
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 13 Maintainer: Miguel Luis and Gregory Cristian
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 14 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 15 #ifndef __SXRADIO_H__
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 16 #define __SXRADIO_H__
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 17
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 18 #include <stdint.h>
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 19 #include "rtos.h"
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 20 #include "SxRadioEvents.h"
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 21
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 22 /*!
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 23 * \brief Radio driver definition
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 24 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 25 class SxRadio
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 26 {
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 27 public:
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 28 /*!
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 29 * Radio driver supported modems
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 30 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 31 typedef enum
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 32 {
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 33 MODEM_FSK = 0,
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 34 MODEM_LORA,
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 35 }RadioModems_t;
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 36
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 37 /*!
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 38 * Radio driver internal state machine states definition
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 39 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 40 typedef enum
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 41 {
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 42 RF_IDLE = 0,
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 43 RF_RX_RUNNING,
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 44 RF_TX_RUNNING,
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 45 RF_CAD,
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 46 }RadioState_t;
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 47
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 48 SxRadio(uint32_t WakeupTime) : WakeupTime(WakeupTime), State(RF_IDLE), Modem(MODEM_LORA) { }
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 49 virtual ~SxRadio() {};
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 50
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 51 /*!
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 52 * \brief Initializes the radio
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 53 *
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 54 * \param [IN] events Structure containing the driver callback functions
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 55 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 56 virtual void Init( SxRadioEvents *events ) = 0;
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 57 /*!
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 58 * \brief Prepares the radio for destruction
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 59 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 60 virtual void Terminate( void ) = 0;
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 61 /*!
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 62 * Return current radio status
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 63 *
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 64 * \param status Radio status.[RF_IDLE, RF_RX_RUNNING, RF_TX_RUNNING]
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 65 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 66 virtual RadioState_t Status( void ) { return State; }
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 67 /*!
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 68 * \brief Configures the radio with the given modem
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 69 *
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 70 * \param [IN] modem Modem to be used [0: FSK, 1: LoRa]
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 71 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 72 virtual void SetModem( RadioModems_t modem ) = 0;
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 73 /*!
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 74 * \brief Sets the channel frequency
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 75 *
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 76 * \param [IN] freq Channel RF frequency
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 77 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 78 virtual void SetChannel( uint32_t freq ) = 0;
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 79 /*!
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 80 * \brief Sets the channels configuration
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 81 *
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 82 * \param [IN] modem Radio modem to be used [0: FSK, 1: LoRa]
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 83 * \param [IN] freq Channel RF frequency
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 84 * \param [IN] rssiThresh RSSI threshold
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 85 * \param [IN] rssiVal pointer to variable to hold RSSI value if desired - ignored if NULL
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 86 *
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 87 * \retval isFree [true: Channel is free, false: Channel is not free]
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 88 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 89 virtual bool IsChannelFree( RadioModems_t modem, uint32_t freq, uint8_t datarate, int16_t rssiThresh, uint8_t bandwidth, uint32_t timeout = 5000, int16_t *rssiVal = NULL ) = 0;
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 90 /*!
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 91 * \brief Generates a 32 bits random value based on the RSSI readings
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 92 *
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 93 * \remark This function sets the radio in LoRa modem mode and disables
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 94 * all interrupts.
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 95 * After calling this function either Radio.SetRxConfig or
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 96 * Radio.SetTxConfig functions must be called.
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 97 *
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 98 * \retval randomValue 32 bits random value
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 99 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 100 virtual uint32_t Random( void ) = 0;
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 101 /*!
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 102 * \brief Sets the reception parameters
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 103 *
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 104 * \param [IN] modem Radio modem to be used [0: FSK, 1: LoRa]
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 105 * \param [IN] bandwidth Sets the bandwidth
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 106 * FSK : >= 2600 and <= 250000 Hz
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 107 * LoRa: [0: 125 kHz, 1: 250 kHz,
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 108 * 2: 500 kHz, 3: Reserved]
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 109 * \param [IN] datarate Sets the Datarate
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 110 * FSK : 600..300000 bits/s
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 111 * LoRa: [6: 64, 7: 128, 8: 256, 9: 512,
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 112 * 10: 1024, 11: 2048, 12: 4096 chips]
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 113 * \param [IN] coderate Sets the coding rate (LoRa only)
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 114 * FSK : N/A ( set to 0 )
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 115 * LoRa: [1: 4/5, 2: 4/6, 3: 4/7, 4: 4/8]
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 116 * \param [IN] bandwidthAfc Sets the AFC Bandwidth (FSK only)
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 117 * FSK : >= 2600 and <= 250000 Hz
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 118 * LoRa: N/A ( set to 0 )
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 119 * \param [IN] preambleLen Sets the Preamble length
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 120 * FSK : Number of bytes
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 121 * LoRa: Length in symbols (the hardware adds 4 more symbols)
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 122 * \param [IN] symbTimeout Sets the RxSingle timeout value (LoRa only)
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 123 * FSK : N/A ( set to 0 )
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 124 * LoRa: timeout in symbols
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 125 * \param [IN] fixLen Fixed length packets [0: variable, 1: fixed]
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 126 * \param [IN] payloadLen Sets payload length when fixed length is used
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 127 * \param [IN] crcOn Enables/Disables the CRC [0: OFF, 1: ON]
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 128 * \param [IN] FreqHopOn Enables disables the intra-packet frequency hopping
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 129 * FSK : N/A ( set to 0 )
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 130 * LoRa: [0: OFF, 1: ON]
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 131 * \param [IN] HopPeriod Number of symbols bewteen each hop
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 132 * FSK : N/A ( set to 0 )
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 133 * LoRa: Number of symbols
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 134 * \param [IN] iqInverted Inverts IQ signals (LoRa only)
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 135 * FSK : N/A ( set to 0 )
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 136 * LoRa: [0: not inverted, 1: inverted]
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 137 * \param [IN] rxContinuous Sets the reception in continuous mode
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 138 * [false: single mode, true: continuous mode]
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 139 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 140 virtual void SetRxConfig( RadioModems_t modem, uint32_t bandwidth,
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 141 uint32_t datarate, uint8_t coderate,
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 142 uint32_t bandwidthAfc, uint16_t preambleLen,
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 143 uint16_t symbTimeout, bool fixLen,
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 144 uint8_t payloadLen,
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 145 bool crcOn, bool FreqHopOn, uint8_t HopPeriod,
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 146 bool iqInverted, bool rxContinuous ) = 0;
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 147 /*!
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 148 * \brief Sets the transmission parameters
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 149 *
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 150 * \param [IN] modem Radio modem to be used [0: FSK, 1: LoRa]
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 151 * \param [IN] power Sets the output power [dBm]
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 152 * \param [IN] fdev Sets the frequency deviation (FSK only)
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 153 * FSK : [Hz]
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 154 * LoRa: 0
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 155 * \param [IN] bandwidth Sets the bandwidth (LoRa only)
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 156 * FSK : 0
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 157 * LoRa: [0: 125 kHz, 1: 250 kHz,
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 158 * 2: 500 kHz, 3: Reserved]
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 159 * \param [IN] datarate Sets the Datarate
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 160 * FSK : 600..300000 bits/s
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 161 * LoRa: [6: 64, 7: 128, 8: 256, 9: 512,
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 162 * 10: 1024, 11: 2048, 12: 4096 chips]
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 163 * \param [IN] coderate Sets the coding rate (LoRa only)
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 164 * FSK : N/A ( set to 0 )
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 165 * LoRa: [1: 4/5, 2: 4/6, 3: 4/7, 4: 4/8]
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 166 * \param [IN] preambleLen Sets the preamble length
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 167 * FSK : Number of bytes
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 168 * LoRa: Length in symbols (the hardware adds 4 more symbols)
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 169 * \param [IN] fixLen Fixed length packets [0: variable, 1: fixed]
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 170 * \param [IN] crcOn Enables disables the CRC [0: OFF, 1: ON]
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 171 * \param [IN] FreqHopOn Enables disables the intra-packet frequency hopping
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 172 * FSK : N/A ( set to 0 )
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 173 * LoRa: [0: OFF, 1: ON]
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 174 * \param [IN] HopPeriod Number of symbols bewteen each hop
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 175 * FSK : N/A ( set to 0 )
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 176 * LoRa: Number of symbols
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 177 * \param [IN] iqInverted Inverts IQ signals (LoRa only)
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 178 * FSK : N/A ( set to 0 )
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 179 * LoRa: [0: not inverted, 1: inverted]
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 180 * \param [IN] timeout Transmission timeout [us]
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 181 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 182 virtual void SetTxConfig( RadioModems_t modem, int8_t power, uint32_t fdev,
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 183 uint32_t bandwidth, uint32_t datarate,
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 184 uint8_t coderate, uint16_t preambleLen,
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 185 bool fixLen, bool crcOn, bool FreqHopOn,
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 186 uint8_t HopPeriod, bool iqInverted, uint32_t timeout ) = 0;
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 187
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 188 virtual void SetTxContinuous(bool enable) = 0;
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 189
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 190 /*!
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 191 * \brief Checks if the given RF frequency is supported by the hardware
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 192 *
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 193 * \param [IN] frequency RF frequency to be checked
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 194 * \retval isSupported [true: supported, false: unsupported]
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 195 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 196 virtual bool CheckRfFrequency( uint32_t frequency ) { return true; }
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 197 /*!
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 198 * \brief Computes the packet time on air for the given payload
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 199 *
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 200 * \Remark Can only be called once SetRxConfig or SetTxConfig have been called
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 201 *
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 202 * \param [IN] modem Radio modem to be used [0: FSK, 1: LoRa]
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 203 * \param [IN] pktLen Packet payload length
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 204 *
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 205 * \retval airTime Computed airTime for the given packet payload length
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 206 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 207 virtual double TimeOnAir( RadioModems_t modem, uint8_t pktLen ) = 0;
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 208 /*!
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 209 * \brief Sends the buffer of size. Prepares the packet to be sent and sets
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 210 * the radio in transmission
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 211 *
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 212 * \param [IN]: buffer Buffer pointer
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 213 * \param [IN]: size Buffer size
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 214 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 215 virtual void Send( const uint8_t *buffer, uint8_t size ) = 0;
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 216 /*!
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 217 * \brief Sets the radio in sleep mode
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 218 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 219 virtual void Sleep( void ) = 0;
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 220 /*!
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 221 * \brief Sets the radio in standby mode
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 222 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 223 virtual void Standby( void ) = 0;
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 224 /*!
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 225 * \brief Sets the radio in reception mode for the given time
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 226 * \param [IN] timeout Reception timeout [us]
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 227 * [0: continuous, others timeout]
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 228 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 229 virtual void Rx( uint32_t timeout ) = 0;
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 230 /*!
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 231 * \brief Start a Channel Activity Detection
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 232 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 233 virtual void StartCad( void ) = 0;
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 234 /*!
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 235 * \brief Reads the current RSSI value
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 236 *
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 237 * \retval rssiValue Current RSSI value in [dBm]
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 238 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 239 virtual int16_t Rssi( RadioModems_t modem ) = 0;
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 240 /*!
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 241 * \brief Writes the radio register at the specified address
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 242 *
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 243 * \param [IN]: addr Register address
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 244 * \param [IN]: data New register value
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 245 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 246 virtual void Write( uint8_t addr, uint8_t data ) = 0;
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 247 /*!
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 248 * \brief Reads the radio register at the specified address
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 249 *
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 250 * \param [IN]: addr Register address
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 251 * \retval data Register value
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 252 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 253 virtual uint8_t Read ( uint8_t addr ) = 0;
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 254 /*!
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 255 * \brief Writes multiple radio registers starting at address
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 256 *
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 257 * \param [IN] addr First Radio register address
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 258 * \param [IN] buffer Buffer containing the new register's values
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 259 * \param [IN] size Number of registers to be written
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 260 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 261 virtual void WriteBuffer( uint8_t addr, const uint8_t *buffer, uint8_t size ) = 0;
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 262 /*!
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 263 * \brief Reads multiple radio registers starting at address
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 264 *
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 265 * \param [IN] addr First Radio register address
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 266 * \param [OUT] buffer Buffer where to copy the registers data
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 267 * \param [IN] size Number of registers to be read
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 268 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 269 virtual void ReadBuffer( uint8_t addr, uint8_t *buffer, uint8_t size ) = 0;
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 270
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 271 virtual void SignalMacEvent(void) {};
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 272
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 273 void GrabMutex(void) { mutex.lock(); }
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 274 void ReleaseMutex(void) { mutex.unlock(); }
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 275
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 276 const uint32_t WakeupTime;
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 277
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 278 protected:
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 279 RadioState_t State;
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 280
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 281 RadioModems_t Modem;
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 282
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 283 /*!
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 284 * Access protection
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 285 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 286 Mutex mutex;
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 287 };
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 288
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 289 #endif // __SXRADIO_H__
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 290