AcarsDeco2 is a command line based receiver and decoder of ACARS (Aircraft Communications Addressing and Reporting System) signals of a system for transmission of short messages between aircraft and ground stations via air-band radio and output data feed to network in multiple formats.


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:\>acarsdeco2.exe --help
YYYY-MM-DD  INFO     AcarsDeco2 v.20140905
Program options
-h [ --help ]            This help message
--device-list            List Available devices
--device-index <arg>     Select RTL device (default: 0)
--device-serial <arg>    Select RTL device by serial no
--gain <arg>             Set gain in Receiver, dB (default: Auto)
--freq-correction <arg>  Set frequency correction, ppm (default: 0)
--agc                    Enable Automatic Gain Control in RTL (default: off)
--freq <arg>             Set frequency, Hz. Specify option --freq multiple times to multiple channels (--freq XX --freq YY ..)
--net <arg>              Enable network-server on port (default: off)
--udp <arg>              Set PlanePlotter UDP server address. Format: address:port (default: off)
--http-port <arg>        Set port for http server (default: 8080)
--vrs-url <arg>          Set VirtualRadarServer url for aircraft images Example: (default: off)
--pictures-url <arg>     Set aircraft pictures url Example: (default: off)
--no-uplink              Don't display uplink messages (default: on)
--no-sq                  Don't display label: SQ messages (default: on)
--no-empty               Don't display empty messages (default: on)
--logfile <arg>          Set log filename (default: off)
--no-console             Disable logging on console (default: on)

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.

--device-serial <arg> — selects a specific device by its serial number. This argument is only interesting to those users that operate more than one dongle in their installation and want to assign specific RTL1090 instances to a specific dongle. R820T dongles come with a serial number “13” usually. Strongly recommend not to alter the serial number of the first dongle you operate. Leave it at “13”. For any other dongles that you want to operate select a serial number of your choice between 0 and 999. For details how to change the serial number of dongle, please refer to page:

--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-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.

--freq <arg> — sets the receiving frequency in Hz. Separation between channels with low and high frequency should be no more than 1.4 MHz.
The number of simultaneously receiving channels is up to 3.

--net <arg> — enables a TCP server, that listen incoming connections on port for output data in Kinetic Avionics SBS-3 ACARS format which is a ASCII string, as: 2014-11-10,08:54:16,131.725,K,VP-BGD,,SA,6,S23A,SU0251,0EV085412VS. By default is off.

--udp <arg> — enables a UDP client, that sends data in PlanePlotter which is a ASCII string, as: XXX to PlanePlotter UDP server in address:port. By default is off.

--http-port <arg> — sets port for HTTP server. By default is 8080.

--vrs-url <arg> — sets VirtualRadarServer URL for additional aircraft data and pictures. Sometimes the aircraft can simultaneously transmit both ACARS and ADS-B data. If exists VRS server ( with this data, they can be obtained from it and put on the acarsdeco2 WEB page. By default is off.

--pictures-url <arg> — sets aircraft pictures URL, If exists HTTP server with aircraft pictures, they can be obtained from it by URL and put on the acarsdeco2 WEB page. By default is off.

--no-uplink — disables display UPLINK (ground to air) messages from ground stations. By default is on.

--no-sq — disables display Squitter messages. By default is on.

--no-empty — disables display empty messages. By default is on.

--logfile <arg> — sets name of log file. By default is off.

--no-console — disables display logging on console. By default is on.


Updated on 2014-11-10T16:52:00+00:00, by sergsero.