Installationsanleitung

Erstinstallation

Die folgenden Anweisungen gehen von einer Installation auf einem RaspberryPi aus und das Home-Verzeichnis lautet entsprechend /home/pi. Es darf nur die 32bit Version von Raspbian verwendet werden. Die vorkomplilierten Pakete sind nicht mit der 64bit Version vom Raspbian kompatibel. Es ist auch eine Installation auf allen üblichen Linux-Systemen in gleicher Weise möglich. Es müssen dann nur die Pfadangaben angepasst werden. Es werden nur die Programmdateien installiert. Startskripte sind in den Paketen nicht vorhanden und müssen selbst erstellt bzw. hinzugefügt werden.

Wechseln in das Home-Verzeichnis mit

cd ~

Wir laden das aktuelle Paket der dxlAPRS Tools von der Seite github.com/dl1nux/dxlAPRS herunter. Es wird dabei unterschieden für welche Plattform man die Tools benötigt:

   * armv6 (z.B. RaspberryPi der ersten Generation oder Zero - nur 32bit!)
   * armv7hf (z.B. RaspberryPi ab Version 2B und aufwärts - nur 32bit!)
   * x86_32 (32 Bit PC-Systeme)
   * x86_64 (64 Bit PC-Systeme)

Für einen RaspberryPi 2B und neuer benötigt man die Version armv7hf, welches an der Konsole wie folgt herunterladen werden kann:

wget https://github.com/dl1nux/dxlAPRS/raw/main/dxlAPRS_armv7hf-current.tgz

Das Archiv enthält ein Installations-Skript, welches man extrahiert und im Home-Verzeichnis speichert:

tar xzvf dxlAPRS_armv7hf-current.tgz --strip=1 scripts/updateDXLaprs

In der Regel dürfte das Skript bereits ausführbar sein. Wir starten die Installation der Tools mit:

./updateDXLaprs dxlAPRS_armv7hf-current.tgz

Anschließend befindet sich im Home-Verzeichnis der Ordner "dxlAPRS", welcher die beiden weiteren Unterordner "aprs" und "aprsmap" enthält.

Schnelle Installation auf dem RaspberryPi ab Version 2 (ARMv7)

cd ~
wget https://github.com/dl1nux/dxlAPRS/raw/main/dxlAPRS_armv7hf-current.tgz
tar xzvf dxlAPRS_armv7hf-current.tgz --strip=1 scripts/updateDXLaprs
./updateDXLaprs dxlAPRS_armv7hf-current.tgz

Es ist empfehlenswert anschließend sofort Updates der Programmdateien zu lassen:

wget https://raw.githubusercontent.com/dl1nux/dxlAPRS-update/refs/heads/main/dxl-update.sh
chmod +x dxl-udpate.sh

Mit

./dxl-update.sh 

kann nun das Update am Raspberry Pi gestartet werden. Für andere Plattformen muss das Skript angepasst werden (siehe weiter unten).

Schnelle Installation auf dem RaspberryPi ab Version 3 mit 64bit Betriebssystem (aarch64)

cd ~
wget https://github.com/dl1nux/dxlAPRS/raw/main/dxlAPRS_aarch64-current.tgz
tar xzvf dxlAPRS_aarch64-current.tgz --strip=1 scripts/updateDXLaprs
./updateDXLaprs dxlAPRS_aarch64-current.tgz

Schnelle Installation auf dem RaspberryPi Version 1 sowie Pi Zero W/H (ARMv6)

cd ~
wget https://github.com/dl1nux/dxlAPRS/raw/main/dxlAPRS_armv6-current.tgz
tar xzvf dxlAPRS_armv6-current.tgz --strip=1 scripts/updateDXLaprs
./updateDXLaprs dxlAPRS_armv6-current.tgz

Schnelle Installation auf 64bit PC-Systemen

cd ~
wget https://github.com/dl1nux/dxlAPRS/raw/main/dxlAPRS_x86_64-current.tgz
tar xzvf dxlAPRS_x86_64-current.tgz --strip=1 scripts/updateDXLaprs
./updateDXLaprs dxlAPRS_x86_64-current.tgz

Schnelle Installation 32bit PC-Systemen

cd ~
wget https://github.com/dl1nux/dxlAPRS/raw/main/dxlAPRS_x86_32-current.tgz
tar xzvf dxlAPRS_x86_32-current.tgz --strip=1 scripts/updateDXLaprs
./updateDXLaprs dxlAPRS_x86_32-current.tgz

Udpate der Programmdateien von dxlaprs.hamspirit.at

Hinweis: Da der Server in der Vergangenheit immer wieder mal nicht erreichbar war hier der Hinweis, dass dies nur funktioniert wenn der Server auch online ist!

Für eine nachträgliche Aktualisierung der Programmdateien vom selben Server kann das Skript ebenfalls verwendet werden. Dazu startet man das Skript und hängt die Plattform (armv6, armv7hf, x86_32, x86_64) als Parameter an. Dazu muss man sich unterhalb des dxlAPRS Ordners befinden, der bei der Erstinstallation angelegt wurde. Idealerweise belässt man einfach die Datei updateDXLaprs nach der Erstinstallation im Homeverzeichnis, dann kann man diese immer wieder nutzen.

cd ~
./updateDXLaprs armv7hf

Der Befehl lädt automatisch das aktuelle Programmpaket von der Webseite dxlaprs.hamspirit.at und ersetzt die bisherigen Programmdateien durch die neueren. Nachträglich veränderte Dateien, wie z.B. die style.css, sollten vor dem Update gesichert und anschließend zurückkopiert werden. Sie werden sonst gnadenlos durch das Updateskript überschrieben. Startskripte werden dadurch nicht überschrieben, da diese nicht im Programmpaket enthalten sind.

Hinweis: Die Archive von OE5HPM werden nur sehr unregelmäßig aktualisiert. Die neuesten Versionen der Programmdateien liegen immer auf dem Server von Chris OE5DXL. Es ist empfehlenswert das Update der Programmdateien über das folgende Updateskript durchzuführen

Manuelles Update über den OE5DXL Server

Die Programmpakete auf dxlaprs.hamspirit.at werden nur unregelmäßig durch Hannes OE5HPM aktualisiert. Da Chris OE5DXL jedoch permanent an der Weiterentwicklung arbeitet, liegen meist bereits aktuellere Programmversionen von ihm vor. Möchte man die aktuellsten Programmversionen probieren, kann man diese manuell von seinem Server laden (siehe Abschnitt "Weitere Bezugsquellen").

Damit man nicht jede einzelne Datei manuell mit WGET laden muss, habe ich ein einfaches Skript erstellt, das einem die Arbeit abnimmt. Man muss allerings reinschreiben, wo sich der dxlAPRS Ordner befindet, welche der drei Architekturen (armv7hf, x86-32, x86-64) man benötigt und von welcher Quelle man die Programmdateien laden möchte.

Download von Github

git clone https://github.com/dl1nux/dxlAPRS-update.git

Bitte auch die REAMDE.md Datei lesen für weitere Hinweise!

Das Updateskript im Detail

Stand 24.06.2022

#!/bin/sh
# Skript von Attila Kocis, DL1NUX (attila@dl1nux.de)
# Dieses Skript aktualisiert die dxlAPRS Binaries direkt vom Server des 
# Entwicklers Chris OE5DXL. Der Server ist über verschiedene Wege erreichbar.

# Bitte in der Variable DXLHOME den Ordner eintragen, wo sich der Hauptordner
# "dxlAPRS" derzeit befindet.
DXLHOME=/home/pi

# Bitte in der Variable ARCH die Architektur eintragen, die benötigt wird.
#   Zur verfügung stehen: armv7hf (RaspberryPi 2B und neuer)
#                         x86-32  (32 bit PC Systeme)
#                         x86-64  (64 bit PC Systeme)
ARCH=armv7hf

# Bitte für die Variable SOURCE die Updatequelle auswählen (auskommentieren)
# Internet HTTPS:
#SOURCE=https://oe5dxl.hamspirit.at:8024/aprs/bin/
# Internet HTTP:
SOURCE=http://oe5dxl.hamspirit.at:8025/aprs/bin/
# Hamnet HTTP:
#SOURCE=http://oe5dxl.ampr.org/aprs/bin/

echo "Dieses Skript aktualisiert die dxlAPRS Binaries aus der Quelle:"
echo $SOURCE
echo ""
echo "Bitte vor dem Ausführen die Variablen DXLHOME, ARCH und SOURCE im Skript kontrollieren und ggf. anpassen."
echo "Hinweis: Zum Aktualisieren von AFSKMODEM werden root Rechte benötigt!"
echo "Es stehen nicht alle Tools für alle Architekturen zur Verfügung (ggf. Fehleranzeige)."
echo ""
echo "ENTER für weiter, STRG+C zum Abbrechen..."
read continue

cd $DXLHOME/dxlAPRS/aprs

wget -N --no-check-certificate $SOURCE$ARCH/adsb2aprs
sudo wget -N --no-check-certificate $SOURCE$ARCH/afskmodem
wget -N --no-check-certificate $SOURCE$ARCH/cmslogin
wget -N --no-check-certificate $SOURCE$ARCH/downsample
wget -N --no-check-certificate $SOURCE$ARCH/fmrepeater
wget -N --no-check-certificate $SOURCE$ARCH/gps2aprs
wget -N --no-check-certificate $SOURCE$ARCH/gps2digipos
wget -N --no-check-certificate $SOURCE$ARCH/hostint
wget -N --no-check-certificate $SOURCE$ARCH/l2cat
wget -N --no-check-certificate $SOURCE$ARCH/lorarx
wget -N --no-check-certificate $SOURCE$ARCH/loratx
wget -N --no-check-certificate $SOURCE$ARCH/profile
wget -N --no-check-certificate $SOURCE$ARCH/ra02
wget -N --no-check-certificate $SOURCE$ARCH/radiorange
wget -N --no-check-certificate $SOURCE$ARCH/sdrradio
wget -N --no-check-certificate $SOURCE$ARCH/sdrtst
wget -N --no-check-certificate $SOURCE$ARCH/sdrtx
wget -N --no-check-certificate $SOURCE$ARCH/sondemod
wget -N --no-check-certificate $SOURCE$ARCH/sondeudp
wget -N --no-check-certifi
cate $SOURCE$ARCH/udpbox
wget -N --no-check-certificate $SOURCE$ARCH/udpflex
wget -N --no-check-certificate $SOURCE$ARCH/udpgate4
wget -N --no-check-certificate $SOURCE$ARCH/udphub
wget -N --no-check-certificate $SOURCE$ARCH/waterfall
wget -N --no-check-certificate $SOURCE$ARCH/waterfall3

cd $DXLHOME/dxlAPRS/aprsmap

wget -N --no-check-certificate $SOURCE$ARCH/aprsmap

cd ~

echo "Übertragung abgeschlossen."
echo "Dateien in $DXLHOME/dxlaprs/aprs und $DXLHOME/dxlaprs/aprsmap wurden aktualisiert."
echo ""

Bei diesem Skript ist zu beachten, dass es die Programmdateien herunterlädet, auch wenn sie lokal noch nicht existieren. Hin und wieder kommen neue Programme hinzu, diese werden dann auch heruntergeladen. Allerdings haben sie dann nicht die richtigen Rechte, damit man sie auch ausführen kann. Dies kann man ändern mit chmod. Der Befehl muss in dem Ordner ausgeführt werden, wo sich die Datei befindet.

chmod 755 <Programmname>

z.B.

chmod 755 lorarx

Weitere Bezugsquellen

Christian OE5DXL entwickelt die dxlAPRS Tools stetig weiter. Die Programmpakete werden in unregelmäßigen Abständen von Hannes OE5HPM gepackt und hier bereitgestellt: dxlaprs.hamspirit.at Die aktuellsten Versionen, manchmal auch Beta-Versionen, findet man direkt auf Christians Seite im Internet mit SSL, Internet ohne SSL oder Hamnet.

Bei der SSL Seite wird das selbstgenerierte Serverzertifikat bemängelt. Das kann man getrost ignorieren.

Programmquellcodes von OE5HPM findet man auf Github oder am aktuellsten auf dem Server von Chris im Unterorder /aprs/c/.

Video-Tutorial

Für die Installation und Aktualisierung der dxlAPRS Toolchain hat DL1NUX ein Tutorial-Video erstellt. Es ist über Youtube abrufbar:

https://www.youtube.com/watch?v=S9lA0tx-5eY