Conocimiento · Guía
Conectar Signal K con la app Logbook
La app Logbook se conecta por WebSocket a tu servidor Signal K e incorpora posición, viento, profundidad, motor, depósitos y baterías a las entradas de tu bitácora. Solo necesitas la dirección del servidor y el puerto, normalmente el 3000.
Actualizado: noviembre de 2026
En resumen
- Qué lee la app
- posición, rumbo, viento, profundidad, temperaturas, presión atmosférica, motor, depósitos, baterías, escora y asiento de tu propio barco.
- Dirección y puerto
- dirección IP o nombre de host de tu servidor, puerto
3000, protocolo «Signal K (WebSocket)». La app abrews://<server>:3000/signalk/v1/stream?subscribe=self. - Lo que no se puede hacer
- inicio de sesión con nombre de usuario o token y conexiones cifradas (
wss://). El servidor tiene que permitir el acceso de lectura sin iniciar sesión. - Para empezar
- Ajustes › Fuentes de datos › Configuración de la conexión NMEA › elegir la pasarela «Signal K (JSON)».
¿Qué es Signal K?
Signal K es un formato de datos abierto y gratuito para barcos. Se desarrolla como proyecto de código abierto; la especificación y el servidor Signal K están disponibles libremente. Un servidor Signal K, normalmente en una Raspberry Pi o en un equipo como el Victron Cerbo GX, recoge los datos de NMEA 0183, NMEA 2000 y otras fuentes y los ofrece de forma unificada en la red. Cada valor tiene un nombre legible, por ejemplo
environment.depth.belowTransducer, y una unidad fija.Para ti significa que, si tienes un servidor Signal K a bordo, la app no necesita ninguna pasarela adicional.
Dos caminos hacia el servidor Signal K
| Camino | Pasarela en la app | Protocolo | Puerto | Cuándo conviene |
|---|---|---|---|---|
| Signal K directo | Signal K (JSON) | Signal K (WebSocket) | 3000 | El caso normal. La app lee ella misma los datos de Signal K. |
| Salida NMEA 0183 del servidor | Signal K | TCP | 10110 | Si tu servidor está configurado para emitir NMEA 0183. |
Esta guía describe el camino directo.
Configuración
- Conecta el móvil o la tableta a la wifi en la que está el servidor Signal K.
- Abre Ajustes › Fuentes de datos › Configuración de la conexión NMEA y toca la primera línea en «Conexión».
- Elige Signal K (JSON).
- Sustituye la dirección predeterminada
192.168.1.1por la dirección IP o el nombre de host de tu servidor, por ejemplo192.168.1.50osignalk.local. El puerto sigue siendo3000, salvo que lo hayas cambiado en el servidor. Los nombres con.localsolo funcionan si el servidor se anuncia en la red por mDNS (Zeroconf, que en la Raspberry Pi suele estar ya activo). Si el nombre no funciona, usa la dirección IP. - Activa Conexión NMEA. El estado muestra «Signal K», y en Datos recibidos aparecen los valores en tiempo real.
- Abre Ajustes › Fuentes de datos › Establecer fuentes de datos y, para cada valor que quieras, arrastra la fuente Signal K al primer lugar. Solo entonces los valores llegan a tus entradas.
Técnicamente, la app abre la dirección
ws://<server>:<port>/signalk/v1/stream?subscribe=self y lee los mensajes delta de tu propio barco. Los datos de otros barcos, por ejemplo los blancos AIS, los ignora.Rutas de Signal K compatibles
La app convierte por sí sola las unidades SI de Signal K: radianes a grados, m/s a nudos, kelvin a °C y pascales a hPa.
Navegación
| Ruta | Valor en la bitácora |
|---|---|
navigation.position | Posición |
navigation.gnss.horizontalDilution | Precisión del GPS |
navigation.speedOverGround | Velocidad sobre el fondo |
navigation.courseOverGroundTrue | Rumbo sobre el fondo |
navigation.headingTrue | rumbo verdadero |
navigation.attitude | Escora y asiento |
navigation.log, navigation.trip.log | Corredera (total, parcial) |
Viento, agua, meteorología
| Ruta | Valor en la bitácora |
|---|---|
environment.wind.directionTrue | dirección del viento real |
environment.wind.speedOverGround | intensidad del viento real |
environment.wind.angleApparent | ángulo del viento aparente |
environment.wind.speedApparent | intensidad del viento aparente |
environment.depth.belowTransducer, .belowSurface, .belowKeel | Profundidad del agua |
environment.water.temperature | Temperatura del agua |
environment.outside.temperature | Temperatura del aire |
environment.outside.pressure | Presión atmosférica |
environment.current | Corriente (dirección, intensidad) |
Motor, depósitos, baterías
| Ruta | Valor en la bitácora |
|---|---|
propulsion.<id>.revolutions | Régimen del motor |
propulsion.<id>.runTime | Horas de funcionamiento |
tanks.fuel.<id>.currentLevel, .currentVolume | Depósito de combustible |
tanks.freshWater.<id>.currentLevel, .currentVolume | Depósito de agua dulce |
tanks.wasteWater.<id>.currentLevel, .currentVolume | Depósito de aguas grises |
electrical.batteries.<id>.voltage | Tensión de la batería |
electrical.batteries.<id>.capacity.stateOfCharge | Estado de carga |
Cómo numera la app motores, depósitos y baterías
En Signal K, cada motor, depósito y batería tiene un identificador (
<id>). La app los asigna así:| Identificador en la ruta | Número en la app |
|---|---|
0, starboard, stb, main | 1 |
1, port | 2 |
2, center, centre | 3 |
Otros identificadores, por ejemplo
house o starter, la app no los reconoce por ahora. Cambia el nombre del identificador en el servidor o ponte en contacto conmigo y lo incorporo.Profundidad del agua: ¿qué ruta?
Signal K conoce tres profundidades: bajo el transductor, bajo la superficie del agua y bajo la quilla. La app muestra las tres como fuentes independientes. Elige en el orden de las fuentes de datos la que quieras tener en la bitácora.
La desviación de los ajustes de NMEA se suma a cada profundidad. Si usas
belowSurface, en la que tu servidor ya ha tenido en cuenta la distancia del transductor, pon la desviación de la app en 0.Solución de problemas
| Lo que ves | Causa | Solución |
|---|---|---|
| «No se puede acceder a …» | Wifi equivocada o dirección incorrecta | Comprueba si puedes abrir la interfaz de Signal K en el navegador en http://<server>:3000. |
| «Se puede acceder a …, pero no hay ningún servicio que responda en el puerto …» | Puerto incorrecto o el servidor solo funciona por HTTPS | Comprueba el puerto. La app necesita una conexión sin cifrar (ws://). |
| «No llegan datos al puerto …» | El servidor exige iniciar sesión o él mismo no tiene datos | Permite el acceso de lectura sin iniciar sesión (ver más abajo). Comprueba en el Data Browser del servidor si llegan valores. |
| Hay conexión, pero faltan algunos valores | La ruta no existe en el servidor o no se reconoce el identificador | Busca la ruta exacta en el Data Browser y compárala con las tablas de arriba. |
| Los valores están, pero no en la entrada | La fuente Signal K no está en primer lugar | Ajusta el orden de las fuentes de datos. |
Inicio de sesión en el servidor: la app no puede iniciar sesión con nombre de usuario ni token. He hecho las pruebas con un servidor sin la seguridad activada, y así funciona de forma fiable. Si tú tienes la seguridad activada, permite en el servidor el acceso de lectura sin iniciar sesión («Allow Readonly Access»). Esto todavía no lo he probado yo mismo. Tanto si te funciona como si no, te agradezco un breve comentario.
Lo que no se puede hacer
- Inicio de sesión con nombre de usuario, contraseña o token.
- Conexiones cifradas (
wss://o HTTPS). - Detección automática del servidor en la red. La dirección la introduces tú.
- Escribir datos de vuelta en el servidor Signal K. La app solo lee.
- Blancos AIS y otros barcos.
¿Necesitas algo de esto? Ponte en contacto conmigo. Haré todo lo posible por encontrar una solución.
Más información
- signalk.org: web del proyecto con introducción y guías de instalación
- Especificación de Signal K: todas las rutas y unidades en detalle
- Servidor Signal K en GitHub: el propio servidor, con indicaciones sobre seguridad y permisos de acceso
- Diferencia entre NMEA 0183, NMEA 2000 y Signal K
Preguntas frecuentes
¿La app Logbook es compatible con Signal K?
Sí. A partir de la versión 2.92 (iOS) y 1.36 (Android), la app se conecta por WebSocket a un servidor Signal K e incorpora los valores a las entradas de la bitácora. La función es gratuita.
¿Qué puerto usa Signal K?
De fábrica, el servidor Signal K usa el puerto 3000 para la interfaz web y el flujo WebSocket. La salida NMEA 0183 del servidor suele ir por el puerto TCP 10110.
¿Sigo necesitando una pasarela NMEA con Signal K?
No. El servidor Signal K es la pasarela. Él mismo tiene que estar conectado a tu red NMEA 0183 o NMEA 2000, por ejemplo mediante un adaptador USB.
¿Funciona con un Victron Cerbo GX o con Venus OS?
Sí, siempre que allí esté activado el servidor Signal K y se pueda leer en la wifi por el puerto 3000 sin iniciar sesión. Si aun así te da problemas, escríbeme y lo pongo en marcha.
¿Puede la app iniciar sesión en el servidor Signal K?
No. La app necesita acceso de lectura sin iniciar sesión a través de una conexión WebSocket sin cifrar (
ws://).¿Qué es mejor: Signal K o NMEA directo?
Si ya tienes un servidor Signal K, usa Signal K. Recibes todas las fuentes de tu barco por una sola conexión. Si no lo tienes, una pasarela NMEA a wifi es el camino más sencillo.