Udpflex

Funktion von udpflex

udpflex fungiert als Schnittstelle zwischen bekannten Protokollen wie KISS, SMACK oder TCP-KISS und dem AXUDP Protokoll der dxlAPRS Tools. Es können dadurch Programme wie udpbox, udpgate4 oder APRSMAP mit vorhandenen Geräten (z.B. TNCs) oder Programmen (Direwolf, APRX usw.) betrieben werden.

Parameter in der Kurzübersicht

udpflex -h

bidirectional AXUDP <-> KISS/SMACK(tty/com/pipe) or TCP-KISS(dire-wolf) Interface

 -A                                ASCII (TAPR) Mode
 -a                                automatic switch to KISS/FLEX/SMACK mode
                                   (only with 1 Port)
 -d <ms>                           delay between kiss-on and sending -p ...(2500)
 -h                                this
 -i <filename>                     send this file to tty to switch on kiss
 -k                                tnc2 tf switch on kiss
 -p <cmd>:<value>                  tnc2 parameter 1=txd, 2=p 3=slottime,
                                   128:0=set smack, 255:13 kiss exit
                                   (add 16, 32 ... to cmd for next Port)
                                   repeat -p for more parameters
 -r                                use rmnc-crc
 -s                                SMACK (crc) on
 -t <tty>:<baud>                   /dev/ttyS0:9600 or Pipe Filename
 -T [ip]:[port]                    TCP-KISS -T 127.0.0.1:8001 (default)
                                   local dire-wolf soundmodem -T :
 -T 0.0.0.0:<tcpport>              listen on <tcp port> for TCP-KISS connect
 -U <x.x.x.x:destport:listenport>  axudp "ip:destport/listenport" to check ipnum
                                   (repeat for more Ports)
 -u                                retry until (re)pluged (USB) tty
                                   and on kiss error reinitialize kiss mode
 -v                                verbous error messages
 -V                                verbous errors and monitor data to stdout

Parameter ausführlich erklärt

Parameter	Beschreibung
A	Aktiviert den ASCII/TAPR Modus für kompatible TAPR TNCs
a	Automatisches Umschalten zum KISS, SMACK oder FLEX(-KISS) Modus (nur mit einem Port möglich)
d <ms>	Verzögerung zwischen dem Aktivieren des KISS Modus bis zum senden der Parameter mit -p. Standardwert = 2500 ms
h	Kurzer Hilfetext
i <Dateiname>	Sende die Datei <Dateiname> an die Schnittstelle um KISS zu aktivieren
k	Schaltet ein TNC mit TF Firmware in den KISS Modus
p <cmd>:<value>	Beispiel
r	Verwende RMNC-CRC
s	SMACK mit CRC einschalten
t <tty>:<baud>	Name der Schnittstelle und die Übertraungsrate in Baud, z.B. /dev/ttyS0:9600. Alternativ kann auch der Dateiname einer Pipe angegeben werden.
T [ip]:[port]	Lausche nach einer KISS-Verbindung von <IP> auf Port [port]. Standardwert ist -T 127.0.0.1:8001. Dies lauscht am selben Gerät auf Port 8001 (Direwolf Standard).
U <x.x.x.x:destport:listenport>	AXUDP Verbindung zu udpbox, udpgate4, aprsmap usw. Kann beliebig wiederholt werden bei mehreren AXUDP Verbindungen. Beispiel: -U 127.0.0.1:5001:5002.
u	Wiederhole Verbindungsaufbau bei Verbindungstrennung zum Gerät, z.B. USB Stecker gezogen. Bei KISS Fehlern wird der KISS-Modus neu initialisiert.
v	Ausgabe von Informationen auf dem Bildschirm
V	Ausgabe von erweiterten Informationen auf dem Bildschirm

Konfigurationsbeispiele

Anbindung eines TNCs an einem Digi

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:9002 -u 

• Benutzt die Schnittstelle /dev/ttyUSB0 mit einer Geschwindigkeit von 38400 Baud (z.B. TNC2multi an einem USB/RS232 Wandlerkabel).
• k Schaltet das TNC von TF Modus in den Kiss Modus.
• d wartet etwa 5 Sekunden nach KISS Aktivierung zum senden der TNC Parameter.
• p Parameter als Beispiel: TXdelay=150ms, Persistence=255, Slottime=10, aktiviere SMACK Modus (mit CRC)
• AXUDP Schnittstelle befindet sich am gleichen Rechner. Destinationport = 9001, Listenport = 9002. Dies bedeutet, empfangene Daten werden an Port 9001 gesendet (z.B. zu udpgate4), zu sendende Daten werden auf Port 9002 "angenommen" (z.B. von udpbox (Digipeating) oder udpgate4 (APRS-IS Aussendungen uns APRS-Nachrichten)).
• u sorgt dafür, dass die Verbindung neu aufgebaut wird, wenn die USB Verbindung gertennt werden sollte.

Mithören des Monitors

Wenn man ein iGate abgesetzt betreibt und darauf Zugriff an (z.B. über Hamnet oder Internet), kann man udpflex auch nutzen, um den AX25 Monitor, also die gerade empfangenen Daten, remote mitzulesen, beispielweise über SSH. Dazu sendet man die empfangenen Daten zuerst an udpbox.

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:9002 -u 

udpbox erlaubt es den Datenstrom zu vervielfachen und an mehrere Ports weiterzusenden. Beipsielsweise übergibt hier udpflex die empfangenen Daten an Port 9001. Normalerweise würde das iGate udpgate4 die Daten auf Port 9001 empfangen und ins APRS Netzwerk weiterleiten. Hier schaltet man udpbox dazwischen.

udpbox -R 127.0.0.1:9001 -r 127.0.0.1:9101 -r 127.0.0.1:9201 ... 

udpbox empfängt die Daten auf Port 9001 und leitet diese weiter an Port 9101 und zusätzlich (zum Beispiel) an Port 9201. Auf Port 9101 muss dann udpgate4 hören, das leitet die empfangenen Daten weiter ins APRS Netzwerk.

udpgate4 -s MYCALL-10 -R 127.0.0.1:9002:9101 ...

Übrig bleiben nun die Daten auf Port 9201. An diesen Port docken wir nun udpflex an.

udpflex -U :0:9201 -V

Damit können wir diese Daten in der Konsole "sichtbar" machen. -U lässt auf Port 9201 lauschen. Der Destinationport bleibt auf "0", da wir ja nichts zum senden haben. Eine IP-Adresse müssen wir nicht angeben, da wir uns auf dem selben Rechner befinden und dann standardmäßig 127.0.0.1 angenommen wird. Das -V zeigt dann die ausführlichen Monitordaten am Bildschirm lesbar an. Auf dem Rechner lege ich mir dazu

pi@raspberry:~/dxlAPRS/aprs $ ./udpflex -U :0:9201 -V
send init to tnc
UDP0:fm DB0ERF-10 to APRS via DB0RIE* WIDE1-1 ctl UIv1 pid F0
}DO2HEY-15>APMI04,TCPIP,DB0ERF-10*::DO2HEY-15:UNIT.Volt,Pkt,Pkt,Pcnt,None,On,On,On,On,Hi,Hi,Hi,Hi
UDP0:fm DB0ERF-10 to APRS via DB0RIE* WIDE1-1 ctl UIv1 pid F0
}DO2HEY-15>APMI04,TCPIP,DB0ERF-10*::DO2HEY-15:EQNS.0,0.079,0,0,10,0,0,10,0,0,1,0,0,0,0
UDP0:fm DB0ERF-10 to APRS via DB0RIE DB0FGB* ctl UIv1 pid F0
}DO2HEY-15>APMI04,TCPIP,DB0ERF-10*::DO2HEY-15:EQNS.0,0.079,0,0,10,0,0,10,0,0,1,0,0,0,0
UDP0:fm DB0NU-10 to APNL51 ctl UI^ pid F0
}DO8TBO-1>APN000,TCPIP,DB0NU-10*:=5006.16N\01058.67E-360/000OV B37 Timm 73!.... 144.800MHz 13.9V
UDP0:fm DM8WP-9 to UP4Y58 via DM0RLB-10 DB0REN WIDE1 WIDE2* ctl UIv1 pid F0
`(8:q\e>/"6z}145.500MHz / Patrick direkt or Relais

Man kann so also aus der Ferne live mitlesen was so auf der QRG passiert, als wenn man direkt vor Ort wäre.