Description

ModeSDeco2 is SDR receiver and decoder for Automatic Dependent Surveillance-Broadcast Mode (ADS-B) and Secondary Surveillance Systems Radar (Mode A/C, Mode-S) signals and output data feed to network in multiple formats.

md2_flights

md2_charts

md2_stats

Arguments

The required configuration for specific target is specified by using command line arguments. The arguments are separated by spaces. Each argument specifies a single function and can contain additional parameters.
When the program is run with a single argument: --help the full list of possible arguments is displayed.

C:\>modesdeco2.exe --help
YYYY-MM-DD HH:MM:SS.ms  INFO     ModeSDeco2 v.20140809
Program options
-h [ --help ]            This help message
--device-list            List Available devices
--device-index <arg>     Select RTL device (default: 0)
--gain <arg>             Set gain in Receiver, dB (default: Auto)
--agc                    Enable Automatic Gain Control in RTL (default: off)
--freq <arg>             Set frequency, Hz (default: 1090000000)
--freq-correction <arg>  Set frequency correction, ppm (default: 0)
--input-file <arg>       Set input filename with I/Q signals
--rbs                    Enable RBS decoding
--beast <arg>            Enable Beast output listen port (default: off)
--avr <arg>              Enable AVR output listen port (default: off)
--avrmlat <arg>          Enable AVR MLAT output listen port (default: off)
--sbs10001 <arg>         Enable SBS-3 output listen port (default: off)
--msg <arg>              Enable MSG output listen port (default: off)
--localtime              Local Time in MSG format output (default: UTC)
--filter-expire <arg>    Filter record expire time, sec (default: 20)
--filter-count <arg>     Filter record min count (default: 6)
--filter-time <arg>      Filter record min time, sec (default: 60)
--filter-nocountry       Disable ICAO Country filter (default: on)
--location <arg>         Receiver location Lat:Lon
--verbose                Verbose mode
--nmea <arg>             Enable GPS Emulation. Format: ICAO:Port:BaudRate
--nmea-logfile <arg>     Set output GPS Emulator logfile

Detailed description of arguments

--device-list — displays list available RTL2832U devices.

--device-index <arg> — selects a specific device by its number in the system. By default is 0.

--gain <arg> — sets a fixed value of gain for the receiving chip (R820T, E4000 …) in dB. By default is Auto.

--agc — sets an automatic gain control in RTL2832U chip. By default is off.

--freq <arg> — sets the receiving frequency in Hz. As for the transmission uses a single channel at 1090 MHz, then the option may be not used and by default will be 1090000000.

--freq-correction <arg> — sets an adjustment by entering the ppm (parts per million) offset value. The crystal of oscillator acting as the master clock for the dongle is an unadjusted 28.8 MHz device. Since the frequency error is completely linear over the tuning range of the device, an error correction in ppm (parts per million) can be used to adjust and correct the device at the software side of operation. By default is 0.

--input-file <arg> — specifies the name of a file with I/Q samples, that has been recorded, for example, using rtl_sdr from osmocom.org.

--rbs — enables RBS (Radar Beacon System) decoding for receive Mode A/C and Mode S messages simultaneously. By default is off.

--beast <arg> — enables a TCP server, that listen incoming connections on port for output data in BEAST format which is a binary hexdump of the raw frame contents. It can be binery messages: 6 Byte MLAT time stamp, 1 Byte signal level, 2 Byte Mode-AC or 7 Byte Mode-S short frame, or 14 Byte Mode-S long frame. By default is off.

--avr <arg> — enables a TCP server, that listen incoming connections on port for output data in AVR format which is a ASCII hexdump of the raw frame contents. It can be text messages: 56 Bit Mode-S frames, as *02E99619FACDAE; 112 Bit Mode-S frames, as *8D3C5EE69901BD9540078D37335F; Mode-A/C frames, as *7700 (Mode-A/C frame values are octal). By default is off.

--avrmlat <arg> — enables a TCP server, that listen incoming connections on port for output data in AVR format which is a ASCII hexdump of the raw frame contents with 6 Byte time stamp. It can be text messages: 56 Bit Mode-S frames, as @016CE3671C7402E99619FACDAE; 112 Bit Mode-S frames, as @016CE3671AA88D3C5EE69901BD9540078D37335F; Mode-A/C frames, as @016CE3671C747700 (Mode-A/C frame values are octal). By default is off.

--sbs10001 <arg> — enables a TCP server, that emulates SBS-1/3 receiver from Kinetic Avionics and allows to connect BaseStation program directly. By default is off.

--msg <arg> — enables a TCP server, that listen incoming connections on port for output data in eight different MSG type messages, which is a text strings. Each message type contains up to 22 different fields, as MSG,3,0,0,780B45,0,2014/11/09,15:45:26.981,2014/11/09,15:45:26.981,,37000,,,57.591568,71.852818,,,,,,0. Often this format are called as MSG30003, because TCP port 30003 has become the de-facto standard for transmission of MSG messages. By default is off.

--localtime — sets a local time in MSG messages instead of UTC by default.

--filter-expire <arg> Filter record expire time, sec (default: 20)

--filter-count <arg> Filter record min count (default: 6)

--filter-time <arg> Filter record min time, sec (default: 60)

--filter-nocountry Disable ICAO Country filter (default: on)

--location <arg> — sets coordinates of location of the receiver in Lat:Lon format. Required for unambiguous decoding location of aircraft on ground for MSG messages. By default is off.

--verbose — sets verbose mode output in console. By default is disable.

--nmea <arg> — allows to use data obtained from any aircraft with ADS-B transponder to generate output GPS data based on NMEA-0183 protocol for emulation a GPS receiver. Generates four types of NMEA sentences: GGA, RMC, GLL and VTG. The field 10 of GGA, instead of the antenna height above the geoid, is used barometric altitude. The null-modem com0com emulator can be used to provide serial interface for device emulators. In this case modesdeco2 uses one port of the pair and the other port can be used by Windows application that requires a COM port to communicate with GPS device. The argument has format: ICAO:Port:BaudRate.

--nmea-logfile <arg> — sets name of output GPS emulator NMEA logfile.

ModeSDeco

Updated on 2014-12-14T23:02:44+00:00, by sergsero.