Feed planeplotter from RPi/dump1090

[abcd567]

This post describes method to install planeplotter uploader on RPi.

This software obtains data from dump1090, and uploads it to planeplotter site only. It is NOT like Windows full-scale Planeplotter software.

This method is applicable to all the following installs:

• Piaware SD Card image (which has integral dump1090-fa)
  
  
• Pi24 image (which has integral dump1090-mutability)
  
  
• Raspbian image with dump1090-fa package install
  
  
• Raspbian image with dump1090-mutability package install
  
  

CREDITS:
David Taylor
http://www.satsignal.eu/raspberry-pi/dump1090.html

STEP-BY-STEP METHOD


1 - Obtain Planeplotter Configuration/user key
Go to http://www.coaa.co.uk/rpi-request.htm and enter your details, and your co-ordinates. You will then be e-mailed your own personal copy of a file called coaa.h.


2 - Install packages necessary to build and necessary to fulfil dependencies.

Code Select Expand


sudo apt-get update
sudo apt-get install git cmake librtlsdr-dev
sudo apt-get install libusb-1.0-0-dev pkg-config



3 - Build the Planeplotter uploader ppup1090 from source code of dump1090 (Malcolm Robb)

3.1 - Clone/download the dump1090 source code from Github.

Code Select Expand


cd ~
git clone git://github.com/MalcolmRobb/dump1090.git ppup


3.2 -  Enter folder ppup

Code Select Expand


cd ppup


3.3 - Add Planeplotter Configuration/user key
In directory ppup, you will find dummy file coaa.h. Replace it with the coaa.h you have received by email (see step 1). Use any one of following 2 options.

Option-1:
Use FileZilla or WinSCP or similar program to copy file `coaa.h` from your Desktop/Laptop to RPi in folder ppup.

The file coaa.h cannot be directly copied to folder ppup due to permissions problem. To overcome this problem, copy it to folder /home/pi which has permission for copying files using SCP or FTP.

Once you have a copy of file coaa.h in folder home/pi, SSH to Pi, and issue following command to copy it to folder ppup:

Code Select Expand


cd ~/
sudo cp coaa.h  ppup/



Option-2:
Open file coaa.h received by email using MS Word or Wordpad
It's content will be like this:

Code Select Expand


//coaa.h configuration file for ab cd 2018-07-11 05:58:29
#define USER_REGNO xxxxxxx
#define USER_AUTHCODE xxxxxxxxxx
#define USER_LATITUDE xx.xxx
#define USER_LONGITUDE xx.xxx


open file coaa.h in RPi's folder ppup for editing

Code Select Expand


cd ~/ppup
sudo nano coaa.h


following will be displayed

Code Select Expand


// coaa.h configuration file for Plane Plotter Uploader
//
// You MUST apply via the COAA website for your own personal version of this fi$
// Do not disclose the contents of this file to anyone thereafter as it uniquely
// identifies you to the PlanePlotter system
//



Press (Ctrl+k) to delete all these lines and make this file empty.
Copy-Paste all lines from the file `coaa.h` which you received by email) in the file coaa.h in RPi.
After pasting, it will become like this

Code Select Expand


//coaa.h configuration file for ab cd 2018-07-11 05:58:29
#define USER_REGNO xxxxxx
#define USER_AUTHCODE xxxxxxxxx
#define USER_LATITUDE xx.xxx
#define USER_LONGITUDE xx.xxx



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

3.4 - Compile the ppup1090 (plane plotter uploader) from source code

Code Select Expand


cd ~/ppup
make -f makeppup1090


3.5 - TEST

Code Select Expand


cd ~/ppup
./ppup1090


4 - Make ppup1090 to auto-start at boot by systemd

4.1 - Create system user ppup1090 which will start the service automatically at boot.

Code Select Expand


sudo useradd --system ppup1090 



4.2 - Create a blank file ppup1090.service in folder /lib/systemd/system/ppup1090.service

Code Select Expand


sudo nano /lib/systemd/system/ppup1090.service


4.3 - Copy-paste following code in this blank file

IF USING DUMP1090-FA

Code Select Expand


# planeplotter uploader service for systemd

[Unit]
Description=PlanePlotter Raspberry Pi uploader
Wants=network-online.target
After=dump1090-fa.service network-online.target time-sync.target
PartOf=dump1090-fa.service

[Service]
User=ppup1090
RuntimeDirectory=ppup
ExecStart=/home/pi/ppup/ppup1090 --quiet
Type=simple
Restart=on-failure
RestartSec=30
# exit code 4 means login failed
# exit code 6 means startup failed
RestartPreventExitStatus=4 6

[Install]
WantedBy=default.target


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


IF USING DUMP1090-MUTABILITY

Code Select Expand


# planeplotter uploader service for systemd

[Unit]
Description=PlanePlotter Raspberry Pi uploader
Wants=network-online.target
After=dump1090-mutability.service network-online.target time-sync.target
PartOf=dump1090-mutability.service

[Service]
User=ppup1090
RuntimeDirectory=ppup
ExecStart=/home/pi/ppup/ppup1090 --quiet
Type=simple
Restart=on-failure
RestartSec=30
# exit code 4 means login failed
# exit code 6 means startup failed
RestartPreventExitStatus=4 6

[Install]
WantedBy=default.target


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

.

4.4 - Enable service by following command

Code Select Expand


sudo systemctl enable ppup1090.service 

sudo systemctl restart ppup1090


.

4.5 - Check status after few minutes

Code Select Expand


pi@raspberrypi:~ $ sudo systemctl status ppup1090
● ppup1090.service - PlanePlotter Raspberry Pi uploader
   Loaded: loaded (/lib/systemd/system/ppup1090.service; enabled; vendor preset: enabled)
   Active: active (running) since Sun 2019-03-17 04:36:59 EDT; 5min ago
Main PID: 860 (ppup1090)
   CGroup: /system.slice/ppup1090.service
           └─860 /home/pi/ppup/ppup1090 --quiet

Mar 17 04:36:59 raspberrypi systemd[1]: Started PlanePlotter Raspberry Pi uploader.




4.6 - Commands to control & monitor

Code Select Expand


sudo systemctl restart ppup1090   

sudo systemctl stop ppup1090   

sudo systemctl status ppup1090 


[rikgale]

I have just followed the first few parts of this process. Section 3.1 needs to be updated to

3.1 - Clone/download the dump1090 source code from Github.

Code Select Expand

cd ~
git clone https://github.com/MalcolmRobb/dump1090.git ppup

NOTE: I am unable to get ppup to compile under the latest version of Raspberry Pi OS (BOOKWORM), but worked fine on an old BUSTER version of Raspberry Pi OS

[abcd567]

NOTE: I am unable to get ppup to compile under the latest version of Raspberry Pi OS (BOOKWORM), but worked fine on an old BUSTER version of Raspberry Pi OS

UPDATED METHOD

THIS METHOD IS APPLICABLE TO:

• Piaware SD Card image (Buster, Bullseye, Bookworm)
• Raspberry Pi OS image  (Buster, Bullseye, Bookworm) - with dump1090-fa / dump1090-mutability / ModeSDeco2 / readsb
• Ubuntu 20, 22, and 24, amd64 (x86_64) PC
• Debian 10, 11, 12 & 13, amd64 (x86_64) PC

INSTALLATION
The bash script given below performs fully automated installation of planeplotter uploader ppup1090 on RPi & Debian/Ubuntu PC
Copy-paste the following command in Terminal / PuTTY and press Enter Key:

Code Select Expand

sudo bash -c "$(wget https://github.com/abcd567a/ppup1090/raw/master/install-ppup.sh)" 


The above bash script does the following:

• Creates installation folder /usr/share/ppup
• Creates Systemd Service file /lib/systemd/system/ppup1090.service and enables it.
• Downloads compiled binary package from coaa.co.uk 1 and saves it in folder /usr/share/ppup
• Unzips downloaded binaries package into folder /usr/share/ppup/
• Detects OS Version (Buster / Bullseye / Bookworm / x86_64 / i686 ) and architecture (32-bit or 64-bit)
• Copies binary ppup1090 to folder /usr/share/ppup/ from the unzipped folder matching the OS version and architecture detected (item 5 above)
• Makes binary /usr/share/ppup/ppup1090 executable.

BRIEF HISTORY
The source code of Raspberry Pi's Planeplotter uploader ppup1090 was created by MacolmRob. However as he has stopped maintaining it, it fails to compile on Bullseye and Bookworm.

Recently Bev of PlanePlotter has compiled the ppup1090 binary and made it available for downlod, as posted by Dan & Bev in Planeplotter groups.

1. https://planeplotter.groups.io/g/main/topic/ppup1090_new_2024_version/104396113?p=,20,0,0,0::recentpostdate/sticky,20,2,80,104396113 

2. https://planeplotter.groups.io/g/main/message/129906

3. https://planeplotter.groups.io/g/main/message/130092


In the latest release (https://www.coaa.co.uk/ppup1090-2024-06-11.zip 2), the Binaries compiled by Bev are available for following:

• Buster 32-bit
• Bullseye 32-bit and 64-bit
• Bookworm 64-bit
• X86-64 (for Ubuntu & Debian on PC)
• I686-32 (for Ubuntu & Debian on PC)

I wrote above noted script script to automatically install the Planeplotter uploader ppup1090 on RPi.


You cannot view this attachment.


After the bash script completes installation, the user has to do following things:
(1) Copy his file coaa.h to folder /usr/share/ppup/

NOTE: If you do not already have a coaa.h file, or it has expired due to long priod of no use, then request it from following address:
https://www.coaa.co.uk/rpi-request.htm

(2) Restart ppup1090 by following command

Code Select Expand

sudo systemctl restart ppup1090 
(3) Test ppup1090 status by following link
https://www.coaa.co.uk/rpiusers.php?authcode=123456789
In above link, replace 123456789 by your authcode
(your authcode is available in file coaa.h)


You cannot view this attachment.


To check status:

Code Select Expand

sudo systemctl status ppup1090

sudo journalctl -u ppup1090 -e


You cannot view this attachment.


.
To Uninstall Completely:
Please issue following 5 commands.

Code Select Expand

sudo systemctl stop ppup1090

sudo systemctl disable ppup1090

sudo rm /lib/systemd/system/ppup1090.service

sudo rm -rf /usr/share/ppup

sudo rm /usr/bin/ppup1090