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
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.
Supply the information asked for and submit the form once done to complete the setup.
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.
- Raspbian Raspbian Stretch
- Debian Debian 8 ("Jessie") and Debian 9 ("Stretch").
- Ubuntu Ubuntu 16.04 LTS ("Xenial Xerus"), Ubuntu 18.04 LTS ("Bionic Beaver") and Ubuntu 18.10 ("Cosmic Cuttlefish").
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.
- A device such as a desktop/laptop PC or Raspberry Pi.
- An RTL-SDR dongle containing a R820T or R820T2 tuner.
- An antenna tuned to receive the 1090MHz frequency.
The above with dump978 setup as well.
- An additional RTL-SDR dongle containing a R820T or R820T2 tuner.
- An additional antenna tuned to receive the 978MHz frequency.
Any of the above with the web portal w/ advanced options.
- A durable data storage medium such as an internal or external hard drive.
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.
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.