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
packetravenwithpip: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
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 Distributions
Built Distribution
File details
Details for the file packetraven-2.1.0-py3-none-any.whl.
File metadata
- Download URL: packetraven-2.1.0-py3-none-any.whl
- Upload date:
- Size: 74.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.1 CPython/3.9.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 68c9abf2837d0ca76ffb6bf5545667f8041e77aa0ae4a9deb90ba451e0956e1e |
|
| MD5 | 42edd63018d3626f4aa458a5db6e06ba |
|
| BLAKE2b-256 | af9f1889d1e2e315f79ad7c41f8d253b701fb2d3e1b8842cb4a6144456aeb850 |
