DXL - APRSmap operating
- 1 Program start
- 2 Operation
- 3 Menus
- 3.1 File
- 3.2 Config
- 3.2.1 Brightness
- 3.2.2 Online
- 3.2.3 RF-Ports
- 3.2.4 Timers
- 3.2.5 Map Parameter
- 3.2.6 Map Moving
- 3.2.7 Colours, Font
- 3.2.8 Callfilters
- 3.2.9 Watch Calls
- 3.2.10 Reload Config
- 3.2.11 Save Config
- 3.3 Zoom
- 3.4 Tools
- 3.5 Help
After downloading and saving locally, the aprsmap.exe program can be started. A separate installation is not required.
On the first start of the program it is necessary to do some configuration. The most important things you have to adjust are in the ONLINE menu. You best configure all steps from up till down.
- First of all you put in your callsign (MY CALLSIGN) with optional SSID
- Second step is to choose your desired APRS icon (MY SYMBOL)
- Next you will zoom to your QTH as far as you can, 100% identifing your home (zoom level >16). Then open ONLINE - MY POSITION and point to your home with the cursor. While push and hold the SHIFT key click on your home. The coordinates will be copied into the MY POSITION field. Just click OK to save them.
- Now you can set the SERVER URL by just inserting your favorite APRS IS. Click ADD to save this entry.
for example: aprs.oe2xzr.ampr.at (APRS IS connection via HAMNET) austria.aprs2.net (APRS IS connection via Internet)
- You also need to enter a valid APRS PASSCODE to transmit packets to the APRS network (not needed in case of only RX). Just do a internet search on APRS PASSCODE to find a possibility on getting your code.
- Last but not least you have to activate CONNECT SERVER to get data from an to the APRS network.
Note, shortcut keys are case sensitive!
: delete markers @ reset <On Next Click> to menu mode a Animate (Click to Map to set Parameters) b or <Backspace> go back in position history c Center (to last clicked Pixel) d toggle (missing) map download e toggle Errors only/All for stepping along a track with <> f Junk Filter toggle on/off h Heard (click symbol or text of igate before) i Internal Status Listing l toggle Labels on/off m toggle dimm not moving since 10min o toggle Objects/Items on/off p toggle mouse-over Hints q Quit Program r toggle Radio tracks on/off s toggle show only stations with a selected symbol u toggle tx/rx-Monitor window on/off w toggle WX stations and Temperature x set Marker 1 to mouse position y set Marker 2 and Line to Marker 1 B Open Beacon editor C Enter Category of POI to be drawn on map D Digi Config open/close F Find Call (with wildcards * ?), Locator, Latitude/Longitude H Altitude Colour Map (if srtm-Data avaliable) M Compose Message R toggle Radiorange Map on/off T toggle Timestamp S Screenshot bpm (win), png (linux) W Rain map (use topo or dark map) < > Step along Beacons/Waypoints of a selected User ( ) Map Brightness +- 5% / zoom to Marker 1-2 Square \ shortcut list ~ change track colour + Zoom in - Zoom out . zoom to track and show only this (clicked before) = same as . but with radio tracks 0 show all (and radio tracks off) 1,2,3,4 Zoom/Pan to stored Views 7,8,9 use map type as configured ESC close menus Cursor up/down/left/right move map, same as click near margin SHIFT with up/down/left/right/[zoom+]/[zoom-] in smaller steps DEL delete selected (Symbol, Waypoint) TAB switch between two Views ctrl-L Reset Image and Mouse parameters to default ctrl-V Paste
Tips & tricks
- Animation: Click on the track of a moving object (e.g. car) and press the "a" key
- Temperature distribution: Two times "w" (w + w) shows a color distribution of the reported temperatures (sensible min. Zoom level 10 or less)
- The "0" (zero), ESC and ":" keys often help if you want to have everything displayed again after clicking on the filter or similar.
- "TAB" key toggles between two independent displays, similar to VFO "A" and "B".
In addition to the main menus explained in more detail below, the menu offers further short menus on the right.
N .... Display or switching of the network status, green means connected, orange means not connected or connection problems. If the mouse pointer is moved over the menu, the connection status appears in the popup 1-4....Display or switch the UDP port connections L .... display the log file data M .... View the saved messages F .... display or switching of the track filter (incorrect or implausible position packages) O .... display or switch the display of pure objects
By the way, the mouse position display (green bar with coordinates) can be activated in the CONFIG> MAP PARAMETER> SHOW LOC OF MOUSE menu.
Import a complete logfile.
Save a screenshot in your local user directory, e.g. map1.bmp (Win10 user directories are in the User\AppData folder e.g. C:\Users\User\AppData\Local\VirtualStore\Program Files (x86)\APRSmap)
Save a video from e.g. a moving object in .y4m raw video format.
Choose the logfile directory.
Keep Log Days
Define the ammount of days logs are kept.
Exit APRSmap, shortcut key is q.
Setting the respective brightness, times and colors.
Time Fade Out - time until the display of stations disappears after the time for display (full brightness) has expired Time full Bright - time to display received positions Brightness Waypoint - Brightness of the waypoint points Brightness Text - Brightness of the station texts Brightness Symbol - the brightness of the symbols displayed Gamma - Gamma value setting of the card Brightness Track - the brightness of the route Brightness Map - the brightness of the map Brightness Object - the brightness of the objects displayed
The ONLINE area is initially the most important and necessary menu item, which has to be configured individually. Basically, when the program is simply started and a data connection is established, other stations can be receive even without specifying your own callsign, position or APRS passcode (RX only mode). However, in order to act "actively" in the APRS network and to be seen and reached by other stations, this information must be entered accordingly. The APRS PASScode must be requested once. To do this, search for "APRS PASSCODE Generator" on the Internet.
Here you enter the callsign to be used, optionally with SSID.
(without SSID) Your primary station usually fixed and message capable -1 generic additional station, digi, mobile, wx, etc -2 generic additional station, digi, mobile, wx, etc -3 generic additional station, digi, mobile, wx, etc -4 generic additional station, digi, mobile, wx, etc -5 Other networks (Dstar, Iphones, Androids, Blackberry's etc) -6 Special activity, Satellite ops, camping or 6 meters, etc -7 walkie talkies, HT's or other human portable -8 boats, sailboats, RV's or second main mobile -9 Primary Mobile (usually message capable) -10 internet, Igates, echolink, winlink, AVRS, APRN, etc -11 balloons, aircraft, spacecraft, etc -12 APRStt, DTMF, RFID, devices, one-way trackers*, etc -13 Weather stations -14 Truckers or generally full time drivers -15 generic additional station, digi, mobile, wx, etc * One-way trackers should best use the -12 one-way SSID indicator because the -9's usually mean a ham in full APRS communication both message and voice. The -9's can be contacted by APRS message or by Voice on his frequency included in his beacon, or on Voice Alert if he is in simplex range. The -12's are just moving Icons on the map and since they have no 2 way communication for ham radio they are not generally of routine interest to other operators.
In order to enter your own position in MY POSITION quickly and without any major search effort, simply go first with the zoom into the MAP (preferably ZOOMLEVEL 17) so that you can clearly see your own position. Then open the CONFIG - ONLINE - MY POSITION item and click the SHIFT key to determine your own position. The coordinates are automatically adopted in the context menu and only need to be confirmed with OK.
The text set here is sent as beacon text via the network connection.
An APRS PASSCODE is not absolutely necessary for RX, but this code is essential for sending your own data. You can apply for this code online with a waiting period, simply search for APRS IS PASSCODE using the search engine.
Any APRS server that provides the data in the correct format can be entered as the server URL.
for example: aprs.oe2xzr.ampr.at (for connections via HAMNET) austria.aprs2.net (for connections via Internet)
Another list can be found at http://www.aprs2.net/serverstats.php .
The standard port is 14580 and does not have to be specified.
Alternative ports are given after the address: aprs.server.com:12345
Suggestion: " m / 100 p / OE -t / t "
The position filter is structured as follows [Position] / [Radius] eg " m / 100 " for displaying data with a radius of 100km around your own position.
" P / OE " is used to display all OE stations (e.g. mobile) outside the defined radius filter .
And the mostly unnecessary telemetry traffic is filtered with " -t / t ".
settings relating to the server are only adopted when a new connection is made, for this the server connection can either be disconnected and re-established in the menu bar under "N", or the corresponding server entry can be deactivated and activated under "Config"> "Online"> "Connect Server" .
Activates or deactivates the online connection.
Allow TX to NET
Activates or deactivates the sending of (own) data to the online network.
Allow Gate RF>NET
Activates or deactivates the forwarding of APRS data heard locally via HF in the online network.
Show Loc of Mouse
Activates / deactivates the display of the coordinates, height and distance of the mouse pointer on the map.
Activates / deactivates the intelligent filter function for incorrect or implausible position data (e.g. long lines across the APRS map; chopping or zik-zak in the track as if the route was driven several times - wheel cap lost - caused by a massive delay from Digis delivered packages)
Activates / deactivates the display of the wind vane at weather stations if this value was supplied.
Activates / deactivates the display of the temperature value at weather stations if this has been delivered.
Load Map Program
Deactivates / activates the card loader. Optionally, the loading program can be selected by clicking on the menu, optionally
getosm (standard, activates the external program getosm.exe from OE5KRN) * recommended start sh map.sh (loading maps in the background) sh gm.sh (for map download from the Internet) sh gm-hamnet.sh (for map download from HAMNET )
Freely selectable text of the unit for displaying the speed of moving stations. Default "km / h", can be shortened to "km", for example, to save space.
Show Altitude min m
Reset to Default
Deactivates the permanently displayed toolbar. The toolbar can then be opened dynamically with a click on the map.
On next Click
When the display is activated (marked by * next to SYMBOL) only the selected symbols are displayed. These can be switched on / off by clicking on the respective symbols (multiple selection possible). The entire function can be switched on / off by clicking on the wording SYMBOL.
With the on / off switch, it clearly dims the stationary stations and objects in relation to, for example, mobile stations.
Shows a temperature distribution (similar to an isobar map). Shortcut 2x "w". Exit the Colourmap view with ESC or key w again
Opens the message context menu
Shows the currently installed version of APRSmap. The letter in brackets indicates the operating system, followed by the version number of the software.
aprsmap(w) 0.79 by OE5DXL
Opens the program-internal help context.