From 60df2a326817071593465a206e1f600caeb263c6 Mon Sep 17 00:00:00 2001 From: Jakub <106778416+MarekZegare4@users.noreply.github.com> Date: Wed, 7 Oct 2026 22:05:32 +0200 Subject: [PATCH] docs: 4.2" e-ink, alerts and the USB bolt, scope Default, L2 GPS tabs; rc2 release notes Co-Authored-By: Claude Sonnet 5.5 --- README.md | 2 +- docs/solo/getting-started.md | 32 ++++++++++++++++++++++++++------ docs/solo/hardware.md | 14 +++++++++++--- docs/solo/img/eink42-status.png | Bin 0 -> 5625 bytes docs/solo/messages.md | 2 +- docs/solo/settings.md | 4 ++-- docs/solo/tools.md | 7 +++++-- release-notes.md | 27 +++++++++++++++++++++++++++ 8 files changed, 73 insertions(+), 15 deletions(-) create mode 100644 docs/solo/img/eink42-status.png diff --git a/README.md b/README.md index 0f8dbf4c..1887873d 100644 --- a/README.md +++ b/README.md @@ -17,7 +17,7 @@ Discussion: [MeshCore Discord](https://discord.gg/sdhYArU2jr) — [Solo firmware | Device | MCU | Display | Firmware file | | ------ | --- | ------- | ------------- | | Seeed Wio Tracker L1 (OLED) | nRF52840 | SSD1306 / SH1106 128 × 64 | `solo--WioTrackerL1.uf2` | -| Seeed Wio Tracker L1 (E-ink) | nRF52840 | GxEPD2 250 × 122 | `solo--WioTrackerL1Eink-landscape.uf2` or `-portrait.uf2` | +| Seeed Wio Tracker L1 (E-ink) | nRF52840 | GxEPD2 250 × 122, or 4.2" 400 × 300 | `solo--WioTrackerL1Eink-landscape.uf2`, `-portrait.uf2` or `solo--WioTrackerL1Eink42.uf2` | | Seeed Wio Tracker L2 | ESP32-S3 | 320 × 240 touch LCD | `solo--Wio-Tracker-L2-merged.bin` | | GAT562 30S Mesh Kit | nRF52840 | SSD1306 128 × 64 | `solo--GAT562-30S-Mesh-Kit.uf2` | | GAT562 Mesh Watch13 *(experimental)* | nRF52840 | SSD1306 128 × 64 | `solo--GAT562-Mesh-Watch13.uf2` | diff --git a/docs/solo/getting-started.md b/docs/solo/getting-started.md index 746a03c3..7cf141e5 100644 --- a/docs/solo/getting-started.md +++ b/docs/solo/getting-started.md @@ -36,17 +36,21 @@ order: | **Status** | Radio, GPS, battery and mesh at a glance; Enter opens the [Status screen](./tools.md#status) | | **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 | +| **Settings** | All settings, then brightness and GPS on / off | | **Map** | Your position, the trail, people sharing theirs and the target ([Navigation](./navigation.md#map)) | -| **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 | +| **Tools** | All tools, then the two you used last with their state | +| **Messages** | All messages, then the two latest conversations with their unread counts | | **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 +Most pages are **quick panels**: a few rows, the first of which opens the +full screen, the rest shortcuts. **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. +A tool opened from the Tools page returns to the home screen on **Back**; +one opened from the full Tools list returns to that list. + Settings › Home Pages sets their order and hides the ones you don't use; Settings and Messages are always shown. @@ -61,6 +65,21 @@ Settings and Messages are always shown. > sets the brightness. Hold a tile for its settings. Swipe it up, or tap > below it, to put it away. +## Alerts and the battery + +A new message, a changed setting and similar notices drop in as a banner from +the top of the screen and slide away after a moment; on e-ink they just +appear and go. A message's lasts two seconds. Typing on the keyboard isn't +interrupted. + +The battery sits at the top right, as an icon, a percentage or the voltage +(Settings › Display). A small bolt beside it means external power is +connected over USB. + +> [!NOTE] +> Boards without a way to sense USB power (the Heltec V3, V4 and the +> Cardputer ADV) don't show the bolt. + ## Connecting the phone app Every build serves the MeshCore app over **Bluetooth and USB**, one at a time: @@ -68,7 +87,8 @@ 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. +is paired. Switching Bluetooth off keeps it off after a restart or +hibernation, until you switch it on again. > [!NOTE] > **Wio Tracker L2:** the PIN is under Settings › Bluetooth. diff --git a/docs/solo/hardware.md b/docs/solo/hardware.md index fdfe5118..1c86e8f1 100644 --- a/docs/solo/hardware.md +++ b/docs/solo/hardware.md @@ -64,16 +64,24 @@ Fn shortcuts. ## E-ink -The e-ink Wio Tracker L1 (250 × 122) comes in two builds, one per +The e-ink Wio Tracker L1 comes in three builds, one per screen and orientation, since every screen is laid out for one shape: -- **Landscape** writes in a larger 8 × 13 font, with larger icons. -- **Portrait** keeps the 6 × 9 font and fits more lines. +- **Landscape** (250 × 122) writes in a larger 8 × 13 font, with larger icons. +- **Portrait** (250 × 122) keeps the 6 × 9 font and fits more lines. +- **4.2"** (400 × 300, Good Display GDEY042T81, on the same wiring in place of + the 2.13") writes in a 9 × 15 font with its own icon set, and uses the + room for tiles on the status page, a node list with a detail pane, charts, + the sky view and the clock tools. | Landscape | Portrait | | | :---: | :---: | :---: | | ![A channel in landscape](./img/eink-channel.png) | ![Clock and calendar in portrait](./img/eink-clock.png) | ![The sky view in portrait](./img/eink-sky.png) | +| 4.2" | +| :---: | +| ![The status page on the 4.2"](./img/eink42-status.png) | + The e-ink screens show more than the OLED, the portrait one most: - a month calendar (portrait) under the clock and on the lock screen, the diff --git a/docs/solo/img/eink42-status.png b/docs/solo/img/eink42-status.png new file mode 100644 index 0000000000000000000000000000000000000000..cb051e41cd9652ed1a41c9fd8bb61a70db8065ea GIT binary patch literal 5625 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 [!NOTE] > **Wio Tracker L2:** the Diagnostics app, with a **Noise** tab that -> measures the noise floor over time, and the **GPS** app, which draws a sky -> plot of the satellites and each one's signal strength. +> measures the noise floor over time and history charts you can touch for the +> value at that moment, and the **GPS** app, on three tabs: **Sky** (a plot +> of the satellites and the fix), **Signal** (a bar per satellite with its +> strength, and the constellations) and **Details** (position, precision, +> time to first fix and what the receiver reports). ## GPIO diff --git a/release-notes.md b/release-notes.md index 0a5a2bf4..1606f0bc 100644 --- a/release-notes.md +++ b/release-notes.md @@ -1,3 +1,30 @@ +## MeshCore Solo Companion Firmware v2.0-rc2 + +### What's new + +- **A third Wio Tracker L1 E-ink build, for a 4.2" 400 × 300 panel** (`WioTrackerL1Eink42`), with a 9 × 15 font, its own icons, and screens laid out for the room: tiles on the status page, a node list with a detail pane, charts, the sky view and the clock tools. +- **Alerts drop in from the top** on the OLED and E-ink builds, as a banner that slides down and away, instead of a box over the middle of the screen. A new-message alert lasts two seconds; on E-ink it simply appears and goes. +- **A bolt beside the battery when USB power is connected.** Where the board can sense it (the nRF52 boards, the Wio Tracker L2); the screen redraws as the cable goes in or out. +- **The splash grows with the screen**, and the start-up "Loading..." is three dots in the middle of the screen, so it needs no orientation. +- **Wio Tracker L2:** + - GPS on three tabs: Sky, Signal (a bar per satellite, with a dB-Hz scale) and Details. + - Charts with a value axis, a grid and a readout under your finger; the big clock in the splash's lettering. + - The USB-drive offer waits until the screen is unlocked, with a PIN or without. + - A pull-down quick panel from the status bar, and a faster screen fade. +- **A channel's scope can follow the default.** "Default" is the new start value for a channel, and follows whichever scope the list marks as default; `*` still sends unscoped. +- **Home panels list the way in first:** "All settings", "All messages" and "All tools" head their panels, the shortcuts after. +- **On / Off** are written the same way on every screen, and the GPS switch no longer looks like a battery. + +### Fixes + +- **Settings were lost on restart on a device that had run Meshtastic.** It leaves a `/prefs` folder behind, which our settings file could neither be read from nor saved over, so no change survived. The folder is now removed on start. +- **Bluetooth switched off stays off** over a reboot or hibernation. +- **A tool opened from the Tools page goes back to Home** on Back, not to the full tools list. +- **A change made in Settings is saved** on the way to a screen opened from it. +- **L2 GPS signal chart** spans its box from the first bar. + +--- + ## MeshCore Solo Companion Firmware v2.0-rc1 A release candidate for 2.0: please report anything that looks wrong before the final release.