Risoluzione problemi
Il veicolo non si connette
Sintomo: L'indicatore rimane rosso anche dopo aver premuto Connetti.
- Verifica che il link radio (HM30, MK32, telemetry) sia acceso e associato
- Controlla che il profilo di connessione usi l'IP e la porta corretti
- Se condividi il link tra più GCS, verifica che il relay integrato sia attivo su ogni postazione (profilo SIYI in Impostazioni di connessione)
- Prova a pingare l'IP del link:
ping 192.168.144.20
Heartbeat ricevuto ma nessun dato telemetrico
Sintomo: Indicatore giallo, nessun dato HUD.
- ArduPilot potrebbe non inviare stream: usa Connessione → Richiedi stream per forzare
REQUEST_DATA_STREAM - Verifica che
SR0_*oSR1_*siano impostati a valori > 0 nei parametri
Upload missione fallisce
- Verifica che il veicolo sia connesso e stia ricevendo heartbeat
- Controlla che la missione non contenga waypoint con coordinate
0,0 - Prova a scaricare prima la missione esistente, poi fare un nuovo upload
Parametri non si aggiornano
Se PARAM_SET non riceve risposta:
- Aumenta il timeout in Impostazioni → Connessione → Timeout
- Verifica che il link non sia saturo (es. streaming video ad alta frequenza)
Log e diagnostica
Harlock registra continuamente le notifiche mostrate all'operatore, i messaggi di stato dell'autopilota, le conferme critiche, i comandi dell'operatore e la diagnostica del backend. Ogni evento viene aggiunto e sincronizzato subito su disco: i record completati sopravvivono a un crash o a uno spegnimento improvviso.
Apri Avanzate → Logs per vedere e copiare il percorso esatto del file JSONL corrente. Harlock usa la directory dei log dell'applicazione prevista dal sistema operativo, sia su Windows sia su Android. I file ruotano a 10 MiB e l'applicazione conserva al massimo 100 MiB in locale; non vengono caricati sulla SABROBOTIX Suite.
I timestamp sono istanti UTC di ricezione alla stazione di terra, affiancati dal tempo monotono
trascorso dall'avvio. Per confrontarli con un log .bin dell'autopilota usa il tempo UTC/GPS.
Segnalare un bug
Apri una issue su GitHub con:
- Versione Harlock (visibile in About)
- Sistema operativo e versione
- Passi per riprodurre il problema
- Log dell'app (vedi sopra)