Skip to content

EXAMPLES.md

Latest commit

 

History

History
262 lines (190 loc) · 16.5 KB

EXAMPLES.md

File metadata and controls

262 lines (190 loc) · 16.5 KB

MPAD example requests and responses

This is a simple collection of sample queries along with their associated responses.

Weather forecasts

External service dependencies:

What do we want Command string User > MPAD Response example MPAD > User
localised Wx report for the city of Holzminden, Germany Holzminden;de tomorrow lang de 16-Jan-21 Holzminden;DE Bedeckt morn:-3c day:-1c eve:-2c nite:-2c
sunrise/set 08:21/16:42UTC clouds:89% uvi:0.5 hPa:1026 hum:92%
dewpt:-5c wndspd:2m/s wnddeg:252
WX report for monday for the user's own current position monday 18-Jan-21 Hoexter;DE rain and snow morn:-1c day:1c eve:2c nite:0c
sunrise/set 08:25/16:48UTC rain:1mm snow:2mm clouds:100% uvi:0.3
hPa:1017 hum:98% dewpt:1c wndspd:2m/s wnddeg:223
WX report for monday for another user's position wa1gov-10 monday 20-Jan-21 Taunton,MA,02718;US overcast clouds morn:-1c day:1c
eve:0c nite:-4c sunrise/set 13:06/22:43UTC clouds:100% uvi:0.9
hPa:1010 hum:84% dewpt:-4c wndspd:1m/s wnddeg:280
Wx report for zipcode 94043 94043 17-Jan-21 Mountain View,94043;US clear sky morn:13c day:22c eve:16c
U.S. country code is added implicitly for a 5-digit zip zip 94043 returns same results nite:14c sunrise/set 16:20/02:16UTC clouds:1% uvi:2.6 hPa:1019
(see keyword specification) hum:27% dewpt:2c wndspd:2m/s wnddeg:353
WX report for zipcode 37603 in Germany zip 37603;de 19-Jan-21 Holzminden,37603;DE moderate rain morn:3c day:4c eve:8c
same as 37603;de nite:5c sunrise/set 08:18/16:46UTC rain:13mm clouds:100% uvi:0.3
hPa:1006 hum:90% dewpt:3c wndspd:7m/s wnddeg:217
WX report for Grid JO41du grid jo41du 17-Jan-21 jo41du rain and snow morn:-1c day:0c eve:1c nite:2c
mh jo41du or jo41du returns same results sunrise/set 08:25/16:48UTC rain:1mm snow:2mm clouds:100% uvi:0.3
hPa:1018 hum:97% dewpt:-1c wndspd:2m/s wnddeg:153
Wx report for numeric latitude and longitude 50.1211/8.7938 19-Jan-21 Offenbach am Main,63075;DE moderate rain morn:2c day:3c
eve:5c nite:3c sunrise/set 08:14/16:56UTC rain:5mm clouds:100%
uvi:0.1 hPa:1014 hum:79% dewpt:0c wndspd:8m/s wnddeg:217
WX report in 47h for zipcode 37627 in Germany zip 37603;de 47h 15-Feb-21 in 47h Stadtoldendorf,37627;DE overcast clouds temp:-2c
clouds:100% uvi:0.5 hPa:1032 hum:87% dewpt:-8c wndspd:5m/s
wnddeg:166 vis:10000m

Repeater

External service dependencies:

What do we want Command string User > MPAD Response example MPAD > User
Nearest repeater with C4FM capability repeater c4fm Nearest repeater Hoexter 8 km 225 deg SW Rx 430.4125 Tx 439.8125
Multimode-Digital-Relais (C4FM und DMR), DMR-ID: 262484 C4FM 70cm
JO41QS
Nearest repeater on 70cm band repeater 70cm Nearest repeater Hoexter 8 km 225 deg SW Rx 430.4125 Tx 439.8125
Multimode-Digital-Relais (C4FM und DMR), DMR-ID: 262484 C4FM 70cm
JO41QS
Nearest repeater with C4FM capability and on 70cm band repeater c4fm 70cm Nearest repeater Hoexter 8 km 225 deg SW Rx 430.4125 Tx 439.8125
(order of both band and mode are interchangable) Multimode-Digital-Relais (C4FM und DMR), DMR-ID: 262484 C4FM 70cm
JO41QS
Nearest repeater (disregarding band and mode) repeater Nearest repeater Alfeld 18 km 62 deg ENE Rx 145.1125 Tx 145.7125
C4FM 2m JO41VX

Where Is / Where Am I

External service dependencies:

  • Openstreetmap for coordinate transformation (e.g. City/country or zipcode to lat/lon)
  • aprs.fi for APRS call sign coordinates
What do we want Command string User > MPAD Response example MPAD > User
My own position data whereami Pos for DF1JSL-1 Grid JO41su94 DMS N51.51'13.2, E09.34'37.8 Alt 237m
UTM 32U 539752 5744921 MGRS 32UNC3975244921 LatLon 51.85367/9.57717
Schorborn, 37627, DE Alte Muehle
DF1JSL-8's position whereis df1jsl-8 Pos DF1JSL-8 Grid JO41st76 DMS N51.49'0.0/E09.33'57.0 Dst 85 km
Brg 272deg W Alt 366m UTM 32U 539003 5740799 MGRS 32UNC3900340799
LatLon 51.81667/9.56583 Merxhausen, 37627, DE Neuhaeuser Strasse
Last heard 2021-01-23 17:32:42

METAR / TAF data

External service dependencies:

  • Aviation Weather for coordinate transformation (airport code to lat/lon) and METAR/TAF data
  • aprs.fi for APRS call sign coordinates
What do we want Command string User > MPAD Response example MPAD > User
METAR / TAF data of a METAR-enabled airport, related to the user's position metar EDDF 171150Z 02008KT 340V050 5000 -SHSNRA FEW004 SCT011CB BKN019
03/01 Q1023 NOSIG ### TAF EDDF 171100Z 1712/1818 02008KT 9999
BKN030 TEMPO 1712/1716 SHRAGS BKN020TCU BECMG 1717/1720 FEW030
BECMG 1800/1802 02002KT BECMG 1806/1809 30005KT TEMPO 1811/1818
SHRAGS BKN020TCU SCT030
METAR data of a METAR-enabled airport, related to another user's position metar wa1gov-10 similar output to 1st example
METAR data for ICAO code EDDF icao eddf or eddf similar output to 1st example
METAR data for IATA code FRA iata fra or fra similar output to 1st example

IATA codes are taken from https://www.aviationweather.gov/docs/metar/stations.txt. This file does not contain several international IATA codes. If your IATA code does not work, use an ICAO code.

For better legibility, METAR and TAF data are separated by a ### sequence - see example.

CWOP data

External service dependencies:

CWOP reports always return the latest wx data to the user. Any date / time specifications specified by the user will be ignored.

What do we want Command string User > MPAD Response example MPAD > User
CWOP report, related to the user's position cwop CWOP AT166 17-Jan-21 0C Spd 0.0km/h Gust 1.6km/h Hum 94%
Pres 1017.9mb Rain(cm) 1h=0.03, 24h=0.10, mn=0.10
CWOP report, related to another user's position cwop wa1gov-10 CWOP FW8220 17-Jan-21 6C 332deg Spd 8.0km/h Gust 32.2km/h Hum 52%
Pres 997.4mb Rain(cm) 1h=0.0, 24h=0.0, mn=0.0
CWOP report for a specific CWOP station ID cwop dl6mm-4 CWOP DL6MM-4 17-Jan-21 0C 0deg Spd 0.0km/h Gust 0.0km/h Hum 91%
Pres 1018.1mb Rain(cm) 1h=0.0, 24h=0.0, mn=0.0

Sunrise/Sunset and Moonset/Moonrise

External service dependencies:

  • aprs.fi for APRS call sign coordinates

The very first usage of this command set will trigger a download of the de421.bsp ephemeris data file which will take a few seconds to complete. Once that download has been completed, all future attempts to calculate these celestial attempts will use that previously downloaded data file.

What do we want Command string User > MPAD Response example MPAD > User
Sunrise/set and moonset/rise, relative to the user's position riseset RiseSet DF1JSL-4 17-Jan GMT sun_rs 07:25-15:49 mn_sr 20:47-09:55
Sunrise/set and moonset/rise, relative to another user's position riseset wa1gov-10 RiseSet WA1GOV-10 17-Jan GMT sun_rs 12:08-21:40 mn_sr 01:26-15:03
Sunrise/set and moonset/rise, relative to another user's position and a specific day riseset wa1gov-10 friday RiseSet WA1GOV-10 22-Jan GMT sun_rs 12:04-21:46 mn_sr 06:31-17:00

OpenStreetMap Category 'Near' search

External service dependencies:

  • Openstreetmap for coordinate transformation (e.g. City/country or zipcode to lat/lon)
  • aprs.fi for APRS call sign coordinates
What do we want Command string User > MPAD Response example MPAD > User
Nearest Supermarket to my location osm supermarket Nahkauf Eversteiner Straße 17 Lobach Dst 6 km Brg 332 deg NNW
Top3 of the nearest supermarkets to my location osm supermarket top3 #1 Nahkauf Eversteiner Straße 17 Lobach Dst 6 km Brg 332 deg NNW #2
REWE Bevern Schloss 15 Bevern Dst 7 km Brg 313 deg NW #3 Aldi
Deenser Straße 26 Stadtoldendorf Dst 8 km Brg 26 deg NNE
Nearest police to my location (non-keyword search) police Polizei Stadtoldendorf Amtsstraße 4 Stadtoldendorf Dst 8 km
Brg 29 deg NNE

Keyword-less variants may or may not work, so osm supermarket and supermarket should return the same values. However, ambiguous (shorter) search terms might get misinterpreted as earlier parser processes might mistake them for something else. Example: osm pub will give you the direction to the nearest pub whereas pub will return METAR data for an airport location in Pueblo, CO (whose IATA code is -as you might have guessed- PUB).

Send message to DAPNET user

External service dependencies:

What do we want Command string User > MPAD Response example MPAD > User
Send message Hello World to user DF1JSL dapnet df1jsl Hello World DAPNET message dispatch to 'DF1JSL' via 'all' successful
Send high priority message Emergency, need help to user DF1JSL dapnethp df1jsl mergency, need help DAPNET message dispatch to 'DF1JSL' via 'all' successful

MPAD's response message indicates which transmitter group was used for sending the message to the user (previous example: "all")

Fortune Teller

External service dependencies:

  • Fortuna :-)
What do we want Command string User > MPAD Response example MPAD > User
Our fortune in English language fortuneteller, magic8ball,magic8 or m8b Outlook good
Our fortune in Russian language fortuneteller lang ru Знаки говорят — да

In case you ever wonder about whether you should buy that new transceiver with the super expensive price tag: the answer is always Without a doubt. ALWAYS.

The main purpose of this keyword is testing both UTF-8 and lang keyword tests. Apart from that, it's fun :-) Note that outgoing UTF-8 content will be converted to plain ASCII content unless specified otherwise in the program's config file (see installation instructions).

Satellite pass data

External service dependencies:

What do we want Command string User > MPAD Response example MPAD > User
Get next ISS pass satpass iss ISS pass for DF1JSL-8 UTC Rise 10-Mar 23:09 Culm 23:12 Set 23:15
Alt 10 deg Az 154 deg Dst 677km Vis N
Get next visible ISS pass vispass iss ISS vis pass for DF1JSL-8 UTC Rise 11-Mar 03:59 Culm 04:02
Set 04:05 Alt 10 deg Az 213 deg Dst 876km
Get top2 of next visible ISS pass vispass iss top2 ISS vis passes for DF1JSL-8 UTC #1 Rise 11-Mar 03:59 Culm 04:02
Set 04:05 Alt 10 deg Az 213 deg Dst 876km #2 R 12-Mar 03:11 C 03:14
S 03:17 Alt 10 Az 208 Dst 701

If you request more than one result (via the top2...top5 commands), MPAD will abbreviate the descriptive text for results 2..5 in order to save a few bytes per message. The format for messages 2..5 is the same as for the first message which comes with a full descriptive text.

Description:

  • Rise / R: Rise time, event start time
  • Culm / C: Culmination time, mid-time of the event
  • Set / S: Set time, event end time
  • Alt: Altitude in degrees at culmination time
  • Az: Azimuth in degrees at culmination time
  • Dst: Distance in km or miles at culmination time
  • Vis: Visibility Y/N. Only included if your query is based on satpass.

Satellite frequency data

External service dependencies:

What do we want Command string User > MPAD Response example MPAD > User
Get Es'Hail-2 satellite frequencies satfreq es'hail-2 'ES'HAIL-2' Freq: #1 Uplink 2400.050-2400.300
Downlink 10489.550-10489.800 Mode Linear transponder #2
Up 2401.500-2409.500 Dn 10491.000-10499.000 Md Digital transponder

Note that the requested satellite in question MUST exist in Celestrak's Amateur Radio Satellite list. Satellites which do not exist in the Celestrak data but in JE9PEL's data will not be taken into consideration.

If the requested satellite has more than one uplink/downlink frequency tupel, MPAD will abbreviate the descriptive text for results 2..n in order to save a few bytes per message. The format for messages 2..n is the same as for the first message which comes with a full descriptive text.

Description:

  • Uplink / Up: Satellite uplink frequency
  • Downlink / Dn: Satellite Downlink frequency
  • Beacon / Bcn: Beacon frequency
  • Mode / Md: Mode, e.g. SSTV

Email position reports

External service dependencies:

  • aprs.fi for APRS call sign coordinates
  • Openstreetmap for coordinate transformation (e.g. lat/lon to City/country or zipcode)

Have MPAD send an email with your APRS position data to any user on the Internet.

What do we want Command string User > MPAD Response example MPAD > User
Send a position report to user test123@gmail.com posmsg test123@gmail.com The requested position report was emailed to its recipient
Send a position report to user test123@gmail.com and enforce language 'Russian' posmsg test123@gmail.com lang ru The requested position report was emailed to its recipient

Default language is English - you can specify a different language via language keyword. MPAD always sends this parameter to OpenStreetmap, thus allowing you to receive e.g. Russian addresses in cyrillic characters.

Note that specifying your own message content (as part of the outgoing mail) is not implemented - I sacrificed this option in favor of longer email addresses.

Radiosonde landing predictions

External service dependencies:

  • aprs.fi for APRS call sign coordinates
  • Habhub for the radiosonde landing prediction

Based on the probe's coordinates on APRS.fi, calculate the probe's landing coordinates and return them to the user

What do we want Command string User > MPAD Response example MPAD > User
Get the radiosonde's predicted landing coordinates sonde s3421116 Landing Pred. 'S3421116' Lat/Lon 47.7853/10.6331 02-Apr 15:45UTC
Dst 481 km Brg 159deg SSE Grid JN57hs58 Addr: Baerenleitenweg,
Marktoberdorf, Landkreis Ostallgaeu, Bavaria, 87616, Germany