FlightAware Discussions

Dump978 Add-On Installation Procedures?

Could someone point me to dump978 install procedures? I got a Realtek 2838 a few weeks ago and would like to install dump978 and PiAware to an existing Pi3 (stretch) and see what it’ll pick up. I have PiAware installed but haven’t run across recent add-on instructions for dump978. This pi3 won’t be picking up 1090 traffic since I have another one dedicated for that.

1 Like

This isn’t supported yet.

You’ll have to either wait for the release or use the pre-release sd-card image.

Otherwise you need to compile and install the dev branches of these two github repositories:
https://github.com/flightaware/piaware_builder
https://github.com/flightaware/dump978

1 Like

PROCEDURE HERE

https://discussions.flightaware.com/t/version-3-7-0-of-dump1090-fa-piaware/47874/51

NOTE:
In Step 3.2, instead of
git checkout v3.7.0

Use:
git checkout v3.7.0.1

Updated version 3.7.0 released 2 hrs ago
.

SEE RESULT HERE
https://flightaware.com/adsb/stats/user/abcd567#stats-6396

.

.

.
.

Just wait a couple of hours or maybe till Monday and you’ll probably get the released version :wink:

… of Piaware microSD card image :slight_smile:

For my RPi, the image will be useful, but it wont work with my OrangePi, on which I have Armbian (stretch) and built & installed add-on packages.

If add-on packages are also released, then it will make installation on OrangePi easy.

For Debian 9.9 in VM on x64 Windows, I will have to build the packages.

1 Like

What are the changes to the newest version?

See https://github.com/flightaware/dump1090/commit/4061477 for a quick look.

1 Like

Is it possible to to upgrade without re-imaging my SD Card?

No idea, never tried.

I always do a fresh install (write latest image to microSD card), whenever a new version is released. This is the cleanest and headache-free method.

1 Like

As soon as the new version is in the repository an update should be no problem.

sudo apt update
sudo apt dist-upgrade
2 Likes

I built and installed packages as readme says.

First, readme says about

--sdr-device driver=rtlsdr,serial=01234567

while actual file /etc/default/dump978-fa has it like this

--sdr driver=rtlsdr,serial=00000978 --format CS8

so, is --sdr or --sdr-device are correct? In the logs I get this:

May 03 21:53:41 raspberrypi dump978-fa[5698]: json-port: listening for connections on 0.0.0.0:30979
May 03 21:53:41 raspberrypi dump978-fa[5698]: json-port: listening for connections on [::]:30979
May 03 21:53:41 raspberrypi dump978-fa[5698]: Found Rafael Micro R820T tuner
May 03 21:53:41 raspberrypi dump978-fa[5698]: usb_claim_interface error -6
May 03 21:53:41 raspberrypi dump978-fa[5698]: Found Rafael Micro R820T tuner
May 03 21:53:42 raspberrypi dump978-fa[5698]: Exact sample rate is: 2083333.135571 Hz
May 03 21:53:42 raspberrypi dump978-fa[5698]: [R82XX] PLL not locked!
May 03 21:53:42 raspberrypi dump978-fa[5698]: SoapySDR: using maximum manual gain 49.6 dB
May 03 21:53:42 raspberrypi dump978-fa[5698]: SoapySDR: using stream setting buffsize=262144
May 03 21:53:56 raspberrypi dump978-fa[5698]: [::]:30978: accepted a connection from [::1]:34786

Please note usb_claim_interface error -6

my setup is:

rtl_test
Found 2 device(s):
0: Realtek, RTL2838UHIDIR, SN: 00000978
1: Realtek, RTL2832U, SN: 00001090

This is correct:
RECEIVER_OPTIONS="--sdr driver=rtlsdr,serial=00000978 --sdr-gain 49 --format CS8"

1 Like

The version has changed, so the syntax could have changed as well.

@varnav Check the help for syntax:
dump978-fa --help

that is not a fail.

It tries all rtl-sdr devices until it finds the correct serial number.

Hm, but rtl_test can tell correct serial without any interface claims, even if devices are busy.

Version 3.7.1 Add-on Package Install

1 - Serialized Dongles (Click here)

After serialuization, tested

rtl_test -t
Found 2 device(s):
  0:  Realtek, RTL2832UFA, SN: 00000978
  1:  Realtek, RTL2838UHIDIR, SN: 00001090

2 - Installed dump978-fa AND skyview978 ver 3.7.1

sudo apt update
sudo apt install -y git lighttpd 
sudo apt install -y build-essential debhelper dh-systemd
sudo apt install -y libboost-system-dev libboost-program-options-dev libboost-regex-dev
sudo apt install -y libboost-filesystem-dev libsoapysdr-dev soapysdr-module-rtlsdr

git clone https://github.com/flightaware/dump978.git
cd dump978
git checkout v3.7.1
Note: checking out 'v3.7.1'.
HEAD is now at ff80def... Release v3.7.1

sudo dpkg-buildpackage -b

cd ../
sudo dpkg -i dump978-fa_3.7.1_armhf.deb 
sudo dpkg -i skyview978_3.7.1_armhf.deb

.

Added Serial Number to file /etc/default/dump978-fa

sudo nano /etc/default/dump978-fa

.
added
,serial=00000978
after
driver=rtlsdr
.

ENABLED=yes

RECEIVER_OPTIONS="--sdr driver=rtlsdr,serial=00000978 --format CS8"
DECODER_OPTIONS=""
NET_OPTIONS="--raw-port 30978 --json-port 30979"

.
REBOOTED PI

pi@raspberrypi:~ $ sudo reboot

.

Checked

pi@raspberrypi:~ $ sudo systemctl status dump978-fa

● dump978-fa.service - dump978 ADS-B UAT receiver
   Loaded: loaded (/lib/systemd/system/dump978-fa.service; enabled; vendor preset: enabled)
   Active: active (running) since Sat 2019-05-04 02:31:04 EDT; 5s ago
● dump978-fa.service - dump978 ADS-B UAT receiver
   Loaded: loaded (/lib/systemd/system/dump978-fa.service; enabled; vendor preset: enabled)
   Active: active (running) since Sat 2019-05-04 02:31:04 EDT; 21s ago
     Docs: https://flightaware.com/adsb/piaware/
 Main PID: 899 (dump978-fa)
   CGroup: /system.slice/dump978-fa.service
           └─899 /usr/bin/dump978-fa --sdr driver=rtlsdr,serial=00000978 --format CS8 --raw-port 30978 --json-port 30979

May 04 02:31:05 raspberrypi dump978-fa[899]: Reattached kernel driver
May 04 02:31:05 raspberrypi dump978-fa[899]: Detached kernel driver
May 04 02:31:05 raspberrypi dump978-fa[899]: Found Rafael Micro R820T tuner
May 04 02:31:06 raspberrypi dump978-fa[899]: Reattached kernel driver
May 04 02:31:06 raspberrypi dump978-fa[899]: Detached kernel driver
May 04 02:31:06 raspberrypi dump978-fa[899]: Found Rafael Micro R820T tuner
May 04 02:31:07 raspberrypi dump978-fa[899]: Exact sample rate is: 2083333.135571 Hz
May 04 02:31:07 raspberrypi dump978-fa[899]: [R82XX] PLL not locked!
May 04 02:31:07 raspberrypi dump978-fa[899]: SoapySDR: using maximum manual gain 49.6 dB
May 04 02:31:07 raspberrypi dump978-fa[899]: SoapySDR: using stream setting buffsize=262144

.
Checked Map in Browser at following address
IP-of-PI/skyview978/

3 - INSTALLED DUMP1090-FA ver 3.7.1

sudo apt install -y debhelper dh-systemd librtlsdr-dev libusb-1.0-0-dev 
sudo apt install -y git pkg-config libncurses5-dev lighttpd libbladerf-dev  

git clone https://github.com/flightaware/dump1090.git dump1090-fa
cd dump1090-fa 
git checkout v3.7.1

#Note: checking out 'v3.7.1'.
#.....
#HEAD is now at 4061477... Release v3.7.1

sudo dpkg-buildpackage -b   

cd ../
sudo dpkg -i dump1090-fa_3.7.1_armhf.deb

.

Serial Number

sudo nano /etc/default/dump1090-fa

changed
--device-index 0
to
--device-index 00001090

.

ENABLED=yes

RECEIVER_OPTIONS="--device-index 00001090 --gain 42 --ppm 0 --net-bo-port 30005"
DECODER_OPTIONS="--max-range 360"
NET_OPTIONS="--net --net-heartbeat 60 --net-ro-size 1000 --net-ro-interval 1 --net-ri-port 0 --net-ro-port 30002 --net-sbs-port 30003 --ne$
JSON_OPTIONS="--json-location-accuracy 1"

.

Restarted

pi@raspberrypi:~ $ sudo systemctl restart dump978-fa

Checked

pi@raspberrypi:~ $ sudo systemctl status dump1090-fa

● dump1090-fa.service - dump1090 ADS-B receiver (FlightAware customization)
   Loaded: loaded (/lib/systemd/system/dump1090-fa.service; enabled; vendor preset: enabled)
   Active: active (running) since Sat 2019-05-04 04:14:05 EDT; 31min ago
     Docs: https://flightaware.com/adsb/piaware/
 Main PID: 425 (dump1090-fa)
   CGroup: /system.slice/dump1090-fa.service
           └─425 /usr/bin/dump1090-fa --device-index 00001090 --gain 42 --ppm 0 --net-bo-port 30005 --max-range 360 --net --net-heartbeat

May 04 04:14:05 raspberrypi systemd[1]: Started dump1090 ADS-B receiver (FlightAware customization).
May 04 04:14:05 raspberrypi dump1090-fa[425]: Sat May  4 04:14:05 2019 EDT  dump1090-fa 3.7.1 starting up.
May 04 04:14:05 raspberrypi dump1090-fa[425]: rtlsdr: using device #1: Generic RTL2832U OEM (Realtek, RTL2838UHIDIR, SN 00001090)
May 04 04:14:06 raspberrypi dump1090-fa[425]: Detached kernel driver
May 04 04:14:06 raspberrypi dump1090-fa[425]: Found Rafael Micro R820T tuner
May 04 04:14:06 raspberrypi dump1090-fa[425]: rtlsdr: tuner gain set to 42.1 dB

.

4 - INSTALLED PIAWARE ver 3.7.1

sudo apt install -y git devscripts build-essential debhelper  
sudo apt install -y tcl8.6-dev autoconf python3-dev python3-venv  
sudo apt install -y virtualenv dh-systemd zlib1g-dev tclx8.4  
sudo apt install -y tcllib tcl-tls itcl3 net-tools 
sudo apt install -y libboost-system-dev libboost-program-options-dev 
sudo apt install -y libboost-regex-dev libboost-filesystem-dev
git clone https://github.com/flightaware/piaware_builder.git  
cd  piaware_builder  

git checkout v3.7.1 

#Note: checking out 'v3.7.1'.
#........
#HEAD is now at 908fdef... Release v3.7.1

CODENAME=(`lsb_release -sc`)  
echo ${CODENAME}  
# above command outputs distro's codename 
#("stretch" in this case)
./sensible-build.sh ${CODENAME}  

cd  package-${CODENAME}  
sudo dpkg-buildpackage -b  

cd ../
sudo dpkg -i piaware_3.7.1_armhf.deb   

Configured Piaware
(used actual feeder-id in place of xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx )

sudo piaware-config feeder-id xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx 
sudo piaware-config allow-auto-updates yes 
sudo piaware-config allow-manual-updates yes 

sudo systemctl restart piaware  

.

Enabled UAT in piaware-config by setting uat-receiver-type sdr

sudo piaware-config uat-receiver-type sdr  
sudo systemctl restart piaware

CHECKED

pi@raspberrypi:~ $ sudo systemctl status piaware
● piaware.service - FlightAware ADS-B uploader
   Loaded: loaded (/lib/systemd/system/piaware.service; enabled; vendor preset: enabled)
   Active: active (running) since Sat 2019-05-04 04:22:18 EDT; 25min ago
     Docs: https://flightaware.com/adsb/piaware/
 Main PID: 1008 (piaware)
   CGroup: /system.slice/piaware.service
           ├─1008 /usr/bin/piaware -p /run/piaware/piaware.pid -plainlog -statusfile /run/piaware/status.json
           ├─1036 /usr/lib/piaware/helpers/fa-mlat-client --input-connect localhost:30005 --input-type dump1090 --results beast,connect,l
           ├─1045 /usr/lib/piaware/helpers/faup1090 --net-bo-ipaddr localhost --net-bo-port 30005 --stdout --lat 43.xxx --lon -79.xxx
           └─1054 /usr/lib/piaware/helpers/faup978 --connect localhost:30978

May 04 04:32:54 raspberrypi piaware[1008]: 1 msgs recv'd from dump978-fa (0 in last 5m); 1 msgs sent to FlightAware
May 04 04:37:23 raspberrypi piaware[1008]: mlat-client(1036): Receiver status: connected
May 04 04:37:23 raspberrypi piaware[1008]: mlat-client(1036): Server status:   synchronized with 64 nearby receivers
May 04 04:37:23 raspberrypi piaware[1008]: mlat-client(1036): Receiver:   40.7 msg/s received       18.3 msg/s processed (45%)
May 04 04:37:23 raspberrypi piaware[1008]: mlat-client(1036): Server:      0.0 kB/s from server    0.0kB/s TCP to server     0.2kB/s UDP
May 04 04:37:23 raspberrypi piaware[1008]: mlat-client(1036): Aircraft: 6 of 7 Mode S, 5 of 5 ADS-B used
May 04 04:37:54 raspberrypi piaware[1008]: 500 msgs recv'd from dump1090-fa (174 in last 5m); 500 msgs sent to FlightAware
May 04 04:37:54 raspberrypi piaware[1008]: 1 msgs recv'd from dump978-fa (0 in last 5m); 1 msgs sent to FlightAware
May 04 04:42:54 raspberrypi piaware[1008]: 635 msgs recv'd from dump1090-fa (135 in last 5m); 635 msgs sent to FlightAware
May 04 04:42:54 raspberrypi piaware[1008]: 1 msgs recv'd from dump978-fa (0 in last 5m); 1 msgs sent to FlightAware

.
.

Yeah soapy-sdr is programmed strangely.
But if you would continue reading the log it’s announcing the gain used and accepting a connection.
If it were a real error you would see the program exiting.

1 Like

Version 3.7.1 Add-on Package Install - Station #5252

.

pi@raspberrypi:~ $ sudo systemctl status dump978-fa 

● dump978-fa.service - dump978 ADS-B UAT receiver
   Loaded: loaded (/lib/systemd/system/dump978-fa.service; enabled; vendor preset: enabled)
   Active: active (running) since Sat 2019-05-04 10:33:36 EDT; 1h 56min ago
     Docs: https://flightaware.com/adsb/piaware/
 Main PID: 22369 (dump978-fa)
   CGroup: /system.slice/dump978-fa.service
           └─22369 /usr/bin/dump978-fa --sdr driver=rtlsdr,serial=00000978 --format CS8 --raw-port 30978 --json-port 30979

May 04 10:33:36 raspberrypi dump978-fa[22369]: linux; GNU C++ version 6.2.0 20161010; Boost_106100; UHD_003.009.005-0-unknown
May 04 10:33:36 raspberrypi dump978-fa[22369]: Found Rafael Micro R820T tuner
May 04 10:33:36 raspberrypi dump978-fa[22369]: usb_claim_interface error -6
May 04 10:33:37 raspberrypi dump978-fa[22369]: Found Rafael Micro R820T tuner
May 04 10:33:37 raspberrypi dump978-fa[22369]: Exact sample rate is: 2083333.135571 Hz
May 04 10:33:37 raspberrypi dump978-fa[22369]: [R82XX] PLL not locked!
May 04 10:33:37 raspberrypi dump978-fa[22369]: SoapySDR: using maximum manual gain 49.6 dB
May 04 10:33:37 raspberrypi dump978-fa[22369]: SoapySDR: using stream setting buffsize=262144
May 04 10:33:46 raspberrypi dump978-fa[22369]: [::]:30978: accepted a connection from [::1]:43508
May 04 10:34:06 raspberrypi dump978-fa[22369]: [::]:30978: accepted a connection from [::1]:43516

.
.

pi@raspberrypi:~ $ sudo systemctl status dump1090-fa 

● dump1090-fa.service - dump1090 ADS-B receiver (FlightAware customization)
   Loaded: loaded (/lib/systemd/system/dump1090-fa.service; enabled; vendor preset: enabled)
   Active: active (running) since Sat 2019-05-04 05:43:27 EDT; 6h ago
     Docs: https://flightaware.com/adsb/piaware/
 Main PID: 479 (dump1090-fa)
   CGroup: /system.slice/dump1090-fa.service
           └─479 /usr/bin/dump1090-fa --device-index 00001090 --gain 42 --ppm 0 --net-bo-port 30005 --max-range 360 --net --net-heartbeat

May 04 05:43:27 raspberrypi systemd[1]: Started dump1090 ADS-B receiver (FlightAware customization).
May 04 05:43:28 raspberrypi dump1090-fa[479]: Sat May  4 05:43:28 2019 EDT  dump1090-fa 3.7.1 starting up.
May 04 05:43:28 raspberrypi dump1090-fa[479]: rtlsdr: using device #1: Generic RTL2832U OEM (Realtek, RTL2838UHIDIR, SN 00001090)
May 04 05:43:29 raspberrypi dump1090-fa[479]: Found Rafael Micro R820T tuner
May 04 05:43:29 raspberrypi dump1090-fa[479]: rtlsdr: tuner gain set to 42.1 dB 

.
.

pi@raspberrypi:~ $ sudo systemctl status piaware
● piaware.service - FlightAware ADS-B uploader
   Loaded: loaded (/lib/systemd/system/piaware.service; enabled; vendor preset: enabled)
   Active: active (running) since Sat 2019-05-04 05:43:27 EDT; 6h ago
     Docs: https://flightaware.com/adsb/piaware/
 Main PID: 481 (piaware)
   CGroup: /system.slice/piaware.service
           ├─  481 /usr/bin/piaware -p /run/piaware/piaware.pid -plainlog -statusfile /run/piaware/status.json
           ├─ 1007 /usr/lib/piaware/helpers/faup1090 --net-bo-ipaddr localhost --net-bo-port 30005 --stdout --lat 43.xxx --lon -79.xxx
           ├─ 1028 /usr/lib/piaware/helpers/fa-mlat-client --input-connect localhost:30005 --input-type dump1090 --results beast,connect,l
           └─22390 /usr/lib/piaware/helpers/faup978 --connect localhost:30978

May 04 12:24:04 raspberrypi piaware[481]: 59804 msgs recv'd from dump1090-fa (763 in last 5m); 59804 msgs sent to FlightAware
May 04 12:24:04 raspberrypi piaware[481]: 9 msgs recv'd from dump978-fa (0 in last 5m); 9 msgs sent to FlightAware
May 04 12:28:55 raspberrypi piaware[481]: mlat-client(1028): Receiver status: connected
May 04 12:28:55 raspberrypi piaware[481]: mlat-client(1028): Server status:   synchronized with 124 nearby receivers
May 04 12:28:55 raspberrypi piaware[481]: mlat-client(1028): Receiver:  156.3 msg/s received       51.6 msg/s processed (33%)
May 04 12:28:55 raspberrypi piaware[481]: mlat-client(1028): Server:      0.1 kB/s from server    0.0kB/s TCP to server     0.6kB/s UDP to
May 04 12:28:55 raspberrypi piaware[481]: mlat-client(1028): Results:  47.9 positions/minute
May 04 12:28:55 raspberrypi piaware[481]: mlat-client(1028): Aircraft: 6 of 18 Mode S, 16 of 16 ADS-B used
May 04 12:29:04 raspberrypi piaware[481]: 60451 msgs recv'd from dump1090-fa (647 in last 5m); 60451 msgs sent to FlightAware
May 04 12:29:04 raspberrypi piaware[481]: 9 msgs recv'd from dump978-fa (0 in last 5m); 9 msgs sent to FlightAware

Thanks for all of the insight. I followed abcd567’s procedures and got dump978 installed and the dongle serialized. FA is recognizing the site, but PiAware status check gives this line at the end:
May 04 13:05:58 Pi3Ofc piaware[10519]: no ADS-B data program seen listening on port 30005 for 303 seconds, next check in 60s

May 04 13:06:29 Pi3Ofc piaware[10519]: 0 msgs recv’d from dump1090 (0 in last 5m); 0 msgs sent to FlightAware

I don’t see any data on the Skyview page and dump978 is running. Is this an easy fix?