gnss-js 1.17.0 → 1.19.0

package/dist/ubx.d.cts

@@ -1,4 +1,4 @@
-import { E as Ephemeris } from './nav-BAI1a9vK.cjs';
+import { E as Ephemeris, C as CnavEphemeris } from './nav-DImXUdbp.cjs';
 
 /**
  * u-blox UBX framing shared by the measurement and navigation decoders:
@@ -117,6 +117,36 @@ interface UbxIonoUtcResult {
  */
 declare function parseUbxIonoUtc(data: Uint8Array): UbxIonoUtcResult;
 
+/**
+ * u-blox UBX raw CNAV decoding: GPS L2C CNAV messages from RXM-SFRBX
+ * (class 0x02, id 0x13), gnssId 0 with sigId 3 (L2 CL) or 4 (L2 CM).
+ *
+ * Word packing: the u-blox interface description delivers the 300-bit
+ * CNAV message as 10 32-bit `dwrd` words (little-endian in the
+ * stream) with the message bits left-justified MSB-first — message
+ * bit 0 is bit 31 of dwrd[0], and the low 20 bits of dwrd[9] are
+ * padding. Verified empirically on a ZED-F9P capture: this unpacking
+ * yields a valid CRC-24Q (and the 0x8B preamble in the top byte of
+ * dwrd[0], the same property `readLnavSubframe` in ./nav uses to skip
+ * CNAV frames) on effectively every message. RTKLIB demo5 does not
+ * decode CNAV from u-blox receivers; the field decoding lives in
+ * `src/navbits/cnav.ts`, working from IS-GPS-200 directly.
+ */
+
+interface UbxCnavResult {
+    /** Assembled CNAV ephemerides in stream order, repeats suppressed. */
+    ephemerides: CnavEphemeris[];
+    /** Raw messages whose CRC-24Q check failed (dropped). */
+    badCrc: number;
+    /** Total GPS L2C RXM-SFRBX messages seen (checksum-valid frames). */
+    messages: number;
+}
+/**
+ * Decode every GPS L2C CNAV message in a UBX byte stream (RXM-SFRBX,
+ * gnssId 0, sigId 3/4) and assemble them into ephemerides.
+ */
+declare function parseUbxCnav(data: Uint8Array): UbxCnavResult;
+
 /**
  * u-blox UBX raw-measurement decoding (RXM-RAWX) — the path from a
  * receiver log to RINEX-grade observables.
@@ -173,4 +203,4 @@ interface UbxParseResult {
  */
 declare function parseUbxRawx(data: Uint8Array): UbxParseResult;
 
-export { type UbxFrame, type UbxIonoUtcResult, type UbxMeasurement, type UbxNavOptions, type UbxNavResult, type UbxParseResult, type UbxRawxEpoch, parseUbxIonoUtc, parseUbxNav, parseUbxRawx, ubxFrames };
+export { type UbxCnavResult, type UbxFrame, type UbxIonoUtcResult, type UbxMeasurement, type UbxNavOptions, type UbxNavResult, type UbxParseResult, type UbxRawxEpoch, parseUbxCnav, parseUbxIonoUtc, parseUbxNav, parseUbxRawx, ubxFrames };

package/dist/ubx.d.ts

@@ -1,4 +1,4 @@
-import { E as Ephemeris } from './nav-BAI1a9vK.js';
+import { E as Ephemeris, C as CnavEphemeris } from './nav-DImXUdbp.js';
 
 /**
  * u-blox UBX framing shared by the measurement and navigation decoders:
@@ -117,6 +117,36 @@ interface UbxIonoUtcResult {
  */
 declare function parseUbxIonoUtc(data: Uint8Array): UbxIonoUtcResult;
 
+/**
+ * u-blox UBX raw CNAV decoding: GPS L2C CNAV messages from RXM-SFRBX
+ * (class 0x02, id 0x13), gnssId 0 with sigId 3 (L2 CL) or 4 (L2 CM).
+ *
+ * Word packing: the u-blox interface description delivers the 300-bit
+ * CNAV message as 10 32-bit `dwrd` words (little-endian in the
+ * stream) with the message bits left-justified MSB-first — message
+ * bit 0 is bit 31 of dwrd[0], and the low 20 bits of dwrd[9] are
+ * padding. Verified empirically on a ZED-F9P capture: this unpacking
+ * yields a valid CRC-24Q (and the 0x8B preamble in the top byte of
+ * dwrd[0], the same property `readLnavSubframe` in ./nav uses to skip
+ * CNAV frames) on effectively every message. RTKLIB demo5 does not
+ * decode CNAV from u-blox receivers; the field decoding lives in
+ * `src/navbits/cnav.ts`, working from IS-GPS-200 directly.
+ */
+
+interface UbxCnavResult {
+    /** Assembled CNAV ephemerides in stream order, repeats suppressed. */
+    ephemerides: CnavEphemeris[];
+    /** Raw messages whose CRC-24Q check failed (dropped). */
+    badCrc: number;
+    /** Total GPS L2C RXM-SFRBX messages seen (checksum-valid frames). */
+    messages: number;
+}
+/**
+ * Decode every GPS L2C CNAV message in a UBX byte stream (RXM-SFRBX,
+ * gnssId 0, sigId 3/4) and assemble them into ephemerides.
+ */
+declare function parseUbxCnav(data: Uint8Array): UbxCnavResult;
+
 /**
  * u-blox UBX raw-measurement decoding (RXM-RAWX) — the path from a
  * receiver log to RINEX-grade observables.
@@ -173,4 +203,4 @@ interface UbxParseResult {
  */
 declare function parseUbxRawx(data: Uint8Array): UbxParseResult;
 
-export { type UbxFrame, type UbxIonoUtcResult, type UbxMeasurement, type UbxNavOptions, type UbxNavResult, type UbxParseResult, type UbxRawxEpoch, parseUbxIonoUtc, parseUbxNav, parseUbxRawx, ubxFrames };
+export { type UbxCnavResult, type UbxFrame, type UbxIonoUtcResult, type UbxMeasurement, type UbxNavOptions, type UbxNavResult, type UbxParseResult, type UbxRawxEpoch, parseUbxCnav, parseUbxIonoUtc, parseUbxNav, parseUbxRawx, ubxFrames };

package/dist/ubx.js

@@ -1,11 +1,14 @@
 import {
+  parseUbxCnav,
   parseUbxIonoUtc,
   parseUbxNav,
   parseUbxRawx,
   ubxFrames
-} from "./chunk-IG5CDNDS.js";
-import "./chunk-REYOYF7O.js";
+} from "./chunk-JW2ICDR7.js";
+import "./chunk-6NCMACDO.js";
+import "./chunk-IQ5OIMQD.js";
 export {
+  parseUbxCnav,
   parseUbxIonoUtc,
   parseUbxNav,
   parseUbxRawx,

package/package.json

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

package/dist/nav-BAI1a9vK.d.cts

@@ -1,108 +0,0 @@
-/**
- * RINEX 3.x/4.x navigation file parser.
- * Parses GPS, Galileo, BeiDou (Keplerian), and GLONASS (state vector) ephemerides.
- */
-interface NavHeader {
-    version: number;
-    type: string;
-    leapSeconds: number | null;
-    ionoCorrections: Record<string, number[]>;
-}
-/** GPS / Galileo / BeiDou / QZSS / NavIC Keplerian ephemeris. */
-interface KeplerEphemeris {
-    system: 'G' | 'E' | 'C' | 'J' | 'I';
-    /** Satellite PRN, e.g. "G14". */
-    prn: string;
-    /** Epoch of clock in seconds of GPS week. */
-    toc: number;
-    /** Epoch of clock as a Date. */
-    tocDate: Date;
-    /** SV clock bias in seconds. */
-    af0: number;
-    /** SV clock drift in s/s. */
-    af1: number;
-    /** SV clock drift rate in s/s². */
-    af2: number;
-    /** Issue of data (ephemeris). */
-    iode: number;
-    /** Amplitude of sine correction to orbit radius in meters. */
-    crs: number;
-    /** Mean motion difference in rad/s. */
-    deltaN: number;
-    /** Mean anomaly at reference time in radians. */
-    m0: number;
-    /** Amplitude of cosine correction to argument of latitude in radians. */
-    cuc: number;
-    /** Eccentricity (dimensionless). */
-    e: number;
-    /** Amplitude of sine correction to argument of latitude in radians. */
-    cus: number;
-    /** Square root of semi-major axis in m^(1/2). */
-    sqrtA: number;
-    /** Time of ephemeris in seconds of GPS week. */
-    toe: number;
-    /** Amplitude of cosine correction to inclination in radians. */
-    cic: number;
-    /** Right ascension of ascending node at reference time in radians. */
-    omega0: number;
-    /** Amplitude of sine correction to inclination in radians. */
-    cis: number;
-    /** Inclination at reference time in radians. */
-    i0: number;
-    /** Amplitude of cosine correction to orbit radius in meters. */
-    crc: number;
-    /** Argument of perigee in radians. */
-    omega: number;
-    /** Rate of right ascension in rad/s. */
-    omegaDot: number;
-    /** Rate of inclination in rad/s. */
-    idot: number;
-    /** GPS week number. */
-    week: number;
-    /** SV health flag. */
-    svHealth: number;
-    /** Total group delay in seconds. */
-    tgd: number;
-}
-/** GLONASS / SBAS state-vector ephemeris. Positions in km, velocities in km/s, accelerations in km/s². */
-interface GlonassEphemeris {
-    system: 'R' | 'S';
-    prn: string;
-    tocDate: Date;
-    /** Clock bias (seconds). */
-    tauN: number;
-    /** Relative frequency bias (dimensionless). */
-    gammaN: number;
-    /** Message frame time (seconds of UTC day). */
-    messageFrameTime: number;
-    /** X position in km (PZ-90). */
-    x: number;
-    /** X velocity in km/s. */
-    xDot: number;
-    /** X acceleration in km/s² (luni-solar). */
-    xAcc: number;
-    /** Y position in km (PZ-90). */
-    y: number;
-    /** Y velocity in km/s. */
-    yDot: number;
-    /** Y acceleration in km/s² (luni-solar). */
-    yAcc: number;
-    /** Z position in km (PZ-90). */
-    z: number;
-    /** Z velocity in km/s. */
-    zDot: number;
-    /** Z acceleration in km/s² (luni-solar). */
-    zAcc: number;
-    /** Health flag (0 = healthy). */
-    health: number;
-    /** GLONASS frequency channel number (-7 to +6). */
-    freqNum: number;
-}
-type Ephemeris = KeplerEphemeris | GlonassEphemeris;
-interface NavResult {
-    header: NavHeader;
-    ephemerides: Ephemeris[];
-}
-declare function parseNavFile(text: string): NavResult;
-
-export { type Ephemeris as E, type GlonassEphemeris as G, type KeplerEphemeris as K, type NavHeader as N, type NavResult as a, parseNavFile as p };

package/dist/nav-BAI1a9vK.d.ts

@@ -1,108 +0,0 @@
-/**
- * RINEX 3.x/4.x navigation file parser.
- * Parses GPS, Galileo, BeiDou (Keplerian), and GLONASS (state vector) ephemerides.
- */
-interface NavHeader {
-    version: number;
-    type: string;
-    leapSeconds: number | null;
-    ionoCorrections: Record<string, number[]>;
-}
-/** GPS / Galileo / BeiDou / QZSS / NavIC Keplerian ephemeris. */
-interface KeplerEphemeris {
-    system: 'G' | 'E' | 'C' | 'J' | 'I';
-    /** Satellite PRN, e.g. "G14". */
-    prn: string;
-    /** Epoch of clock in seconds of GPS week. */
-    toc: number;
-    /** Epoch of clock as a Date. */
-    tocDate: Date;
-    /** SV clock bias in seconds. */
-    af0: number;
-    /** SV clock drift in s/s. */
-    af1: number;
-    /** SV clock drift rate in s/s². */
-    af2: number;
-    /** Issue of data (ephemeris). */
-    iode: number;
-    /** Amplitude of sine correction to orbit radius in meters. */
-    crs: number;
-    /** Mean motion difference in rad/s. */
-    deltaN: number;
-    /** Mean anomaly at reference time in radians. */
-    m0: number;
-    /** Amplitude of cosine correction to argument of latitude in radians. */
-    cuc: number;
-    /** Eccentricity (dimensionless). */
-    e: number;
-    /** Amplitude of sine correction to argument of latitude in radians. */
-    cus: number;
-    /** Square root of semi-major axis in m^(1/2). */
-    sqrtA: number;
-    /** Time of ephemeris in seconds of GPS week. */
-    toe: number;
-    /** Amplitude of cosine correction to inclination in radians. */
-    cic: number;
-    /** Right ascension of ascending node at reference time in radians. */
-    omega0: number;
-    /** Amplitude of sine correction to inclination in radians. */
-    cis: number;
-    /** Inclination at reference time in radians. */
-    i0: number;
-    /** Amplitude of cosine correction to orbit radius in meters. */
-    crc: number;
-    /** Argument of perigee in radians. */
-    omega: number;
-    /** Rate of right ascension in rad/s. */
-    omegaDot: number;
-    /** Rate of inclination in rad/s. */
-    idot: number;
-    /** GPS week number. */
-    week: number;
-    /** SV health flag. */
-    svHealth: number;
-    /** Total group delay in seconds. */
-    tgd: number;
-}
-/** GLONASS / SBAS state-vector ephemeris. Positions in km, velocities in km/s, accelerations in km/s². */
-interface GlonassEphemeris {
-    system: 'R' | 'S';
-    prn: string;
-    tocDate: Date;
-    /** Clock bias (seconds). */
-    tauN: number;
-    /** Relative frequency bias (dimensionless). */
-    gammaN: number;
-    /** Message frame time (seconds of UTC day). */
-    messageFrameTime: number;
-    /** X position in km (PZ-90). */
-    x: number;
-    /** X velocity in km/s. */
-    xDot: number;
-    /** X acceleration in km/s² (luni-solar). */
-    xAcc: number;
-    /** Y position in km (PZ-90). */
-    y: number;
-    /** Y velocity in km/s. */
-    yDot: number;
-    /** Y acceleration in km/s² (luni-solar). */
-    yAcc: number;
-    /** Z position in km (PZ-90). */
-    z: number;
-    /** Z velocity in km/s. */
-    zDot: number;
-    /** Z acceleration in km/s² (luni-solar). */
-    zAcc: number;
-    /** Health flag (0 = healthy). */
-    health: number;
-    /** GLONASS frequency channel number (-7 to +6). */
-    freqNum: number;
-}
-type Ephemeris = KeplerEphemeris | GlonassEphemeris;
-interface NavResult {
-    header: NavHeader;
-    ephemerides: Ephemeris[];
-}
-declare function parseNavFile(text: string): NavResult;
-
-export { type Ephemeris as E, type GlonassEphemeris as G, type KeplerEphemeris as K, type NavHeader as N, type NavResult as a, parseNavFile as p };