Novedad: datos en directo de tu barco vía Signal K — cómo configurarlo
Consulta en ClearShip en cualquier momento la posición, el viento, la profundidad y la batería de tu barco. El nuevo plugin de Signal K se configura en pocos minutos: esta es la guía completa.
Tu barco está fondeado en una cala, tú estás en casa y no tienes ni idea de si la batería aguanta, de cuánto sopla ahí fuera o de si el barco sigue donde lo dejaste. Justo para eso están los datos en directo en ClearShip.
Un plugin gratuito para tu servidor Signal K de a bordo envía a ClearShip la posición, el rumbo, la velocidad, el viento, la profundidad, la temperatura, la presión y el estado de la batería. Ves tu barco en el mapa y cada dato de los instrumentos como un mosaico, en el navegador y en la app, desde cualquier lugar.
Beta
El plugin está en una fase beta temprana (0.1.0-beta.5). Envía el estado actual del barco a intervalos fijos, nada más. Todavía no incluye guardia de fondeo, alertas ni registro de la derrota. No cuentes con que los datos lleguen sin interrupciones. Tus comentarios son muy bienvenidos.
Qué necesitas
Configuración en tres pasos
1. Instala el plugin
Abre tu servidor Signal K en el navegador y ve a Appstore. Busca clearship e instala ClearShip Telemetry. Reinicia el servidor cuando Signal K te lo pida.
O directamente en el servidor:
cd ~/.signalk
npm install @welytics/clearship-signalk
sudo systemctl restart signalk
2. Crea un token en ClearShip
En ClearShip: Barco → En directo → Conecta tu barco → Crear token.
El token solo se muestra una vez
Cópialo enseguida. Después, en nuestro lado solo se guarda un hash: el token en sí no se puede volver a mostrar. Perderlo no es ningún drama: basta con crear uno nuevo.
3. Pega el token en el plugin
De vuelta en tu servidor Signal K: Server → Plugin Config → ClearShip Telemetry. Pega el token, activa el plugin y guarda.
La línea de estado del plugin mostrará entonces algo así:
Connected — 12 measurements in 1 frame(s) via delta stream
El número de mediciones (measurements) es la cifra que importa. Si en lugar de un número ves un aviso, el plugin llega bien a ClearShip pero no encuentra datos en Signal K: consulta la solución de problemas.
En ClearShip, la primera posición aparece en menos de un minuto.
Qué datos se transmiten
| Ruta de Signal K | Campo en ClearShip | Conversión |
|---|---|---|
navigation.position | Posición | — |
navigation.speedOverGround | Velocidad sobre el fondo | m/s → kn |
navigation.courseOverGroundTrue | Rumbo sobre el fondo | rad → ° |
navigation.headingTrue / .headingMagnetic | Rumbo | rad → ° |
environment.wind.speedApparent / .angleApparent | Viento aparente | m/s → kn, rad → ° |
environment.wind.speedTrue / .directionTrue | Viento real | m/s → kn, rad → ° |
environment.depth.belowTransducer | Profundidad | — |
environment.water.temperature | Temperatura del agua | K → °C |
environment.outside.temperature | Temperatura del aire | K → °C |
environment.outside.pressure | Presión | Pa → hPa |
electrical.batteries.*.voltage | Tensión de la batería | — |
electrical.batteries.*.capacity.stateOfCharge | Estado de carga | proporción → % |
El plugin lee los valores de dos formas, en este orden:
- Modelo completo (
app.getSelfPath): es la preferida, porque se aplican las prioridades de fuente configuradas en tu servidor Signal K. Con varias fuentes GPS a bordo, la posición se mantiene estable en lugar de saltar entre antenas. - Delta stream: es la alternativa. En algunos servidores, el modelo completo no devuelve nada aunque los datos aparecen claramente en el Data Browser (observado en Victron Venus OS). La contrapartida: si una ruta tiene varias fuentes, gana la última recibida en lugar de la prioridad configurada.
La línea de estado indica cuál se está usando: via full model o via delta stream.
Solo tu propio barco
Solo se lee vessels.self. Los blancos AIS de otros barcos nunca se transmiten, ni como volumen de datos en tu tarifa móvil ni como datos personales de terceros en nuestra base de datos.
Sensores en rutas no estándar
No todos los sensores publican en la ruta estándar. Un sensor RUUVI, por ejemplo, publica con el nombre de ubicación configurado en su propio plugin: un sensor configurado como cabin acaba en environment.cabin.pressure y no en environment.outside.pressure, así que el plugin no lo encontraría.
Hay dos formas de solucionarlo, cualquiera vale:
- Asígnalo aquí. Introduce la ruta en
customPaths→Pressure. La conversión de unidades se sigue aplicando: Signal K usa el SI en todas partes, así que los Pa se convierten en hPa venga el valor de la ruta que venga. - Asígnalo en Signal K. Cambia la ubicación en el plugin del sensor o reasigna la ruta en el servidor. A la larga es más limpio, porque también se benefician todos los demás consumidores de Signal K, pero cambia el modelo de datos de tu barco.
Para encontrar la ruta correcta, activa listPaths y reinicia el plugin. Escribirá en el registro todas las rutas que haya visto en vessels.self:
All 87 paths seen on vessels.self:
environment.cabin.humidity = 0.54
environment.cabin.pressure = 101820
environment.cabin.temperature = 297.45
...
La misma información está en el Data Browser de Signal K; listPaths simplemente es más rápido si ya tienes el registro abierto.
Datos adicionales: tanques, revoluciones, toma de puerto
Los campos integrados cubren lo que tiene cualquier barco. Todo lo demás varía de un barco a otro, por eso se configura en lugar de venir programado. Añade una entrada en customMetrics por cada uno:
| Campo | Significado |
|---|---|
path | Ruta de Signal K, p. ej., tanks.freshWater.0.currentLevel |
label | Nombre que aparece en el mosaico, p. ej., Agua dulce |
unit | Se muestra tal cual: l, %, A, bar, rpm, °C |
factor / offset | valor × factor + offset, aplicado a bordo |
key | Identificador opcional. Por defecto es la ruta; si lo cambias más adelante se crea un segundo mosaico en lugar de renombrar el primero. |
factor y offset existen porque Signal K usa el SI en todo. El nivel de un tanque llega como proporción, así que factor: 100 con unit: "%" da un mosaico legible; una nevera llega en kelvin, así que lo consigues con offset: -273.15 y unit: "°C". Convertir a bordo y no en la nube significa que el valor guardado y el mostrado son el mismo número.
Cada dato aparece en ClearShip como su propio mosaico la primera vez que llega; no hay nada que configurar por nuestra parte. Un mosaico existe exactamente cuando existe un sensor: un barco sin anemómetro no tiene un mosaico de viento vacío.
Ajustar los mosaicos en ClearShip
En Barco → En directo → Configurar datos en directo defines, para cada barco:
Este ajuste pertenece al barco, no al navegador ni al usuario: toda la tripulación ve los mismos mosaicos, cambiar de dispositivo no altera nada y una misma cuenta puede tener dos paneles de instrumentos completamente distintos para dos barcos. Puede cambiarlo cualquiera que tenga permiso para editar el barco.
Historial
Junto al valor actual, cada mosaico muestra el historial del intervalo seleccionado: 15 minutos, 1 hora, 24 horas o 7 días. Los valores angulares, como el rumbo o la dirección del viento, se muestran en una rosa de los vientos en lugar de en una curva: la media de 350° y 10° daría 180°, justo en la dirección contraria.
Privacidad y una prueba en seco antes de enviar nada
Si primero quieres ver qué transmitiría realmente el plugin, activa dryRun. Entonces construye los paquetes exactamente igual que en funcionamiento normal y los escribe en el registro de Signal K: no se envía nada. Los avisos son los mismos que en funcionamiento real, así que la prueba en seco sirve también como el diagnóstico más rápido.
Solución de problemas
La línea de estado del plugin indica la causa en casi todos los casos:
| Línea de estado | Causa |
|---|---|
No measurements: neither the full model nor the delta stream provides data | No llega ningún dato de los instrumentos a Signal K. Comprueba en el Data Browser si hay datos navigation.* o electrical.* en vessels.self. La causa está antes del plugin: conexión NMEA, pasarela, instrumentos apagados. |
No expected paths yet — the delta stream has N other path(s) | Signal K tiene datos, pero no en las rutas que lee el plugin. Consulta el apartado sobre rutas no estándar. |
No measurements in the selected groups. Signal K only provides: … | Los datos están, pero el grupo correspondiente está desactivado en la configuración del plugin. |
No device token configured | Falta el token en la configuración del plugin. |
Token invalid or revoked | El token se ha eliminado o se copió mal: crea uno nuevo en ClearShip. |
A ClearShip subscription is required | Tu plan actual no incluye telemetría. |
Offline — N frames buffered | No hay conexión a internet; los paquetes se reenvían en el siguiente intento. |
Server error 5xx | ClearShip no está accesible; los paquetes se quedan en el búfer. |
Los registros detallados están en el servidor Signal K, en Server → Server Log. Además, el plugin registra información mediante debug (DEBUG=clearship-signalk), incluido un inventario único al arrancar de qué rutas esperadas proporciona tu servidor y cuáles no.
Lo que la beta todavía no hace
El búfer sin conexión no sobrevive a un reinicio del servidor Signal K: lo que siga en cola se pierde. Y todavía no hay ningún aviso si se corta la conexión. Por eso, de momento no uses la vista en directo como sustituto de una guardia de fondeo o de la vigilancia de la batería. Ambas cosas están en la hoja de ruta.
Para qué sirve en la práctica
El verdadero valor aparece cuando no estás a bordo:
- Invernada: vigila la tensión de la batería antes de que una descarga profunda la estropee.
- Fondeado: comprueba el viento en el fondeadero antes de volver en la auxiliar.
- Chárter o astillero: ¿dónde está el barco ahora mismo y desde cuándo?
- Con la tripulación: todos los miembros del barco ven los mismos datos en directo; nadie tiene que compartir sus credenciales.
Disponibilidad
Los datos en directo forman parte de los planes Skipper (1 barco) y Profi (hasta 5 barcos). El plugin de Signal K en sí es gratuito y de código abierto (MIT). Puedes cambiar de barco conectado en cualquier momento: libera la plaza y conecta otro barco; el dispositivo sigue configurado y vuelve a enviar datos en cuanto recupera la plaza. Más detalles en la página de precios.
Queremos tu opinión
¿Te funciona? ¿No te funciona? Durante la beta, cualquier comentario ayuda, sobre todo la lista de rutas del Data Browser si tu configuración produce datos que el plugin no encuentra. Escríbenos a través del formulario de contacto.
Artículos relacionados
Navegar de noche: la lista de preparación
Lo que de verdad importa antes de una travesía nocturna: desde el último parte meteorológico hasta tomar rizos antes de que oscurezca y organizar las guardias. Además: una lista de verificación importable en ClearShip.
Cómo ahorrar datos móviles en tu barco: consejos para navegar lejos de la costa
¿Te quedas sin datos navegando? Estos sencillos ajustes de iPhone y Android pueden reducir muchísimo el consumo de datos móviles en el mar. Consejos imprescindibles para cualquier navegante.
Lista de mantenimiento de primavera para tu barco
Una lista de verificación completa para poner tu barco a punto para la temporada. De la inspección del casco a la revisión del motor: todo lo que necesitas saber.