Is2axudp.py

Beschreibung

is2axudp.py ist ein Python3 Skript, um Pakete im APRS-IS Protokoll entgegenzunehmen und in das AXUDP Format zu wandeln. Dies ermöglicht es beispielsweise Daten einer Wetterstation mit CWOP Report (z.B. WeeWX) direkt per HF über APRS abzustrahlen, anstatt die Daten nur über das Internet an einen APRS-Server zu übermitteln. Selbstverständlich lassen sich so auch andere Daten aus dem APRS-IS Protokoll in AXUDP wandeln.

Anwendungszwecke:

• Abstrahlung der Daten direkt lokal über HF (z.B. mit udpflex und einem TNC).
• Abstrahlung der Daten über einen entfernten APRS-Digipeater mit dxlAPRS Software.

Technisches zu is2axudp.py

• Das Skript besteht aus zwei Teilen. Zum einen das Skript wx.py von Chris OE5DXL und zum anderen das Skript is2axudp.py von Matze DM4TZE.
• Beide Dateien müssen im gleichen Ordner liegen.
• Zum Ausführen wird python3 benötigt. Falls es noch nicht installiert ist, kann es auf Debian und kompatiblen Systemen (RaspberryPi, Ubuntu, Mint etc.) mit >> sudo apt-get install python3 << nachinstalliert werden.
• Das Skript kann gestartet werden mit dem Befehl >> python3 is2axudp.py <<. Alternativ kann man die python Datei auch mit >> chmod 755 << ausführbar gemacht und anschließend direkt mit ./is2axudp.py gestartet werden.

Funktionsweise

Im Beispiel die Anbindung einer Wetterstation mit WeeWX und konfiguriertem CWOP Report.

python3 is2axudp.py 

connection
<-# is2axudp 0.1
->user DL1NUX-14 pass 21432 vers weewx 4.2.0
<-# logresp #
->DL1NUX-14>APRS,TCPIP*:@182025z5013.81N/01059.43E_000/002g004t035r001p009P009b10250h81.weewx-4.2.0-FineOffsetUSB
<~DL1NUX-14>APRS:@182025z5013.81N/01059.43E_000/002g004t035r001p009P009b10250h81.weewx-4.2.0-FineOffsetUSB

1. Das Skript erzeugt einen TCP Server auf einem im Skript vorgegebenen und auch änderbaren Port.
2. Die Wetterstation connected den TCP Server.
3. is2axudp.py antwortet protokollgemäß mit der Softwareversion
4. WeeWX sendet das APRS Loginskript mit Rufzeichen, Passcode und Softwareversion
5. is2axudp.py antwortet mit einem # logresp #. Damit weiß WeeWX dass die Verbindung erfolgreich ist.
6. WeeWX sendet das APRS Paket mit enthaltener TCPIP* Syntax. Das ist so definiert für Übergaben in das APRS-IS Netzwerk.
7. Für die Aussendung als APRS-Paket wird durch is2axudp.py die Syntax ",TCPIP*" wieder entfernt. Es bleibt das eigentliche Rohpaket übrig.
8. is2axudp.py wandelt mithilfe der wx.py von Chris OE5DXL das Paket in das AXUDP Format um.

Das somit erzeugte AXUDP Paket kann an alle kompatiblen Tools der dxlAPRS Toolchain (udpflex, afskmodem, udpbox usw.) zur Weiterverarbeitung übergeben werden.

Wie WeeWX eingestellt werden muss

In der WeeWX Konfiguration muss der sogenannte "CWOP" Report aktiviert werden. "CWOP" steht dabei nicht für den "Telegrafie-Operator", sondern für "Citizen Weather Observer Program".

Die WeeWX Konfigurationsdatei liegt gewöhnlicherweise hier /etc/weewx/weewx.conf. Der Ort kann aber auch abweichen bei manueller Installation. Siehe auch WeeWX Doku.

[StdRESTful]

    [[CWOP]]
        # This section is for configuring posts to CWOP.

        # If you wish to do this, set the option 'enable' to true,
        # and specify the station ID (e.g., CW1234).
        enable = true
        station = MYCALL-15

        # If this is an APRS (radio amateur) station, uncomment
        # the following and replace with a passcode (e.g., 12345).
        #passcode = 12345
        server_list = 127.0.0.1:1234, rotate.aprs2.net:14580
        log_success = true
        log_failure = true

• "enable" muss auf "true" geändert werden.
• Unter "station" gibt man das eigene Rufzeichen mit SSID an, unter dem die Wetterstation die Daten veröffentlichen soll.
• Einen Passcode muss man für is2axudp.py nicht zwingend eintragen (von is2axudp.py wird es ignoriert). Es wird aber empfohlen falls es einen Fallback auf einen anderen APRS-Server gibt (z.B. is2axudp.py beendet sich), dann verbindet sich WeeWX wie in diesem Beispiel mit dem nächsten gelisteten Server "rotate.aprs2.net".
• Unter server_list gibt man IP-Adresse:Port des TCP Servers an, wo is2axudp.py läuft. Es ist empfehlenswert is2axudp direkt auf dem selben Rechner (127.0.0.1) wie WeeWX laufen zu lassen. Es kann aber auch wo anders laufen. Es können mit Kommas getrennt mehrere Server eingetragen werden. Sobald einer nicht erreichbar ist, wird der nächste angewählt.
• log_success und log_failure sind nicht zwingend notwendig, hinterlassen aber einen Eintrag in /var/log/syslog ob erfolgreich oder nicht übermittelt wurde.

Direkte lokale Aussendung am gleichen Standort

Wenn die Wetterdaten vom gleichen Standort wie die Wetterstaton abgestrahlt wird, kann das Skript mit nur kleinen Anpassungen verwendet werden. Es sind lediglich bei Bedarf ein abweichender TCP Port einzutragen (Standard = 1234) sowie das AXUDP-Ziel (IP-Adresse und Port). Das Paket wird dann 1:1 ausgesendet.

Änderungen am Skript:

TCP Port Eingang falls anders gewünscht (Standard = 1234):

serversocket.bind(("0.0.0.0", 1234))

AXUDP Ausgang (Standard = IP 127.0.0.1 und Port 9032):

sendax(data,("127.0.0.1",9032),{})

Auf Port 9032 muss dann der Sender "hören", z.B. udpflex mit einem angeschlossenen TNC. Beispielkonfiguration von udpflex:

udpflex -t /dev/ttyUSB0:38400 -k -d 5000 -p 1:15 -p 2:255 -p 3:10 -p 128:0 -U 127.0.0.1:0:9032 -u -V

Aussendung nach dem Durchlaufen des Skripts:

DL1NUX-14>APRS:@182025z5013.81N/01059.43E_000/002g004t035r001p009P009b10250h81.weewx-4.2.0-FineOffsetUSB

Das Paket kann von allen Stationen in HF-Reichweite gelesen werden. Wenn ein iGate unter den Empfängern ist, erscheint die Aussendung auch auf aprs.fi & Co. Möchte man, dass das Paket ggf. noch digipeatet wird, muss man noch den APRS-Pfad durch einen WIDE-Pfad erweitern, z.B. WIDE1-1. Dies geschieht recht einfach im "replace" Abschnitt der is2axudp.py. Anstatt dass ",TCPIP*" durch "nichts" ersetzt wird (quasi entfernt), kann man auch einen anderen Wert einfügen. Es muss aber immer ein "," (Komma - ohne Anführungszeichen) dem Pfad vorangestellt werden.

Original:

data = data.replace(b',TCPIP*',b'')

Änderung mit WIDE1-1 Pfad:

data = data.replace(b',TCPIP*',b',WIDE1-1')

Aussendung mit WIDE1-1:

DL1NUX-14>APRS,WIDE1-1:@182025z5013.81N/01059.43E_000/002g004t035r001p009P009b10250h81.weewx-4.2.0-FineOffsetUSB

Aussendung an einem entfernten Standort

Wenn man die Daten der Wetterstation nicht am gleichen Standort sondern entfernt abstrahlen möchte, z.B. beim nächsten Digipeater, muss ein wenig mehr beachtet werden.

• Die Pakete der Wetterstation sollten nicht "direkt" eins-zu-eins ausgesendet werden.
• Heißt die Wetterstation z.B. DL1NUX-14 und der Digi DB0NU-10, würde eine eins-zu-eins Abstrahlung allen Empfänger der Aussendung vortäuschen, dass DL1NUX-14 direkt empfangen wurde. Das stimmt aber nicht, da sich DL1NUX-14 gar nicht am Standort von DB0NU befindet. Das "Relais" würde quasi mit dem "falschen Rufzeichen" seine Aussendung machen.
• Korrekter wäre es, wenn der APRS-Digipeater die Aussendung auch als gedigipeatertes Paket abstrahlen würde. Also so, als wenn DB0NU-10 DL1NUX-14 über HF empfangen hätte und nun digipeaten würde.

Beispiel:

Folgendes Paket wird durch is2axudp.py empfangen:

DL1NUX-14>APRS,TCPIP*:@182205z5013.81N/01059.43E_341/002g006t035r001p011P011b10242h81.weewx-4.2.0-FineOffsetUSB

Das Paket wird von is2axudp.py in AXUDP umgewandelt und es wird ein WIDE1-1 Pfad angehängt:

DL1NUX-14>APRS,WIDE1-1:@182205z5013.81N/01059.43E_341/002g006t035r001p011P011b10242h81.weewx-4.2.0-FineOffsetUSB

Paket wird wie folgt von DB0NU-10 auf HF abgestrahlt:

DL1NUX-14>APRS,DB0NU-10*:@182205z5013.81N/01059.43E_341/002g006t035r001p011P011b10242h81.weewx-4.2.0-FineOffsetUSB

Was passiert in diesem Beispiel und welche Bedeutung hat es?

1. Wie oben beschrieben wird das von WeeWX empfangene Paket empfangen und der String ",TCPIP*" wird entfernt.
2. Als Pfad wird WIDE1-1 angehängt (String = ",WIDE1-1"), damit der Digipeater (udpbox) weiß, dass er es digipeaten soll.
3. Anschließend wird das Paket im AXUDP Format an den Digipeater gesandt.
4. Der Digipeater udpbox "empfängt" das Paket über AXUDP, erkennt anhand des "WIDE1-1" dass es das Paket digipeaten soll.
5. Das Paket wird von DB0NU-10 abgestrahlt und korrekterweise das H-Bit "*" an das eigene Call angehängt. Dadurch weiß jede Station, die das Paket empfängt, dass die Aussendung indirekt von DB0NU-10 stammt, und nicht direkt von DL1NUX-14. Das WIDE1-1 wird in diesem Fall entfernt, da der Hop aus WIDE1-1 "verbraucht" ist.
6. Würde man wollen, dass noch weitere Digis das Paket digipeaten sollen, kann man auch das WIDE erweitern auf WIDE2-2, oder WIDE1-1,WIDE2-1 usw. Es ist jede Kombination denkbar. Hierbei sollte man aber sparsam sein. Es sollte maximal bis zum nächsten iGate "getragen" werden. Um es weiter digipeaten zu können, muss der Digipeater bei der udpbox mindestens die Digipeater-Parameter -p4,6 haben, sonst wird der Pfad ggf. abgeschnitten und/oder gänzlich ignoriert.

Das eigentliche Digipeating übernimmt die udpbox. Dazu gibt es mehrere technische Lösungen:

Senden des AXUDP Paketes an den Listen-Port des vorhandenen Digipeaters

• Der udpbox Digipeater kann entweder nur auf einer Quell-IP hören (z.B. 127.0.0.1) oder auf alle (0.0.0.0).
• Auf alle IPs zu hören ist unsicher, das könnte missbraucht werden.
• Auch wenn man is2axudp.py, udpflex und [[udpbox] auf dem selben Rechner laufen lässt, ist es gefährlich. Der TCP Server könnte ebenfalls mit fremden Daten gespeist werden, die dann zur Aussendung kommen.
• Aber Achtung: Wer weiß dass dort ein TCP-Server läuft, könnte auch auch diesem Weg Daten direkt an is2axudp.py zuführen.
• Diese Variante ist also eher nicht zu empfehlen, egal wie, da zu Risikoreich.

Beispiel am Digi mit allen drei Programmen auf dem selben Rechner

TNC KISS Verbindung:  
udpflex -t /dev/ttyUSB0:38400 -k -d 5000 -p 1:15 -p 2:255 -p 3:10 -p 128:0 -U 127.0.0.1:9001:9032 -u -V

Digipeater:
udpbox -R 0.0.0.0:9001 -l 127.0.0.1:9101 -d DB0XYZ-10 -p 0,1,2,4,5,6,7,8,9 -t 1740,28 -f p28,29,33,35-39,41-43,46,47,58,59,61,64,91,95,96,123 -k 0/0/20000 -b 600:/home/pi/dxlAPRS/aprs/digibeacon.txt -x APLWS*,NOCALL -l 127.0.0.1:9032 -v

is2axudp:
AXUDP Ziel = IP 127.0.0.1 Port 9001

Erklärung:

• Das TNC empfängt auf UDP 9032 alle Daten (listen port) die es Aussenden soll und sendet seine empfangenen Daten an UDP 9001 (destination port) am gleichen Rechner.
• Die RX Chain UDP 9001 wird in der udpbox nach UDP 9101 kopiert zum iGate udpgate4 ...
• ... dann wird der Digipeater DB0XYZ-10 akiviert mit diversen Filteroptionen und einer HF-Bake ...
• ... und anschließend wird das, was durch den Digipeater gelaufen ist und "hinten raus" kommt an UDP 9032 gesendet - das ist der Port wo der TNC seine auszusendenden Daten erhält.
• Die Daten von WeeWX werden über TCP in is2axudp.py eingespielt, in AXUDP umgewandelt und das WIDEx-y eingefügt, und anschließend an den lokalen Port 9001 gesendet, wo sie von der udpbox gehört, weiterverarbeitet und digipeatet werden. Das Paket landet dann wie alle anderen zu digipeatenden Pakete auf Port 9032, also beim TNC.

Senden des AXUDP Paketes an eine eigene Chain im vorhandenen udpbox

• Man ergänzt die vorhandene udpbox um eine weitere Chain für für die Übermittlung der Daten von der einen Wetterstation und setzt alle Digipeating-Optionen nach Wunsch erneut.
• Der Vorteil daran ist, dass Daten nur von dieser einen Gegenstelle angenommen werden. Ein Mißbrauch ist unwahrscheinlich.
• Außerdem kann man bei Bedarf mit zusätzlichen Filtereinstellungen am Digi in der udpbox weitereren möglichen Mißbrauch einschränken.

Senden des AXUDP Paketes an eine zusätzliche Instanz von udpbox

• Die udpbox kann auch als zusätzlicher Prozess gestartet werden, auch mit dem selben Call wie im anderen Prozess.