FlightAware

From charlesreid1

Revision as of 05:22, 22 August 2017 by Admin (talk | contribs) (→‎Running)

Hardware

The FlightAware hardware consists of a standard RTL-SDR dongle, plus an optional noise filter (the cylinder on the right). The FlightAware USB stick plugs into the computer, and the other end connects to an antenna.

FlightAwareHardware1.jpg FlightAwareHardware2.jpg

Software/Installation

Scripts to execute the commands below can be downloaded here: https://git.charlesreid1.com/charlesreid1/flight-aware

Install software needed

Start by installing stuff that you need: 

apt-get install -y \
	libboost-all-dev \
	libusb-1.0 \
	libusb-dev \
	libusb-1.0-0-dev \
	devscripts \
	cmake \
	portaudio19-dev \
	iproute \
	python-virtualenv

apt-get install -y \
	tcl8.5-dev \
	tclx8.4-dev \
	itcl3-dev \
	tcl-tls \
	tcllib \
	tcl-tclreadline \

Install RTL-SDR

Next, install rtl-sdr package from osmocom. We will also need to disable the DVB driver, not using this for TV. 

export RTL_DIR="/root/codes/rtl-sdr"
git clone git://git.osmocom.org/rtl-sdr.git ${RTL_DIR}
cd ${RTL_DIR}
mkdir build
cd build
cmake ../
make
make install
cp ${RTL_SDR}/rtl-sdr.rules /etc/udev/rules.d/.
ldconfig

# disable DVB driver
mkdir -p /etc/modprobe.d/
cd /etc/modprobe.d/
echo "blacklist dvb_usb_rtl28xxu" >> /etc/modprobe.d/ban-rtl.conf

Before moving on to the next step, need to restart.

After restarting, plug the FlightAware device in.

Install dump1090-fa

Next, we need to install a program to dump out (and decode) information from the 1090 MHz band. There is a dump1090 program (generic), and there is a dump1090-fa program (specific to FlightAware). We will install dump1090-fa. At the conclusion of this step, you should be able to see your first flight information decoded from the receiver.

Start by checkout out a copy of the flightaware dump1090 repo: 

DUMP1090_PATH="/root/codes/dump1090"
git clone https://www.github.com/flightaware/dump1090 ${DUMP1090_PATH}
cd ${DUMP1090_PATH}

You DO NOT want to build this manually - that will cause dump1090 binaries to sit in that directory and they will not be found on your path. Furthermore, there will be no startup service, and the piaware program tries to invoke dump1090-fa via a startup service. (Also see: So, just build the .deb package. (If you see warnings about not being able to sign the package with a GPG key, that's okay, we're just building the package for ourselves.) 

./prepare-wheezy-tree.sh
cd package-wheezy/
dpkg-buildpackage -b

Now install the two packages created, in the specified order: 

cd ../
dpkg -i dump1090-fa_3.5.1~bpo9+1_amd64.deb
dpkg -i dump1090_3.5.1~bpo9+1_all.deb

This installs a binary called dump1090-fa, as well as installing a startup service called dump1090-fa. Running the command below should reveal a new startup service called dump1090-fa: 

$ service --status-all

Test dump1090-fa

Now we can test the dump1090-fa binary. First, make sure your FlightAware RTL-SDR dongle is plugged in. If you have problems with the commands below, you can also try restarting.

First, test the dump1090-fa utility (standalone, not as a startup service): 

dump1090-fa --interactive

Dump1090Interactive Screenshot.png

Install Piaware

Two steps:

  • Install tcllauncher for Piaware GUI
  • Install Piaware debian package

Start with tcllauncher: 

export FA_DIR="/root/codes/tcllauncher"
git clone https://github.com/flightaware/tcllauncher.git ${FA_DIR}
cd ${FA_DIR}
autoconf
./configure --with-tcl=/usr/lib/tcl8.5
make
make install

Next, install piaware: 

export PIAWARE_DIR="/root/codes/piaware_builder"
git clone https://github.com/flightaware/piaware_builder.git ${PIAWARE_DIR}
cd ${PIAWARE_DIR}
./sensible-build.sh wheezy
cd package-wheezy/
dpkg-buildpackage -b
cd ../
dpkg -i piaware_3.5.1~bpo9+1_amd64.deb
sudo update-rc.d piaware defaults

Set Piaware Configuration

Set flightaware credentials by editing /etc/piaware.conf: 

flightaware-user <username>
flightaware-password <password>
mlat-results no
wired-network yes

Running

Start Dump1090 Startup Service

Once you've run through each of the steps above, you can run piaware by first starting the dump1090-fa startup service, then starting the piaware startup service: 

$ service dump1090-fa start
$ service piaware start

When you run the command to check on the status of the piaware service, you should see a line that says "piaware received a message from dump1090-fa!" 

# systemctl status piaware

See #Troubleshooting section below for expected output.

Flight Stats Page

There are two FlightAware stats pages: the first one requires an internet connection, and has an up to 2 minute delay. The second runs locally, and shows stats on planes spotted locally by the FlightAware/PiAware device.


To find the first one, you'll need to sign up for a FlightAware account. Then use your username in the following URL: http://flightaware.com/adsb/stats/user/<username>. For example, here's my FlightAware stats page URL: http://flightaware.com/adsb/stats/user/charlesreid1

The second page, the local stats page, can be found at port 8080 on the machine running the FlightAware software. From the machine running the FlightAware software, visit localhost:8080; from another machine on the same local network, visit 192.168.X.Y:8080 (or whatever the IP address of the machine running FlightAware is).

Troubleshooting

Checking Status: Method 1

To check on the status of piaware, and assuming it was installed using the piaware_builder repository (i.e., that you built a debian package and installed it using dpkg), which also creates a startup service, you can use systemctl to check on the status of the startup service:

Output:

SystemctlStatusPiawareSuccess.png 

# systemctl status piaware

● piaware.service - FlightAware ADS-B uploader
   Loaded: loaded (/etc/systemd/system/piaware.service; disabled; vendor preset: disabled)
   Active: active (running) since Fri 2017-08-18 04:22:31 PDT; 10h ago
     Docs: https://flightaware.com/adsb/piaware/
 Main PID: 2831 (piaware)
    Tasks: 2 (limit: 4915)
   CGroup: /system.slice/piaware.service
           └─2831 /usr/bin/piaware -p /run/piaware/piaware.pid -plainlog -statusfile /run/piaware/status.json

Aug 18 15:12:34 WindowsXP sudo[3810]:  piaware : TTY=unknown ; PWD=/ ; USER=root ; COMMAND=/bin/netstat --program --tcp --wide --all --
Aug 18 15:12:34 WindowsXP sudo[3810]: pam_unix(sudo:session): session opened for user root by (uid=0)
Aug 18 15:12:34 WindowsXP sudo[3810]: pam_unix(sudo:session): session closed for user root
Aug 18 15:12:34 WindowsXP piaware[2831]: no ADS-B data program seen listening on port 30005 for 370 seconds, trying to start it...
Aug 18 15:12:34 WindowsXP piaware[2831]: attempting to start dump1090..
Aug 18 15:12:34 WindowsXP piaware[2831]: can't start dump1090, no services that look like dump1090 found
Aug 18 15:12:44 WindowsXP sudo[3813]:  piaware : TTY=unknown ; PWD=/ ; USER=root ; COMMAND=/bin/netstat --program --tcp --wide --all --
Aug 18 15:12:44 WindowsXP sudo[3813]: pam_unix(sudo:session): session opened for user root by (uid=0)
Aug 18 15:12:44 WindowsXP sudo[3813]: pam_unix(sudo:session): session closed for user root
Aug 18 15:12:44 WindowsXP piaware[2831]: no ADS-B data program seen listening on port 30005 for 10 seconds, next check in 60s

Checking Status: Method 2

To check the status of piaware, you can also use the status.json file: 

# cat /run/piaware/status.json

If everything is okay, you will see something like this: 

{
    "piaware"  : {
        "status"  : "green",
        "message" : "PiAware 3.5.1 is running"
    },
    "expiry"   : 1503098467731,
    "interval" : 5000,
    "mlat"     : {
        "status"  : "red",
        "message" : "Multilateration is not enabled"
    },
    "adept"    : {
        "status"  : "green",
        "message" : "Connected to FlightAware and logged in"
    },
    "radio"    : {
        "status"  : "green",
        "message" : "Received Mode S data recently"
    },
    "time"     : 1503098456731
}

If something is wrong with the hardware and/or the communication with dump1090-fa, you will see something like this: 

{
    "piaware"  : {
        "status"  : "green",
        "message" : "PiAware 3.5.1 is running"
    },
    "expiry"   : 1503094220448,
    "interval" : 5000,
    "mlat"     : {
        "status"  : "red",
        "message" : "Multilateration is not enabled"
    },
    "adept"    : {
        "status"  : "green",
        "message" : "Connected to FlightAware and logged in"
    },
    "radio"    : {
        "status"  : "red",
        "message" : "Not connected to receiver"
    },
    "time"     : 1503094209448
}

Links

Multilateration (MLAT) overview: https://flightaware.com/adsb/mlat/

PiAware if you already have dump1090: http://flightaware.com/adsb/piaware/install

PiAware building base station: http://flightaware.com/adsb/piaware/build

PiAware repo: https://github.com/flightaware/piaware

PiAware builder repo: https://github.com/flightaware/piaware_builder

PiAware repo wiki - release notes: https://github.com/flightaware/piaware/wiki/PiAware-Release-Notes

  • "Piaware will now attempt to start dump1090 if no ADS-B producer program is seen listening for connections on port 30005 (the "Beast" binary data port) for more than six minutes."

Dump1090 repo: https://github.com/flightaware/dump1090

FlightAware stats: https://flightaware.com/adsb/stats/user/charlesreid1

Flags

Retrieved from "https://charlesreid1.com/w/index.php?title=FlightAware&oldid=20735"