dump1090-mutability1

Usage

NAME dump1090-mutability - Mode-S decoder

Overview

dump1090-mutability receives and decodes Mode S packets using the Realtek RTL2832 software defined radio interface. It provides the ability to decode multiple frame types as well as correct bit errors using the embedded 24-bit CRC. Results can be viewed using a text client, via the built- in HTTP server or forwarded off to other locations for collection.

Options

The supported options are as follows:

--device-index index

Select RTL device (default: 0)

--gain db

Set gain (default: max gain. Use -10 for auto-gain)

--enable-agc

Enable the Automatic Gain Control (default: off)

--freq hz

Set frequency (default: 1090 Mhz)

--ifile filename

Read data from file (use '-' for stdin)

--interactive

Display received in a textual table, in real-time.

--interactive-rows num

Max number of rows in interactive mode (default: 15)

--interactive-ttl sec

Remove from list if idle for sec (default: 60)

--interactive-rtl1090

Display flight table in RTL1090 format

--raw

Show only messages hex values

--net Enable networking

--modeac

Enable decoding of SSR Modes 3/A & 3/C

--net-beast

TCP raw output in Beast binary format

--net-only

Enable just networking, no RTL device or file used

--net-http-port port

HTTP server port (default: 8080)

--net-ri-port port

TCP raw input listen port (default: 30001)

--net-ro-port port

TCP raw output listen port (default: 30002)

--net-sbs-port port TCP BaseStation output listen port (default: 30003)

--net-bi-port port

TCP Beast input listen port (default: 30004)

--net-bo-port port

TCP Beast output listen port (default: 30005)

--net-ro-size size

TCP raw output minimum size (default: 0)

--net-ro-rate rate

TCP raw output memory flush rate (default: 0)

--net-heartbeat rate

TCP heartbeat rate in seconds (default: 60; 0 to disable)

--net-buffer n

TCP buffer size 64Kb * (2^n) (default: n=0, 64Kb)

--lat latitude

Reference/receiver latitude for surface posn (opt)

--lon longitude

Reference/receiver longitude for surface posn (opt)

--fix

Enable single-bits error correction using CRC

--no-fix

Disable single-bits error correction using CRC

--no-crc-check

Disable messages with broken CRC (discouraged)

--phase-enhance

Enable phase enhancement

--aggressive

More CPU for more messages (two bits fixes, ...)

--mlat

display raw messages in Beast ascii mode

--stats

With --ifile print stats at exit. No other output

--onlyaddr

Show only ICAO addresses (testing purposes)

--metric

Use metric units (meters, km/h, ...)

--snip level

Strip IQ file removing samples level

--debug flags

Debug mode (verbose)

--quiet

Disable output to stdout.

--ppm error

Set receiver error in parts per million (default 0)

--help

Show help

Diagnostics

The Debug mode is a visual help to improve the detection algorithm or to understand why the program is not working for a given input.

In this mode messages are displayed in an ASCII-art style graphical representation, where the individual magnitude bars sampled at 2MHz are displayed.

An index shows the sample number, where 0 is the sample where the first Mode S peak was found. Some additional background noise is also added before the first peak to provide some context.

Select frames to log using the following flags:

Examples

The most basic usage is with no flags, which will open the first found rtl-sdr device and begin printing out hex dumps of the received packets.

Most people will either run this in interactive mode or as a daemon.

Interactive mode

        dump1090-mutability --interactive

Daemon mode

        dump1090-mutability --net --quiet &

You can also use dump1090-mutability as a network hub for multiple receivers by using

        dump1090-mutability --net-only