DOCSEARCHbyAlgolia
Submit Docs

dump1090 Documentation

repository·master·Indexed 25 days ago

https://github.com/antirez/dump1090

A high-performance Mode S decoder optimized for RTL-SDR devices. It features robust decoding of weak signals, surface position decoding, and multiple network output formats including Raw, SBS1, and HTTP. Supports error correction, aggressive decoding modes, and raw 8-bit unsigned IQ sample processing via files or standard input.

Tokens
561
Snippets
1
Records
6
Agent score
34%

What's inside dump1090

  1. Decode data from a file

    master

    You can use the --ifile flag to decode raw 8-bit unsigned IQ samples from a file. You can also feed data via standard input by passing - as the argument to --ifile.

    To create a compatible binary file using rtl_sdr, use a 2Mhz sample rate:

  3. Run Dump1090 in various modes

    master

    Dump1090 can be executed with different flags to change its output behavior:

    • Default mode: Captures traffic directly from an RTL device and outputs to standard output.
    • Raw mode: Outputs only hexadecimal messages.
    • Interactive mode: Displays a refreshing list of detected aircraft in the terminal.
    • Interactive mode with networking: Enables the embedded HTTP server (accessible at http://localhost:8080) and interactive terminal output.

  4. Configure error correction and aggressive decoding

    master

    Dump1090 includes features to improve detection and reliability:

    • Error Correction: By default, the program uses a 24-bit CRC and a precomputed syndrome table to correct up to two bit errors. To disable this and use raw data, use the --no-fix flag.
    • Aggressive Mode: The --aggressive flag enables a modified detection algorithm that tolerates up to two demodulation errors and attempts to fix DF17 messages by trying every two-bit combination. This uses more CPU and is best suited for low-traffic environments.

  5. Use Dump1090 network server features

    master

    Enabling networking with the --net flag starts listening on specific ports for data streaming and input. You can also run Dump1090 as a network-only hub using --net-only.

    Available Ports

    • Port 30002 (Raw Output): Serves connected clients with raw hexadecimal messages (e.g., *8D451E8B99019699C00B0A81F36E;) separated by newlines.
    • Port 30001 (Raw Input): Accepts raw hex messages (starting with * and ending with ;) to feed into Dump1090. Data received here is also broadcast to clients on port 30002.
    • Port 30003 (SBS1/BaseStation Output): Serves messages in SBS1 format (e.g., MSG,4,,,738065,,,,,,,,420,179,,,0,0,0,0), which is compatible with various aircraft data sharing sites.

  6. Use the --snip mode for file filtering

    master
    The --snip mode acts as a filter for raw 8-bit IQ samples. It outputs a file that excludes segments where the I and Q values are lower than the specified <level> for more than 32 consecutive samples.