Le opzioni di configurazione LoRa includono: Regione, Usa Preset, Preset Modem, Max Hops, Potenza di Trasmissione, Larghezza di Banda, Fattore di Spreading, Codifica, Offset di Frequenza, Trasmissione Abilitata, Slot di Frequenza, Ignora Array in Entrata, Ignora MQTT, Sovrascrivi Limite Duty Cycle, Guadagno RX SX126x Potenziato, Sovrascrivi Frequenza e Ventola PA Disabilitata. Questa configurazione utilizza un messaggio admin che invia un protobuf Config.LoRa.
Nota: Per comunicare efficacemente, i dispositivi in una mesh devono condividere impostazioni Regione e Preset Modem identiche oppure avere impostazioni personalizzate del Modem identiche.
Valori di Configurazione LoRa
Nota: Assicurati di impostare la configurazione lora.region del tuo dispositivo per rispettare i limiti legali nella tua area.
-
Regione: Imposta la regione per il tuo nodo, con il valore predefinito non impostato. Se non impostato, il nodo mostrerà un messaggio e non potrà trasmettere pacchetti.
| Codice Regione | Descrizione | Gamma di Frequenza (MHz) | Ciclo di Lavoro (%) | Limite di Potenza (dBm) |
| UNSET | Non impostato | N/D | N/D | N/D |
| Stati Uniti | Stati Uniti | 902.0 - 928.0 | 100 | 30 |
| EU_433 | Unione Europea 433MHz | 433.0 - 434.0 | 10 | 12 |
| EU_868 | Unione Europea 868MHz | 869.4 - 869.65 | 10 | 27 |
| CN | Cina | 470.0 - 510.0 | 100 | 19 |
| JP | Giappone | 920.8 - 927.8 | 100 | 16 |
| ANZ | Australia & Nuova Zelanda | 915.0 - 928.0 | 100 | 30 |
| KR | Corea | 920.0 - 923.0 | 100 | |
| TW | Taiwan | 920.0 - 925.0 | 100 | 27 |
| RU | Russia | 868.7 - 869.2 | 100 | 20 |
| IN | India | 865.0 - 867.0 | 100 | 30 |
| NZ_865 | Nuova Zelanda 865MHz | 864.0 - 868.0 | 100 | 36 |
| TH | Thailandia | 920.0 - 925.0 | 100 | 16 |
| UA_433 | Ucraina 433MHz | 433.0 - 434.7 | 10 | 10 |
| UA_868 | Ucraina 868MHz | 868.0 - 868.6 | 1 | 14 |
| MY_433 | Malesia 433MHz | 433.0 - 435.0 | 100 | 20 |
| MY_919 | Malesia 919MHz | 919.0 - 924.0 | 100 | 27 |
| SG_923 | Singapore 923MHz | 917.0 - 925.0 | 100 | 20 |
| LORA_24 | Banda 2,4 GHz mondiale | 2400.0 - 2483.5 | 100 | 10 |
NOTA: EU_433 e EU_868 devono rispettare un ciclo di lavoro massimo del 10%, calcolato ogni minuto su base mobile di 1 ora. Il dispositivo smetterà di trasmettere se il limite viene raggiunto.
-
Usa Preset: Quando abilitato, verranno utilizzati i campi Preset Modem; altrimenti, i valori per Larghezza di banda, Fattore di diffusione e Codifica saranno presi dalle rispettive voci manuali.
-
Preset Modem: Il valore predefinito è unset (LONG_FAST). I preset sono impostazioni predefinite (Larghezza di banda, Fattore di diffusione e Codice di correzione) che influenzano velocità e portata del messaggio, offrendo un mix di entrambi per la maggior parte degli utenti. I preset ottimizzano per velocità o portata a seconda della situazione: SHORT_TURBO (Più veloce, larghezza di banda massima, tempo di trasmissione minimo, portata più corta; non legale in tutte le regioni a causa della larghezza di banda di 500 kHz). / SHORT_FAST / SHORT_SLOW / MEDIUM_FAST / MEDIUM_SLOW / LONG_FAST (Predefinito) / LONG_MODERATE / LONG_SLOW / VERY_LONG_SLOW (Più lento, larghezza di banda minima, tempo di trasmissione massimo, portata più lunga; non raccomandato per uso regolare).
-
Max Hop: Il numero massimo di hop non può superare 7, con un valore predefinito di 3, adatto alla maggior parte delle applicazioni.
-
Potenza di Trasmissione: Impostare a zero per usare la potenza continua massima legale predefinita, evitando danni all'hardware. Nella maggior parte dei casi, zero è raccomandato. Le unità sono in dBm.
-
Larghezza di Banda: Alcuni valori di larghezza di banda sono tradotti dal firmware in valori floating-point appropriati:
| Valore Speciale | Interpretato Come |
| 31 | 31.25 kHz |
| 62 | 62.5 kHz |
| 200 | 203.125 kHz |
| 400 | 406.25 kHz |
| 800 | 812.5 kHz |
| 1600 | 1625.0 kHz |
NOTA: Valori < 62,5 kHz possono richiedere TCXO su alcuni hardware.
-
Fattore di Spreading: Un numero da 7 a 12 che rappresenta il numero di chirp per simbolo come (1 << \text{spread_factor}).
-
Rate di Codifica: Questo è il denominatore del rate di codifica; per esempio, per 4/5, il valore è 5.
-
Offset di Frequenza: Destinato a utenti avanzati con apparecchiature specializzate; la maggior parte dovrebbe evitarne l'uso. Questo parametro aggiunge un offset di frequenza alla frequenza centrale per correggere errori di calibrazione.
-
Trasmissione Abilitata: Questa opzione consente di abilitare o disabilitare la trasmissione (TX) dalla radio LoRa; utile per sostituzioni di antenna e test. Il valore predefinito è true.
-
Slot di Frequenza: Controlla la frequenza hardware usata per la trasmissione, rappresentata da uno slot tra 1 e NUM_SLOTS (massimo basato sulla regione e preset del modem). Impostare su 0/UNSET ripristina il metodo più vecchio per la determinazione della frequenza.
-
Ignora Array in Entrata: Per test, puoi impedire a un nodo di ascoltare nodi specifici (simulando fuori portata). I pacchetti dai nodenums in questo array verranno scartati.
-
Ignora MQTT: Impostare questa opzione su true permette al dispositivo di ignorare qualsiasi messaggio LoRa inviato tramite MQTT. Questo vale solo se il dispositivo e il nodo MQTT hanno almeno la versione firmware 2.2.19.
-
OK a MQTT: I valori accettabili sono true o false (predefinito false). Impostare su true significa approvare l'invio dei pacchetti ai broker MQTT. Se false, si richiede ai nodi di non inoltrare i pacchetti. Funziona solo con canali che usano le chiavi defaultpsk e eventpsk; è ignorato nei canali con chiavi personalizzate.
Consiglio: Questa non è una misura crittografica ma una richiesta cortese applicata nel firmware ufficiale.
-
Sovrascrivi Limite del Duty Cycle: Imposta su true per ignorare il limite orario del duty cycle in Europa, il che potrebbe comportare violazioni normative. Per impostazione predefinita, è false, il che significa che il dispositivo interromperà la trasmissione dati al raggiungimento del limite.
-
Guadagno RX Potenziato SX126x: Questa opzione permette ai chip SX126x di usare leggermente più potenza per migliorare la sensibilità RX.
-
Sovrascrivi Frequenza: Per utenti avanzati e operatori radio HAM con licenza. Quando abilitato, il dispositivo ignora i calcoli del canale e utilizza la frequenza specificata (l'offset di frequenza si applica comunque). Assicurati di rispettare le leggi locali e abilita la modalità HAM disabilitando la crittografia.
-
Ventola PA Disabilitata: Se impostato su true, disabilita la ventola PA integrata usando il pin definito in RF95_FAN_EN.
Disponibilità del Client di Configurazione LoRa
Android
Le opzioni di configurazione LoRa sono accessibili su Android.
-
Apri la App Meshtastic.
-
Naviga su: Ellissi Verticale (tre puntini in alto a destra) > Configurazione Radio > LoRa.
Mela
Tutte le opzioni di configurazione LoRa sono disponibili su iOS, iPadOS e macOS in Impostazioni > Configurazione Radio > LoRa.
CLI
I comandi di configurazione LoRa sono accessibili nella CLI Python. Esempi di comandi sono forniti di seguito:
| Impostazione | Valori Accettabili | Predefinito |
| 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, KR, TW, RU ,IN, NZ_865, TH, LORA_24, UA_433, UA_868, MY_433, MY_919, SG_923 | 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 | Da 0 a 1000000 | 0 |
| lora.hop_limit | 1,2,3,4,5,6,7 | 3 |
| lora.tx_power | Da 0 a 30 | 0 |
| lora.tx_enabled | false, true | VERO |
| lora.channel_num | 0, 1 to 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 | Qualsiasi frequenza supportata dalla radio LoRA. Si prega di rispettare le norme e regolamenti locali | 0 |
-
Imposta Preset Modem
| meshtastic --set lora.modem_preset LONG_FAST meshtastic --set lora.modem_preset MEDIUM_FAST
|
-
Imposta Regione
| meshtastic --set lora.region US meshtastic --set lora.region EU_433
|
-
Imposta Limite Hop
meshtastic --set lora.hop_limit 2
|
-
Sovrascrivi Duty Cycle
| meshtastic --set lora.override_duty_cycle true meshtastic --set lora.override_duty_cycle false
|
NOTA: Poiché il dispositivo si riavvierà dopo ogni comando inviato tramite il CLI, si consiglia di concatenare i comandi in uno solo quando si impostano più valori in una sezione di configurazione. Per esempio:
meshtastic --set lora.region US --set lora.modem_preset LONG_FAST
|
Web
Tutte le opzioni di configurazione LoRa sono disponibili nell'interfaccia Web.
