Mirrors/MeshCore-Solo
1
0
Fork 0
mirror of https://github.com/MarekZegare4/MeshCore-Solo.git synced 2026-07-29 00:08:12 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: add screenshot placeholders for un-illustrated screens

Browse Source 
Reviewed the user-facing solo_features docs for screens/sub-views described in
prose but never shown, and added placeholder image tables (repo's OLED|E-Ink
convention) with "screenshot pending" capture notes:

- Tools: Live Share, Waypoints navigation view, Add-by-coords form, Compass,
  Diagnostics, Repeater (tls_scr_11..16).
- Settings: Radio preset popup / frequency digit editor (set_scr_3).
- Clock: Dashboard Config (clk_scr_3).
- Favourites Dial: pin-to-dial contact picker (fav_dial_2).

PNGs just need dropping in under the listed names; tables render as broken
images until then (the repo's existing in-progress convention).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
MarekZegare4
2026-06-24 18:11:55 +02:00
parent d743214bb6
commit 8df289fb16
4 changed files with 55 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
docs/solo_features/clock_screen/clock_screen.md
View File

@@ -52,4 +52,10 @@ Sensor fields show `--` when the sensor is not connected or has no data.
### Configuring fields
| OLED | E-Ink |
| :-----------------------: | :-----------------------: |
| ![](./clk_scr_3_oled.png) | ![](./clk_scr_3_eink.png) |
<!-- screenshot pending: Dashboard Config — three field slots cycled with LEFT/RIGHT -->
**Hold Enter** (or press the **Context menu** key) on the Clock page to open the Dashboard Config screen, where each of the three field slots can be cycled with **LEFT/RIGHT**.

6
docs/solo_features/favourites_dial/favourites_dial.md
View File

@@ -41,6 +41,12 @@ If a pinned contact has been removed from the contacts list, the tile shows `(go
2. Recent DM contacts — listed after
3. All remaining chat contacts — fallback when the first two tiers are empty (e.g. fresh install before any DMs)
| OLED | E-Ink |
| :------------------------: | :------------------------: |
| ![](./fav_dial_2_oled.png) | ![](./fav_dial_2_eink.png) |
<!-- screenshot pending: Pin-to-dial contact picker (favourites first, then recent DMs, then all contacts) -->
Select a contact to pin it to that slot.
**From a DM conversation** — **Hold Enter** › context menu › **Pin to dial**, then choose a slot from the slot picker (Slot 1–6, showing the current occupant name or "empty").

6
docs/solo_features/settings_screen/settings_screen.md
View File

@@ -74,6 +74,12 @@ Lists all available home screen pages. For each entry:
| Pwr save | ON / OFF | **Battery saver.** Hardware duty-cycle receive: the SX126x cycles RX↔sleep on its own and wakes on a preamble, cutting average RX current. Trades a little receive latency; leave OFF for lowest-latency reception. Requires an SX126x radio (otherwise stays on continuous RX). **Forced off (shown as `--`) while the repeater is on** — a repeater must listen continuously; your setting is restored when the repeater is switched off. |
| Auto pwr | ON / OFF | **Adaptive Power Control.** Lowers actual TX power on strong links to save energy, ramping back up — to the **TX Pwr** ceiling — on weak or lost links. Link quality comes from direct-message ACK SNR and, for channel messages (no ACK), from hearing a repeater rebroadcast your packet. The radio page / name bar shows the live power. Default OFF (fixed TX power). **Suppressed (shown as `--`) while the repeater is on** — a repeater holds full TX power for consistent relay reach; your setting is restored when the repeater is switched off. |
| OLED | E-Ink |
| :-----------------------: | :-----------------------: |
| ![](./set_scr_3_oled.png) | ![](./set_scr_3_eink.png) |
<!-- screenshot pending: Radio — preset popup (pick/save/delete) and/or the digit-by-digit frequency editor -->
The **repeater** mode and its flood filters live on their own screen — see **Tools › Repeater**.
---

37
docs/solo_features/tools_screen/tools_screen.md
View File

@@ -142,6 +142,13 @@ A waypoint is a saved spot — your car, camp, a water source — that you can n
**Adding by coordinates** — open **Hold Enter → Waypoints** and select the **+ Add by coords** row (always the last entry in the list). This creates a waypoint without being there — no GPS fix required (handy for a meeting point or a spot read off a map). It opens a small form with three editable rows plus **Save**:
| OLED | E-Ink |
| :------------------------: | :------------------------: |
| ![](./tls_scr_13_oled.png) | ![](./tls_scr_13_eink.png) |
<!-- screenshot pending: Add-by-coords form — Lat/Lon scroll editor, hemisphere toggle, Label, Save -->
- **Lat** / **Lon** — **Enter** opens the digit-by-digit scroll editor (the same widget as the radio frequency field): **LEFT/RIGHT** move the cursor between decimal places, **UP/DOWN** change the digit under it, **Enter** confirms. With the editor closed, **LEFT/RIGHT** on the row toggles the hemisphere — N/S for latitude, E/W for longitude.
- **Label** — **Enter** to type a name (blank → auto `WP<n>`).
- **Save** — validates the range and stores the waypoint. Missing or out-of-range values report a brief error.
@@ -157,6 +164,12 @@ A waypoint is a saved spot — your car, camp, a water source — that you can n
Hdg: 090° E ← your current course over ground (-- when stationary)
```
| OLED | E-Ink |
| :------------------------: | :------------------------: |
| ![](./tls_scr_12_oled.png) | ![](./tls_scr_12_eink.png) |
<!-- screenshot pending: Waypoints navigation view — target label, distance, To/Hdg bearings (shared with Nearby/message Navigate) -->
There is no magnetometer, so the screen shows two *absolute* bearings and you compare them: target at 145°, travelling at 90° → bear right. The **Hdg** line is derived from GPS movement (see Compass) and reads `--` until you move.
**Managing** — **Hold Enter** on a waypoint row offers **Rename** / **Delete** / **Send** / **Set as target** (the *Trail start* row is navigate-only). **Set as target** pins the waypoint as the active **Locator/Nav target** in one step (see **Locator**). Delete removes one at a time; there is no bulk clear.
@@ -203,6 +216,12 @@ Periodically broadcasts a 0-hop advert with your GPS position. Configurable inte
## Live Share
| OLED | E-Ink |
| :------------------------: | :------------------------: |
| ![](./tls_scr_11_oled.png) | ![](./tls_scr_11_eink.png) |
<!-- screenshot pending: Live Share screen — Track loc / Auto share / To / Move / Min gap / Heartbeat rows -->
Share your live position over the mesh **as ordinary chat messages**, and put other people who do the same on your map. A position is sent as a `[LOC]<lat>,<lon>` message — the same coordinate format waypoints use, so it stays readable on other firmware and the phone app (it just looks like a coordinate to anything that doesn't know the tag).
This is **independent of Auto-Advert** and runs alongside it: Auto-Advert announces your *presence* as a 0-hop beacon for Nearby Nodes, while Live Share sends your *position* to a specific channel or contact you choose.
@@ -275,6 +294,12 @@ Navigate with **UP/DOWN**, change a value with **LEFT/RIGHT** (or **Enter**); **
## Compass
| OLED | E-Ink |
| :------------------------: | :------------------------: |
| ![](./tls_scr_14_oled.png) | ![](./tls_scr_14_eink.png) |
<!-- screenshot pending: Compass — scrolling heading tape with centre pointer + large degrees/cardinal readout -->
A heads-up GPS compass. The L1 has no magnetometer, so the heading is the **course over ground** — derived from how your GPS position moves over the last few seconds. The display is a horizontal **heading tape**: a fixed travel-direction pointer sits at the centre and the N..E..S..W scale scrolls underneath it as you turn, so whatever is under the pointer is your current course. A large numeric readout below shows that course in degrees and cardinal (e.g. `145° SE`).
Because the heading comes from movement, it only updates while you are actually moving: standing still shows *move to set heading* (and navigation's **Hdg** line reads `--`). Gross GPS jumps are rejected so a single bad fix can't swing the heading. The heading source runs whenever there's a GPS fix — recording a trail is **not** required.
@@ -374,6 +399,12 @@ Commands also work on the **monitored channel** (the one selected for channel mo
## Diagnostics
| OLED | E-Ink |
| :------------------------: | :------------------------: |
| ![](./tls_scr_15_oled.png) | ![](./tls_scr_15_eink.png) |
<!-- screenshot pending: Diagnostics — live device/mesh stats rows (uptime, rx/tx counters, heap, RSSI/SNR, queue, errors) -->
A single read-only screen of live device and mesh stats, refreshed once a second. On a small OLED the rows scroll with **UP/DOWN**; on a larger e-ink display they all fit at once.
| Row | Shows |
@@ -401,6 +432,12 @@ The counters make the repeater behaviour observable: **Forwarded** confirms the
## Repeater
| OLED | E-Ink |
| :------------------------: | :------------------------: |
| ![](./tls_scr_16_oled.png) | ![](./tls_scr_16_eink.png) |
<!-- screenshot pending: Repeater — toggle + Network/profile + flood-filter rows -->
Turns the companion into a packet **repeater** while it keeps working as a normal companion — no separate firmware. By default, enabling it switches the radio to a dedicated repeater profile rather than relaying on whatever network you're chatting on (see **Network** below) — that matches the MeshCore community norm of repeaters sitting on a standard channel, not a private one. Loop-detection and an advert flood-depth cap are always applied. This screen keeps the toggle, the network/profile, and its flood-filter options together; live forwarding stats are on **Tools › Diagnostics**.
Navigate with **UP/DOWN**; change a value with **LEFT/RIGHT** (or **Enter** for toggles). **Cancel/Back** saves and returns to Tools.