logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

SYNOPSIS

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)

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

See Also