From 0de437916d20002d7d103bdf21b349da29b15a42 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jan=20Grome=C5=A1?= Date: Sun, 2 Mar 2025 08:33:16 +0100 Subject: [PATCH] Updated Troubleshooting Guide (markdown) --- Troubleshooting-Guide.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/Troubleshooting-Guide.md b/Troubleshooting-Guide.md index 939bd2c..02e64de 100644 --- a/Troubleshooting-Guide.md +++ b/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. \ No newline at end of file +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. \ No newline at end of file