While developing RadioLib, we occasionally encounter issues with the radio hardware itself. Usually, manufacturers of these chips publish so-called errata notes, where these known problems with the hardware are described. However, not even the manufacturer-published documetns are perfect, and sometimes RadioLib community finds issues that are not covered even by the errata notes.
RadioLib development team always tries to report these issues directly to the chip manufacturers. This is not always easy as the manufacturers sometimes do not reply to these reports, or gate support by a minimum order quantity of thousands of chips. Because of that, we have started this Community Errata Page, to gather these known problems and tested workarounds.
SX126x series
1. Strong out-of-band signals cause receiver sensitivity to drop
Originally reported in https://github.com/jgromes/RadioLib/issues/521
The issue occurs if there is a strong enough signal outside of the radio's currently configured receiver bandwidth, but closer in frequency than 2.5 MHz from the currently configured center frequency. For example, if the radio is at 868.5 MHz with 250 kHz bandwidth, and there is a strong signal or noise source at 869 MHz, then the issue will manifest. When the issue is present, the receiver sensitivity decreases significantly, which prevents the radio to receive signals from weak sources. There is also an increase in the reported RSSI value (by up to 35 dB).
Currently the only known workaround is to periodically restart reception. When the radio cycles from Rx to any other mode and then back to Rx, the sensitivity is restored. The issue also seems to go away when a strong signal in the receiver bandwidth is present.
2. After finishing CAD operation, the radio always returns to STBY_RC mode
Originally reported in https://github.com/jgromes/RadioLib/discussions/1533