Files
MeshCore-Solo/docs/solo/getting-started.md
T
JakubandClaude Opus 5.5 e822242660 docs: stage I3 -- documentation rewritten under docs/solo
Short pages by feature (getting started, messages, contacts, navigation,
tools, settings, lock, hardware) instead of one page per OLED screen, with
Wio Tracker L2 differences as notes; facts checked against the code
(keyboard scripts vs. hold-for-accents, {batt}/{dist}, L2 limits and
settings layout). Developer guides and build flags under docs/solo/developer.
Old docs/solo_features and its ~50 screenshots removed; a hero banner and
three simulator screenshots added; links updated.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 08:41:10 +02:00

2.4 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 and Enter opens the one shown:

Clock, Recent, Radio, Bluetooth, Advert, GPS, Sensors, Tools, Shutdown, Settings, Messages, Favourites, Map.

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.