From 8df289fb16b373869344768282c0d5332b1275ef Mon Sep 17 00:00:00 2001 From: MarekZegare4 Date: Wed, 24 Jun 2026 18:11:55 +0200 Subject: [PATCH] docs: add screenshot placeholders for un-illustrated screens 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 --- .../clock_screen/clock_screen.md | 6 +++ .../favourites_dial/favourites_dial.md | 6 +++ .../settings_screen/settings_screen.md | 6 +++ .../tools_screen/tools_screen.md | 37 +++++++++++++++++++ 4 files changed, 55 insertions(+) diff --git a/docs/solo_features/clock_screen/clock_screen.md b/docs/solo_features/clock_screen/clock_screen.md index 790191d3..68df527e 100644 --- a/docs/solo_features/clock_screen/clock_screen.md +++ b/docs/solo_features/clock_screen/clock_screen.md @@ -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) | + + + **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**. diff --git a/docs/solo_features/favourites_dial/favourites_dial.md b/docs/solo_features/favourites_dial/favourites_dial.md index ee55a4a6..20edaccb 100644 --- a/docs/solo_features/favourites_dial/favourites_dial.md +++ b/docs/solo_features/favourites_dial/favourites_dial.md @@ -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) | + + + 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"). diff --git a/docs/solo_features/settings_screen/settings_screen.md b/docs/solo_features/settings_screen/settings_screen.md index e23298af..f01c15b6 100644 --- a/docs/solo_features/settings_screen/settings_screen.md +++ b/docs/solo_features/settings_screen/settings_screen.md @@ -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) | + + + The **repeater** mode and its flood filters live on their own screen — see **Tools › Repeater**. --- diff --git a/docs/solo_features/tools_screen/tools_screen.md b/docs/solo_features/tools_screen/tools_screen.md index c4a49999..bd52e944 100644 --- a/docs/solo_features/tools_screen/tools_screen.md +++ b/docs/solo_features/tools_screen/tools_screen.md @@ -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) | + + + + - **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`). - **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) | + + + 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) | + + + 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],` 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) | + + + 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) | + + + 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) | + + + 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.