Skip to content

Default configuration

Jump to bottom
jgromes edited this page Jul 4, 2020 · 18 revisions

This page shows all the parameters set by default to radio modules and wireless protocols. These parameters will be set after calling module/protocol begin() method with no arguments provided. Modules/protocols without default argument values are not listed.

NOTE: Only the parameters changed by RadioLib are listed here. In addition, the module/protocol may also have other parameters, configuration of which is not implemented in RadioLib. These are not listed on this page - consult the module datasheet or protocol specification.

Legend:

  • Begin method - parameters configurable via begin() method.
  • Other - parameters which are not part of the begin() method, but can be configured using some other method from the library public API.
  • Inaccessible - parameters which can not be changed by the user.
  • Equivalent to - pseudo-code of calls to configuration methods that will result in the same configuration as the default.

Modules

CC1101

  • Begin method:
    • Carrier frequency: 868.0 MHz
    • Bit rate: 4.8 kbps
    • Frequency deviation: 48.0 kHz (single-sideband)
    • Receiver bandwidth: 325.0 kHz
    • Output power: 0 dBm
    • Preamble length: 4 bytes
  • Other:
    • Data shaping B-T product: 0 (plain 2-FSK, no Gaussian filter applied)
    • Encoding: whitening (x^9 + x^5 + 1 polynomial)
    • Packet length mode: variable, maximum of CC1101_MAX_PACKET_LENGTH bytes (length byte included in packet)
    • Sync word: 0xD3 0x91, 0 error bits, carrier sense above threshold not required
  • Inaccessible:
    • none

Equivalent to:

CC1101::begin(868.0, 4.8, 48.0, 325.0, 0, 4);
CC1101::setDataShaping(0);
CC1101::setEncoding(2);
CC1101::variablePacketLengthMode(CC1101_MAX_PACKET_LENGTH);
CC1101::setSyncWord(0xD3, 0x91, 0, false);

nRF24

  • Begin method:
    • Carrier frequency: 2400 MHz
    • Data rate: 1000 kbps
    • Output power: -12 dBm
    • Address width: 5 bytes
  • Other:
    • CRC: enabled (16-bit CRC)
    • Auto-acknowledgement: enabled (all pipes)
  • Inaccessible:
    • Retries: 15
    • Retry delay: 1500 us
    • Dynamic payloads: enabled
    • Payload with ACK packets: disabled
    • Dynamic ACK: disabled

Equivalent to:

nRF24::begin(2400, 1000, -12, 5);
nRF24::setCrcFiltering(true);
nRF24::setAutoAck(true);

RF69/SX1231

  • Begin method:
    • Carrier frequency: 434.0 MHz
    • Bit rate: 48.0 kbps
    • Frequency deviation: 50.0 kHz (single-sideband)
    • Receiver bandwidth: 125.0 kHz
    • Output power: 13 dBm
  • Other:
    • Packet length mode: variable, maximum of RF69_MAX_PACKET_LENGTH bytes (length byte included in packet)
    • Sync word: 0x2D 0x01
    • Data shaping B-T product: 0 (plain 2-FSK, no Gaussian filter applied)
    • Encoding: NRZ (non-return to zero - no encoding)
    • CRC: enabled
    • Address filtering: disabled
    • AES encryption: disabled
  • Inaccessible:
    • Over-current protection: enabled
    • Automatically clear packet on CRC mismatch: enabled

Equivalent to (assuming RF69):

RF69::begin(434.0, 48.0, 50.0, 125.0, 13);
RF69::variablePacketLengthMode(RF69_MAX_PACKET_LENGTH);
uint8_t syncWord[] = {0x2D, 0x01};
RF69::setSyncWord(syncWord, 2);
RF69::setDataShaping(0);
RF69::setEncoding(0);
RF69::setCrcFiltering(true);
RF69::disableAddressFiltering();
RF69::disableAES();

Si443x/RFM2x

  • Begin method:
    • Carrier frequency: 434.0 MHz
    • Bit rate: 48.0 kbps
    • Frequency deviation: 50.0 kHz (single-sideband)
    • Receiver bandwidth: 181.1 kHz
    • Output power: 10 dBm
  • Other:
    • Sync word: 0x2D 0x01
    • Data shaping B-T product: 0 (plain 2-FSK, no Gaussian filter applied)
    • Encoding: NRZ (non-return to zero - no encoding)
  • Inaccessible:
    • Packet header: disabled
    • Broadcast address check: disabled

Equivalent to (assuming Si4432):

Si4432::begin(434.0, 48.0, 50.0, 181.1, 10);
uint8_t syncWord[] = {0x2D, 0x01};
Si443x::setSyncWord(syncWord, 2);
Si443x::setDataShaping(0);
Si443x::setEncoding(0);

SX126x - LoRa modem

  • Begin method:
    • Carrier frequency: 434.0 MHz
    • Bandwidth: 125.0 kHz (dual-sideband)
    • Spreading factor: 9
    • Coding rate: 4/7
    • Sync word: SX126X_SYNC_WORD_PRIVATE (0x12)
    • Output power: 14 dBm
    • Over-current protection: 60.0 mA
    • Preamble length: 8 symbols
    • TCXO reference voltage: 1.6 V (SX126x module with TCXO)
    • LDO regulator mode: disabled (SX126x module with DC-DC power supply)
  • Other:
    • DIO2 as RF switch control: enabled
    • LoRa header mode: explicit
    • LoRa CRC: enabled, 2 bytes
  • Inaccessible:
    • Number of CAD symbols: 8

Equivalent to:

SX126x::begin(434.0, 125.0, 9, 7, SX126X_SYNC_WORD_PRIVATE, 14, 60.0, 1.6, false);
SX126x::setDio2AsRfSwitch(true);
SX126x::explicitHeader();
SX126x::setCRC(2);

SX126x - FSK modem

  • Begin method:
    • Carrier frequency: 434.0 MHz
    • Bit rate: 48.0 kbps
    • Frequency deviation: 50.0 kHz (single-sideband)
    • Receiver bandwidth: 156.2 kHz
    • Output power: 14 dBm
    • Over-current protection: 60.0 mA
    • Preamble length: 16 bits
    • Data shaping B-T product: 0.5 (GFSK)
    • TCXO reference voltage: 1.6 V (SX126x module with TCXO)
    • LDO regulator mode: disabled (SX126x module with DC-DC power supply)
  • Other:
    • DIO2 as RF switch control: enabled
    • Sync word: 0x2D 0x01
    • Packet length mode: variable, maximum of SX126X_MAX_PACKET_LENGTH bytes (length byte included in packet)
    • Encoding: whitening (x^9 + x^5 + 1 polynomial with bit order reverse, initial LFSR state 0x01FF)
  • Inaccessible:
    • none

Equivalent to (assuming SX1268):

SX1268::beginFSK(434.0, 48.0, 156.2, 14, 60.0, 16, 0.5, false);
SX126x::setDio2AsRfSwitch(true);
uint8_t syncWord[] = {0x2D, 0x01};
SX126x::setSyncWord(syncWord, 2);
SX126x::variablePacketLengthMode(SX126X_MAX_PACKET_LENGTH);
SX126x::setWhitening(true, 0x01FF);

SX127x/RFM9x - LoRa modem

  • Begin method:
    • Carrier frequency: 434.0 MHz (for SX1276/77/78/79 and RFM96/98) or 915.0 MHz (for SX1272/73 and RFM95/97)
    • Bandwidth: 125.0 kHz (dual-sideband)
    • Spreading factor: 9
    • Coding rate: 4/7
    • Sync word: SX127X_SYNC_WORD (0x12)
    • Output power: 17 dBm
    • Over-current protection: 100 mA
    • Preamble length: 8 symbols
    • Gain: 0 (automatic gain control enabled)
  • Other:
    • none
  • Inaccessible:
    • LoRa header mode: explicit
    • Frequency hopping: disabled

Equivalent to (assuming SX1278):

SX1278::begin(434.0, 125.0, 9, 7, SX127X_SYNC_WORD, 17, 100, 8, 0);

SX127x/RFM9x - FSK modem

  • Begin method:
    • Carrier frequency: 434.0 MHz (for SX1276/77/78/79 and RFM96/98) or 915.0 MHz (for SX1272/73 and RFM95/97)
    • Bit rate: 48.0 kbps
    • Frequency deviation: 50.0 kHz (single-sideband)
    • Receiver bandwidth: 125.0 kHz
    • Output power: 13 dBm
    • Over-current protection: 100 mA
    • Preamble length: 16 bits
    • OOK modulation: disabled
  • Other:
    • Data shaping B-T product: 0.5 (GFSK)
    • Sync word: 0x2D 0x01
    • Packet length mode: variable, maximum of SX127X_MAX_PACKET_LENGTH bytes (length byte included in packet)
    • Encoding: whitening (x^9 + x^5 + 1 polynomial with bit order reverse, initial LFSR state 0x01FF)
    • Address filtering: disabled
    • RSSI measurement configuration: 2^(1 + 2) samples, offset 0 dBm
  • Inaccessible:
    • Automatically clear packet on CRC mismatch: enabled
    • Preamble polarity: 0x55 (start with 0)
    • Preamble detector: enabled, 2 bytes

Equivalent to (assuming SX1278):

SX1278::beginFSK(434.0, 48.0, 125.0, 13, 100, 16, false);
SX1278::setDataShaping(0.5);
uint8_t syncWord[] = {0x2D, 0x01};
SX127x::setSyncWord(syncWord, 2);
SX127x::variablePacketLengthMode(SX127X_MAX_PACKET_LENGTH);
SX127x::setEncoding(2);
SX127x::disableAddressFiltering();
SX127x::setRSSIConfig(2, 0);

SX128x - LoRa modem

  • Begin method:
    • Carrier frequency: 2400.0 MHz
    • Bandwidth: 812.5 kHz (dual-sideband)
    • Spreading factor: 9
    • Coding rate: 4/7, long interleaving disabled
    • Output power: 10 dBm
    • Preamble length: 12 symbols
  • Other:
    • LoRa header mode: explicit
    • LoRa CRC: enabled, 2 bytes
  • Inaccessible:
    • LDO regulator mode: disabled (SX128x module with DC-DC power supply)
    • Number of CAD symbols: 8

Equivalent to:

SX128x::begin(2400.0, 812.5, 9, 7, 10, 12);
SX128x::explicitHeader();
SX128x::setCRC(2);

SX128x - GFSK modem

  • Begin method:
    • Carrier frequency: 2400.0 MHz
    • Bit rate: 800 kbps
    • Frequency deviation: 400 kHz (single-sideband)
    • Output power: 10 dBm
    • Preamble length: 16 bits
    • Data shaping B-T product: 0.5 (GFSK)
  • Other:
    • CRC: enabled, 2 bytes, initial 0x1D0F, polynomial 0x1021
    • Sync word: 0x2D 0x01
    • Encoding: whitening
  • Inaccessible:
    • LDO regulator mode: disabled (SX128x module with DC-DC power supply)

Equivalent to:

SX128x::beginFSK(2400.0, 800, 400, 10, 16, 0.5);
SX128x::setCRC(2, 0x1D0F, 0x1021);
uint8_t syncWord[] = {0x2D, 0x01};
SX128x::setSyncWord(syncWord, 2);
SX128x::setEncoding(2);

SX128x - BLE modem

  • Begin method:
    • Carrier frequency: 2400.0 MHz
    • Bit rate: 800 kbps
    • Frequency deviation: 400 kHz (single-sideband)
    • Output power: 10 dBm
    • Data shaping B-T product: 0.5 (GFSK)
  • Other:
    • CRC: enabled, 3 bytes
    • Encoding: whitening
  • Inaccessible:
    • LDO regulator mode: disabled (SX128x module with DC-DC power supply)

Equivalent to:

SX128x::beginBLE(2400.0, 800, 400, 10, 0.5);
SX128x::setCRC(3);
SX128x::setEncoding(2);

SX128x - FLRC modem

  • Begin method:
    • Carrier frequency: 2400.0 MHz
    • Bit rate: 600 kbps
    • FLRC coding rate: 3/4
    • Output power: 10 dBm
    • Preamble length: 16 bits
    • Data shaping B-T product: 0.5
  • Other:
    • CRC: enabled, 2 bytes, initial 0x1D0F, polynomial 0x1021
    • Sync word: 0x2D 0x01 0x4B 0x1D
    • Encoding: NRZ (non-return to zero - no encoding)

Protocols

Clone this wiki locally