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 00000000..cb051e41 Binary files /dev/null and b/docs/solo/img/eink42-status.png differ diff --git a/docs/solo/messages.md b/docs/solo/messages.md index 7e90ab06..0d1bee16 100644 --- a/docs/solo/messages.md +++ b/docs/solo/messages.md @@ -90,7 +90,7 @@ correctly whatever the keyboard is set to. | Mark all read | Clears its unread count | | Notif, Melody | Its own notification and sound, instead of the global ones | | Fav | Marks it as a favourite (shared with the app) | -| Scope | The region its messages are tagged with (`*` = none); the list is in Settings › Radio › Scope | +| Scope | The region its messages are tagged with: **Default** follows the list's default, `*` sends none; the list is in Settings › Radio › Scope | | Pin to dial | Puts it on the Favourites page | | Edit, Delete | Renames it or changes its secret; removes it | diff --git a/docs/solo/settings.md b/docs/solo/settings.md index fdece2af..8fda38b1 100644 --- a/docs/solo/settings.md +++ b/docs/solo/settings.md @@ -22,8 +22,8 @@ A few notes: ones; the power set above is the ceiling. - **Scope** is a list of named regions (plus `*`, no region). Messages are tagged with a scope so repeaters can tell communities on the same frequency - apart. The default one is used for direct messages and repeating, and each - channel picks its own (see [Messages](./messages.md#channels)). Anyone who + apart. The default one is used for direct messages and repeating, and a channel + follows it unless it picks its own (see [Messages](./messages.md#channels)). Anyone who types the same name gets the same scope; it isn't encryption. - **Low battery** shuts the device down at the voltage you choose, which is also 0 % on the battery indicator. diff --git a/docs/solo/tools.md b/docs/solo/tools.md index 938f896c..027f5eac 100644 --- a/docs/solo/tools.md +++ b/docs/solo/tools.md @@ -108,8 +108,11 @@ locator) keeps it on. > [!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.