Documentation
Onboarding
Getting Started
Power & Battery
Hardware & Components
Build & Assembly
Radio & RF Design
Frequencies & Regulations
Firmware & Software
USB & Connectivity
GPS & Navigation
Morse & Communication
Modes & Operation
Field Operations & Rescue
Building Effectively
Build Variants
Project & Reference
Docs Radio & RF Design SX1262 Registers

SX1262 Registers

Edit on GitHub

The SX1262 register map essentials: the configuration commands the firmware uses and the ones that cause most integration errors.

SX1262 Registers

The SX1262 is configured through SPI commands, not bare register writes. This page lists the commands the firmware actually uses and the traps around them.

The command surface

CommandPurpose
SetStandbyEnter standby mode
SetFrequencySet the carrier frequency
SetPacketTypeLoRa or FSK
SetModulationParamsBandwidth, spreading factor, coding rate
SetTxParamsPower level and ramp
SetPacketParamsPreamble, payload length, CRC
SetDioIrqParamsWhich events raise the interrupt
WriteBuffer / ReadBufferPayload data
SetRx / SetTxStart reception or transmission
GetRssiInstRead the instantaneous RSSI (see Firmware RSSI Measurement)

The busy line trap

The SX1262 requires the host to wait while it is busy after every command: poll the BUSY pin before sending the next command. Ignoring this is the single most common SX1262 integration error, and its symptom is maddening: commands seem to work but the radio never transmits correctly. See E22 Module Pinout for the pin.

The frequency trap

SetFrequency takes a 32-bit value in units of the crystal reference (the “step”). The firmware computes it as:

CODE
freq = frequency_Hz / (32 MHz / 2^25)

Using the wrong reference (the bare chip datasheet uses 32 MHz; some modules change it) shifts the radio off-frequency. A beacon that transmits but cannot be heard on the expected channel is usually this.

Power and ramp

SetTxParams sets both the power (in dBm) and the ramp time. The E22 module’s PA configuration must match the module variant; the E22 Radio Module Guide documents the values for the 30 dBm modules.