Receiver Setup Guide

This guide contains the information you will need to know to set up or upgrading your receiver. It is recommended that you review this information before beginning to setup your receiver. Some pages contain vital information on how to make certain things work properly before, during, and after setup is complete.


Quick Install Guide

For new installations...

You can download the code and start the installation process by running the following commands.

sudo apt-get update
sudo apt-get install git
git clone https://github.com/jprochazka/adsb-receiver.git ~/adsb-receiver
cd ~/adsb-receiver
chmod +x install.sh
./install.sh

Updating existing installations...

Simply execute the installation script found in the adsb-receiver directory.

cd ~/adsb-receiver
./install.sh

Portal setup...

This step pertains to both fresh installations as well as when updating an existing installation. After running the installation scripts you will need to setup the portal by visiting the following web address.

http://IP_ADDRESS_OF_YOUR_DEVICE/install/

Supply the information asked for and submit the form once done to complete the setup.


System Requirements

Operating System

The project files should work on most any current Debian derived Linux distribution. The following is a list of the distribution on which the installation process has been developed and tested.

Hardware

Any somewhat up to date desktop/laptop PC or Raspberry Pi should be capable of running the base installation options outlined below. However keep in mind depending on the feeder options you select your device's CPU load and memory usage will increase which may result in the need for more powerful hardware.

Base dump1090 and the web portal w/ lite options.

The above with dump978 setup as well.

Any of the above with the web portal w/ advanced options.


The ADS-B Receiver Project Images


Before Installing Dump978

Assigning RTL-SDR Devices

When installing dump978 along with dump1090 using these scripts you will be asked to specify the index or serial number of the device you wish to dedicate to each decoder. This should be done before executing install.sh.

Get The RTL-SDR Device Indexes

The easiest way I have found to get a list of the indexes and serial numbers for your RTL-SDR devices is to run the command rtl_test.

rtl_test

More than likely this will error out on you but in the mean time, it will display the information you will need within the first few lines of output. For each device, the number before the colon is the index. The serial number is the string following the characters SN:. The device index numbers will more than likely be easier to remember and will do the job just fine. The only trick is making sure you associate the device with the correct decoder. Make sure you know which device goes to your 1090MHz antenna and which connects to your 978MHz antenna.

pi@raspberrypi:~ $ rtl_test
Found 2 device(s):
  0:  Realtek, RTL2838UHIDIR, SN: 00000001
  1:  Realtek, RTL2838UHIDIR, SN: 00000001

Using device 0: Generic RTL2832U OEM
usb_claim_interface error -6
Failed to open rtlsdr device #0.
pi@raspberrypi:~ $

Once you have this information you can begin the installation.

Assigning The RTL-SDR Devices

During the dump978 setup process if dump1090 is present you will be asked to specify which device is to be assigned to which decoder. When asked, assign the index or serial number of the RTL-SDR device connected to your 1090MHz antenna as the Dump1090 Dongle. Then assign the index or serial number of the RTL-SDR device connected to your 978MHz antenna as the Dump978 Dongle.