Conoscenza · Guida
Collegare Signal K all’app Logbook
L’app Logbook si collega via WebSocket al tuo server Signal K e inserisce posizione, vento, profondità, motore, serbatoi e batterie nelle annotazioni del diario di bordo. Ti servono solo l’indirizzo del server e la porta, di norma la 3000.
Aggiornato: novembre 2026
In breve
- Cosa legge l’app
- posizione, prora, rotta, vento, profondità, temperature, pressione atmosferica, motore, serbatoi, batterie, sbandamento e assetto della tua barca.
- Indirizzo e porta
- indirizzo IP o nome host del tuo server, porta
3000, protocollo «Signal K (WebSocket)». L’app aprews://<server>:3000/signalk/v1/stream?subscribe=self. - Cosa non si può fare
- accesso con nome utente o token e connessioni cifrate (
wss://). Il server deve consentire l’accesso in lettura senza login. - Si parte da qui
- Impostazioni › Fonti dati › Impostazioni di connessione NMEA › scegli il gateway «Signal K (JSON)».
Che cos’è Signal K?
Signal K è un formato dati aperto e gratuito per le barche. Viene sviluppato come progetto open source; la specifica e il server Signal K sono liberamente disponibili. Un server Signal K, di solito su un Raspberry Pi o dentro un dispositivo come il Victron Cerbo GX, raccoglie i dati da NMEA 0183, NMEA 2000 e altre fonti e li mette a disposizione in rete in modo uniforme. Ogni valore ha un nome leggibile, per esempio
environment.depth.belowTransducer, e un’unità fissa.Per te significa: se hai un server Signal K a bordo, all’app non serve un gateway in più.
Due strade verso il server Signal K
| Strada | Gateway nell’app | Protocollo | Porta | Quando conviene |
|---|---|---|---|---|
| Signal K diretto | Signal K (JSON) | Signal K (WebSocket) | 3000 | Il caso normale. L’app legge direttamente i dati Signal K. |
| Uscita NMEA 0183 del server | Signal K | TCP | 10110 | Se il tuo server è configurato per emettere NMEA 0183. |
Questa guida descrive la strada diretta.
Configurazione
- Collega smartphone o tablet al Wi-Fi a cui è collegato il server Signal K.
- Apri Impostazioni › Fonti dati › Impostazioni di connessione NMEA e in «Connessione» tocca la prima riga.
- Scegli Signal K (JSON).
- Sostituisci l’indirizzo preimpostato
192.168.1.1con l’indirizzo IP o il nome host del tuo server, per esempio192.168.1.50osignalk.local. La porta resta3000, a meno che tu non l’abbia cambiata sul server. I nomi con.localfunzionano solo se il server si annuncia in rete via mDNS (Zeroconf, sul Raspberry Pi di solito già attivo). Se il nome non funziona, usa l’indirizzo IP. - Attiva Connessione NMEA. Lo stato mostra «Signal K» e in Dati ricevuti compaiono i valori in tempo reale.
- Apri Impostazioni › Fonti dati › Definisci le fonti dei dati e per ogni valore che ti interessa trascina la fonte Signal K al primo posto. Solo così i valori finiscono nelle tue annotazioni.
Tecnicamente l’app apre l’indirizzo
ws://<server>:<port>/signalk/v1/stream?subscribe=self e legge i messaggi delta della tua barca. I dati di altre imbarcazioni, per esempio i bersagli AIS, li ignora.Percorsi Signal K supportati
L’app converte da sola le unità SI di Signal K: radianti in gradi, m/s in nodi, kelvin in °C, pascal in hPa.
Navigazione
| Percorso | Valore nel diario di bordo |
|---|---|
navigation.position | posizione |
navigation.gnss.horizontalDilution | precisione GPS |
navigation.speedOverGround | velocità effettiva |
navigation.courseOverGroundTrue | rotta effettiva |
navigation.headingTrue | prora vera |
navigation.attitude | sbandamento e assetto |
navigation.log, navigation.trip.log | contamiglia (totale, parziale) |
Vento, acqua, meteo
| Percorso | Valore nel diario di bordo |
|---|---|
environment.wind.directionTrue | direzione del vento reale |
environment.wind.speedOverGround | velocità del vento reale |
environment.wind.angleApparent | angolo del vento apparente |
environment.wind.speedApparent | velocità del vento apparente |
environment.depth.belowTransducer, .belowSurface, .belowKeel | profondità dell’acqua |
environment.water.temperature | temperatura dell’acqua |
environment.outside.temperature | temperatura dell’aria |
environment.outside.pressure | pressione atmosferica |
environment.current | corrente (direzione, velocità) |
Motore, serbatoi, batterie
| Percorso | Valore nel diario di bordo |
|---|---|
propulsion.<id>.revolutions | giri motore |
propulsion.<id>.runTime | ore motore |
tanks.fuel.<id>.currentLevel, .currentVolume | serbatoio carburante |
tanks.freshWater.<id>.currentLevel, .currentVolume | serbatoio acqua dolce |
tanks.wasteWater.<id>.currentLevel, .currentVolume | serbatoio acque grigie |
electrical.batteries.<id>.voltage | tensione batteria |
electrical.batteries.<id>.capacity.stateOfCharge | stato di carica |
Come l’app numera motori, serbatoi e batterie
In Signal K ogni motore, serbatoio e batteria ha un identificativo (
<id>). L’app li assegna così:| Identificativo nel percorso | Numero nell’app |
|---|---|
0, starboard, stb, main | 1 |
1, port | 2 |
2, center, centre | 3 |
Altri identificativi, per esempio
house o starter, per ora l’app non li riconosce. Rinomina l’identificativo sul server oppure fammelo sapere e lo aggiungo.Profondità: quale percorso?
Signal K conosce tre profondità: sotto il trasduttore, sotto la superficie dell’acqua e sotto la chiglia. L’app le mostra tutte e tre come fonti distinte. Nell’ordine delle fonti dati scegli quella che vuoi avere nel diario di bordo.
L’offset delle impostazioni NMEA viene sommato a ogni profondità. Se usi
belowSurface, in cui il tuo server ha già messo in conto la distanza del trasduttore, imposta l’offset nell’app su 0.Risoluzione dei problemi
| Cosa vedi | Causa | Soluzione |
|---|---|---|
| «… non è raggiungibile» | Wi-Fi sbagliato o indirizzo sbagliato | Controlla se riesci ad aprire l’interfaccia di Signal K nel browser all’indirizzo http://<server>:3000. |
| «… è raggiungibile, ma nessun servizio risponde sulla porta …» | Porta sbagliata oppure il server funziona solo via HTTPS | Controlla la porta. L’app ha bisogno di una connessione non cifrata (ws://). |
| «Non arrivano dati sulla porta …» | Il server richiede un login oppure non ha dati nemmeno lui | Consenti l’accesso in lettura senza login (vedi sotto). Controlla nel Data Browser del server se arrivano valori. |
| La connessione c’è, mancano singoli valori | Il percorso non esiste sul server o l’identificativo non viene riconosciuto | Cerca il percorso esatto nel Data Browser e confrontalo con le tabelle qui sopra. |
| I valori ci sono, ma non nell’annotazione | La fonte Signal K non è al primo posto | Modifica l’ordine delle fonti dati. |
Login sul server: l’app non può autenticarsi con nome utente o token. Ho fatto i test con un server senza sicurezza attivata, e così funziona in modo affidabile. Se da te la sicurezza è attiva, consenti sul server l’accesso in lettura senza login («Allow Readonly Access»). Questo non l’ho ancora provato di persona. Che da te funzioni o no, mi fa piacere ricevere un breve riscontro.
Cosa non si può fare
- Accesso con nome utente, password o token.
- Connessioni cifrate (
wss://o HTTPS). - Ricerca automatica del server in rete. L’indirizzo lo inserisci tu.
- Scrivere dati sul server Signal K. L’app legge soltanto.
- Bersagli AIS e altre imbarcazioni.
Ti serve una di queste cose? Fammelo sapere. Faccio del mio meglio per trovare una soluzione.
Per approfondire
- signalk.org: sito del progetto con introduzione e guide all’installazione
- Specifica Signal K: tutti i percorsi e le unità nel dettaglio
- Server Signal K su GitHub: il server vero e proprio, con indicazioni su sicurezza e permessi di accesso
- Differenza tra NMEA 0183, NMEA 2000 e Signal K
Domande frequenti
L’app Logbook supporta Signal K?
Sì. Dalla versione 2.92 (iOS) e 1.36 (Android) l’app si collega via WebSocket a un server Signal K e inserisce i valori nelle annotazioni del diario di bordo. La funzione è gratuita.
Che porta usa Signal K?
Di fabbrica il server Signal K usa la porta 3000 per l’interfaccia web e lo stream WebSocket. L’uscita NMEA 0183 del server passa di solito dalla porta TCP 10110.
Con Signal K mi serve ancora un gateway NMEA?
No. Il gateway è il server Signal K. Deve essere collegato a sua volta alla tua rete NMEA 0183 o NMEA 2000, per esempio tramite un adattatore USB.
Funziona con un Victron Cerbo GX o con Venus OS?
Sì, se lì il server Signal K è attivato ed è leggibile sul Wi-Fi sulla porta 3000 senza login. Se da te dovesse comunque fare i capricci, scrivimi. Lo faccio funzionare.
L’app può autenticarsi sul server Signal K?
No. L’app ha bisogno dell’accesso in lettura senza login attraverso una connessione WebSocket non cifrata (
ws://).Cosa è meglio: Signal K o NMEA diretto?
Se hai già un server Signal K, usa Signal K. Ricevi tutte le fonti della tua barca con una sola connessione. Se non ce l’hai, un gateway NMEA-Wi-Fi è la strada più semplice.