lr2021 0.13.1

Driver for Semtech LR2021
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169

# Change Log

## [0.13.1] - 2025-12-06

### Fixed
  - LoRa: fix the `set_lora_hopping` methods not sending the command properly

### Internal
  - Internal buffer now implements AsMut

## [0.13.0] - 2025-12-06

### Changed
  - LoRa:
    * Renamed some bandwidth (800->812, 400->406, 200->203, 100->101)
    * `lora_set_cad_params` now uses a struct with a few builders.
    * Use signed value for extended syncword setting
  - LR-FHSS: use enum for bandwidth selection
  - VBat: now properly returns an unsigned integer
  - Interrupt: add `From<u32>` to ease conversion from constant

## [0.12.0] - 2025-11-28

### Changed
  - Depencencies updated to more recent version (embedded-hal 1.0.0 and embassy-embedded-hal 0.5.0)

## [0.11.0] - 2025-11-27

### Changed
  - SetTxParams: power change from u8 to i8 to support power below 0dBm

### Added
  - Interrupts:
    * add some shortcut constant and methods to ease creating interrupts setting
    * Add documentation on all interrupts methods and constant

## [0.10.1] - 2025-11-19

### Changed
  - BLE: add patches for certification
    * BLE 2Mb/s: fix preamble length
    * BLE Coded: Tune detection to pass blocking certification

## [0.10.0] - 2025-10-19

### Changed
  - WiSUN and WMBus now uses struct to set the packet parameters
    * rename some WiSUN enum (FcsTX/FecTX now WisunFcsLen and WisunFec)
      and remove some which are obvious boolean (Whiteningm CRC hw, ModeSwitch enable)
  - Alignment with latest API spec release

## [0.9.0] - 2025-10-10

### Added
  - System API around clocks, measurement (temperature, Voltage) and regulator
  - OOK: API to configure OOK demodulator for Somfy RTS
  - BLE Coded: add some register setting to pass certification (Dirty transmitter test)
  - FSK: add method to support long preamble (more than 2k symbols)
  - Add method to tweak PA over-current protection (for some antenna at 900MHz)
  - Add method to support LoRa SX127x frequency hopping timings
  - Add method to centralize settings of register list for retention
  - Add new sleep mode: DeepRetention (i.e. sleep with retention but no timeout)

### Removed
  - Impl of defmt::Format for TempResp has been removed: the API now provides directly the temperature and TempResp is unlikely to be used externally
  - Remove some experimental APIs

### Changed
  - LoRa Ranging:
    * Add missing setting for extended mode
    * Add dedicated set_ranging_modulation to properly configure the chip when using fractional bandwidth (812, 406, 203 and 101kHz)
  - LoRa Data: add methods to configure blanking (algorithm to reduce impact of interferer) and hopping
  - NTC enable in the Temperature compensation command changed from enum to bool
  - End-of-Life trimming enum renamed from Trim to EolTrim
  - Sleep mode retention setting is now an enum to ensure only valid/usefull value can be used

### Internals
  - Centralize constants definition for all register addresses in constants.rs
  - Move all fifo related command to their own module

## [0.8.0] - 2025-09-14

### Added
  - Add method to patch RF setting for ranging as this needs to be done after set_packet_type
  - Add LoRa API to support larger frequency offset range: `set_lora_freq_range`
  - Add BLE API for Constant Tone Extension support (experimental)

### Changed
  - WMbus PktFormat renamed to WmbusFormat
  - LoRa:
    * use struct to define modulation and packet params
    * SF and LoRaBw implements Ord (i.e. can use comparison operators)

## [0.7.0] - 2025-09-07

### Added
  - LoRa: add API to retrieve FEI
  - Ranging:
    * add method to get the base TXRX Delay depending on bandwidth and SF
    * add `set_rf_ranging` to ensure constant delay whatever the RF selected
    * add method to retrieve the ranging RSSI correction offset
  - Ranging:

### Fixed
  - Fix command value of SetRxDutyCycle
  - Ranging: rssi2 has been removed (always null)
  - Patch RAM is now properly enabled after being loaded (to be tested)

## [0.6.0] - 2025-09-03

### Changed
  - Improved documentation (doc(alias), Summary of methods in each protocol file, ...)
  - Use enum for RxBoost in `set_rx_path`
  - Use enum for DIO in `set_dio_function_cmd`, `set_dio_irq_config_cmd`, `set_dio_rf_switch_config_cmd` and `set_lora_timing_sync`

### Added
  - Add API to control DIO functions (`set_dio_function` and `set_dio_rf_switch`)
  - Add API related to packet timestamp (`set_timestamp_source` and `get_timestamp`)
  - Add API related to TX/RS (`set_tx_test_mode`, `set_auto_txrx` and `set_rx_duty_cycle`)

## [0.5.0] - 2025-08-31

### Changed
  - FSK: dc_free parameter is now a bool in `set_fsk_packet`
  - ZWave:
    * timeout now uses the recommended value based on number of channel used
    * `set_packet` now uses a struct which can be build based on the ZWave mode

### Added
  - LoRa: add methods related to ranging, timing synch, preamble modulation
  - WM-Bus: API
  - Wisun: API
  - BPSK: API (TX only)
  - System:
    * `rd_mem` API allows reading a chunk of the chip memory (mainly for debug or multi-register dump)
    * `ErrorsRsp` now has a defmt::Format implementation as-well as a direct access to the 32b value

## [0.4.0] - 2025-08-23

### Changed
  - Core: the internal buffer was extended to support 256 data bytes and made externally accessible
    through `buffer()` and `buffer_mut()`.
  - Read/Write FIFO where changed and split in two:
    * `wr_tx_fifo`/`rd_rx_fifo` changed to take only a length argument and use the internal buffer
    * `wr_tx_fifo_to`/`wr_rx_fifo_from` corresponds to the old API when a buffer is provided to the command
  - FLRC set packet now uses a structures as input parameter (`FlrcPacket_Params::new(...)`)

### Added
  - PatchRam: `get_pram_info` allows to check if a patch RAM has been set and which version number it contains.
  - API for Zigbee: `set_zigbee_packet`, `set_zigbee_packet_len`, `set_zigbee_address`, `get_zigbee_packet_status`, `get_zigbee_rx_stats`
  - API for ZWave: `set_zwave_packet`, `set_zwave_home_id`, `set_zwave_beam_filt`, `set_zwave_scan_config`, `start_zwave_scan`, `get_zwave_packet_status`, `get_zwave_rx_stats`
  - API for LR-FHSS: `lrfhss_build_packet`, `set_lrfhss_syncword` and `set_lrfhss_hopping`.
  - All enums from command now derive defmt::Format if option is enabled


## [0.3.0] - 2025-08-18

### Added
  - API for legacy FSK modulation (using same packet format as previous Semtech chips)
  - API for FSK CAD/CCA (`set_cad_params`, `set_cad`, `set_cca`, `get_cca_result`)
  - API for first RSSI measurements (`get_rssi_avg`/`get_rssi_inst`)


## [0.2.0] - 2025-08-17

### Added
  - OOK: add API methods to configure the OOK receiver including configuration for ADS-B
  - Radio: `set_rx_gain` for manual gain setting and `force_crc_out` to always output CRC on the RX FIFO
  - System: add function to read and write registers