MeshCore v1.14.1: RX Boosted Gain deaktiviert sich beim Upgrade auf Repeatern

Wer seinen Repeater oder Room-Server von v1.14.0 auf v1.14.1 aktualisiert hat, sollte einen Blick auf die Empfangseinstellungen werfen. Ein bekannter Bug sorgt dafür, dass der RX Boosted Gain Mode beim Upgrade still auf OFF gesetzt wird — ohne Warnung und ohne dass man etwas davon merkt. Die Companion Firmware ist davon nicht betroffen.

Was ist der RX Boosted Gain Mode?

Der RX Boosted Gain Mode (auch radio.rxgain) verbessert die Empfangsempfindlichkeit des LoRa-Transceivers. Er war in älteren Versionen immer aktiv, weil das zugehörige Setting schlicht nicht existierte — es gab nichts, das man abschalten hätte können. Erst mit v1.14.1 wurde radio.rxgain als konfigurierbarer Parameter eingeführt.

Warum tritt der Fehler auf?

Bei einer Neuinstallation von v1.14.1 (mit aktiviertem „Erase device") wird radio.rxgain korrekt auf ON gesetzt. Bei einem Upgrade ohne Löschen des Flash-Speichers wird das neue Setting hingegen ohne Standardwert übernommen — und landet dadurch auf OFF. Das ist ein klassisches Migrations-Problem: Ein neuer Parameter wird nicht mit dem sinnvollen Defaultwert aus früheren Versionen befüllt.

Wer ist betroffen?

Betroffen sind alle, die einen Repeater oder Room-Server ohne „Erase device" von v1.14.0 auf v1.14.1 aktualisiert haben. In diesem Szenario ist der boosted Empfangsmodus deaktiviert, was die Reichweite spürbar reduzieren kann. Eine Neuinstallation oder ein Upgrade der Companion Firmware zeigt das Problem nicht.

Schnellcheck und Behebung per CLI

Den aktuellen Status lässt sich über die serielle CLI prüfen und bei Bedarf korrigieren:

CLI

# Aktuellen Status prüfen
get radio.rxgain

# Falls der Wert "off" zurückgemeldet wird, korrigieren:
set radio.rxgain on
reboot

Nach dem Neustart ist der Boosted Gain Mode wieder aktiv. Ein erneutes Flashen ist nicht notwendig.

---

Kurzanleitung: Bug selbst beheben

1. Gerät per USB anschließen und eine serielle Konsole öffnen (z. B. mit dem Web Flasher oder einem Terminal-Programm wie PuTTY/minicom, Baudrate 115200) 2. Status abfragen:

CLI

get radio.rxgain

3. Wenn die Antwort off lautet, Einstellung korrigieren:

CLI

set radio.rxgain on
reboot

4. Nach dem Neustart nochmals prüfen — der Wert sollte jetzt on anzeigen.