Original files from https://github.com/tomelec/RPi-LoRa-KISS-TNC
parent
b031cb23dd
commit
d7d52900c7
13 changed files with 1768 additions and 2 deletions
@ -0,0 +1,237 @@ |
|||||||
|
#!/usr/bin/python |
||||||
|
# -*- coding: utf-8 -*- |
||||||
|
from __future__ import print_function |
||||||
|
|
||||||
|
RECV_BUFFER_LENGTH = 1024 |
||||||
|
|
||||||
|
from threading import Thread |
||||||
|
import socket |
||||||
|
from KissHelper import SerialParser |
||||||
|
from array import array |
||||||
|
|
||||||
|
|
||||||
|
CRCTAB = array("H",[ |
||||||
|
61560,57841,54122,49891,46684,42965,38222,33991,31792,28089,24354,20139,14868,11165,6406,2191, |
||||||
|
57593,61808,50155,53858,42717,46932,34255,37958,27825,32056,20387,24106,10901,15132,2439,6158, |
||||||
|
53626,49395,62056,58337,38750,34519,46156,42437,23858,19643,32288,28585,6934,2719,14340,10637, |
||||||
|
49659,53362,58089,62304,34783,38486,42189,46404,19891,23610,28321,32552,2967,6686,10373,14604, |
||||||
|
45692,41973,37230,32999,62552,58833,55114,50883,15924,12221,7462,3247,30736,27033,23298,19083, |
||||||
|
41725,45940,33263,36966,58585,62800,51147,54850,11957,16188,3495,7214,26769,31000,19331,23050, |
||||||
|
37758,33527,45164,41445,54618,50387,63048,59329,7990,3775,15396,11693,22802,18587,31232,27529, |
||||||
|
33791,37494,41197,45412,50651,54354,59081,63296,4023,7742,11429,15660,18835,22554,27265,31496, |
||||||
|
29808,26105,22370,18155,12884,9181,4422,207,63544,59825,56106,51875,48668,44949,40206,35975, |
||||||
|
25841,30072,18403,22122,8917,13148,455,4174,59577,63792,52139,55842,44701,48916,36239,39942, |
||||||
|
21874,17659,30304,26601,4950,735,12356,8653,55610,51379,64040,60321,40734,36503,48140,44421, |
||||||
|
17907,21626,26337,30568,983,4702,8389,12620,51643,55346,60073,64288,36767,40470,44173,48388, |
||||||
|
13940,10237,5478,1263,28752,25049,21314,17099,47676,43957,39214,34983,64536,60817,57098,52867, |
||||||
|
9973,14204,1511,5230,24785,29016,17347,21066,43709,47924,35247,38950,60569,64784,53131,56834, |
||||||
|
6006,1791,13412,9709,20818,16603,29248,25545,39742,35511,47148,43429,56602,52371,65032,61313, |
||||||
|
2039,5758,9445,13676,16851,20570,25281,29512,35775,39478,43181,47396,52635,56338,61065,65280 |
||||||
|
]) |
||||||
|
|
||||||
|
def logf(message): |
||||||
|
import sys |
||||||
|
print(message, file=sys.stderr) |
||||||
|
|
||||||
|
|
||||||
|
class AXUDPServer(Thread): |
||||||
|
'''AXUDP Server to communicate with the digipeater''' |
||||||
|
|
||||||
|
txQueue = None |
||||||
|
|
||||||
|
# host and port as configured in aprx/aprx.conf.lora-aprs < interface > section |
||||||
|
def __init__(self, txQueue, localHost="127.0.0.1", localPort=10001, remoteHost="127.0.0.1", remotePort="20000"): |
||||||
|
Thread.__init__(self) |
||||||
|
self.socket = socket.socket(socket.AF_INET, socket.SOCK_DGRAM) |
||||||
|
self.socket.bind((localHost, localPort)) |
||||||
|
self.remoteHost=remoteHost |
||||||
|
self.remotePort=remotePort |
||||||
|
self.data = str() |
||||||
|
self.txQueue = txQueue |
||||||
|
|
||||||
|
def run(self): |
||||||
|
while True: |
||||||
|
frame = self.socket.recv(RECV_BUFFER_LENGTH) |
||||||
|
print("TX:",self.axtostr(frame)) |
||||||
|
self.txQueue.put(self.axtostr(frame).encode('utf-8'), block=False) |
||||||
|
|
||||||
|
def __del__(self): |
||||||
|
self.socket.shutdown() |
||||||
|
|
||||||
|
def send(self, data, metadata): |
||||||
|
self.sendax(data, (self.remoteHost, self.remotePort), metadata) |
||||||
|
#self.socket.sendall(data) |
||||||
|
|
||||||
|
def axcall(self, text, pos): |
||||||
|
l=len(text) |
||||||
|
a="" |
||||||
|
print(text) |
||||||
|
while (pos<l) and (len(a)<6) and ((text[pos]>=ord("0")) and (text[pos]<=ord("9")) or (text[pos]>=ord("A")) and (text[pos]<=ord("Z"))): |
||||||
|
a+=chr(text[pos]<<1) |
||||||
|
pos+=1 |
||||||
|
while len(a)<6: a+=chr(ord(" ")<<1) #fill with spaces |
||||||
|
ssid=0 |
||||||
|
if (pos<l) and (text[pos]==ord("-")): |
||||||
|
pos+=1 |
||||||
|
if (pos<l) and (text[pos]>=ord("0")) and (text[pos]<=ord("9")): |
||||||
|
ssid+=text[pos]-ord("0") |
||||||
|
pos+=1 |
||||||
|
if (pos<l) and (text[pos]>=ord("0")) and (text[pos]<=ord("9")): |
||||||
|
ssid=ssid*10 + text[pos]-ord("0") |
||||||
|
pos+=1 |
||||||
|
if ssid>15: ssid=15 |
||||||
|
ssid=(ssid+48)<<1 |
||||||
|
if (pos<l) and (text[pos]==ord("*")): |
||||||
|
ssid|=0x80 |
||||||
|
pos+=1 |
||||||
|
a+=chr(ssid) |
||||||
|
return a, pos |
||||||
|
|
||||||
|
|
||||||
|
def udpcrc(self, frame, topos): |
||||||
|
c=0 |
||||||
|
for p in range(topos): c = (c >> 8) ^ CRCTAB[(ord(frame[p]) ^ c) & 0xff] |
||||||
|
return c |
||||||
|
def sendax(self, text, ip, values=False): |
||||||
|
a,p=self.axcall(text, 0) #src call |
||||||
|
if (p>=len(text)) or (text[p]!=ord(">")): |
||||||
|
print("fehler 1") |
||||||
|
return |
||||||
|
ax,p=self.axcall(text, p+1) #dest call |
||||||
|
ax+=a |
||||||
|
hbit=0 |
||||||
|
while True: #via calls |
||||||
|
if p>=len(text): |
||||||
|
print("found no end of address") |
||||||
|
return #found no end of address |
||||||
|
if text[p]==ord(":"): break #end of address field |
||||||
|
if text[p]!=ord(","): |
||||||
|
print("via path error") |
||||||
|
return #via path error |
||||||
|
if len(ax)>=70: |
||||||
|
print("too many via calls") |
||||||
|
return #too many via calls |
||||||
|
a,p=self.axcall(text, p+1) |
||||||
|
ax+=a |
||||||
|
hp=len(ax)-1 |
||||||
|
if (ord(ax[hp]) & 0x80)!=0: hbit=hp #store last h-bit |
||||||
|
p+=1 |
||||||
|
a="" |
||||||
|
|
||||||
|
if values: |
||||||
|
a="\x01\x30" #axudp v2 start |
||||||
|
|
||||||
|
if 'level' in values.keys(): |
||||||
|
v=values["level"] |
||||||
|
a+="V"+str(round(v))+" " #axudp v2 append level |
||||||
|
|
||||||
|
if 'quality' in values.keys(): |
||||||
|
v=values["quality"] |
||||||
|
a+="Q"+str(round(v))+" " #axudp v2 append quality |
||||||
|
|
||||||
|
if 'txdel' in values.keys(): |
||||||
|
v=values["txdel"] |
||||||
|
a+="T"+str(round(v))+" " #axudp v2 append quality |
||||||
|
|
||||||
|
if 'snr' in values.keys(): |
||||||
|
v=values["snr"] |
||||||
|
a+="S"+str(round(v))+" " #axudp v2 append snr |
||||||
|
|
||||||
|
a+="\x00" #axudp2 end |
||||||
|
|
||||||
|
i=0 |
||||||
|
for i in range(len(ax)): |
||||||
|
ch=ord(ax[i]) |
||||||
|
if (i%7==6) and (i>=20) and (i<hbit): ch|=0x80 #set h-bit on all via calls before |
||||||
|
if i+1==len(ax): ch|=1 #set ent of address bit |
||||||
|
a+=chr(ch) |
||||||
|
a+="\x03\xf0" #ui frame pid F0 |
||||||
|
i=0 |
||||||
|
while p<len(text) and i < 256: #append payload |
||||||
|
a+=chr(text[p]) |
||||||
|
p+=1 |
||||||
|
i+=1 #max 256bytes |
||||||
|
#for ch in b: print(hex(ord(ch))) |
||||||
|
sock=socket.socket(socket.AF_INET,socket.SOCK_DGRAM) |
||||||
|
c=self.udpcrc(a, len(a)) |
||||||
|
a+=chr(c & 0xff) |
||||||
|
a+=chr(c>>8) |
||||||
|
sa=array("B",[0]*len(a)) |
||||||
|
for i in range(0,len(a)): sa[i]=ord(a[i]) |
||||||
|
print(sa) |
||||||
|
print(ip) |
||||||
|
res=sock.sendto(sa, ip) |
||||||
|
|
||||||
|
## RX: |
||||||
|
def callstr(self, b, p): |
||||||
|
s="" |
||||||
|
for i in range(6): |
||||||
|
ch=ord(b[p+i])>>1 |
||||||
|
if ch<32: s+="^" #show forbidden ctrl in call |
||||||
|
elif ch>32:s+=chr(ch) #call is filled with blanks |
||||||
|
ssid=(ord(b[p+6])>>1) & 0x0f |
||||||
|
if ssid: s+="-"+str(ssid) |
||||||
|
return s |
||||||
|
def axtostr(self, axbuf): |
||||||
|
b="" |
||||||
|
for x in axbuf: |
||||||
|
b+=chr(x) |
||||||
|
le=len(b) |
||||||
|
if le<2: |
||||||
|
return "" |
||||||
|
le-=2 |
||||||
|
c=self.udpcrc(b, le) |
||||||
|
if (b[le]!=chr(c & 0xff)) or (b[le+1]!=chr(c>>8)): |
||||||
|
return "" #crc error |
||||||
|
|
||||||
|
i=0 |
||||||
|
if axbuf[0]==1: #axudp v2 |
||||||
|
while (i<len(axbuf)) and (axbuf[i]!=0): i+=1 |
||||||
|
i+=1 |
||||||
|
b="" |
||||||
|
while i<len(axbuf): |
||||||
|
b+=chr(axbuf[i]) |
||||||
|
i+=1 |
||||||
|
s="" |
||||||
|
le=len(b) |
||||||
|
if le>=18: #2 calls + ctrl + pid + crc |
||||||
|
le-=2 |
||||||
|
s=self.callstr(b, 7) #src call |
||||||
|
s+=">"+self.callstr(b, 0) #destination call |
||||||
|
p=14 |
||||||
|
hbit=False |
||||||
|
while (((not (ord(b[p-1]) & 1)))) and (p+6<le): #via path |
||||||
|
if ord(b[p+6])>=128: |
||||||
|
hbit=True |
||||||
|
elif hbit: #call before had hbit |
||||||
|
s+="*" |
||||||
|
hbit=False |
||||||
|
s+=","+callstr(b, p) |
||||||
|
p+=7 |
||||||
|
if hbit: s+="*" #last call had hbit |
||||||
|
p+=2 #pid, ctrl |
||||||
|
s+=":" |
||||||
|
while p<le: #payload may contain ctrl characters |
||||||
|
s+=b[p] |
||||||
|
p+=1 |
||||||
|
return s |
||||||
|
if __name__ == '__main__': |
||||||
|
'''Test program''' |
||||||
|
import time |
||||||
|
from multiprocessing import Queue |
||||||
|
|
||||||
|
TCP_HOST = "0.0.0.0" |
||||||
|
TCP_PORT = 10001 |
||||||
|
|
||||||
|
# frames to be sent go here |
||||||
|
KissQueue = Queue() |
||||||
|
|
||||||
|
server = AXUDPServer(TCP_HOST, TCP_PORT, KissQueue) |
||||||
|
server.setDaemon(True) |
||||||
|
server.start() |
||||||
|
|
||||||
|
while True: |
||||||
|
server.send( |
||||||
|
"\xc0\x00\x82\xa0\xa4\xa6@@`\x9e\x8ar\xa8\x96\x90q\x03\xf0!4725.51N/00939.86E[322/002/A=001306 Batt=3.99V\xc0") |
||||||
|
data = KissQueue.get() |
||||||
|
print("Received KISS frame:" + repr(data)) |
||||||
@ -0,0 +1,76 @@ |
|||||||
|
# Installation and running the RPi-LoRa-Gateway |
||||||
|
|
||||||
|
## Install needed packages |
||||||
|
` |
||||||
|
sudo apt install python3 python3-rpi.gpio python3-spidev aprx screen git python3-pil python3-smbus |
||||||
|
` |
||||||
|
|
||||||
|
## Checkout the code |
||||||
|
Enter following commands:<br/> |
||||||
|
``` |
||||||
|
cd |
||||||
|
git clone https://github.com/tomelec/RPi-LoRa-KISS-TNC.git |
||||||
|
cd RPi-LoRa-KISS-TNC |
||||||
|
git clone https://github.com/mayeranalytics/pySX127x.git |
||||||
|
``` |
||||||
|
to change into homedirectory and then checkout the code and the LoRa Chip-Driver in the right directory. |
||||||
|
|
||||||
|
## Configuration |
||||||
|
Afterwards configure as following: |
||||||
|
### Edit aprx/aprx.conf.lora-aprs file |
||||||
|
Type: |
||||||
|
``` |
||||||
|
cd |
||||||
|
cd RPi-LoRa-KISS-TNC |
||||||
|
sudo cp aprx/aprx.conf.lora-aprs /etc/aprx.conf |
||||||
|
pico -w /etc/aprx.conf |
||||||
|
``` |
||||||
|
to copy and then open the config file. |
||||||
|
|
||||||
|
The most important settings are: |
||||||
|
* **mycall**<br/> |
||||||
|
Your call with an apropriate SSID suffix<br/>[Paper on SSID's from aprs.org](http://www.aprs.org/aprs11/SSIDs.txt) |
||||||
|
* **myloc**<br/> |
||||||
|
NMEA lat/lon form: |
||||||
|
``` |
||||||
|
lat ddmm.mmN lon dddmm.mmE |
||||||
|
``` |
||||||
|
Example: |
||||||
|
``` |
||||||
|
lat 4812.52N lon 01622.39E |
||||||
|
``` |
||||||
|
(simplest way to find the right coordinats for this? Go to [aprs.fi](http://www.aprs.fi) on your location right-click and choose "Add marker" then click on the marker and you should see your coordinates in the NMEA style - enter this infos without any symbols into the config file as seen in the example above) |
||||||
|
|
||||||
|
|
||||||
|
* **passcode**<br/> |
||||||
|
see [see here to generate appropiate setting](https://apps.magicbug.co.uk/passcode/) |
||||||
|
* **server**<br/> |
||||||
|
either leave the default server or if you're connected to Hamnet as well insert an APRSIS Server within the hamnet - a List of Aprs Hamnet servers can be found in the [OEVSV Wiki](http://wiki.oevsv.at/index.php/Anwendungen_am_HAMNET#APRS_Server)) |
||||||
|
|
||||||
|
|
||||||
|
to save and close the file do: |
||||||
|
`Strg + x` -> Y -> Enter |
||||||
|
|
||||||
|
### Edit driver config file |
||||||
|
Type |
||||||
|
``` |
||||||
|
pico -w pySX127x/SX127x/board_config.py |
||||||
|
``` |
||||||
|
change in line 36 |
||||||
|
from |
||||||
|
``` |
||||||
|
DIO0 = 22 # RaspPi GPIO 22 |
||||||
|
DIO0 = 5 # RaspPi GPIO 5 |
||||||
|
``` |
||||||
|
to fix the SPI connection #todo how can we config this from outside? |
||||||
|
|
||||||
|
## Start the LoRa KISS TNC and aprx server instance |
||||||
|
``` |
||||||
|
python3 Start_lora-tnc.py & |
||||||
|
sudo aprx |
||||||
|
``` |
||||||
|
|
||||||
|
## Stop the server's |
||||||
|
``` |
||||||
|
sudo killall aprx python3 |
||||||
|
``` |
||||||
@ -0,0 +1,220 @@ |
|||||||
|
# This program is free software: you can redistribute it and/or modify |
||||||
|
# it under the terms of the GNU General Public License as published by |
||||||
|
# the Free Software Foundation, either version 3 of the License, or |
||||||
|
# (at your option) any later version. |
||||||
|
# |
||||||
|
# This program is distributed in the hope that it will be useful, |
||||||
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of |
||||||
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
||||||
|
# GNU General Public License for more details. |
||||||
|
# |
||||||
|
# You should have received a copy of the GNU General Public License |
||||||
|
# along with this program. If not, see <http://www.gnu.org/licenses/>. |
||||||
|
|
||||||
|
|
||||||
|
# This program provides basic KISS AX.25 APRS frame encoding and decoding. |
||||||
|
# Note that only APRS relevant structures are tested. It might not work |
||||||
|
# for generic AX.25 frames. |
||||||
|
# 11/2019 by Thomas Kottek, OE9TKH |
||||||
|
# |
||||||
|
# Inspired by: |
||||||
|
# * Python script to decode AX.25 from KISS frames over a serial TNC |
||||||
|
# https://gist.github.com/mumrah/8fe7597edde50855211e27192cce9f88 |
||||||
|
# |
||||||
|
# * Sending a raw AX.25 frame with Python |
||||||
|
# https://thomask.sdf.org/blog/2018/12/15/sending-raw-ax25-python.html |
||||||
|
# |
||||||
|
# TODO: remove escapes on decoding |
||||||
|
|
||||||
|
import struct |
||||||
|
|
||||||
|
KISS_FEND = 0xC0 # Frame start/end marker |
||||||
|
KISS_FESC = 0xDB # Escape character |
||||||
|
KISS_TFEND = 0xDC # If after an escape, means there was an 0xC0 in the source message |
||||||
|
KISS_TFESC = 0xDD # If after an escape, means there was an 0xDB in the source message |
||||||
|
|
||||||
|
|
||||||
|
# Addresses must be 6 bytes plus the SSID byte, each character shifted left by 1 |
||||||
|
# If it's the final address in the header, set the low bit to 1 |
||||||
|
# Ignoring command/response for simple example |
||||||
|
def encode_address(s, final): |
||||||
|
if b"-" not in s: |
||||||
|
s = s + b"-0" # default to SSID 0 |
||||||
|
call, ssid = s.split(b'-') |
||||||
|
if len(call) < 6: |
||||||
|
call = call + b" "*(6 - len(call)) # pad with spaces |
||||||
|
encoded_call = [x << 1 for x in call[0:6]] |
||||||
|
encoded_ssid = (int(ssid) << 1) | 0b01100000 | (0b00000001 if final else 0) |
||||||
|
return encoded_call + [encoded_ssid] |
||||||
|
|
||||||
|
|
||||||
|
def decode_address(data, cursor): |
||||||
|
(a1, a2, a3, a4, a5, a6, a7) = struct.unpack("<BBBBBBB", data[cursor:cursor + 7]) |
||||||
|
hrr = a7 >> 5 |
||||||
|
ssid = (a7 >> 1) & 0xf |
||||||
|
ext = a7 & 0x1 |
||||||
|
addr = struct.pack("<BBBBBB", a1 >> 1, a2 >> 1, a3 >> 1, a4 >> 1, a5 >> 1, a6 >> 1) |
||||||
|
if ssid != 0: |
||||||
|
call = addr.strip() + "-{}".format(ssid).encode() |
||||||
|
else: |
||||||
|
call = addr |
||||||
|
return (call, hrr, ext) |
||||||
|
|
||||||
|
|
||||||
|
def encode_kiss(frame): |
||||||
|
# Ugly frame disassembling |
||||||
|
if not b":" in frame: |
||||||
|
return None |
||||||
|
path = frame.split(b":")[0] |
||||||
|
src_addr = path.split(b">")[0] |
||||||
|
digis = path[path.find(b">") + 1:].split(b",") |
||||||
|
# destination address |
||||||
|
packet = encode_address(digis.pop(0).upper(), False) |
||||||
|
# source address |
||||||
|
packet += encode_address(path.split(b">")[0].upper(), len(digis) == 0) |
||||||
|
# digipeaters |
||||||
|
for digi in digis: |
||||||
|
final_addr = digis.index(digi) == len(digis) - 1 |
||||||
|
packet += encode_address(digi.upper(), final_addr) |
||||||
|
# control field |
||||||
|
packet += [0x03] # This is an UI frame |
||||||
|
# protocol ID |
||||||
|
packet += [0xF0] # No protocol |
||||||
|
# information field |
||||||
|
packet += frame[frame.find(b":") + 1:] |
||||||
|
|
||||||
|
# Escape the packet in case either KISS_FEND or KISS_FESC ended up in our stream |
||||||
|
packet_escaped = [] |
||||||
|
for x in packet: |
||||||
|
if x == KISS_FEND: |
||||||
|
packet_escaped += [KISS_FESC, KISS_TFEND] |
||||||
|
elif x == KISS_FESC: |
||||||
|
packet_escaped += [KISS_FESC, KISS_TFESC] |
||||||
|
else: |
||||||
|
packet_escaped += [x] |
||||||
|
|
||||||
|
# Build the frame that we will send to Dire Wolf and turn it into a string |
||||||
|
kiss_cmd = 0x00 # Two nybbles combined - TNC 0, command 0 (send data) |
||||||
|
kiss_frame = [KISS_FEND, kiss_cmd] + packet_escaped + [KISS_FEND] |
||||||
|
try: |
||||||
|
output = bytearray(kiss_frame) |
||||||
|
except ValueError: |
||||||
|
print("Invalid value in frame.") |
||||||
|
return None |
||||||
|
return output |
||||||
|
|
||||||
|
|
||||||
|
def decode_kiss(frame): |
||||||
|
result = b"" |
||||||
|
pos = 0 |
||||||
|
if frame[pos] != 0xC0 or frame[len(frame) - 1] != 0xC0: |
||||||
|
print(frame[pos], frame[len(frame) - 1]) |
||||||
|
return None |
||||||
|
pos += 1 |
||||||
|
pos += 1 |
||||||
|
|
||||||
|
# DST |
||||||
|
(dest_addr, dest_hrr, dest_ext) = decode_address(frame, pos) |
||||||
|
pos += 7 |
||||||
|
# print("DST: ", dest_addr) |
||||||
|
|
||||||
|
# SRC |
||||||
|
(src_addr, src_hrr, src_ext) = decode_address(frame, pos) |
||||||
|
pos += 7 |
||||||
|
# print("SRC: ", src_addr) |
||||||
|
|
||||||
|
result += src_addr.strip() |
||||||
|
# print(type(result), type(dest_addr.strip())) |
||||||
|
result += b">" + dest_addr.strip() |
||||||
|
|
||||||
|
# REPEATERS |
||||||
|
ext = src_ext |
||||||
|
while ext == 0: |
||||||
|
rpt_addr, rpt_hrr, ext = decode_address(frame, pos) |
||||||
|
# print("RPT: ", rpt_addr) |
||||||
|
pos += 7 |
||||||
|
result += b"," + rpt_addr.strip() |
||||||
|
|
||||||
|
result += b":" |
||||||
|
|
||||||
|
# CTRL |
||||||
|
# (ctrl,) = struct.unpack("<B", frame[pos]) |
||||||
|
ctrl = frame[pos] |
||||||
|
pos += 1 |
||||||
|
if (ctrl & 0x3) == 0x3: |
||||||
|
#(pid,) = struct.unpack("<B", frame[pos]) |
||||||
|
pid = frame[pos] |
||||||
|
# print("PID="+str(pid)) |
||||||
|
pos += 1 |
||||||
|
result += frame[pos:len(frame) - 1] |
||||||
|
elif (ctrl & 0x3) == 0x1: |
||||||
|
# decode_sframe(ctrl, frame, pos) |
||||||
|
print("SFRAME") |
||||||
|
return None |
||||||
|
elif (ctrl & 0x1) == 0x0: |
||||||
|
# decode_iframe(ctrl, frame, pos) |
||||||
|
print("IFRAME") |
||||||
|
return None |
||||||
|
|
||||||
|
return result |
||||||
|
|
||||||
|
|
||||||
|
class SerialParser(): |
||||||
|
'''Simple parser for KISS frames. It handles multiple frames in one packet |
||||||
|
and calls the callback function on each frame''' |
||||||
|
STATE_IDLE = 0 |
||||||
|
STATE_FEND = 1 |
||||||
|
STATE_DATA = 2 |
||||||
|
KISS_FEND = KISS_FEND |
||||||
|
|
||||||
|
def __init__(self, frame_cb=None): |
||||||
|
self.frame_cb = frame_cb |
||||||
|
self.reset() |
||||||
|
|
||||||
|
def reset(self): |
||||||
|
self.state = self.STATE_IDLE |
||||||
|
self.cur_frame = bytearray() |
||||||
|
|
||||||
|
def parse(self, data): |
||||||
|
'''Call parse with a string of one or more characters''' |
||||||
|
for c in data: |
||||||
|
if self.state == self.STATE_IDLE: |
||||||
|
if c == self.KISS_FEND: |
||||||
|
self.cur_frame.append(c) |
||||||
|
self.state = self.STATE_FEND |
||||||
|
elif self.state == self.STATE_FEND: |
||||||
|
if c == self.KISS_FEND: |
||||||
|
self.reset() |
||||||
|
else: |
||||||
|
self.cur_frame.append(c) |
||||||
|
self.state = self.STATE_DATA |
||||||
|
elif self.state == self.STATE_DATA: |
||||||
|
self.cur_frame.append(c) |
||||||
|
if c == self.KISS_FEND: |
||||||
|
# frame complete |
||||||
|
if self.frame_cb: |
||||||
|
self.frame_cb(self.cur_frame) |
||||||
|
self.reset() |
||||||
|
|
||||||
|
|
||||||
|
if __name__ == "__main__": |
||||||
|
# Playground for testing |
||||||
|
|
||||||
|
# frame = "\xc0\x00\x82\xa0\xa4\xb0dr`\x9e\x8ar\xa8\x96\x90u\x03\xf0!4725.73NR00939.61E&Experimental LoRa iGate\xc0" |
||||||
|
frame = "\xc0\x00\x82\xa0\xa4\xa6@@`\x9e\x8ar\xa8\x96\x90q\x03\xf0!4725.51N/00939.86E[322/002/A=001306 Batt=3.99V\xc0" |
||||||
|
|
||||||
|
|
||||||
|
# print(decode_kiss(frame)) |
||||||
|
# encoded = encode_kiss("OE9TKH-8>APRS,RELAY,BLA:!4725.51N/00939.86E[322/002/A=001306 Batt=3") |
||||||
|
# encoded = encode_kiss("OE9TKH-8>APRS,digi-3,digi-2:!4725.51N/00939.86E[322/002/A=001306 Batt=3") |
||||||
|
# print((decode_kiss(encoded))) |
||||||
|
|
||||||
|
# print((decode_kiss("\xc0\x00\x82\xa0\xa4\xa6@@`\x9e\x8ar\xa8\x96\x90t\xae\x92\x88\x8ab@\x03\x03\xf0}OE9GHV-10>APMI06,TCPIP,OE9TKH-10*:@110104z4726.55N/00950.63E&WX3in1 op. Holger U=14.2V,T=8.8C\xc0"))) |
||||||
|
|
||||||
|
def newframe(frame): |
||||||
|
print(repr(frame)) |
||||||
|
|
||||||
|
|
||||||
|
two_example_frames = "\xc0\x00\x82\xa0\xa4\xa6@@`\x9e\x8ar\xa8\x96\x90u\x03\xf0}SOTA>APZS16,TCPIP,OE9TKH-10*::OE9TKH-8 :<Ass/Ref> <Freq> <Mode> [call] [comment]{7ba\xc0\xc0\x00\x82\xa0\xa4\xa6@@`\x9e\x8ar\xa8\x96\x90u\x03\xf0}SOTA>APZS16,TCPIP,OE9TKH-10*::OE9TKH-8 :/mylast{7bb\xc0\xc0\x00\x82\xa0\xa4\xa6@@`\x9e\x8ar\xa8\x96\x90u\x03\xf0}SOTA>APZS16,TCPIP,OE9TKH-10*::OE9TKH-8 :/last{7bc\xc0\xc0\x00\x82\xa0\xa4\xa6@@`\x9e\x8ar\xa8\x96\x90u\x03\xf0}SOTA>APZS16,TCPIP,OE9TKH-10*::OE9TKH-8 :/time(/zone){7bd\xc0" |
||||||
|
sp = SerialParser(newframe) |
||||||
|
sp.parse(two_example_frames) |
||||||
@ -0,0 +1,140 @@ |
|||||||
|
#!/usr/bin/python |
||||||
|
# -*- coding: utf-8 -*- |
||||||
|
|
||||||
|
# This program is free software: you can redistribute it and/or modify |
||||||
|
# it under the terms of the GNU General Public License as published by |
||||||
|
# the Free Software Foundation, either version 3 of the License, or |
||||||
|
# (at your option) any later version. |
||||||
|
# |
||||||
|
# This program is distributed in the hope that it will be useful, |
||||||
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of |
||||||
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
||||||
|
# GNU General Public License for more details. |
||||||
|
# |
||||||
|
# You should have received a copy of the GNU General Public License |
||||||
|
# along with this program. If not, see <http://www.gnu.org/licenses/>. |
||||||
|
|
||||||
|
import sys |
||||||
|
from asyncio import QueueEmpty |
||||||
|
import traceback |
||||||
|
sys.path.insert(0, './pySX127x/') |
||||||
|
from pySX127x.SX127x.LoRa import LoRa |
||||||
|
from pySX127x.SX127x.constants import * |
||||||
|
from pySX127x.SX127x.board_config import BOARD |
||||||
|
import time |
||||||
|
#import KissHelper |
||||||
|
|
||||||
|
|
||||||
|
class LoraAprsKissTnc(LoRa): |
||||||
|
LORA_APRS_HEADER = b"<\xff\x01" |
||||||
|
|
||||||
|
# APRS data types |
||||||
|
DATA_TYPES_POSITION = b"!'/@`" |
||||||
|
DATA_TYPE_MESSAGE = b":" |
||||||
|
DATA_TYPE_THIRD_PARTY = b"}" |
||||||
|
|
||||||
|
queue = None |
||||||
|
server = None |
||||||
|
|
||||||
|
# init has LoRa APRS default config settings - might be initialized different when creating object with parameters |
||||||
|
def __init__(self, queue, server, frequency=433.775, preamble=8, spreadingFactor=12, bandwidth=BW.BW125, |
||||||
|
codingrate=CODING_RATE.CR4_5, appendSignalReport = True, paSelect = 1, outputPower = 15, verbose=False): |
||||||
|
# Init SX127x |
||||||
|
BOARD.setup() |
||||||
|
|
||||||
|
super(LoraAprsKissTnc, self).__init__(verbose) |
||||||
|
self.queue = queue |
||||||
|
self.appendSignalReport = appendSignalReport |
||||||
|
|
||||||
|
self.set_mode(MODE.SLEEP) |
||||||
|
|
||||||
|
self.set_freq(frequency) |
||||||
|
self.set_preamble(preamble) |
||||||
|
self.set_spreading_factor(spreadingFactor) |
||||||
|
self.set_bw(bandwidth) |
||||||
|
self.set_low_data_rate_optim(True) |
||||||
|
self.set_coding_rate(codingrate) |
||||||
|
self.set_ocp_trim(100) |
||||||
|
|
||||||
|
self.set_pa_config(paSelect, outputPower) |
||||||
|
self.set_max_payload_length(255) |
||||||
|
self.set_dio_mapping([0] * 6) |
||||||
|
self.server = server |
||||||
|
|
||||||
|
self.reset_ptr_rx() |
||||||
|
self.set_mode(MODE.RXCONT) |
||||||
|
|
||||||
|
def startListening(self): |
||||||
|
try: |
||||||
|
while True: |
||||||
|
# only transmit if no signal is detected to avoid collisions |
||||||
|
if not self.get_modem_status()["signal_detected"]: |
||||||
|
# print("RSSI: %idBm" % lora.get_rssi_value()) |
||||||
|
# FIXME: Add noise floor measurement for telemetry |
||||||
|
if not self.queue.empty(): |
||||||
|
try: |
||||||
|
data = self.queue.get(block=False) |
||||||
|
if self.aprs_data_type(data) == self.DATA_TYPE_THIRD_PARTY: |
||||||
|
# remove third party thing |
||||||
|
data = data[data.find(self.DATA_TYPE_THIRD_PARTY) + 1:] |
||||||
|
data = self.LORA_APRS_HEADER + data |
||||||
|
print("LoRa TX: " + repr(data)) |
||||||
|
self.transmit(data) |
||||||
|
except QueueEmpty: |
||||||
|
pass |
||||||
|
|
||||||
|
time.sleep(0.50) |
||||||
|
except KeyboardInterrupt: |
||||||
|
BOARD.teardown() |
||||||
|
|
||||||
|
def on_rx_done(self): |
||||||
|
payload = self.read_payload(nocheck=True) |
||||||
|
if not payload: |
||||||
|
print("No Payload!") |
||||||
|
return |
||||||
|
rssi = self.get_pkt_rssi_value() |
||||||
|
snr = self.get_pkt_snr_value() |
||||||
|
data = bytes(payload) |
||||||
|
print("LoRa RX[%idBm/%idB, %ibytes]: %s" %(rssi, snr, len(data), repr(data))) |
||||||
|
|
||||||
|
flags = self.get_irq_flags() |
||||||
|
if any([flags[s] for s in ['crc_error', 'rx_timeout']]): |
||||||
|
print("Receive Error, discarding frame.") |
||||||
|
# print(self.get_irq_flags()) |
||||||
|
self.clear_irq_flags(RxDone=1, PayloadCrcError=1, RxTimeout=1) # clear rxdone IRQ flag |
||||||
|
self.reset_ptr_rx() |
||||||
|
self.set_mode(MODE.RXCONT) |
||||||
|
return |
||||||
|
|
||||||
|
if self.server: |
||||||
|
# remove LoRa-APRS header if present |
||||||
|
if data[0:len(self.LORA_APRS_HEADER)] == self.LORA_APRS_HEADER: |
||||||
|
data = data[len(self.LORA_APRS_HEADER):] |
||||||
|
if self.appendSignalReport: |
||||||
|
# Signal report only for certain frames, not messages! |
||||||
|
if self.aprs_data_type(data) in self.DATA_TYPES_POSITION: |
||||||
|
data += b" RSSI=%idBm SNR=%idB" % (rssi, snr) |
||||||
|
self.server.send(data, {"level":rssi, "snr":snr}) |
||||||
|
self.clear_irq_flags(RxDone=1) # clear rxdone IRQ flag |
||||||
|
self.reset_ptr_rx() |
||||||
|
self.set_mode(MODE.RXCONT) |
||||||
|
|
||||||
|
# self.set_mode(MODE.CAD) |
||||||
|
|
||||||
|
def on_tx_done(self): |
||||||
|
print("TX DONE") |
||||||
|
self.clear_irq_flags(TxDone=1) # clear txdone IRQ flag |
||||||
|
self.set_dio_mapping([0] * 6) |
||||||
|
self.set_mode(MODE.RXCONT) |
||||||
|
|
||||||
|
def transmit(self, data): |
||||||
|
self.write_payload([c for c in data]) |
||||||
|
self.set_dio_mapping([1, 0, 0, 0, 0, 0]) |
||||||
|
self.set_mode(MODE.TX) |
||||||
|
|
||||||
|
def aprs_data_type(self, lora_aprs_frame): |
||||||
|
delimiter_position = lora_aprs_frame.find(b":") |
||||||
|
try: |
||||||
|
return lora_aprs_frame[delimiter_position + 1] |
||||||
|
except IndexError: |
||||||
|
return "" |
||||||
@ -1,3 +1,32 @@ |
|||||||
# RPi-LoRa-KISS-TNC |
# Raspberry Pi LoRa KISS TNC |
||||||
|
|
||||||
Custom version of https://github.com/tomelec/RPi-LoRa-KISS-TNC |
This project emulates a KISS TNC and controls a hardware LoRa transceiver |
||||||
|
connected to the Raspberry´s SPI. That makes it possible to use existing |
||||||
|
software, like digipeaters, with LoRa radio communication. The KISS TNC is |
||||||
|
accessed via its TCP server. |
||||||
|
|
||||||
|
The current application is to run the KISS TNC together with the APRS digi [APRX](https://github.com/PhirePhly/aprx), which connects via TCP and provides |
||||||
|
powerful APRS digipeating and I-gate functionality for LoRa-APRS. |
||||||
|
|
||||||
|
## Hardware |
||||||
|
|
||||||
|
The LoRa KISS TNC runs on Raspberry Pi 2 or newer together with the |
||||||
|
*LoRa APRS Gateway Hat V2.0*. However, RFM98W oder RFM96W LoRa modules can |
||||||
|
be wired up to the Raspberry Pi directly aswell. See the |
||||||
|
[schematic](doc/LoRaAPRS-GW-RPI_V20_Schematic.pdf) for details. |
||||||
|
|
||||||
|
 |
||||||
|
|
||||||
|
## Development |
||||||
|
|
||||||
|
This program and documentation is in a very early state and very experimental. |
||||||
|
Only the LoRa radio modem of the gateway board is supported at the moment. |
||||||
|
Display and buttons are not working. |
||||||
|
|
||||||
|
### To Do |
||||||
|
* Python 3 compatibility |
||||||
|
* Get display and buttons working |
||||||
|
* Noise floor telemetry |
||||||
|
* Installation guide and documentation |
||||||
|
* Proper configuration file |
||||||
|
* ... |
||||||
|
|||||||
@ -0,0 +1,41 @@ |
|||||||
|
#!/usr/bin/python3 |
||||||
|
# -*- coding: utf-8 -*- |
||||||
|
|
||||||
|
# This program is free software: you can redistribute it and/or modify |
||||||
|
# it under the terms of the GNU General Public License as published by |
||||||
|
# the Free Software Foundation, either version 3 of the License, or |
||||||
|
# (at your option) any later version. |
||||||
|
# |
||||||
|
# This program is distributed in the hope that it will be useful, |
||||||
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of |
||||||
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
||||||
|
# GNU General Public License for more details. |
||||||
|
# |
||||||
|
# You should have received a copy of the GNU General Public License |
||||||
|
# along with this program. If not, see <http://www.gnu.org/licenses/>. |
||||||
|
# |
||||||
|
# Usage: python3 Start_lora-tnc.py |
||||||
|
# |
||||||
|
from queue import Queue |
||||||
|
from TCPServer import KissServer |
||||||
|
from AXUDPServer import AXUDPServer |
||||||
|
import config |
||||||
|
from LoraAprsKissTnc import LoraAprsKissTnc |
||||||
|
|
||||||
|
# TX KISS frames go here (Digipeater -> TNC) |
||||||
|
kissQueue = Queue() |
||||||
|
|
||||||
|
# KISSTCP or AXUDP Server for the digipeater to connect |
||||||
|
if config.USE_AXUDP: |
||||||
|
server = AXUDPServer(kissQueue, config.AXUDP_LOCAL_IP, config.AXUDP_LOCAL_PORT, config.AXUDP_REMOTE_IP, config.AXUDP_REMOTE_PORT) |
||||||
|
else: |
||||||
|
server = KissServer(kissQueue, config.TCP_HOST, config.TCP_PORT) |
||||||
|
|
||||||
|
server.setDaemon(True) |
||||||
|
server.start() |
||||||
|
|
||||||
|
# LoRa transceiver instance |
||||||
|
lora = LoraAprsKissTnc(kissQueue, server, verbose=False, appendSignalReport = config.APPEND_SIGNAL_REPORT) |
||||||
|
|
||||||
|
# this call loops forever inside |
||||||
|
lora.startListening() |
||||||
@ -0,0 +1,94 @@ |
|||||||
|
#!/usr/bin/python |
||||||
|
# -*- coding: utf-8 -*- |
||||||
|
from __future__ import print_function |
||||||
|
|
||||||
|
RECV_BUFFER_LENGTH = 1024 |
||||||
|
import sys |
||||||
|
from threading import Thread |
||||||
|
import socket |
||||||
|
from KissHelper import SerialParser |
||||||
|
import KissHelper |
||||||
|
|
||||||
|
|
||||||
|
def logf(message): |
||||||
|
print(message, file=sys.stderr) |
||||||
|
|
||||||
|
|
||||||
|
class KissServer(Thread): |
||||||
|
'''TCP Server to be connected by the APRS digipeater''' |
||||||
|
|
||||||
|
txQueue = None |
||||||
|
|
||||||
|
# host and port as configured in aprx/aprx.conf.lora-aprs < interface > section |
||||||
|
def __init__(self, txQueue, host="127.0.0.1", port=10001): |
||||||
|
Thread.__init__(self) |
||||||
|
self.socket = socket.socket(socket.AF_INET, socket.SOCK_STREAM) |
||||||
|
self.socket.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1) |
||||||
|
self.socket.bind((host, port)) |
||||||
|
self.socket.listen(1) |
||||||
|
self.data = str() |
||||||
|
self.txQueue = txQueue |
||||||
|
self.connection = None |
||||||
|
|
||||||
|
def run(self): |
||||||
|
parser = SerialParser(self.queue_frame) |
||||||
|
while True: |
||||||
|
self.connection = None |
||||||
|
self.connection, client_address = self.socket.accept() |
||||||
|
parser.reset() |
||||||
|
logf("KISS-Server: Connection from %s" % client_address[0]) |
||||||
|
while True: |
||||||
|
data = self.connection.recv(RECV_BUFFER_LENGTH) |
||||||
|
if data: |
||||||
|
parser.parse(data) |
||||||
|
else: |
||||||
|
self.connection.close() |
||||||
|
break |
||||||
|
|
||||||
|
def queue_frame(self, frame): |
||||||
|
print("KISS frame:", repr(frame)) |
||||||
|
decoded_data = KissHelper.decode_kiss(frame) |
||||||
|
print("Decoded:", decoded_data) |
||||||
|
|
||||||
|
self.txQueue.put(decoded_data, block=False) |
||||||
|
|
||||||
|
def __del__(self): |
||||||
|
self.socket.shutdown() |
||||||
|
|
||||||
|
def send(self, data, metadata): |
||||||
|
try: |
||||||
|
encoded_data = KissHelper.encode_kiss(data) |
||||||
|
except Exception as e: |
||||||
|
print("KISS encoding went wrong (exception while parsing)") |
||||||
|
traceback.print_tb(e.__traceback__) |
||||||
|
encoded_data = None |
||||||
|
|
||||||
|
if encoded_data != None: |
||||||
|
print("To Server: " + repr(encoded_data)) |
||||||
|
if self.connection: |
||||||
|
self.connection.sendall(encoded_data) |
||||||
|
else: |
||||||
|
print("KISS encoding went wrong") |
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
if __name__ == '__main__': |
||||||
|
'''Test program''' |
||||||
|
import time |
||||||
|
from multiprocessing import Queue |
||||||
|
|
||||||
|
TCP_HOST = "0.0.0.0" |
||||||
|
TCP_PORT = 10001 |
||||||
|
|
||||||
|
# frames to be sent go here |
||||||
|
KissQueue = Queue() |
||||||
|
|
||||||
|
server = KissServer(TCP_HOST, TCP_PORT, KissQueue) |
||||||
|
server.setDaemon(True) |
||||||
|
server.start() |
||||||
|
|
||||||
|
while True: |
||||||
|
server.send( |
||||||
|
"\xc0\x00\x82\xa0\xa4\xa6@@`\x9e\x8ar\xa8\x96\x90q\x03\xf0!4725.51N/00939.86E[322/002/A=001306 Batt=3.99V\xc0") |
||||||
|
data = KissQueue.get() |
||||||
|
print("Received KISS frame:" + repr(data)) |
||||||
@ -0,0 +1,440 @@ |
|||||||
|
# |
||||||
|
# Simple sample configuration file for the APRX-2 -- an APRS iGate and Digipeater |
||||||
|
# |
||||||
|
# This configuration is structured with Apache HTTPD style tags |
||||||
|
# which then contain subsystem parameters. |
||||||
|
# |
||||||
|
|
||||||
|
# |
||||||
|
# For simple case, you need to adjust 4 things: |
||||||
|
# - Mycall parameter |
||||||
|
# - passcode parameter in APRS-IS configuration |
||||||
|
# - Select correct type of interface (ax25-device or serial-device) |
||||||
|
# - Optionally set a beacon telling where this system is |
||||||
|
# - Optionally enable digipeater with or without tx-igate |
||||||
|
# |
||||||
|
|
||||||
|
# |
||||||
|
# |
||||||
|
# Define the parameters in following order: |
||||||
|
# 1) <aprsis> ** zero or one |
||||||
|
# 2) <logging> ** zero or one |
||||||
|
# 3) <interface> ** there can be multiple! |
||||||
|
# 4) <beacon> ** zero to many |
||||||
|
# 5) <telemetry> ** zero to many |
||||||
|
# 6) <digipeater> ** zero to many (at most one for each Tx) |
||||||
|
# |
||||||
|
|
||||||
|
# |
||||||
|
# Global macro for simplified callsign definition: |
||||||
|
# Usable for 99+% of cases. |
||||||
|
# |
||||||
|
|
||||||
|
mycall N0CALL-1 |
||||||
|
|
||||||
|
# |
||||||
|
# Global macro for simplified "my location" definition in |
||||||
|
# place of explicit "lat nn lon mm" at beacons. Will also |
||||||
|
# give "my location" reference for "filter m/100". |
||||||
|
# |
||||||
|
#myloc lat ddmm.mmN lon dddmm.mmE |
||||||
|
|
||||||
|
<aprsis> |
||||||
|
# The aprsis login parameter: |
||||||
|
# Station callsignSSID used for relaying APRS frames into APRS-IS. |
||||||
|
# Use this only to define other callsign for APRS\-IS login. |
||||||
|
# |
||||||
|
#login OTHERCALL-7 # login defaults to $mycall |
||||||
|
|
||||||
|
# |
||||||
|
# Passcode for your callsign: |
||||||
|
# Unique code for your callsign to allow transmitting packets |
||||||
|
# into the APRS-IS. |
||||||
|
# |
||||||
|
passcode -1 |
||||||
|
|
||||||
|
# APRS-IS server name and optional portnumber. |
||||||
|
# |
||||||
|
# WARNING: Do not change from default port number [14580] |
||||||
|
# unless you are absolutely certain you want |
||||||
|
# something else, and you allow that something |
||||||
|
# else also affect your tx-igate behaviour! |
||||||
|
# |
||||||
|
server rotate.aprs2.net |
||||||
|
#server euro.aprs2.net |
||||||
|
#server asia.aprs2.net |
||||||
|
#server noam.aprs2.net |
||||||
|
#server soam.aprs2.net |
||||||
|
#server aunz.aprs2.net |
||||||
|
|
||||||
|
# Some APRS-IS servers tell every about 20 seconds to all contact |
||||||
|
# ports that they are there and alive. Others are just silent. |
||||||
|
# Default value is 3*"heartbeat" + some --> 120 (seconds) |
||||||
|
# |
||||||
|
#heartbeat-timeout 0 # Disabler of heartbeat timeout |
||||||
|
|
||||||
|
# APRS-IS server may support some filter commands. |
||||||
|
# See: http://www.aprs-is.net/javAPRSFilter.aspx |
||||||
|
# |
||||||
|
# You can define the filter as single long quoted string, or as |
||||||
|
# many short segments with explaining comments following them. |
||||||
|
# |
||||||
|
# Usability of these filters for a Tx-iGate is dubious, but |
||||||
|
# they exist in case you for example want to Tx-iGate packets |
||||||
|
# from some source callsigns in all cases even when they are |
||||||
|
# not in your local area. |
||||||
|
# |
||||||
|
#filter "possibly multiple filter specs in quotes" |
||||||
|
# |
||||||
|
#filter "m/100" # My-Range filter: positions within 100 km from my location |
||||||
|
#filter "f/OH2XYZ-3/50" # Friend-Range filter: 50 km of friend's last beacon position |
||||||
|
</aprsis> |
||||||
|
|
||||||
|
<logging> |
||||||
|
|
||||||
|
# pidfile is UNIX way to tell that others that this program is |
||||||
|
# running with given process-id number. This has compiled-in |
||||||
|
# default value of: pidfile /var/run/aprx.pid |
||||||
|
# |
||||||
|
pidfile /var/run/aprx.pid |
||||||
|
|
||||||
|
|
||||||
|
# rflog defines a rotatable file into which all RF-received packets |
||||||
|
# are logged. The host system can rotate it at any time without |
||||||
|
# need to signal the aprx that the file has been moved. |
||||||
|
# |
||||||
|
rflog /var/log/aprx/aprx-rf.log |
||||||
|
|
||||||
|
# aprxlog defines a rotatable file into which most important |
||||||
|
# events on APRS-IS connection are logged, namely connects and |
||||||
|
# disconnects. The host system can rotate it at any time without |
||||||
|
# need to signal the aprx that the file has been moved. |
||||||
|
# |
||||||
|
aprxlog /var/log/aprx/aprx.log |
||||||
|
|
||||||
|
# dprslog defines a rotatable file into which most important |
||||||
|
# events on DPRS receiver gateways are logged. |
||||||
|
# The host system can rotate it at any time without need to |
||||||
|
# signal the aprx that the file has been moved. |
||||||
|
# |
||||||
|
#dprslog /var/log/aprx/dprs.log |
||||||
|
|
||||||
|
# erlangfile defines a mmap():able binary file, which stores |
||||||
|
# running sums of interfaces upon which the channel erlang |
||||||
|
# estimator runs, and collects data. |
||||||
|
# Depending on the system, it may be running on a filesystem |
||||||
|
# that actually retains data over reboots, or it may not. |
||||||
|
# With this backing store, the system does not loose cumulating |
||||||
|
# erlang data over the current period, if the restart is quick, |
||||||
|
# and does not stradle any exact minute. |
||||||
|
# (Do restarts at 15 seconds over an even minute..) |
||||||
|
# This file is around 0.7 MB per each interface talking APRS. |
||||||
|
# If this file is not defined and it can not be created, |
||||||
|
# internal non-persistent in-memory storage will be used. |
||||||
|
# |
||||||
|
# Built-in default value is: /var/run/aprx.state |
||||||
|
# |
||||||
|
#erlangfile /var/run/aprx.state |
||||||
|
|
||||||
|
</logging> |
||||||
|
|
||||||
|
|
||||||
|
# *********** Multiple <interface> definitions can follow ********* |
||||||
|
|
||||||
|
# ax25-device Lists AX.25 ports by their callsigns that in Linux |
||||||
|
# systems receive APRS packets. If none are defined, |
||||||
|
# or the system is not Linux, the AX.25 network receiver |
||||||
|
# is not enabled. Used technologies need at least |
||||||
|
# Linux kernel 2.4.x |
||||||
|
# |
||||||
|
# tx-ok Boolean telling if this device is able to transmit. |
||||||
|
# |
||||||
|
|
||||||
|
#<interface> |
||||||
|
# ax25-device $mycall |
||||||
|
# #tx-ok false # transmitter enable defaults to false |
||||||
|
# #telem-to-is true # set to 'false' to disable |
||||||
|
#</interface> |
||||||
|
|
||||||
|
|
||||||
|
# |
||||||
|
# The TNC serial options. Parameters are: |
||||||
|
# - /dev/ttyUSB1 -- tty device |
||||||
|
# - 19200 -- baud rate, supported ones are: |
||||||
|
# 1200, 2400, 4800, 9600, 19200, 38400 |
||||||
|
# - 8n1 -- 8-bits, no parity, one stop-bit, |
||||||
|
# no other supported modes |
||||||
|
# - "KISS" - plain basic KISS mode |
||||||
|
# - "XORSUM" alias "BPQCRC" - KISS with BPQ "CRC" byte |
||||||
|
# - "SMACK" alias "CRC16" - KISS with real CRC |
||||||
|
# - "FLEXNET" - KISS with real CRC |
||||||
|
# - "TNC2" - TNC2 monitor format |
||||||
|
# - "DPRS" - DPRS (RX) GW |
||||||
|
# |
||||||
|
|
||||||
|
#<interface> |
||||||
|
# serial-device /dev/ttyUSB0 19200 8n1 KISS |
||||||
|
# #callsign $mycall # callsign defaults to $mycall |
||||||
|
# #tx-ok false # transmitter enable defaults to false |
||||||
|
# #telem-to-is true # set to 'false' to disable |
||||||
|
#</interface> |
||||||
|
|
||||||
|
#<interface> |
||||||
|
# serial-device /dev/ttyUSB1 19200 8n1 TNC2 |
||||||
|
# #callsign $mycall # callsign defaults to $mycall |
||||||
|
# #tx-ok false # TNC2 monitor can not have transmitter |
||||||
|
# #telem-to-is true # set to 'false' to disable |
||||||
|
#</interface> |
||||||
|
|
||||||
|
#<interface> |
||||||
|
# serial-device /dev/ttyUSB1 19200 8n1 DPRS |
||||||
|
# callsign dprsgwcallsign # must define actual callsign |
||||||
|
# #tx-ok false # DPRS monitor can not do transmit |
||||||
|
# #telem-to-is true # set to 'false' to disable |
||||||
|
#</interface> |
||||||
|
|
||||||
|
# |
||||||
|
# tcp-device behaves identically to local serial port, but allows |
||||||
|
# access to remote TCP/IP sockets. A common application is remote |
||||||
|
# KISS modems connected to Ethernet-to-serial adapters from suppliers |
||||||
|
# such as Lantronix. |
||||||
|
# It's important that this remote socket is a raw TCP socket and not |
||||||
|
# handle any byte codes as command escapes. |
||||||
|
# |
||||||
|
# tcp-device hostname portnumber mode |
||||||
|
# - hostname may be a domain name, IPv4 address, or a IPv6 address |
||||||
|
# - portnumber is any valid TCP port (1-65535) |
||||||
|
# - mode is the same as serial-device (KISS, TNC2, etc.) |
||||||
|
# |
||||||
|
|
||||||
|
#<interface> |
||||||
|
# tcp-device 192.0.2.10 10001 KISS |
||||||
|
# #callsign $mycall # callsign defaults to $mycall |
||||||
|
# #tx-ok false # transmitter enable defaults to false |
||||||
|
# #telem-to-is true # set to 'false' to disable |
||||||
|
#</interface> |
||||||
|
|
||||||
|
<interface> |
||||||
|
tcp-device 127.0.0.1 10001 KISS |
||||||
|
callsign $mycall |
||||||
|
tx-ok true |
||||||
|
telem-to-is true # set to 'false' to disable |
||||||
|
</interface> |
||||||
|
|
||||||
|
|
||||||
|
# *********** Multiple <beacon> definitions can follow ********* |
||||||
|
<beacon> |
||||||
|
# |
||||||
|
# Beacons are sent out to radio transmitters AND/OR APRSIS. |
||||||
|
# Default is "both", other modes are settable. |
||||||
|
# |
||||||
|
#beaconmode { aprsis | both | radio } |
||||||
|
# |
||||||
|
# Beacons are sent from a circullar transmission queue, total cycle time |
||||||
|
# of that queue is 20 minutes by default, and beacons are "evenly" |
||||||
|
# distributed along it. Actual intervals are randomized to be anything |
||||||
|
# in between 80% and 100% of the cycle-size / number-of-beacons. |
||||||
|
# First beacon is sent out 30 seconds after system start. |
||||||
|
# Tune the cycle-size to be suitable to your number of defined beacons. |
||||||
|
# |
||||||
|
#cycle-size 20m |
||||||
|
# |
||||||
|
# Basic beaconed thing is positional message of type "!": |
||||||
|
# |
||||||
|
#beacon symbol "R&" lat "0000.00N" lon "00000.00E" comment "Rx-only iGate" |
||||||
|
#beacon symbol "R&" $myloc comment "Rx-only iGate" |
||||||
|
# |
||||||
|
#Following are basic options: |
||||||
|
# 'symbol' no default, must be defined! |
||||||
|
# 'lat' coordinate latitude: ddmm.mmN (no default!) |
||||||
|
# 'lon' coordinate longitude: dddmm.mmE (no default!) |
||||||
|
# '$myloc' coordinate values taken from global 'myloc' entry, |
||||||
|
# and usable in place of explicit 'lat'+'lon'. |
||||||
|
# 'comment' optional tail part of the item, default is nothing |
||||||
|
# |
||||||
|
# Sample symbols: |
||||||
|
# R& is for "Rx-only iGate" |
||||||
|
# I& is for "Tx-iGate" |
||||||
|
# /# is for "Digipeater" |
||||||
|
# I# is for "Tx-iGate + Digipeater"" |
||||||
|
# |
||||||
|
#Additional options are: |
||||||
|
# 'srccall' parameter sets claimed origination address. |
||||||
|
# 'dstcall' sets destination address, default "APRXnn" |
||||||
|
# 'interface' parameter picks an interface (must be "tx-ok true" type) |
||||||
|
# 'via' sets radio distribution pattern, default: none. |
||||||
|
# 'timefix' On APRS messages with HMS timestamp (hour:min:sec), the |
||||||
|
# system fixes appropriate field with transmit time timestamp. |
||||||
|
# |
||||||
|
# Message type is by default '!', which is positional no timestamp format. |
||||||
|
# Other possible formats are definable with options: |
||||||
|
# 'type' Single character setting type: ! = / @, default: ! |
||||||
|
# 'item' Defines a name of Item (')') type beacons. |
||||||
|
# 'object' Defines a name of Object (';') type beacons. |
||||||
|
# |
||||||
|
# 'file' option tells a file at which a _raw_ APRS message content is |
||||||
|
# expected to be found as first line of text. Line ending newline |
||||||
|
# is removed, and no escapes are supported. The timefix is |
||||||
|
# available, though probably should not be used. |
||||||
|
# No \-processing is done on read text line. |
||||||
|
# |
||||||
|
# 'exec' option tells a computer program which returns to stdout _raw_ APRS |
||||||
|
# message content without newline. The timefix is |
||||||
|
# available, though probably should not be used. |
||||||
|
# No \-processing is done on read text line. |
||||||
|
# |
||||||
|
# The parameter sets can vary: |
||||||
|
# a) 'srccall nnn-n dstcall "string" symbol "R&" lat "ddmm.mmN" lon "dddmm.mmE" [comment "any text"] |
||||||
|
# b) 'srccall nnn-n dstcall "string" symbol "R&" $myloc [comment "any text"] |
||||||
|
# c) 'srccall nnn-n dstcall "string" raw "string"' |
||||||
|
# |
||||||
|
# The a) form flags on some of possible syntax errors in parameters. |
||||||
|
# It will also create only "!" type messages. The dest parameter |
||||||
|
# defaults to "APRS", but can be used to give other destinations. |
||||||
|
# The via parameter can be used to add other keywords, like "NOGATE". |
||||||
|
# |
||||||
|
# Writing correct RAW format beacon message is very hard, |
||||||
|
# which is evidenced by the frequency of bad syntax texts |
||||||
|
# people so often put there... If you can not be persuaded |
||||||
|
# not to do it, then at least VERIFY the beacon result on |
||||||
|
# web service like findu.com, or aprs.fi |
||||||
|
# |
||||||
|
# Do remember that the \ -character has special treatment in the |
||||||
|
# Aprx configuration parser. If you want a '\' on APRS content, |
||||||
|
# then you encode it on configuration file as: '\\' |
||||||
|
# |
||||||
|
# Stranger combinations with explicite "transmit this to interface X": |
||||||
|
# |
||||||
|
#beacon file /tmp/wxbeacon.txt |
||||||
|
#beacon interface N0CALL-3 srccall N0CALL-3 \ |
||||||
|
# raw "!0000.00NR00000.00E&Rx-only iGate" |
||||||
|
#beacon interface N0CALL-3 srccall N0CALL-3 \ |
||||||
|
# raw "!0000.00NI00000.00E&Tx-iGate" |
||||||
|
#beacon interface $mycall symbol "R&" $myloc \ |
||||||
|
# comment "Rx-only iGate" |
||||||
|
#beacon interface $mycall symbol "I&" $myloc \ |
||||||
|
# comment "Tx-iGate" |
||||||
|
#beacon exec /usr/bin/telemetry.pl |
||||||
|
#beacon timeout 20 exec /usr/bin/telemetry.pl |
||||||
|
#beacon interface N0CALL-3 srccall N0CALL-3 \ |
||||||
|
# timeout 20 exec /usr/bin/telemetry.pl |
||||||
|
# |
||||||
|
beaconmode aprsis |
||||||
|
cycle-size 55m |
||||||
|
beacon symbol "R&" $myloc comment "LoRa-APRS 433.775MHz/125kHz/SF12" |
||||||
|
|
||||||
|
</beacon> |
||||||
|
|
||||||
|
# *********** <telemetry> definition(s) follow ********* |
||||||
|
# |
||||||
|
# The system will always send telemetry for all of its interfaces |
||||||
|
# to APRSIS, but there is an option to define telemetry to be sent |
||||||
|
# to radio channel by using following sections for each transmitter |
||||||
|
# that is wanted to send out the telemetry. |
||||||
|
# |
||||||
|
# transmitter - callsign referring to <interface> |
||||||
|
# via - optional via-path, only 1 callsign! |
||||||
|
# source - one or more of <interface> callsigns for which |
||||||
|
# the telemetry transmission is wanted for |
||||||
|
# |
||||||
|
#<telemetry> |
||||||
|
# transmitter $mycall |
||||||
|
# via TRACE1-1 |
||||||
|
# source $mycall |
||||||
|
#</telemetry> |
||||||
|
|
||||||
|
# *********** <digipeater> definition(s) follow ********* |
||||||
|
# |
||||||
|
# The digipeater definitions tell transmitters that receive |
||||||
|
# AX.25 packets from possibly multiple sources, and then what |
||||||
|
# to do on the AX.25 headers of those messages. |
||||||
|
# |
||||||
|
# There is one transmitter per digipeater -- and inversely, there |
||||||
|
# can be at most one digipeater for each transmitter. |
||||||
|
# |
||||||
|
# In each digipeater there is at least one <source>, usually same |
||||||
|
# as the transmitter. You may use same <source> on multiple |
||||||
|
# <digipeater>s. Using multiple instances of same <source> on |
||||||
|
# a single <digipeater> does not crash the system, but it can cause |
||||||
|
# packet duplication in case of non-APRS protocols (like AX.25 CONS) |
||||||
|
# |
||||||
|
# Use only at most two levels of viscous-delay in your <digipeater>. |
||||||
|
# Immediate sending is by "0", and a delayed sending is any value |
||||||
|
# from 1 to 9. This system does not correctly support other than |
||||||
|
# immediate sending and one level of delay. |
||||||
|
# |
||||||
|
# Note: In order to igate correct when multiple receivers and |
||||||
|
# transmitters are used on single channel, the <interface> |
||||||
|
# definitions of each radio port must have associated |
||||||
|
# "igate-group N" parameter which has N of value 1 to 3. |
||||||
|
# See the aprx-manual.pdf for details. |
||||||
|
# (Default software compilation allows you to have up to |
||||||
|
# three channels of APRS operation.) |
||||||
|
# |
||||||
|
#<digipeater> |
||||||
|
# transmitter $mycall |
||||||
|
# #ratelimit 60 120 # default: average 60 packets/minute, |
||||||
|
# # # burst max 120 packets/minute |
||||||
|
# #srcratelimit 10 20 # Example: by sourcecall: |
||||||
|
# # average 10 packets/minute, |
||||||
|
# # burst max 20 packets/minute |
||||||
|
# |
||||||
|
# <source> |
||||||
|
# source $mycall |
||||||
|
# # #relay-type digipeated # default mode is "digipeated" |
||||||
|
# # viscous-delay 0 # no viscous delay for RF->RF digipeating |
||||||
|
# # ratelimit 60 120 # default: average 60 packets/minute, |
||||||
|
# # # burst max 120 packets/minute |
||||||
|
# ## filter a/la/lo/la/lo # service area filter |
||||||
|
# ## filter -b/CALL # always block these |
||||||
|
# </source> |
||||||
|
# |
||||||
|
# # Diversity receiver which combines to the primary |
||||||
|
# # Tx/Rx transmitter. There can be as many of these |
||||||
|
# # as you can connect on this machine. |
||||||
|
# #<source> |
||||||
|
# # source RXPORT-1 |
||||||
|
# # #relay-type digipeated # default mode is "digipeated" |
||||||
|
# # viscous-delay 0 # no viscous delay for RF->RF digipeating |
||||||
|
# # ratelimit 60 120 # default: average 60 packets/minute, |
||||||
|
# # # burst max 120 packets/minute |
||||||
|
# ## filter a/la/lo/la/lo # service area filter |
||||||
|
# ## filter -b/CALL # always block these |
||||||
|
# </source> |
||||||
|
# |
||||||
|
# #<source> # APRSIS source adds a TX-IGATE behaviour |
||||||
|
# # source APRSIS |
||||||
|
# # relay-type third-party # Must define this for APRSIS source! |
||||||
|
# # viscous-delay 5 # Recommendation: 5 seconds delay to give |
||||||
|
# # # RF delivery time make itself known. |
||||||
|
# # ratelimit 60 120 # default: average 60 packets/minute, |
||||||
|
# # # burst max 120 packets/minute |
||||||
|
# ## filter a/la/lo/la/lo # service area filter |
||||||
|
# ## filter -b/CALL # always block these |
||||||
|
# #</source> |
||||||
|
# |
||||||
|
# #<source> # DPRS source adds a DPRS->APRS RF gate |
||||||
|
# # interface DPRS |
||||||
|
# # ratelimit 60 120 # default: average 60 packets/minute, |
||||||
|
# # # burst max 120 packets/minute |
||||||
|
# # relay-type third-party # Must define this for DPRS source! |
||||||
|
# #</source> |
||||||
|
#</digipeater> |
||||||
|
|
||||||
|
<digipeater> |
||||||
|
transmitter $mycall |
||||||
|
<source> |
||||||
|
source $mycall |
||||||
|
relay-type digipeated # default mode is "digipeated" |
||||||
|
viscous-delay 5 # no viscous delay for RF->RF digipeating |
||||||
|
ratelimit 10 20 |
||||||
|
filter t/m |
||||||
|
</source> |
||||||
|
|
||||||
|
<source> # APRSIS source adds a TX-IGATE behaviour |
||||||
|
source APRSIS |
||||||
|
relay-type third-party # Must define this for APRSIS source! |
||||||
|
ratelimit 4 30 |
||||||
|
filter t/m |
||||||
|
</source> |
||||||
|
</digipeater> |
||||||
@ -0,0 +1,411 @@ |
|||||||
|
# |
||||||
|
# Simple sample configuration file for the APRX-2 -- an APRS iGate and Digipeater |
||||||
|
# |
||||||
|
# This configuration is structured with Apache HTTPD style tags |
||||||
|
# which then contain subsystem parameters. |
||||||
|
# |
||||||
|
|
||||||
|
# |
||||||
|
# For simple case, you need to adjust 4 things: |
||||||
|
# - Mycall parameter |
||||||
|
# - passcode parameter in APRS-IS configuration |
||||||
|
# - Select correct type of interface (ax25-device or serial-device) |
||||||
|
# - Optionally set a beacon telling where this system is |
||||||
|
# - Optionally enable digipeater with or without tx-igate |
||||||
|
# |
||||||
|
|
||||||
|
# |
||||||
|
# |
||||||
|
# Define the parameters in following order: |
||||||
|
# 1) <aprsis> ** zero or one |
||||||
|
# 2) <logging> ** zero or one |
||||||
|
# 3) <interface> ** there can be multiple! |
||||||
|
# 4) <beacon> ** zero to many |
||||||
|
# 5) <telemetry> ** zero to many |
||||||
|
# 6) <digipeater> ** zero to many (at most one for each Tx) |
||||||
|
# |
||||||
|
|
||||||
|
# |
||||||
|
# Global macro for simplified callsign definition: |
||||||
|
# Usable for 99+% of cases. |
||||||
|
# |
||||||
|
|
||||||
|
mycall N0CALL-1 |
||||||
|
|
||||||
|
# |
||||||
|
# Global macro for simplified "my location" definition in |
||||||
|
# place of explicit "lat nn lon mm" at beacons. Will also |
||||||
|
# give "my location" reference for "filter m/100". |
||||||
|
# |
||||||
|
#myloc lat ddmm.mmN lon dddmm.mmE |
||||||
|
|
||||||
|
<aprsis> |
||||||
|
# The aprsis login parameter: |
||||||
|
# Station callsignSSID used for relaying APRS frames into APRS-IS. |
||||||
|
# Use this only to define other callsign for APRS\-IS login. |
||||||
|
# |
||||||
|
#login OTHERCALL-7 # login defaults to $mycall |
||||||
|
|
||||||
|
# |
||||||
|
# Passcode for your callsign: |
||||||
|
# Unique code for your callsign to allow transmitting packets |
||||||
|
# into the APRS-IS. |
||||||
|
# |
||||||
|
passcode -1 |
||||||
|
|
||||||
|
# APRS-IS server name and optional portnumber. |
||||||
|
# |
||||||
|
# WARNING: Do not change from default port number [14580] |
||||||
|
# unless you are absolutely certain you want |
||||||
|
# something else, and you allow that something |
||||||
|
# else also affect your tx-igate behaviour! |
||||||
|
# |
||||||
|
server rotate.aprs2.net |
||||||
|
#server euro.aprs2.net |
||||||
|
#server asia.aprs2.net |
||||||
|
#server noam.aprs2.net |
||||||
|
#server soam.aprs2.net |
||||||
|
#server aunz.aprs2.net |
||||||
|
|
||||||
|
# Some APRS-IS servers tell every about 20 seconds to all contact |
||||||
|
# ports that they are there and alive. Others are just silent. |
||||||
|
# Default value is 3*"heartbeat" + some --> 120 (seconds) |
||||||
|
# |
||||||
|
#heartbeat-timeout 0 # Disabler of heartbeat timeout |
||||||
|
|
||||||
|
# APRS-IS server may support some filter commands. |
||||||
|
# See: http://www.aprs-is.net/javAPRSFilter.aspx |
||||||
|
# |
||||||
|
# You can define the filter as single long quoted string, or as |
||||||
|
# many short segments with explaining comments following them. |
||||||
|
# |
||||||
|
# Usability of these filters for a Tx-iGate is dubious, but |
||||||
|
# they exist in case you for example want to Tx-iGate packets |
||||||
|
# from some source callsigns in all cases even when they are |
||||||
|
# not in your local area. |
||||||
|
# |
||||||
|
#filter "possibly multiple filter specs in quotes" |
||||||
|
# |
||||||
|
#filter "m/100" # My-Range filter: positions within 100 km from my location |
||||||
|
#filter "f/OH2XYZ-3/50" # Friend-Range filter: 50 km of friend's last beacon position |
||||||
|
</aprsis> |
||||||
|
|
||||||
|
<logging> |
||||||
|
|
||||||
|
# pidfile is UNIX way to tell that others that this program is |
||||||
|
# running with given process-id number. This has compiled-in |
||||||
|
# default value of: pidfile /var/run/aprx.pid |
||||||
|
# |
||||||
|
pidfile /var/run/aprx.pid |
||||||
|
|
||||||
|
|
||||||
|
# rflog defines a rotatable file into which all RF-received packets |
||||||
|
# are logged. The host system can rotate it at any time without |
||||||
|
# need to signal the aprx that the file has been moved. |
||||||
|
# |
||||||
|
rflog /var/log/aprx/aprx-rf.log |
||||||
|
|
||||||
|
# aprxlog defines a rotatable file into which most important |
||||||
|
# events on APRS-IS connection are logged, namely connects and |
||||||
|
# disconnects. The host system can rotate it at any time without |
||||||
|
# need to signal the aprx that the file has been moved. |
||||||
|
# |
||||||
|
aprxlog /var/log/aprx/aprx.log |
||||||
|
|
||||||
|
# dprslog defines a rotatable file into which most important |
||||||
|
# events on DPRS receiver gateways are logged. |
||||||
|
# The host system can rotate it at any time without need to |
||||||
|
# signal the aprx that the file has been moved. |
||||||
|
# |
||||||
|
#dprslog /var/log/aprx/dprs.log |
||||||
|
|
||||||
|
# erlangfile defines a mmap():able binary file, which stores |
||||||
|
# running sums of interfaces upon which the channel erlang |
||||||
|
# estimator runs, and collects data. |
||||||
|
# Depending on the system, it may be running on a filesystem |
||||||
|
# that actually retains data over reboots, or it may not. |
||||||
|
# With this backing store, the system does not loose cumulating |
||||||
|
# erlang data over the current period, if the restart is quick, |
||||||
|
# and does not stradle any exact minute. |
||||||
|
# (Do restarts at 15 seconds over an even minute..) |
||||||
|
# This file is around 0.7 MB per each interface talking APRS. |
||||||
|
# If this file is not defined and it can not be created, |
||||||
|
# internal non-persistent in-memory storage will be used. |
||||||
|
# |
||||||
|
# Built-in default value is: /var/run/aprx.state |
||||||
|
# |
||||||
|
#erlangfile /var/run/aprx.state |
||||||
|
|
||||||
|
</logging> |
||||||
|
|
||||||
|
|
||||||
|
# *********** Multiple <interface> definitions can follow ********* |
||||||
|
|
||||||
|
# ax25-device Lists AX.25 ports by their callsigns that in Linux |
||||||
|
# systems receive APRS packets. If none are defined, |
||||||
|
# or the system is not Linux, the AX.25 network receiver |
||||||
|
# is not enabled. Used technologies need at least |
||||||
|
# Linux kernel 2.4.x |
||||||
|
# |
||||||
|
# tx-ok Boolean telling if this device is able to transmit. |
||||||
|
# |
||||||
|
|
||||||
|
#<interface> |
||||||
|
# ax25-device $mycall |
||||||
|
# #tx-ok false # transmitter enable defaults to false |
||||||
|
# #telem-to-is true # set to 'false' to disable |
||||||
|
#</interface> |
||||||
|
|
||||||
|
|
||||||
|
# |
||||||
|
# The TNC serial options. Parameters are: |
||||||
|
# - /dev/ttyUSB1 -- tty device |
||||||
|
# - 19200 -- baud rate, supported ones are: |
||||||
|
# 1200, 2400, 4800, 9600, 19200, 38400 |
||||||
|
# - 8n1 -- 8-bits, no parity, one stop-bit, |
||||||
|
# no other supported modes |
||||||
|
# - "KISS" - plain basic KISS mode |
||||||
|
# - "XORSUM" alias "BPQCRC" - KISS with BPQ "CRC" byte |
||||||
|
# - "SMACK" alias "CRC16" - KISS with real CRC |
||||||
|
# - "FLEXNET" - KISS with real CRC |
||||||
|
# - "TNC2" - TNC2 monitor format |
||||||
|
# - "DPRS" - DPRS (RX) GW |
||||||
|
# |
||||||
|
|
||||||
|
#<interface> |
||||||
|
# serial-device /dev/ttyUSB0 19200 8n1 KISS |
||||||
|
# #callsign $mycall # callsign defaults to $mycall |
||||||
|
# #tx-ok false # transmitter enable defaults to false |
||||||
|
# #telem-to-is true # set to 'false' to disable |
||||||
|
#</interface> |
||||||
|
|
||||||
|
#<interface> |
||||||
|
# serial-device /dev/ttyUSB1 19200 8n1 TNC2 |
||||||
|
# #callsign $mycall # callsign defaults to $mycall |
||||||
|
# #tx-ok false # TNC2 monitor can not have transmitter |
||||||
|
# #telem-to-is true # set to 'false' to disable |
||||||
|
#</interface> |
||||||
|
|
||||||
|
#<interface> |
||||||
|
# serial-device /dev/ttyUSB1 19200 8n1 DPRS |
||||||
|
# callsign dprsgwcallsign # must define actual callsign |
||||||
|
# #tx-ok false # DPRS monitor can not do transmit |
||||||
|
# #telem-to-is true # set to 'false' to disable |
||||||
|
#</interface> |
||||||
|
|
||||||
|
# |
||||||
|
# tcp-device behaves identically to local serial port, but allows |
||||||
|
# access to remote TCP/IP sockets. A common application is remote |
||||||
|
# KISS modems connected to Ethernet-to-serial adapters from suppliers |
||||||
|
# such as Lantronix. |
||||||
|
# It's important that this remote socket is a raw TCP socket and not |
||||||
|
# handle any byte codes as command escapes. |
||||||
|
# |
||||||
|
# tcp-device hostname portnumber mode |
||||||
|
# - hostname may be a domain name, IPv4 address, or a IPv6 address |
||||||
|
# - portnumber is any valid TCP port (1-65535) |
||||||
|
# - mode is the same as serial-device (KISS, TNC2, etc.) |
||||||
|
# |
||||||
|
|
||||||
|
#<interface> |
||||||
|
# tcp-device 192.0.2.10 10001 KISS |
||||||
|
# #callsign $mycall # callsign defaults to $mycall |
||||||
|
# #tx-ok false # transmitter enable defaults to false |
||||||
|
# #telem-to-is true # set to 'false' to disable |
||||||
|
#</interface> |
||||||
|
|
||||||
|
|
||||||
|
# *********** Multiple <beacon> definitions can follow ********* |
||||||
|
<beacon> |
||||||
|
# |
||||||
|
# Beacons are sent out to radio transmitters AND/OR APRSIS. |
||||||
|
# Default is "both", other modes are settable. |
||||||
|
# |
||||||
|
#beaconmode { aprsis | both | radio } |
||||||
|
# |
||||||
|
# Beacons are sent from a circullar transmission queue, total cycle time |
||||||
|
# of that queue is 20 minutes by default, and beacons are "evenly" |
||||||
|
# distributed along it. Actual intervals are randomized to be anything |
||||||
|
# in between 80% and 100% of the cycle-size / number-of-beacons. |
||||||
|
# First beacon is sent out 30 seconds after system start. |
||||||
|
# Tune the cycle-size to be suitable to your number of defined beacons. |
||||||
|
# |
||||||
|
#cycle-size 20m |
||||||
|
# |
||||||
|
# Basic beaconed thing is positional message of type "!": |
||||||
|
# |
||||||
|
#beacon symbol "R&" lat "0000.00N" lon "00000.00E" comment "Rx-only iGate" |
||||||
|
#beacon symbol "R&" $myloc comment "Rx-only iGate" |
||||||
|
# |
||||||
|
#Following are basic options: |
||||||
|
# 'symbol' no default, must be defined! |
||||||
|
# 'lat' coordinate latitude: ddmm.mmN (no default!) |
||||||
|
# 'lon' coordinate longitude: dddmm.mmE (no default!) |
||||||
|
# '$myloc' coordinate values taken from global 'myloc' entry, |
||||||
|
# and usable in place of explicit 'lat'+'lon'. |
||||||
|
# 'comment' optional tail part of the item, default is nothing |
||||||
|
# |
||||||
|
# Sample symbols: |
||||||
|
# R& is for "Rx-only iGate" |
||||||
|
# I& is for "Tx-iGate" |
||||||
|
# /# is for "Digipeater" |
||||||
|
# I# is for "Tx-iGate + Digipeater"" |
||||||
|
# |
||||||
|
#Additional options are: |
||||||
|
# 'srccall' parameter sets claimed origination address. |
||||||
|
# 'dstcall' sets destination address, default "APRXnn" |
||||||
|
# 'interface' parameter picks an interface (must be "tx-ok true" type) |
||||||
|
# 'via' sets radio distribution pattern, default: none. |
||||||
|
# 'timefix' On APRS messages with HMS timestamp (hour:min:sec), the |
||||||
|
# system fixes appropriate field with transmit time timestamp. |
||||||
|
# |
||||||
|
# Message type is by default '!', which is positional no timestamp format. |
||||||
|
# Other possible formats are definable with options: |
||||||
|
# 'type' Single character setting type: ! = / @, default: ! |
||||||
|
# 'item' Defines a name of Item (')') type beacons. |
||||||
|
# 'object' Defines a name of Object (';') type beacons. |
||||||
|
# |
||||||
|
# 'file' option tells a file at which a _raw_ APRS message content is |
||||||
|
# expected to be found as first line of text. Line ending newline |
||||||
|
# is removed, and no escapes are supported. The timefix is |
||||||
|
# available, though probably should not be used. |
||||||
|
# No \-processing is done on read text line. |
||||||
|
# |
||||||
|
# 'exec' option tells a computer program which returns to stdout _raw_ APRS |
||||||
|
# message content without newline. The timefix is |
||||||
|
# available, though probably should not be used. |
||||||
|
# No \-processing is done on read text line. |
||||||
|
# |
||||||
|
# The parameter sets can vary: |
||||||
|
# a) 'srccall nnn-n dstcall "string" symbol "R&" lat "ddmm.mmN" lon "dddmm.mmE" [comment "any text"] |
||||||
|
# b) 'srccall nnn-n dstcall "string" symbol "R&" $myloc [comment "any text"] |
||||||
|
# c) 'srccall nnn-n dstcall "string" raw "string"' |
||||||
|
# |
||||||
|
# The a) form flags on some of possible syntax errors in parameters. |
||||||
|
# It will also create only "!" type messages. The dest parameter |
||||||
|
# defaults to "APRS", but can be used to give other destinations. |
||||||
|
# The via parameter can be used to add other keywords, like "NOGATE". |
||||||
|
# |
||||||
|
# Writing correct RAW format beacon message is very hard, |
||||||
|
# which is evidenced by the frequency of bad syntax texts |
||||||
|
# people so often put there... If you can not be persuaded |
||||||
|
# not to do it, then at least VERIFY the beacon result on |
||||||
|
# web service like findu.com, or aprs.fi |
||||||
|
# |
||||||
|
# Do remember that the \ -character has special treatment in the |
||||||
|
# Aprx configuration parser. If you want a '\' on APRS content, |
||||||
|
# then you encode it on configuration file as: '\\' |
||||||
|
# |
||||||
|
# Stranger combinations with explicite "transmit this to interface X": |
||||||
|
# |
||||||
|
#beacon file /tmp/wxbeacon.txt |
||||||
|
#beacon interface N0CALL-3 srccall N0CALL-3 \ |
||||||
|
# raw "!0000.00NR00000.00E&Rx-only iGate" |
||||||
|
#beacon interface N0CALL-3 srccall N0CALL-3 \ |
||||||
|
# raw "!0000.00NI00000.00E&Tx-iGate" |
||||||
|
#beacon interface $mycall symbol "R&" $myloc \ |
||||||
|
# comment "Rx-only iGate" |
||||||
|
#beacon interface $mycall symbol "I&" $myloc \ |
||||||
|
# comment "Tx-iGate" |
||||||
|
#beacon exec /usr/bin/telemetry.pl |
||||||
|
#beacon timeout 20 exec /usr/bin/telemetry.pl |
||||||
|
#beacon interface N0CALL-3 srccall N0CALL-3 \ |
||||||
|
# timeout 20 exec /usr/bin/telemetry.pl |
||||||
|
# |
||||||
|
</beacon> |
||||||
|
|
||||||
|
# *********** <telemetry> definition(s) follow ********* |
||||||
|
# |
||||||
|
# The system will always send telemetry for all of its interfaces |
||||||
|
# to APRSIS, but there is an option to define telemetry to be sent |
||||||
|
# to radio channel by using following sections for each transmitter |
||||||
|
# that is wanted to send out the telemetry. |
||||||
|
# |
||||||
|
# transmitter - callsign referring to <interface> |
||||||
|
# via - optional via-path, only 1 callsign! |
||||||
|
# source - one or more of <interface> callsigns for which |
||||||
|
# the telemetry transmission is wanted for |
||||||
|
# |
||||||
|
#<telemetry> |
||||||
|
# transmitter $mycall |
||||||
|
# via TRACE1-1 |
||||||
|
# source $mycall |
||||||
|
#</telemetry> |
||||||
|
|
||||||
|
# *********** <digipeater> definition(s) follow ********* |
||||||
|
# |
||||||
|
# The digipeater definitions tell transmitters that receive |
||||||
|
# AX.25 packets from possibly multiple sources, and then what |
||||||
|
# to do on the AX.25 headers of those messages. |
||||||
|
# |
||||||
|
# There is one transmitter per digipeater -- and inversely, there |
||||||
|
# can be at most one digipeater for each transmitter. |
||||||
|
# |
||||||
|
# In each digipeater there is at least one <source>, usually same |
||||||
|
# as the transmitter. You may use same <source> on multiple |
||||||
|
# <digipeater>s. Using multiple instances of same <source> on |
||||||
|
# a single <digipeater> does not crash the system, but it can cause |
||||||
|
# packet duplication in case of non-APRS protocols (like AX.25 CONS) |
||||||
|
# |
||||||
|
# Use only at most two levels of viscous-delay in your <digipeater>. |
||||||
|
# Immediate sending is by "0", and a delayed sending is any value |
||||||
|
# from 1 to 9. This system does not correctly support other than |
||||||
|
# immediate sending and one level of delay. |
||||||
|
# |
||||||
|
# Note: In order to igate correct when multiple receivers and |
||||||
|
# transmitters are used on single channel, the <interface> |
||||||
|
# definitions of each radio port must have associated |
||||||
|
# "igate-group N" parameter which has N of value 1 to 3. |
||||||
|
# See the aprx-manual.pdf for details. |
||||||
|
# (Default software compilation allows you to have up to |
||||||
|
# three channels of APRS operation.) |
||||||
|
# |
||||||
|
#<digipeater> |
||||||
|
# transmitter $mycall |
||||||
|
# #ratelimit 60 120 # default: average 60 packets/minute, |
||||||
|
# # # burst max 120 packets/minute |
||||||
|
# #srcratelimit 10 20 # Example: by sourcecall: |
||||||
|
# # average 10 packets/minute, |
||||||
|
# # burst max 20 packets/minute |
||||||
|
# |
||||||
|
# <source> |
||||||
|
# source $mycall |
||||||
|
# # #relay-type digipeated # default mode is "digipeated" |
||||||
|
# # viscous-delay 0 # no viscous delay for RF->RF digipeating |
||||||
|
# # ratelimit 60 120 # default: average 60 packets/minute, |
||||||
|
# # # burst max 120 packets/minute |
||||||
|
# ## filter a/la/lo/la/lo # service area filter |
||||||
|
# ## filter -b/CALL # always block these |
||||||
|
# </source> |
||||||
|
# |
||||||
|
# # Diversity receiver which combines to the primary |
||||||
|
# # Tx/Rx transmitter. There can be as many of these |
||||||
|
# # as you can connect on this machine. |
||||||
|
# #<source> |
||||||
|
# # source RXPORT-1 |
||||||
|
# # #relay-type digipeated # default mode is "digipeated" |
||||||
|
# # viscous-delay 0 # no viscous delay for RF->RF digipeating |
||||||
|
# # ratelimit 60 120 # default: average 60 packets/minute, |
||||||
|
# # # burst max 120 packets/minute |
||||||
|
# ## filter a/la/lo/la/lo # service area filter |
||||||
|
# ## filter -b/CALL # always block these |
||||||
|
# </source> |
||||||
|
# |
||||||
|
# #<source> # APRSIS source adds a TX-IGATE behaviour |
||||||
|
# # source APRSIS |
||||||
|
# # relay-type third-party # Must define this for APRSIS source! |
||||||
|
# # viscous-delay 5 # Recommendation: 5 seconds delay to give |
||||||
|
# # # RF delivery time make itself known. |
||||||
|
# # ratelimit 60 120 # default: average 60 packets/minute, |
||||||
|
# # # burst max 120 packets/minute |
||||||
|
# ## filter a/la/lo/la/lo # service area filter |
||||||
|
# ## filter -b/CALL # always block these |
||||||
|
# #</source> |
||||||
|
# |
||||||
|
# #<source> # DPRS source adds a DPRS->APRS RF gate |
||||||
|
# # interface DPRS |
||||||
|
# # ratelimit 60 120 # default: average 60 packets/minute, |
||||||
|
# # # burst max 120 packets/minute |
||||||
|
# # relay-type third-party # Must define this for DPRS source! |
||||||
|
# #</source> |
||||||
|
#</digipeater> |
||||||
@ -0,0 +1,24 @@ |
|||||||
|
## KISS Settings |
||||||
|
# Where to listen? |
||||||
|
# TCP_HOST can be "localhost", "0.0.0.0" or a specific interface address |
||||||
|
# TCP_PORT as configured in aprx.conf <interface> section |
||||||
|
TCP_HOST = "0.0.0.0" |
||||||
|
TCP_PORT = 10001 |
||||||
|
|
||||||
|
## AXUDP Settings |
||||||
|
# AXUDP_REMOTE_IP IP to wich udp packets are sent |
||||||
|
# AXUDP_REMOTE_PORT UDP Port to wich udp packets are sent |
||||||
|
# AXUDP_LOCAL_IP IP of Interface to listen on, 0.0.0.0 for all interfaces |
||||||
|
# AXUDP_LOCAL_PORT Port to listen for incoming AXUDP packets |
||||||
|
|
||||||
|
AXUDP_REMOTE_IP = "192.168.0.185" |
||||||
|
AXUDP_REMOTE_PORT = 20000 |
||||||
|
AXUDP_LOCAL_IP = "0.0.0.0" |
||||||
|
AXUDP_LOCAL_PORT = 20000 |
||||||
|
|
||||||
|
## Genral Settings |
||||||
|
# USE_AXUDP Switch from KISS to AXUDP if True |
||||||
|
# APPEND_SIGNAL_REPORT adds signal report to text of APRS-Message for debug purpose |
||||||
|
# this will change the original message and could cause loops |
||||||
|
USE_AXUDP = True |
||||||
|
APPEND_SIGNAL_REPORT = True |
||||||
Binary file not shown.
|
After Width: | Height: | Size: 161 KiB |
@ -0,0 +1,54 @@ |
|||||||
|
|
||||||
|
# Experimental multi-SF reception. Does not yet work. |
||||||
|
# lora.set_mode(MODE.STDBY) |
||||||
|
# lora.set_mode(MODE.CAD) |
||||||
|
# f = lora.get_irq_flags() |
||||||
|
# while True: |
||||||
|
# |
||||||
|
# for sf in [10, 11, 12]: |
||||||
|
# #m = lora.get_mode() # important to keep pySX127x updated |
||||||
|
# lora.set_mode(MODE.STDBY) |
||||||
|
# lora.set_spreading_factor(sf) |
||||||
|
# lora.set_mode(MODE.CAD) |
||||||
|
# #time.sleep(0.001) |
||||||
|
# while f["cad_done"] == 0: |
||||||
|
# time.sleep(0.05) |
||||||
|
# f = lora.get_irq_flags() |
||||||
|
# #print(sf, MODE.lookup[lora.get_mode()], f) |
||||||
|
# if f["cad_detected"]: |
||||||
|
# print("DET SF %i" % sf) |
||||||
|
# lora.set_mode(MODE.RXSINGLE) |
||||||
|
# time.sleep(3) |
||||||
|
# lora.clear_irq_flags(CadDone=1, CadDetected=1) |
||||||
|
# f = lora.get_irq_flags() |
||||||
|
# #print((lora.get_irq_flags())) |
||||||
|
# |
||||||
|
# import sys |
||||||
|
# sys.exit(0) |
||||||
|
|
||||||
|
# if f["cad_done"]: |
||||||
|
# lora.clear_irq_flags(CadDone=1) |
||||||
|
# if f["cad_detected"]: |
||||||
|
# lora.clear_irq_flags(CadDetected=1) |
||||||
|
# lora.set_mode(MODE.RXSINGLE) |
||||||
|
# else: |
||||||
|
# if mode == 1: |
||||||
|
# lora.set_spreading_factor(SPREADINGFACTOR) |
||||||
|
# lora.set_low_data_rate_optim(True) |
||||||
|
# mode = 2 |
||||||
|
# else: |
||||||
|
# lora.set_spreading_factor(10) |
||||||
|
# lora.set_low_data_rate_optim(False) |
||||||
|
# mode = 1 |
||||||
|
# lora.set_mode(MODE.CAD) |
||||||
|
# elif f["rx_timeout"]: |
||||||
|
# lora.clear_irq_flags(RxTimeout=1) |
||||||
|
# lora.set_mode(MODE.CAD) |
||||||
|
# |
||||||
|
# if f["valid_header"]: |
||||||
|
# lora.clear_irq_flags(ValidHeader=1) |
||||||
|
|
||||||
|
|
||||||
|
# if lora.mode == MODE.RXCONT: |
||||||
|
# lora.set_mode(MODE.CAD) |
||||||
|
# time.sleep(0.001) |
||||||
Loading…
Reference in new issue