Skip to main content

Balloon payload telemetry over APRS

Project description

PacketRaven

tests build

PacketRaven is a front-end data aggregator / dashboard, designed to track the progress of high-altitude balloon payload flights via location telemetry.

pip install packetraven

Usage:

to start the client, run the following:

packetraven
usage: packetraven [-h] [-k APIKEY] [-c CALLSIGNS] [-s] [-p PORT] [-l LOG] [-o OUTPUT] [-t INTERVAL] [-g]

optional arguments:
  -h, --help            show this help message and exit
  -k APIKEY, --apikey APIKEY
                        API key from https://aprs.fi/page/api
  -c CALLSIGNS, --callsigns CALLSIGNS
                        comma-separated list of callsigns to track
  -s, --skipserial      skip attempting to connect to APRS packet radio
  -p PORT, --port PORT  name of serial port connected to APRS packet radio
  -l LOG, --log LOG     path to log file to save log messages
  -o OUTPUT, --output OUTPUT
                        path to output file to save packets
  -t INTERVAL, --interval INTERVAL
                        seconds between each main loop
  -g, --gui             start the graphical interface

Python API:

to retrieve packets directly from https://aprs.fi:

from packetraven import DEFAULT_CALLSIGNS, APRSfiConnection

callsigns = ['W3EAX-8', 'W3EAX-12', 'KC3FXX', 'KC3ZRB']
api_key = '' # enter your APRS.fi API key here - you can get a free API key from https://aprs.fi/page/api

aprs_fi = APRSfiConnection(callsigns, api_key)
aprs_fi_packets = aprs_fi.packets

print(aprs_fi_packets)

or parse packets from a radio sending parsed APRS over a USB connection:

from packetraven import APRSPacketRadio

serial_port = None # leave None to let PacketRaven guess the port name  

radio = APRSPacketRadio(serial_port)
radio_packets = radio.packets

print(radio_packets)

or connect to a PostGreSQL database running PostGIS:

from packetraven import APRSPacketDatabaseTable

hostname = 'bpp.umd.edu:5432' 
database = 'bpp'
table = 'packets'

username = 'username'
password = '1234'

table = APRSPacketDatabaseTable(hostname, database, table, username=username, password=password)
table_packets = table.packets

print(table_packets)

Features:

current:
  • parse APRS packets from USB radio
  • retrieve packets from https://aprs.fi
  • output packets to file
  • plot altitude
in development:
  • flight track plotting
  • live track prediction
  • Iridium telemetry and commands
  • live chase navigation

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

packetraven-1.1.1.tar.gz (21.3 kB view details)

Uploaded Source

Built Distribution

packetraven-1.1.1-py3-none-any.whl (25.3 kB view details)

Uploaded Python 3

File details

Details for the file packetraven-1.1.1.tar.gz.

File metadata

  • Download URL: packetraven-1.1.1.tar.gz
  • Upload date:
  • Size: 21.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/47.1.0 requests-toolbelt/0.9.1 tqdm/4.49.0 CPython/3.8.5

File hashes

Hashes for packetraven-1.1.1.tar.gz
Algorithm Hash digest
SHA256 6e2f03b8cb581e66f12975aa646825f1b6646ed3650940462fcd787accb9a4ae
MD5 676d5dcd373c1b41f6d052df16aa2176
BLAKE2b-256 f54f8745e7e9433012604eb873891c7097a85e4e256f05234560ea8f6e7d97f9

See more details on using hashes here.

Provenance

File details

Details for the file packetraven-1.1.1-py3-none-any.whl.

File metadata

  • Download URL: packetraven-1.1.1-py3-none-any.whl
  • Upload date:
  • Size: 25.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/47.1.0 requests-toolbelt/0.9.1 tqdm/4.49.0 CPython/3.8.5

File hashes

Hashes for packetraven-1.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 4f33df18bc64d1567cb6dcff56167177901cf5d2c5db260833788066d63bec26
MD5 c1d325e6814a2160bfea7a479fca9b08
BLAKE2b-256 680234e8d4cc14f71fe56e7ba057324eec8861d58c630053404606786de05226

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page