978 UAT¶
The UAT decoder handles both aircraft-originated downlinks and ground-station uplinks on 978 MHz. It feeds aircraft state into the shared Aviation workspace and passes uplink payloads to the FIS-B/TIS-B/ADS-R product path.
Signal and frame geometry¶
| Property | Value |
|---|---|
| RF channel | 978.000 MHz |
| Decoder rate | 6.25M/3 S/s = 2,083,333⅓ S/s |
| Bit rate | approximately 1.041667 Mbit/s |
| Preferred bandwidth | 1.5 MHz (1.0–2.083334 MHz permitted) |
| Downlink sync | 36-bit 0xEACDDA4E2 |
| Uplink sync | 36-bit 0x153225B1D |
| Downlink | 18/30-byte short or 34/48-byte long data/coded frames |
| Uplink | six blocks, each 72 data / 92 coded bytes; 432/552 total |
| Integrity | shortened Reed–Solomon correction and frame geometry |
IQ pipeline¶
flowchart TB
CU8[Receiver CU8] --> CH[Channelizer to 6.25M/3 S/s]
CH --> DISC[Two-samples-per-bit phase discriminator]
DISC --> SYNC[36-bit downlink/uplink sync correlation]
SYNC --> CLASS[Short / long / uplink geometry]
CLASS --> RS[Shortened Reed–Solomon FEC]
RS --> FRAME[Validated UAT frame event]
FRAME --> AIR[Aircraft state parser]
FRAME --> GROUND[Uplink / FIS-B parser]
AIR --> AVI[Aviation intelligence]
GROUND --> PRODUCTS[Weather/information products]
FEC is performed inside the C/WASM module. TypeScript never treats a raw uncorrected candidate as a validated frame. Correction counts and uncorrectable frames remain explicit diagnostics.
Aircraft messages¶
The implemented parser derives fields where the UAT message type provides them: qualified address/identity, callsign/flight ID, position, altitude, groundspeed/track, vertical rate, squawk/status, emitter/category, and other state. Address qualifiers matter because not every 24-bit field has identical ICAO identity semantics.
TIS-B and ADS-R observations can report another aircraft. Their surveillance source and relay provenance are retained instead of being presented as a direct airborne broadcast.
Ground uplinks and FIS-B¶
Valid uplink blocks enter the product parser for service/status frames and the implemented FIS-B families. Text and geographic products preserve reception, issue, valid, and expiration times separately. Weather received over RF stays usable offline and is not silently replaced by an Internet service.
Supported/valuable families include METAR/SPECI, TAF, PIREP, AIRMET, SIGMET and Convective SIGMET, winds/temperatures aloft, applicable NOTAM/advisory records, and precipitation/geographic products where the decoder implements their published representation. An unknown product remains inspectable rather than receiving an invented interpretation.
Map and cross-protocol identity¶
UAT aircraft use the same markers, labels, selection, trails, distance/bearing, and reference-time behavior as 1090ES. Freshness and trust select the displayed field; the aircraft details retain both sources and timestamps. Geographic weather layers are separately toggleable to control clutter.
Tests¶
uatRawIqPipeline.test.ts includes deterministic raw-IQ downlink and uplink
fixtures through production demodulation, sync, FEC, and decoding, plus noise,
corruption, and representative offset robustness. aviation.test.ts, service,
persistence, and map tests cover shared state. Live OTA validation has also
been performed, but deterministic fixtures remain the CI regression gate.