Datasheet LR2012, LR2021, LR2022 (Semtech) - 3

link to page 250 link to page 28 link to page 171 link to page 237 link to page 165 link to page 209 link to page 214 link to page 153 link to page 211 link to page 235 link to page 43 link to page 48 link to page 53 link to page 64 link to page 233 link to page 233 link to page 40
LR2021/LR2022/LR2012 DISCLAIMER 1 Long Range-Frequency Hopping Spread Spectrum
(LR-FHSS) is a high link-budget, high-performance technology combining the benefits of a modulation employing low energy per bit and advanced frequency hopping schemes to achieve improved coexistence, spectral efficiency and sensitivity. Semtech Corp. holds patents directed to aspects of the LR-FHSS technology. Your use of LR-FHSS software made available by Semtech Corp. or its affiliates does not grant any rights to their patents for LR-FHSS technology. Rights under Semtech patents may be available via various mechanisms, including by purchasing Semtech SX1261, SX1262, SX1268, LR1110, LR1120, LR1121, LR2012, LR2021 or LR2022 semiconductor devices, or their authorized counterparts from Semtech, or its affiliates, or their respective licensees.
DISCLAIMER 2
Semtech’s products are designed to be used in connection with qualified
Bluetooth
® products and applications but are not certified or qualified Bluetooth products.
Revision History Version Date Changes and/or Modifications
0.2 June 2025 Preliminary release 1.1 October 2025 Final datasheet: Clarifications throughout Expanded LR2021 datasheet to cover LR2022 and LR2012 specifications, also modified: • Figure 1-9 description, to specify +12 dBm is the power setting. • FLRC BW values in Table 18-1, Table 18-3 and Section 18.4.1 • Section 9.3 • Added commands: 9.9.12 SetLoraTxSync • Added 11.1.3 (G)FSK Limitations • Modified Figure 23-1: LR2021/LR2022 Reference Design Schematic 2.0 March 2026 • Added expected degradation using SIMO with metal ic RF shield in Section 23.1 • Electrical spec conditions have been clarified to “no shield, SIMO” • Modified IDDSL1 value in Table 3-4 • Modified BRFLRC Max value in Table 3-8 • Modified ZW_R2_S, ZW_R3_S, ZWLR1 Typ values in Table 3-10 • Added 0.5 dB to al sensitivity numbers in Table 3-13 and Table 3-18 • Added Section 22.3 Firmware Patch RAM (PRAM)
LR2021/LR2022/LR2012 3 of 250 Final Datasheet Rev. 2.2 Semtech DS.LR20xx 29/07/26
www.semtech.com
Proprietary & Confidential
Document Outline 1. Chip Description 1.1 LR2021 1.2 LR2022 1.3 LR2012 1.4 Receiver RF Path 1.5 Transmitter RF Path 1.5.1 Low Frequency Power Amplifier (LF PA) (LR20xx) 1.5.2 High Frequency Power Amplifier (HF PA) (LR2021/22) 1.5.3 Direct-Tie Implementation (LR20xx) 1.6 Frequency Synthesizer 1.7 Modem 1.8 Power Distribution 1.8.1 Power-On Reset and Brown-Out Reset 1.8.2 Low Battery Detector 1.8.3 Over Current Protection 1.8.4 Power Supply Mode 1.9 Clock Sources 1.9.1 32 kHz RC Oscillator 1.9.2 32 MHz Crystal 1.9.3 32 MHz TCXO 1.9.4 External Clock Reference Inputs 1.9.5 Output Clock 2. Pin Connection 2.1 I/O Description 3. Specifications (LR20xx) 3.1 Absolute Maximum Ratings 3.2 Operating Range 3.3 ESD Protection and Latch-up 3.4 Electrical Specifications 3.4.1 Power Consumption 3.4.2 General Specifications 3.4.3 Receive Mode Specifications 3.4.4 Transmit Mode Specifications 3.5 Reference Oscillator Crystal Specification 3.6 SIMO Inductor Specification 3.7 Digital I/O and Interface Specifications 3.7.1 Digital I/O Specifications 3.7.2 SPI Interface Specifications 4. Chip Modes (LR20xx) 4.1 Chip Mode State Diagram 4.2 Reset 4.3 Start-up and Boot Calibration Sequence 4.4 Chip Modes 4.4.1 Sleep 4.4.2 Standby RC / XOSC 4.4.3 Frequency Synthesis (FS) 4.4.4 Receive (Rx) 4.4.5 Transmit (Tx) 5. Host Interface 5.1 Hardware Interface (LR20xx) 5.1.1 DIO Pins 5.1.2 SPI Interface 5.2 Busy Line Control (LR20xx) 5.3 Data FIFO (LR20xx) 5.3.1 Rx Data FIFO 5.3.2 Tx Data FIFO 5.3.3 Extending the Data FIFOs 5.4 Host-Command Interface (LR20xx) 5.4.1 Read Write Command 5.5 DIO Rx / Tx Triggers (LR20xx) 5.6 Host Commands Summary 5.6.1 Direct Radio FIFO Read/Write Commands (LR20xx) 5.6.2 Register / Memory Access Operations (LR20xx) 5.6.3 System Configuration / Status Operations (LR20xx) 5.6.4 Radio Configuration / Status Operations (LR20xx except FLRC Commands) 5.7 Host Interrupts (LR20xx) 6. Chip Control Commands (LR20xx) 6.1 Direct Radio FIFO Read/Write 6.1.1 ReadRadioRxFifo 6.1.2 WriteRadioTxFifo 6.2 Register / Memory Access Operations 6.2.1 WriteRegMem32 6.2.2 WriteRegMemMask32 6.2.3 ReadRegMem32 6.3 Chip Mode Control 6.3.1 SetSleep 6.3.2 SetStandby 6.3.3 SetFs 6.3.4 SetAdditionalRegToRetain 6.3.5 SetRx 6.3.6 SetTx 6.3.7 SetRxTxFallbackMode 6.3.8 SetRxDutyCycle 6.3.9 SetAutoRxTx 6.3.10 StopTimeoutOnPreamble 6.3.11 SetLoraCadParams 6.3.12 SetLoraCAD 6.3.13 SetCad 6.3.14 SetCadParams 6.3.15 SetCca 6.3.16 ResetRxStats 6.3.17 SetDefaultRxTxTimeout 6.3.18 SetRegMode 6.4 Chip Auto Calibration 6.4.1 Calibrate 6.4.2 CalibFE 6.5 Measurements 6.5.1 GetVbat 6.5.2 GetTemp 6.6 Low Battery Detector Configuration 6.6.1 SetLbdCfg 6.6.2 GetRandomNumber 6.7 Chip Status 6.7.1 GetStatus 6.7.2 GetVersion 6.7.3 ClearErrors 6.7.4 GetErrors 6.8 DIO Control 6.8.1 SetDioFunction 6.8.2 SetDioRfSwitchConfig 6.8.3 SetDioIrqConfig 6.9 Interrupt Control 6.9.1 ClearIrq 6.9.2 GetAndClearIrqStatus 6.10 Data FIFO 6.10.1 ConfigFifoIrq 6.10.2 GetFifoIrqFlags 6.10.3 ClearFifoIrqFlags 6.10.4 GetAndClearFifoIrqFlags 6.10.5 GetRxFifoLevel 6.10.6 GetTxFifoLevel 6.10.7 ClearRxFifo 6.10.8 ClearTxFifo 6.11 Clock Control 6.11.1 ConfigLfClock 6.11.2 ConfigClkOutputs 6.11.3 SetTcxoMode 6.11.4 SetXoscCpTrim 6.12 Temperature Compensation 6.12.1 SetTempCompCfg 6.12.2 SetNtcParams 7. Radio Frequency Front End Control 7.1 Overview (LR2021/LR2022) 7.2 Overview (LR2012) 7.3 RF Front End Commands (LR20xx) 7.3.1 SetRfFrequency 7.3.2 SetRxPath 7.3.3 GetRssiInst 7.3.4 SetRssiCalibration 7.3.5 ResetRxStats 7.3.6 SetTimestampSource 7.3.7 GetTimestampValue 7.3.8 GetCcaResult 7.3.9 SetAgcGainManual 7.3.10 GetRxPktLength 7.4 Power Amplifier Control Commands (LR20xx) 7.4.1 SetPaConfig 7.4.2 SelPa 7.4.3 SetTxParams 8. Modem Configuration (LR20xx) 8.1 Packet Type Selection 8.1.1 SetPacketType 8.1.2 GetPacketType 9. LoRa Modulation (LR20xx) 9.1 LoRa Modulation Principle 9.1.1 Spreading Factor (SF) 9.1.2 LoRa Bandwidth (BWLORA) 9.1.3 Coding Rate (CR) 9.1.4 Low Data Rate Optimization (LDRO) 9.1.5 LoRa Symbol Rate (Rs) 9.2 LoRa Packet Handler 9.2.1 Preamble 9.2.2 Header (explicit packets only) 9.2.3 Payload 9.3 Multi-SF Detection 9.4 Channel Activity Detection (CAD) 9.5 Multi-SF CAD 9.6 Fast CAD 9.7 Extended LoRa Rx Bandwidth 9.8 Intra-packet Frequency Hopping Compatibility with SX127x 9.9 LoRa Commands 9.9.1 SetLoraModulationParams 9.9.2 SF6 Compatibility with SX127x 9.9.3 SetLoraPacketParams 9.9.4 SetLoRaSynchTimeout 9.9.5 SetLoraSyncword 9.9.6 SetLoraSideDetConfig 9.9.7 SetLoraSideDetSyncword 9.9.8 GetLoraRxStats 9.9.9 GetLoraPacketStatus 9.9.10 SetLoraAddress 9.9.11 SetLoraHopping 9.9.12 SetLoraTxSync 9.9.13 SetLoraSideDetCad 10. RTToF (Round-Trip Time of Flight) (LR20xx) 10.1 RTToF Engine 10.2 RTToF Commands 10.2.1 SetRangingAddr 10.2.2 SetRangingReqAddr 10.2.3 GetRangingResult 10.2.4 GetRangingStats 10.2.5 SetRangingTxRxDelay 10.2.6 SetRangingParams 11. (G)FSK Modulation (LR20xx) 11.1 (G)FSK Modulation Principle 11.1.1 Modem Bandwidth and Bit Rates 11.1.2 (G)FSK Modulation Index 11.1.3 (G)FSK Limitations 11.2 (G)FSK Packet Handler 11.2.1 Fixed-Length Packet 11.2.2 Variable-Length Packet 11.3 (G)FSK Commands 11.3.1 SetFskModulationParams 11.3.2 SetFskPacketParams 11.3.3 SetFskWhiteningParams 11.3.4 SetFskCrcParams 11.3.5 SetFskSyncword 11.3.6 SetFskAddress 11.3.7 GetFskRxStats 11.3.8 GetFskPacketStatus 12. Wireless M-Bus (WM-BUS) (LR20xx) 12.1 WM-BUS Modulation 12.2 WM-BUS Packet Handler 12.3 WM-BUS Radio Commands 12.3.1 SetWmbusParams 12.3.2 GetWmbusRxStats 12.3.3 GetWmbusPacketStatus 12.3.4 SetWmbusFilteringAddress 13. Wi-SUN FSK (LR20xx) 13.1 Wi-SUN Modulation 13.2 Wi-SUN Packet Handler 13.3 Wi-SUN Radio Commands 13.3.1 SetWisunMode 13.3.2 SetWisunPacketParams 13.3.3 GetWisunRxStats 13.3.4 GetWisunPacketStatus 13.3.5 SetWisunPacketLen 14. Bluetooth Low Energy Physical Layer (LR2021/LR2022) 14.1 Bluetooth LE Modulation 14.2 Bluetooth LE Packet Handler 14.3 Bluetooth LE Radio Commands 14.3.1 SetBleModulationParams 14.3.2 SetBleChannelParams 14.3.3 SetBleTxPduLen 14.3.4 SetBleTx 14.3.5 GetBleRxStats 14.3.6 GetBlePacketStatus 15. BPSK Modem (LR20xx) 15.1 (D)BPSK Modulation 15.2 BPSK Radio Commands 15.2.1 SetBpskModulationParams 15.2.2 SetBpskPacketParams 16. OOK Modem (LR20xx) 16.1 OOK Modulation 16.2 OOK Packet Handler 16.3 OOK Commands 16.3.1 SetOokModulationParams 16.3.2 SetOokPacketParams 16.3.3 SetOokCrcParams 16.3.4 SetOokSyncword 16.3.5 SetOokAddress 16.3.6 GetOokRxStats 16.3.7 GetOokPacketStatus 16.3.8 SetOokDetector 16.3.9 SetOokwhiteningParams 17. LR-FHSS (LR20xx) 17.1 LR-FHSS Modulation 17.2 LR-FHSS Commands 17.2.1 LrFhssBuildFrame 17.2.2 LrFhssSetSyncword 17.2.3 ReadLrFhssHoppingTable 17.2.4 WriteLrFhssHoppingTable 18. FLRC Modem (LR2021) 18.1 FLRC Modulation 18.1.1 Modem Bandwidth and Bit Rates 18.1.2 FEC Coding Rate 18.1.3 Gaussian Filtering 18.1.4 FLRC Frequency Tolerance 18.2 FLRC Packet Handler 18.2.1 Fixed-Length Packet Format 18.2.2 Variable-length Packet Format 18.3 FLRC Time-on-Air 18.4 FLRC Radio Commands 18.4.1 SetFlrcModulationParams 18.4.2 SetFlrcPacketParams 18.4.3 GetFlrcRxStats 18.4.4 GetFlrcPacketStatus 18.4.5 SetFlrcSyncword 19. OQPSK_15_4 (LR2021) 19.1 OQPSK_15_4 Modulation 19.2 OQPSK_15_4 Packet Handler 19.3 OQPSK_15_4 Radio Commands 19.3.1 SetOqpskParams 19.3.2 GetOqpskRxStats 19.3.3 GetOqpskPacketStatus 19.3.4 SetOqpskPacketLen 19.3.5 SetOqpskAddress 20. Z-Wave (LR2021) 20.1 Z-Wave Modulation 20.2 Z-Wave Packet Handler 20.3 Z-Wave Radio Commands 20.3.1 SetZwaveParams 20.3.2 SetZwaveHomeIdFiltering 20.3.3 GetZwaveRxStats 20.3.4 GetZwavePacketStatus 20.3.5 SetZwaveBeamFiltering 20.3.6 SetZwaveScanConfig 20.3.7 SetZwaveScan 21. Test Commands (LR20xx) 21.1 Regulatory Overview 21.1.1 ETSI 21.1.2 FCC 21.2 SetTxTestMode 22. Known Limitations and Workarounds 22.1 OOK Detection Threshold Adjustment (LR20xx) 22.1.1 Description 22.1.2 Workaround 22.2 RTTOF Accuracy for SX1280-compatible Bandwidths (LR2021/LR2022) 22.3 Firmware Patch RAM (PRAM) 22.3.1 Loading the Patch RAM 22.3.2 Checking the Patch RAM 22.4 Regulatory Compliance 22.4.1 CN470 SRRC Compliance for China 22.4.2 IN865 Compliance for India 23. Application Information 23.1 Power Management 23.2 RF Shield Impact 23.3 Oscillator Recommendations 23.4 Reference Design 23.5 Unused Pins 23.6 Configurations via Register Change 23.7 OCP registers 23.8 Compatibility of Generation 1–4 LoRa Radios 24. Package Information 24.1 Package Outline Drawing 24.2 Package Marking 24.3 Land Pattern 24.4 Reflow Profiles 24.5 Thermal Information 24.6 Tape & Reel Information