mirror
/
RadioLib
kopia lustrzana https://github.com/jgromes/RadioLib
1
0
Forkuj 0
Kod Zgłoszenia Projekty Wydania Wiki Aktywność

Updated Troubleshooting Guide (markdown)

master
Jan Gromeš 2025-03-02 08:33:16 +01:00
rodzic 45ba27252d
commit 0de437916d
1 zmienionych plików z 3 dodań i 2 usunięć
Pokaż statystyki Ściągnij plik aktualizacji Ściągnij plik porównania Expand all files Collapse all files

5
Troubleshooting-Guide.md

@ -11,6 +11,7 @@ We also have an online [Status Code Decoder](https://radiolib-org.github.io/stat
| Transmit timeout | -5 | End of transmission is signalled by an interrupt signal, and this error means that signal did not arrive in the expected time window. Check your pinout and/or wiring. |
| Receiver timeout (no LoRaWAN) | -6 | [Blocking receive mode](https://github.com/jgromes/RadioLib/wiki/Troubleshooting-Guide#receiver-timeout) |
| SX126x/8x failed to initialize | -706 or -707 | [Incorrect oscillator selected](https://github.com/jgromes/RadioLib/wiki/Troubleshooting-Guide#sx126xsx128x-incorrect-oscillator) |
| LR11x0 failed to initialize | -705 | [Incorrect oscillator selected](https://github.com/jgromes/RadioLib/wiki/Troubleshooting-Guide#sx126xsx128x-incorrect-oscillator) |
| ESP32/ESP8266 interrupts do not work | N/A | Missing `IRAM_ATTR` from user-provided interrupt service routine. This is a property of the ESP32/ESP8266 architectures when using Arduino and has nothing to do with RadioLib, see [espressif's documentation](https://docs.espressif.com/projects/esp-idf/en/stable/esp32/api-guides/memory-types.html#iram-instruction-ram). |
| No downlink after LoRaWAN uplink | -1116 | Not all uplinks to LoRaWAN server result in a downlink. This is not a problem, but rather a common behavior in LoRaWAN. |
| Output power lower than configured | N/A | Overcurrent protection is likely set to the default value (change it by `radio.setCurrentLimit()`). This can also be caused by insufficient power supply. |
@ -42,6 +43,6 @@ Some platforms support multiple SPI interfaces. If you do not use the correct on
The `receive` method is a blocking method - this means that it will block executuion until an event occurs. In case of RadioLib, this is either packet being received, or a timeout. If the method finishes with a timeout, it will report a -6 error code. However, this can be expected if there were no packets received during the receive window.
### SX126x/SX128x incorrect oscillator
### SX126x/SX128x/LR11x0 incorrect oscillator
The SX126x/8x LoRa modules support two different oscillator types - temperature-compensated crystal oscillator (TCXO) or a crystal oscillator (XTAL). The type of oscillator used in any given SX126x/8x module is up to the module manufacturer. By default, RadioLib assumes TCXO to be used (since it seems to be the more common choice). However, if your module contains an XTAL, it will fail to initialize with the default settings, usually reutrning error code -707 or -706. To let RadioLib know your module is using XTAL instead of TCXO, either set `SX126x::XTAL` to `true` before calling `begin`, or set `tcxoVoltage` argument of `begin` to 0.
The SX126x/8x/LR11x0 LoRa modules support two different oscillator types - temperature-compensated crystal oscillator (TCXO) or a crystal oscillator (XTAL). The type of oscillator used in any given SX126x/8x/LR11x0 module is up to the module manufacturer. By default, RadioLib assumes TCXO to be used (since it seems to be the more common choice). However, if your module contains an XTAL, it will fail to initialize with the default settings, usually reutrning error code -707 or -706. To let RadioLib know your module is using XTAL instead of TCXO, either set `SX126x::XTAL`/`SX128x::XTAL`/`LR11x0::XTAL` to `true` before calling `begin`, or set `tcxoVoltage` argument of `begin` to 0.