SOTA Spotter Documentation

Contents

  1. Introduction
  2. Spots list
  3. Send spot
  4. Find summits
  5. Settings
  6. Summits database

This documentation is a work in progress, and may not be complete.

 


Introduction

SOTA Spotter is a simple application that retrieves spots from sotawatch.org and displays them in an easy to read manner.
Summits on the Air (SOTA) is an award scheme for radio amateurs and short wave listeners that encourages portable operation in mountainous areas. You can learn more about it at http://www.sota.org.uk/.

Spots list

This is the first screen shown when you startup SOTA Spotter. It displays the received spots in a list, showing the following information for each spot:spots_list

  • The spotted call sign
  • The frequency and mode of operation
  • The summit reference code
  • The date and time (GMT)
  • The spotter
  • Any comments by the spotter
  • The number of points awarded for this summit

 

The current time (GMT) is displayed on the top of this screen.

This is also where you can access the main menu of the application, which allows you to go to Send spot, Find summits, Settings, Help and About.

Tapping on one of the spots will open the Summit details screen for the summit being spotted.

While this list is visible, it is refreshed once every minute. Once you exit SOTA Spotter the spots list is refreshed at the Sync interval specified in Settings, but only if the Background sync option is checked.

Tip:

In order to refresh the list manually, swipe down from the top of the list.

Send spot

Here you can send new spots to sotawatch.org. With the exception of the Comments field, all the other fields are mandatory.
By checking the Remember spot data check box you can instruct SOTA Spotter to keep the form data and recall it the next time you open the Send spot screen. This is useful to SOTA activators, which may want to re-spot themselves quickly, without re-entering all the data from the beginning.
You can also choose the spot delivery method, which can be one of the following:

  • Internet connection
  • SMS gateway

Next to the SMS gateway option there is a small area where the currently active SMS gateway is displayed. In case a gateway is not selected, a warning appears instead.
By tapping on the active gateway or on the warning you can quickly get to the SMS gateways list and change the selection. No gateway is selected by default, and the selection is reset when the SMS gateways list is updated (this is done automatically over the internet, no action is required on your part).

Important:

You must have an account registered at sotawatch.org and the credentials must be set in the SOTAwatch account section in Settings.

Find summits

This is where you can find information about the summits from the SOTA programme.

Nearby

Here you’ll see a list of summits that are nearby (in a roughly 100km radius around your current position). In order to use this feature you must first enable the Location services – SOTA Spotter will prompt you to do so if not already enabled. Tapping on a summit takes you to the Summit details screen, which also offers some navigation directions.

By association

Here you’ll see a list of summits from the selected association and region. Tapping on a summit takes you to the Summit details screen, which also offers some navigation directions.

Settings

The Settings screen is the place which allows you to configure SOTA Spotter. From look and feel to filters and notifications, everything is in here.

General Settings

This is where you can set some general parameters for SOTA Spotter.

Background sync

Allows SOTA Spotter to retrieve spots in the background (when the app itself is not visible to the user). This is useful for the notifications.

Sync interval

Only meaningful when the Background sync check box is checked above. It defines the time interval (in minutes) between consecutive background spots retrievals. The default is 5 minutes. A shorter interval may have a slight effect on battery life and thus is not recommended.

Appearance

This section allows you to customize the way SOTA Spotter looks.

Theme

Choose the application color theme. The available themes are:

  • Holo Light
  • Holo Dark
  • Red
  • Orange
  • Blue
  • Green

Units

Choose the system of measurement used throughout SOTA Spotter:

  • Metric (meters, kilometers)
  • Imperial (feet, miles)

Spots

Each spot has a colored vertical bar at its left. The color represents the age of the spot and can be one of the following:

  • Red
  • Orange
  • Gray

By default, spots that appeared less than 15 minutes ago are marked with red, the ones older than 15 minutes and newer than 60 minutes are marked with orange and all other (older) spots are marked with gray. The maximum age for spots marked with red and orange can be set in this dialog.

SOTAwatch account

The SOTAwatch account allows you to use the service at http://www.sotawatch.org/ to send new spots. If you do not want or need to send spots you may skip setting the SOTAwatch user name and password.

Username

The user name is the callsign you used to register at http://www.sotawatch.org/.

Password

The password you chose for your SOTAwatch account.

Filters & Notifications

This section gives you access to filters and notifications. Use the filters to drop (block) spots that are of no interest and the notifications to make the ones that do peak your interest stand out.

Important:

The filters and notifications are evaluated sequentially, in the order in which they are defined. For example, if you have defined a filter to drop spots from the 20m band and a sound/vibration notification for spots on the 20m band, the notification will never be triggered.

There are several types of filters and notifications: band, mode, callsign, association, region and summit. Any or all of these types can be set for any filter or notification.

Filters

The filters allow you to drop (block) or accept spots based on some criteria that you define for each filter.
Spots can be filtered by:

  • Band: 160m, 80m, 60m, 40m, 30m, 20m, 17m, 15m, 12m, 10m, 6m, 4m, 2m, 70cm, 23cm
  • Mode: AM, CW, Data, DV, FM, PSK, RTTY, SSB, Other
  • Call sign
  • Association
  • Region
  • Summit

Any or all of these criteria can be used for a filter.

Important:

  • The order of the filters is important. You can tap and hold and then drag a filter to change its position in the list.
  • An incoming spot is checked against each filter until a match is found. The action of the matching filter is then applied to the spot (accept or drop). If no match is found, the default filter action will be applied.
  • You can only enable the Filter by region if the Filter by association is enabled. Similarly, Filter by summit can only be enabled if Filter by region is enabled.

Default filter

This is the default action that will be applied to incoming spots that have passed through all the user-defined filters. By default it is set to accept all spots.

Notifications

An incoming spot can trigger a notification based on certain criteria (the same as for filters). A notification can be accompanied by vibrations, by a ringtone and by a pulsing LED light.

  • Vibrations: the phone will vibrate in a specific pattern – transmitting SOTA in morse code 🙂 – for notifications with Vibrate enabled
  • Ringtone: a user-selected sound will be played whenever a notification with Ring enabled is triggered
  • Pulsing LED: the device’s LED (if it has one) will pulse for notifications with Pulse LED enabled

Important:

  • An incoming spot is checked against each defined notification until a match is found. If a match is found, a notification is triggered for the spot and appears in the notification area.
  • The notifications are only evaluated for spots that have been accepted after passing through the filters chain (either by a custom defined filter or by the default filter).

Ringtone

This is where you can choose the notification ringtone – for those notifications that have Ring enabled.

Spotting

This section gives you access to settings related to sending spots. For now, a list of SMS gateways for spotting via SMS is available.

SMS gateways

The SMS gateways allow you to send spots by sending a SMS to a certain phone number. The message contains all the information needed to send a spot to sotawatch.org. SOTA Spotter can compose the SMS automatically and send it to the selected gateway.
This list is read-only, meaning you cannot add a SMS gateway yourself. If you are the owner of such a gateway and you would like to have yours added to this list, please contact me.
In order to use a gateway, you have to check it in this list (by tapping on the corresponding bullet to its left). By tapping on the name/number in the list you can access some more information about the gateway, like the carrier and country, as well as a short description written by its owner and a URL for extra details.

Important:

Sending SMS may cost you money. The price for sending an SMS may vary based on the carrier to which the SMS is being sent. Please check with your mobile carrier for the relevant fees for sending SMS to the countries/carriers of the gateways.

Summits database

Here you can decide how to handle the summits database updates. You can either have it update automatically or you can update it on demand.

Automatic update

By default this option is disabled. When enabled, SOTA Spotter periodically checks online to see if a newer version of the summits database is available. If there is, it is updated automatically.

This feature uses your mobile device’s internet connection to download a file which is at least 13MB in size. If you have a limited data plan you should leave this option disabled and only perform manual updates when your device has internet access through a WiFi connection.

Update now

This is where you can manually check for and download the latest summits database.