Savoir · Guide

Connecter Signal K à l’appli Logbook

L’appli journal de bord Logbook se connecte en WebSocket à ton serveur Signal K et reprend la position, le vent, la profondeur, le moteur, les réservoirs et les batteries dans tes entrées de journal de bord. Il te faut seulement l’adresse du serveur et le port, en général 3000.

Mis à jour: novembre 2026

En bref

Ce que lit l’appli 
position, cap, vent, profondeur, températures, pression atmosphérique, moteur, réservoirs, batteries, gîte et assiette de ton propre bateau.
Adresse et port 
adresse IP ou nom d’hôte de ton serveur, port 3000, protocole « Signal K (WebSocket) ». L’appli ouvre ws://<server>:3000/signalk/v1/stream?subscribe=self.
Ce qui n’est pas possible 
l’authentification par nom d’utilisateur ou jeton et les connexions chiffrées (wss://). Le serveur doit autoriser l’accès en lecture sans authentification.
C’est parti 
Réglages › Sources de données › Paramètres de connexion NMEA › choisir la passerelle « Signal K (JSON) ».

Signal K, c’est quoi ?

Signal K est un format de données ouvert et gratuit pour les bateaux. Il est développé comme projet open source ; la spécification et le serveur Signal K sont en libre accès. Un serveur Signal K, le plus souvent sur un Raspberry Pi ou dans un appareil comme le Victron Cerbo GX, rassemble les données de NMEA 0183, de NMEA 2000 et d’autres sources et les diffuse sur le réseau sous une forme unifiée. Chaque valeur a un nom lisible, par exemple environment.depth.belowTransducer, et une unité fixe.
Pour toi, ça veut dire : si tu as un serveur Signal K à bord, l’appli n’a besoin d’aucune passerelle supplémentaire.

Deux façons d’accéder au serveur Signal K

VoiePasserelle dans l’appliProtocolePortQuand l’utiliser
Signal K en directSignal K (JSON)Signal K (WebSocket)3000Le cas normal. L’appli lit elle-même les données Signal K.
Sortie NMEA 0183 du serveurSignal KTCP10110Si ton serveur est configuré pour émettre du NMEA 0183.
Ce guide décrit la voie directe.

Configuration

  • Connecte ton téléphone ou ta tablette au Wi-Fi sur lequel se trouve le serveur Signal K.
  • Ouvre Réglages › Sources de données › Paramètres de connexion NMEA et touche la première ligne sous « Connexion ».
  • Choisis Signal K (JSON).
  • Remplace l’adresse préréglée 192.168.1.1 par l’adresse IP ou le nom d’hôte de ton serveur, par exemple 192.168.1.50 ou signalk.local. Le port reste 3000, sauf si tu l’as modifié sur le serveur. Les noms en .local ne fonctionnent que si le serveur s’annonce sur le réseau par mDNS (Zeroconf, en général déjà actif sur le Raspberry Pi). Si le nom ne passe pas, prends l’adresse IP.
  • Active Connexion NMEA. Le statut affiche « Signal K », et les valeurs en direct apparaissent sous Données reçues.
  • Ouvre Réglages › Sources de données › Définir les sources de données et fais glisser la source Signal K en première position pour chaque valeur souhaitée. C’est seulement là que les valeurs arrivent dans tes entrées.
Techniquement, l’appli ouvre l’adresse ws://<server>:<port>/signalk/v1/stream?subscribe=self et lit les messages delta de ton propre bateau. Elle ignore les données des autres bateaux, par exemple les cibles AIS.

Chemins Signal K pris en charge

L’appli convertit elle-même les unités SI de Signal K : radians en degrés, m/s en nœuds, kelvins en °C, pascals en hPa.

Navigation

CheminValeur dans le journal de bord
navigation.positionposition
navigation.gnss.horizontalDilutionprécision du GPS
navigation.speedOverGroundvitesse fond
navigation.courseOverGroundTrueroute fond
navigation.headingTruecap vrai
navigation.attitudegîte et assiette
navigation.log, navigation.trip.logdistance loch (totale, trip)

Vent, eau, météo

CheminValeur dans le journal de bord
environment.wind.directionTruedirection du vent réel
environment.wind.speedOverGroundvitesse du vent réel
environment.wind.angleApparentangle du vent apparent
environment.wind.speedApparentvitesse du vent apparent
environment.depth.belowTransducer, .belowSurface, .belowKeelprofondeur
environment.water.temperaturetempérature de l’eau
environment.outside.temperaturetempérature de l’air
environment.outside.pressurepression atmosphérique
environment.currentcourant (direction, force)

Moteur, réservoirs, batteries

CheminValeur dans le journal de bord
propulsion.<id>.revolutionsrégime moteur
propulsion.<id>.runTimeheures moteur
tanks.fuel.<id>.currentLevel, .currentVolumeréservoir de carburant
tanks.freshWater.<id>.currentLevel, .currentVolumeréservoir d’eau douce
tanks.wasteWater.<id>.currentLevel, .currentVolumeréservoir d’eaux grises
electrical.batteries.<id>.voltagetension de la batterie
electrical.batteries.<id>.capacity.stateOfChargeétat de charge

Comment l’appli numérote moteurs, réservoirs et batteries

Dans Signal K, chaque moteur, chaque réservoir et chaque batterie a un identifiant (<id>). L’appli les associe ainsi :
Identifiant dans le cheminNuméro dans l’appli
0, starboard, stb, main1
1, port2
2, center, centre3
Pour l’instant, l’appli ne reconnaît pas les autres identifiants, par exemple house ou starter. Renomme l’identifiant sur le serveur ou fais-moi signe, et je l’ajoute.

Profondeur : quel chemin ?

Signal K connaît trois profondeurs : sous la sonde, sous la surface et sous la quille. L’appli affiche chacune comme une source distincte. Dans l’ordre des sources de données, choisis celle que tu veux voir dans le journal de bord.
Le décalage des réglages NMEA s’ajoute à chaque profondeur. Si tu prends belowSurface, dans laquelle ton serveur a déjà intégré la distance de la sonde, mets le décalage à 0 dans l’appli.

Dépannage

Ce que tu voisCauseSolution
« … n’est pas accessible »Mauvais Wi-Fi ou mauvaise adresseVérifie que tu peux ouvrir l’interface Signal K dans le navigateur à l’adresse http://<server>:3000.
« … est accessible, mais aucun service ne répond sur le port … »Mauvais port, ou le serveur ne fonctionne qu’en HTTPSVérifie le port. L’appli a besoin d’une connexion non chiffrée (ws://).
« Aucune donnée n’arrive sur le port … »Le serveur exige une authentification ou n’a lui-même aucune donnéeAutorise l’accès en lecture sans authentification (voir plus bas). Vérifie dans le Data Browser du serveur que des valeurs arrivent.
La connexion est établie, certaines valeurs manquentLe chemin n’existe pas sur le serveur ou l’identifiant n’est pas reconnuCherche le chemin exact dans le Data Browser et compare-le aux tableaux ci-dessus.
Les valeurs sont là, mais pas dans l’entréeLa source Signal K n’est pas en première positionModifie l’ordre des sources de données.
Authentification sur le serveur : l’appli ne peut pas s’authentifier avec un nom d’utilisateur ou un jeton. J’ai fait mes tests avec un serveur dont la sécurité n’était pas activée ; dans ce cas, ça fonctionne de façon fiable. Si la sécurité est activée chez toi, autorise sur le serveur l’accès en lecture sans authentification (« Allow Readonly Access »). Je ne l’ai pas encore essayé moi-même. Que ça marche chez toi ou non, je suis preneur d’un petit retour.

Ce qui n’est pas possible

  • L’authentification par nom d’utilisateur, mot de passe ou jeton.
  • Les connexions chiffrées (wss:// ou HTTPS).
  • La détection automatique du serveur sur le réseau. Tu saisis l’adresse toi-même.
  • L’écriture de données vers le serveur Signal K. L’appli se contente de lire.
  • Les cibles AIS et les autres bateaux.
Tu as besoin de l’une de ces fonctions ? Fais-moi signe. Je fais de mon mieux pour trouver une solution.

Pour aller plus loin

Questions fréquentes

L’appli Logbook prend-elle en charge Signal K ?

Oui. À partir de la version 2.92 (iOS) et 1.36 (Android), l’appli se connecte en WebSocket à un serveur Signal K et reprend les valeurs dans les entrées de journal de bord. La fonction est gratuite.

Quel port utilise Signal K ?

Par défaut, le serveur Signal K utilise le port 3000 pour l’interface web et le flux WebSocket. La sortie NMEA 0183 du serveur passe habituellement par le port TCP 10110.

Avec Signal K, ai-je encore besoin d’une passerelle NMEA ?

Non. Le serveur Signal K fait office de passerelle. Il doit lui-même être relié à ton réseau NMEA 0183 ou NMEA 2000, par exemple par un adaptateur USB.

Ça fonctionne avec un Victron Cerbo GX ou Venus OS ?

Oui, si le serveur Signal K y est activé et lisible sans authentification sur le Wi-Fi, port 3000. Si ça coince malgré tout chez toi, écris-moi. Je ferai en sorte que ça marche.

L’appli peut-elle s’authentifier sur le serveur Signal K ?

Non. L’appli a besoin d’un accès en lecture sans authentification, par une connexion WebSocket non chiffrée (ws://).

Lequel vaut mieux : Signal K ou NMEA en direct ?

Si tu as déjà un serveur Signal K, prends Signal K. Tu obtiens toutes les sources de ton bateau par une seule connexion. Si tu n’en as pas, une passerelle NMEA vers Wi-Fi est la solution la plus simple.