SX1278.h

#if !defined(_RADIOLIB_SX1278_H)
#define _RADIOLIB_SX1278_H
 
#include "../../TypeDef.h"
 
#if !defined(RADIOLIB_EXCLUDE_SX127X)
 
#include "../../Module.h"
#include "SX127x.h"
 
// SX1278 specific register map
#define RADIOLIB_SX1278_REG_MODEM_CONFIG_3                     0x26
#define RADIOLIB_SX1278_REG_PLL_HOP                            0x44
#define RADIOLIB_SX1278_REG_TCXO                               0x4B
#define RADIOLIB_SX1278_REG_PA_DAC                             0x4D
#define RADIOLIB_SX1278_REG_FORMER_TEMP                        0x5B
#define RADIOLIB_SX1278_REG_REG_BIT_RATE_FRAC                  0x5D
#define RADIOLIB_SX1278_REG_AGC_REF                            0x61
#define RADIOLIB_SX1278_REG_AGC_THRESH_1                       0x62
#define RADIOLIB_SX1278_REG_AGC_THRESH_2                       0x63
#define RADIOLIB_SX1278_REG_AGC_THRESH_3                       0x64
#define RADIOLIB_SX1278_REG_PLL                                0x70
 
// SX1278 LoRa modem settings
// RADIOLIB_SX1278_REG_OP_MODE                                                  MSB   LSB   DESCRIPTION
#define RADIOLIB_SX1278_HIGH_FREQ                              0b00000000  //  3     3     access HF test registers
#define RADIOLIB_SX1278_LOW_FREQ                               0b00001000  //  3     3     access LF test registers
 
// RADIOLIB_SX1278_REG_FRF_MSB + REG_FRF_MID + REG_FRF_LSB
#define RADIOLIB_SX1278_FRF_MSB                                0x6C        //  7     0     carrier frequency setting: f_RF = (F(XOSC) * FRF)/2^19
#define RADIOLIB_SX1278_FRF_MID                                0x80        //  7     0         where F(XOSC) = 32 MHz
#define RADIOLIB_SX1278_FRF_LSB                                0x00        //  7     0               FRF = 3 byte value of FRF registers
 
// RADIOLIB_SX1278_REG_PA_CONFIG
#define RADIOLIB_SX1278_MAX_POWER                              0b01110000  //  6     4     max power: P_max = 10.8 + 0.6*MAX_POWER [dBm]; P_max(MAX_POWER = 0b111) = 15 dBm
#define RADIOLIB_SX1278_LOW_POWER                              0b00100000  //  6     4
 
// RADIOLIB_SX1278_REG_LNA
#define RADIOLIB_SX1278_LNA_BOOST_LF_OFF                       0b00000000  //  4     3     default LNA current
 
// SX127X_REG_MODEM_CONFIG_1
#define RADIOLIB_SX1278_BW_7_80_KHZ                            0b00000000  //  7     4     bandwidth:  7.80 kHz
#define RADIOLIB_SX1278_BW_10_40_KHZ                           0b00010000  //  7     4                 10.40 kHz
#define RADIOLIB_SX1278_BW_15_60_KHZ                           0b00100000  //  7     4                 15.60 kHz
#define RADIOLIB_SX1278_BW_20_80_KHZ                           0b00110000  //  7     4                 20.80 kHz
#define RADIOLIB_SX1278_BW_31_25_KHZ                           0b01000000  //  7     4                 31.25 kHz
#define RADIOLIB_SX1278_BW_41_70_KHZ                           0b01010000  //  7     4                 41.70 kHz
#define RADIOLIB_SX1278_BW_62_50_KHZ                           0b01100000  //  7     4                 62.50 kHz
#define RADIOLIB_SX1278_BW_125_00_KHZ                          0b01110000  //  7     4                 125.00 kHz
#define RADIOLIB_SX1278_BW_250_00_KHZ                          0b10000000  //  7     4                 250.00 kHz
#define RADIOLIB_SX1278_BW_500_00_KHZ                          0b10010000  //  7     4                 500.00 kHz
#define RADIOLIB_SX1278_CR_4_5                                 0b00000010  //  3     1     error coding rate:  4/5
#define RADIOLIB_SX1278_CR_4_6                                 0b00000100  //  3     1                         4/6
#define RADIOLIB_SX1278_CR_4_7                                 0b00000110  //  3     1                         4/7
#define RADIOLIB_SX1278_CR_4_8                                 0b00001000  //  3     1                         4/8
#define RADIOLIB_SX1278_HEADER_EXPL_MODE                       0b00000000  //  0     0     explicit header mode
#define RADIOLIB_SX1278_HEADER_IMPL_MODE                       0b00000001  //  0     0     implicit header mode
 
// SX127X_REG_MODEM_CONFIG_2
#define RADIOLIB_SX1278_RX_CRC_MODE_OFF                        0b00000000  //  2     2     CRC disabled
#define RADIOLIB_SX1278_RX_CRC_MODE_ON                         0b00000100  //  2     2     CRC enabled
 
// RADIOLIB_SX1278_REG_MODEM_CONFIG_3
#define RADIOLIB_SX1278_LOW_DATA_RATE_OPT_OFF                  0b00000000  //  3     3     low data rate optimization disabled
#define RADIOLIB_SX1278_LOW_DATA_RATE_OPT_ON                   0b00001000  //  3     3     low data rate optimization enabled
#define RADIOLIB_SX1278_AGC_AUTO_OFF                           0b00000000  //  2     2     LNA gain set by REG_LNA
#define RADIOLIB_SX1278_AGC_AUTO_ON                            0b00000100  //  2     2     LNA gain set by internal AGC loop
 
// SX127X_REG_VERSION
#define RADIOLIB_SX1278_CHIP_VERSION                           0x12
 
// SX1278 FSK modem settings
// SX127X_REG_PA_RAMP
#define RADIOLIB_SX1278_NO_SHAPING                             0b00000000  //  6     5     data shaping: no shaping (default)
#define RADIOLIB_SX1278_FSK_GAUSSIAN_1_0                       0b00100000  //  6     5                   FSK modulation Gaussian filter, BT = 1.0
#define RADIOLIB_SX1278_FSK_GAUSSIAN_0_5                       0b01000000  //  6     5                   FSK modulation Gaussian filter, BT = 0.5
#define RADIOLIB_SX1278_FSK_GAUSSIAN_0_3                       0b01100000  //  6     5                   FSK modulation Gaussian filter, BT = 0.3
#define RADIOLIB_SX1278_OOK_FILTER_BR                          0b00100000  //  6     5                   OOK modulation filter, f_cutoff = BR
#define RADIOLIB_SX1278_OOK_FILTER_2BR                         0b01000000  //  6     5                   OOK modulation filter, f_cutoff = 2*BR
 
// RADIOLIB_SX1278_REG_AGC_REF
#define RADIOLIB_SX1278_AGC_REFERENCE_LEVEL_LF                 0x19        //  5     0     floor reference for AGC thresholds: AgcRef = -174 + 10*log(2*RxBw) + 8 + AGC_REFERENCE_LEVEL [dBm]: below 525 MHz
#define RADIOLIB_SX1278_AGC_REFERENCE_LEVEL_HF                 0x1C        //  5     0                                                                                                         above 779 MHz
 
// RADIOLIB_SX1278_REG_AGC_THRESH_1
#define RADIOLIB_SX1278_AGC_STEP_1_LF                          0x0C        //  4     0     1st AGC threshold: below 525 MHz
#define RADIOLIB_SX1278_AGC_STEP_1_HF                          0x0E        //  4     0                        above 779 MHz
 
// RADIOLIB_SX1278_REG_AGC_THRESH_2
#define RADIOLIB_SX1278_AGC_STEP_2_LF                          0x40        //  7     4     2nd AGC threshold: below 525 MHz
#define RADIOLIB_SX1278_AGC_STEP_2_HF                          0x50        //  7     4                        above 779 MHz
#define RADIOLIB_SX1278_AGC_STEP_3                             0x0B        //  3     0     3rd AGC threshold
 
// RADIOLIB_SX1278_REG_AGC_THRESH_3
#define RADIOLIB_SX1278_AGC_STEP_4                             0xC0        //  7     4     4th AGC threshold
#define RADIOLIB_SX1278_AGC_STEP_5                             0x0C        //  4     0     5th AGC threshold
 
class SX1278: public SX127x {
  public:
 
    // constructor
 
    SX1278(Module* mod);
 
    // basic methods
 
    int16_t begin(float freq = 434.0, float bw = 125.0, uint8_t sf = 9, uint8_t cr = 7, uint8_t syncWord = RADIOLIB_SX127X_SYNC_WORD, int8_t power = 10, uint16_t preambleLength = 8, uint8_t gain = 0);
 
    int16_t beginFSK(float freq = 434.0, float br = 4.8, float freqDev = 5.0, float rxBw = 125.0, int8_t power = 10, uint16_t preambleLength = 16, bool enableOOK = false);
 
    void reset() override;
 
    // configuration methods
 
    int16_t setFrequency(float freq);
 
    int16_t setBandwidth(float bw);
 
    int16_t setSpreadingFactor(uint8_t sf);
 
    int16_t setCodingRate(uint8_t cr);
 
    int16_t setOutputPower(int8_t power, bool useRfo = false);
 
    int16_t setGain(uint8_t gain);
 
    int16_t setDataShaping(uint8_t sh) override;
 
    int16_t setDataShapingOOK(uint8_t sh);
 
    float getRSSI(bool skipReceive = false);
 
    int16_t setCRC(bool enable, bool mode = false);
 
    int16_t forceLDRO(bool enable);
 
    int16_t autoLDRO();
 
    int16_t implicitHeader(size_t len);
 
    int16_t explicitHeader();
 
#if !defined(RADIOLIB_GODMODE)
  protected:
#endif
    int16_t setBandwidthRaw(uint8_t newBandwidth);
    int16_t setSpreadingFactorRaw(uint8_t newSpreadingFactor);
    int16_t setCodingRateRaw(uint8_t newCodingRate);
    int16_t setHeaderType(uint8_t headerType, size_t len = 0xFF);
 
    int16_t configFSK();
    void errataFix(bool rx);
 
#if !defined(RADIOLIB_GODMODE)
  private:
#endif
    bool _ldroAuto = true;
    bool _ldroEnabled = false;
 
};
 
#endif
 
#endif