commit/c69e98de90135ef92ca6d8292779209ff4b5d226/_c_c1101_8h_source.html

 #if !defined(_RADIOLIB_CC1101_H) && !defined(RADIOLIB_EXCLUDE_CC1101)

 #define _RADIOLIB_CC1101_H


 #include "../../TypeDef.h"

 #include "../../Module.h"


 #include "../../protocols/PhysicalLayer/PhysicalLayer.h"


 // CC1101 physical layer properties

 #define RADIOLIB_CC1101_FREQUENCY_STEP_SIZE                    396.7285156

 #define RADIOLIB_CC1101_MAX_PACKET_LENGTH                      255

 #define RADIOLIB_CC1101_CRYSTAL_FREQ                           26.0

 #define RADIOLIB_CC1101_DIV_EXPONENT                           16

 #define RADIOLIB_CC1101_FIFO_SIZE                              64


 // CC1101 SPI commands

 #define RADIOLIB_CC1101_CMD_READ                               0b10000000

 #define RADIOLIB_CC1101_CMD_WRITE                              0b00000000

 #define RADIOLIB_CC1101_CMD_BURST                              0b01000000

 #define RADIOLIB_CC1101_CMD_ACCESS_STATUS_REG                  0b01000000

 #define RADIOLIB_CC1101_CMD_FIFO_RX                            0b10000000

 #define RADIOLIB_CC1101_CMD_FIFO_TX                            0b00000000

 #define RADIOLIB_CC1101_CMD_RESET                              0x30

 #define RADIOLIB_CC1101_CMD_FSTXON                             0x31

 #define RADIOLIB_CC1101_CMD_XOFF                               0x32

 #define RADIOLIB_CC1101_CMD_CAL                                0x33

 #define RADIOLIB_CC1101_CMD_RX                                 0x34

 #define RADIOLIB_CC1101_CMD_TX                                 0x35

 #define RADIOLIB_CC1101_CMD_IDLE                               0x36

 #define RADIOLIB_CC1101_CMD_WOR                                0x38

 #define RADIOLIB_CC1101_CMD_POWER_DOWN                         0x39

 #define RADIOLIB_CC1101_CMD_FLUSH_RX                           0x3A

 #define RADIOLIB_CC1101_CMD_FLUSH_TX                           0x3B

 #define RADIOLIB_CC1101_CMD_WOR_RESET                          0x3C

 #define RADIOLIB_CC1101_CMD_NOP                                0x3D


 // CC1101 register map

 #define RADIOLIB_CC1101_REG_IOCFG2                             0x00

 #define RADIOLIB_CC1101_REG_IOCFG1                             0x01

 #define RADIOLIB_CC1101_REG_IOCFG0                             0x02

 #define RADIOLIB_CC1101_REG_FIFOTHR                            0x03

 #define RADIOLIB_CC1101_REG_SYNC1                              0x04

 #define RADIOLIB_CC1101_REG_SYNC0                              0x05

 #define RADIOLIB_CC1101_REG_PKTLEN                             0x06

 #define RADIOLIB_CC1101_REG_PKTCTRL1                           0x07

 #define RADIOLIB_CC1101_REG_PKTCTRL0                           0x08

 #define RADIOLIB_CC1101_REG_ADDR                               0x09

 #define RADIOLIB_CC1101_REG_CHANNR                             0x0A

 #define RADIOLIB_CC1101_REG_FSCTRL1                            0x0B

 #define RADIOLIB_CC1101_REG_FSCTRL0                            0x0C

 #define RADIOLIB_CC1101_REG_FREQ2                              0x0D

 #define RADIOLIB_CC1101_REG_FREQ1                              0x0E

 #define RADIOLIB_CC1101_REG_FREQ0                              0x0F

 #define RADIOLIB_CC1101_REG_MDMCFG4                            0x10

 #define RADIOLIB_CC1101_REG_MDMCFG3                            0x11

 #define RADIOLIB_CC1101_REG_MDMCFG2                            0x12

 #define RADIOLIB_CC1101_REG_MDMCFG1                            0x13

 #define RADIOLIB_CC1101_REG_MDMCFG0                            0x14

 #define RADIOLIB_CC1101_REG_DEVIATN                            0x15

 #define RADIOLIB_CC1101_REG_MCSM2                              0x16

 #define RADIOLIB_CC1101_REG_MCSM1                              0x17

 #define RADIOLIB_CC1101_REG_MCSM0                              0x18

 #define RADIOLIB_CC1101_REG_FOCCFG                             0x19

 #define RADIOLIB_CC1101_REG_BSCFG                              0x1A

 #define RADIOLIB_CC1101_REG_AGCCTRL2                           0x1B

 #define RADIOLIB_CC1101_REG_AGCCTRL1                           0x1C

 #define RADIOLIB_CC1101_REG_AGCCTRL0                           0x1D

 #define RADIOLIB_CC1101_REG_WOREVT1                            0x1E

 #define RADIOLIB_CC1101_REG_WOREVT0                            0x1F

 #define RADIOLIB_CC1101_REG_WORCTRL                            0x20

 #define RADIOLIB_CC1101_REG_FREND1                             0x21

 #define RADIOLIB_CC1101_REG_FREND0                             0x22

 #define RADIOLIB_CC1101_REG_FSCAL3                             0x23

 #define RADIOLIB_CC1101_REG_FSCAL2                             0x24

 #define RADIOLIB_CC1101_REG_FSCAL1                             0x25

 #define RADIOLIB_CC1101_REG_FSCAL0                             0x26

 #define RADIOLIB_CC1101_REG_RCCTRL1                            0x27

 #define RADIOLIB_CC1101_REG_RCCTRL0                            0x28

 #define RADIOLIB_CC1101_REG_FSTEST                             0x29

 #define RADIOLIB_CC1101_REG_PTEST                              0x2A

 #define RADIOLIB_CC1101_REG_AGCTEST                            0x2B

 #define RADIOLIB_CC1101_REG_TEST2                              0x2C

 #define RADIOLIB_CC1101_REG_TEST1                              0x2D

 #define RADIOLIB_CC1101_REG_TEST0                              0x2E

 #define RADIOLIB_CC1101_REG_PARTNUM                            0x30

 #define RADIOLIB_CC1101_REG_VERSION                            0x31

 #define RADIOLIB_CC1101_REG_FREQEST                            0x32

 #define RADIOLIB_CC1101_REG_LQI                                0x33

 #define RADIOLIB_CC1101_REG_RSSI                               0x34

 #define RADIOLIB_CC1101_REG_MARCSTATE                          0x35

 #define RADIOLIB_CC1101_REG_WORTIME1                           0x36

 #define RADIOLIB_CC1101_REG_WORTIME0                           0x37

 #define RADIOLIB_CC1101_REG_PKTSTATUS                          0x38

 #define RADIOLIB_CC1101_REG_VCO_VC_DAC                         0x39

 #define RADIOLIB_CC1101_REG_TXBYTES                            0x3A

 #define RADIOLIB_CC1101_REG_RXBYTES                            0x3B

 #define RADIOLIB_CC1101_REG_RCCTRL1_STATUS                     0x3C

 #define RADIOLIB_CC1101_REG_RCCTRL0_STATUS                     0x3D

 #define RADIOLIB_CC1101_REG_PATABLE                            0x3E

 #define RADIOLIB_CC1101_REG_FIFO                               0x3F


 // CC1101_REG_IOCFG2                                                  MSB   LSB   DESCRIPTION

 #define RADIOLIB_CC1101_GDO2_NORM                              0b00000000  //  6     6     GDO2 output: active high (default)

 #define RADIOLIB_CC1101_GDO2_INV                               0b01000000  //  6     6                  active low


 // CC1101_REG_IOCFG1

 #define RADIOLIB_CC1101_GDO1_DS_LOW                            0b00000000  //  7     7     GDO1 output drive strength: low (default)

 #define RADIOLIB_CC1101_GDO1_DS_HIGH                           0b10000000  //  7     7                                 high

 #define RADIOLIB_CC1101_GDO1_NORM                              0b00000000  //  6     6     GDO1 output: active high (default)

 #define RADIOLIB_CC1101_GDO1_INV                               0b01000000  //  6     6                  active low


 // CC1101_REG_IOCFG0

 #define RADIOLIB_CC1101_GDO0_TEMP_SENSOR_OFF                   0b00000000  //  7     7     analog temperature sensor output: disabled (default)

 #define RADIOLIB_CC1101_GDO0_TEMP_SENSOR_ON                    0b10000000  //  7     0                                       enabled

 #define RADIOLIB_CC1101_GDO0_NORM                              0b00000000  //  6     6     GDO0 output: active high (default)

 #define RADIOLIB_CC1101_GDO0_INV                               0b01000000  //  6     6                  active low


 // CC1101_REG_IOCFG2 + REG_IOCFG1 + REG_IOCFG0

 #define RADIOLIB_CC1101_GDOX_RX_FIFO_FULL                      0x00        //  5     0     Rx FIFO full or above threshold

 #define RADIOLIB_CC1101_GDOX_RX_FIFO_FULL_OR_PKT_END           0x01        //  5     0     Rx FIFO full or above threshold or reached packet end

 #define RADIOLIB_CC1101_GDOX_TX_FIFO_ABOVE_THR                 0x02        //  5     0     Tx FIFO above threshold

 #define RADIOLIB_CC1101_GDOX_TX_FIFO_FULL                      0x03        //  5     0     Tx FIFO full

 #define RADIOLIB_CC1101_GDOX_RX_FIFO_OVERFLOW                  0x04        //  5     0     Rx FIFO overflowed

 #define RADIOLIB_CC1101_GDOX_TX_FIFO_UNDERFLOW                 0x05        //  5     0     Tx FIFO underflowed

 #define RADIOLIB_CC1101_GDOX_SYNC_WORD_SENT_OR_RECEIVED        0x06        //  5     0     sync word was sent or received

 #define RADIOLIB_CC1101_GDOX_PKT_RECEIVED_CRC_OK               0x07        //  5     0     packet received and CRC check passed

 #define RADIOLIB_CC1101_GDOX_PREAMBLE_QUALITY_REACHED          0x08        //  5     0     received preamble quality is above threshold

 #define RADIOLIB_CC1101_GDOX_CHANNEL_CLEAR                     0x09        //  5     0     RSSI level below threshold (channel is clear)

 #define RADIOLIB_CC1101_GDOX_PLL_LOCKED                        0x0A        //  5     0     PLL is locked

 #define RADIOLIB_CC1101_GDOX_SERIAL_CLOCK                      0x0B        //  5     0     serial data clock

 #define RADIOLIB_CC1101_GDOX_SERIAL_DATA_SYNC                  0x0C        //  5     0     serial data output in: synchronous mode

 #define RADIOLIB_CC1101_GDOX_SERIAL_DATA_ASYNC                 0x0D        //  5     0                            asynchronous mode

 #define RADIOLIB_CC1101_GDOX_CARRIER_SENSE                     0x0E        //  5     0     RSSI above threshold

 #define RADIOLIB_CC1101_GDOX_CRC_OK                            0x0F        //  5     0     CRC check passed

 #define RADIOLIB_CC1101_GDOX_RX_HARD_DATA1                     0x16        //  5     0     direct access to demodulated data

 #define RADIOLIB_CC1101_GDOX_RX_HARD_DATA0                     0x17        //  5     0     direct access to demodulated data

 #define RADIOLIB_CC1101_GDOX_PA_PD                             0x1B        //  5     0     power amplifier circuit is powered down

 #define RADIOLIB_CC1101_GDOX_LNA_PD                            0x1C        //  5     0     low-noise amplifier circuit is powered down

 #define RADIOLIB_CC1101_GDOX_RX_SYMBOL_TICK                    0x1D        //  5     0     direct access to symbol tick of received data

 #define RADIOLIB_CC1101_GDOX_WOR_EVNT0                         0x24        //  5     0     wake-on-radio event 0

 #define RADIOLIB_CC1101_GDOX_WOR_EVNT1                         0x25        //  5     0     wake-on-radio event 1

 #define RADIOLIB_CC1101_GDOX_CLK_256                           0x26        //  5     0     256 Hz clock

 #define RADIOLIB_CC1101_GDOX_CLK_32K                           0x27        //  5     0     32 kHz clock

 #define RADIOLIB_CC1101_GDOX_CHIP_RDYN                         0x29        //  5     0      (default for GDO2)

 #define RADIOLIB_CC1101_GDOX_XOSC_STABLE                       0x2B        //  5     0

 #define RADIOLIB_CC1101_GDOX_HIGH_Z                            0x2E        //  5     0     high impedance state (default for GDO1)

 #define RADIOLIB_CC1101_GDOX_HW_TO_0                           0x2F        //  5     0

 #define RADIOLIB_CC1101_GDOX_CLOCK_XOSC_1                      0x30        //  5     0     crystal oscillator clock: f = f(XOSC)/1

 #define RADIOLIB_CC1101_GDOX_CLOCK_XOSC_1_5                    0x31        //  5     0                               f = f(XOSC)/1.5

 #define RADIOLIB_CC1101_GDOX_CLOCK_XOSC_2                      0x32        //  5     0                               f = f(XOSC)/2

 #define RADIOLIB_CC1101_GDOX_CLOCK_XOSC_3                      0x33        //  5     0                               f = f(XOSC)/3

 #define RADIOLIB_CC1101_GDOX_CLOCK_XOSC_4                      0x34        //  5     0                               f = f(XOSC)/4

 #define RADIOLIB_CC1101_GDOX_CLOCK_XOSC_6                      0x35        //  5     0                               f = f(XOSC)/6

 #define RADIOLIB_CC1101_GDOX_CLOCK_XOSC_8                      0x36        //  5     0                               f = f(XOSC)/8

 #define RADIOLIB_CC1101_GDOX_CLOCK_XOSC_12                     0x37        //  5     0                               f = f(XOSC)/12

 #define RADIOLIB_CC1101_GDOX_CLOCK_XOSC_16                     0x38        //  5     0                               f = f(XOSC)/16

 #define RADIOLIB_CC1101_GDOX_CLOCK_XOSC_24                     0x39        //  5     0                               f = f(XOSC)/24

 #define RADIOLIB_CC1101_GDOX_CLOCK_XOSC_32                     0x3A        //  5     0                               f = f(XOSC)/32

 #define RADIOLIB_CC1101_GDOX_CLOCK_XOSC_48                     0x3B        //  5     0                               f = f(XOSC)/48

 #define RADIOLIB_CC1101_GDOX_CLOCK_XOSC_64                     0x3C        //  5     0                               f = f(XOSC)/64

 #define RADIOLIB_CC1101_GDOX_CLOCK_XOSC_96                     0x3D        //  5     0                               f = f(XOSC)/96

 #define RADIOLIB_CC1101_GDOX_CLOCK_XOSC_128                    0x3E        //  5     0                               f = f(XOSC)/128

 #define RADIOLIB_CC1101_GDOX_CLOCK_XOSC_192                    0x3F        //  5     0                               f = f(XOSC)/192 (default for GDO0)


 // CC1101_REG_FIFOTHR

 #define RADIOLIB_CC1101_ADC_RETENTION_OFF                      0b00000000  //  6     6     do not retain ADC settings in sleep mode (default)

 #define RADIOLIB_CC1101_ADC_RETENTION_ON                       0b01000000  //  6     6     retain ADC settings in sleep mode

 #define RADIOLIB_CC1101_RX_ATTEN_0_DB                          0b00000000  //  5     4     Rx attenuation: 0 dB (default)

 #define RADIOLIB_CC1101_RX_ATTEN_6_DB                          0b00010000  //  5     4                     6 dB

 #define RADIOLIB_CC1101_RX_ATTEN_12_DB                         0b00100000  //  5     4                     12 dB

 #define RADIOLIB_CC1101_RX_ATTEN_18_DB                         0b00110000  //  5     4                     18 dB

 #define RADIOLIB_CC1101_FIFO_THR_TX_61_RX_4                    0b00000000  //  3     0     TX fifo threshold: 61, RX fifo threshold: 4


 // CC1101_REG_SYNC1

 #define RADIOLIB_CC1101_SYNC_WORD_MSB                          0xD3        //  7     0     sync word MSB


 // CC1101_REG_SYNC0

 #define RADIOLIB_CC1101_SYNC_WORD_LSB                          0x91        //  7     0     sync word LSB


 // CC1101_REG_PKTLEN

 #define RADIOLIB_CC1101_PACKET_LENGTH                          0xFF        //  7     0     packet length in bytes


 // CC1101_REG_PKTCTRL1

 #define RADIOLIB_CC1101_PQT                                    0x00        //  7     5     preamble quality threshold

 #define RADIOLIB_CC1101_CRC_AUTOFLUSH_OFF                      0b00000000  //  3     3     automatic Rx FIFO flush on CRC check fail: disabled (default)

 #define RADIOLIB_CC1101_CRC_AUTOFLUSH_ON                       0b00001000  //  3     3                                                enabled

 #define RADIOLIB_CC1101_APPEND_STATUS_OFF                      0b00000000  //  2     2     append 2 status bytes to packet: disabled

 #define RADIOLIB_CC1101_APPEND_STATUS_ON                       0b00000100  //  2     2                                      enabled (default)

 #define RADIOLIB_CC1101_ADR_CHK_NONE                           0b00000000  //  1     0     address check: none (default)

 #define RADIOLIB_CC1101_ADR_CHK_NO_BROADCAST                   0b00000001  //  1     0                    without broadcast

 #define RADIOLIB_CC1101_ADR_CHK_SINGLE_BROADCAST               0b00000010  //  1     0                    broadcast address 0x00

 #define RADIOLIB_CC1101_ADR_CHK_DOUBLE_BROADCAST               0b00000011  //  1     0                    broadcast addresses 0x00 and 0xFF


 // CC1101_REG_PKTCTRL0

 #define RADIOLIB_CC1101_WHITE_DATA_OFF                         0b00000000  //  6     6     data whitening: disabled

 #define RADIOLIB_CC1101_WHITE_DATA_ON                          0b01000000  //  6     6                     enabled (default)

 #define RADIOLIB_CC1101_PKT_FORMAT_NORMAL                      0b00000000  //  5     4     packet format: normal (FIFOs)

 #define RADIOLIB_CC1101_PKT_FORMAT_SYNCHRONOUS                 0b00010000  //  5     4                    synchronous serial

 #define RADIOLIB_CC1101_PKT_FORMAT_RANDOM                      0b00100000  //  5     4                    random transmissions

 #define RADIOLIB_CC1101_PKT_FORMAT_ASYNCHRONOUS                0b00110000  //  5     4                    asynchronous serial

 #define RADIOLIB_CC1101_CRC_OFF                                0b00000000  //  2     2     CRC disabled

 #define RADIOLIB_CC1101_CRC_ON                                 0b00000100  //  2     2     CRC enabled (default)

 #define RADIOLIB_CC1101_LENGTH_CONFIG_FIXED                    0b00000000  //  1     0     packet length: fixed

 #define RADIOLIB_CC1101_LENGTH_CONFIG_VARIABLE                 0b00000001  //  1     0                    variable (default)

 #define RADIOLIB_CC1101_LENGTH_CONFIG_INFINITE                 0b00000010  //  1     0                    infinite


 // CC1101_REG_ADDR

 #define RADIOLIB_CC1101_DEVICE_ADDR                            0x00        //  7     0     device address


 // CC1101_REG_CHANNR

 #define RADIOLIB_CC1101_CHAN                                   0x00        //  7     0     channel number


 // CC1101_REG_FSCTRL1

 #define RADIOLIB_CC1101_FREQ_IF                                0x0F        //  4     0     IF frequency setting; f_IF = (f(XOSC) / 2^10) * CC1101_FREQ_IF


 // CC1101_REG_FSCTRL0

 #define RADIOLIB_CC1101_FREQOFF                                0x00        //  7     0     base frequency offset (2s-compliment)


 // CC1101_REG_FREQ2 + REG_FREQ1 + REG_FREQ0

 #define RADIOLIB_CC1101_FREQ_MSB                               0x1E        //  5     0     base frequency setting: f_carrier = (f(XOSC) / 2^16) * FREQ

 #define RADIOLIB_CC1101_FREQ_MID                               0xC4        //  7     0         where f(XOSC) = 26 MHz

 #define RADIOLIB_CC1101_FREQ_LSB                               0xEC        //  7     0               FREQ = 3-byte value of FREQ registers


 // CC1101_REG_MDMCFG4

 #define RADIOLIB_CC1101_CHANBW_E                               0b10000000  //  7     6     channel bandwidth: BW_channel = f(XOSC) / (8 * (4 + CHANBW_M)*2^CHANBW_E) [Hz]

 #define RADIOLIB_CC1101_CHANBW_M                               0b00000000  //  5     4         default value for 26 MHz crystal: 203 125 Hz

 #define RADIOLIB_CC1101_DRATE_E                                0x0C        //  3     0     symbol rate: R_data = (((256 + DRATE_M) * 2^DRATE_E) / 2^28) * f(XOSC) [Baud]


 // CC1101_REG_MDMCFG3

 #define RADIOLIB_CC1101_DRATE_M                                0x22        //  7     0         default value for 26 MHz crystal: 115 051 Baud


 // CC1101_REG_MDMCFG2

 #define RADIOLIB_CC1101_DEM_DCFILT_OFF                         0b10000000  //  7     7     digital DC filter: disabled

 #define RADIOLIB_CC1101_DEM_DCFILT_ON                          0b00000000  //  7     7                        enabled - only for data rates above 250 kBaud (default)

 #define RADIOLIB_CC1101_MOD_FORMAT_2_FSK                       0b00000000  //  6     4     modulation format: 2-FSK (default)

 #define RADIOLIB_CC1101_MOD_FORMAT_GFSK                        0b00010000  //  6     4                        GFSK

 #define RADIOLIB_CC1101_MOD_FORMAT_ASK_OOK                     0b00110000  //  6     4                        ASK/OOK

 #define RADIOLIB_CC1101_MOD_FORMAT_4_FSK                       0b01000000  //  6     4                        4-FSK

 #define RADIOLIB_CC1101_MOD_FORMAT_MFSK                        0b01110000  //  6     4                        MFSK - only for data rates above 26 kBaud

 #define RADIOLIB_CC1101_MANCHESTER_EN_OFF                      0b00000000  //  3     3     Manchester encoding: disabled (default)

 #define RADIOLIB_CC1101_MANCHESTER_EN_ON                       0b00001000  //  3     3                          enabled

 #define RADIOLIB_CC1101_SYNC_MODE_NONE                         0b00000000  //  2     0     synchronization: no preamble/sync

 #define RADIOLIB_CC1101_SYNC_MODE_15_16                        0b00000001  //  2     0                      15/16 sync word bits

 #define RADIOLIB_CC1101_SYNC_MODE_16_16                        0b00000010  //  2     0                      16/16 sync word bits (default)

 #define RADIOLIB_CC1101_SYNC_MODE_30_32                        0b00000011  //  2     0                      30/32 sync word bits

 #define RADIOLIB_CC1101_SYNC_MODE_NONE_THR                     0b00000100  //  2     0                      no preamble sync, carrier sense above threshold

 #define RADIOLIB_CC1101_SYNC_MODE_15_16_THR                    0b00000101  //  2     0                      15/16 sync word bits, carrier sense above threshold

 #define RADIOLIB_CC1101_SYNC_MODE_16_16_THR                    0b00000110  //  2     0                      16/16 sync word bits, carrier sense above threshold

 #define RADIOLIB_CC1101_SYNC_MODE_30_32_THR                    0b00000111  //  2     0                      30/32 sync word bits, carrier sense above threshold


 // CC1101_REG_MDMCFG1

 #define RADIOLIB_CC1101_FEC_OFF                                0b00000000  //  7     7     forward error correction: disabled (default)

 #define RADIOLIB_CC1101_FEC_ON                                 0b10000000  //  7     7                               enabled - only for fixed packet length

 #define RADIOLIB_CC1101_NUM_PREAMBLE_2                         0b00000000  //  6     4     number of preamble bytes: 2

 #define RADIOLIB_CC1101_NUM_PREAMBLE_3                         0b00010000  //  6     4                               3

 #define RADIOLIB_CC1101_NUM_PREAMBLE_4                         0b00100000  //  6     4                               4 (default)

 #define RADIOLIB_CC1101_NUM_PREAMBLE_6                         0b00110000  //  6     4                               6

 #define RADIOLIB_CC1101_NUM_PREAMBLE_8                         0b01000000  //  6     4                               8

 #define RADIOLIB_CC1101_NUM_PREAMBLE_12                        0b01010000  //  6     4                               12

 #define RADIOLIB_CC1101_NUM_PREAMBLE_16                        0b01100000  //  6     4                               16

 #define RADIOLIB_CC1101_NUM_PREAMBLE_24                        0b01110000  //  6     4                               24

 #define RADIOLIB_CC1101_CHANSPC_E                              0x02        //  1     0     channel spacing: df_channel = (f(XOSC) / 2^18) * (256 + CHANSPC_M) * 2^CHANSPC_E [Hz]


 // CC1101_REG_MDMCFG0

 #define RADIOLIB_CC1101_CHANSPC_M                              0xF8        //  7     0         default value for 26 MHz crystal: 199 951 kHz


 // CC1101_REG_DEVIATN

 #define RADIOLIB_CC1101_DEVIATION_E                            0b01000000  //  6     4     frequency deviation: f_dev = (f(XOSC) / 2^17) * (8 + DEVIATION_M) * 2^DEVIATION_E [Hz]

 #define RADIOLIB_CC1101_DEVIATION_M                            0b00000111  //  2     0         default value for 26 MHz crystal: +- 47 607 Hz

 #define RADIOLIB_CC1101_MSK_PHASE_CHANGE_PERIOD                0x07        //  2     0     phase change symbol period fraction: 1 / (MSK_PHASE_CHANGE_PERIOD + 1)


 // CC1101_REG_MCSM2

 #define RADIOLIB_CC1101_RX_TIMEOUT_RSSI_OFF                    0b00000000  //  4     4     Rx timeout based on RSSI value: disabled (default)

 #define RADIOLIB_CC1101_RX_TIMEOUT_RSSI_ON                     0b00010000  //  4     4                                     enabled

 #define RADIOLIB_CC1101_RX_TIMEOUT_QUAL_OFF                    0b00000000  //  3     3     check for sync word on Rx timeout

 #define RADIOLIB_CC1101_RX_TIMEOUT_QUAL_ON                     0b00001000  //  3     3     check for PQI set on Rx timeout

 #define RADIOLIB_CC1101_RX_TIMEOUT_OFF                         0b00000111  //  2     0     Rx timeout: disabled (default)

 #define RADIOLIB_CC1101_RX_TIMEOUT_MAX                         0b00000000  //  2     0                 max value (actual value depends on WOR_RES, EVENT0 and f(XOSC))


 // CC1101_REG_MCSM1

 #define RADIOLIB_CC1101_CCA_MODE_ALWAYS                        0b00000000  //  5     4     clear channel indication: always

 #define RADIOLIB_CC1101_CCA_MODE_RSSI_THR                      0b00010000  //  5     4                               RSSI below threshold

 #define RADIOLIB_CC1101_CCA_MODE_RX_PKT                        0b00100000  //  5     4                               unless receiving packet

 #define RADIOLIB_CC1101_CCA_MODE_RSSI_THR_RX_PKT               0b00110000  //  5     4                               RSSI below threshold unless receiving packet (default)

 #define RADIOLIB_CC1101_RXOFF_IDLE                             0b00000000  //  3     2     next mode after packet reception: idle (default)

 #define RADIOLIB_CC1101_RXOFF_FSTXON                           0b00000100  //  3     2                                       FSTxOn

 #define RADIOLIB_CC1101_RXOFF_TX                               0b00001000  //  3     2                                       Tx

 #define RADIOLIB_CC1101_RXOFF_RX                               0b00001100  //  3     2                                       Rx

 #define RADIOLIB_CC1101_TXOFF_IDLE                             0b00000000  //  1     0     next mode after packet transmission: idle (default)

 #define RADIOLIB_CC1101_TXOFF_FSTXON                           0b00000001  //  1     0                                          FSTxOn

 #define RADIOLIB_CC1101_TXOFF_TX                               0b00000010  //  1     0                                          Tx

 #define RADIOLIB_CC1101_TXOFF_RX                               0b00000011  //  1     0                                          Rx


 // CC1101_REG_MCSM0

 #define RADIOLIB_CC1101_FS_AUTOCAL_NEVER                       0b00000000  //  5     4     automatic calibration: never (default)

 #define RADIOLIB_CC1101_FS_AUTOCAL_IDLE_TO_RXTX                0b00010000  //  5     4                            every transition from idle to Rx/Tx

 #define RADIOLIB_CC1101_FS_AUTOCAL_RXTX_TO_IDLE                0b00100000  //  5     4                            every transition from Rx/Tx to idle

 #define RADIOLIB_CC1101_FS_AUTOCAL_RXTX_TO_IDLE_4TH            0b00110000  //  5     4                            every 4th transition from Rx/Tx to idle

 #define RADIOLIB_CC1101_PO_TIMEOUT_COUNT_1                     0b00000000  //  3     2     number of counter expirations before CHP_RDYN goes low: 1 (default)

 #define RADIOLIB_CC1101_PO_TIMEOUT_COUNT_16                    0b00000100  //  3     2                                                             16

 #define RADIOLIB_CC1101_PO_TIMEOUT_COUNT_64                    0b00001000  //  3     2                                                             64

 #define RADIOLIB_CC1101_PO_TIMEOUT_COUNT_256                   0b00001100  //  3     2                                                             256

 #define RADIOLIB_CC1101_PIN_CTRL_OFF                           0b00000000  //  1     1     pin radio control: disabled (default)

 #define RADIOLIB_CC1101_PIN_CTRL_ON                            0b00000010  //  1     1                        enabled

 #define RADIOLIB_CC1101_XOSC_FORCE_OFF                         0b00000000  //  0     0     do not force XOSC to remain on in sleep (default)

 #define RADIOLIB_CC1101_XOSC_FORCE_ON                          0b00000001  //  0     0     force XOSC to remain on in sleep


 // CC1101_REG_FOCCFG

 #define RADIOLIB_CC1101_FOC_BS_CS_GATE_OFF                     0b00000000  //  5     5     do not freeze frequency compensation until CS goes high

 #define RADIOLIB_CC1101_FOC_BS_CS_GATE_ON                      0b00100000  //  5     5     freeze frequency compensation until CS goes high (default)

 #define RADIOLIB_CC1101_FOC_PRE_K                              0b00000000  //  4     3     frequency compensation loop gain before sync word: K

 #define RADIOLIB_CC1101_FOC_PRE_2K                             0b00001000  //  4     3                                                        2K

 #define RADIOLIB_CC1101_FOC_PRE_3K                             0b00010000  //  4     3                                                        3K (default)

 #define RADIOLIB_CC1101_FOC_PRE_4K                             0b00011000  //  4     3                                                        4K

 #define RADIOLIB_CC1101_FOC_POST_K                             0b00000000  //  2     2     frequency compensation loop gain after sync word: same as FOC_PRE

 #define RADIOLIB_CC1101_FOC_POST_K_2                           0b00000100  //  2     2                                                       K/2 (default)

 #define RADIOLIB_CC1101_FOC_LIMIT_NO_COMPENSATION              0b00000000  //  1     0     frequency compensation saturation point: no compensation - required for ASK/OOK

 #define RADIOLIB_CC1101_FOC_LIMIT_BW_CHAN_8                    0b00000001  //  1     0                                              +- BW_chan/8

 #define RADIOLIB_CC1101_FOC_LIMIT_BW_CHAN_4                    0b00000010  //  1     0                                              +- BW_chan/4 (default)

 #define RADIOLIB_CC1101_FOC_LIMIT_BW_CHAN_2                    0b00000011  //  1     0                                              +- BW_chan/2


 // CC1101_REG_BSCFG

 #define RADIOLIB_CC1101_BS_PRE_KI                              0b00000000  //  7     6     clock recovery integral gain before sync word: Ki

 #define RADIOLIB_CC1101_BS_PRE_2KI                             0b01000000  //  7     6                                                    2Ki (default)

 #define RADIOLIB_CC1101_BS_PRE_3KI                             0b10000000  //  7     6                                                    3Ki

 #define RADIOLIB_CC1101_BS_PRE_4KI                             0b11000000  //  7     6                                                    4Ki

 #define RADIOLIB_CC1101_BS_PRE_KP                              0b00000000  //  5     4     clock recovery proportional gain before sync word: Kp

 #define RADIOLIB_CC1101_BS_PRE_2KP                             0b00010000  //  5     4                                                        2Kp

 #define RADIOLIB_CC1101_BS_PRE_3KP                             0b00100000  //  5     4                                                        3Kp (default)

 #define RADIOLIB_CC1101_BS_PRE_4KP                             0b00110000  //  5     4                                                        4Kp

 #define RADIOLIB_CC1101_BS_POST_KI                             0b00000000  //  3     3     clock recovery integral gain after sync word: same as BS_PRE

 #define RADIOLIB_CC1101_BS_POST_KI_2                           0b00001000  //  3     3                                                   Ki/2 (default)

 #define RADIOLIB_CC1101_BS_POST_KP                             0b00000000  //  2     2     clock recovery proportional gain after sync word: same as BS_PRE

 #define RADIOLIB_CC1101_BS_POST_KP_1                           0b00000100  //  2     2                                                       Kp (default)

 #define RADIOLIB_CC1101_BS_LIMIT_NO_COMPENSATION               0b00000000  //  1     0     data rate compensation saturation point: no compensation

 #define RADIOLIB_CC1101_BS_LIMIT_3_125                         0b00000001  //  1     0                                              +- 3.125 %

 #define RADIOLIB_CC1101_BS_LIMIT_6_25                          0b00000010  //  1     0                                              +- 6.25 %

 #define RADIOLIB_CC1101_BS_LIMIT_12_5                          0b00000011  //  1     0                                              +- 12.5 %


 // CC1101_REG_AGCCTRL2

 #define RADIOLIB_CC1101_MAX_DVGA_GAIN_0                        0b00000000  //  7     6     reduce maximum available DVGA gain: no reduction (default)

 #define RADIOLIB_CC1101_MAX_DVGA_GAIN_1                        0b01000000  //  7     6                                         disable top gain setting

 #define RADIOLIB_CC1101_MAX_DVGA_GAIN_2                        0b10000000  //  7     6                                         disable top two gain setting

 #define RADIOLIB_CC1101_MAX_DVGA_GAIN_3                        0b11000000  //  7     6                                         disable top three gain setting

 #define RADIOLIB_CC1101_LNA_GAIN_REDUCE_0_DB                   0b00000000  //  5     3     reduce maximum LNA gain by: 0 dB (default)

 #define RADIOLIB_CC1101_LNA_GAIN_REDUCE_2_6_DB                 0b00001000  //  5     3                                 2.6 dB

 #define RADIOLIB_CC1101_LNA_GAIN_REDUCE_6_1_DB                 0b00010000  //  5     3                                 6.1 dB

 #define RADIOLIB_CC1101_LNA_GAIN_REDUCE_7_4_DB                 0b00011000  //  5     3                                 7.4 dB

 #define RADIOLIB_CC1101_LNA_GAIN_REDUCE_9_2_DB                 0b00100000  //  5     3                                 9.2 dB

 #define RADIOLIB_CC1101_LNA_GAIN_REDUCE_11_5_DB                0b00101000  //  5     3                                 11.5 dB

 #define RADIOLIB_CC1101_LNA_GAIN_REDUCE_14_6_DB                0b00110000  //  5     3                                 14.6 dB

 #define RADIOLIB_CC1101_LNA_GAIN_REDUCE_17_1_DB                0b00111000  //  5     3                                 17.1 dB

 #define RADIOLIB_CC1101_MAGN_TARGET_24_DB                      0b00000000  //  2     0     average amplitude target for filter: 24 dB

 #define RADIOLIB_CC1101_MAGN_TARGET_27_DB                      0b00000001  //  2     0                                          27 dB

 #define RADIOLIB_CC1101_MAGN_TARGET_30_DB                      0b00000010  //  2     0                                          30 dB

 #define RADIOLIB_CC1101_MAGN_TARGET_33_DB                      0b00000011  //  2     0                                          33 dB (default)

 #define RADIOLIB_CC1101_MAGN_TARGET_36_DB                      0b00000100  //  2     0                                          36 dB

 #define RADIOLIB_CC1101_MAGN_TARGET_38_DB                      0b00000101  //  2     0                                          38 dB

 #define RADIOLIB_CC1101_MAGN_TARGET_40_DB                      0b00000110  //  2     0                                          40 dB

 #define RADIOLIB_CC1101_MAGN_TARGET_42_DB                      0b00000111  //  2     0                                          42 dB


 // CC1101_REG_AGCCTRL1

 #define RADIOLIB_CC1101_AGC_LNA_PRIORITY_LNA2                  0b00000000  //  6     6     LNA priority setting: LNA2 first

 #define RADIOLIB_CC1101_AGC_LNA_PRIORITY_LNA                   0b01000000  //  6     6                           LNA first (default)

 #define RADIOLIB_CC1101_CARRIER_SENSE_REL_THR_OFF              0b00000000  //  5     4     RSSI relative change to assert carrier sense: disabled (default)

 #define RADIOLIB_CC1101_CARRIER_SENSE_REL_THR_6_DB             0b00010000  //  5     4                                                   6 dB

 #define RADIOLIB_CC1101_CARRIER_SENSE_REL_THR_10_DB            0b00100000  //  5     4                                                   10 dB

 #define RADIOLIB_CC1101_CARRIER_SENSE_REL_THR_14_DB            0b00110000  //  5     4                                                   14 dB

 #define RADIOLIB_CC1101_CARRIER_SENSE_ABS_THR                  0x00        //  3     0     RSSI threshold to assert carrier sense in 2s compliment, Thr = MAGN_TARGET + CARRIER_SENSE_ABS_TH [dB]


 // CC1101_REG_AGCCTRL0

 #define RADIOLIB_CC1101_HYST_LEVEL_NONE                        0b00000000  //  7     6     AGC hysteresis level: none

 #define RADIOLIB_CC1101_HYST_LEVEL_LOW                         0b01000000  //  7     6                           low

 #define RADIOLIB_CC1101_HYST_LEVEL_MEDIUM                      0b10000000  //  7     6                           medium (default)

 #define RADIOLIB_CC1101_HYST_LEVEL_HIGH                        0b11000000  //  7     6                           high

 #define RADIOLIB_CC1101_WAIT_TIME_8_SAMPLES                    0b00000000  //  5     4     AGC wait time: 8 samples

 #define RADIOLIB_CC1101_WAIT_TIME_16_SAMPLES                   0b00010000  //  5     4                    16 samples (default)

 #define RADIOLIB_CC1101_WAIT_TIME_24_SAMPLES                   0b00100000  //  5     4                    24 samples

 #define RADIOLIB_CC1101_WAIT_TIME_32_SAMPLES                   0b00110000  //  5     4                    32 samples

 #define RADIOLIB_CC1101_AGC_FREEZE_NEVER                       0b00000000  //  3     2     freeze AGC gain: never (default)

 #define RADIOLIB_CC1101_AGC_FREEZE_SYNC_WORD                   0b00000100  //  3     2                      when sync word is found

 #define RADIOLIB_CC1101_AGC_FREEZE_MANUAL_A                    0b00001000  //  3     2                      manually freeze analog control

 #define RADIOLIB_CC1101_AGC_FREEZE_MANUAL_AD                   0b00001100  //  3     2                      manually freeze analog and digital control

 #define RADIOLIB_CC1101_FILTER_LENGTH_8                        0b00000000  //  1     0     averaging length for channel filter: 8 samples

 #define RADIOLIB_CC1101_FILTER_LENGTH_16                       0b00000001  //  1     0                                          16 samples (default)

 #define RADIOLIB_CC1101_FILTER_LENGTH_32                       0b00000010  //  1     0                                          32 samples

 #define RADIOLIB_CC1101_FILTER_LENGTH_64                       0b00000011  //  1     0                                          64 samples

 #define RADIOLIB_CC1101_ASK_OOK_BOUNDARY_4_DB                  0b00000000  //  1     0     ASK/OOK decision boundary: 4 dB

 #define RADIOLIB_CC1101_ASK_OOK_BOUNDARY_8_DB                  0b00000001  //  1     0                                8 dB (default)

 #define RADIOLIB_CC1101_ASK_OOK_BOUNDARY_12_DB                 0b00000010  //  1     0                                12 dB

 #define RADIOLIB_CC1101_ASK_OOK_BOUNDARY_16_DB                 0b00000011  //  1     0                                16 dB


 // CC1101_REG_WOREVT1 + REG_WOREVT0

 #define RADIOLIB_CC1101_EVENT0_TIMEOUT_MSB                     0x87        //  7     0     EVENT0 timeout: t_event0 = (750 / f(XOSC)) * EVENT0_TIMEOUT * 2^(5 * WOR_RES) [s]

 #define RADIOLIB_CC1101_EVENT0_TIMEOUT_LSB                     0x6B        //  7     0         default value for 26 MHz crystal: 1.0 s


 // CC1101_REG_WORCTRL

 #define RADIOLIB_CC1101_RC_POWER_UP                            0b00000000  //  7     7     power up RC oscillator

 #define RADIOLIB_CC1101_RC_POWER_DOWN                          0b10000000  //  7     7     power down RC oscillator

 #define RADIOLIB_CC1101_EVENT1_TIMEOUT_4                       0b00000000  //  6     4     EVENT1 timeout: 4 RC periods

 #define RADIOLIB_CC1101_EVENT1_TIMEOUT_6                       0b00010000  //  6     4                     6 RC periods

 #define RADIOLIB_CC1101_EVENT1_TIMEOUT_8                       0b00100000  //  6     4                     8 RC periods

 #define RADIOLIB_CC1101_EVENT1_TIMEOUT_12                      0b00110000  //  6     4                     12 RC periods

 #define RADIOLIB_CC1101_EVENT1_TIMEOUT_16                      0b01000000  //  6     4                     16 RC periods

 #define RADIOLIB_CC1101_EVENT1_TIMEOUT_24                      0b01010000  //  6     4                     24 RC periods

 #define RADIOLIB_CC1101_EVENT1_TIMEOUT_32                      0b01100000  //  6     4                     32 RC periods

 #define RADIOLIB_CC1101_EVENT1_TIMEOUT_48                      0b01110000  //  6     4                     48 RC periods (default)

 #define RADIOLIB_CC1101_RC_CAL_OFF                             0b00000000  //  3     3     disable RC oscillator calibration

 #define RADIOLIB_CC1101_RC_CAL_ON                              0b00001000  //  3     3     enable RC oscillator calibration (default)

 #define RADIOLIB_CC1101_WOR_RES_1                              0b00000000  //  1     0     EVENT0 resolution: 1 period (default)

 #define RADIOLIB_CC1101_WOR_RES_2_5                            0b00000001  //  1     0                        2^5 periods

 #define RADIOLIB_CC1101_WOR_RES_2_10                           0b00000010  //  1     0                        2^10 periods

 #define RADIOLIB_CC1101_WOR_RES_2_15                           0b00000011  //  1     0                        2^15 periods


 // CC1101_REG_FREND1

 #define RADIOLIB_CC1101_LNA_CURRENT                            0x01        //  7     6     front-end LNA PTAT current output adjustment

 #define RADIOLIB_CC1101_LNA2MIX_CURRENT                        0x01        //  5     4     front-end PTAT output adjustment

 #define RADIOLIB_CC1101_LODIV_BUF_CURRENT_RX                   0x01        //  3     2     Rx LO buffer current adjustment

 #define RADIOLIB_CC1101_MIX_CURRENT                            0x02        //  1     0     mixer current adjustment


 // CC1101_REG_FREND0

 #define RADIOLIB_CC1101_LODIV_BUF_CURRENT_TX                   0x01        //  5     4     Tx LO buffer current adjustment

 #define RADIOLIB_CC1101_PA_POWER                               0x00        //  2     0     set power amplifier power according to PATABLE


 // CC1101_REG_FSCAL3

 #define RADIOLIB_CC1101_CHP_CURR_CAL_OFF                       0b00000000  //  5     4     disable charge pump calibration

 #define RADIOLIB_CC1101_CHP_CURR_CAL_ON                        0b00100000  //  5     4     enable charge pump calibration (default)

 #define RADIOLIB_CC1101_FSCAL3                                 0x09        //  3     0     charge pump output current: I_out = I_0 * 2^(FSCAL3/4) [A]


 // CC1101_REG_FSCAL2

 #define RADIOLIB_CC1101_VCO_CORE_LOW                           0b00000000  //  5     5     VCO: low (default)

 #define RADIOLIB_CC1101_VCO_CORE_HIGH                          0b00100000  //  5     5          high

 #define RADIOLIB_CC1101_FSCAL2                                 0x0A        //  4     0     VCO current result/override


 // CC1101_REG_FSCAL1

 #define RADIOLIB_CC1101_FSCAL1                                 0x20        //  5     0     capacitor array setting for coarse VCO tuning


 // CC1101_REG_FSCAL0

 #define RADIOLIB_CC1101_FSCAL0                                 0x0D        //  6     0     frequency synthesizer calibration setting


 // CC1101_REG_RCCTRL1

 #define RADIOLIB_CC1101_RCCTRL1                                0x41        //  6     0     RC oscillator configuration


 // CC1101_REG_RCCTRL0

 #define RADIOLIB_CC1101_RCCTRL0                                0x00        //  6     0     RC oscillator configuration


 // CC1101_REG_PTEST

 #define RADIOLIB_CC1101_TEMP_SENS_IDLE_OFF                     0x7F        //  7     0     temperature sensor will not be available in idle mode (default)

 #define RADIOLIB_CC1101_TEMP_SENS_IDLE_ON                      0xBF        //  7     0     temperature sensor will be available in idle mode


 // CC1101_REG_TEST0

 #define RADIOLIB_CC1101_VCO_SEL_CAL_OFF                        0b00000000  //  1     1     disable VCO selection calibration stage

 #define RADIOLIB_CC1101_VCO_SEL_CAL_ON                         0b00000010  //  1     1     enable VCO selection calibration stage


 // CC1101_REG_PARTNUM

 #define RADIOLIB_CC1101_PARTNUM                                0x00


 // CC1101_REG_VERSION

 #define RADIOLIB_CC1101_VERSION_CURRENT                        0x14

 #define RADIOLIB_CC1101_VERSION_LEGACY                         0x04

 #define RADIOLIB_CC1101_VERSION_CLONE                          0x17


 // CC1101_REG_MARCSTATE

 #define RADIOLIB_CC1101_MARC_STATE_SLEEP                       0x00        //  4     0     main radio control state: sleep

 #define RADIOLIB_CC1101_MARC_STATE_IDLE                        0x01        //  4     0                               idle

 #define RADIOLIB_CC1101_MARC_STATE_XOFF                        0x02        //  4     0                               XOFF

 #define RADIOLIB_CC1101_MARC_STATE_VCOON_MC                    0x03        //  4     0                               VCOON_MC

 #define RADIOLIB_CC1101_MARC_STATE_REGON_MC                    0x04        //  4     0                               REGON_MC

 #define RADIOLIB_CC1101_MARC_STATE_MANCAL                      0x05        //  4     0                               MANCAL

 #define RADIOLIB_CC1101_MARC_STATE_VCOON                       0x06        //  4     0                               VCOON

 #define RADIOLIB_CC1101_MARC_STATE_REGON                       0x07        //  4     0                               REGON

 #define RADIOLIB_CC1101_MARC_STATE_STARTCAL                    0x08        //  4     0                               STARTCAL

 #define RADIOLIB_CC1101_MARC_STATE_BWBOOST                     0x09        //  4     0                               BWBOOST

 #define RADIOLIB_CC1101_MARC_STATE_FS_LOCK                     0x0A        //  4     0                               FS_LOCK

 #define RADIOLIB_CC1101_MARC_STATE_IFADCON                     0x0B        //  4     0                               IFADCON

 #define RADIOLIB_CC1101_MARC_STATE_ENDCAL                      0x0C        //  4     0                               ENDCAL

 #define RADIOLIB_CC1101_MARC_STATE_RX                          0x0D        //  4     0                               RX

 #define RADIOLIB_CC1101_MARC_STATE_RX_END                      0x0E        //  4     0                               RX_END

 #define RADIOLIB_CC1101_MARC_STATE_RX_RST                      0x0F        //  4     0                               RX_RST

 #define RADIOLIB_CC1101_MARC_STATE_TXRX_SWITCH                 0x10        //  4     0                               TXRX_SWITCH

 #define RADIOLIB_CC1101_MARC_STATE_RXFIFO_OVERFLOW             0x11        //  4     0                               RXFIFO_OVERFLOW

 #define RADIOLIB_CC1101_MARC_STATE_FSTXON                      0x12        //  4     0                               FSTXON

 #define RADIOLIB_CC1101_MARC_STATE_TX                          0x13        //  4     0                               TX

 #define RADIOLIB_CC1101_MARC_STATE_TX_END                      0x14        //  4     0                               TX_END

 #define RADIOLIB_CC1101_MARC_STATE_RXTX_SWITCH                 0x15        //  4     0                               RXTX_SWITCH

 #define RADIOLIB_CC1101_MARC_STATE_TXFIFO_UNDERFLOW            0x16        //  4     0                               TXFIFO_UNDERFLOW


 // CC1101_REG_WORTIME1 + REG_WORTIME0

 #define RADIOLIB_CC1101_WORTIME_MSB                            0x00        //  7     0     WOR timer value

 #define RADIOLIB_CC1101_WORTIME_LSB                            0x00        //  7     0


 // CC1101_REG_PKTSTATUS

 #define RADIOLIB_CC1101_CRC_OK                                 0b10000000  //  7     7     CRC check passed

 #define RADIOLIB_CC1101_CRC_ERROR                              0b00000000  //  7     7     CRC check failed

 #define RADIOLIB_CC1101_CS                                     0b01000000  //  6     6     carrier sense

 #define RADIOLIB_CC1101_PQT_REACHED                            0b00100000  //  5     5     preamble quality reached

 #define RADIOLIB_CC1101_CCA                                    0b00010000  //  4     4     channel clear

 #define RADIOLIB_CC1101_SFD                                    0b00001000  //  3     3     start of frame delimiter - sync word received

 #define RADIOLIB_CC1101_GDO2_ACTIVE                            0b00000100  //  2     2     GDO2 is active/asserted

 #define RADIOLIB_CC1101_GDO0_ACTIVE                            0b00000001  //  0     0     GDO0 is active/asserted


 //Defaults

 #define RADIOLIB_CC1101_DEFAULT_FREQ                           434.0

 #define RADIOLIB_CC1101_DEFAULT_BR                             4.8

 #define RADIOLIB_CC1101_DEFAULT_FREQDEV                        5.0

 #define RADIOLIB_CC1101_DEFAULT_RXBW                           135.0

 #define RADIOLIB_CC1101_DEFAULT_POWER                          10

 #define RADIOLIB_CC1101_DEFAULT_PREAMBLELEN                    16

 #define RADIOLIB_CC1101_DEFAULT_SW                             {0x12, 0xAD}

 #define RADIOLIB_CC1101_DEFAULT_SW_LEN                         2


 class CC1101: public PhysicalLayer {

   public:

     // introduce PhysicalLayer overloads

     using PhysicalLayer::transmit;

     using PhysicalLayer::receive;

     using PhysicalLayer::startTransmit;

     using PhysicalLayer::readData;


     CC1101(Module* module);


     Module* getMod();


     // basic methods


     int16_t begin(

       float freq = RADIOLIB_CC1101_DEFAULT_FREQ,

       float br = RADIOLIB_CC1101_DEFAULT_BR,

       float freqDev = RADIOLIB_CC1101_DEFAULT_FREQDEV,

       float rxBw = RADIOLIB_CC1101_DEFAULT_RXBW,

       int8_t power = RADIOLIB_CC1101_DEFAULT_POWER,

       uint8_t preambleLength = RADIOLIB_CC1101_DEFAULT_PREAMBLELEN);


     int16_t transmit(uint8_t* data, size_t len, uint8_t addr = 0) override;


     int16_t receive(uint8_t* data, size_t len) override;


     int16_t standby() override;


     int16_t transmitDirect(uint32_t frf = 0) override;


     int16_t receiveDirect() override;


     int16_t transmitDirectAsync(uint32_t frf = 0);


     int16_t receiveDirectAsync();


     int16_t packetMode();


     // interrupt methods


     void setGdo0Action(void (*func)(void), RADIOLIB_INTERRUPT_STATUS dir = RISING);


     void clearGdo0Action();


     void setGdo2Action(void (*func)(void), RADIOLIB_INTERRUPT_STATUS dir = FALLING);


     void clearGdo2Action();


     int16_t startTransmit(uint8_t* data, size_t len, uint8_t addr = 0) override;


     int16_t finishTransmit() override;


     int16_t startReceive();


     int16_t readData(uint8_t* data, size_t len) override;


     // configuration methods


     int16_t setFrequency(float freq);


     int16_t setBitRate(float br);


     int16_t setRxBandwidth(float rxBw);


     int16_t setFrequencyDeviation(float freqDev) override;


     int16_t getFrequencyDeviation(float *freqDev);


     int16_t setOutputPower(int8_t power);


     int16_t setSyncWord(uint8_t syncH, uint8_t syncL, uint8_t maxErrBits = 0, bool requireCarrierSense = false);


     int16_t setSyncWord(uint8_t* syncWord, uint8_t len, uint8_t maxErrBits = 0, bool requireCarrierSense = false);


     int16_t setPreambleLength(uint8_t preambleLength);


     int16_t setNodeAddress(uint8_t nodeAddr, uint8_t numBroadcastAddrs = 0);


     int16_t disableAddressFiltering();


     int16_t setOOK(bool enableOOK);


     float getRSSI();


    uint8_t getLQI() const;


     size_t getPacketLength(bool update = true) override;


     int16_t fixedPacketLengthMode(uint8_t len = RADIOLIB_CC1101_MAX_PACKET_LENGTH);


     int16_t variablePacketLengthMode(uint8_t maxLen = RADIOLIB_CC1101_MAX_PACKET_LENGTH);


     int16_t enableSyncWordFiltering(uint8_t maxErrBits = 0, bool requireCarrierSense = false);


     int16_t disableSyncWordFiltering(bool requireCarrierSense = false);


     int16_t setCrcFiltering(bool crcOn = true);


     int16_t setPromiscuousMode(bool promiscuous = true);


     bool getPromiscuousMode();


     int16_t setDataShaping(uint8_t sh) override;


     int16_t setEncoding(uint8_t encoding) override;


     void setRfSwitchPins(RADIOLIB_PIN_TYPE rxEn, RADIOLIB_PIN_TYPE txEn);


     uint8_t randomByte();


     int16_t getChipVersion();


     #if !defined(RADIOLIB_EXCLUDE_DIRECT_RECEIVE)

     void setDirectAction(void (*func)(void));


     void readBit(RADIOLIB_PIN_TYPE pin);

     #endif


     int16_t setDIOMapping(RADIOLIB_PIN_TYPE pin, uint8_t value);


   #if !defined(RADIOLIB_GODMODE) && !defined(RADIOLIB_LOW_LEVEL)

     protected:

   #endif

       Module* _mod;


       // SPI read overrides to set bit for burst write and status registers access

       int16_t SPIgetRegValue(uint8_t reg, uint8_t msb = 7, uint8_t lsb = 0);

       int16_t SPIsetRegValue(uint8_t reg, uint8_t value, uint8_t msb = 7, uint8_t lsb = 0, uint8_t checkInterval = 2);

       void SPIreadRegisterBurst(uint8_t reg, uint8_t numBytes, uint8_t* inBytes);

       uint8_t SPIreadRegister(uint8_t reg);

       void SPIwriteRegisterBurst(uint8_t reg, uint8_t* data, size_t len);

       void SPIwriteRegister(uint8_t reg, uint8_t data);


       void SPIsendCommand(uint8_t cmd);


   #if !defined(RADIOLIB_GODMODE)

     protected:

   #endif


     float _freq = RADIOLIB_CC1101_DEFAULT_FREQ;

     float _br = RADIOLIB_CC1101_DEFAULT_BR;

     uint8_t _rawRSSI = 0;

     uint8_t _rawLQI = 0;

     uint8_t _modulation = RADIOLIB_CC1101_MOD_FORMAT_2_FSK;


     size_t _packetLength = 0;

     bool _packetLengthQueried = false;

     uint8_t _packetLengthConfig = RADIOLIB_CC1101_LENGTH_CONFIG_VARIABLE;


     bool _promiscuous = false;

     bool _crcOn = true;

     bool _directMode = true;


     int8_t _power = RADIOLIB_CC1101_DEFAULT_POWER;


     int16_t config();

     int16_t transmitDirect(bool sync, uint32_t frf);

     int16_t receiveDirect(bool sync);

     int16_t directMode(bool sync);

     static void getExpMant(float target, uint16_t mantOffset, uint8_t divExp, uint8_t expMax, uint8_t& exp, uint8_t& mant);

     int16_t setPacketMode(uint8_t mode, uint16_t len);

 };


 #endif

CC1101
Control class for CC1101 module.
Definition: CC1101.h:517

CC1101::setFrequencyDeviation
int16_t setFrequencyDeviation(float freqDev) override
Sets frequency deviation. Allowed values range from 1.587 to 380.8 kHz.
Definition: CC1101.cpp:502

CC1101::getPacketLength
size_t getPacketLength(bool update=true) override
Query modem for the packet length of received payload.
Definition: CC1101.cpp:770

CC1101::setDIOMapping
int16_t setDIOMapping(RADIOLIB_PIN_TYPE pin, uint8_t value)
Configure DIO pin mapping to get a given signal on a DIO pin (if available).
Definition: CC1101.cpp:939

CC1101::transmitDirect
int16_t transmitDirect(uint32_t frf=0) override
Starts direct mode transmission.
Definition: CC1101.cpp:169

CC1101::setPromiscuousMode
int16_t setPromiscuousMode(bool promiscuous=true)
Set modem in "sniff" mode: no packet filtering (e.g., no preamble, sync word, address,...
Definition: CC1101.cpp:819

CC1101::getChipVersion
int16_t getChipVersion()
Read version SPI register. Should return CC1101_VERSION_LEGACY (0x04) or CC1101_VERSION_CURRENT (0x14...
Definition: CC1101.cpp:925

CC1101::setRxBandwidth
int16_t setRxBandwidth(float rxBw)
Sets receiver bandwidth. Allowed values range from 58.0 to 812.0 kHz.
Definition: CC1101.cpp:481

CC1101::packetMode
int16_t packetMode()
Stops direct mode. It is required to call this method to switch from direct transmissions to packet-b...
Definition: CC1101.cpp:220

CC1101::setSyncWord
int16_t setSyncWord(uint8_t syncH, uint8_t syncL, uint8_t maxErrBits=0, bool requireCarrierSense=false)
Sets 16-bit sync word as a two byte value.
Definition: CC1101.cpp:653

CC1101::setRfSwitchPins
void setRfSwitchPins(RADIOLIB_PIN_TYPE rxEn, RADIOLIB_PIN_TYPE txEn)
Some modules contain external RF switch controlled by two pins. This function gives RadioLib control ...
Definition: CC1101.cpp:901

CC1101::getRSSI
float getRSSI()
Gets RSSI (Recorded Signal Strength Indicator) of the last received packet.
Definition: CC1101.cpp:743

CC1101::disableSyncWordFiltering
int16_t disableSyncWordFiltering(bool requireCarrierSense=false)
Disable preamble and sync word filtering and generation.
Definition: CC1101.cpp:805

CC1101::variablePacketLengthMode
int16_t variablePacketLengthMode(uint8_t maxLen=RADIOLIB_CC1101_MAX_PACKET_LENGTH)
Set modem in variable packet length mode.
Definition: CC1101.cpp:788

CC1101::setDirectAction
void setDirectAction(void(*func)(void))
Set interrupt service routine function to call when data bit is receveid in direct mode.
Definition: CC1101.cpp:930

CC1101::getLQI
uint8_t getLQI() const
Gets LQI (Link Quality Indicator) of the last received packet.
Definition: CC1101.cpp:766

CC1101::readBit
void readBit(RADIOLIB_PIN_TYPE pin)
Function to read and process data bit in direct reception mode.
Definition: CC1101.cpp:934

CC1101::CC1101
CC1101(Module *module)
Default constructor.
Definition: CC1101.cpp:4

CC1101::setNodeAddress
int16_t setNodeAddress(uint8_t nodeAddr, uint8_t numBroadcastAddrs=0)
Sets node and broadcast addresses. Calling this method will also enable address filtering.
Definition: CC1101.cpp:693

CC1101::enableSyncWordFiltering
int16_t enableSyncWordFiltering(uint8_t maxErrBits=0, bool requireCarrierSense=false)
Enable sync word filtering and generation.
Definition: CC1101.cpp:792

CC1101::standby
int16_t standby() override
Sets the module to standby mode.
Definition: CC1101.cpp:160

CC1101::randomByte
uint8_t randomByte()
Get one truly random byte from RSSI noise.
Definition: CC1101.cpp:905

CC1101::setFrequency
int16_t setFrequency(float freq)
Sets carrier frequency. Allowed values are in bands 300.0 to 348.0 MHz, 387.0 to 464....
Definition: CC1101.cpp:435

CC1101::disableAddressFiltering
int16_t disableAddressFiltering()
Disables address filtering. Calling this method will also erase previously set addresses.
Definition: CC1101.cpp:704

CC1101::receiveDirectAsync
int16_t receiveDirectAsync()
Starts asynchronous direct mode reception.
Definition: CC1101.cpp:203

CC1101::setBitRate
int16_t setBitRate(float br)
Sets bit rate. Allowed values range from 0.025 to 600.0 kbps.
Definition: CC1101.cpp:461

CC1101::setCrcFiltering
int16_t setCrcFiltering(bool crcOn=true)
Enable CRC filtering and generation.
Definition: CC1101.cpp:809

CC1101::receiveDirect
int16_t receiveDirect() override
Starts direct mode reception.
Definition: CC1101.cpp:199

CC1101::transmit
int16_t transmit(__FlashStringHelper *fstr, uint8_t addr=0)
Arduino Flash String transmit method.
Definition: PhysicalLayer.cpp:12

CC1101::setEncoding
int16_t setEncoding(uint8_t encoding) override
Sets transmission encoding. Allowed values are RADIOLIB_ENCODING_NRZ, RADIOLIB_ENCODING_MANCHESTER,...
Definition: CC1101.cpp:877

CC1101::clearGdo0Action
void clearGdo0Action()
Clears interrupt service routine to call when GDO0 activates.
Definition: CC1101.cpp:231

CC1101::getFrequencyDeviation
int16_t getFrequencyDeviation(float *freqDev)
Gets frequency deviation.
Definition: CC1101.cpp:529

CC1101::setOutputPower
int16_t setOutputPower(int8_t power)
Sets output power. Allowed values are -30, -20, -15, -10, 0, 5, 7 or 10 dBm.
Definition: CC1101.cpp:554

CC1101::setGdo2Action
void setGdo2Action(void(*func)(void), RADIOLIB_INTERRUPT_STATUS dir=FALLING)
Sets interrupt service routine to call when GDO2 activates.
Definition: CC1101.cpp:235

CC1101::clearGdo2Action
void clearGdo2Action()
Clears interrupt service routine to call when GDO0 activates.
Definition: CC1101.cpp:243

CC1101::setPreambleLength
int16_t setPreambleLength(uint8_t preambleLength)
Sets preamble length.
Definition: CC1101.cpp:658

CC1101::fixedPacketLengthMode
int16_t fixedPacketLengthMode(uint8_t len=RADIOLIB_CC1101_MAX_PACKET_LENGTH)
Set modem in fixed packet length mode.
Definition: CC1101.cpp:784

CC1101::setDataShaping
int16_t setDataShaping(uint8_t sh) override
Sets Gaussian filter bandwidth-time product that will be used for data shaping. Allowed value is RADI...
Definition: CC1101.cpp:858

CC1101::setGdo0Action
void setGdo0Action(void(*func)(void), RADIOLIB_INTERRUPT_STATUS dir=RISING)
Sets interrupt service routine to call when GDO0 activates.
Definition: CC1101.cpp:227

CC1101::readData
int16_t readData(String &str, size_t len=0)
Reads data that was received after calling startReceive method.
Definition: PhysicalLayer.cpp:61

CC1101::begin
int16_t begin(float freq=RADIOLIB_CC1101_DEFAULT_FREQ, float br=RADIOLIB_CC1101_DEFAULT_BR, float freqDev=RADIOLIB_CC1101_DEFAULT_FREQDEV, float rxBw=RADIOLIB_CC1101_DEFAULT_RXBW, int8_t power=RADIOLIB_CC1101_DEFAULT_POWER, uint8_t preambleLength=RADIOLIB_CC1101_DEFAULT_PREAMBLELEN)
Initialization method.
Definition: CC1101.cpp:12

CC1101::getPromiscuousMode
bool getPromiscuousMode()
Get whether the modem is in promiscuous mode: no packet filtering (e.g., no preamble,...
Definition: CC1101.cpp:854

CC1101::transmitDirectAsync
int16_t transmitDirectAsync(uint32_t frf=0)
Starts asynchronous direct mode transmission.
Definition: CC1101.cpp:173

CC1101::startTransmit
int16_t startTransmit(String &str, uint8_t addr=0)
Interrupt-driven Arduino String transmit method. Unlike the standard transmit method,...
Definition: PhysicalLayer.cpp:53

CC1101::finishTransmit
int16_t finishTransmit() override
Clean up after transmission is done.
Definition: CC1101.cpp:324

CC1101::startReceive
int16_t startReceive()
Interrupt-driven receive method. GDO0 will be activated when full packet is received.
Definition: CC1101.cpp:334

CC1101::setOOK
int16_t setOOK(bool enableOOK)
Enables/disables OOK modulation instead of FSK.
Definition: CC1101.cpp:714

CC1101::receive
int16_t receive(String &str, size_t len=0)
Arduino String receive method.
Definition: PhysicalLayer.cpp:104

Module
Implements all common low-level methods to control the wireless module. Every module class contains o...
Definition: Module.h:16

PhysicalLayer
Provides common interface for protocols that run on LoRa/FSK modules, such as RTTY or LoRaWAN....
Definition: PhysicalLayer.h:14

PhysicalLayer::transmit
int16_t transmit(__FlashStringHelper *fstr, uint8_t addr=0)
Arduino Flash String transmit method.
Definition: PhysicalLayer.cpp:12

PhysicalLayer::readData
int16_t readData(String &str, size_t len=0)
Reads data that was received after calling startReceive method.
Definition: PhysicalLayer.cpp:61

PhysicalLayer::startTransmit
int16_t startTransmit(String &str, uint8_t addr=0)
Interrupt-driven Arduino String transmit method. Unlike the standard transmit method,...
Definition: PhysicalLayer.cpp:53

PhysicalLayer::receive
int16_t receive(String &str, size_t len=0)
Arduino String receive method.
Definition: PhysicalLayer.cpp:104