mirror of https://github.com/f4exb/sdrangel.git synced 2024-12-23 10:05:46 -05:00

History

f4exb 98b305f320 Make rollup state a serializable object so that it can be dumped in JSON format for the API. Prerequisite tp #1050		2022-01-09 05:27:12 +01:00
..
aprs	Add APRS Feature	2021-01-13 20:37:09 +00:00
aprs.cpp	Make rollup state a serializable object so that it can be dumped in JSON format for the API. Prerequisite tp #1050	2022-01-09 05:27:12 +01:00
aprs.h	Add APRS Feature	2021-01-13 20:37:09 +00:00
aprs.qrc	Add APRS Feature	2021-01-13 20:37:09 +00:00
aprsgui.cpp	Make rollup state a serializable object so that it can be dumped in JSON format for the API. Prerequisite tp #1050	2022-01-09 05:27:12 +01:00
aprsgui.h	Make rollup state a serializable object so that it can be dumped in JSON format for the API. Prerequisite tp #1050	2022-01-09 05:27:12 +01:00
aprsgui.ui	Start ARPS GUI on stations tab	2021-01-13 21:18:14 +00:00
aprsplugin.cpp	Make rollup state a serializable object so that it can be dumped in JSON format for the API. Prerequisite tp #1050	2022-01-09 05:27:12 +01:00
aprsplugin.h	Add APRS Feature	2021-01-13 20:37:09 +00:00
aprssettings.cpp	Make rollup state a serializable object so that it can be dumped in JSON format for the API. Prerequisite tp #1050	2022-01-09 05:27:12 +01:00
aprssettings.h	Make rollup state a serializable object so that it can be dumped in JSON format for the API. Prerequisite tp #1050	2022-01-09 05:27:12 +01:00
aprssettingsdialog.cpp	Add support for choosing metric or imperial units as per #829	2021-04-02 21:14:49 +01:00
aprssettingsdialog.h	Add support for choosing metric or imperial units as per #829	2021-04-02 21:14:49 +01:00
aprssettingsdialog.ui	Add support for choosing metric or imperial units as per #829	2021-04-02 21:14:49 +01:00
aprswebapiadapter.cpp	Fix cut and paste errors from PTT feature	2021-01-15 11:00:03 +00:00
aprswebapiadapter.h	Add APRS Feature	2021-01-13 20:37:09 +00:00
aprsworker.cpp	Move Feature workers to thread	2021-11-25 09:28:59 +00:00
aprsworker.h	Move Feature workers to thread	2021-11-25 09:28:59 +00:00
CMakeLists.txt	APRS updates	2021-02-26 20:32:33 +00:00
readme.md	Add support for choosing metric or imperial units as per #829	2021-04-02 21:14:49 +01:00

readme.md

APRS Feature Plugin

Introduction

The APRS plugin displays APRS (Automatic Packet Reporting System) packets. APRS packets can be received over RF via one or more Packet Demodulator or ChirpChat Demodulator source channels or from the Internet via an APRS-IS IGate.

Interface

1: Source channels

This displays a list of the Packet Demodulator or ChirpChat Demodulator channels the APRS feature is receiving packets from.

2: Enable APRS-IS IGate

When checked, enables the APRS-IS IGate (Internet gateway). The IGate forwards packets received via the Packet Demodulators to APRS-IS internet servers. These servers collate packets from all IGates and allow them to be viewed on web sites such as https://aprs.fi, https://www.aprsdirect.com/ and http://ariss.net/ (the latter being for packets repeated via satellites and the ISS). It is also possible to receive packets via the IGate, which allows you to see packets that you cannot receive via RF.

3: Show APRS Settings

Pressing this button shows the APRS Settings Dialog. This dialog allows you to enter:

The APRS-IS server the IGate should connect to. Please choose your local server. (noam = North America, euro = Europe, etc).
The callsign the IGate should connect with.
The passcode corresponding to the given callsign.
A serverside filter, that specifies which packets should be forwarded from the internet to SDRangel. See http://www.aprs-is.net/javAPRSFilter.aspx m/50 will send you packets within 50 km of the last known position of the station corresponding to the callsign used to log in with. If you do not have a corresponding station, you can specify a location by passing a latitude and longitude. E.g: r/lat/lon/50
The units in which altitudes are displyed (Feet or metres).
The units in which object speeds are displayed (Knots, MPH or KPH).
The units in which temperature is displayed (Fahrenheit or Celsius).
The units in which rainfall is displayed (Hundredths of an inch or millimetres).

Map

The APRS feature can plot APRS symbols and data on the Map. To use, simply open a Map feature and the APRS plugin will display packets it receives from that point on it. Selecting an APRS item on the map will display a text bubble containing APRS status, position and weather data.

Attribution

APRS icons are from: https://github.com/hessu/aprs-symbols

API

Full details of the API can be found in the Swagger documentation. Here is a quick example of how to enable the APRS-IS IGate:

curl -X PATCH "http://127.0.0.1:8091/sdrangel/featureset/0/feature/0/settings" -d '{"featureType": "APRS",  "APRSSettings": { "igateCallsign": "MYCALLSIGN", "igatePasscode": "12345", "igateFilter": "r/50.2/10.2/25", "igateEnabled": 1  }}'