Le opzioni di configurazione per i canali includono Indice, Ruoli e Impostazioni. La configurazione del canale utilizza un messaggio amministrativo che invia un protobuf Channel, che contiene un protobuf ChannelSettings o ModuleSettings.
Nota: le Impostazioni del Canale (descritte in questa pagina) non devono essere confuse con le Impostazioni Predefinite del Modem.
Le Impostazioni Predefinite del Modem consistono nella configurazione del modem, inclusi impostazioni di frequenza, fattore di diffusione, larghezza di banda e altro, applicabili alla radio LoRa. Queste impostazioni sono coerenti su tutti i canali e non possono essere uniche per canali individuali.
Al contrario, le Impostazioni del Canale forniscono informazioni per organizzare gruppi di messaggi, abilitare la crittografia opzionale e consentire o vietare la messaggistica tramite gateway internet. Queste impostazioni sono uniche e configurabili per ogni canale.
Valori di Configurazione del Canale
Indice
L'indicizzazione non può essere modificata.
| Indice | Canale | Ruolo Predefinito | Scopo |
| 0 | 1 | PRIMARY | Usato come canale predefinito |
| 1 | 2 | DISABILITATO | Definito dall'utente |
| 2 | 3 | DISABILITATO | Definito dall'utente |
| 3 | 4 | DISABILITATO | Definito dall'utente |
| 4 | 5 | DISABILITATO | Definito dall'utente |
| 5 | 6 | DISABILITATO | Definito dall'utente |
| 6 | 7 | DISABILITATO | Definito dall'utente |
| 7 | 8 | DISABILITATO | Definito dall'utente |
NOTA: Non puoi avere canali DISABILITATI posizionati tra canali attivi come PRIMARY e SECONDARY. I canali attivi devono essere in ordine consecutivo.
Ruolo
A ogni canale viene assegnato uno dei tre ruoli:
-
PRIMARY (1) Questo è il primo canale creato durante la configurazione iniziale. Può esistere un solo canale primary e non può essere disabilitato. Le trasmissioni periodiche, come posizione e telemetria, vengono inviate esclusivamente su questo canale.
-
SECONDARY (2) Questo canale può modificare la chiave di crittografia (PSK).
-
DISABILITATO (0) Il canale non è più disponibile per l'uso e le sue impostazioni sono ripristinate ai valori predefiniti.
NOTA: Sebbene tu possa usare un canale PRIMARY diverso e comunicare su canali SECONDARY con lo stesso nome e PSK, l'hash del nome del canale PRIMARY definisce lo slot di frequenza LoRa. Questo slot di frequenza determina la frequenza effettiva di trasmissione all'interno della banda. Per garantire che i dispositivi con nomi di canale PRIMARY diversi trasmettano sulla stessa frequenza, devi impostare esplicitamente lo slot di frequenza LoRa.
Parametri di Configurazione del Canale
Le opzioni Impostazioni Canale includono: Nome, PSK, Downlink Abilitato e Uplink Abilitato. Queste impostazioni del canale sono racchiuse nel Channel protobuf come un ChannelSettings protobuf e trasmesse come un messaggio admin.
nomi dei canali
Un identificatore breve per il canale. (< 12 byte)
| Nome riservato | Scopo |
| "" (predefinito) | Se lasciato vuoto sul canale Primary, questo designa il canale predefinito. |
| admin | Sui canali secondari, il nome admin (case sensitive) designa il canale admin usato per amministrare i nodi sulla mesh. Nota che questa è una funzionalità Legacy, vedi Remote Admin per dettagli. |
NOTA: Per comunicare sullo stesso canale con altri dispositivi, sono essenziali nomi di canale corrispondenti. Ad esempio, se il tuo dispositivo utilizza il nome canale LongFast, il dispositivo con cui vuoi comunicare deve avere un canale chiamato LongFast.
PSK
La chiave di crittografia usata per i canali privati può essere specificata come segue: può essere di 0 byte (nessuna crittografia), 16 byte (AES128) o 32 byte (AES256). Il Primary default channel utilizza il byte esadecimale 0x01.
Nota: Le PSK corrispondenti sono necessarie per comunicare sullo stesso canale con altri dispositivi. Ad esempio, se il tuo dispositivo utilizza un canale con la PSK predefinita AQ==, il dispositivo con cui desideri comunicare deve avere un canale con la stessa PSK.
Downlink abilitato
Se abilitato, i messaggi catturati da un gateway internet pubblico saranno inoltrati alla mesh locale. Per impostazione predefinita, questa impostazione è false per tutti i canali.
Uplink abilitato
Se abilitato, i messaggi dalla mesh saranno trasmessi a internet pubblico tramite il gateway configurato di qualsiasi nodo. Questa impostazione è false di default per tutti i canali.
Impostazioni di configurazione del canale
Le opzioni di impostazioni del modulo canale includono la precisione della posizione. Queste impostazioni sono incorporate nel Channel protobuf come un ModuleSettings protobuf e vengono inviate come un messaggio admin.
Precisione della posizione
L'impostazione position_precision consente di controllare il livello di precisione dei dati di localizzazione trasmessi su un canale specifico. Questo può essere importante per la privacy, poiché potrebbe essere necessario offuscare la posizione esatta quando si inviano dati di posizione su determinati canali.
Il valore position_precision è un intero compreso tra 0 e 32:
-
Un valore di 0 indica che i dati di localizzazione non vengono mai inviati tramite il canale specificato.
-
Un valore di 32 significa che i dati di posizione sono inviati con massima precisione.
-
I valori intermedi rappresentano il numero di bit di precisione da inviare, corrispondenti a una specifica precisione della posizione dettagliata nella tabella sottostante.
-
Si prega di notare che il server MQTT pubblico filtra le posizioni precise.
Le applicazioni client offrono vari livelli di precisione, permettendo agli utenti di scegliere da un intervallo pratico. Puoi impostare valori su tutta la gamma di interi usando il Python CLI. Per esempi su come impostare diversi livelli di precisione usando il CLI, consulta Impostazione della Precisione della Posizione.
| Bit di precisione | Metrico | Imperial |
| 10 | 23,3 km | 14,5 miglia |
| 11 | 11,7 km | 7,3 miglia |
| 12 | 5,8 km | 3,6 miglia |
| 13 | 2,9 km | 1,8 miglia |
| 14 | 1,5 km | 4787 piedi |
| 15 | 729 m | 2392 piedi |
| 16 | 364 m | 1194 piedi |
| 17 | 182 m | 597 piedi |
| 18 | 91 m | 299 piedi |
| 19 | 45 m | 148 piedi |
Disponibilità della configurazione del client canale
Android
Le opzioni di Config Canale sono disponibili su Android.
La scheda Configurazione Radio è disponibile per attività comuni, tra cui:
-
Visualizzare il codice QR e l'URL della configurazione corrente del canale.
-
Creare o modificare rapidamente il tuo canale primario.
-
Selezionare un preset modem per tutti i tuoi canali, come Long Range o Fast.
Per ulteriori istruzioni sulla configurazione del tuo canale primario, consulta la sezione Uso dell'app Android.
Tocca "Modifica" per accedere al Menu Canale, dove puoi:
-
Aggiungi, rimuovi o modifica i canali secondari.
-
Crea o modifica le chiavi di crittografia.
-
Abilita uplink e downlink per i singoli canali.
-
Abilita le impostazioni di posizione.
-
Imposta la posizione precisa (se la posizione è abilitata).
-
Regola la precisione della posizione (se la posizione precisa è disabilitata).
Apple
Un editor di canale è accessibile nelle applicazioni iOS, iPadOS e macOS sotto Impostazioni > Configurazione radio > Canali.
CLI
Consiglio: Poiché il dispositivo si riavvierà dopo ogni comando inviato tramite la CLI, si consiglia di concatenare i comandi in uno solo quando si impostano più valori in una sezione di configurazione. Esempio:
| meshtastic --ch-set name "My Channel" --ch-set psk random --ch-set uplink_enabled true --ch-index 4 |
Tutte le opzioni di configurazione del canale sono disponibili nella CLI Python. Esempi di comandi sono forniti di seguito:
Nome
Imposta il nome del canale per il canale PRIMARIO
|
# senza spazi |
PSK
Se usi Meshtastic per scambiare messaggi che non vuoi che altri vedano, dovresti usare l'impostazione random. Scegliere default o uno qualsiasi dei valori simple dalla tabella seguente utilizzerà chiavi di crittografia pubblicamente note. Queste chiavi sono incluse nel codice sorgente di Meshtastic, rendendo possibile a chiunque intercettare i messaggi criptati con esse. Sebbene siano adatte per test e canali pubblici, non sono sicure per comunicazioni private.
| Impostazione | Comportamento |
| none | Disabilita crittografia |
| default | Crittografia predefinita (usa la chiave di crittografia debole) |
| random | Genera una chiave di crittografia sicura a 256 bit. Usa questa impostazione per comunicazioni private. |
| simple0- simple254 | Usa una codifica a singolo byte per la crittografia |
-
Imposta la crittografia predefinita sul canale PRIMARIO
| meshtastic --ch-set psk default --ch-index 0 |
-
Imposta la crittografia casuale sul canale PRIMARIO
| meshtastic --ch-set psk random --ch-index 0 |
-
Imposta la crittografia a singolo byte sul canale PRIMARIO
| meshtastic --ch-set psk simple15 --ch-index 0 |
-
Imposta la crittografia con la tua chiave sul canale PRIMARIO
| meshtastic --ch-set psk 0x1a1a1a1a2b2b2b2b1a1a1a1a2b2b2b2b1a1a1a1a2b2b2b2b1a1a1a1a2b2b2b2b --ch-index 0 |
-
Imposta la crittografia con la tua chiave sul canale PRIMARIO (codificata in Base64)
| meshtastic --ch-set psk base64:puavdd7vtYJh8NUVWgxbsoG2u9Sdqc54YvMLs+KNcMA= --ch-index 0 |
-
Disabilita la crittografia sul canale PRIMARIO
| meshtastic --ch-set psk none --ch-index 0 |
NOTA: Usa questo per copiare e incollare la chiave codificata in base64 (canale singolo) dal comando meshtastic --info. Evita di usare il codice omnibus (tutti i canali) qui, poiché non è una chiave valida.
Uplink / Downlink
Per la configurazione dei gateway, vedi MQTT
-
Abilita/Disabilita Uplink sul canale PRIMARIO
| meshtastic --ch-set uplink_enabled true --ch-index 0 meshtastic --ch-set uplink_enabled false --ch-index 0 |
-
Abilita/Disabilita Downlink sul canale SECONDARIO
| meshtastic --ch-set downlink_enabled true --ch-index 1 meshtastic --ch-set downlink_enabled false --ch-index 5 |
Configurazione della Precisione della Posizione
Questa è una impostazione per canale. Il parametro --ch-index deve essere specificato per impostare la precisione della posizione per un canale specifico, ad esempio --ch-index 0 per il canale primario o --ch-index 1 per il canale secondario 1.
-
Imposta la precisione della posizione a 13 bit (circa ±3 km)
| meshtastic --ch-set module_settings.position_precision 13 --ch-index 0 |
-
Imposta la precisione della posizione alla precisione completa (32 bit)
| meshtastic --ch-set module_settings.position_precision 32 --ch-index 1 |
Web
Tutte le opzioni di Channel config sono accessibili nell'interfaccia Web.
Codice QR
Il Meshtastic QR code (o Channel URL) permette agli utenti di condividere rapidamente le impostazioni del canale e di LoRa, semplificando il processo di configurazione di più nodi con impostazioni di comunicazione corrispondenti. Scansionare un codice QR applica tutte le impostazioni del canale e di configurazione LoRa incluse, quindi assicurati di rivedere cosa comprendono queste impostazioni prima di procedere. Scansiona solo codici QR da fonti affidabili.
Per maggiori dettagli, vedi:
