Ra02

Über ra02

ra02 ist ein Tool zum Ansteuern von LoRa Chips wie dem Semtech SX1278 für die Nutzung als LoRa APRS Gateway (RX und TX). Es sendet und empfängt Pakete in AXUDP und kann somit mit den restlichen Tools wie udpbox oder [[udpgate4]} zusammenarbeiten.

Wichtig:

• ra02 benötigt derzeit am RaspberryPi root Rechte und muss dadurch mit sudo aufgerufen werden.
• SPI muss auf dem RaspberryPi deaktiviert sein. Ggf. kontrollieren über raspi-config oder in der GUI.
• Die Sendeparameter (QRG, TX PWR etc.) müssen immer VOR dem -L gesetzt werden

Funktionsumfang:

• ra02 ist in der Lage mehrere LoRa chips parallel anzusteuern

Parameter in der Kurzübersicht

 ra-02 (sx127x) via LPT or GPIO to axudp by oe5dxl
 -a                 AGC on
 -b <n>             bandwidth khz 0:7.8 1:10.4 2:15.6 3:20.8 4:31.25 5:41.7 6:62.5 7:125 8:250 9:500 (7)
 -c <cr>            coding rate 5..8 (5)
 -d <time>          do not send while DCD (on tx sf/bw) limit time, 0=do not test for dcd
                      timebase is detection duration, some ms see chip manual
 -F <netid>         pass only rx packets with this network id (sync word) (off)
 -f <mhz>           MHz (433.775)
 -g <n>             lna gain 6..1, 1 is maximum gain! see chip manual(1)
 -H <n>             Preample length +4 by default (4)
 -h                 this
 -L ip:sendport:listenport AXUDPv2 data, set tx relevant parameters before
                      repeat for more tx contexts with different listen ports
                      parameters entered after last -L are for rx
                      rx data is sent to all non zero sendports
 -l <n>             lna boost 0..3, more better ip3 by more supply current (3)
 -n <netid>         tx network id (sync word) (not use 34=lorawan) (12)
 -O <n>             set overcurrent protection, use with care, see chip manual
 -o <offon>         low datarate optimize -1=auto 0=off 1=on else automatic (-1)
 -P <ppm>           x-tal correction +-128 (0.0
 -p <nss> <mosi> <miso> <sck>  GPIO numbers (8 10 9 11)
 -s <sf>            spread factor 6..12 (12)
 -R <n>             PaRamp how fast tx goes to power, see chip manual (9)
 -r <n>             add to rssi value to compensate internal and external preamps (0)
 -U ip:sendport:receiveport AXUDP data (no metadata) see -L
 -V                 show more infos on stdout
 -v                 show some infos on stdout
 -w <dBm>           tx power 0..17 (10)

ra02 -d 2000 -r -15 -f 433.775 -w 10 -L 127.0.0.1:9000:9001 -v
ra02 -p 8 10 9 11 -P -4.4 -d 2000 -r -15 -s 8 -b 6 -f 434.1 -w 10 -L 127.0.0.1:0:2401 -s 12 -b 7 -f 433.775 -w 15 -L 127.0.0.1:2300:2400 -v

Parameter ausführlich erklärt

Parameter	Beschreibung
a	AGC ein
b <n>	Bandbreite in KHz 0:7.8 1:10.4 2:15.6 3:20.8 4:31.25 5:41.7 6:62.5 7:125 8:250 9:500 (Standard = 7 = 125 KHz)
c <cr>	coding rate 5..8 (5)
d <time>	do not send while DCD (on tx sf/bw) limit time, 0=do not test for dcd. timebase is detection duration, some ms see chip manual.
F <netid>	pass only rx packets with this network id (sync word) (off)
f <mhz>	Sende-/Empfangsfrequenz in MHz (Standard = 433.775)
g <n>	Empfangsverstörkung 6..1. 1 ist die Maxcimalverstärkung. Siehe auch Chip-Manual (Standard = 1)
H <n>	Preample length +4 by default (4)
h	Hilfetext
L ip:sendport:listenport	AXUDPv2 data, set tx relevant parameters before repeat for more tx contexts with different listen ports. parameters entered after last -L are for rx.
l <n>	lna boost 0..3, more better ip3 by more supply current (3)
n <netid>	tx network id (sync word) (not use 34=lorawan) (12)
O <n>	set overcurrent protection, use with care, see chip manual
o <offon>	low datarate optimize -1=auto 0=off 1=on else automatic (-1)
P <ppm>	Korrektur des TCXO in ppm +-128 (Standard = 0.0)
p <nss> <mosi> <miso> <sck>	GPIO Nummern der NSS, MOSI, MISO und SCK Verbindung (Standard = 8 10 9 11)
s <sf>	LoRa Spreadfactor (Spreizfaktor) 6..12 (Standard = 12)
R <n>	PaRamp how fast tx goes to power, see chip manual (9)
r <n>	add to rssi value to compensate internal and external preamps (0)
U ip:sendport:receiveport	AXUDP Daten ohne Metadaten wie TXD, AFC usw. (siehe auch -L)
V	Zeige mehr Informationen in der Bildschirmausgabe.
v	Zeige Informationen in der Bildschirmausgabe.
w <dBm>	Sendeleistung in dBm 0..17 (Standard = 10)

Konfigurationsbeispiele

Aufruf für ein reines RX-only iGate

ra02 -p 8 10 9 11 -a -L 127.0.0.1:9001:0 -v

• -p definiert die 4 benötigten GPIO Ports an denen die vier wichtigen Datenleitungen angschlossen sind (nss, mosi, miso, sck). 8, 10, 9 und 11 sind dei Standard-GPIOs der bekannten LoRa HATs.
• -a schaltet die AGC an
• -L sendet AXUDP Daten der empfangenen Pakete an Port 9001. Zu sendende Pakete sind nicht vorgesehen.
• -v zeigt Informationen in der Bildschirmausgabe an, z.B. empfangene Pakete (optional).

An Port 9001 kann dann z.B. eine udpbox oder das udpgate4 lauschen.

Aufruf für ein RX/TX iGate

ra02 -p 8 10 9 11 -w 18 -a -L 127.0.0.1:9001:9002 -v

• -p definiert die 4 benötigten GPIO Ports an denen die vier wichtigen Datenleitungen angschlossen sind (nss, mosi, miso, sck). 8, 10, 9 und 11 sind die Standard-GPIOs der bekannten LoRa HATs.
• -a schaltet die AGC an
• -L sendet AXUDP Daten der empfangenen Pakete an Port 9001 und hört auf Port 9002 auf zu sendende Pakete.
• -w Modul sendet mit voller Sendeleistung.
• -v zeigt Informationen in der Bildschirmausgabe an, z.B. empfangene Pakete (optional).

An Port 9001 kann dann z.B. eine udpbox oder das udpgate4 lauschen. Zu sendende Pakete, z.B. vom Digi in udpbox oder aus dem APRS-IS (z.B. Nachrichten oder APRS-IS>RF Infos), müssen dann an Port 9002 geschickt werden.