Files
MeshCore-Solo/docs/solo/getting-started.md
T
JakubandClaude Opus 5.5 a733b8bcf5 docs(solo): bring the docs up to date with the L1 refresh
- Home pages as they are now (Status, quick panels, Map page), the Status
  screen's tabs instead of Diagnostics / GPS / Sensors, lock clock Big /
  Compact and the hint on a key press, battery curve on L1 and L2, "+ Send"
  and a failed send, trail pin, vector map behind -D MAP_VECTOR.
- Developer guide: drawScreenHeader, soft frames, InfoKit, TabBar, a status
  bar without blinking, toast and millis() rules; ui-core status; build
  flags (GPS_SKYVIEW, MAP_VECTOR, HIST_ARCHIVE added, ui-tiny-only ones out).
- New simulator screenshots: the clock page and the Status page.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-02 14:23:15 +02:00

3.5 KiB
Raw Blame History

Getting started

Controls

On joystick devices:

Input Does
Up / Down Move through a list
Left / Right Switch home pages; change the value of a setting
Enter Open, select, confirm
Hold Enter Options for the selected item (a message, contact, channel…)
Back One step back; from a screen, back to the home screen

Lists wrap around at both ends. Any key wakes a dark screen without acting on it.

Keyboard devices use the same controls, from the arrow keys (or their Fn combinations), Enter and Esc. Hardware has the key maps.

Note

Wio Tracker L2: tap to open, hold for options, swipe sideways between pages. The top button turns the screen off and on. The side button goes back to the home screen; hold it and let go to mute or unmute the sound. Holding the side button while pressing the top one takes a screenshot.

Home screen

The home screen is a row of pages. On joystick devices, Left / Right steps through them (on Favourites it moves between the slots first). The default order:

Page Shows
Clock The time, the date and up to three fields of your choice; Enter opens the clock tools
Favourites Six slots for the conversations you open most (Contacts)
Status Radio, GPS, battery and mesh at a glance; Enter opens the Status screen
Bluetooth Bluetooth on / off and the phone: connected, or the pairing PIN
Advert Send an advert now, and the auto-advert interval
Settings Brightness, GPS on / off, then all settings
Map Your position, the trail, people sharing theirs and the target (Navigation)
Tools The two tools you used last with their state, then all tools
Messages The two latest conversations with their unread counts, then all messages
Shutdown Lock the screen, or hibernate (with the battery level)

Most pages are quick panels: a few rows and a last one that opens the full screen. Up / Down picks a row and Enter acts on it. A value row (brightness, auto-advert) goes into editing: Left / Right change it while you watch, Enter or Back keeps it.

Settings › Home Pages sets their order and hides the ones you don't use; Settings and Messages are always shown.

Note

Wio Tracker L2: pages you swipe between: favourite chats, the clock (where it starts), a minimap, then the apps, six to a page. Hold an app to arrange or hide them.

Connecting the phone app

Every build serves the MeshCore app over Bluetooth and USB, one at a time: while Bluetooth is connected, USB is ignored. To use USB, disconnect Bluetooth first or turn it off on the device.

The Bluetooth pairing PIN is shown on the Bluetooth home page until the phone is paired.

Note

Wio Tracker L2: the PIN is under Settings › Bluetooth.

Everything you do on the device and in the app stays in sync: contacts, channels and messages are the same data.

Updating

Download the new file from the releases page and flash it the way you did the first time (see the main README). Settings, contacts and messages are kept.

Note

Wio Tracker L2: Settings › Firmware update checks GitHub for a newer release and installs it over WiFi. Set up a network under Settings › WiFi first.