How to Install dump1090-mutability on RPi

abcd567 replied

2016-07-27, 13:35

@Sam26K
Piaware feeds MLAT data to port 30104.
Check settings of dump1090 mutability. By default it has setting of "Ports for Beast-format input connections" as 30004,30104.

Use command below to check, and add 30104 if not already there:

Code:

sudo dpkg-reconfigure dump1090-mutability

Reboot for new setting to take effect. Reload/refresh the gmap page.

Also configure your Piaware data feeder to feed MLAT input to port 30104, and to make port 30106 available for feeding MLAT to VRS in case you want to display piawre's MLAT planes on VRS. This is done using port 30106 (ext_basestation,listen,30106)

Code:

#Configuration command
~ $ sudo piaware-config -mlatResultsFormat "beast,connect,localhost:30104  ext_basestation,listen,30106"

#Check if configuration has actually taken place
~ $ sudo piaware-config -show

#Above command will show contents of piaware config file '/root/.piaware' as follows:
mlatResultsFormat {beast,connect,localhost:30104  ext_basestation,listen,30106}
password xxxxxxxx
user xxxxxxxx

#Now restart piaware so that new configuration starts operating
~ $ sudo piaware-config -restart

#Above command will give following output:
invoking: /etc/init.d/piaware restart
[ ok ] Restarting piaware (via systemctl): piaware.service.

#Now reboot RPi
~ $ sudo reboot

Last edited by abcd567; 2016-07-27, 17:17.

Leave a comment:

p0werslave replied

2016-07-24, 11:47
Excellent tutorial - i think the terrain limit rings and funky coloured planes are justification alone to install this.

Backup / Image your current SD Card first using something like Apple Pi-Baker.

Many Thanks
Leave a comment:
abcd567 replied

2016-07-16, 19:30
How-to Add "Received Signal Strength Indicator" (RSSI) Column in Aircraft Table of dump1090-mutability ver 1.15~dev

Posted on: October 14, 2018

A glance on RSSI Colums will show what are strengths of signals from different planes.
This will help in determining if Gain Setting of dongle is to be lowered or increased.

Contributors:
@evangelyul
@wiedehopf
@abcd567

STEP-1

Code:

#Move into folder containing file to be edited cd /usr/share/dump1090-mutability/html/ #First make a backup copy before attempting modifications #The backup will enable you to revert if something goes wrong sudo cp gmap.html gmap.html.bak #Now edit the file and make modifications sudo nano gmap.html

Press Ctrl+w keys, type onclick="sortBy then Press Enter key.
The cursor will jump to relevant block of code.
ADD 2 lines shown below in RED (copy-paste these)

<thead style="background-color: #BBBBBB; cursor: pointer;">
<tr>
<td id="icao" onclick="sortByICAO();">ICAO</td>
<td id="flag" onclick="sortByCountry()"></t$
<td id="flight" onclick="sortByFlight();">Flight</td>
<td id="squawk" onclick="sortBySquawk();" style="text-align: right">Squaw$
<td id="altitude" onclick="sortByAltitude();" style="text-align: right">A$
<td id="speed" onclick="sortBySpeed();" style="text-align: right">Speed</$
<td id="distance" onclick="sortByDistance();" style="text-align: right">D$
<td id="track" onclick="sortByTrack();" style="text-align: right">Track</$
<td id="msgs" onclick="sortByMsgs();" style="text-align: right">Msgs</td>
<td id="seen" onclick="sortBySeen();" style="text-align: right">Age</td>
<td id="rssi" onclick="sortByRSSI();" style="text-align: right">RSSI</td>

</tr>
</thead>
<tbody>
<tr id="plane_row_template" class="plane_table_row hidden">
<td>ICAO</td>
<td><img style="width: 20px; height=12px" src="about:blank" alt="Flag"></$
<td>FLIGHT</td>
<td style="text-align: right">SQUAWK</td>
<td style="text-align: right">ALTITUDE</td>
<td style="text-align: right">SPEED</td>
<td style="text-align: right">DISTANCE</td>
<td style="text-align: right">TRACK</td>
<td style="text-align: right">MSGS</td>
<td style="text-align: right">SEEN</td>
<td style="text-align: right">RSSI</td>
</tr>
</tbody>

STEP-2

2.1 - Prepration

Code:

#Move into folder containing file to be edited cd /usr/share/dump1090-mutability/html/ #First make a backup copy before attempting modifications #The backup will enable you to revert if something goes wrong sudo cp script.js script.js.bak #Now edit the file and make modifications sudo nano script.js

2.2 - Add RSSI Column
Press Ctrl+W keys, type tableplane.tr.cells then press Enter Key
The cursor will jump to relevant block of code.
ADD line shown in RED (copy-paste it)

// ICAO doesn't change
tableplane.tr.cells[2].textContent = (tableplane.flight !== null ? tableplane.flight : "");
tableplane.tr.cells[3].textContent = (tableplane.squawk !== null ? tableplane.squawk : "");
tableplane.tr.cells[4].textContent = format_altitude_brief(tableplane.altitude, tableplane.vert_rate);
tableplane.tr.cells[5].textContent = format_speed_brief(tableplane.speed);
tableplane.tr.cells[6].textContent = format_distance_brief(tableplane.sitedist);
tableplane.tr.cells[7].textContent = format_track_brief(tableplane.track);
tableplane.tr.cells[8].textContent = tableplane.messages;
tableplane.tr.cells[9].textContent = tableplane.seen.toFixed(0);
tableplane.tr.className = classes;
tableplane.tr.cells[10].textContent = tableplane.rssi.toFixed(1);

2.3 - Add sort functionality to RSSI column (clicking on the title of the RSSI column will sort it "highest to lowest"/"lowest to highest" values. Thanks to @thutson for this.

Press Ctrl+W keys, type function sortBy then press Enter Key
The cursor will jump to relevant block of code.
ADD line shown in RED (copy-paste it)

function sortByICAO() { sortBy('icao', compareAlpha, function(x) { return x.icao; }); }
function sortByFlight() { sortBy('flight', compareAlpha, function(x) { return x.flight; }); }
function sortBySquawk() { sortBy('squawk', compareAlpha, function(x) { return x.squawk; }); }
function sortByAltitude() { sortBy('altitude',compareNumeric, function(x) { return (x.altitude == "ground" ? -1e9 : x.altitude); }); }
function sortBySpeed() { sortBy('speed', compareNumeric, function(x) { return x.speed; }); }
function sortByDistance() { sortBy('sitedist',compareNumeric, function(x) { return x.sitedist; }); }
function sortByTrack() { sortBy('track', compareNumeric, function(x) { return x.track; }); }
function sortByMsgs() { sortBy('msgs', compareNumeric, function(x) { return x.messages; }); }
function sortBySeen() { sortBy('seen', compareNumeric, function(x) { return x.seen; }); }
function sortByCountry() { sortBy('country', compareAlpha, function(x) { return x.icaorange.country; }); }
function sortByRSSI() { sortBy('rssi', compareNumeric, function(x) { return x.rssi; }); }

STEP-3

Code:

#Move into folder containing file to be edited cd /usr/share/dump1090-mutability/html/ #First make a backup copy before attempting modifications #The backup will enable you to revert if something goes wrong sudo cp style.css style.css.bak #Now edit the file and make modifications sudo nano style.css

Counting from top:

Line 6:
change 420 to 460

Line 7:
This line is blank. Do nothing here.

Line 8:
(a) change 410 to 450
(b) change -410 to -455

html, body {
margin: 0; padding: 0; background-color: #ffffff; font-family: Tahoma, Sans-Serif;
font-size: 10pt; overflow: auto; height: 100%;
}
div#map_container { float: left; width: 100%; height: 100%; }
div#map_canvas { height: 100%; margin-right: 460px; }

div#sidebar_container { float: left; width: 450px; margin-left: -455px; height: 100%; overflow: auto; }

STEP-4
Go to dump1090 Map
IP-of-Pi/dump1090/gmap.html

Clear Browser cache (Ctrl+Shift+Delete), the Reload Browser (Ctrl+F5)
The RSSI Column will show on extreme-right of the Map page/Aircraft Table.
Last edited by abcd567; 2021-05-13, 22:41.
Likes 1
Leave a comment:

abcd567 replied

2016-07-01, 07:49

READ & SET GAIN FROM BROWSER / DUMP1090 MAP

Last Updated: 20th July, 2018

This method is for dump1090-mutability ver 1.15~dev.

It will NOT work for PI24 / dump1090-mutability ver 1.14 ("Receiver=DVBT" setting)

OPTION-1: INDEPENDENT

OPTION-2: EMBEDDED IN MAP

STEP-1: Only Step-1 is different for Jessie, Stretch, and Buster, rest is same.

JESSIE

Code:

sudo apt update   
sudo apt install php5-cgi

STRETCH

Code:

sudo apt update   
sudo apt install php7.0-cgi

BUSTER

Code:

sudo apt update   
sudo apt install php7.3-cgi

STEP-2:

Code:

sudo lighty-enable-mod fastcgi-php   
sudo /etc/init.d/lighttpd force-reload

STEP-3:
Create a new file gain.php containing gain button, drop-down list of gains & current gain display.

3.1 - Create a new file gain.php in folder /usr/share/dump1090-mutability/html

Code:

sudo nano /usr/share/dump1090-mutability/html/gain.php

3.2 - Copy-paste following code in newly created blank file gain.php

NOTE:Code is larger than displayed. Scroll Right and Scroll Down to see these in full.

Code:

<html>
 <form id="myform" action="gain.php" method="post" />
 <div><font color=#ff0000 face="'Helvetica Neue', Helvetica, Arial, sans-serif">Current Gain: <?php system('cat /usr/local/sbin/gain/currentgain');?> </font></div>
 <select name="gain" id="gain">
   <option value=-10>-10</option>
   <option value=49.6>49.6</option>
   <option value=48.0>48.0</option>
   <option value=44.5>44.5</option>
   <option value=43.9>43.9</option>
   <option value=43.4>43.4</option>
   <option value=42.1>42.1</option>
   <option value=40.2>40.2</option>
   <option value=38.6>38.6</option>
   <option value=37.2>37.2</option>
   <option value=36.4>36.4</option>
   <option value=33.8>33.8</option>
   <option value=32.8>32.8</option>
   <option value=29.7>29.7</option>
   <option value=28.0>28.0</option>
   <option value=25.4>25.4</option>
   <option value=22.9>22.9</option>
   <option value=20.7>20.7</option>
   <option value=19.7>19.7</option>
   <option value=16.6>16.6</option>
 </select>
 <input type="submit" value="Set Gain" style="color:#ffffff;background-color:#00A0E2;border-color:#00B0F0;" />
 </form>
</html>

<?php
function setgain(){
$gain="{$_POST['gain']}";
system("echo $gain > /usr/local/sbin/gain/newgain");
sleep(5);
header("Refresh:0");
}

if ("{$_POST['gain']}"){
setgain();
}

?>


<!------ END ------>

Save (Ctrl+o) and Close (Ctrl+x)

STEP-4:
Create Gain Changing Script

4.1 - Create new directory

Code:

sudo mkdir /usr/local/sbin/gain

4.2 - Create a new blank script file setgain.sh inside this new directory

Code:

sudo touch /usr/local/sbin/gain/setgain.sh

4.3 - Open file setgain.sh to edit

Code:

sudo nano /usr/local/sbin/gain/setgain.sh

4.4 - Copy-paste following code in file setgain.sh
Note:
The code in file setgain.sh was originally written by abcd567, but due to a security issue, it has been re-written by wiedehopf.

NOTE:Code is larger than displayed. Scroll Right and Scroll Down to see these in full.

Code:

#!/bin/bash

# redirect all output and errors of this script to a log file
exec &>/usr/local/sbin/gain/log

# file that anyone can write to in order to set a new gain
fifo=/usr/local/sbin/gain/newgain

# remove $fifo so we are sure we can create our named pipe
rm -f $fifo

# create the named pipe with write access for everyone
mkfifo -m 666 $fifo

# read current gain and store in file currentgain
# script in gain.php will read gain value stored in currentgain and
# will display it on map as "Current Gain"
sed -n 's/\GAIN=//p' /etc/default/dump1090-mutability > /usr/local/sbin/gain/currentgain



while sleep 1
do
        if ! [[ -r $fifo ]] || ! [[ -p $fifo ]]

        # exit the loop/script if $fifo is not readable or not a named pipe
        then break
        fi


        # read one line from the named pipe, remove all characters but numbers, dot, minus and newline and store it in $line
        read line < <(tr -cd  '.\-0123456789\n' < $fifo)

        #set new gain
        sed -i '/GAIN=.*/c\GAIN='$line /etc/default/dump1090-mutability

        #restart dump1090-mutability to implement new gain value
        systemctl restart dump1090-mutability

        # read updated gain and store in file currentgain
        sed -n 's/\GAIN=//p' /etc/default/dump1090-mutability > /usr/local/sbin/gain/currentgain

        # script in gain.php will read the updated gain and display it on map

done

#
#

Save (Ctrl+o) and Close (Ctrl+x) the file.

STEP-5:
Add entry in cron to run script setgain.sh at boot

Code:

sudo crontab -e 
 
#If you are using crontab for first time, it will ask which editor to use
#Choose "nano", as it is the easiest to use

#Scroll down and ADD following line at the end

@reboot /bin/bash /usr/local/sbin/gain/setgain.sh

Save (Ctrl+o) and Close (Ctrl+x)

STEP-6:
Run and Test.

6.1 - Reboot Pi for cron to run the script setgain.sh at startup.

6.2 - After Pi has rebooted, go to page IP-of-PI/dump1090/gain.php and check gain setting add-on appears as shown in FIRST screenshot above.

The value show in Red at browser load or re-load is your current gain value.

If you want to change it, click open drop-down menu, select the desired gain and click "Set Gain" button. After about 5 seconds, the Current Gain (red) will be updated.

If you want to verify that gain has actually changed, give following command. The output of this command will show the actual value of gain used.

Code:

sudo systemctl status dump1090-mutability -l

You can also check current gain by following command

Code:

cat /etc/default/dump1090-mutability

ADDITIONAL STEP IF YOU WANT TO EMBED SETGAIN BUTTON IN DUMP1090-MUTABILITY MAP

STEP-7:
Edit file gmap.html and add code to embed newly created file gain.php (the file gain.php contains "Set Gain" button & drop-down menu).

7.1 - BEFORE EDITING, make its backup copy. This will enable you to revert in case something goes wrong.

Code:

cd /usr/share/dump1090-mutability/html/
sudo cp gmap.html gmap.html.orig

#Check to ensure back-up copy has been created by giving ls command

ls

#The output should contain both gmap.html and gmap.html.orig

config.js    formatter.js   markers.js        style.css
coolclock    gain.php       ol3               test
db           gmap.html.orig  planeObject.js    upintheair.json
dbloader.js  gmap.html      registrations.js
flags.js     jquery         script.js
flags-tiny   layers.js      spinny.gif

7.2 - Open the file gmap.html for editing

Code:

cd /usr/share/dump1090-mutability/html/  
sudo nano gmap.html

7.3 - Press Ctrl+w then type sudo_buttons then press Enter key.
The cursor will jump to line `<div id="sudo_buttons">`, as shown below

Code:

                                </div> <!-- timestamps -->

                                <div id="sudo_buttons">
                                        <table style="width: 100%">
                                                <tr>
                                                        <td style="width: 150px; text-align: center;" class="pointer">
                                                                [ <span onclick="resetMap();">Reset Map</span> ]
                                                        </td>
                                                </tr>
                                        </table>

                                </div> <!-- sudo_buttons -->

7.4 - Just above line <div id="sudo_buttons">, insert following 3 lines

Code:

<div id="GAIN" style="text-align:center;width:175px;height:65px;">   
<iframe src=gain.php style="border:0;width:175px;height:65px;"></iframe>   
</div> <!----- GAIN --->

After insertion of 3 lines, the code will be like shown below:

Code:

                                </div> <!-- timestamps -->

<div id="GAIN" style="text-align:center;width:175px;height:65px;">   
<iframe src=gain.php style="border:0;width:175px;height:65px;"></iframe>   
</div> <!----- GAIN --->   


                                <div id="sudo_buttons">
                                        <table style="width: 100%">
                                                <tr>
                                                        <td style="width: 150px; text-align: center;" class="pointer">
                                                                [ <span onclick="resetMap();">Reset Map</span> ]
                                                        </td>
                                                </tr>
                                        </table>

                                </div> <!-- sudo_buttons -->

Save (Ctrl+o) and Close (Ctrl+x)

7.5 - Go to page IP-of-PI/dump1090/gmap.html and check gain setting add-on appears as shown in screenshot above. If button does not show, clear cache and reload browser Ctrl+F5

The value show in Red at browser load or re-load is your current gain value.

If you want to change it, click open drop-down menu, select the desired gain and click "Set Gain" button. After about 5 seconds, the Current Gain (red) will be updated.

Last edited by abcd567; 2019-07-21, 22:35.

Announcement

How to Install dump1090-mutability on RPi

Leave a comment:

Leave a comment:

Leave a comment:

Leave a comment:

Leave a comment:

Leave a comment:

How to Install dump1090-mutability on RPi