Network

Il menu [w] Network del menu principale raccoglie tutte le impostazioni di rete del ricevitore: configurazione WiFi STA, scan reti, PVT TCP server, MQTT publisher, comportamento al cambio modalità radio, reset configurazione network.

Il contenuto del menu varia in base alla modalità radio attiva (SPP/BLE vs WIFI). Le voci pertinenti solo a una modalità sono visibili soltanto in quella modalità.

Schermata in SPP / BLE mode

In modalità Bluetooth (SPP Classic o BLE NUS), il menu Network presenta:

=== Network ===

[t] Toggle WiFi (On, RSSI -45 dBm)
[n] Scan networks
[s] SSID (MyNetwork)
[p] WiFi password (*****)
[v] Toggle PVT (On, 2947, 2c, 4.5MB)
[c] Clear all
[x] Back

In SPP/BLE WiFi e PVT sono opt-in: l’utente decide se attivarli per ricevere/inviare corrections NTRIP o per esporre lo stream NMEA via TCP.

Nota

Il tasto [V] (maiuscolo) è un hotkey nascosto che apre il sotto-menu PVT Server per cambiare la porta TCP. Non compare nell’elenco delle voci a video ma è accettato dal firmware. Vedi sezione «[v] / [V] PVT Server» più sotto.

Schermata in WIFI mode

In modalità WIFI il menu è leggermente diverso: il PVT TCP server è sempre attivo (è l’unica via per accedere al menu remoto), quindi non c’è il toggle [v]. Compaiono invece [q] MQTT e [K] Keep NTRIP/MQTT on mode switch:

=== Network ===

[t] Toggle WiFi (On, RSSI -45 dBm)
[n] Scan networks
[s] SSID (MyNetwork)
[p] WiFi password (*****)
[q] MQTT (On, conn)
[K] Keep NTRIP/MQTT on mode switch (Off)
[c] Clear all
[x] Back

Lo stato del PVT TCP server in WIFI mode è invece visibile nel menu principale (riga PVT-Srv: Online (port 2947, N clients)).

Tasti

Tasto Voce Disponibile in
[t] Toggle WiFi On/Off Tutte (solo se SSID+pwd ok)
[n] Scan reti WiFi Tutte
[s] Edita SSID Tutte
[p] Edita Password WiFi Tutte
[v] Toggle PVT TCP Server Solo SPP/BLE
[V] Entra sub-menu PVT Server Solo SPP/BLE
[q] Entra sub-menu MQTT publisher Solo WIFI
[K] Toggle «Keep NTRIP/MQTT on mode switch» Solo WIFI
[c] Clear all (reset config rete) Tutte
[x] Back al menu principale Tutte

[t] Toggle WiFi

Accende/spegne il WiFi STA. Visibile solo se sono già configurati SSID + password (altrimenti accendere il WiFi non avrebbe effetto).

Stato visibile a destra:

  • On, RSSI -NN dBm — connesso, signal strength in decibel-milliwatt (-30 = ottimo, -50 = buono, -70 = mediocre, < -80 = scarso)
  • On (connecting...) — handshake in corso
  • Off — disabilitato dall’utente

In modalità WIFI il WiFi è forzato On all’avvio se SSID configurato (necessario per il funzionamento). In SPP/BLE è opt-in.

[n] Scan networks

Lancia uno scan WiFi e mostra le reti rilevate ordinate per RSSI decrescente:

=== Reti disponibili ===

[1] MyHomeWiFi          RSSI -42 dBm
[2] OfficeNetwork       RSSI -55 dBm
[3] Wind3-HUB-0BCB9C    RSSI -68 dBm
...
[x] Annulla

Scegli rete (1-N):

Premi il numero della rete per pre-popolare il campo SSID. Devi poi inserire manualmente la password con [p].

[s] SSID

Apre un prompt per inserire o modificare il nome della rete WiFi:

SSID (lascia vuoto per cancellare):
>

Stringa max 32 caratteri. Salvato in NVS. Cancellando il SSID, il WiFi non parte al boot successivo (in modalità WIFI scatta il Soft AP fallback, vedi Primo avvio del ricevitore).

[p] Password

Apre un prompt per inserire o modificare la password WiFi (mascherata):

Password (lascia vuoto per cancellare):
>

Stringa max 64 caratteri. WPA2-PSK supportato. Salvato in NVS (in plaintext: il device deve poterla riusare al boot).

[v] / [V] PVT Server (solo SPP/BLE)

Solo in SPP/BLE è possibile attivare/disattivare il PVT TCP server (porta 2947 GPSD-like):

  • [v] (minuscolo) — toggle rapido on/off

  • [V] (maiuscolo) — entra in submenu per cambiare la porta:

    === PVT Server ===

Status: On   Port: 2947   Clients: 2

[o] Port (2947)
[t] Toggle PVT Server (On)
[x] Back
    • [o] apre prompt numerico per cambiare la porta (1-65535).
    • [t] toggle on/off del server.
    • [x] torna a Network.

In WIFI mode il PVT TCP server è obbligatoriamente sempre attivo (unica via di accesso menu) e questa voce non compare.

[q] MQTT (solo WIFI)

Apre il submenu MQTT publisher. Visibile solo in modalità WIFI (MQTT richiede WiFi e non funziona in SPP/BLE).

Stato visibile a destra:

  • Off — disabilitato
  • On, conn — abilitato e connesso al broker
  • On, off-line — abilitato ma broker irraggiungibile
  • On, standby - attivo solo in Rover — abilitato ma device in Base/Caster (vedi MQTT publisher)

Vedi pagina dedicata MQTT publisher per tutti i dettagli.

[K] Keep NTRIP/MQTT on mode switch (solo WIFI)

Flag che controlla cosa succede a NTRIP Client/Server/MQTT quando l’utente cambia modalità radio (SPP ↔ BLE ↔ WIFI):

  • Off (default) — cambio modalità resetta lo stato dei servizi: il ricevitore riparte come Rover standalone senza NTRIP/MQTT.
  • On — cambio modalità preserva la configurazione attiva: NTRIP Client/Server e MQTT ripartono come prima nella nuova modalità.

Default Off pensato per evitare sorprese: l’utente che cambia radio si trova sempre in stato «pulito». Attiva On se vuoi che le tue configurazioni di rete persistano attraverso i cambi di modalità.

Vedi Modalità radio (SRA) per i dettagli.

[c] Clear all

Cancella tutte le impostazioni di rete in NVS:

  • SSID
  • Password WiFi
  • PVT Server enabled
  • PVT Port (riportata a default 2947)

Non cancella: config MQTT, config NTRIP Client/Server. Per resettare quelle vedi Restart e Factory Reset.

Operazione immediata, niente conferma. Usa con cautela.

Persistenza NVS

Tutte le impostazioni del menu Network sono salvate nella partizione NVS (namespace gnss / ntrip):

  • SSID + password → wifi_ssid / wifi_pass
  • PVT port + enabled → pvt_port / pvt_en
  • Keep on mode switch → mode_keep_nt
  • MQTT config completa → varie chiavi mqtt_*

Tutte sopravvivono a reboot, OTA, cambio modalità (a meno di «Clear all» o flag «Keep on mode switch»).

Soft AP fallback

Se in modalità WIFI il ricevitore non ha SSID configurato in NVS (SSID vuoto, condizione tipica out-of-the-box o dopo [c] Clear all), avvia automaticamente un Soft Access Point per permettere la prima configurazione senza Bluetooth.

Il Soft AP non si attiva se SSID è configurato ma la rete è irraggiungibile o la password è errata: in quel caso il WiFi STA continua a ritentare la connessione indefinitamente. Per forzare l’AP fallback usa [c] Clear all (svuota SSID e password) e riavvia.

Vedi Primo avvio del ricevitore sezione «Prima configurazione WiFi (Soft AP)» per le caratteristiche complete dell’AP (canale, IP, max client).

Pagine correlate