gnss-js 1.14.1 → 1.16.0

package/dist/ubx.d.cts

@@ -1,3 +1,82 @@
+import { E as Ephemeris } from './nav-BAI1a9vK.cjs';
+
+/**
+ * u-blox UBX framing shared by the measurement and navigation decoders:
+ * 0xB5 0x62 sync, message class and ID, little-endian payload length,
+ * payload, and an 8-bit Fletcher checksum over class..payload.
+ */
+/** One checksum-valid UBX frame located in a byte stream. */
+interface UbxFrame {
+    /** Message class, e.g. 0x02 for RXM. */
+    msgClass: number;
+    /** Message ID within the class, e.g. 0x15 for RXM-RAWX. */
+    msgId: number;
+    /** Payload bytes (a view into the input buffer, not a copy). */
+    payload: Uint8Array;
+    /** Byte offset of the payload within the input buffer. */
+    payloadStart: number;
+}
+/**
+ * Iterate every checksum-valid UBX frame in `data`. Bad checksums are
+ * counted in `stats.badChecksums` and a resync continues at the next
+ * byte; a frame candidate that overruns the buffer ends the scan
+ * (truncated capture).
+ */
+declare function ubxFrames(data: Uint8Array, stats?: {
+    badChecksums: number;
+}): Generator<UbxFrame>;
+
+/**
+ * u-blox UBX navigation-message decoding: GPS/QZSS LNAV broadcast
+ * ephemerides from RXM-SFRBX (class 0x02, id 0x13).
+ *
+ * Ported from RTKLIB demo5 (rtklibexplorer fork, src/rcv/ublox.c:
+ * decode_rxmsfrbx / decode_nav / decode_eph, Copyright (c) 2007-2020
+ * T. Takasu, BSD-2-Clause); the subframe fields themselves are decoded
+ * by `decodeGpsLnavFrame` (the decode_frame port in src/navbits).
+ *
+ * On D30* polarity: the receiver has already checked parity and
+ * resolved the polarity inversion of the data bits before writing the
+ * 30-bit words into the 30 LSBs of each `dwrd`, so — exactly like
+ * RTKLIB's decode_nav (`U4(p)>>6`, "24 x 10 bits w/o parity") — the
+ * conversion to parity-stripped 24-bit words is a plain 6-bit shift
+ * with NO D30* re-inversion. (Verified against the TLM preamble 0x8B
+ * at bits 29..22 of word 1 in every GPS/QZSS LNAV message of the
+ * reference F9P capture.)
+ *
+ * Other constellations in RXM-SFRBX (Galileo I/NAV, BDS D1/D2, GLONASS
+ * strings, SBAS) and GPS/QZSS CNAV are out of scope and skipped
+ * silently, as are LNAV subframes 4/5 (iono/UTC/almanac pages).
+ */
+
+interface UbxNavOptions {
+    /**
+     * Full GPS week used to resolve the 10-bit broadcast week. When
+     * omitted, the week is harvested from the first RXM-RAWX message in
+     * the same stream (u-blox raw logs carry both); a stream with
+     * neither yields no ephemerides — the system clock is never used.
+     */
+    refWeek?: number;
+}
+interface UbxNavResult {
+    /** Broadcast ephemerides in stream order, duplicates suppressed. */
+    ephemerides: Ephemeris[];
+    /**
+     * Subframes rejected for inconsistency: an out-of-range subframe ID
+     * in the HOW word, or a complete subframe-1/2/3 set whose
+     * IODC/IODE cross-check failed (mixed issues of data).
+     */
+    badParity: number;
+}
+/**
+ * Decode every GPS/QZSS LNAV ephemeris broadcast in a UBX byte stream
+ * (RXM-SFRBX). Subframes 1–3 are assembled per satellite; a frame is
+ * decoded when subframe 3 arrives with 1 and 2 buffered (RTKLIB
+ * decode_nav), and repeated broadcasts of an unchanged ephemeris are
+ * suppressed by issue of data and clock epoch like `parseNovatelNav`.
+ */
+declare function parseUbxNav(data: Uint8Array, opts?: UbxNavOptions): UbxNavResult;
+
 /**
  * u-blox UBX raw-measurement decoding (RXM-RAWX) — the path from a
  * receiver log to RINEX-grade observables.
@@ -12,6 +91,7 @@
  * RINEX attributes chosen to match RTKLIB's u-blox conversion (the de
  * facto reference: GPS L2 CL/CM as 2X, Galileo E1 as 1X, E5b as 7X).
  */
+
 interface UbxMeasurement {
     /** RINEX PRN, e.g. "G04", "R11", "S23". */
     prn: string;
@@ -53,4 +133,4 @@ interface UbxParseResult {
  */
 declare function parseUbxRawx(data: Uint8Array): UbxParseResult;
 
-export { type UbxMeasurement, type UbxParseResult, type UbxRawxEpoch, parseUbxRawx };
+export { type UbxFrame, type UbxMeasurement, type UbxNavOptions, type UbxNavResult, type UbxParseResult, type UbxRawxEpoch, parseUbxNav, parseUbxRawx, ubxFrames };

package/dist/ubx.d.ts

@@ -1,3 +1,82 @@
+import { E as Ephemeris } from './nav-BAI1a9vK.js';
+
+/**
+ * u-blox UBX framing shared by the measurement and navigation decoders:
+ * 0xB5 0x62 sync, message class and ID, little-endian payload length,
+ * payload, and an 8-bit Fletcher checksum over class..payload.
+ */
+/** One checksum-valid UBX frame located in a byte stream. */
+interface UbxFrame {
+    /** Message class, e.g. 0x02 for RXM. */
+    msgClass: number;
+    /** Message ID within the class, e.g. 0x15 for RXM-RAWX. */
+    msgId: number;
+    /** Payload bytes (a view into the input buffer, not a copy). */
+    payload: Uint8Array;
+    /** Byte offset of the payload within the input buffer. */
+    payloadStart: number;
+}
+/**
+ * Iterate every checksum-valid UBX frame in `data`. Bad checksums are
+ * counted in `stats.badChecksums` and a resync continues at the next
+ * byte; a frame candidate that overruns the buffer ends the scan
+ * (truncated capture).
+ */
+declare function ubxFrames(data: Uint8Array, stats?: {
+    badChecksums: number;
+}): Generator<UbxFrame>;
+
+/**
+ * u-blox UBX navigation-message decoding: GPS/QZSS LNAV broadcast
+ * ephemerides from RXM-SFRBX (class 0x02, id 0x13).
+ *
+ * Ported from RTKLIB demo5 (rtklibexplorer fork, src/rcv/ublox.c:
+ * decode_rxmsfrbx / decode_nav / decode_eph, Copyright (c) 2007-2020
+ * T. Takasu, BSD-2-Clause); the subframe fields themselves are decoded
+ * by `decodeGpsLnavFrame` (the decode_frame port in src/navbits).
+ *
+ * On D30* polarity: the receiver has already checked parity and
+ * resolved the polarity inversion of the data bits before writing the
+ * 30-bit words into the 30 LSBs of each `dwrd`, so — exactly like
+ * RTKLIB's decode_nav (`U4(p)>>6`, "24 x 10 bits w/o parity") — the
+ * conversion to parity-stripped 24-bit words is a plain 6-bit shift
+ * with NO D30* re-inversion. (Verified against the TLM preamble 0x8B
+ * at bits 29..22 of word 1 in every GPS/QZSS LNAV message of the
+ * reference F9P capture.)
+ *
+ * Other constellations in RXM-SFRBX (Galileo I/NAV, BDS D1/D2, GLONASS
+ * strings, SBAS) and GPS/QZSS CNAV are out of scope and skipped
+ * silently, as are LNAV subframes 4/5 (iono/UTC/almanac pages).
+ */
+
+interface UbxNavOptions {
+    /**
+     * Full GPS week used to resolve the 10-bit broadcast week. When
+     * omitted, the week is harvested from the first RXM-RAWX message in
+     * the same stream (u-blox raw logs carry both); a stream with
+     * neither yields no ephemerides — the system clock is never used.
+     */
+    refWeek?: number;
+}
+interface UbxNavResult {
+    /** Broadcast ephemerides in stream order, duplicates suppressed. */
+    ephemerides: Ephemeris[];
+    /**
+     * Subframes rejected for inconsistency: an out-of-range subframe ID
+     * in the HOW word, or a complete subframe-1/2/3 set whose
+     * IODC/IODE cross-check failed (mixed issues of data).
+     */
+    badParity: number;
+}
+/**
+ * Decode every GPS/QZSS LNAV ephemeris broadcast in a UBX byte stream
+ * (RXM-SFRBX). Subframes 1–3 are assembled per satellite; a frame is
+ * decoded when subframe 3 arrives with 1 and 2 buffered (RTKLIB
+ * decode_nav), and repeated broadcasts of an unchanged ephemeris are
+ * suppressed by issue of data and clock epoch like `parseNovatelNav`.
+ */
+declare function parseUbxNav(data: Uint8Array, opts?: UbxNavOptions): UbxNavResult;
+
 /**
  * u-blox UBX raw-measurement decoding (RXM-RAWX) — the path from a
  * receiver log to RINEX-grade observables.
@@ -12,6 +91,7 @@
  * RINEX attributes chosen to match RTKLIB's u-blox conversion (the de
  * facto reference: GPS L2 CL/CM as 2X, Galileo E1 as 1X, E5b as 7X).
  */
+
 interface UbxMeasurement {
     /** RINEX PRN, e.g. "G04", "R11", "S23". */
     prn: string;
@@ -53,4 +133,4 @@ interface UbxParseResult {
  */
 declare function parseUbxRawx(data: Uint8Array): UbxParseResult;
 
-export { type UbxMeasurement, type UbxParseResult, type UbxRawxEpoch, parseUbxRawx };
+export { type UbxFrame, type UbxMeasurement, type UbxNavOptions, type UbxNavResult, type UbxParseResult, type UbxRawxEpoch, parseUbxNav, parseUbxRawx, ubxFrames };

package/dist/ubx.js

@@ -1,6 +1,11 @@
 import {
-  parseUbxRawx
-} from "./chunk-5IXK25MX.js";
+  parseUbxNav,
+  parseUbxRawx,
+  ubxFrames
+} from "./chunk-6CX6EXRK.js";
+import "./chunk-4LVD4DYL.js";
 export {
-  parseUbxRawx
+  parseUbxNav,
+  parseUbxRawx,
+  ubxFrames
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gnss-js",
-  "version": "1.14.1",
+  "version": "1.16.0",
   "description": "Comprehensive GNSS library for JavaScript — time scales, coordinates, RINEX parsing, RTCM3 decoding, orbit computation, and signal analysis",
   "type": "module",
   "sideEffects": false,