How to Make dump1090-rb Configurable by User

[abcd567]

If you have NOT installed any decoder (such as dump1090-fa, readsb, dump1090-mutability etc) and are using rbfeeder's built-in decoder dump1090-rb,  then you can make dump1090-rb configurable by following method. This will enable you to set gain to your desired value

(1) You have to do nothing except to copy-paste following bash command in Terminal / PuTTY and press the Enter Key. The bash command will do everything automatically

Code: [Select]


sudo bash -c "$(wget -O - https://github.com/abcd567a/temp/raw/main/make-dump1090-rb-configurable.sh)"   



(2) After the script completes installation, REBOOT your Pi

Code: [Select]

sudo reboot


(3) Edit file /etc/default/dump1090-rb to change gain setting from default 49.6 to whatever value you desire (between 0 and 60).

Code: [Select]


sudo nano /etc/default/dump1090-rb 



(4) After editing and saving file /etc/default/dump1090-rb, restart dum1090-rb by following command

Code: [Select]

sudo systemctl restart dump1090-rb   


(5) Check status of dump1090-rb by following command:

Code: [Select]

sudo systemctl status dump1090-rb   



NOTE:
If user wants to use automatic gain control (also known as adaptive gain control), he can activate it by adding following two lines at the bottom of file /etc/default/dump1090-rb

--adaptive-range
--adaptive-burst

After adding these two lines, Save & Close file, and restart dump1090-rb


HOW TO REMOVE ABOVE MODIFICATIONS AND REVERT TO ORIGINAL SETUP?

Issue following SEVEN (7) Commands (Do not miss any command)

Code: [Select]

sudo systemctl stop dump1090-rb   

sudo systemctl disable dump1090-rb   

sudo rm /lib/systemd/system/dump1090-rb.service   

sudo rm /etc/default/dump1090-rb   

sudo rm -rf /usr/lib/dump1090-rb 

sed -i 's/^network_mode=.*/network_mode=false/' /etc/rbfeeder.ini   

sudo reboot 




DETAILED EXPLANATION OF THE MODIFICATIONS DONE BY BASH SCRIPT
If you have not installed any type of decoder (such as dump1090-fa or dump1090-mutability, or readsb etc), you can use rbfeeder's built-in decoder dump1090-rb .

To use rbfeeder's built-in decoder dump1090-rb, you have to use following setting in file /etc/rbfeeder.ini

network_mode=false

However the Radarbox24 Software Developers have not provided facility for user to change the gain setting.

In view of above difficulty, I have wrtten a script which does following modifications automatically:

(1) In file /etc/rbfeeder.ini changes setting:
From
network_mode=false
To
network_mode=true

(2) Creates following systemd service file:
 /lib/systemd/system/dump1090-rb.service

This systemd service file automatically starts dump1090-rb at boot and reboot. It also provides following commands, enabling user to manually stop, restart, and check status.

Code: [Select]

sudo systemctl status dump1090-rb   
sudo systemctl restart dump1090-rb
sudo systemctl stop dump1090-rb   

(3) Creates following user-editable cofig file for dump1090-rb config parameters:

/etc/default/dump1090-rb

The default contents of this user-editable file are as follows:

--gain 49.6
--device 0
--net
--net-ri-port 30001
--net-ro-port 30002
--net-sbs-port 30003
--net-bi-port 30004,30104
--net-bo-port 30005
--quiet
--write-json /var/run/dump1090-rb
--mlat
--forward-mlat
--modeac
--fix
--gnss

(a) User can change default gain valu 49.6 to whatever value he wants (between 0 and 60) .

(b) If using more than one dongle, the user can change device index/serial from default "--device 0" to "--device nnnn" where nnnn is the serial number to which he has serialized his dump1090 dongle.

(c) User can add immediately below last line, following two lines:

  --lat xx.xxxx
  --lon yy.yyyy

(Replace xx.xxxx and yy.yyyy by your actual latitude and longitude)

(d) User can switch from a fixed value of gain to automatic adaptive gain control by adding following two lines in the file /etc/default/dump1090-rb

--adaptive-burst
--adaptive-range

.

[abcd567]

How to install tar1090 map for configurable dump1090-rb?

You can install above add-on which will display a live map and a live table, all the aircraft currently being received by your antenna+dongle, and decoded by dump1090-rb.

However this requires that you have already made dump1090-rb configurable by method given in post #1 of this thread.

The tar1090 is added to RPi by bash script provided at following site:

https://github.com/wiedehopf/tar1090/blob/master/README.md

However currently the bash script on above site suits only dump1090-fa, dump1090-mutability, and readsb.
It fails if used directly with dump1090-rb.

I have found a work-around to successfully install tar1090 when your decoder is dump1090-rb and it has been reconfigured as per post #1 of this thread. The work-around is given below:

(1) First install package lighttpd
(2) AFTER installing package lighttpd, download the installation script from above site.
(3) AFTER downloading install script, issue sed command to modify the script and make it suitable for reconfigured version of dump1090-rb.
(4) AFTER modifying installation script by sed command, run the modified installation script to install tar1090.


For your ease and quick reference, I am giving below commands for all above 4 steps. Please issue these commands in the same order as given below.

Code: [Select]


sudo apt install lighttpd   

wget -O install-tar1090.sh https://github.com/wiedehopf/tar1090/raw/master/install.sh   

sudo sed -i 's/dump1090-fa/dump1090-rb/g' install-tar1090.sh   

sudo bash install-tar1090.sh   




NOTE:
After installing "tar1090", you can change it's settings to display map and aircraft table in LIGHY or DARK mode. Please see attached screenshots.

[abcd567]

How to Install Graphs1090 on Configurable dump1090-rb?

The graphs1090 is a very useful tool to monitor performance of your ADS-B System and RPi. It's installation script is provided on the site linked below. However this requires that you have already made dump1090-rb configurable by method given in post #1 of this thread.


https://github.com/wiedehopf/graphs1090/blob/master/README.md


IMPORTANT:
The bash command given on above site works straightaway for decoders dump1090-fa, dump1090-mutability, and readsb, but fails when decoder is dump1090-rb. The work-around for making it work with configurable dump1090-rb is as follows:

(1) First install package lighttpd

(2) AFTER installing lighttpd, run the bash command to install graphs1090

(3) AFTER installing graphs1090, run another command to make graphs1090 use data from dump1090-rb


For your convenience, I am giving below all the three commands listed above. Please execute these commands in the same order as given below.

Code: [Select]


sudo apt install lighttpd

sudo bash -c "$(curl -L -o - https://github.com/wiedehopf/graphs1090/raw/master/install.sh)"   

sudo ln -sf /var/run/dump1090-rb /usr/share/graphs1090/data-symlink/data   



(1) Graphs1090 can be seen in your Browser at following address:

IP-OF-PI/graphs1090/

(2) Blank graphs will appear immediately after installtion is completed. However after installing graphs1090, you will have to wait for about 10 minutes for data to start appear in the graphs.