NAME dump1090-mutability - Mode-S decoder

SYNOPSIS

       dump1090-mutability
       dump1090-mutability --interactive
       dump1090-mutability --ifile file

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.

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:

       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

BUGS

       Report     bugs     with     the     program     to     the    project's    github    page
       <https://github.com/mutability/dump1090/>

AUTHORS

       Dump1090 was originally written by Salvatore Sanfilippo <antirez@gmail.com>.  This version
       is  now  maintained by Oliver Jowett <oliver@mutability.co.uk>.  This manpage was prepared
       for Debian by Matthew Ernisse <mernisse@ub3rgeek.net>.

                                          17 August 2014                   DUMP1090-MUTABILITY(1)