Ero sivun ”Aprs.fi user guide” versioiden välillä

Radioamatööriwikistä
Siirry navigaatioon Siirry hakuun
>Oh7lzb
>Oh7lzb
 
(7 välissä olevaa versiota samalta käyttäjältä ei näytetä)
Rivi 39: Rivi 39:
=Sections=
=Sections=


[[Aprs.fi Common features]]
To ease up browsing and editing the guide has been split into separate pages for each section.


[[Aprs.fi Real-time map]]
;[[Aprs.fi Common features|Common features]]
: Describes features which are common to many or all of the different views of the site, such as searching using wildcards and table sorting.


[[Aprs.fi Preferences]]
;[[Aprs.fi Real-time map|Real-time map]]
: Describes the main feature of the site, the real-time map.


[[Aprs.fi Info pages]]
;[[Aprs.fi Preferences|Preferences]]
: Goes through the Preferences dialog, which allows you to customize aprs.fi to your liking.


[[Aprs.fi Static maps]]
;[[Aprs.fi Info pages|Info pages]]
: Describes the station info and station graph views.


[[Aprs.fi Weather]]
;[[Aprs.fi Static maps|Static maps]]
: Introduces the static maps feature.


[[Aprs.fi Telemetry]]
;[[Aprs.fi KML|KML and Google Earth]]
: Describes how to view aprs.fi in 3D using Google Earth.


[[Aprs.fi Network tools]]
;[[Aprs.fi Web stations|Web stations]]
: Updating your position on aprs.fi using a web browser, a mobile phone, or Google Latitude.


[[Aprs.fi Exporting data]]
;[[Aprs.fi Messages and Status|Messages, status messages and the Bulletin Board]]
: Describes the messages, status messages and bulletin board views.


[[Aprs.fi Troubleshooting]]
;[[Aprs.fi Weather|Weather]]
: Describes the weather data visualization features of aprs.fi.


=Messages=
;[[Aprs.fi Telemetry|Telemetry]]
: Describes telemetry collection and viewing.


The [http://aprs.fi/?c=message&limit=50 message browsing page] displays APRS chat messages sent between users. Initially it shows the most recent messages seen on the APRS-IS. If you look up a callsign, you will see all messages sent by or destined to that call. Messages sent by the station are shown with a red background, and received ones are shown in green.
;[[Aprs.fi Raw packets and Beacons|Raw packets and Beacons]]
: Raw APRS and beacon packet listings.


aprs.fi currently does not have the possibility to transmit messages (or any other type of data), it serves only as a place to view data.
;[[Aprs.fi Prefix browsing|Prefix browsing]]


=Status messages=
;[[Aprs.fi Network tools|Network tools]]
: Tools for people who run the digipeaters and igates of the APRS network.


Status message packets are shown in the [http://aprs.fi/?c=status status message page]. Initially, if opened without a callsign, it will let you browse the stations which have transmitted status messages, sorted by callsign. If you look up a callsign, you get to browse old status messages transmitted by that station over time.
;[[Aprs.fi Exporting data|Exporting data]]
: How to download APRS position data from aprs.fi to your computer.


===Difference between status messages and comment text===
;[[Aprs.fi Troubleshooting|Troubleshooting]]
: If you're having problems using aprs.fi, or if you think you've found a bug, please start reading here.


Status messages are often confused with the comment text. They're another method to send some descriptive status message for the station, the difference from comments being:
=Discussion group, blog and other points of communication=


# The comment text is transmitted in the same APRS packet with the position, as text right after the position data. aprs.fi associates the comment message with the position.
If you have any questions, answers, ideas, tips or tricks, please share them on the official [https://groups.google.com/forum/#!forum/aprsfi aprs.fi Google Group]. It's available as a web-based forum and as a regular mailing list. '''Before posting, please read the instructions on the forum's front page, especially the requirement for as many relevant details as possible (including exact callsigns and page links in question).''' The forum exists strictly for discussing the aprs.fi web service – please use the other relevant forums for discussion about generic APRS issues or tracker configuration problems.
# The status message is transmitted in a separate APRS packet, such as the following one, together with a timestamp. On aprs.fi, the status message is stored separately from the position, and they can be browsed using the [http://aprs.fi/?c=status status message page].


  2010-07-02 10:09:00 UTC: CT2XXX-11>APU25N,WIDE3-3,qAR,CT1AKV:>282308zUI-View32 V2.03
Please read through the [[Aprs.fi Troubleshooting|Troubleshooting]] section before posting to the discussion group about any problems. Thank you!
 
As you can see from this example, the timestamp is quite often invalid, so it is ignored by aprs.fi. In practice, you can put your descriptive message in the comment text or the status message. It is not wise to put the same text in both comment and status, as it will then be sent twice, which will place unnecessary load on the busy APRS network.
 
=Beacon packets=
 
The [http://aprs.fi/?c=beacon&call= beacons page] shows packets received from the APRS-IS but which were not identified as APRS packets at all. They are typically identification beacons sent by network nodes, usually describing their hardware or software.
 
  2010-07-02 03:44:07 UTC: DB0EMS>UIDIGI: UIDIGI 1.9
  2010-07-02 03:44:38 UTC: DB0UAL>ID: DB0UAL * X-NET-DIGI * -9k6 Shift
 
=Bulletin board=
 
APRS bulletin messages are used for sending local announcements to other APRS network users. The aprs.fi [http://aprs.fi/bulletin/ Bulletin board] page shows all bulletins which have been transmitted recently and passed on the APRS-IS. The page allows looking up custom bulletin groups using the links provided in the beginning of the page.
 
=Raw packets=
 
The [http://aprs.fi/?c=raw raw packets] page allows you to browse and inspect APRS packets received from the APRS-IS. When you load the page initially (or click '''Clear''') it will show the most recent APRS packets received. The '''previous''' and '''next''' buttons can be used to browse older ones. If you click on '''Raw packets''' in the real-time map while tracking a station, you will automatically get the packets sent by that station.
 
Invalid packets (and ones which are valid but which are not supported by aprs.fi) are shown in red, together with an English error message. Unprintable non-ASCII characters are displayed in hex with a purple colour. '''<0x1c>''' stands for a byte which has a hex value of 1C (28 decimal).
 
To see a hex dump of the complete packet contents (revealing difference in whitespace: tabs, amount of space characters in the end of the line), move the mode selector from '''Normal''' to '''Hex'''.
 
To view the decoded contents of the packets, switch to the '''Decoded''' mode. This will display what information the [http://search.cpan.org/dist/Ham-APRS-FAP/ Ham::APRS::FAP APRS packet parser] is able to find from the packets, and is very useful for understanding the contents of mic-e and compressed format packets. aprs.fi internally uses the open-source Ham::APRS::FAP parser for decoding.
 
=Prefix browsing=
 
The [http://aprs.fi/browse/ prefix browsing] pages allow you to search for APRS users by the callsign prefix. It's useful for finding APRS users near you, even if they haven't transmitted for a while and are not shown in the real-time map.


News about the aprs.fi service are posted on the [http://blog.aprs.fi/ aprs.fi blog], which can also be subscribed over email, or using an RSS reader such as [http://reader.google.com/ reader.google.com]. Headlines from the blog are shown regularly in the lower right corner of the real-time map.


[[Category:aprs.fi]]
[[Category:aprs.fi]]
[[Category:APRS]]
[[Category:APRS]]
[[Category:Pakettiradio]]
[[Category:Pakettiradio]]

Nykyinen versio 8. kesäkuuta 2011 kello 07.15

This is the official manual for the aprs.fi web service. This is also a Wiki page, so you're welcome to expand the document!

Introduction

The aprs.fi web service collects information from the Automatic Packet (or Position) Reporting System Internet network (APRS-IS). APRS is used by amateur (ham) radio operators to transmit real-time position information, weather data, telemetry and messages over the radio. A vehicle equipped with a GPS receiver, a VHF transmitter or HF transceiver and a small computer device called a tracker transmits it's location, speed and course in a small data packet, which is then received by a nearby iGate receiving site which forwards the packet on the Internet. Packets are also retransmitted on the radio channel by digipeaters to enhance the coverage of the system. Systems connected to the Internet can send information on the APRS-IS without a radio transmitter, or collect and display information transmitted anywhere in the world.

In addition to that, aprs.fi also displays AIS data transmitted by most large ships. AIS transmissions are received by volunteers at numerous sites, but most areas are largely uncovered.

This guide aims to become a comprehensive manual for the aprs.fi web site, and as such does not attempt to describe the APRS or AIS systems in detail. To get started with APRS, please consult the following pages:

AIS is described well on the Wikipedia page for Automatic Identification System.

Languages and localisation

The aprs.fi service has been translated by volunteer users to numerous different languages. The language shown to you will be selected based on your browser's language preference settings. If you wish to preview the site in different languages, please prepend the two-letter language code to the site URL:

The site also supports different measurement units (metric, imperial and nautical), which can be selected in the preferences.

Site navigation links

Aprsfi-shot-info-toplinks.png

Each page has a set of navigation links at the top of the page, and another at the bottom. On the real-time map, the links are provided in the navigation bar the right side of the map, which can be hidden by clicking the button in the top right corner of the page.

The general idea is that the links on the top provide links to different data views. If you have already looked up a specific station, the links will contain that callsign, and clicking on the weather link when viewing the info page of a weather station will give you that station's weather history graphs.

The links at the bottom page provide links to static content pages such as the FAQ and this user guide, which give general information about the whole site.

There are a few exceptions to these rules, of course – the My account and Moving stations links, for example.

Sections

To ease up browsing and editing the guide has been split into separate pages for each section.

Common features
Describes features which are common to many or all of the different views of the site, such as searching using wildcards and table sorting.
Real-time map
Describes the main feature of the site, the real-time map.
Preferences
Goes through the Preferences dialog, which allows you to customize aprs.fi to your liking.
Info pages
Describes the station info and station graph views.
Static maps
Introduces the static maps feature.
KML and Google Earth
Describes how to view aprs.fi in 3D using Google Earth.
Web stations
Updating your position on aprs.fi using a web browser, a mobile phone, or Google Latitude.
Messages, status messages and the Bulletin Board
Describes the messages, status messages and bulletin board views.
Weather
Describes the weather data visualization features of aprs.fi.
Telemetry
Describes telemetry collection and viewing.
Raw packets and Beacons
Raw APRS and beacon packet listings.
Prefix browsing
Network tools
Tools for people who run the digipeaters and igates of the APRS network.
Exporting data
How to download APRS position data from aprs.fi to your computer.
Troubleshooting
If you're having problems using aprs.fi, or if you think you've found a bug, please start reading here.

Discussion group, blog and other points of communication

If you have any questions, answers, ideas, tips or tricks, please share them on the official aprs.fi Google Group. It's available as a web-based forum and as a regular mailing list. Before posting, please read the instructions on the forum's front page, especially the requirement for as many relevant details as possible (including exact callsigns and page links in question). The forum exists strictly for discussing the aprs.fi web service – please use the other relevant forums for discussion about generic APRS issues or tracker configuration problems.

Please read through the Troubleshooting section before posting to the discussion group about any problems. Thank you!

News about the aprs.fi service are posted on the aprs.fi blog, which can also be subscribed over email, or using an RSS reader such as reader.google.com. Headlines from the blog are shown regularly in the lower right corner of the real-time map.