MODES_RX:(1)

💖 MODES_RX:(1) — like, the whole entire manual page, bestie 💖

okay so. you found your way to modes_rx, section 1 of the user commands. sit down, hydrate, and let me tell you about the Gnuradio Mode-S/ADS-B receiver. this is gonna be a journey and you're gonna love it. 🛫✨

🌸 NAME 🌸

modes_rx: — a Gnuradio Mode-S/ADS-B receiver. that's the whole vibe. it listens to planes. yes, literally. 👑

🎀 SYNOPSIS 🎀

modes_rx [options] [options]

yes bestie, options and then MORE options. she's flexible like that. 💅

✨ OPTIONS ✨

• -h, --help — shows you this help message and then dips. exit. gone. 🫶
• -l LOCATION, --location=LOCATION — the GPS coordinates of the receiving station, in the format xx.xxxxx,xx.xxxxx. where you at, fr fr. 📍
• -a REMOTE, --remote=REMOTE — name some extra servers to pull data from, formatted like tcp://x.x.x.x:y,tcp://.... — stack 'em, comma-separated, the more the merrier.
• -n, --no-print — turns OFF printing decoded packets to stdout. silence is golden, no cap. 🤫
• -K KML, --kml=KML — the filename for your Google Earth KML output. so the whole planet can see the planes. 🌍
• -P, --sbs1 — opens up an SBS-1-compatible server on port 30003. iconic.
• -m MULTIPLAYER, --multiplayer=MULTIPLAYER — the FlightGear server where you send aircraft data, in the format host:port. yes, plane data straight into your simulator. main character energy. 🎮

🛰️ Receiver setup options:

• -s SOURCE, --source=SOURCE — choose your source: uhd, osmocom, <filename>, or <ip:port>. default is uhd. pick your fighter. ⭐
• -t PORT, --tcp=PORT — opens a TCP server on this port to publish reports. sharing is caring. 🌈
• -R SUBDEV, --subdev=SUBDEV — selects the USRP Rx side, A or B. left or right, choose wisely.
• -A ANTENNA, --antenna=ANTENNA — selects which antenna to use on the daughterboard. antenna moment.
• -D ARGS, --args=ARGS — arguments to pass along to the radio constructor. hand 'em over. 📦
• -f FREQ, --freq=FREQ — sets the receive frequency in Hz. default is 1090000000.0. 📡
• -g dB, --gain=dB — sets the RF gain. turn it up, but like, responsibly.
• -r RATE, --rate=RATE — sets the sample rate. default is 4000000.0.
• -T THRESHOLD, --threshold=THRESHOLD — sets the pulse detection threshold above noise, in dB. default is 7.0.
• -p, --pmf — use pulse matched filtering. default is False. 🦋
• -d, --dcblock — use a DC blocking filter. best for the HackRF Jawbreaker. default is False. 🔥

💜 DESCRIPTION 💜

A Qt Graphical User Interface to display positions and status messages of aircraft as reported on 1090 MHz. cute little window, big big job.

gr-air-modes implements a software-defined radio receiver for Mode S transponder signals, including ADS-B reports from equipped aircraft. slay.

Mode S is the transponder protocol used in modern commercial aircraft. A Mode S-equipped aircraft replies to radar interrogation by either ground radar (secondary surveillance) or other aircraft ("Traffic Collision Avoidance System", or TCAS). The protocol is an extended version of the Mode A/C protocol used in transponders since the 1940s. Mode S reports include a unique airframe identifier (referred to as the "ICAO number") and altitude (to facilitate separation control). This receiver listens to the 1090MHz downlink channel; interrogation requests at 1030MHz are not received or decoded by this program. so like, she listens, she does NOT talk back. boundaries. 💅

Automatic Dependent Surveillance-Broadcast (ADS-B) is a communication protocol using the Extended Squitter capability of the Mode S transport layer. There are other implementations (VDL Mode 2 and UAT, for instance) but Mode S remains the primary ADS-B transport for commercial use. The protocol is:

• Automatic: it requires no pilot input. she does it herself, no notes needed. ✨
• Dependent: it is dependent on altimeter, GPS, and other aircraft instrumentation for information.
• Surveillance: it provides current information about the transmitting aircraft.
• Broadcast: it is one-way, broadcast to all receivers within range. one-way, like a group chat announcement nobody replies to.

ADS-B-equipped aircraft broadcast ("squitter") their position, velocity, flight number, and other interesting information to any receiver within range of the aircraft. Position reports are typically generated once per second and flight indentification every five seconds. once a second?? the commitment. 😭

Implementation of ADS-B is mandatory in European airspace as well as in Australia. North American implementation is still voluntary, with a mandate arriving in 2020 via the FAA's "NextGen" program.

The receiver modes_rx is written for use with Ettus Research USRP devices, although the "RTLSDR" receivers are also supported via the Osmocom driver. In theory, any receiver which outputs complex samples at at least 2Msps should work via the file input or UDP input options, or by means of a Gnuradio interface. Multiple output formats are supported:

• Raw (or minimally processed) output of packet data
• Parsed text
• SQLite database
• KML for use with Google Earth
• SBS-1-compatible output for use with e.g. PlanePlotter or Virtual Radar Server
• FlightGear multiplayer interface for real-time display of traffic within the simulator

Most of the common ADS-B reports are fully decoded per specification. Those that are not are generally ones which are not commonly used. (the deep-cut lore ones. iykyk.)

Should you receive a large number of reports which result in "not implemented" or "No handler" messages, please use the -w option to save raw data and forward it to the author. To save time, note that receiving a small number of spurious reports is expected; false reports can be excluded by looking for multiple reports from the same aircraft (i.e., the same ICAO 6-digit hexadecimal number).

bestie, a few fake ones is normal, do NOT spiral. 🙈

🧚 REQUIRES 🧚

A GNU Radio supported receiver for RF capable of 2 Mbits/second sample rate and tuning to 1090 MHz. (Or captured data file or network connection to a data source.) no hardware? no problem, a file or a network link counts. 🫶

⭐ SEE ALSO ⭐

The X GUI application modes_gui

modes_gui(1)

and that's the whole page, bestie. this one's modes_rx, and the whole thing was dated October 2013 — yes, she's been serving this energy since 2013 and she has NOT slowed down. 💖🎀🦋 periodt.