1090ES / Mode S¶
The 1090 MHz decoder extracts CRC-valid Mode S extended squitter traffic and feeds protocol interpretation into the shared aviation intelligence model.
Input geometry¶
| Property | Value |
|---|---|
| RF channel | 1,090.000 MHz |
| Domain | complex IQ |
| Exact input | 2.4 MS/s |
| Preferred bandwidth | 2.0 MHz (1.8–2.4 MHz permitted) |
| Signaling | Mode S pulse-position modulation |
| Supported frames | 112-bit DF17/DF18 extended squitter |
| Validation | Mode S parity/CRC polynomial 0xfff409 |
IQ pipeline¶
flowchart TB
CU8[Receiver CU8 at 2.4 MS/s] --> MAG[Complex magnitude / level]
MAG --> PRE[Mode S preamble correlation]
PRE --> PHASE[Five fractional sample phases]
PHASE --> PPM[1 µs PPM bit slicing]
PPM --> FRAME[112-bit DF17/DF18 candidate]
FRAME --> CRC[Mode S CRC]
CRC --> RAW[Validated raw frame event]
RAW --> TS[TypeScript ADS-B interpretation]
TS --> CPR[Global/local CPR and state fields]
CPR --> AVI[Aviation intelligence + map]
The C module contains readsb-derived 2.4 MS/s fractional phase slicers and preamble correlation. Five timing phases compensate for the non-integer relationship between 2.4 samples/µs and pulse edges. Candidates that are not DF17/DF18 or fail CRC are not emitted as validated aircraft messages.
Interpretation¶
The TypeScript layer decodes the implemented ADS-B type codes, including ICAO address, flight identification, airborne/surface position, barometric or GNSS altitude where represented, velocity/ground track, vertical rate, squawk and emergency/status, and emitter category where available.
Compact Position Reporting uses paired even/odd global CPR when valid and supported local decoding when reference constraints are satisfied. CPR age, surface/airborne zone, NL function, and latitude/longitude plausibility are checked; an address alone does not fabricate a position.
Aviation integration¶
Each observation records 1090es, surveillance source, receiver/lane,
capture time, raw frame, validation evidence, and decoded fields. FAA local
metadata may add registration/type/owner evidence. UAT observations with the
same qualified ICAO identity can contribute to one aircraft while both
protocol histories remain visible.
Moving-map orientation prefers fresh trustworthy ground track—the direction of travel—rather than confusing magnetic/true heading with course. True heading remains separate evidence. Presentation interpolation is never stored as an observation.
Detection and replay¶
The exact 1090 MHz service channel is a strong manifest prior and permits a bounded Auto Start trial. Validation still requires CRC-valid output. Replay passes raw IQ through the same slicer/parser path; historical aircraft state is queried as of capture time.
Tests and limitations¶
decoderArtifact.test.ts synthesizes raw 2.4 MS/s IQ for a CRC-valid frame and
passes it through the built WASM artifact. aviation.test.ts covers message
fields and CPR pairs; aviation service, persistence, history, scaling, map,
and start-policy tests cover integration. This implementation intentionally
does not claim support for every Mode S downlink format; validated output is
currently focused on 112-bit DF17/DF18 extended squitter.