Skip to content

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.