Telemetry dashboard for APRS packets from TNC, https://aprs.fi, and PostGIS
Project description
PacketRaven
PacketRaven is a dashboard built to track high-altitude balloon flights from their location telemetry.
pip install packetraven
Installation
-
install Python - https://www.python.org/downloads/
-
install
packetraven
withpip
:pip install packetraven
NOTE
Alternatively, you may download the source code and build from source:
git clone https://github.com/UMDBPP/PacketRaven.git
cd packetraven
pip install .
Usage
PacketRaven reads a configuration file to determine which connections to set up, how to parse your packets, which callsigns to filter, etc.
packetraven /path/to/config.yaml
The configuration is in YAML format. Here is an example configuration:
# config.yaml
callsigns:
- W3EAX-9
- W3EAX-11
- W3EAX-12
time:
start: '2022-03-05'
end: '2022-03-06'
interval: 30
output:
filename: 'ns110.geojson'
log:
filename: 'ns110.log'
packets:
aprs_fi:
api_key: '123456.abcdefhijklmnop'
text:
locations:
- '/dev/ttyUSB0'
- '~/packets.txt'
database:
hostname: 'localhost'
port: 5432
database: 'nearspace'
table: 'ns110'
username: 'user1'
password: 'password1'
tunnel:
hostname: 'bpp.umd.edu'
port: 22
username: 'user1'
password: 'password2'
prediction:
start:
location:
- -78.4987
- 40.0157
time: '2022-03-05 10:36:00'
profile:
ascent_rate: 6.5
burst_altitude: 25000
sea_level_descent_rate: 9
output:
filename: 'ns110_prediction.geojson'
start the graphical user interface (GUI)
to start the GUI, add --gui
to any packetraven
command
packetraven --gui
packetraven config.yaml --gui
Examples
listen to a TNC sending raw APRS strings over USB port COM4
# config.yaml
packets:
text:
locations:
- 'COM4'
you can also set the location to auto
to try the first open USB port
# config.yaml
packets:
text:
locations:
- 'auto'
listen to APRS.fi, watching specific callsigns
you need an API key to connect to APRS.fi; you can get one from https://aprs.fi/page/api
# config.yaml
callsigns:
- W3EAX-8
- W3EAX-14
packets:
aprs_fi:
api_key: '123456.abcdefhijklmnop'
listen to a PostGIS database table
# config.yaml
callsigns:
- W3EAX-8
- W3EAX-14
packets:
database:
hostname: 'bpp.umd.edu'
port: 5432
database: 'nearspace'
table: 'ns110'
username: 'user1'
password: 'password1'
watch text file(s) for new lines containing raw APRS strings
# config.yaml
packets:
text:
locations:
- 'http://bpp.umd.edu/archives/Launches/NS-95_2020-11-07/APRS/W3EAX-10/W3EAX-10_raw_NS95.txt'
- 'http://bpp.umd.edu/archives/Launches/NS-95_2020-11-07/APRS/W3EAX-11/W3EAX-11_raw_NS95.txt'
listen to a TNC on COM3, watching specific callsigns, and synchronize new packets with a database table via SSH tunnel
# config.yaml
callsigns:
- W3EAX-8
- W3EAX-14
packets:
text:
locations:
- 'COM3'
database:
hostname: 'localhost'
port: 5432
database: 'nearspace'
table: 'ns110'
username: 'user1'
password: 'password1'
tunnel:
hostname: 'bpp.umd.edu'
port: 22
username: 'user1'
password: 'password2'
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for packetraven-2.0.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8aca63aebb23213c10d04721d1d91fbc72bf2cd817ab5f159e9b462f3e4dffaf |
|
MD5 | 1ebc9f17b16c518470dc7e18fe7cd178 |
|
BLAKE2b-256 | c4fb669a7f0839c4886a098b3c2f9b6bd93af8ce9694ebea6fb6af624d5fa530 |