SYNOPSIS
Contents
Bugs
Report bugs with the program to the project's github page <https://github.com/mutability/dump1090/>
Description
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.
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:
d Log frames decoded with errors
D Log frames decoded with zero errors
c Log frames with bad CRC
C Log frames with good CRC
p Log frames with bad preamble
n Log network debugging info
j Log frames to frames.js, loadable by debug.html
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
Name Dump1090-Mutability - Mode-S Decoder
Options
The supported options are as follows:
--device-indexindex
Select RTL device (default: 0)
--gaindb
Set gain (default: max gain. Use -10 for auto-gain)
--enable-agc
Enable the Automatic Gain Control (default: off)
--freqhz
Set frequency (default: 1090 Mhz)
--ifilefilename
Read data from file (use '-' for stdin)
--interactive
Display received in a textual table, in real-time.
--interactive-rowsnum
Max number of rows in interactive mode (default: 15)
--interactive-ttlsec
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-portport
HTTP server port (default: 8080)
--net-ri-portport
TCP raw input listen port (default: 30001)
--net-ro-portport
TCP raw output listen port (default: 30002)
--net-sbs-portport TCP BaseStation output listen port (default: 30003)
--net-bi-portport
TCP Beast input listen port (default: 30004)
--net-bo-portport
TCP Beast output listen port (default: 30005)
--net-ro-sizesize
TCP raw output minimum size (default: 0)
--net-ro-raterate
TCP raw output memory flush rate (default: 0)
--net-heartbeatrate
TCP heartbeat rate in seconds (default: 60; 0 to disable)
--net-buffern
TCP buffer size 64Kb * (2^n) (default: n=0, 64Kb)
--latlatitude
Reference/receiver latitude for surface posn (opt)
--lonlongitude
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, ...)
--sniplevel
Strip IQ file removing samples level--debugflags
Debug mode (verbose)
--quiet
Disable output to stdout.
--ppmerror
Set receiver error in parts per million (default 0)
--help Show help
Synopsis
dump1090-mutabilitydump1090-mutability--interactivedump1090-mutability--ifilefile
