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 ouvrews://<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
| Voie | Passerelle dans l’appli | Protocole | Port | Quand l’utiliser |
|---|---|---|---|---|
| Signal K en direct | Signal K (JSON) | Signal K (WebSocket) | 3000 | Le cas normal. L’appli lit elle-même les données Signal K. |
| Sortie NMEA 0183 du serveur | Signal K | TCP | 10110 | Si 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.1par l’adresse IP ou le nom d’hôte de ton serveur, par exemple192.168.1.50ousignalk.local. Le port reste3000, sauf si tu l’as modifié sur le serveur. Les noms en.localne 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
| Chemin | Valeur dans le journal de bord |
|---|---|
navigation.position | position |
navigation.gnss.horizontalDilution | précision du GPS |
navigation.speedOverGround | vitesse fond |
navigation.courseOverGroundTrue | route fond |
navigation.headingTrue | cap vrai |
navigation.attitude | gîte et assiette |
navigation.log, navigation.trip.log | distance loch (totale, trip) |
Vent, eau, météo
| Chemin | Valeur dans le journal de bord |
|---|---|
environment.wind.directionTrue | direction du vent réel |
environment.wind.speedOverGround | vitesse du vent réel |
environment.wind.angleApparent | angle du vent apparent |
environment.wind.speedApparent | vitesse du vent apparent |
environment.depth.belowTransducer, .belowSurface, .belowKeel | profondeur |
environment.water.temperature | température de l’eau |
environment.outside.temperature | température de l’air |
environment.outside.pressure | pression atmosphérique |
environment.current | courant (direction, force) |
Moteur, réservoirs, batteries
| Chemin | Valeur dans le journal de bord |
|---|---|
propulsion.<id>.revolutions | régime moteur |
propulsion.<id>.runTime | heures moteur |
tanks.fuel.<id>.currentLevel, .currentVolume | réservoir de carburant |
tanks.freshWater.<id>.currentLevel, .currentVolume | réservoir d’eau douce |
tanks.wasteWater.<id>.currentLevel, .currentVolume | réservoir d’eaux grises |
electrical.batteries.<id>.voltage | tension 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 chemin | Numéro dans l’appli |
|---|---|
0, starboard, stb, main | 1 |
1, port | 2 |
2, center, centre | 3 |
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 vois | Cause | Solution |
|---|---|---|
| « … n’est pas accessible » | Mauvais Wi-Fi ou mauvaise adresse | Vé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 HTTPS | Vé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ée | Autorise 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 manquent | Le chemin n’existe pas sur le serveur ou l’identifiant n’est pas reconnu | Cherche le chemin exact dans le Data Browser et compare-le aux tableaux ci-dessus. |
| Les valeurs sont là, mais pas dans l’entrée | La source Signal K n’est pas en première position | Modifie 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
- signalk.org : le site du projet, avec présentation et guides d’installation
- Spécification Signal K : tous les chemins et unités en détail
- Serveur Signal K sur GitHub : le serveur lui-même, avec des indications sur la sécurité et les droits d’accès
- Différence entre NMEA 0183, NMEA 2000 et Signal K
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.