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 apre ws://<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

StradaGateway nell’appProtocolloPortaQuando conviene
Signal K direttoSignal K (JSON)Signal K (WebSocket)3000Il caso normale. L’app legge direttamente i dati Signal K.
Uscita NMEA 0183 del serverSignal KTCP10110Se 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.1 con l’indirizzo IP o il nome host del tuo server, per esempio 192.168.1.50 o signalk.local. La porta resta 3000, a meno che tu non l’abbia cambiata sul server. I nomi con .local funzionano 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

PercorsoValore nel diario di bordo
navigation.positionposizione
navigation.gnss.horizontalDilutionprecisione GPS
navigation.speedOverGroundvelocità effettiva
navigation.courseOverGroundTruerotta effettiva
navigation.headingTrueprora vera
navigation.attitudesbandamento e assetto
navigation.log, navigation.trip.logcontamiglia (totale, parziale)

Vento, acqua, meteo

PercorsoValore nel diario di bordo
environment.wind.directionTruedirezione del vento reale
environment.wind.speedOverGroundvelocità del vento reale
environment.wind.angleApparentangolo del vento apparente
environment.wind.speedApparentvelocità del vento apparente
environment.depth.belowTransducer, .belowSurface, .belowKeelprofondità dell’acqua
environment.water.temperaturetemperatura dell’acqua
environment.outside.temperaturetemperatura dell’aria
environment.outside.pressurepressione atmosferica
environment.currentcorrente (direzione, velocità)

Motore, serbatoi, batterie

PercorsoValore nel diario di bordo
propulsion.<id>.revolutionsgiri motore
propulsion.<id>.runTimeore motore
tanks.fuel.<id>.currentLevel, .currentVolumeserbatoio carburante
tanks.freshWater.<id>.currentLevel, .currentVolumeserbatoio acqua dolce
tanks.wasteWater.<id>.currentLevel, .currentVolumeserbatoio acque grigie
electrical.batteries.<id>.voltagetensione batteria
electrical.batteries.<id>.capacity.stateOfChargestato 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 percorsoNumero nell’app
0, starboard, stb, main1
1, port2
2, center, centre3
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 vediCausaSoluzione
«… non è raggiungibile»Wi-Fi sbagliato o indirizzo sbagliatoControlla 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 HTTPSControlla 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 luiConsenti l’accesso in lettura senza login (vedi sotto). Controlla nel Data Browser del server se arrivano valori.
La connessione c’è, mancano singoli valoriIl percorso non esiste sul server o l’identificativo non viene riconosciutoCerca il percorso esatto nel Data Browser e confrontalo con le tabelle qui sopra.
I valori ci sono, ma non nell’annotazioneLa fonte Signal K non è al primo postoModifica 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

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.