{ "id": "meshcore-solo", "name": "MeshCore Solo", "type": "fork", "maintainer": "MarekZegare4", "maintainers": [ { "name": "MarekZegare4", "url": "https://github.com/MarekZegare4" } ], "maintainerUrl": "https://github.com/MarekZegare4", "repository": "https://github.com/MarekZegare4/MeshCore-Solo", "website": "https://marekzegare4.github.io/Solo-tools/", "license": "MIT", "description": "A fork of the official MeshCore companion radio firmware with extended features and UI enhancements. Adds GPS navigation (waypoints, compass, trail recording with GPX export), battery power-saving (hardware RX duty-cycle + adaptive power control), favourite contacts dial, extended language support with native Unicode rendering, message delivery status, screen lock, auto-reply bot, repeater mode with diagnostics, and more — all optimized for joystick-only navigation on small displays.\n", "status": "active", "lifecycle": "active", "maturity": "stable", "distribution": "community", "lineage": { "kind": "fork", "upstreamFirmwareId": "meshcore-official", "upstreamRepository": "https://github.com/meshcore-dev/MeshCore" }, "runtime": { "framework": "arduino", "language": "cpp" }, "roles": [ "companion", "repeater", "standalone-ui" ], "features": [ "Extended Unicode support with Lemon font and native input", "GPS navigation suite (waypoints, compass, backtrack, trail recording)", "GPX export via USB serial", "Screenshot capture over USB", "Favourites dial for pinned contacts", "Message delivery status indicators", "DM auto-resend and incoming deduplication", "Screen lock with time and sensor display", "Auto-reply bot with command responses", "Auto-advert for location sharing", "Battery power saving (RX duty-cycle + APC)", "Companion repeater mode with diagnostics", "Ping functionality in Nearby Nodes", "SOS broadcast with configurable target", "Quiet hours for sound suppression", "Mark-all-read at type level", "Lock-screen unread count", "Channel scanner home page", "Contact distance sorting", "Signal stats screen", "Display test pattern", "Power profile presets", "Solo Tools web app for screenshot capture and GPX export (https://marekzegare4.github.io/Solo-tools/)" ], "capabilities": { "protocol": { "meshcoreCompatible": true, "rawPacketSend": true, "rawPacketObserve": true }, "transports": { "ble": true, "usbSerial": true, "nativeTcp": false, "wifiAp": false }, "operations": { "webFlasher": false, "ota": false, "bleDfu": false, "configurationBackup": true }, "networking": { "repeater": true, "roomServer": false, "observer": false, "mqtt": false, "kissModem": false }, "hardware": { "gps": true, "display": true, "sensors": true, "lowPowerRx": true } }, "changelog": { "source": "github", "repo": "MarekZegare4/MeshCore-Solo" }, "devices": [ { "id": "wio-tracker-l1", "status": "supported", "target": "wio-tracker-l1", "platformio_board": "seeed-wio-tracker-l1", "notes": "OLED variant (SSD1306/SH1106 128x64)" }, { "id": "wio-tracker-l1-pro", "status": "supported", "target": "wio-tracker-l1", "platformio_board": "seeed-wio-tracker-l1", "notes": "OLED variant — same firmware target as wio-tracker-l1" }, { "id": "wio-tracker-l1-eink", "status": "supported", "target": "wio-tracker-l1-eink", "platformio_board": "seeed-wio-tracker-l1", "notes": "E-ink variant (GxEPD2 250x122)" }, { "id": "gatiot-gat562-30s", "status": "supported", "target": "gat562_30s_mesh_kit", "platformio_board": "rak4631", "notes": "GAT562 30S Mesh Kit" } ], "source": { "path": "data/firmwares/meshcore-solo/firmware.yaml", "updatedAt": "2026-06-22T21:31:07+02:00" }, "latest_version": "1.20", "released": "2026-06-22", "releases": [ { "version": "v1.20", "name": "Solo v1.20", "datetime": "2026-06-22T08:51:38Z", "url": "https://github.com/MarekZegare4/MeshCore-Solo/releases/tag/v1.20", "prerelease": false, "notes": "## MeshCore Solo Companion Firmware v1.20\r\n\r\n### What's new\r\n\r\n- **Repeater mode** — a solo companion can now opt in to relaying mesh traffic, configured from a dedicated **Tools › Repeater** screen that consolidates the toggle, the forwarding filters, live forwarding stats, and a separate radio profile:\r\n - **Forwarding filters** (all flood-only, off by default) — *skip-advert* (don't re-flood the highest-volume advert traffic), *max-hops* (drop a flood once it has travelled too far), *yield* (extra retransmit-delay so a mobile node defers to better-sited fixed repeaters), and *min-SNR* (don't re-flood marginal fringe packets). Plus **overhear suppression**, which cancels a queued retransmit if a peer relays the same packet first.\r\n - **Dedicated radio profile** — an optional \"Custom\" Freq/SF/BW/CR used only while relaying, separate from the companion's own network and band-matched to the companion frequency by default. It's applied everywhere a radio change can happen (boot, on-device toggle, app-driven `CMD_SET_RADIO_PARAMS`, Settings edits) so the device never silently relays on the wrong params.\r\n - While relaying, **Adaptive Power Control is pinned to the ceiling** and **duty-cycle RX is forced off** — a repeater needs to hear and relay at consistent power.\r\n- **Radio settings overhaul** (Settings › Radio) — **16 community-suggested presets** plus manual Freq/SF/BW/CR tuning (digit-by-digit frequency editor), and **4 persisted user preset slots**. Presets and the manual editor are now **shared between Settings and the Repeater screen** — a preset saved from either place shows up in both, and you can **save the current profile as a named preset** or **delete one** from either screen.\r\n- **On-device Diagnostics** (Tools › Diagnostics) — a single scrollable screen showing packet counts by category (RX/TX), radio noise floor / RSSI / SNR, packet-pool free count and outbound queue length, actually-forwarded packet count, uptime, and live heap/stack headroom, with a reset-counters popup.\r\n\r\n### Fixes\r\n\r\n- **Channel storage hardening** — `saveChannels()` skips unused (all-zero) slots, so `/channels2` holds only configured channels instead of always writing ~2.7 KB; and `findChannelIdx()` rejects an all-zero secret so a corrupted/empty channel can't match an unused slot and misroute messages.\r\n- **e-ink UI scaling** — self-sizing popup menu scaled for landscape e-ink (no stray header gap, tighter row tiling); popup menu uses the shared proportional scroll indicator instead of raw `^`/`v` glyphs and stops the selection bar before the scrollbar gutter; compass tape ticks/pointer and trail-map markers scale for e-ink, with wrap-around map navigation.\r\n- **Joystick rotation** is now persisted on e-ink builds.\r\n- **Trail capacity guard** — a `static_assert` fails the build if `TrailStore::CAPACITY` ever outgrows the `uint16_t` save-header count, instead of silently truncating.\r\n\r\n### Under the hood\r\n\r\n- Packet pool bumped 16 → 32 so queued retransmits no longer starve incoming-packet allocation while relaying.\r\n- Shared, UITask-decoupled `RadioPresetPicker` and `RadioParamsEditor` (plus `nearestBwIndex()` in `RadioPresets.h`) replace ~6 duplicated methods and several state fields per screen.\r\n- Mesh `Dispatcher` gains generic per-payload-type RX/TX counters and pool-free / queue-length getters; a new `DeviceDiag` helper reports nRF52 heap (linker-symbol + `sbrk`) and stack (FreeRTOS high-water-mark) headroom.\r\n- `build.sh` tolerates control characters in `pio project config`'s JSON dump.", "notesHtml": "

MeshCore Solo Companion Firmware v1.20

\n

What's new

\n\n

Fixes

\n\n

Under the hood

\n\n" }, { "version": "v1.19", "name": "Solo v1.19", "datetime": "2026-06-16T08:11:43Z", "url": "https://github.com/MarekZegare4/MeshCore-Solo/releases/tag/v1.19", "prerelease": false, "notes": "## MeshCore Solo Companion Firmware v1.19\r\n\r\n### What's new\r\n\r\n- **Message delivery status** — outgoing messages now show an end-to-end delivery marker, auto-scaled to the font (legible on landscape e-ink), in both the history list and the fullscreen view:\r\n - **Direct messages** (and room servers): pending → delivered (✓) → failed (✗), driven by the real end-to-end ACK. While pending, a row of dots shows one per send so auto-resend progress is visible.\r\n - **Auto-resend** — a pending DM whose ACK times out is re-sent automatically (reusing the original timestamp) until resends run out. Configurable count under Settings › Messages › Resend (0–5, default 2). Runs in the background, independent of which screen is open; incoming duplicates from retries are dropped.\r\n - **Channels** — ✓ appears only once a repeater echo confirms the message was relayed into the mesh. No echo is normal (flood has no recipient ACK), so no pending/fail is shown.\r\n- **Auto-reply bot overhaul** — the trigger/reply bot grows into a small auto-responder:\r\n - **Query commands** — a DM or monitored-channel message is scanned for `!` tokens (`!ping !batt !loc !time !temp !hops !status !help`) and answered in one combined reply.\r\n - **Away / reply-to-all** — a lone `*` trigger replies to every message.\r\n - **Separate DM and channel triggers**, each with its own reply text.\r\n - **Quiet hours** — silence push replies during a chosen window (wraps midnight).\r\n - **Throttling & anti-loop** — per-contact DM throttle so one sender can't starve others; channel echo guard so the bot never answers itself; reply counter shown in the bot screen header.\r\n- **Keyboard overhaul** — one shared keyboard across all screens (reclaims duplicate RAM), icon keys (⇧ caps, ⎵ space, ⌫ delete, ✓ OK), and a second **symbols page** toggled with `#@`/`abc`.\r\n- **UI refresh**\r\n - Proportional **scrollbar** with up/down triangle caps replaces the old `^`/`v` arrows, scaling with the font (1× OLED, 2× landscape e-ink); used by every scrollable list and the fullscreen message view. The redundant `>` selection marker is gone and rows shifted left to reclaim space.\r\n - Status-bar single-letter indicators (M/B/A/G) replaced with scalable **mini-icons** (mute, bluetooth, advert, trail).\r\n- **Nearby Nodes reorganized** — one list over two sources (stored contacts + live discover scan) with a unified detail/action menu. Type filter and sort are independent axes and persist across re-entry; the active filter is shown in the title and in empty-list messages.\r\n- **Tools › Trail reorganized** — a short two-level action menu (Hold Enter) replaces the flat ~12-item list; view-aware settings; a fitted **square map grid**; and the waypoint manager split out into its own component. No change to trail recording itself.\r\n- **OTA updates** — each solo release now ships a DFU `.zip` (`solo---ota.zip`) for over-the-air / BLE-DFU updates, alongside the `.uf2` for USB flashing.\r\n\r\n### Fixes\r\n\r\n- **GPS battery drain on shutdown** — GPS is powered off before `SYSTEMOFF`, and uses the correct active-level (`!PIN_GPS_EN_ACTIVE`) instead of a hardcoded level.\r\n- **Buzzer octave 8** — the RTTTL parser now fully accepts octave 8 instead of clamping it away (which could leak a digit into the next note's duration).\r\n- **Trail file robustness** — `Waypoint`/trail readers check every header read, so a truncated file is rejected instead of using a garbage count.\r\n\r\n### Under the hood\r\n\r\n- OTA DFU zip is named and attached to releases by the `_solo_dual` build workflow; the per-build Actions artifact already carried it.\r\n- Large UI consolidation: shared `drawList` / header / key-decode helpers, deduplicated status-bar indicators, reusable scalable mini-icon facility (`icons.h`), and an audit-pass cleanup premoving dead code and redundant scroll-clamp logic.", "notesHtml": "

MeshCore Solo Companion Firmware v1.19

\n

What's new

\n\n

Fixes

\n\n

Under the hood

\n\n" }, { "version": "v1.18", "name": "Solo v1.18", "datetime": "2026-06-14T08:22:51Z", "url": "https://github.com/MarekZegare4/MeshCore-Solo/releases/tag/v1.18", "prerelease": false, "notes": "## MeshCore Solo Companion Firmware v1.18\r\n\r\n### New device support\r\n\r\n- **GAT562 30S Mesh Kit** — the firmware now supports the GAT562 30S alongside the Wio Tracker L1 family. Pre-built `.uf2` files for all supported devices are published with each release — see the [Supported Devices](https://github.com/MarekZegare4/MeshCore-Solo#supported-devices) table.\r\n\r\n### What's new\r\n\r\n- **GAT562 30S Mesh Kit support** — see above.\r\n- **Battery saving (radio)** — two new independent toggles under Settings › Radio:\r\n - **Pwr save** — hardware duty-cycle receive (SX126x `SetRxDutyCycle`): the radio cycles RX↔sleep autonomously and wakes on a preamble, cutting average RX current with only a small increase in receive latency\r\n - **Auto pwr** — Adaptive Power Control: trims TX power on strong links (based on ACK SNR) and ramps back up on weak or lost links; the home screen shows the live transmit power\r\n- **BLE disconnect icon fix** — the BLE status icon now updates immediately when the connection drops (e.g. out of range, supervision timeout). Previously it could stay active until the next UI polling cycle.\r\n- **Bot trigger preserves case** — the auto-reply trigger phrase is now stored exactly as typed. Matching remains case-insensitive, so `Ping`, `ping` and `PING` all trigger the bot, but the trigger no longer gets silently lowercased when saved.\r\n- **Screenshot support in all solo builds** — `ENABLE_SCREENSHOT` is now enabled in every solo firmware build. No need to use a separate `_dev` environment. Use the [Solo Tools](https://marekzegare4.github.io/Solo-tools/) web app to capture screenshots directly from the browser.\r\n\r\n\r\n### Under the hood\r\n\r\n- CI matrix for solo firmware builds is now fully dynamic — new devices are picked up automatically from `platformio.ini` based on the `_solo_dual` env suffix, no workflow changes required.\r\n- `AbstractUITask::onBLEDisconnected()` virtual hook added — called by `setHasConnection()` on transition to disconnected; `UITask` overrides it to set `_next_refresh = 0`.\r\n- `build.sh` gains `build-solo-firmwares` command, backed by `build_all_firmwares_by_suffix \"_solo_dual\"`.", "notesHtml": "

MeshCore Solo Companion Firmware v1.18

\n

New device support

\n\n

What's new

\n\n

Under the hood

\n\n" }, { "version": "v1.17", "name": "Solo v1.17", "datetime": "2026-06-09T15:33:39Z", "url": "https://github.com/MarekZegare4/MeshCore-Solo/releases/tag/v1.17", "prerelease": false, "notes": "## Wio Tracker L1 — Solo Firmware v1.17\r\n\r\n### What's new\r\n\r\n- **Nearby Nodes — navigate & save waypoints from the list** — the context menu now exposes _Navigate_ and _Save waypoint_ directly from the Nearby list and detail view, so you no longer have to open the separate Tools → Waypoints screen. Long-press Options in the detail view also opens a _Ping_ submenu.\r\n- **Nearby Nodes — TIME sort filter** — a new `[TIME]` filter sorts contacts by last-seen time (most recent first) instead of distance, useful when GPS is unavailable.\r\n- **Battery indicator calibrated** — the 100 % ceiling of the LiPo discharge curve was corrected from 4200 mV to 4170 mV, matching what the board's charger actually delivers.\r\n- **Advert sound scope control** — a new _Sound → Advert_ setting lets you choose whether advert notifications play for all nodes or only direct (zero-hop) neighbours, cutting noise on busy meshes.\r\n- **Sound slot \"None\" option** — DM, channel and advert melody slots can now be set to _None_ to silence that notification category entirely without muting everything.\r\n- **Mark-as-read feedback** — marking messages read (per-contact or per-channel) now shows a brief _\"N marked read\"_ confirmation on screen.\r\n- **[Web tool] GPX Downloader** — a standalone web page for downloading saved GPX trails from the device over the browser's Web Serial API, no desktop app required.\r\n\r\n### Under the hood\r\n\r\n- `SoundNotifier` extracted from `UITask::notify()` — all buzzer/melody logic lives in one place, reducing future merge conflict surface with upstream.\r\n- `KeyboardWidget` is now a single shared instance across screens (saves ~1.5 KB heap).\r\n- `onDiscoveredAdvert` extracted as a separate virtual so upstream `onDiscoveredContact` keeps its original 4-parameter signature.", "notesHtml": "

Wio Tracker L1 — Solo Firmware v1.17

\n

What's new

\n\n

Under the hood

\n\n" }, { "version": "v1.16", "name": "Solo v1.16", "datetime": "2026-06-06T16:35:39Z", "url": "https://github.com/MarekZegare4/MeshCore-Solo/releases/tag/v1.16", "prerelease": false, "notes": "## Wio Tracker L1 — Solo Firmware v1.16\r\n\r\nRebases the Solo fork onto upstream MeshCore **v1.16.0** (254 commits)\r\n\r\n### What's new (from upstream)\r\n\r\n- **NRF52 power-saving** — the companion now puts the MCU to sleep whenever there's no pending work, instead of looping continuously between events.\r\n- **Better reception of longer messages at low spreading factors** — the LoRa preamble is now 32 (was 16) for SF below 9, which makes longer frames more reliable on weak links.\r\n- **More robust sensors** — the I²C sensor subsystem was rewritten to probe the bus before touching any device, so an absent or misbehaving sensor can no longer hang or crash the node.\r\n- **Charging-aware shutdown** — the device no longer auto-shuts-down on low battery while it's on external power, and shows a shutdown warning on OLED.\r\n- **New companion command** for sending raw packets, plus assorted CLI additions (`flood.max.advert`, `flood.max.unscoped`, region hierarchy) and bounds-checking fixes that the phone app and repeaters benefit from.\r\n- **Battery-voltage reading fix** carried in from upstream.", "notesHtml": "

Wio Tracker L1 — Solo Firmware v1.16

\n

Rebases the Solo fork onto upstream MeshCore v1.16.0 (254 commits)

\n

What's new (from upstream)

\n\n" }, { "version": "v1.15.1", "name": "Solo v1.15.1", "datetime": "2026-06-05T11:31:47Z", "url": "https://github.com/MarekZegare4/MeshCore-Solo/releases/tag/v1.15.1", "prerelease": false, "notes": "## Wio Tracker L1 — Solo Firmware v1.15.1\r\n\r\nHotfix for Bluetooth pairing and buzzer regressions in v1.15 (introduced by the Advert-sound change). No schema change — upgrade in place from v1.15.\r\n\r\n### Fixes\r\n\r\n- **Bluetooth pairing PIN is shown again** — on the published OLED + e-ink (dual BLE+USB) builds the pairing PIN was never drawn, so the phone asked for a code that wasn't displayed and pairing failed. The PIN now appears on the **Bluetooth** home page while BLE is on and not yet bonded.\r\n- **Auto buzzer mute works again** — in v1.15 \"Auto\" was effectively always muted on dual builds (the connection state was hardcoded true). It now mutes only when a companion app is actually connected — **BLE bonded or a host holding the USB serial port open** — and stays audible on charge-only / no host. (Plain serial monitors that assert DTR count as connected.)\r\n- **Bluetooth status indicator** — the top-bar BT dot again reflects a real BLE connection instead of showing connected permanently.\r\n- **New-message display wake** — the screen wakes for an incoming message again when no app is connected.\r\n\r\n### Background\r\n\r\nv1.15's advert-sound feature broadened the internal \"connected\" flag from BLE-bonded to *any* transport, but the dual interface always reports its send-fallback as connected — so everything keyed off \"connected\" (PIN prompt, Auto mute, BT indicator, message-wake) misbehaved. This release splits the two notions: BLE-specific UI uses the BLE bond state, while Auto mute / message-wake use a new \"app connected over BLE or USB\" check (USB detected via the CDC DTR line).", "notesHtml": "

Wio Tracker L1 — Solo Firmware v1.15.1

\n

Hotfix for Bluetooth pairing and buzzer regressions in v1.15 (introduced by the Advert-sound change). No schema change — upgrade in place from v1.15.

\n

Fixes

\n\n

Background

\n

v1.15's advert-sound feature broadened the internal \"connected\" flag from BLE-bonded to any transport, but the dual interface always reports its send-fallback as connected — so everything keyed off \"connected\" (PIN prompt, Auto mute, BT indicator, message-wake) misbehaved. This release splits the two notions: BLE-specific UI uses the BLE bond state, while Auto mute / message-wake use a new \"app connected over BLE or USB\" check (USB detected via the CDC DTR line).

\n" }, { "version": "v1.15", "name": "Solo v1.15", "datetime": "2026-06-04T15:35:06Z", "url": "https://github.com/MarekZegare4/MeshCore-Solo/releases/tag/v1.15", "prerelease": false, "notes": "## Wio Tracker L1 — Solo Firmware v1.15\r\n\r\nAdds a full **GPS navigation suite** on top of Solo v1.14 — the L1 becomes a standalone off-grid navigator, no phone required.\r\n\r\n### Highlights\r\n\r\n- **Waypoints** — mark your current spot or type coordinates, give it a short label, then get live bearing + distance back to it. Ideal for car / camp / water / a meeting point.\r\n- **GPS compass** — *Tools › Compass*: a heads-up heading tape derived from GPS course-over-ground. No magnetometer needed.\r\n- **Navigate to anything** — a saved waypoint, the start of your trail (backtrack), a node from Nearby Nodes, or a location someone texts you.\r\n- **Share & save locations over the mesh** — send a waypoint in a message; on the other end, navigate to or save any shared location with one menu.\r\n- **Global Units setting** — one Metric / Imperial switch (Settings › System) drives every distance and speed in the UI.\r\n- **Advert sound** — an optional audible \"in range\" heartbeat: the device chirps when it receives an advert from another node — pair it with Auto-Advert to keep tabs on a buddy hands-free.\r\n\r\n### Changes\r\n\r\n**Navigation (new)**\r\n\r\n- **Waypoints** — *Tools › Trail › Hold Enter*: **Mark here** drops one at the current GPS fix; **Waypoints** opens the list, which carries a synthetic **Trail start** backtrack row, a usage counter (`WAYPOINTS 3/16`), and a **+ Add by coords** row to enter a point by lat/lon/label with no fix required (hemisphere chosen with LEFT/RIGHT since the keyboard has no minus key). Per-waypoint **Rename / Delete / Send**, plus **Clear waypoints**. Stored in their own `/waypoints` file (16 max) — independent of the trail and **not** cleared by Reset trail.\r\n- **Navigate-to-point view** — distance plus two *absolute* bearings, **To:** (target) and **Hdg:** (your course over ground), compared by eye. Reused by waypoints, trail backtrack, Nearby-node navigation and message-shared locations.\r\n- **GPS compass** — *Tools › Compass*: a scrolling N..E..S..W heading tape under a fixed travel-direction pointer, with a large degrees + cardinal readout. Works whether or not a trail is recording.\r\n- **Navigate to a node** — Nearby Nodes detail → **Hold Enter** now opens an Options menu (**Navigate** / **Ping**); Navigate opens the bearing/distance view targeting the node's last-known position.\r\n- **Trail map as a live view** — the Map draws your current position and all waypoints continuously, even with no trail recording. While a trail exists it frames the recorded route and clamps far-off waypoints to the nearest edge (a distant mark can't blow up the scale); with no trail it auto-fits to your waypoints and position. Markers show the first two label characters, placed edge-aware so labels stay on-map.\r\n- **Navigate / save a shared location** — any message carrying a `lat,lon` (what `{loc}` inserts) or a `[WAY]lat,lon label` share offers **Navigate** and **Save waypoint** from its **Hold Enter** menu — on the history row or in fullscreen, for DMs and channels. **Send** on a waypoint shares it to a contact or channel, pre-filling the message to confirm.\r\n- **Waypoints in GPX** — the GPX export now includes saved waypoints as `` elements (label → ``, plus `