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

Installation

ra02 ist derzeit in Entwicklung und liegt derzeit nur als kompilierte Version für ARM7 (RaspberryPi & CO) vor:

wget http://oe5dxl.hamspirit.at:8025/tmp/ra02
chmod 755 ra02

Parameter in der Kurzübersicht

Stand: 07.11.2021

  one ra-02 (sx127x) via LPT or more via 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                 do not send while DCD on this band or if dcd on tx sf/bw)
                      timebase is detection duration, some ms see chip manual
 -f <MHz>           MHz (433.775)
 -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
 -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 for better ip3 by more supply current (3)
 -n <netid>         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, 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>            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, same as -L but standard AXUDP (no metadata)
 -V                 show more infos on stdout
 -v                 show some infos on stdout
 -w <dBm>           tx power 0..17 (10)

ra02 -d 200 -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 200 -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 <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.