Semtech / SX1276Lib

Driver for the SX1276 RF Transceiver

Dependents:   LoRa_PIR LoRaWAN-lmic-app SX1276PingPong LoRaWAN-lmic-app ... more

sx1276/sx1276-hal.h@27:737e89f8d4f3, 2018-10-16 (annotated)

Committer:
mverdy
Date:
Tue Oct 16 15:50:04 2018 +0000
Revision:
27:737e89f8d4f3
Parent:
26:d09a8ef807e2 
Remove debug folder as it is now available in mbed library

Who changed what in which revision?

UserRevisionLine numberNew contents of line
GregCr 0:e6ceb13d2d05 1 /*
GregCr 0:e6ceb13d2d05 2 / _____) _ | |
GregCr 0:e6ceb13d2d05 3 ( (____ _____ ____ _| |_ _____ ____| |__
GregCr 0:e6ceb13d2d05 4 \____ \| ___ | (_ _) ___ |/ ___) _ \
GregCr 0:e6ceb13d2d05 5 _____) ) ____| | | || |_| ____( (___| | | |
GregCr 0:e6ceb13d2d05 6 (______/|_____)_|_|_| \__)_____)\____)_| |_|
mluis 22:7f3aab69cca9 7 (C) 2014 Semtech
GregCr 0:e6ceb13d2d05 8
GregCr 0:e6ceb13d2d05 9 Description: -
GregCr 0:e6ceb13d2d05 10
GregCr 0:e6ceb13d2d05 11 License: Revised BSD License, see LICENSE.TXT file include in the project
GregCr 0:e6ceb13d2d05 12
GregCr 0:e6ceb13d2d05 13 Maintainers: Miguel Luis, Gregory Cristian and Nicolas Huguenin
GregCr 0:e6ceb13d2d05 14 */
GregCr 0:e6ceb13d2d05 15 #ifndef __SX1276_HAL_H__
GregCr 0:e6ceb13d2d05 16 #define __SX1276_HAL_H__
GregCr 0:e6ceb13d2d05 17 #include "sx1276.h"
GregCr 0:e6ceb13d2d05 18
mluis 22:7f3aab69cca9 19 /*!
mluis 26:d09a8ef807e2 20 * @brief Radio hardware registers initialization definition
mluis 22:7f3aab69cca9 21 *
mluis 26:d09a8ef807e2 22 * @remark Can be automatically generated by the SX1276 GUI (not yet implemented)
mluis 22:7f3aab69cca9 23 */
mluis 22:7f3aab69cca9 24 #define RADIO_INIT_REGISTERS_VALUE \
mluis 22:7f3aab69cca9 25 { \
mluis 22:7f3aab69cca9 26 { MODEM_FSK , REG_LNA , 0x23 },\
mluis 22:7f3aab69cca9 27 { MODEM_FSK , REG_RXCONFIG , 0x1E },\
mluis 22:7f3aab69cca9 28 { MODEM_FSK , REG_RSSICONFIG , 0xD2 },\
mluis 26:d09a8ef807e2 29 { MODEM_FSK , REG_AFCFEI , 0x01 },\
mluis 22:7f3aab69cca9 30 { MODEM_FSK , REG_PREAMBLEDETECT , 0xAA },\
mluis 22:7f3aab69cca9 31 { MODEM_FSK , REG_OSC , 0x07 },\
mluis 22:7f3aab69cca9 32 { MODEM_FSK , REG_SYNCCONFIG , 0x12 },\
mluis 22:7f3aab69cca9 33 { MODEM_FSK , REG_SYNCVALUE1 , 0xC1 },\
mluis 22:7f3aab69cca9 34 { MODEM_FSK , REG_SYNCVALUE2 , 0x94 },\
mluis 22:7f3aab69cca9 35 { MODEM_FSK , REG_SYNCVALUE3 , 0xC1 },\
mluis 22:7f3aab69cca9 36 { MODEM_FSK , REG_PACKETCONFIG1 , 0xD8 },\
mluis 22:7f3aab69cca9 37 { MODEM_FSK , REG_FIFOTHRESH , 0x8F },\
mluis 22:7f3aab69cca9 38 { MODEM_FSK , REG_IMAGECAL , 0x02 },\
mluis 22:7f3aab69cca9 39 { MODEM_FSK , REG_DIOMAPPING1 , 0x00 },\
mluis 22:7f3aab69cca9 40 { MODEM_FSK , REG_DIOMAPPING2 , 0x30 },\
mluis 22:7f3aab69cca9 41 { MODEM_LORA, REG_LR_PAYLOADMAXLENGTH, 0x40 },\
mluis 22:7f3aab69cca9 42 } \
mluis 22:7f3aab69cca9 43
GregCr 0:e6ceb13d2d05 44 /*!
GregCr 0:e6ceb13d2d05 45 * Actual implementation of a SX1276 radio, includes some modifications to make it compatible with the MB1 LAS board
GregCr 0:e6ceb13d2d05 46 */
GregCr 0:e6ceb13d2d05 47 class SX1276MB1xAS : public SX1276
GregCr 0:e6ceb13d2d05 48 {
GregCr 0:e6ceb13d2d05 49 protected:
GregCr 0:e6ceb13d2d05 50 /*!
GregCr 0:e6ceb13d2d05 51 * Antenna switch GPIO pins objects
GregCr 0:e6ceb13d2d05 52 */
mluis 26:d09a8ef807e2 53 DigitalInOut AntSwitch;
mluis 26:d09a8ef807e2 54 DigitalIn Fake;
mluis 26:d09a8ef807e2 55
GregCr 0:e6ceb13d2d05 56 private:
GregCr 0:e6ceb13d2d05 57 static const RadioRegisters_t RadioRegsInit[];
mluis 26:d09a8ef807e2 58
GregCr 0:e6ceb13d2d05 59 public:
mluis 21:2e496deb7858 60 SX1276MB1xAS( RadioEvents_t *events,
GregCr 0:e6ceb13d2d05 61 PinName mosi, PinName miso, PinName sclk, PinName nss, PinName reset,
GregCr 0:e6ceb13d2d05 62 PinName dio0, PinName dio1, PinName dio2, PinName dio3, PinName dio4, PinName dio5,
GregCr 0:e6ceb13d2d05 63 PinName antSwitch );
mluis 26:d09a8ef807e2 64
mluis 22:7f3aab69cca9 65 SX1276MB1xAS( RadioEvents_t *events );
mluis 26:d09a8ef807e2 66
GregCr 0:e6ceb13d2d05 67 virtual ~SX1276MB1xAS( ) { };
mluis 26:d09a8ef807e2 68
mluis 26:d09a8ef807e2 69 protected:
GregCr 0:e6ceb13d2d05 70 /*!
GregCr 0:e6ceb13d2d05 71 * @brief Initializes the radio I/Os pins interface
GregCr 0:e6ceb13d2d05 72 */
GregCr 0:e6ceb13d2d05 73 virtual void IoInit( void );
mluis 26:d09a8ef807e2 74
GregCr 0:e6ceb13d2d05 75 /*!
GregCr 0:e6ceb13d2d05 76 * @brief Initializes the radio registers
GregCr 0:e6ceb13d2d05 77 */
GregCr 0:e6ceb13d2d05 78 virtual void RadioRegistersInit( );
GregCr 0:e6ceb13d2d05 79
GregCr 0:e6ceb13d2d05 80 /*!
GregCr 0:e6ceb13d2d05 81 * @brief Initializes the radio SPI
GregCr 0:e6ceb13d2d05 82 */
GregCr 0:e6ceb13d2d05 83 virtual void SpiInit( void );
mluis 26:d09a8ef807e2 84
GregCr 0:e6ceb13d2d05 85 /*!
GregCr 0:e6ceb13d2d05 86 * @brief Initializes DIO IRQ handlers
GregCr 0:e6ceb13d2d05 87 *
GregCr 0:e6ceb13d2d05 88 * @param [IN] irqHandlers Array containing the IRQ callback functions
GregCr 0:e6ceb13d2d05 89 */
GregCr 0:e6ceb13d2d05 90 virtual void IoIrqInit( DioIrqHandler *irqHandlers );
GregCr 0:e6ceb13d2d05 91
GregCr 0:e6ceb13d2d05 92 /*!
GregCr 0:e6ceb13d2d05 93 * @brief De-initializes the radio I/Os pins interface.
GregCr 0:e6ceb13d2d05 94 *
GregCr 0:e6ceb13d2d05 95 * \remark Useful when going in MCU lowpower modes
GregCr 0:e6ceb13d2d05 96 */
GregCr 0:e6ceb13d2d05 97 virtual void IoDeInit( void );
GregCr 0:e6ceb13d2d05 98
GregCr 0:e6ceb13d2d05 99 /*!
mluis 26:d09a8ef807e2 100 * \brief Sets the radio output power.
mluis 26:d09a8ef807e2 101 *
mluis 26:d09a8ef807e2 102 * @param [IN] power Sets the RF output power
mluis 26:d09a8ef807e2 103 */
mluis 26:d09a8ef807e2 104 virtual void SetRfTxPower( int8_t power );
mluis 26:d09a8ef807e2 105
mluis 26:d09a8ef807e2 106 /*!
GregCr 0:e6ceb13d2d05 107 * @brief Gets the board PA selection configuration
GregCr 0:e6ceb13d2d05 108 *
GregCr 0:e6ceb13d2d05 109 * @param [IN] channel Channel frequency in Hz
GregCr 0:e6ceb13d2d05 110 * @retval PaSelect RegPaConfig PaSelect value
GregCr 0:e6ceb13d2d05 111 */
GregCr 0:e6ceb13d2d05 112 virtual uint8_t GetPaSelect( uint32_t channel );
GregCr 0:e6ceb13d2d05 113
GregCr 0:e6ceb13d2d05 114 /*!
GregCr 0:e6ceb13d2d05 115 * @brief Set the RF Switch I/Os pins in Low Power mode
GregCr 0:e6ceb13d2d05 116 *
GregCr 0:e6ceb13d2d05 117 * @param [IN] status enable or disable
GregCr 0:e6ceb13d2d05 118 */
GregCr 0:e6ceb13d2d05 119 virtual void SetAntSwLowPower( bool status );
GregCr 0:e6ceb13d2d05 120
GregCr 0:e6ceb13d2d05 121 /*!
GregCr 0:e6ceb13d2d05 122 * @brief Initializes the RF Switch I/Os pins interface
GregCr 0:e6ceb13d2d05 123 */
GregCr 0:e6ceb13d2d05 124 virtual void AntSwInit( void );
GregCr 0:e6ceb13d2d05 125
GregCr 0:e6ceb13d2d05 126 /*!
GregCr 0:e6ceb13d2d05 127 * @brief De-initializes the RF Switch I/Os pins interface
GregCr 0:e6ceb13d2d05 128 *
mluis 26:d09a8ef807e2 129 * @remark Needed to decrease the power consumption in MCU lowpower modes
GregCr 0:e6ceb13d2d05 130 */
GregCr 0:e6ceb13d2d05 131 virtual void AntSwDeInit( void );
GregCr 0:e6ceb13d2d05 132
GregCr 0:e6ceb13d2d05 133 /*!
GregCr 0:e6ceb13d2d05 134 * @brief Controls the antena switch if necessary.
GregCr 0:e6ceb13d2d05 135 *
mluis 26:d09a8ef807e2 136 * @remark see errata note
GregCr 0:e6ceb13d2d05 137 *
mluis 26:d09a8ef807e2 138 * @param [IN] opMode Current radio operating mode
GregCr 0:e6ceb13d2d05 139 */
mluis 26:d09a8ef807e2 140 virtual void SetAntSw( uint8_t opMode );
mluis 26:d09a8ef807e2 141
mluis 26:d09a8ef807e2 142 public:
GregCr 0:e6ceb13d2d05 143 /*!
GregCr 2:5eb3066446dd 144 * @brief Detect the board connected by reading the value of the antenna switch pin
GregCr 2:5eb3066446dd 145 */
mluis 26:d09a8ef807e2 146 virtual uint8_t DetectBoardType( void );
mluis 26:d09a8ef807e2 147
GregCr 2:5eb3066446dd 148 /*!
GregCr 0:e6ceb13d2d05 149 * @brief Checks if the given RF frequency is supported by the hardware
GregCr 0:e6ceb13d2d05 150 *
GregCr 0:e6ceb13d2d05 151 * @param [IN] frequency RF frequency to be checked
GregCr 0:e6ceb13d2d05 152 * @retval isSupported [true: supported, false: unsupported]
GregCr 0:e6ceb13d2d05 153 */
GregCr 0:e6ceb13d2d05 154 virtual bool CheckRfFrequency( uint32_t frequency );
mluis 26:d09a8ef807e2 155
mluis 26:d09a8ef807e2 156 /*!
GregCr 0:e6ceb13d2d05 157 * @brief Writes the radio register at the specified address
GregCr 0:e6ceb13d2d05 158 *
GregCr 0:e6ceb13d2d05 159 * @param [IN]: addr Register address
GregCr 0:e6ceb13d2d05 160 * @param [IN]: data New register value
GregCr 0:e6ceb13d2d05 161 */
GregCr 0:e6ceb13d2d05 162 virtual void Write ( uint8_t addr, uint8_t data ) ;
mluis 26:d09a8ef807e2 163
GregCr 0:e6ceb13d2d05 164 /*!
GregCr 0:e6ceb13d2d05 165 * @brief Reads the radio register at the specified address
GregCr 0:e6ceb13d2d05 166 *
GregCr 0:e6ceb13d2d05 167 * @param [IN]: addr Register address
GregCr 0:e6ceb13d2d05 168 * @retval data Register value
GregCr 0:e6ceb13d2d05 169 */
GregCr 0:e6ceb13d2d05 170 virtual uint8_t Read ( uint8_t addr ) ;
mluis 26:d09a8ef807e2 171
GregCr 0:e6ceb13d2d05 172 /*!
GregCr 0:e6ceb13d2d05 173 * @brief Writes multiple radio registers starting at address
GregCr 0:e6ceb13d2d05 174 *
GregCr 0:e6ceb13d2d05 175 * @param [IN] addr First Radio register address
GregCr 0:e6ceb13d2d05 176 * @param [IN] buffer Buffer containing the new register's values
GregCr 0:e6ceb13d2d05 177 * @param [IN] size Number of registers to be written
GregCr 0:e6ceb13d2d05 178 */
GregCr 0:e6ceb13d2d05 179 virtual void Write( uint8_t addr, uint8_t *buffer, uint8_t size ) ;
mluis 26:d09a8ef807e2 180
GregCr 0:e6ceb13d2d05 181 /*!
GregCr 0:e6ceb13d2d05 182 * @brief Reads multiple radio registers starting at address
GregCr 0:e6ceb13d2d05 183 *
GregCr 0:e6ceb13d2d05 184 * @param [IN] addr First Radio register address
GregCr 0:e6ceb13d2d05 185 * @param [OUT] buffer Buffer where to copy the registers data
GregCr 0:e6ceb13d2d05 186 * @param [IN] size Number of registers to be read
GregCr 0:e6ceb13d2d05 187 */
GregCr 0:e6ceb13d2d05 188 virtual void Read ( uint8_t addr, uint8_t *buffer, uint8_t size ) ;
mluis 26:d09a8ef807e2 189
GregCr 0:e6ceb13d2d05 190 /*!
GregCr 0:e6ceb13d2d05 191 * @brief Writes the buffer contents to the SX1276 FIFO
GregCr 0:e6ceb13d2d05 192 *
GregCr 0:e6ceb13d2d05 193 * @param [IN] buffer Buffer containing data to be put on the FIFO.
GregCr 0:e6ceb13d2d05 194 * @param [IN] size Number of bytes to be written to the FIFO
GregCr 0:e6ceb13d2d05 195 */
GregCr 0:e6ceb13d2d05 196 virtual void WriteFifo( uint8_t *buffer, uint8_t size ) ;
GregCr 0:e6ceb13d2d05 197
GregCr 0:e6ceb13d2d05 198 /*!
GregCr 0:e6ceb13d2d05 199 * @brief Reads the contents of the SX1276 FIFO
GregCr 0:e6ceb13d2d05 200 *
GregCr 0:e6ceb13d2d05 201 * @param [OUT] buffer Buffer where to copy the FIFO read data.
GregCr 0:e6ceb13d2d05 202 * @param [IN] size Number of bytes to be read from the FIFO
GregCr 0:e6ceb13d2d05 203 */
GregCr 0:e6ceb13d2d05 204 virtual void ReadFifo( uint8_t *buffer, uint8_t size ) ;
mluis 26:d09a8ef807e2 205
GregCr 0:e6ceb13d2d05 206 /*!
GregCr 0:e6ceb13d2d05 207 * @brief Reset the SX1276
GregCr 0:e6ceb13d2d05 208 */
GregCr 0:e6ceb13d2d05 209 virtual void Reset( void );
GregCr 0:e6ceb13d2d05 210 };
GregCr 0:e6ceb13d2d05 211
GregCr 0:e6ceb13d2d05 212 #endif // __SX1276_HAL_H__