Confianza marítima: ¿puede el puente fiarse de esta posición?
kshana receiver-trust puede puntuar, para un buque en movimiento, una cifra de confianza de 0 a 100 en tiempo real para cada posición, a partir de lo que cualquier receptor ya pone en el bus (primero NMEA 0183), e indicar qué comprobaciones la redujeron. Es una capa de software que se sitúa junto a un receptor. No es un receptor, no sustituye a ninguno y no hace más exacta una posición.
Software de carácter consultivo. Kshana no es un equipo de navegación homologado (IEC 61108, IEC 61162) y no se ha evaluado frente a ninguna norma de rendimiento. Su puntuación y su puerta son ayudas al criterio del navegante. El operador sigue siendo responsable de la navegación segura del buque y de cualquier decisión de fiarse, o de dejar de fiarse, de una posición.
Esta página dice qué examinan las comprobaciones, qué puede y qué no puede detectar cada una, cómo ejecutarlo en tiempo real y qué hace la puerta. La correspondencia de la puntuación y cada valor por defecto están en RECEIVER-TRUST.md.
Qué lee#
Un buque se declara en el archivo de sesión, con sus límites indicados antes de la ejecución:
[platform]
kind = "vessel"
max_speed_kn = 20.0 # includes any current you want to allow for: it limits speed over ground
max_accel_mps2 = 0.2
max_turn_rate_dps = 2.0
antenna_height_m = 18.0 # antenna above the waterline
heading_sensor = true # the stream carries a gyro or compass heading
| Sentencia | Se lee |
|---|---|
| GGA | posición, calidad de la posición (0 = sin posición), altitud sobre el nivel medio del mar, separación del geoide, HDOP |
| RMC | estado (A válido, V no), velocidad y rumbo sobre el fondo, fecha, modo |
| VTG | velocidad y rumbo sobre el fondo, donde RMC no los tiene |
| HDT, THS | rumbo (THS solo cuando su modo no es V) |
| VHW, VBW | velocidad a través del agua (VBW solo cuando su estado es A) |
| ZDA | hora |
| GSV | intensidad de señal por satélite (dB-Hz), elevación y acimut (para la geometría) |
| GSA | dilución de la precisión y satélites usados (para la geometría, donde GSV no da cielo; y el HDOP declarado que compara la protección) |
$PKSOS,<A/F/N> |
un estado de OSNMA notificado por un receptor, traducido a esta sentencia por el adaptador que lee el receptor: A autenticado, F fallido, N sin resultado |
Las épocas que el propio receptor dice que no son una posición por satélite (calidad GGA 0, o 6 a 8: estimada, manual, simulador; estado RMC V, o modo E, M, S, N) no se usan para las comprobaciones de posición y no aportan evidencia en ningún sentido: el receptor ya lo ha dicho.
Los primeros calibration_s segundos forman la línea base y nunca se puntúan. Cada monitor mira solo la época actual y las anteriores, de modo que una decisión en una época no cambia cuando llegan datos posteriores, y un flujo en directo da la misma puntuación que el mismo texto leído como archivo.
Qué detecta cada comprobación y qué no puede detectar#
Las direcciones entre posiciones (el rumbo de la trayectoria que usa la comprobación de velocidad de giro, el rumbo implícito en dos posiciones) son la dirección de la cuerda entre ellas, que es el acimut medio de la geodésica entre las posiciones, no el acimut directo en la primera; ambos difieren en aproximadamente la mitad de la convergencia de los meridianos entre las posiciones (0,001 grados para una línea base de 260 m a 59,5 grados de latitud).
Una posición falsificada tiene que concordar con la física del buque y con los demás sensores del buque. Cada comprobación compara la posición con uno de ellos. Una comprobación es tan independiente como lo sea su otra fuente: un rumbo procedente de una brújula GNSS, o una "velocidad a través del agua" derivada de GNSS, no es independiente del receptor sometido a prueba y no aporta nada.
| Comprobación | Detecta | No puede detectar |
|---|---|---|
kinematic |
un salto de posición; una trayectoria cuyo movimiento no explican la velocidad y el rumbo notificados; una velocidad, aceleración o velocidad de giro implícitas por encima de los límites declarados del buque | un arrastre cuya velocidad y rumbo notificados siguen la trayectoria falsificada y permanece dentro de los límites (el receptor los deriva de su propia solución, de modo que concuerdan entre sí); un límite de velocidad declarado demasiado alto |
heading-course |
una trayectoria que se aparta de hacia dónde apunta el buque en más del ángulo de deriva declarado | un arrastre a lo largo del rumbo (el rumbo no cambia); un rumbo procedente del mismo receptor o de una brújula GNSS; un desvío transversal por encima de la tolerancia (falsa alarma); velocidades por debajo de min_speed_kn |
speed-log |
un arrastre que cambia la velocidad sobre el fondo frente a la velocidad a través del agua | una corredera derivada de GNSS; una corriente por encima de la tolerancia (falsa alarma); un arrastre más lento que la tolerancia |
sea-level |
una altitud que no está donde la sitúan la superficie del mar y la altura de antena declarada | un suplantador que mantiene verosímil la altitud; la tolerancia es amplia porque el error vertical autónomo es grande; la separación del geoide se registra pero no se comprueba, porque el motor no tiene modelo de geoide |
cn0-spread, cn0-rise |
la firma de un único transmisor: la C/N0 de todos los satélites que se hunde a la vez, o sube a la vez, respecto a la línea base de calibración | un suplantador que conforma la potencia por satélite; cualquier cosa mientras la propia línea base está suplantada; una cadencia de GSV demasiado lenta para seguirla |
time-consistency |
el tiempo del receptor que avanza de forma irregular o retrocede; frente al reloj de este ordenador, el tiempo del receptor que se desvía de él (solo flujos en tiempo real) | una hora falsificada que es consistente y estable; un reloj que está mal desde el principio |
osnma |
un fallo de autenticación OSNMA notificado | el estado se lee, no se verifica; no se ve a un suplantador que suprime el informe |
cn0-drop, loss-of-lock, agc, jam-ind |
denegación de potencia y pérdida de satélites, como en el caso estático | dicen que el entorno es hostil, no que la posición sea errónea |
Lo que los monitores solo de NMEA no pueden hacer. Un suplantador que reproduce toda la constelación con una posición, una velocidad, un rumbo compatible con el de proa, una potencia por satélite verosímil y un reloj coincidente, todo autoconsistente, es invisible para todas las comprobaciones anteriores: nada en las sentencias distingue su posición de una real. Tampoco lo hace una reproducción de señales reales grabadas. La autenticación (OSNMA, o un receptor con su propia protección antisuplantación) y los sensores de navegación independientes son lo que cierra esa brecha; esta capa solo puede usar su estado notificado. Un flujo que ya está siendo suplantado mientras se forma la línea base no tiene una línea base limpia. La ausencia de una alarma no es evidencia de una buena posición.
Puntuación de confianza#
Cada época posterior a la calibración recibe una puntuación de 0 a 100 y los motivos por los que no es 100: qué comprobaciones restaron, su estadístico frente al umbral y sus puntos. Bandas (bordes indicados en la sesión): nominal con 90 o más, degraded con 55 o más, untrusted por debajo. La correspondencia, cada peso y su motivo están en RECEIVER-TRUST.md; es determinista y se fija antes de puntuar un registro, sin aprendizaje y sin nada ajustado a sucesos.
Toda salida de buque lleva la declaración consultiva: la clave advisory del JSON de resultados y de cada línea en directo, una primera línea de comentario # del CSV (los lectores la omiten con su opción de comentarios), el <desc> y un pie del SVG. Salidas de una ejecución por lotes: session.result.json (con el modelo de puntuación y las deducciones de cada época), session.trust.csv (con columnas score y score_reasons) y session.trust.svg, que para un buque es la trayectoria notificada por el receptor coloreada por banda de confianza sobre la puntuación a lo largo del tiempo.
Una demostración sintética#
examples/maritime-trust/ contiene un registro NMEA inventado de un transbordador en una ruta de Tallin a Helsinki (un extracto de 50 minutos, unos 17 kn, 1 Hz: GGA, RMC, VTG, un rumbo de giróscopo, una corredera, GSV con un cielo verosímil) en el que un arrastre de posición aparta la posición notificada de la real del buque a partir de 1500 s. El receptor sigue notificando una posición válida en todo momento; lo que cae es la puntuación de confianza, pasando por la banda degraded hasta la untrusted. session.toml declara cada umbral, los límites del buque y cada peso de la puntuación antes de la ejecución.
kshana receiver-trust examples/maritime-trust/session.toml
kshana receiver-trust live examples/maritime-trust/session.toml \
--file examples/maritime-trust/tallinn-helsinki.nmea --gate --json trust.jsonl > gated.nmea
El registro es texto escrito en un archivo por cargo run --example gen_maritime_trust_demo: no modela ninguna señal de radio y no transmite nada. No es una medición y la ruta es ilustrativa, no una carta. tests/receiver_trust_maritime_demo.rs fija el registro y la salida esperada como protecciones de regresión sobre los datos sintéticos; no dicen nada sobre cómo se comporta ningún monitor frente a interferencias reales.
La figura la dibuja tools/gen_readme_assets.py a partir de una ejecución real de esta demostración (kshana receiver-trust examples/maritime-trust/session.toml); la puntuación es consultiva y el registro es inventado.
Especificación de la vista de Studio#
Para quien construya la vista de Studio de una ejecución de buque. Nada de esta sección está implementado todavía en Studio; el lado del motor (los datos de abajo) sí lo está.
Entradas. Cualquiera de estas:
- el JSON de resultados de una ejecución por lotes (
kshana receiver-trust <session.toml>, o lo mismo mediantereceiver_trust(toml)en el paquete WebAssembly con el registro en línea):score_model(bordes de banda, rampa, retención de evidencia, cada peso),monitors_run,statesyepochs[], cada uno cont_s,state,alarms,score.{score,band,deductions[]},marine.{position:[lat,lon], stats, ratios}y, desde 0,36,geometryy laclassde cada deducción, congeometry_modelygeometry_summaryen el nivel superior; o bien - las líneas JSON en directo (esquema de arriba), un objeto por época, añadidas a medida que corre el flujo. Cada línea lleva la
positionnotificada por el receptor (esquema 1,1).
El conjunto de demostración es examples/maritime-trust/: session.toml, tallinn-helsinki.nmea (el registro) y tallinn-helsinki.truth.csv (t_s,true_lat_deg,true_lon_deg: dónde estuvo realmente el buque, algo que ningún registro real tiene). Una vista debería ejecutar la sesión y leer el archivo de verdad terreno a su lado.
Qué dibujar.
- Trayectoria, norte arriba, una escala en ambos ejes: las posiciones notificadas por el receptor como una línea coloreada según la banda de la época (gris calibrando, verde nominal, ámbar degraded, rojo untrusted), inicio y final marcados, una barra de escala. En la demostración, la trayectoria real como una línea neutra fina debajo, de modo que el arrastre se vea como la separación de ambas; un conmutador para la trayectoria real y una lectura del desfase en metros en el instante del cursor.
- Cronología de la puntuación: la puntuación de 0 a 100 frente al tiempo, los bordes de banda (
nominal_min,degraded_mindescore_model) como líneas discontinuas, la banda como una tira debajo y el inicio de cualquier suceso declarado como una marca. El eje de tiempo se comparte con la trayectoria. - Motivos: para la época bajo el cursor, las deducciones (monitor, razón frente al umbral, puntos) como barras horizontales, de mayor a menor, con el peso que lleva cada monitor de
score_model.weights; los monitores que se ejecutaron y no costaron nada se muestran tenues, los monitores que no se ejecutaron (que no están enmonitors_run) se listan como "not run", nunca como superados. El monitorgeometryno tiene entrada enscore_model.weights: su tope esgeometry_model.cap_in_force. - Tiras de monitor: una tira fina por cada monitor de
monitors_runque muestra su razón a lo largo del tiempo (alarma en 1), de modo que el lector ve qué comprobación se movió primero. - Estado de la puerta: en una vista en directo, el
gatede cada época (off,passed,withheld) como una tira bajo la tira de banda, y la última$PKSHT. En una vista por lotes, las épocas que una puerta habría retenido son aquellas cuya banda es untrusted, con la retención de liberación aplicada. - Carril de geometría (0,36): una tira bajo la tira de banda coloreada según
geometry.status(verde bueno, ámbar degraded, gris rayado desconocido), en una familia de color distinta de la de los carriles de inconsistencia y de entorno, con la leyenda "geometry: the sky, not the signal". Deducciones coloreadas segúnclass(geometría, entorno, inconsistencia) en el panel de motivos y en las tiras de monitor, y los recuentos de épocas por clase degeometry_summaryjunto a los recuentos de banda. Para la época bajo el cursor:geometry.note,n_used, HDOP, PDOP, VDOP,source,age_sy un indicador cuandoreported_derived_mismatchestá activado (la deducción de geometría es entonces una inconsistencia).unknownse muestra como "geometry unknown: no GSV or GSA in the log", nunca como bueno. Los umbrales de[geometry]y su procedencia desdegeometry_modelvan junto a los ajustes de la puntuación. La nota consultiva permanece. - Posición notificada por el receptor: el receptor de la demostración notifica una posición válida en todo momento (calidad GGA 1, estado RMC A); dígalo en la leyenda, porque ese es el sentido de la vista.
Interacciones. Un cursor de tiempo compartido por todos los paneles (arrastrar, teclas de flecha y un botón de reproducción que reproduce de 1x a 60x); pasar el cursor sobre la trayectoria o sobre cualquier tira lo mueve. Hacer clic en una deducción resalta las épocas en las que ese monitor estuvo por encima de su inicio. Un filtro de banda (mostrar solo las épocas degraded y untrusted) y un salto a la primera deducción y a la primera época untrusted. Texto emergente en cada nombre de monitor con la descripción de una línea de esta página. Los umbrales y pesos de la sesión se muestran, de solo lectura, junto al gráfico, de modo que lo que usó la puntuación está en pantalla.
Redacción que debe mantenerse. La página debe decir que es software de carácter consultivo y no un equipo de navegación homologado, que la demostración es texto sintético con un arrastre inventado, y que una posición sin alarma no es por ello una buena posición (véanse los límites de arriba). Ninguna cifra de la página debe leerse como una medida de cómo se comportan las comprobaciones frente a interferencias reales.
Desde código#
Para quienes llaman con la sesión y los bytes en memoria (sin archivos, sin reloj, sin sockets; seguro para WebAssembly), kshana::receiver_trust::assess ofrece:
assess_vessel_log(session_toml, log_bytes) -> Result<ReceiverTrustResult, String>: un registro completo, puntuado como una ejecución por lotes; el mismo resultado quekshana receiver-trust <session.toml>, que se serializa en el JSON de resultados (score_model,monitors_run,epochs[]con puntuaciones y deducciones).assess_stream_excerpt(session_toml, excerpt_bytes) -> Result<ExcerptAssessment, String>: un fragmento acotado de un flujo (como máximo 2 MiB y 20.000 épocas, y lo bastante largo para contener la ventana de calibración), puntuado como lo puntúa el modo en directo y devuelto en el esquema de líneas JSON en directo (epochs[], la última$PKSHT, un resumen de recuentos de banda, puntuación más baja y final, primer instante untrusted). El tiempo del receptor no se compara con un reloj del anfitrión. El modo en directo de larga duración (sockets, un archivo al que se añade, la puerta) corresponde al binario.
Ambos necesitan una sesión con [platform] kind = "vessel"; su tabla [log] es opcional.
Ejecútelo en directo#
# stdin: a serial port read by another tool, or a multiplexer's output
some-nmea-source | kshana receiver-trust live session.toml
# a log file that is being appended to (it starts at the beginning; --from-end skips what is there)
kshana receiver-trust live session.toml --file /var/log/nmea.log --follow
# a TCP server (a multiplexer or a terminal server) or UDP datagrams (a bridge network)
kshana receiver-trust live session.toml --tcp 192.0.2.10:10110
kshana receiver-trust live session.toml --udp 10110
La sesión es el mismo session.toml que en una ejecución por lotes, con una tabla [platform] que declara kind = "vessel"; su tabla [log] no es necesaria. Los puertos serie todavía no se abren directamente: lea el puerto con la herramienta que ya usa (stty y cat, un servidor de terminales, un multiplexor) y canalícelo o reenvíelo. La entrada serie directa puede llegar más adelante.
Cada época completada escribe una línea JSON en la salida estándar:
{"seq":941,"t_s":940.0,"time":"2025-06-14T08:15:40.000Z","state":"degraded","score":60.0,
"deductions":[{"monitor":"heading-course","ratio":1.5,"points":40.0}],
"alarms":["heading-course"],"gate":"off","note":null,
"position":{"lat_deg":59.8123456,"lon_deg":24.9012345,"height_m":39.4}}
state es calibrating, nominal, degraded o untrusted (la banda de la puntuación, con los bordes en la tabla [score] de la sesión); score está ausente durante la calibración; deductions enumeran qué comprobaciones restaron puntos y cuántos, de mayor a menor.
Esquema de líneas JSON (versión 1,1)#
Un objeto JSON por época completada, con las claves en este orden:
| Clave | Tipo | Significado |
|---|---|---|
seq |
entero | recuento de épocas notificadas, a partir de 1 |
t_s |
número | segundos desde la primera época del flujo |
time |
cadena o null | la hora de la época tal como la indica el flujo (UTC ISO-8601 con fecha una vez que se ha visto una RMC; en caso contrario hh:mm:ss.mmm UTC (date not in log)) |
state |
cadena | calibrating, nominal, degraded o untrusted |
score |
número o null | de 0 a 100, un decimal; null durante la calibración o cuando note dice por qué no se pudo producir ninguna |
deductions |
matriz | {"monitor": string, "ratio": number, "points": number, "class": string}, primero los que más puntos restan; ratio es el estadístico sobre el umbral (alarma en 1 o más); solo se listan los monitores que cuestan puntos; class (añadido en 1,3) es geometry, environment o inconsistency |
alarms |
matriz de cadenas | monitores en su umbral o por encima de él |
gate |
cadena | off, passed o withheld |
note |
cadena o null | por qué no se produjo ninguna puntuación (por ejemplo, un sensor de rumbo declarado que está ausente) |
position |
objeto o null | (añadido en 1,1) la posición que el receptor notificó en esta época, {"lat_deg", "lon_deg", "height_m"} (altura elipsoidal cuando la sentencia da la separación del geoide; si no, sobre el nivel medio del mar); null cuando el receptor no dio ninguna, incluidas las épocas de calibración sin posición |
advisory |
cadena | (añadido en 1,2) qué es y qué no es este software: consultivo, no un equipo de navegación homologado, el operador sigue siendo responsable |
geometry |
objeto | (añadido en 1,3) la geometría de los satélites: status (good, degraded, unknown cuando el flujo no tiene elevaciones ni acimutes de GSV y no tiene GSA), reasons (few-satellites, high-pdop, high-hdop, sky-blocked), source (derived, reported, none), n_used, hdop, pdop, vdop, open_fraction, max_azimuth_gap_deg, age_s, reported_hdop, reported_derived_mismatch, note, in_view, signal_loss (satélites a la vista pero no seguidos mientras el DOP a la vista es bueno: la deducción de geometría es entonces environment), label (good, fair, poor, unknown: siempre notificado, nunca puntuado; la puntuación solo resta por poor) (véase RECEIVER-TRUST.md) |
Nombres de monitor (kebab-case; 17): cn0-drop, agc, jam-ind, loss-of-lock, position-jump, raim, clock, solve-failure, kinematic, heading-course, speed-log, sea-level, cn0-spread, cn0-rise, time-consistency, osnma y, desde 1,3, geometry. En versiones posteriores pueden añadirse nombres nuevos; los consumidores deben tratar un nombre de monitor desconocido como un monitor. La disposición de $PKSHT de abajo lleva una versión de formato en su primer campo; este esquema JSON es la versión 1,3: 1,1 añadió position, 1,2 advisory, 1,3 geometry al final y class en cada deducción, y solo cambia añadiendo claves al final.
Entrada de autenticación#
El monitor osnma toma el estado de autenticación por satélite de una fuente de autenticación mediante MarineObs::sat_auth (una lista de (satellite, status), estado Authenticated, Failed o Unavailable), junto al MarineObs::osnma global. Del lado de NMEA lo transporta $PKSOS,<A|F|N>[,<sat>:<A|F|N>...], por ejemplo $PKSOS,A,E11:A,E19:F. Cualquier fallo, global o en un satélite, activa la alarma del monitor y le cuesta todo su peso (se le asigna la razón 1,5); el éxito no es evidencia. Kshana no verifica nada aquí: la fuente que lo hace es responsable del estado que notifica.
Una época está completa cuando llega la siguiente sentencia con hora; las sentencias de instrumentos más lentos o no sincronizados (un giróscopo unas décimas de segundo por detrás del receptor) que llegan antes le pertenecen. Si el flujo se detiene durante [live] idle_flush_s (por defecto 1,5 s; fíjelo por encima del mayor intervalo entre las sentencias con hora de su receptor), la época se completa tal como está. Los primeros calibration_s segundos del flujo forman la línea base y nunca se puntúan, por lo que un flujo que ya está siendo suplantado cuando se conecta por primera vez no tiene una línea base limpia: inicie la capa antes de la travesía, o mientras se sepa que la posición es buena. La ventana de calibración se cierra una sola vez, por orden de llegada: una época cuya hora es anterior a una hora ya vista (un retroceso, una reproducción del inicio del flujo) nunca es calibración, diga lo que diga su hora; se puntúa con una deducción completa de time-consistency, que es untrusted. El motor en directo puntúa cada época sobre las épocas de calibración y el último minuto aproximadamente del flujo, de modo que su coste por época crece con calibration_s por la tasa de épocas; mantenga la ventana corta en un receptor rápido. Sus búferes están acotados (una avalancha de líneas sin sentencia con hora se completa cada 5.000 líneas; la calibración y el historial están limitados a 20.000 épocas).
El tiempo del receptor se compara también con el reloj monótono de este ordenador, lo cual solo tiene sentido para un flujo que llega en tiempo real. Un registro almacenado introducido a toda velocidad por stdin, TCP o UDP activa esa comprobación por construcción: pase --replay. (--file sin --follow ya lo implica.) Un --file ... --follow se lee como una reproducción hasta que se ha leído hasta su final y, desde entonces, se activa el reloj del anfitrión, de modo que un atraso acumulado no se lee como un fallo de reloj; la comprobación necesita entonces que la ventana de calibración siga abierta (en caso contrario no tiene línea base y no se ejecuta).
Finales de flujo y fallos: stdin y un archivo leído hasta su final terminan con normalidad (salida 0). Una conexión TCP cerrada por el otro extremo no es un final normal para un flujo que debería continuar: la capa sale con código distinto de cero tras puntuar y escribir todo lo que había recibido y no se reconecta, así que ejecútela bajo un supervisor que la reinicie. Los datagramas UDP que dividen una sentencia se unen; los lectores de stdin, de un archivo y de TCP están respaldados por una cola acotada que presiona al emisor (no se pierde nada), mientras que UDP, que no puede presionar, descarta los datagramas que el motor no puede aceptar y lo indica en stderr. --udp <port> se enlaza a la dirección de bucle local; indique --udp <addr>:<port> para escuchar en otro sitio (se imprime una advertencia).
$PKSHT: la sentencia propietaria#
Cada época produce además una sentencia NMEA 0183, con una suma de comprobación válida, que --pksht <path|-> escribe en un archivo o en la salida estándar y que la puerta inserta en el flujo reenviado:
$PKSHT,1,080140.25,30.0,U,W,heading-course:40.0/cn0-spread:30.0*2F
| Campo | Significado |
|---|---|
| 1 | 1: la versión del formato |
| 2 | hora UTC de la época, hhmmss.ss; vacía si el flujo no dio ninguna |
| 3 | puntuación de confianza de 0 a 100, un decimal; vacía durante la calibración o cuando no se pudo producir ninguna |
| 4 | banda: C calibrating, N nominal, D degraded, U untrusted |
| 5 | puerta: - off, P passed, W withheld (la posición se marcó como no válida en el ciclo reenviado) |
| 6 | hasta dos motivos, monitor:points unidos por /; vacío cuando no se dedujo nada |
La dirección es P + el mnemónico del fabricante KSH + T. El equipo que no conoce una sentencia propietaria la ignora. Kshana ignora su propia $PKSHT en la entrada.
Modo de puerta#
--gate sitúa a Kshana entre el receptor y el equipo que usa su posición (un sistema de cartas, un sistema de control de rumbo). El flujo NMEA entra, sale por la salida estándar y es:
- transmitido sin cambios mientras la época no es untrusted (y durante la calibración), con una
$PKSHTdespués de cada ciclo de sentencias; y - marcado como no válido mientras es untrusted: calidad GGA
0; estado RMCV(y su indicador de modoNy estado de navegaciónVdonde estén presentes); modo GNSNen cada posición; estado GLLVy modoN; modo VTGNdonde lo tenga. Los campos de posición se dejan como estaban: lo importante es que el equipo ve que el propio receptor declara la posición no válida y activa su propia alarma. A cada sentencia reescrita se le recalcula la suma de comprobación.
Una vez retenida, la posición se libera solo después de que las épocas hayan estado fuera de la banda untrusted durante [live] gate_release_s (por defecto 30 s), de modo que una puntuación en el borde de la banda no pueda hacer parpadear la posición. Las líneas JSON van únicamente adonde diga --json <path> (por defecto, a ninguna parte, porque el flujo tiene la salida estándar).
receiver-nmea-source | kshana receiver-trust live session.toml --gate --json trust.jsonl | downstream-equipment
Para dejar que un trazador de cartas se conecte directamente, sirva el flujo filtrado por la puerta por TCP en lugar de por la salida estándar:
receiver-nmea-source | kshana receiver-trust live session.toml --gate --listen tcp:10110
--listen tcp:<port> escucha en la dirección de bucle local; tcp:<addr>:<port> escucha en otro sitio (se imprime una advertencia, porque cualquiera que pueda alcanzar la dirección puede leer el flujo). Puede conectarse cualquier número de clientes; cada uno recibe el mismo flujo desde el momento en que se conecta, y los clientes solo leen. Cada cliente tiene su propia cola acotada y su propio escritor, de modo que el que no pueda seguir el ritmo se descarta (se cierra su conexión y se escribe una línea en stderr) y nunca retrasa a los demás ni a la entrada. --listen necesita --gate; la salida estándar entonces no lleva nada del flujo, así que --json - queda libre.
Lo que la puerta no hace, y lo que hay que saber antes de usarla:
- Es opcional. Nada marca una posición como no válida salvo que se indique
--gate. - Añade latencia: un ciclo se retiene hasta que se puntúa su época, que es el tiempo hasta la siguiente sentencia con hora (aproximadamente un ciclo: un segundo para un receptor de 1 Hz), o
idle_flush_sdespués de la última cuando el flujo se detiene. El equipo que necesita una sentencia a pocas decenas de milisegundos de la salida del receptor no debe colocarse detrás de ella. - Es un punto único en la cadena: si se detiene, el flujo se detiene. Ejecútela bajo supervisión y decida de antemano qué hace el equipo posterior sin flujo.
- Falla en modo cerrado ante sus propios fallos: si los monitores no pueden producir una puntuación tras la calibración (un sensor de rumbo declarado que no envía nada, demasiado pocas épocas de calibración), la época es untrusted, lleva una
notey se retiene; la retención de liberación se mide con el reloj de este ordenador, no con el tiempo del receptor, que es lo que controla un suplantador (para una reproducción solo existe el tiempo del receptor). - Puede retener una buena posición (una falsa alarma) además de dejar pasar una suplantada (un fallo de detección). Los monitores comprueban una posición frente a la física del buque y sus demás sensores; una falsificación coherente con todos ellos no se detecta (véanse los límites abajo).
- Espera un flujo de texto NMEA 0183 puro. Las tramas binarias mezcladas en el flujo se reenvían sin cambios, pero entonces una
$PKSHTpuede quedar entre los bytes de una trama. - No está homologado y nada en él se ha evaluado frente a IEC 61108 ni IEC 61162. El operador sigue siendo responsable de la navegación del buque.