Maritiem vertrouwen: kan de brug deze positiebepaling vertrouwen?
kshana receiver-trust kan voor een varend vaartuig een live vertrouwenscijfer van 0 tot 100 geven voor elke positiebepaling, uit wat elke ontvanger al op de bus zet (eerst NMEA 0183), en zeggen welke controles het hebben verlaagd. Het is een softwarelaag naast een ontvanger. Het is geen ontvanger, het vervangt er geen, en het maakt een positiebepaling niet nauwkeuriger.
Adviserende software. Kshana is geen typegoedgekeurde navigatieapparatuur (IEC 61108, IEC 61162) en is niet getoetst aan enige prestatienorm. De score en de gate zijn hulpmiddelen bij het oordeel van de navigator. De exploitant blijft verantwoordelijk voor de veilige navigatie van het vaartuig en voor elke beslissing om op een positiebepaling te vertrouwen of daarmee te stoppen.
Deze pagina zegt waar de controles naar kijken, wat elk ervan wel en niet kan vangen, hoe u het live uitvoert en wat de gate doet. De scoreafbeelding en elke standaardwaarde staan in RECEIVER-TRUST.md.
Wat het leest#
Een vaartuig wordt in het sessiebestand opgegeven, met zijn grenzen vastgelegd vóór de run:
[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
| Zin | Gelezen |
|---|---|
| GGA | positie, kwaliteit van de positiebepaling (0 = geen positiebepaling), hoogte boven gemiddeld zeeniveau, geoïdescheiding, HDOP |
| RMC | status (A geldig, V niet), snelheid en koers over de grond, datum, modus |
| VTG | snelheid en koers over de grond, waar RMC er geen heeft |
| HDT, THS | koers (THS alleen wanneer zijn modus niet V is) |
| VHW, VBW | snelheid door het water (VBW alleen wanneer zijn status A is) |
| ZDA | tijd |
| GSV | signaalsterkte per satelliet (dB-Hz), elevatie en azimut (voor de geometrie) |
| GSA | dilution of precision en gebruikte satellieten (voor de geometrie, waar GSV geen hemel geeft; en de opgegeven HDOP die de bewaking vergelijkt) |
$PKSOS,<A/F/N> |
een OSNMA-status die een ontvanger meldde, door de adapter die de ontvanger leest vertaald naar deze zin: A geauthenticeerd, F mislukt, N geen resultaat |
Epochs waarvan de ontvanger zelf zegt dat het geen satellietpositiebepaling is (GGA-kwaliteit 0, of 6 tot 8: geschat, handmatig, simulator; RMC-status V, of modus E, M, S, N) worden niet gebruikt voor de positiecontroles en dragen geen bewijs in welke richting dan ook: de ontvanger heeft het al gezegd.
De eerste calibration_s seconden vormen de basislijn en worden nooit gescoord. Elke monitor kijkt alleen naar de huidige en eerdere epochs, zodat een beslissing op een epoch niet verandert wanneer later gegevens binnenkomen, en een live stream dezelfde score geeft als dezelfde tekst als bestand gelezen.
Wat elke controle vangt, en wat niet#
Richtingen tussen positiebepalingen (de koerspeiling die de bochtsnelheidscontrole gebruikt, de koers die door twee posities wordt geïmpliceerd) zijn de richting van het koorde ertussen, wat het gemiddelde azimut van de geodeet tussen de positiebepalingen is, niet het voorwaartse azimut bij de eerste positiebepaling; de twee verschillen ongeveer de helft van de meridiaanconvergentie tussen de positiebepalingen (0,001 graad bij een basislijn van 260 m op 59,5 graden breedte).
Een vervalste positie moet overeenstemmen met de natuurkunde van een schip en met de andere sensoren van het schip. Elke controle vergelijkt de positiebepaling met een daarvan. Een controle is slechts zo onafhankelijk als haar andere bron: een koers van een GNSS-kompas, of een "snelheid door het water" die uit GNSS is afgeleid, is niet onafhankelijk van de ontvanger die wordt getest en voegt niets toe.
| Controle | Vangt | Kan niet |
|---|---|---|
kinematic |
een positiesprong; een track waarvan de beweging niet door de gemelde snelheid en koers wordt verklaard; een impliciete snelheid, versnelling of bochtsnelheid boven de opgegeven grenzen van het vaartuig | een drag waarvan de gemelde snelheid en koers de vervalste track volgen en binnen de grenzen blijven (de ontvanger leidt ze af uit zijn eigen oplossing, dus ze komen met elkaar overeen); een te hoog opgegeven snelheidsgrens |
heading-course |
een track die meer dan de opgegeven krabhoek afwijkt van waar het schip heen wijst | een drag langs de koers (de koers verandert niet); een koers van dezelfde ontvanger of een GNSS-kompas; een dwarsstroom boven de tolerantie (vals alarm); snelheden onder min_speed_kn |
speed-log |
een drag die de snelheid over de grond verandert ten opzichte van de snelheid door het water | een log dat uit GNSS is afgeleid; een stroom boven de marge (vals alarm); een drag die langzamer is dan de marge |
sea-level |
een hoogte die niet is waar het zeeoppervlak en de opgegeven antennehoogte haar zouden plaatsen | een spoofer die de hoogte aannemelijk houdt; de tolerantie is ruim omdat de verticale fout van een zelfstandige ontvanger groot is; de geoïdescheiding wordt vastgelegd maar niet gecontroleerd, omdat de engine geen geoïdemodel heeft |
cn0-spread, cn0-rise |
de signatuur van één zender: C/N0 over de satellieten die samen instort of samen stijgt, ten opzichte van de kalibratiebasislijn | een spoofer die het vermogen per satelliet vormgeeft; alles zolang de basislijn zelf wordt gespooft; een GSV-cadans die te traag is om te volgen |
time-consistency |
de tijd van de ontvanger die onregelmatig stapt of achteruit loopt; ten opzichte van de klok van deze computer, de tijd van de ontvanger die ervan wegdrijft (alleen realtimestreams) | een vervalste tijd die consistent en gestaag is; een klok die vanaf het begin onjuist is |
osnma |
een gemelde OSNMA-authenticatiefout | de status wordt gelezen, niet geverifieerd; een spoofer die de melding onderdrukt wordt niet gezien |
cn0-drop, loss-of-lock, agc, jam-ind |
vermogensontzegging en verlies van satellieten, zoals in het statische geval | zij zeggen dat de omgeving vijandig is, niet dat de positiebepaling onjuist is |
Wat monitors die alleen op NMEA werken niet kunnen. Een spoofer die de hele constellatie nabootst met een zelfconsistente positie, snelheid, met de koers verenigbare koers, aannemelijk vermogen per satelliet en een overeenkomende klok is onzichtbaar voor elke controle hierboven: niets in de zinnen onderscheidt zijn positiebepaling van een echte. Een replay van opgenomen echte signalen evenmin. Authenticatie (OSNMA, of een ontvanger met eigen bescherming tegen spoofing) en onafhankelijke navigatiesensoren dichten die kloof; deze laag kan alleen hun gemelde status gebruiken. Een stream die al wordt gespooft terwijl de basislijn wordt gevormd, heeft geen schone basislijn. Het uitblijven van een alarm is geen bewijs van een goede positiebepaling.
Vertrouwensscore#
Elke epoch na de kalibratie krijgt een score van 0 tot 100 en de redenen waarom die niet 100 is: welke controles aftrokken, hun statistiek tegen de drempel en hun punten. Banden (randen vermeld in de sessie): nominal bij 90 of hoger, degraded bij 55 of hoger, untrusted daaronder. De afbeelding, elk gewicht en zijn reden staan in RECEIVER-TRUST.md; zij is deterministisch en vastgelegd voordat een log wordt gescoord, zonder leren en zonder iets dat aan gebeurtenissen is gefit.
Elke uitvoer van een vaartuig draagt de adviesverklaring: de sleutel advisory van de resultaat-JSON en van elke live regel, een eerste commentaarregel # van de CSV (lezers slaan hem over met hun commentaaroptie), de <desc> en een voettekst van de SVG. Uitvoer van een batchrun: session.result.json (met het scoremodel en de aftrekposten van elke epoch), session.trust.csv (met de kolommen score en score_reasons) en session.trust.svg, die voor een vaartuig de door de ontvanger gemelde track is, gekleurd naar vertrouwensband, boven de score over de tijd.
Een synthetische demo#
examples/maritime-trust/ bevat een verzonnen NMEA-log van een veerboot op de route Tallinn-Helsinki (een uittreksel van 50 minuten, ongeveer 17 kn, 1 Hz: GGA, RMC, VTG, een gyrokoers, een snelheidslog, GSV met een aannemelijke hemel) waarin een positie-drag-off vanaf 1500 s de gemelde positie van de werkelijke positie van het vaartuig wegtrekt. De ontvanger blijft de hele tijd een geldige positiebepaling melden; de vertrouwensscore is wat daalt, door de band degraded naar de band untrusted. session.toml legt elke drempel, de grenzen van het vaartuig en elk scoregewicht vast vóór de run.
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
Het log is tekst die naar een bestand is geschreven door cargo run --example gen_maritime_trust_demo: het modelleert geen radiosignaal en zendt niets uit. Het is geen meting en de route is illustratief, geen zeekaart. tests/receiver_trust_maritime_demo.rs pint het log en de verwachte uitvoer vast als regressiebewaking op de synthetische gegevens; zij zeggen niets over hoe enige monitor het doet bij echte interferentie.
De figuur is getekend door tools/gen_readme_assets.py uit een echte run van deze demo (kshana receiver-trust examples/maritime-trust/session.toml); de score is adviserend, en het log is verzonnen.
Specificatie van de Studio-weergave#
Voor wie de Studio-weergave van een vaartuigrun bouwt. Niets in dit gedeelte is al in de Studio geïmplementeerd; de kant van de engine (de gegevens hieronder) wel.
Invoer. Een van beide:
- de resultaat-JSON van een batchrun (
kshana receiver-trust <session.toml>, of hetzelfde viareceiver_trust(toml)in het WebAssembly-pakket met het log inline):score_model(bandranden, ramp, bewijsvasthouding, elk gewicht),monitors_run,statesenepochs[], elk mett_s,state,alarms,score.{score,band,deductions[]},marine.{position:[lat,lon], stats, ratios}, en vanaf 0,36geometryen declassvan elke aftrekpost, metgeometry_modelengeometry_summaryop het hoogste niveau; of - de live JSON-regels (schema hierboven), één object per epoch, toegevoegd terwijl de stream loopt. Elke regel draagt de door de ontvanger gemelde
position(schema 1,1).
De demoset is examples/maritime-trust/: session.toml, tallinn-helsinki.nmea (het log) en tallinn-helsinki.truth.csv (t_s,true_lat_deg,true_lon_deg: waar het vaartuig werkelijk was, wat geen echt log heeft). Een weergave moet de sessie uitvoeren en het waarheidsbestand ernaast lezen.
Wat te tekenen.
- Track, noord boven, één schaal op beide assen: de door de ontvanger gemelde posities als een lijn gekleurd naar de band van de epoch (grijs calibrating, groen nominal, oranje degraded, rood untrusted), begin en einde gemarkeerd, een schaalbalk. Voor de demo de ware track als dunne neutrale lijn eronder, zodat de drag-off zichtbaar wordt als het uiteengaan van de twee; een schakelaar voor de ware track en een uitlezing van de afwijking in meters op het tijdstip van de cursor.
- Scoretijdlijn: de score van 0 tot 100 tegen de tijd, de bandranden (
nominal_min,degraded_minuitscore_model) als streeplijnen, de band als strook eronder, en het begin van elke vermelde gebeurtenis als markering. De tijdas wordt gedeeld met de track. - Redenen: voor de epoch onder de cursor de aftrekposten (monitor, verhouding tegen drempel, punten) als horizontale balken, grootste eerst, met het gewicht dat elke monitor uit
score_model.weightsdraagt; monitors die liepen en niets kostten vaag weergegeven, monitors die niet liepen (niet inmonitors_run) vermeld als "not run", nooit als geslaagd. De monitorgeometryheeft geen item inscore_model.weights: haar plafond isgeometry_model.cap_in_force. - Monitorstroken: één dunne strook per monitor in
monitors_rundie zijn verhouding over de tijd toont (alarm bij 1), zodat een lezer ziet welke controle het eerst bewoog. - Gatestatus: in een liveweergave de
gatevan elke epoch (off,passed,withheld) als strook onder de bandstrook, en de laatste$PKSHT. In een batchweergave zijn de epochs die een gate zou hebben tegengehouden degene waarvan de band untrusted is, met de vrijgavevasthouding toegepast. - Geometriebaan (0,36): een strook onder de bandstrook gekleurd naar
geometry.status(groen good, oranje degraded, grijs gearceerd unknown), in een kleurfamilie die verschilt van die van de inconsistentie- en omgevingsbanen, met de legenda "geometry: the sky, not the signal". Aftrekposten gekleurd naarclass(geometry, environment, inconsistency) in het redenenpaneel en de monitorstroken, en de tellingen van epochs per klasse uitgeometry_summarynaast de bandtellingen. Voor de epoch onder de cursor:geometry.note,n_used, HDOP, PDOP, VDOP,source,age_s, en een vlag wanneerreported_derived_mismatchis gezet (de geometrie-aftrekpost is dan een inconsistentie).unknownwordt getoond als "geometry unknown: no GSV or GSA in the log", nooit als goed. De drempels van[geometry]en hun herkomst uitgeometry_modelstaan naast de scoreinstellingen. De adviesopmerking blijft. - Door de ontvanger gemelde positiebepaling: de ontvanger van de demo meldt de hele tijd een geldige positiebepaling (GGA-kwaliteit 1, RMC-status A); zeg dat in de legenda, want dat is het punt van de weergave.
Interacties. Eén tijdcursor gedeeld door elk paneel (slepen, pijltjestoetsen en een afspeelknop die op 1x tot 60x afspeelt); boven de track of een strook zweven verplaatst hem. Klikken op een aftrekpost markeert de epochs waarin die monitor boven zijn begindrempel lag. Een bandfilter (toon alleen degraded en untrusted epochs) en een sprong naar de eerste aftrekpost en naar de eerste untrusted epoch. Hovertekst bij elke monitornaam met de omschrijving van één regel van deze pagina. De drempels en gewichten van de sessie worden alleen-lezen naast de grafiek getoond, zodat op het scherm staat wat de score heeft gebruikt.
Te behouden formulering. De pagina moet zeggen dat het adviserende software is en geen typegoedgekeurde navigatieapparatuur, dat de demo synthetische tekst is met een verzonnen drag-off, en dat een positiebepaling zonder alarm daarmee nog geen goede positiebepaling is (zie de beperkingen hierboven). Geen cijfer op de pagina mag lezen als een maat voor hoe de controles het doen bij echte interferentie.
Vanuit code#
Voor aanroepers die de sessie en de bytes in het geheugen houden (geen bestanden, geen klok, geen sockets; veilig voor WebAssembly) heeft kshana::receiver_trust::assess:
assess_vessel_log(session_toml, log_bytes) -> Result<ReceiverTrustResult, String>: een heel log, gescoord als een batchrun; hetzelfde resultaat alskshana receiver-trust <session.toml>, dat serialiseert naar de resultaat-JSON (score_model,monitors_run,epochs[]met scores en aftrekposten).assess_stream_excerpt(session_toml, excerpt_bytes) -> Result<ExcerptAssessment, String>: een begrensd stuk van een stream (ten hoogste 2 MiB en 20.000 epochs, en lang genoeg om het kalibratievenster te bevatten), gescoord zoals de livemodus scoort en teruggegeven in het live JSON-regelschema (epochs[], de laatste$PKSHT, een samenvatting van bandtellingen, laagste en laatste score, eerste untrusted tijd). De tijd van de ontvanger wordt niet met een hostklok vergeleken. De langlopende livemodus (sockets, een bestand dat wordt aangevuld, de gate) is van de binary.
Beide hebben een sessie nodig met [platform] kind = "vessel"; de tabel [log] ervan is optioneel.
Live uitvoeren#
# 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
An NMEA 2000 network is read through a SocketCAN interface: kshana sensor-live --kind n2k turns the
position, course and speed, heading and system-time groups into NMEA 0183 sentences (see
MACHINE-INPUTS.md), which this command reads as it reads any other:
candump -L can0 | kshana sensor-live --kind n2k --from - | kshana receiver-trust live session.toml
De sessie is dezelfde session.toml als bij een batchrun, met een tabel [platform] die kind = "vessel" declareert; de tabel [log] is niet nodig. Seriële poorten worden nog niet rechtstreeks geopend: lees de poort met het hulpmiddel dat u al gebruikt (stty en cat, een terminalserver, een multiplexer) en geef haar door via een pipe of door te sturen. Directe seriële invoer kan later komen.
Elke voltooide epoch schrijft één JSON-regel naar stdout:
{"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 is calibrating, nominal, degraded of untrusted (de band van de score, met de randen in de tabel [score] van de sessie); score ontbreekt tijdens de kalibratie; deductions geven aan welke controles punten hebben afgetrokken en hoeveel, grootste eerst.
JSON-regelschema (versie 1,1)#
Eén JSON-object per voltooide epoch, sleutels in deze volgorde:
| Sleutel | Type | Betekenis |
|---|---|---|
seq |
geheel getal | aantal gemelde epochs, vanaf 1 |
t_s |
getal | seconden sinds de eerste epoch van de stream |
time |
tekenreeks of null | de tijd van de epoch zoals de stream hem vermeldt (ISO-8601 UTC met een datum zodra een RMC is gezien, anders hh:mm:ss.mmm UTC (date not in log)) |
state |
tekenreeks | calibrating, nominal, degraded of untrusted |
score |
getal of null | 0 tot 100, één decimaal; null tijdens de kalibratie of wanneer note zegt waarom er geen kon worden geproduceerd |
deductions |
array | {"monitor": string, "ratio": number, "points": number, "class": string}, grootste punten eerst; ratio is statistiek over drempel (alarm bij 1 of meer); alleen monitors die punten kosten worden vermeld; class (toegevoegd in 1,3) is geometry, environment of inconsistency |
alarms |
array van string | monitors op of boven hun drempel |
gate |
tekenreeks | off, passed of withheld |
note |
tekenreeks of null | waarom er geen score is geproduceerd (bijvoorbeeld een gedeclareerde koerssensor die ontbreekt) |
position |
object of null | (toegevoegd in 1,1) de positie die de ontvanger op deze epoch meldde, {"lat_deg", "lon_deg", "height_m"} (hoogte ellipsoïdaal waar de zin de geoïdescheiding geeft, anders boven gemiddeld zeeniveau); null wanneer de ontvanger er geen gaf, ook bij kalibratie-epochs zonder positiebepaling |
advisory |
tekenreeks | (toegevoegd in 1,2) wat deze software is en niet is: adviserend, geen typegoedgekeurde navigatieapparatuur, de exploitant blijft verantwoordelijk |
geometry |
object | (toegevoegd in 1,3) de satellietgeometrie: status (good, degraded, unknown wanneer de stream geen GSV-elevaties en -azimuts en geen GSA heeft), 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 (satellieten in zicht maar niet getrackt terwijl de DOP in zicht goed is: de geometrie-aftrekpost is dan environment), label (good, fair, poor, unknown: altijd gemeld, nooit gescoord; de score trekt alleen af voor poor) (zie RECEIVER-TRUST.md) |
Monitornamen (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, en vanaf 1,3 geometry. In latere versies kunnen nieuwe namen worden toegevoegd; consumenten moeten een onbekende monitornaam als een monitor behandelen. De indeling van $PKSHT hieronder draagt een formaatversie in zijn eerste veld; dit JSON-schema is versie 1,3: 1,1 voegde position toe, 1,2 advisory, 1,3 geometry aan het eind en class in elke aftrekpost, en het verandert alleen door sleutels aan het eind toe te voegen.
Authenticatie-invoer#
De monitor osnma neemt de authenticatiestatus per satelliet van een authenticatiebron via MarineObs::sat_auth (een lijst van (satellite, status), status Authenticated, Failed of Unavailable), naast de algemene MarineObs::osnma. Aan de NMEA-kant wordt hetzelfde gedragen door $PKSOS,<A|F|N>[,<sat>:<A|F|N>...], bijvoorbeeld $PKSOS,A,E11:A,E19:F. Elke fout, algemeen of op één satelliet, laat de monitor alarm slaan en kost zijn volledige gewicht (hij krijgt de verhouding 1,5); succes is geen bewijs. Kshana verifieert hier niets: de bron die dat wel doet, is verantwoordelijk voor de status die zij meldt.
Een epoch is voltooid wanneer de volgende getimede zin binnenkomt; zinnen van tragere of niet-gesynchroniseerde instrumenten (een gyro enkele tienden van een seconde achter de ontvanger) die daarvoor binnenkomen, horen erbij. Als de stream stilvalt gedurende [live] idle_flush_s (standaard 1,5 s, stel het hoger in dan de langste pauze tussen de getimede zinnen van uw ontvanger) wordt de epoch voltooid zoals hij is. De eerste calibration_s seconden van de stream vormen de basislijn en worden nooit gescoord, dus een stream die al wordt gespooft wanneer hij voor het eerst wordt aangesloten, heeft geen schone basislijn: start de laag vóór de reis, of terwijl bekend is dat de positiebepaling goed is. Het kalibratievenster sluit één keer, op volgorde van binnenkomst: een epoch waarvan de tijd eerder is dan een reeds geziene tijd (een terugspoeling, een replay van het begin van de stream) is nooit kalibratie, wat zijn tijd ook zegt; hij wordt gescoord met een volledige aftrekpost van time-consistency, die untrusted is. De live engine scoort elke epoch over de kalibratie-epochs en de laatste minuut of zo van de stream, dus zijn kosten per epoch groeien met calibration_s maal de epochfrequentie; houd het venster kort bij een snelle ontvanger. Zijn buffers zijn begrensd (een stortvloed aan regels zonder getimede zin wordt om de 5.000 regels voltooid, kalibratie en historie zijn begrensd op 20.000 epochs).
De tijd van de ontvanger wordt ook vergeleken met de monotone klok van deze computer, wat alleen iets betekent voor een stream die in realtime binnenkomt. Een opgeslagen log dat op volle snelheid via stdin, TCP of UDP wordt ingevoerd, activeert die controle per constructie: geef --replay mee. (--file zonder --follow impliceert het al.) Een --file ... --follow wordt als replay gelezen totdat hij tot het einde is gelezen en de hostklok wordt vanaf dan ingeschakeld, zodat een achterstand niet als klokfout wordt gelezen; de controle vereist dan dat het kalibratievenster nog open is (anders heeft zij geen basislijn en draait zij niet).
Einde van streams en fouten: stdin en een bestand dat tot het einde is gelezen, eindigen normaal (exit 0). Een TCP-verbinding die door de peer wordt gesloten, is geen normaal einde voor een stream die door zou moeten gaan: de laag eindigt met een niet-nulcode nadat zij alles heeft gescoord en geschreven wat zij had ontvangen en maakt niet opnieuw verbinding, dus voer haar uit onder een supervisor die haar herstart. UDP-datagrammen die een zin splitsen, worden samengevoegd; de lezers van stdin, een bestand en TCP worden gedragen door een begrensde wachtrij die de zender terugduwt (er gaat niets verloren), terwijl UDP, dat niet kan terugduwen, datagrammen laat vallen die de engine niet kan aannemen en dat op stderr meldt. --udp <port> bindt het loopback-adres; geef --udp <addr>:<port> om elders te luisteren (er wordt een waarschuwing afgedrukt).
$PKSHT: de eigen zin#
Elke epoch produceert ook één NMEA 0183-zin, met een geldige controlesom, die --pksht <path|-> naar een bestand of stdout schrijft en die de gate in de doorgestuurde stream invoegt:
$PKSHT,1,080140.25,30.0,U,W,heading-course:40.0/cn0-spread:30.0*2F
| Veld | Betekenis |
|---|---|
| 1 | 1: de formaatversie |
| 2 | UTC-tijd van de epoch, hhmmss.ss; leeg als de stream er geen gaf |
| 3 | vertrouwensscore 0 tot 100, één decimaal; leeg tijdens de kalibratie of wanneer er geen kon worden geproduceerd |
| 4 | band: C calibrating, N nominal, D degraded, U untrusted |
| 5 | gate: - off, P passed, W withheld (de positiebepaling is in de doorgestuurde cyclus ongeldig gemarkeerd) |
| 6 | maximaal twee redenen, monitor:points verbonden door /; leeg wanneer er niets is afgetrokken |
Het adres is P + het fabrikantmnemoniek KSH + T. Apparatuur die een eigen zin niet kent, negeert haar. Kshana negeert zijn eigen $PKSHT bij invoer.
Gate-modus#
--gate plaatst Kshana tussen de ontvanger en de apparatuur die zijn positiebepaling gebruikt (een kaartsysteem, een trackbesturingssysteem). De NMEA-stream gaat erin, komt op stdout eruit, en wordt:
- ongewijzigd doorgegeven zolang de epoch niet untrusted is (en tijdens de kalibratie), met een
$PKSHTna elke cyclus van zinnen; en - ongeldig gemarkeerd zolang hij untrusted is: GGA-kwaliteit
0; RMC-statusV(en zijn modusindicatorNen navigatiestatusVwaar aanwezig); GNS-modusNin elke positie; GLL-statusVen modusN; VTG-modusNwaar zij er een heeft. De positievelden blijven zoals ze waren: het punt is dat de apparatuur de ontvanger zelf de positiebepaling ongeldig ziet verklaren en haar eigen alarm geeft. Van elke herschreven zin wordt de controlesom opnieuw berekend.
Eenmaal tegengehouden wordt de positiebepaling pas vrijgegeven nadat de epochs gedurende [live] gate_release_s (standaard 30 s) buiten de band untrusted zijn geweest, zodat een score op de bandrand de positiebepaling niet kan laten flikkeren. De JSON-regels gaan alleen waar --json <path> het zegt (standaard nergens, omdat de stream stdout heeft).
receiver-nmea-source | kshana receiver-trust live session.toml --gate --json trust.jsonl | downstream-equipment
Om een kaartplotter rechtstreeks te laten verbinden, biedt u de gegate stream aan via TCP in plaats van stdout:
receiver-nmea-source | kshana receiver-trust live session.toml --gate --listen tcp:10110
--listen tcp:<port> luistert op het loopback-adres; tcp:<addr>:<port> luistert elders (er wordt een waarschuwing afgedrukt, omdat iedereen die het adres kan bereiken de stream kan lezen). Een willekeurig aantal clients mag verbinden; elk krijgt dezelfde stream vanaf het moment dat het verbindt, en clients lezen alleen. Elke client heeft zijn eigen begrensde wachtrij en schrijver, dus een client die het niet bijhoudt wordt verwijderd (zijn verbinding gesloten, een regel op stderr) en vertraagt nooit de andere of de invoer. --listen vereist --gate; stdout bevat dan niets van de stream, dus --json - is vrij.
Wat de gate niet doet, en wat u moet weten voordat u haar gebruikt:
- Zij is opt-in. Niets markeert een positiebepaling ongeldig tenzij
--gateis opgegeven. - Zij voegt latentie toe: een cyclus wordt vastgehouden totdat zijn epoch is gescoord, wat de tijd tot de volgende getimede zin is (ongeveer één cyclus: een seconde voor een ontvanger van 1 Hz), of
idle_flush_sna de laatste wanneer de stream stilvalt. Apparatuur die binnen enkele tientallen milliseconden na de uitvoer van de ontvanger een zin nodig heeft, mag er niet achter zitten. - Zij is één enkel punt in de keten: als zij stopt, stopt de stream. Voer haar onder supervisie uit en bepaal vooraf wat de apparatuur stroomafwaarts zonder stream doet.
- Zij faalt veilig bij haar eigen fouten: als de monitors na de kalibratie geen score kunnen produceren (een gedeclareerde koerssensor die niets verstuurt, te weinig kalibratie-epochs), is de epoch untrusted, draagt een
noteen wordt tegengehouden; de vrijgavevasthouding wordt getimed op de klok van deze computer, niet op de tijd van de ontvanger, die een spoofer beheerst (bij een replay is er alleen de tijd van de ontvanger). - Het kan een goede positiebepaling tegenhouden (een vals alarm) en een vervalste doorlaten (een gemiste detectie). De monitors toetsen een positiebepaling aan de fysica van een schip en aan zijn andere sensoren; een vervalsing die met al die gegevens consistent is, wordt niet opgemerkt (zie de beperkingen hieronder).
- Het verwacht een zuivere NMEA 0183-tekststroom. Binaire frames die in de stroom zijn gemengd, worden ongewijzigd doorgestuurd, maar een
$PKSHTkan dan tussen de bytes van een frame terechtkomen. - Het is niet typegoedgekeurd en niets ervan is getoetst aan IEC 61108 of IEC 61162. De gezagvoerder of exploitant blijft verantwoordelijk voor de navigatie van het vaartuig.