TESTED ON:
- Ubuntu-20.04-desktop-amd64
- Kali-linux-2020.2-amd64
OPTION-1: AUTOMATED INSTALL
(1) DUMP1090-FA
Copy-paste following command in SSH console and press Enter key.
The script will build & install dump1090-fa.
sudo bash -c "$(wget -O - https://raw.githubusercontent.com/abcd567a/piaware-ubuntu20-amd64/master/install-dump1090-fa.sh)"
(2) PIAWARE
Copy-paste following command in SSH console and press Enter key.
The script will build & install piaware.
sudo bash -c "$(wget -O - https://raw.githubusercontent.com/abcd567a/piaware-ubuntu20-amd64/master/install-piaware.sh)"
https://www.github.com/abcd567a/piaware-ubuntu20-amd64
OPTION-2: MANUAL INSTALL
1 - Install build tools (for Dump1090-fa and Piaware).
$ sudo apt update
$ sudo apt install git dh-systemd devscripts pkg-config
2 - Build & Install DUMP1090-FA
2.1 - Install dump1090-fa dependencies
$ sudo apt install lighttpd librtlsdr-dev libusb-1.0-0-dev libncurses5-dev
2.2 - For KALI LINUX only
Enable and start lighttpd
$ sudo systemctl enable lighttpd
$ sudo systemctl restart lighttpd
2.3 - Clone dump1090-fa source code
$ cd ~/
$ git clone https://github.com/flightaware/dump1090
2.4 - Workaround for non-available package libbladerf1
The package libbladerf1 is missing from package libbladerf-dev in Ubuntu 20 repository
$ cd dump1090
$ sudo sed -i 's/BLADERF=yes/BLADERF=no/' debian/rules
$ sudo sed -i 's/, libbladerf-dev//' debian/control
$ sudo sed -i 's/libbladerf1 (>= 0.2016.06), //' debian/control
2.5 - Build & install dump1090-fa package
$ sudo dpkg-buildpackage -b --no-sign
$ cd ../
$ sudo dpkg -i dump1090-fa_3.8.1*.deb
## TWO COMMANDS BELOW ARE FOR KALI LINUX ONLY
$ sudo systemctl enable dump1090-fa
$ sudo systemctl restart dump1090-fa
## Check status
$ sudo systemctl status dump1090-fa
## If status shows: Failed with result 'exit-code'
## then REBOOT Computer
$ sudo reboot
## Check status after reboot
$ sudo systemctl status dump1090-fa
3 - Build and Install PIAWARE
3.1 - Install piaware dependencies
$ sudo apt install tcl8.6-dev python3-dev libz-dev
$ sudo apt install libboost-system-dev libboost-program-options-dev
$ sudo apt install libboost-regex-dev libboost-filesystem-dev
$ sudo apt install net-tools tclx8.4 tcllib itcl3
3.2 - Build & Install dependency tcl-tls from source code.
## Install dependencies
$ sudo apt install libssl-dev tcl-dev chrpath
## Clone source code, build & Install tcl-tls
$ cd ~/
$ git clone http://github.com/flightaware/tcltls-rebuild.git
$ cd tcltls-rebuild
$ ./prepare-build.sh buster
$ cd package-buster
$ sudo dpkg-buildpackage -b --no-sign
$ cd ../
$ sudo dpkg -i tcl-tls_*.deb
3.3 - Clone piaware source code, build package, and install package.
$ cd ~/
$ git clone http://github.com/flightaware/piaware_builder
$ cd piaware_builder
$ sudo ./sensible-build.sh bionic
## Workaround for pyvenv:
$ cd package-bionic
$ sudo sed -i 's/pyvenv $(VENV) --without-pip/$(PYTHON3) -m venv $(VENV) --without-pip/' debian/rules
$ sudo sed -i 's/python3-venv, //' debian/control
## After above Workaround, build the piaware package
$ sudo dpkg-buildpackage -b --no-sign
$ cd ../
$ sudo dpkg -i piaware_3.8.1*.deb
## TWO COMMANDS BELOW ARE FOR KALI LINUX ONLY
$ sudo systemctl enable piaware
$ sudo systemctl restart piaware
## Check status
$ sudo systemctl status piaware
4 - Configure Station ID
Alternative-1:
Get a brand new station number & feeder id
Log-in to your Flightaware account, go to this page and follow instructions to claim a new station https://flightaware.com/adsb/piaware/claim
Alternative-2:
Configure an Existing Station
(a) - Find existing station’s feeder-id (Unique Identifier)
Log-in to your Flightaware account, go to “My ADSB” / stats page
flightaware.com/adsb/stats/user/ ,
and look for 32-digit Unique Identifier: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Copy Unique Identifier from your “My ADSB” page.
(b) - SSH and configure station id:
sudo piaware-config feeder-id xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
# Replace xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx by your
# actual feeder-id (Unique Identifier)
$ sudo systemctl restart piaware
$ sudo piaware-config allow-manual-updates yes
$ sudo piaware-config allow-auto-updates yes
$ sudo systemctl restart piaware
## Check status
$ sudo systemctl status piaware
5 - Build and Install DUMP978-FA - (For USA only)
5.1 - Install dump978-fa dependencies
$ sudo apt install libsoapysdr-dev soapysdr-module-rtlsdr
5.2 - Clone dump978-fa source code, build package, and install it.
$ cd ~/
$ git clone https://github.com/flightaware/dump978
$ cd dump978
$ sudo dpkg-buildpackage -b --no-sign
$ cd ../
$ sudo dpkg -i dump978-fa_3.8.1*.deb
$ sudo dpkg -i skyaware978_3.8.1*.deb
5.3. - Enable piaware to use dump978-fa
$ sudo piaware-config uat-receiver-type sdr
$ sudo systemctl restart piaware
6 - Configuration for using both dump1090-fa & dump978-fa (Two dongles are required)
6.1 - Serialize dongles: (CLICK HERE)
If you want to receive both ES1090 and UAT978, then two dongles are required, one for 1090 and other for 978. In this case you will have to serialize dongles so that correct dongle+antenna sets are used by dump1090-fa and dump978-fa.
For 1090 Mhz dongle: use serial # 00001090
For 978 Mhz dongle : use serial # 00000978
6.2 - Configure dump1090-fa & dump978-fa to use dongles of assigned serial numbers
$ sudo sed -i 's/--device-index 0/--device-index 00001090/' /etc/default/dump1090-fa
$ sudo sed -i 's/driver=rtlsdr/driver=rtlsdr,serial=00000978/' /etc/default/dump978-fa
6.3 - Reboot so that dump1090-fa & dump978-fa can pick their assigned dongles at boot
$ sudo reboot
7 - B O N U S
7.1 - ModeSMixer2
7.1.1 - Copy-paste following command and press Enter key.
$ sudo bash -c "$(wget -O - https://raw.githubusercontent.com/abcd567a/mm2/master/install-mm2-ubuntu20.sh)"
7.1.2 - When the script finishes installation, it will display instructions to configure. Follow those instructions
7.1.3 - For help and to list all config parameters:
$ modesmixer2 --help
7.1.4 - For detailed Install, Configuration, and Uninstall instructions:
https://github.com/abcd567a/mm2/blob/master/README.md
7.2 - Flightradar24 Feeder
7.2.1 - Issue following two commands to download and install fr24feed’s deb package for amd64 architecture:
$ wget https://repo-feed.flightradar24.com/linux_x86_64_binaries/fr24feed_1.0.25-3_amd64.deb
$ sudo dpkg -i fr24feed_1.0.25-3_amd64.deb
7.2.2 - CONFIGURE
CASE (a): If you have a sharing key:
$ sudo nano /etc/fr24feed.ini
Above command will open a file with following entries
bs=yes
raw=yes
mlat="yes"
mlat-without-gps="yes"
Add following lines to the file fr24feed.ini (replace xxxxxxxxxxx by your actual sharing key).
receiver="beast-tcp"
host="127.0.0.1:30005"
fr24key="xxxxxxxxxxxxxx"
Save file (Ctrl+o) and close (Ctrl+x)
Restart fr24feed
$ sudo systemctl restart fr24feed
CASE (b): If you do NOT have a sharing key:
signup using following command and provide your details such as email, latitude, longitude etc
$ sudo fr24feed --signup
$ sudo systemctl restart fr24feed
7.3 - Planefinder feeder
This method uses i386 deb package, as planefinder’s amd64 package is not available
7.3.1 - Prepare x86_64 OS to accept i386 deb package and i386 linux binary
$ sudo dpkg --add-architecture i386
## Check
$ dpkg --print-foreign-architectures
## Update apt and download necessary i386 packages
$ sudo apt update
$ sudo apt install gcc-8-base:i386 libc6:i386 libgcc1:i386 libidn2-0:i386 libunistring2:i386
7.3.2 - Download and install deb package “pfclient_4.1.1_i386.deb”
$ wget http://client.planefinder.net/pfclient_4.1.1_i386.deb
$ sudo dpkg -i pfclient_4.1.1_i386.deb
$ sudo systemctl status pfclient
7.3.3 - In your browser go to page localhost:30053 (or to IP:30053 from another computer)
If you dont have a sharing key: Add your email and other details
If you have sharing key, add it & latitude, longitude.
