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 seit der version vom 7.11.2011 keine root Rechte bzw. udev Regeln mehr!!!
• 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 (derzeit noch experimentell!!)

Installation

ra02 ist seit Sommer 2022 offiziell in den Paketen und Quellen verfügbar und wird bei der Grundinstallation von dxlAPRS mit installiert.

Parameter in der Kurzübersicht

 ra-02 (sx127x) via LPT or multiple chips via GPIO to axudp by oe5dxl
 -A                 tx AFSK 1200 Baud
 -a                 AGC on
 -B <n>             tx 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)
 -b <n>             rx bandwidth (7)
 -C <cr>            tx coding rate 5..8 (5)
 -c <cr>            rx coding rate 5..8 (5)
 -D <Hz>            (a)fsk deviation +-Hz (3000)
 -d                 do not send while DCD on this band or if dcd on tx sf/bw)
                      timebase is detection duration, some ms see chip manual
 -E                 Send UDP frame unmodified in FSK up to 1500Byte eg. for POCSAG
 -F <MHz>           tx MHz (433.775)
 -f <MHz>           rx MHz (433.775)
 -G [-]<baud>       Send GFSK <baud> -baud same but g3ruh scrambler off (490..250000)
 -g <n>             lna gain 6..1, 1 is maximum gain! see chip manual(1)
 -H <n>             Preample length (8) sx seems to need minimum 4
 -h                 this
 -I                 tx implicit header on
 -i                 rx implicit header on
 -L ip:sendport:listenport AXUDPv2 data, apply before all othere parameters for this channel
                      repeat for more tx contexts with different listen ports
                      same rx data are sent to all non zero sendports
 -l <n>             lna boost 0..3, more for better ip3 by more supply current (3)
 -n <netid>         network id (sync word) (not use 34=lorawan) (12)
 -I <n>             set overcurrent protection, use with care, see chip manual
 -O <offon>         tx low datarate optimize 0=off 1=on else automatic (-1)
 -o <offon>         rx low datarate optimize 0=off 1=on else automatic (-1)
 -P <ppm>           x-tal correction +-128 (0.0)
 -p <nss> <mosi> <miso> <sck>  GPIO numbers, apply before all parameter to this chip
                      repeat for more chips (8 10 9 11)
                      with different <nss> pins. Sharing <miso> needs <nss> high
                      on not configed chips by pullup or setting <nss> manual
 -S <sf>            tx spread factor 6..12 (12)
 -s <sf>            rx 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)
 -T <n>             (A)FSK txdel in byte (4), not used for raw mode -E
 -U ip:sendport:receiveport AXUDP data, same as -L but standard AXUDP (no metadata)
 -u <us> <us>       sleep time betrween divice polls rx/(a)fsk tx, more:faster response, more cpu (50000 20000)
                      afsk needs 20000 or less to avoid underruns
 -V                 show more infos on stdout
 -v                 show some infos on stdout
 -w <dBm>           tx power 0..17 (10)

ra02 -L 127.0.0.1:9000:9001 -d -r -10 -f 433.775 -w 17 -v
ra02 -p 8 10 9 11 -L 127.0.0.1:2400:2401 -P -2 -d -S 9 -B 6 -F 434.1 -f 433.775 -s 12 -b 7 -L 127.0.0.1:0:2400 -v
ra02 -P <gpio/chip1> -L ... <parameters chip1 tx1/rx> -L <parameters chip1 tx2> ... -P <gpio/chip2> -L ... <parameters chip2 tx1/rx> -L ... -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 <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). 1W Module haben noch eine PA dahinter und werden ebenfalls mit den niedrigen Werten angesprochen.

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 17 -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 17 Modul sendet mit voller (17 dBm) 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.

Tutorials

LoRa APRS iGate mit dxlAPRS und ra02 auf einem RaspberryPi