CONFIGURATION INDEX
| Item | Configuration |
|---|---|
| Document | setup.html |
| Markdown source / build | setup_R02.md / B261109 |
| File revision / build | R003 / B261109 |
| Content revision / build | R001 / B261013 |
| Date | 2026-11-09 |
| Approved source application | SPOTMAP v0.9.9R01 FIX1 |
| Standalone application | n/a |
| Source display / package build | B261013 / 2026101303 |
| Standalone package build | n/a |
| Status | Prepared for project-owner review; not uploaded. |
Generic information
- The offline app help stays available even when not connected to internet.
- The online web help requires an internet connection.
- This is a reference tool only and not a substitute for knowledge, experience or approved operational data; always strictly use, adhere, follow and verify with approved operational data.
- If you do not have a FULL understanding of the tool, do not use it!
How to use the help section
π΄Disclaimer: A disclaimer is a legal statement designed to limit a company's liability or specify the boundaries of a product's warranty. It informs the user about what the product or company is not responsible for, or clarifies that certain information (like third-party software updates) is outside of the company's control. Impact: Legal/Financial. It protects the organization from lawsuits and sets realistic expectations for the product's performance or usage.
β οΈWarning: A warning alerts the user to potential hazards that could result in personal injury, death, severe data loss, or permanent damage to equipment. It is the most critical type of callout and must clearly explain the hazard, the consequences of ignoring it, and how to avoid it. Impact: High. Ignoring a warning can lead to physical harm or catastrophic system failure, or both.
πΌ Note: A note provides helpful, non-critical information to the user. It emphasizes points, clarifies steps, or offers background context that is not essential to completing the main task but improves the user's understanding. Impact: Low. Ignoring a note will not cause harm, damage, or data loss.
INTRODUCTION
SETUP configures GNSS source labels, map presentation, distance rings, and the ownship symbol. It also provides save-status information and access to retained sessions and backups.
BASIC USAGE
Open SETUP from the main toolbar. The sections below follow the card from top to bottom.
1. GNSS SOURCE β internal source label
Enter a useful name in INTERNAL GPS SOURCE LABEL. RESET restores the label to iPad. The current label is shown below the field and is used in applicable displays and exports.
This field labels the system location source. It does not enable a built-in receiver, select a different receiver, or establish a Bluetooth connection.
2. GNSS SOURCE β external source label
Choose the label corresponding to the receiver actually supplying the iPad's system location feed:
- Auto / Unidentified Accessory β keep the accessory identity unspecified.
- Flight Stream 110 654C β label fixes from the installed Flight Stream/GDL system.
- Bad Elf Flex Mini Standard β label fixes from that receiver.
- Dual XGPS160 SkyPro β label fixes from that receiver.
- Other External GPS β label another compatible external receiver.
πΌ Note: The iPad's accessory flag distinguishes an external feed from the internal/system feed. Selecting a name here supplies a descriptive label; it does not prove which hardware is connected. Verify the receiver connection separately and check the live source, accuracy, and fix age.
3. MAP β reference information and projected track
The default map view is TRACK UP Β· CENTERED Β· 4.0 NM WIDE. The U.S. Base Map Lite row describes the bundled fallback; external package controls are in LAYERS.
Turn WET NOODLE Β· PROJECTED GROUND TRACK on to display the prediction based on current ground speed and smoothed GPS rate of turn. Ticks identify the projected 30-, 60-, and 90-second positions. In a turn, the prediction becomes an arc with a turn-center indication. It is an extrapolation of current motion, not a planned route or a saved track.
4. MAP β DISTANCE RINGS
Use DISTANCE RINGS for the master visibility setting. Then configure RING 1 followed by RING 2:
- Enable the individual ring.
- Choose DISTANCE (NM) for a fixed radius, or TIME (MIN) for a radius calculated from the selected time and the trailing three-minute average ground speed.
- Enter VALUE. The supported limits are 0.1β200 NM in distance mode and 0.5β60 minutes in time mode.
- Set RED OPACITY from 0% to 100%. At 0%, the enabled ring is transparent.
For example, a 2-minute time ring at a 90 kt average ground speed has a 3 NM radius. Its size changes as the average speed changes. It is a distance-at-current-average-speed reference, not a promise of arrival time.
5. MAP β OWNSHIP ICON
Select JET, MIL JET, GA, HELO, DOT, or TRIANGLE. Each symbol is centered on the displayed position. Changing the symbol does not change the position, ground track, or recorded data.
6. BACKUP β save status
Read the last durable fix, last journal/master save, full checkpoint time, and any save error. SPOTMAP keeps an ordered journal and writes full master JSON files at key actions and periodically, approximately every 30 minutes.
RETRY SAVE appears when a save has failed. Use it, then confirm that the error clears. Wait for the required final save after STOP before starting a new session. A visible track alone is not confirmation that the latest data have been saved successfully.
7. BACKUP β SAVED SESSIONS / BACKUPS
Open SAVED SESSIONS / BACKUPS to inspect retained session files:
- RESCAN FILE LIST refreshes the list.
- IMPORT MASTER JSON copies a compatible previously saved master into the retained-session collection. It does not replace the live recording.
- SAVE COPY OF MASTER JSON or SAVE COPY shares the selected existing file without converting it.
- REVIEW opens the selected saved session's recorded information.
- EXPORT generates a selected output format when that file and the current app state permit it.
Keep useful copies outside the app. Exported files, retained masters, and journals serve different purposes; a successful export is not the same event as an automatic save.
8. SOFTWARE VERSION
Read Current test build when reporting a problem. Identify the app version/revision and build, along with the affected tool and the steps that produced the issue.
Tap X to return to the map. The settings described above are retained by the app.
ABBREVIATION
- GA β General Aviation.
- GNSS β Global Navigation Satellite System.
- GPS β Global Positioning System.
- HELO β Helicopter.
- JSON β JavaScript Object Notation, used for structured data files.
- MIN β Minutes.
- NM β Nautical Miles.
- OSM β OpenStreetMap.
DEFINITION
- Ownship β The symbol representing the current aircraft/device position.
- Ground speed β Speed over the Earth's surface, as supplied or derived from the location feed.
- Fix age β Time elapsed since the timestamp of the latest location fix.
- Durable save β A save acknowledged by the app's storage system.
- Journal β An ordered record of session changes used for persistence and recovery.
- Checkpoint β A complete saved master snapshot at a particular session revision.
- Master JSON β A structured session file retaining the detailed session data.
- Wet noodle β SPOTMAP's short-term projected ground-track display.
