gnss-js 1.25.0 → 1.26.0

package/dist/trimble.d.cts

@@ -0,0 +1,147 @@
+import { E as Ephemeris } from './nav-DImXUdbp.cjs';
+
+/** One checksum-valid Trimble packet located in a byte stream. */
+interface TrimbleFrame {
+    /** Offset of the STX byte. */
+    start: number;
+    /** STATUS byte. */
+    status: number;
+    /** Packet TYPE byte (e.g. 0x57 RAWDATA, 0x55 RETSVDATA). */
+    type: number;
+    /** DATA length in bytes. */
+    len: number;
+    /** Offset of the first DATA byte (i.e. `start + 4`). */
+    payload: number;
+}
+/**
+ * Iterate every checksum-valid Trimble packet in `data`. A prospective
+ * packet must end in ETX and match its checksum; otherwise the walker
+ * resyncs at the next byte and, for a checksum mismatch on an
+ * otherwise-well-formed packet, increments `stats.badChecksum`.
+ */
+declare function trimbleFrames(data: Uint8Array, stats: {
+    badChecksum: number;
+}): Generator<TrimbleFrame>;
+
+/**
+ * Trimble RT17/RT27 navigation-message decoding: RETSVDATA (0x55)
+ * GPS ephemeris (subtype 1) and ION / UTC data (subtype 3).
+ *
+ * Ported field-for-field from RTKLIB's `src/rcv/rt17.c`
+ * (`decode_gps_ephemeris` / `decode_ion_utc_data`, tomojitakasu/RTKLIB,
+ * Copyright (C) 2014 D. A. Cook / T. Takasu, BSD-2-Clause). All scalar
+ * fields are big-endian; the semicircle angular/harmonic fields are
+ * scaled by π to radians, exactly as RTKLIB does.
+ *
+ * Output records mirror what `parseNavFile` produces for the equivalent
+ * RINEX 3 GPS navigation record and match the NovAtel/SBF ephemeris
+ * paths (Keplerian `tocDate` a GPS-scale Date, angles in radians).
+ *
+ * RTKLIB decodes only these two RETSVDATA subtypes; the GLONASS,
+ * Galileo, BeiDou and QZSS ephemeris/almanac subtypes are not handled
+ * here (see the module note in the package README / decoder report).
+ * This path is validated against synthetic records only: the DLF100
+ * ALLOY capture carried GLONASS/BeiDou subtypes but no GPS ephemeris.
+ */
+
+interface TrimbleNavResult {
+    /** Broadcast ephemerides in stream order, duplicates suppressed. */
+    ephemerides: Ephemeris[];
+    /**
+     * Klobuchar coefficients from ION/UTC in the RINEX-header shape
+     * (`GPSA` = alpha0..3, `GPSB` = beta0..3), last message wins.
+     */
+    ionoCorrections: Record<string, number[]>;
+    /** GPS−UTC leap seconds (Δt_LS) from ION/UTC, null when unseen. */
+    leapSeconds: number | null;
+    /** RETSVDATA frame counts per subtype, for diagnostics. */
+    retsvCounts: Record<number, number>;
+    /** Frames whose checksum failed (corruption indicator). */
+    badChecksum: number;
+}
+/**
+ * Decode every RETSVDATA navigation message (GPS ephemeris, ION/UTC) in
+ * a Trimble binary byte stream. Repeated broadcasts of an unchanged GPS
+ * ephemeris are suppressed by issue of data (IODE), as RTKLIB does.
+ */
+declare function parseTrimbleNav(data: Uint8Array): TrimbleNavResult;
+
+/**
+ * Trimble RT27 raw-measurement decoding (RAWDATA 0x57, record type 27
+ * "Real-time GNSS survey data", the multi-constellation successor to
+ * the GPS-only RT17 record type 17).
+ *
+ * The stream framing and multi-page RAWDATA reassembly follow RTKLIB's
+ * `src/rcv/rt17.c` (see `./frame`). The record-27 payload itself is NOT
+ * decoded by RTKLIB (its `decode_rawdata` handles only record types 0
+ * and 7); the block layout here is taken from Trimble's published ICD,
+ * "Data record subtype 6: Real-time GNSS survey data (record type 27)"
+ * (receiverhelp.trimble.com/oem-gnss), and was verified byte-for-byte
+ * against a 60 s multi-GNSS capture from the TU Delft ALLOY mount
+ * DLF100NLD1: carrier phase reconstructs pseudorange to |L|·λ ≈ P for
+ * every signal and constellation, SNRs land in 30–48 dB-Hz, and the
+ * geostationary SBAS Doppler is ≈ 0 Hz.
+ *
+ * Record 27 is a chain of length-prefixed blocks. The epoch header
+ * carries the GPS week, receiver time (ms of week) and satellite count;
+ * each satellite has a variable-length header (system, PRN, GLONASS
+ * frequency channel, elevation/azimuth, flags) followed by one
+ * measurement block per tracked signal. The first block of a satellite
+ * carries a full pseudorange (U4, 2⁻⁷ m — 2⁻⁶ for SBAS/QZSS); later
+ * blocks carry a signed 2-byte difference to it (2⁻⁸ m). Carrier phase
+ * is a signed 6-byte field (2⁻¹⁵ cycles, negated for the RINEX sign
+ * like RTKLIB's record-17 path); Doppler, when flagged, is a signed
+ * 3-byte field (2⁻⁸ Hz). Output records mirror `parseNovatelRange`.
+ *
+ * An epoch that does not fit in one 15-page message overflows into a
+ * following message that shares the same reply id and carries no epoch
+ * header (pure satellite-block continuation); such messages are joined
+ * onto the epoch by reply id. This reply-run joining is an extension of
+ * RTKLIB's per-message model, driven by the DLF100 capture.
+ */
+
+interface TrimbleMeasurement {
+    /** RINEX PRN, e.g. "G04", "R11", "E12", "C21", "S27". */
+    prn: string;
+    /** RINEX band+attribute, e.g. "1C", "2W", "5Q". */
+    code: string;
+    /** Pseudorange (m), null when the range is not loaded. */
+    pr: number | null;
+    /** Carrier phase (cycles, RINEX sign), null when phase is not loaded. */
+    cp: number | null;
+    /** Instantaneous Doppler (Hz), null when absent. */
+    doppler: number | null;
+    /** C/N0 (dB-Hz). */
+    cn0: number;
+    /** Rolling cycle-slip counter (0–255). */
+    cycleSlipCount: number;
+    /** True when the measurement's cycle-slip flag is set. */
+    cycleSlip: boolean;
+    /** GLONASS frequency channel k (−7…+6), null for CDMA systems. */
+    gloChannel: number | null;
+}
+interface TrimbleEpoch {
+    /** Epoch (GPS-scale ms — same convention as the RINEX parser). */
+    timeMs: number;
+    meas: TrimbleMeasurement[];
+}
+interface TrimbleParseResult {
+    epochs: TrimbleEpoch[];
+    /** Observation codes seen per system letter, in first-seen order. */
+    obsCodes: Record<string, string[]>;
+    /** RAWDATA frame counts per record type, for diagnostics. */
+    recordCounts: Record<number, number>;
+    /** RETSVDATA frame counts per subtype, for diagnostics. */
+    retsvCounts: Record<number, number>;
+    /** Frames whose checksum failed (corruption indicator). */
+    badChecksum: number;
+}
+/**
+ * Decode every RT27 (record type 27) measurement epoch in a Trimble
+ * binary byte stream. RETSVDATA and unsupported RAWDATA record types
+ * are counted and skipped. Navigation messages (ephemerides, ION/UTC)
+ * are decoded separately by {@link parseTrimbleNav}.
+ */
+declare function parseTrimble(data: Uint8Array): TrimbleParseResult;
+
+export { type TrimbleEpoch, type TrimbleFrame, type TrimbleMeasurement, type TrimbleNavResult, type TrimbleParseResult, parseTrimble, parseTrimbleNav, trimbleFrames };

package/dist/trimble.d.ts

@@ -0,0 +1,147 @@
+import { E as Ephemeris } from './nav-DImXUdbp.js';
+
+/** One checksum-valid Trimble packet located in a byte stream. */
+interface TrimbleFrame {
+    /** Offset of the STX byte. */
+    start: number;
+    /** STATUS byte. */
+    status: number;
+    /** Packet TYPE byte (e.g. 0x57 RAWDATA, 0x55 RETSVDATA). */
+    type: number;
+    /** DATA length in bytes. */
+    len: number;
+    /** Offset of the first DATA byte (i.e. `start + 4`). */
+    payload: number;
+}
+/**
+ * Iterate every checksum-valid Trimble packet in `data`. A prospective
+ * packet must end in ETX and match its checksum; otherwise the walker
+ * resyncs at the next byte and, for a checksum mismatch on an
+ * otherwise-well-formed packet, increments `stats.badChecksum`.
+ */
+declare function trimbleFrames(data: Uint8Array, stats: {
+    badChecksum: number;
+}): Generator<TrimbleFrame>;
+
+/**
+ * Trimble RT17/RT27 navigation-message decoding: RETSVDATA (0x55)
+ * GPS ephemeris (subtype 1) and ION / UTC data (subtype 3).
+ *
+ * Ported field-for-field from RTKLIB's `src/rcv/rt17.c`
+ * (`decode_gps_ephemeris` / `decode_ion_utc_data`, tomojitakasu/RTKLIB,
+ * Copyright (C) 2014 D. A. Cook / T. Takasu, BSD-2-Clause). All scalar
+ * fields are big-endian; the semicircle angular/harmonic fields are
+ * scaled by π to radians, exactly as RTKLIB does.
+ *
+ * Output records mirror what `parseNavFile` produces for the equivalent
+ * RINEX 3 GPS navigation record and match the NovAtel/SBF ephemeris
+ * paths (Keplerian `tocDate` a GPS-scale Date, angles in radians).
+ *
+ * RTKLIB decodes only these two RETSVDATA subtypes; the GLONASS,
+ * Galileo, BeiDou and QZSS ephemeris/almanac subtypes are not handled
+ * here (see the module note in the package README / decoder report).
+ * This path is validated against synthetic records only: the DLF100
+ * ALLOY capture carried GLONASS/BeiDou subtypes but no GPS ephemeris.
+ */
+
+interface TrimbleNavResult {
+    /** Broadcast ephemerides in stream order, duplicates suppressed. */
+    ephemerides: Ephemeris[];
+    /**
+     * Klobuchar coefficients from ION/UTC in the RINEX-header shape
+     * (`GPSA` = alpha0..3, `GPSB` = beta0..3), last message wins.
+     */
+    ionoCorrections: Record<string, number[]>;
+    /** GPS−UTC leap seconds (Δt_LS) from ION/UTC, null when unseen. */
+    leapSeconds: number | null;
+    /** RETSVDATA frame counts per subtype, for diagnostics. */
+    retsvCounts: Record<number, number>;
+    /** Frames whose checksum failed (corruption indicator). */
+    badChecksum: number;
+}
+/**
+ * Decode every RETSVDATA navigation message (GPS ephemeris, ION/UTC) in
+ * a Trimble binary byte stream. Repeated broadcasts of an unchanged GPS
+ * ephemeris are suppressed by issue of data (IODE), as RTKLIB does.
+ */
+declare function parseTrimbleNav(data: Uint8Array): TrimbleNavResult;
+
+/**
+ * Trimble RT27 raw-measurement decoding (RAWDATA 0x57, record type 27
+ * "Real-time GNSS survey data", the multi-constellation successor to
+ * the GPS-only RT17 record type 17).
+ *
+ * The stream framing and multi-page RAWDATA reassembly follow RTKLIB's
+ * `src/rcv/rt17.c` (see `./frame`). The record-27 payload itself is NOT
+ * decoded by RTKLIB (its `decode_rawdata` handles only record types 0
+ * and 7); the block layout here is taken from Trimble's published ICD,
+ * "Data record subtype 6: Real-time GNSS survey data (record type 27)"
+ * (receiverhelp.trimble.com/oem-gnss), and was verified byte-for-byte
+ * against a 60 s multi-GNSS capture from the TU Delft ALLOY mount
+ * DLF100NLD1: carrier phase reconstructs pseudorange to |L|·λ ≈ P for
+ * every signal and constellation, SNRs land in 30–48 dB-Hz, and the
+ * geostationary SBAS Doppler is ≈ 0 Hz.
+ *
+ * Record 27 is a chain of length-prefixed blocks. The epoch header
+ * carries the GPS week, receiver time (ms of week) and satellite count;
+ * each satellite has a variable-length header (system, PRN, GLONASS
+ * frequency channel, elevation/azimuth, flags) followed by one
+ * measurement block per tracked signal. The first block of a satellite
+ * carries a full pseudorange (U4, 2⁻⁷ m — 2⁻⁶ for SBAS/QZSS); later
+ * blocks carry a signed 2-byte difference to it (2⁻⁸ m). Carrier phase
+ * is a signed 6-byte field (2⁻¹⁵ cycles, negated for the RINEX sign
+ * like RTKLIB's record-17 path); Doppler, when flagged, is a signed
+ * 3-byte field (2⁻⁸ Hz). Output records mirror `parseNovatelRange`.
+ *
+ * An epoch that does not fit in one 15-page message overflows into a
+ * following message that shares the same reply id and carries no epoch
+ * header (pure satellite-block continuation); such messages are joined
+ * onto the epoch by reply id. This reply-run joining is an extension of
+ * RTKLIB's per-message model, driven by the DLF100 capture.
+ */
+
+interface TrimbleMeasurement {
+    /** RINEX PRN, e.g. "G04", "R11", "E12", "C21", "S27". */
+    prn: string;
+    /** RINEX band+attribute, e.g. "1C", "2W", "5Q". */
+    code: string;
+    /** Pseudorange (m), null when the range is not loaded. */
+    pr: number | null;
+    /** Carrier phase (cycles, RINEX sign), null when phase is not loaded. */
+    cp: number | null;
+    /** Instantaneous Doppler (Hz), null when absent. */
+    doppler: number | null;
+    /** C/N0 (dB-Hz). */
+    cn0: number;
+    /** Rolling cycle-slip counter (0–255). */
+    cycleSlipCount: number;
+    /** True when the measurement's cycle-slip flag is set. */
+    cycleSlip: boolean;
+    /** GLONASS frequency channel k (−7…+6), null for CDMA systems. */
+    gloChannel: number | null;
+}
+interface TrimbleEpoch {
+    /** Epoch (GPS-scale ms — same convention as the RINEX parser). */
+    timeMs: number;
+    meas: TrimbleMeasurement[];
+}
+interface TrimbleParseResult {
+    epochs: TrimbleEpoch[];
+    /** Observation codes seen per system letter, in first-seen order. */
+    obsCodes: Record<string, string[]>;
+    /** RAWDATA frame counts per record type, for diagnostics. */
+    recordCounts: Record<number, number>;
+    /** RETSVDATA frame counts per subtype, for diagnostics. */
+    retsvCounts: Record<number, number>;
+    /** Frames whose checksum failed (corruption indicator). */
+    badChecksum: number;
+}
+/**
+ * Decode every RT27 (record type 27) measurement epoch in a Trimble
+ * binary byte stream. RETSVDATA and unsupported RAWDATA record types
+ * are counted and skipped. Navigation messages (ephemerides, ION/UTC)
+ * are decoded separately by {@link parseTrimbleNav}.
+ */
+declare function parseTrimble(data: Uint8Array): TrimbleParseResult;
+
+export { type TrimbleEpoch, type TrimbleFrame, type TrimbleMeasurement, type TrimbleNavResult, type TrimbleParseResult, parseTrimble, parseTrimbleNav, trimbleFrames };

package/dist/trimble.js

@@ -0,0 +1,10 @@
+import {
+  parseTrimble,
+  parseTrimbleNav,
+  trimbleFrames
+} from "./chunk-CKRNXZHT.js";
+export {
+  parseTrimble,
+  parseTrimbleNav,
+  trimbleFrames
+};

package/dist/ubx.js

@@ -5,9 +5,10 @@ import {
   parseUbxRawNav,
   parseUbxRawx,
   ubxFrames
-} from "./chunk-MCAVU3XL.js";
-import "./chunk-VTX3VCL4.js";
-import "./chunk-WZDFZ76K.js";
+} from "./chunk-FEOMYZEU.js";
+import "./chunk-5AUK42AL.js";
+import "./chunk-726LQBGM.js";
+import "./chunk-IQ5OIMQD.js";
 import "./chunk-HVXYFUCB.js";
 import "./chunk-LEEU5OIO.js";
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gnss-js",
-  "version": "1.25.0",
+  "version": "1.26.0",
   "description": "Comprehensive GNSS library for JavaScript — time scales, coordinates, RINEX parsing, RTCM3 decoding, orbit computation, and signal analysis",
   "type": "module",
   "sideEffects": false,
@@ -45,6 +45,16 @@
       "import": "./dist/sbf.js",
       "require": "./dist/sbf.cjs"
     },
+    "./trimble": {
+      "types": "./dist/trimble.d.ts",
+      "import": "./dist/trimble.js",
+      "require": "./dist/trimble.cjs"
+    },
+    "./binex": {
+      "types": "./dist/binex.d.ts",
+      "import": "./dist/binex.js",
+      "require": "./dist/binex.cjs"
+    },
     "./rtcm3": {
       "types": "./dist/rtcm3.d.ts",
       "import": "./dist/rtcm3.js",