readsb(1) readsb(1)

readsb - Mode-S aircraft data processor for various receiver hardware.

v3.8.1

readsb Mode-S Receiver

readsb [OPTION...]

Apply a 1Hz DC filter to input data (requires more CPU)
Enable bias tee on supporting interfaces (default: disabled)
Debug mode (verbose), see flags below
Select SDR type
Enable CRC single-bit error correction (default)
Allow forwarding of received mlat results to output ports
Set frequency (default: 1090 MHz)
Set gain (default: max gain. Use -10 for auto-gain)
Show altitudes as GNSS when available
Interactive mode refreshing data on screen. Implies --throttle
Remove from list if idle for <sec> (default: 60)
Accuracy of receiver location in json metadata:
0
no location
1
approximate
2
exact

Reference/receiver surface latitude
Reference/receiver surface longitude
Absolute maximum range for position decoding (in nm, default: 300)
Use metric units
Display raw messages in Beast ASCII mode
Enable decoding of SSR Modes 3/A & 3/C
Disable messages with invalid CRC (discouraged)
Disable CRC single-bit error correction
Disable interactive mode, print to stdout
Don't enable Mode A/C if requested by a Beast connection
Show only ICAO addresses
Disable output. Use for daemon applications
Show only messages hex values
Show only messages by given ICAO on stdout
Strip IQ file removing samples < level
With --ifile print stats at exit. No other output
Show and reset stats every <sec> seconds
Collect/show range histogram
Periodically write json output to <dir> (for external webserver)
Write json output every t seconds (default 1)

Enable networking
TCP Beast input listen ports (default: 30004,30104)
TCP VRS json output listen ports (default: 0)
TCP BeastReduce output listen ports (default: 0)
BeastReduce position update interval, longer means less data (default: 0.125, valid range: 0.000 - 14.999)
IP address to bind to (default: Any; Use 127.0.0.1 for private)
TCP Beast output listen ports (default: 30005)
TCP buffer size 64Kb * (2^n) (default: n=0, 64Kb)
TCP heartbeat rate in seconds (default: 60 sec, 0 to disable)
Enable just networking, no RTL device or file used
Establish connection, can be specified multiple times (example: 127.0.0.1,23004,beast_out) Protocols: beast_out, beast_in, raw_out, raw_in, sbs_out, vrs_out.
Outbound re-connection delay (default: 30)
TCP raw input listen ports (default: 30001)
TCP output memory flush rate in seconds (default: 0)
TCP raw output listen ports (default: 30002)
TCP output minimum size (default: 0)
TCP BaseStation output listen ports (default: 30003)

Forward messages unchanged

use with --device-type rtlsdr

Select device by index or serial number
Enable digital AGC (not tuner AGC!)
Set oscillator frequency correction in PPM

use with --device-type bladerf

Set LPF bandwidth ('bypass' to bypass the LPF)
Assume FPGA decimates by a factor of N
Use alternative FPGA bitstream ('' to disable FPGA load)
Select device by bladeRF 'device identifier'

use with --device-type modesbeast

Beast binary protocol and hardware handshake are always enabled.

Turn OFF CRC checking
Turn ON DF0/4/5 filter
Turn ON DF11/17-only filter
Turn OFF forward error correction
Turn OFF MLAT time stamps
Turn ON mode A/C
Path to Beast serial device (default /dev/ttyUSB0)

use with --device-type plutosdr

Default device expected at hostname 'pluto.local'.

Create USB context from URI (eg. usb:1.2.5)
Create network context from hostname or IP (default pluto.local)

use with --ifile

Read samples from given file ('-' for stdin)
Set sample format (UC8, SC16, SC16Q11)
Process samples at the original capture speed

-?, --help
Give this help list
Give a short usage message
Print program version

Log frames decoded with errors
Log frames decoded with zero errors
Log frames with bad CRC
Log frames with good CRC
Log frames with bad preamble
Log network debugging info
Log frames to frames.js, loadable by debug.html

Matthias Wirth aka wiedehopf Taner Halicioglu aka tanerH

Report bugs to Michael Wolf <michael@mictronics.de>.

Michael Wolf

12 December 2019