PHAESYLE26PHotography, AErial SurveY, Logging & Exploration

CONFIGURATION INDEX

Item Configuration
Document messages.html
Markdown source / build messages_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

MESSAGES exchanges group-channel text through a configured Meshtastic radio connected by Bluetooth. Drafts, conversation history, and custom shortcuts are retained locally on the iPad.

BASIC USAGE

Open TOOLS → MESSAGES. A compatible configured radio is required for transmission; the app reads its existing channels rather than configuring the radio network.

1. CONNECT RADIO

Tap CONNECT RADIO or the connection card at the top. Power the radio, enable its Bluetooth connection, and disconnect it from competing apps or devices.

  • SCAN FOR RADIO starts discovery; select the intended radio from the results.
  • STOP SCAN ends discovery.
  • RECONNECT LAST RADIO retries the remembered radio when available.
  • DISCONNECT ends the current connection.
  • If iPadOS asks for a pairing PIN, use the PIN displayed or configured on the radio.

Wait for Connected · ready and the channel list. Done returns to the conversation. Radio configuration remains in the radio's normal configuration application.

2. TO — choose a group channel

Use the TO selector to choose an existing channel. Check it before sending: SEND broadcasts to that group channel. An incoming direct message may be displayed, but direct-message sending is not implemented here; it is labeled DIRECT · receive only.

The unread count identifies messages not yet viewed. Inspect any connection/error banner. Its close button dismisses the displayed error message; it does not resolve the underlying radio condition.

3. Read the conversation and delivery status

The conversation lists incoming and outgoing messages. Interpret outgoing status carefully:

  • Sent to radio confirms the Bluetooth write.
  • Queued by radio confirms that the radio accepted the message into its transmit queue.
  • Mesh ACK received reports a radio acknowledgment. For a group message, it does not prove every recipient received it and is never a read receipt.
  • Delivery unconfirmed does not prove failure; the message may still have arrived.

The app does not automatically resend an unconfirmed message. A second compatible radio or a reachable user is needed to check end-to-end delivery and replies.

4. Compose and SEND

Enter text in Type a message…. The counter shows the UTF-8 byte length, with a maximum of 200 bytes. Some accented characters and emojis consume more than one byte.

Review the message and selected channel, then tap SEND. Merely typing or inserting a shortcut does not transmit. Use Done to dismiss the keyboard.

5. Use the shortcut row

The shortcut buttons append to the draft, separated by a space:

  1. YES — insert YES.
  2. NO — insert NO.
  3. HELP — insert HELP; this is a message shortcut, not the help-page button.
  4. GPS — insert decimal latitude and longitude with five decimal places.
  5. LOCAL — insert local time/date in the form LT1959 YYYYMMDD.
  6. ZULU — insert UTC time/date in the form Z1959 YYYYMMDD.
  7. 1–5 — insert the corresponding saved custom message.

Swipe the row sideways in a narrow window. Long-press a numbered shortcut and choose Edit custom messages, or use EDIT CUSTOM MESSAGES in help. Each custom message can contain up to 25 characters.

The GPS, LOCAL, and ZULU shortcuts use SPOTMAP's system-location feed and the fix timestamp, not the radio's GPS or a separate satellite clock. Fixes older than 15 seconds are rejected. If Location ready has not appeared, wait and tap again; the app does not insert stale information into the draft automatically.

6. MAP, HELP, and TEST LOG

  • MAP opens MeshMap in the browser and requires internet. The app supplies the connected radio's node identity when available; this is not a live SPOTMAP tracking map or a guarantee that the radio is listed there.
  • HELP or ? opens the offline instructions. Close help with X to return to the conversation.
  • TEST LOG → EXPORT TEST LOG shares diagnostic information, including connection events, firmware, channel names, and message history. Channel encryption keys are excluded.
  • CLEAR THIS RADIO'S LOCAL HISTORY, inside the test-log panel, asks for confirmation before removing locally saved messages for the selected radio. Export a copy first if needed; this action is not a remote deletion of recipients' messages.

7. Close and return

Closing the MESSAGES card keeps the radio available while SPOTMAP remains active. Reopening restores the conversation and draft. The latest 500 messages across radios are retained locally.

Keep SPOTMAP visible and the iPad awake when testing messaging. Locked-screen/background reception is not supported by this feature. Opening a browser can interrupt foreground reception; return to SPOTMAP to check the connection. Messaging does not control the main flight recorder or MARK.

🔼 Note: The HELP shortcut is ordinary group text. It does not contact emergency services or guarantee that anyone receives or acts on the message.

ABBREVIATION

  • ACK — Acknowledgment.
  • GPS — Global Positioning System.
  • LT — Local Time.
  • PIN — Personal Identification Number used for pairing.
  • UTC — Coordinated Universal Time.
  • UTF-8 — The text encoding used for the message-byte limit.
  • Z — Zulu time, meaning UTC.

DEFINITION

  • Channel — A group-message destination already configured in the radio.
  • Draft — Text being composed but not yet sent.
  • Node — A radio/device on the mesh network.
  • Shortcut — A button that appends predefined or current information to the draft.
  • Read receipt — Confirmation that a person has read a message; this tool does not provide one.
  • Foreground reception — Radio handling while SPOTMAP is active and visible.