Versie van 3 okt 2025 12:32

LoRa-configuratie

Omschrijving: Begrip van de LoRa-configuratie-instellingen op je Meshtastic-apparaat, inclusief regio, modem, hop-limiet en meer.

De LoRa-configuratie-opties zijn: Region, Use Preset, Modem Preset, Max Hops, Transmit Power, Bandwidth, Spread Factor, Coding Rate, Frequency Offset, Transmit Enabled, Frequency Slot, Ignore Incoming Array, Ignore MQTT, Override Duty Cycle Limit, SX126x RX Boosted Gain, Override Frequency, en PA Fan Disabled.

De LoRa-configuratie wordt ingesteld door een admin-bericht dat een Config.LoRa protobuf bevat.

Let op: Om volledig te kunnen communiceren, moeten apparaten binnen een mesh identieke instellingen hebben voor Regio en Modem Preset, of identieke aangepaste modeminstellingen.

LoRa-configuratiewaarden

Let op: Je moet de lora.region instelling van je apparaat instellen. Dit zorgt ervoor dat je binnen de wettelijke limieten voor jouw regio opereert.

Regio

Stelt de regio van je node in. Standaard is dit unset. Zolang dit niet is ingesteld, toont de node een melding en verzendt hij geen pakketten.

Use Preset

Wanneer ingeschakeld, worden de Modem Preset-velden aangehouden; anders worden de Bandwidth / Spread Factor / Coding Rate gebruikt vanuit hun respectieve handmatig gedefinieerde velden.

Modem Preset

Standaard is unset, wat gelijk staat aan LONG_FAST. Presets zijn vooraf gedefinieerde modeminstellingen (Bandwidth, Spread Factor en Coding Rate) die zowel snelheid als bereik beïnvloeden. De standaard preset biedt een goede mix van snelheid en bereik voor de meeste gebruikers. De presets zijn ontworpen om opties te bieden voor optimalisatie van snelheid (en verminderde congestie in het radiomesh) of bereik:

SHORT_TURBO (snelste, hoogste bandbreedte, laagste airtime, kortste bereik — niet legaal in alle regio’s vanwege 500 kHz bandbreedte)
SHORT_FAST
SHORT_SLOW
MEDIUM_FAST
MEDIUM_SLOW
LONG_FAST (standaard)
LONG_MODERATE
LONG_SLOW
VERY_LONG_SLOW (langzaamste, laagste bandbreedte, hoogste airtime, grootste bereik — niet aanbevolen voor normaal gebruik; vormt minder betrouwbaar mesh)

Max Hops

Maximum aantal hops. Dit kan niet groter zijn dan 7. De standaardwaarde is 3, wat voor de meeste toepassingen voldoende is.

Really, 3 is fine.

Bestand:Max-hops.webp

Hop Count

Transmit Power

Als nul, gebruikt het apparaat het standaard maximale legale continue vermogen (dat de radiohardware niet beschadigt). In de meeste gevallen is nul een goede keuze. Eenheid: dBm.

Bandwidth

Bepaalde bandbreedtewaarden zijn “speciaal” en worden door de firmware omgezet naar de juiste floating point waarde:

Speciaal waarde	Geïnterpreteerd als
31	31,25 kHz
62	62,5 kHz
200	203,125 kHz
400	406,25 kHz
800	812,5 kHz
1600	1625,0 kHz

Let op: waarden < 62,5 kHz kunnen een TCXO vereisen op sommige hardware.

Spread Factor

Een getal van 7 tot 12. Duidt het aantal chirps per symbool aan als 1 << spread_factor.

Coding Rate

De noemer van de foutcorrectieverhouding. Bijv. voor 4/5 is de waarde 5; voor 4/8 is de waarde 8.

Frequency Offset

Deze parameter is voor gevorderde gebruikers met testapparatuur. Wij raden niet aan dat de meeste gebruikers dit instellen. Het is een offset die wordt toegevoegd aan de berekende bandcentrale frequentie, gebruikt om kristaalafwijkingen te corrigeren.

Transmit Enabled

Laat je de zender (TX) van de LoRa-radio in- of uitschakelen. Handig bij bijvoorbeeld antennewissel of tests. Standaard: true.

Frequency Slot

Deze instelling beheert de werkelijke hardwarefrequentie waarop de radio zendt, aangeduid via een slot tussen 1 en NUM_SLOTS (maximum voor de huidige regio en modem preset). Als ingesteld op 0 / UNSET, keert het apparaat terug naar het oudere algoritme dat gebaseerd is op hash van het kanaalnaam om het frequentieslot te bepalen.

Ignore Incoming Array

Voor testdoeleinden: je kunt een node dwingen om nooit naar bepaalde andere nodes te luisteren (alsof buiten bereik). Alle nodenummers in de ignore_incoming-array zullen pakketten die zij verzenden genegeerd worden op ontvangst.

Ignore MQTT

Wanneer ingesteld op true, zal het apparaat berichten die het via LoRa ontvangt maar die op het pad via MQTT zijn verzonden, negeren. Dit werkt alleen wanneer je apparaat en de MQTT-node firmwareversie ≥ 2.2.19 zijn.

OK to MQTT

Toegestane waarden: true of false Standaard: false Wanneer ingesteld op true, geeft deze configuratie aan dat de gebruiker toestemt dat zijn/haar pakketten naar MQTT-brokers mogen worden doorgestuurd. Als false, wordt ontvangers gevraagd om jouw pakketten niet door te sturen naar MQTT.

Deze configuratie is alleen van toepassing op kanalen geconfigureerd met de defaultpsk en eventpsk-sleutels; kanalen met aangepaste sleutels negeren deze instelling. Belangrijk: dit is geen cryptografische oplossing, maar een beleefd verzoek dat in de officiële firmware wordt afgedwongen.

Override Duty Cycle Limit

Wanneer deze optie op true is ingesteld, negeert het apparaat de uurlijkse duty cycle limiet in Europa. Dit kan betekenen dat je regelgeving overtreedt als je te vaak zendt. Standaard is deze optie false.

SX126x RX Boosted Gain

Deze optie is specifiek voor de SX126x-chipserie. Laat de chip een kleine extra stroom gebruiken om de gevoeligheid van de ontvanger te verhogen.

Override Frequency

Deze parameter is voor gevorderde gebruikers en gelicenseerde HAM-radioamateurs. Wanneer ingeschakeld, wordt de kanaalberekening genegeerd en de opgegeven frequentie gebruikt (frequency_offset blijft gelden). Respecteer je lokale wetgeving en regels. Als je HAM bent, schakel dan de encryptie uit en activeer HAM-modus.

PA Fan Disabled

Als true, wordt de ingebouwde PA-ventilator uitgeschakeld via de pin-definitie in RF95_FAN_EN.

LoRa-configuratie — clientondersteuning

Beschikbaar in:

Android
Apple (iOS, iPadOS en macOS)
CLI
Web UI

Android

Info: LoRa-configuratie-opties zijn beschikbaar op Android.

Open de Meshtastic-app
Ga naar: Verticale Ellipsis (3 puntjes rechtsboven) > Radio Configuration > LoRa

Apple

Info: Alle LoRa-configuratie-opties zijn beschikbaar op iOS, iPadOS en macOS via: Instellingen > Radio Configuration > LoRa

CLI

Info: LoRa-configuratiecommando’s zijn beschikbaar in de Python CLI.

Voorbeeldcommando’s:

Instelling	Toegestane waarden	Standaardwaarde
lora.modem_preset	LONG_FAST, LONG_SLOW, VERY_LONG_SLOW, MEDIUM_SLOW, MEDIUM_FAST, SHORT_SLOW, SHORT_FAST, SHORT_TURBO	LONG_FAST
lora.use_preset	false, true	false
lora.region	UNSET, US, EU_433, EU_868, CN, JP, ANZ, ANZ_433, KR, TW, RU, IN, NZ_865, TH, LORA_24, UA_433, UA_868, MY_433, MY_919, SG_923, KZ_433, KZ_863, BR_902, NP_865	UNSET
lora.bandwidth	31, 62, 125, 250, 500	250
lora.spread_factor	7, 8, 9, 10, 11, 12	12
lora.coding_rate	5, 6, 7, 8	8
lora.frequency_offset	0 tot 1000000	0
lora.hop_limit	1 tot 7	3
lora.tx_power	0 tot 30	0
lora.tx_enabled	false, true	true
lora.channel_num	0, 1 tot NUM_CHANNELS	0
lora.ignore_mqtt	false, true	false
lora.config_ok_to_mqtt	true, false	false
lora.override_duty_cycle	false, true	false
lora.sx126x_rx_boosted_gain	false, true	false
lora.override_frequency	elke ondersteunde frequentie	0

Tip: Omdat het apparaat herstart na elk commando via CLI, is het aanbevolen om wanneer je meerdere waarden instelt binnen een sectie, deze commando’s aaneen te schakelen in één opdracht.

meshtastic --set lora.region US --set lora.modem_preset LONG_FAST

meshtastic --set lora.modem_preset LONG_FAST
meshtastic --set lora.modem_preset MEDIUM_FAST

meshtastic --set lora.region US
meshtastic --set lora.region EU_433

meshtastic --set lora.hop_limit 2

meshtastic --set lora.override_duty_cycle true
meshtastic --set lora.override_duty_cycle false

Web

Info: Alle LoRa-configuratie-opties zijn beschikbaar in de Web UI.