gnss-js 1.17.0 → 1.18.0

package/dist/ubx.d.cts

@@ -1,4 +1,5 @@
 import { E as Ephemeris } from './nav-BAI1a9vK.cjs';
+import { C as CnavEphemeris } from './cnav-CRns0ECn.cjs';
 
 /**
  * u-blox UBX framing shared by the measurement and navigation decoders:
@@ -117,6 +118,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 +204,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,5 @@
 import { E as Ephemeris } from './nav-BAI1a9vK.js';
+import { C as CnavEphemeris } from './cnav-CRns0ECn.js';
 
 /**
  * u-blox UBX framing shared by the measurement and navigation decoders:
@@ -117,6 +118,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 +204,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-FEGLXNWA.js";
+import "./chunk-Y5IWUPJQ.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.18.0",
   "description": "Comprehensive GNSS library for JavaScript — time scales, coordinates, RINEX parsing, RTCM3 decoding, orbit computation, and signal analysis",
   "type": "module",
   "sideEffects": false,