The "dump1090-mutability_1.15~dev" is development version of dump1090-mutability, and has many additional functionality. It is preferred & installed by lot of users. However there is no .deb package available for installation, and one has to built it from the source code.
The dump1090-mutability_1.15~dev is NOT compatible with Pi24 img and Piaware img
TO HAVE A TROUBLE FREE INSTALLATION, IT IS REQUIRED TO MAKE A FRESH INSTALL, AS SHOWN BELOW:
(a) Format microSD Card
(b) Write Raspbian Image.
(c) Install dump1090-mutability.
(d) Install data feeders.
It is important that first dump1090-mutability is installed, and data feeders are installed after dump1090-mutability has been installed.
Below is a step-by-step method to built & install dump1090-mutability_1.15~dev from source code.
STEP (1): UPDATE THE OPERATING SYSTEM
Code:sudo apt-get update
STEP (2): INSTALL PRE REQUISIT PACKAGES (needed to build, and needed to fulfill dependencies)
Code:sudo apt-get install -y git sudo apt-get install -y build-essential sudo apt-get install -y debhelper sudo apt-get install -y rtl-sdr sudo apt-get install -y librtlsdr-dev sudo apt-get install -y libusb-1.0-0-dev sudo apt-get install -y pkg-config sudo apt-get install -y fakeroot sudo apt-get install -y curl sudo apt-get install -y cron sudo apt-get install -y lighttpd
STEP (3): DOWNLOAD / CLONE THE SOURCE FILES TO YOUR RPi
Code:cd ~/ sudo mkdir install-dump cd install-dump sudo git clone https://github.com/mutability/dump1090.git
STEP (4): BUILD THE DUMP1090-MUTABILITY PACKAGE
Note: This is a lengthy process, and seems to freez at several occasions. Please be patient, and let the process take it's time to finish.
Code:cd ~/install-dump/dump1090 sudo dpkg-buildpackage -b
STEP (5): INSTALL THE DUMP1090-MUTABILITY PACKAGE
Code:cd ~/install-dump sudo dpkg -i dump1090-mutability_1.15~dev_*.deb
STEP (6): CONFIGURE THE WEB SERVER
Code:sudo lighty-enable-mod dump1090 sudo /etc/init.d/lighttpd force-reload
STEP (7): DUMP1090-MUTABILITY POST INSTALLATION CONFIGURATION
For most settings, accept default settings by pressing "Enter".Code:sudo dpkg-reconfigure dump1090-mutability
For following settings, enter values as shown:
(a) RTL-SDR dongle to use: 0
(b) Your receiver's Latitude (in decimal format): xx.xxxx
(c) Your receiver's Longitude (in decimal format): yy.yyyy
(d) Interface address to bind to (blank for all interfaces): remove default 127.0.0.1 and leave blank.
For advance users:Alternatively, you can change the settings by editing the configuration file shown below:
Code:sudo nano /etc/default/dump1090-mutability #after making changes, save file (Ctrl+o) and exit (Ctrl+x) #restart dump1090-mutability sudo /etc/init.d/dump1090-mutability restart #alternative command to restart dump1090-mutability sudo service dump1090-mutability restart
STEP (8): ADD TERRAIN LIMIT RINGS
Dump1090-mutability v1.15~dev can display terrain limit rings using data obtained from the website http://www.heywhatsthat.com.
(a) First you have to generate a panorama for your location. To do this, follow the steps in first post of the following thread:
What is the Maximum Range I can Get?
(b) Once your panorama is generated, look near the top left of your newly created panorama page. You will see URL of your panorama there. The URL will be http://www.heywhatsthat.com/?view=XXXXXXXX where XXXXXXXX is the ID for your panorama.
See screenshot below.
(c) Use following command to download the generated panorama's JSON file "upintheair.json" to your RPi, and save it in the folder "/usr/share/dump1090-mutability/html" (replace XXXXXXXX in the command below by your panorama's ID).
You can create as many rings as you want by adding elevations (in meters) at the end of URL given in the wget command above after "&alts=", separated by commas.Code:sudo wget -O /usr/share/dump1090-mutability/html/upintheair.json "http://www.heywhatsthat.com/api/upintheair.json?id=XXXXXXXX&refraction=0.25&alts=3048,12192"
10,000 ft = 3048 m
20,000 ft = 6096 m
25,000 ft = 7620 m
30,000 ft = 9144 m
40,000 ft = 12192 m
Hence if you want to add all the 5 elevation rings noted above, the string at the end of wget URL will become "&alts=3048,6096,7620,9144,12192"
To keep map un-cluttered, I have used only 2 rings in the wget command above. i.e. the 10,000 feet (3048 meters), and 40,000 feet (12192 meters).
Use altitude in meters in the wget URL above.
Do NOT use feet.
(d) RESTART dump1090-mutability
STEP (9) VIEW MAPCode:sudo /etc/init.d/dump1090-mutability restart
To view map, type following address in your browser:
http://<ip address of your RPi on your LAN>/dump1090/gmap.html
STEP (10): ADDITIONAL RANGE CIRCLES
By default, range circles are provided at 100, 150, and 200 nm.
To add Range Circles, edit file config.js of html folder
(a) By default, there are 3 circles at 100, 150, and 200 nm/km. to add more circles at 250 & 300 nm/km, add these numbers in config.js file as shown belowCode:cd ~ cd /usr/share/dump1090-mutability/html sudo nano config.js
Press ctrl+w, then type SiteCirclesDistances and press Enter key. The cursor will jump to SiteCirclesDistances. Add additional distances as shown in red.
SiteCirclesDistances = new Array(100,150,200,250,300);
(b) Range Circle default unit is nm (metric=false). To change to km, change "metric=false" to "metric=true"
Press ctrl+w, type Metric = false , then press Enter key. The cursor will jump to Metric = false; change false to true as shown in red.
Metric = true;
STEP (11): INSTALLATION OF FR24 DATA FEEDER:
Install FR24 feeder from instructions on this page: https://www.flightradar24.com/raspberry-pi using command
During above command, it will present a signup wizard, asking for email, sharing key, latitude, longitude, antenna height etc.Code:sudo bash -c "$(wget -O - http://repo.feed.flightradar24.com/install_fr24_rpi.sh)"
After sign-in details, it will ask choice for receiver configuration. ENTER VALUES SHOWN IN RED BELOW
Step 4.1 - Receiver selection:
1 - DVBT Stick (USB)
2 - SBS1/SBS1er (USB/Network)
3 - SBS3 (USB/Network)
4 - ModeS Beast (USB/Network)
5 - AVR Compatible (DVBT over network, etc)
6 - microADSB (USB/Network)
7 - SBSx via Basestation (localhost:30006)
Enter your receiver type (1-7)$: 4
Step 4.2 - Please select connection type:
1 - Network connection
2 - USB directly to this computer
Enter your connection type (1-2)$: 1
Step 4.3A - Please enter your receiver's IP address/hostname
Step 4.3B - Please enter your receiver's data port number
Step 5.1 - Would you like to enable RAW data feed on port 30002 (yes/no)$:no
Step 5.2 - Would you like to enable Basestation data feed on port 30003 (yes/no)$:no
Step 6A - Please select desired logfile mode:
0 - Disabled
1 - 48 hour, 24h rotation
2 - 72 hour, 24h rotation
Select logfile mode (0-2)$:0
Step 6B - Please enter desired logfile path (/var/log):
Post Install configuration/Re-configuration of FR24 feeder
The FR24 Feeder can be configured on the page http://<IP of RPi>:8754/settings.html. The "Receiver" and "Host/IP" setting should be either "ModeS Beast(TCP), 127.0.0.1:30005" or "AVR(TCP), 127.0.0.1:30002" as shown in screenshots below.
Fr24feeder settings Beast(TCP) dump1090 mutability.png . Fr24feeder Settings AVR(TCP) External dump1090.png
Re-configuration can also be done through SSH
.Code:~ $ sudo fr24feed --reconfigure #after reconfiguration ~$ sudo service fr24feed restart
STEP (12): INSTALLATION OF FLIGHTAWARE DATA FEEDER:
Install Flightaware feeder from instructions on this page (STEP 2 ONLY): http://flightaware.com/adsb/piaware/install
STEP (13): INSTALLATION OF PLANEFINDER DATA FEEDER:
Install Planefinder feeder from instructions on this page: