feat: Galileo E5a F/NAV decoder#63
Merged
Merged
Conversation
Codecov Report✅ All modified and coverable lines are covered by tests. Additional details and impacted files@@ Coverage Diff @@
## master #63 +/- ##
==========================================
+ Coverage 97.67% 98.13% +0.45%
==========================================
Files 10 12 +2
Lines 1336 1499 +163
==========================================
+ Hits 1305 1471 +166
+ Misses 31 28 -3 ☔ View full report in Codecov by Harness. 🚀 New features to boost your workflow:
|
Decode the Galileo Open Service F/NAV message on the E5a-I data component (50 sps). Recovers ephemeris, clock correction, ionospheric correction, BGD, signal health / data validity, GST-UTC and GST-GPS conversion, and the word-type-5/6 split-almanac chain, per OS SIS ICD v2.2 §5.1 (word types 1-6). The FEC chain reuses the shared Galileo K=7 NSC Viterbi (G1=0o171, G2=0o133, G2 inverted): 12-symbol sync detection, 61x8 block deinterleave, G2 sign-flip on the soft LLRs, AFF3CT Viterbi (K=238, N=488), then CRC-24Q over the 238-bit page. Consumes soft symbols end-to-end like L1 C/A and E1B, so the public decode API is unchanged. To support this, factor the definitions common to every Galileo signal (SignalHealth / DataValidityStatus enums, GalileoAlmanac, the galileo_viterbi FEC primitive) out of e1b.jl into a new galileo/galileo.jl, and hoist the package-wide physical constants (GNSS_PI, SPEED_OF_LIGHT, EARTH_ROTATION_RATE) into gnss.jl as a single source of truth. Requires GNSSSignals 2.3 (compat bumped from 2.2), which adds the GalileoE5aI / GalileoE5aQ signal types (GNSSSignals.jl PR #83). The GNSSDecoderState(::GalileoE5aI, prn) dispatch resolves that type directly, mirroring the E1B constructor; F/NAV rides only on the E5a-I data component, so E5a-Q (pilot) does not map to this decoder. Non-breaking: purely additive (new GalileoE5aDecoderState export). The e1b.jl/gnss.jl refactor relocates code without changing any public symbol, signature, or constant value. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a decoder for the Galileo Open Service F/NAV message broadcast on the
E5a-I data component (50 sps). It recovers ephemeris, clock correction,
ionospheric correction, BGD, signal health / data validity, GST-UTC and GST-GPS
conversion, and the word-type-5/6 split-almanac chain — per OS SIS ICD v2.2 §5.1
(word types 1–6).
Usage mirrors the existing decoders:
What's in here
src/galileo/e5a.jl— F/NAV decoder: page sync, FEC, CRC, and word-type1–6 field parsing, plus the SVID-2 split-almanac stitching across WT5/WT6.
src/galileo/galileo.jl(new) — definitions shared by every Galileosignal, factored out of
e1b.jl: theSignalHealth/DataValidityStatusenums,
GalileoAlmanac, and the commongalileo_viterbiFEC primitive.src/gnss.jl— hoists the package-wide physical constants (GNSS_PI,SPEED_OF_LIGHT,EARTH_ROTATION_RATE) to a single source of truth; GPSdecoders now reference them (values unchanged).
The FEC chain reuses the shared Galileo K=7 NSC Viterbi (G1=0o171, G2=0o133 with
G2 inverted): 12-symbol sync detection → 61×8 block deinterleave → G2 sign-flip
on the soft LLRs → AFF3CT Viterbi (K=238, N=488) → CRC-24Q over the 238-bit page.
Consumes soft symbols end-to-end like L1 C/A and E1B, so the public
decodeAPIis unchanged.
Testing
test/galileo_e5a.jldrives the fulldecodepath against a Spirent PRN 21capture (152 F/NAV pages). Field values are checked against the independent
Spirent ground-truth dump, so a layout mistake can't be masked by a shared
encode/decode bug. Covered: FEC round-trip, CRC validity, the full
ephemeris/clock frame, the WT5/WT6 split-almanac stitching, the 180° polarity
ambiguity, and reset semantics. Full suite: 2043 / 2043 pass.
Dependency / CI note
Requires GNSSSignals ≥ 2.3 (compat bumped from
2.2), which adds theGalileoE5aI/GalileoE5aQsignal types (JuliaGNSS/GNSSSignals.jl#83).masterbut not yetregistered in General (registry max is 2.2.2). CI will stay red until
2.3.0 is registered — the
"2.3"compat can't resolve before then, so thefailing jobs can simply be re-run once it lands. No further changes are needed
here.
Compatibility
Non-breaking — purely additive (new
GalileoE5aDecoderStateexport). Thee1b.jl/gnss.jlrefactor relocates code without changing any public symbol,signature, or constant value. Suggest a minor version bump (3.0.0 → 3.1.0).
🤖 Generated with Claude Code