Wio Tracker L1 — Extended Companion Radio Firmware

This branch extends the official MeshCore companion radio firmware for the Seeed Wio Tracker L1 (NRF52840 + SX1262 + SH1106 OLED 128×64 + GPS + buzzer + 5-way joystick).

New Build Variants

In addition to the standard _companion_radio_usb and _companion_radio_ble builds, two new variants are available with a full settings screen:

Environment	Interface
`WioTrackerL1_companion_radio_usb_settings`	USB serial
`WioTrackerL1_companion_radio_ble_settings`	Bluetooth LE

The settings screen is accessed by navigating to the last page of the home screen and pressing Enter.

New Features

Settings Screen

All settings are saved to flash and restored on next boot.

Setting	Options	Default
Display brightness	5 levels (very dim → max)	Medium
Buzzer	ON / OFF	ON
TX Power	2 – 22 dBm	Board default
Auto-off delay	5 s / 15 s / 30 s / 60 s / never	15 s
GPS update interval	off / 30 s / 1 min / 5 min / 15 min / 30 min	off
Timezone	UTC−12 .. UTC+14	UTC
Low battery shutdown	off / 3.0 V – 3.5 V	3.4 V
Battery display	icon / % / voltage	icon

Clock Screen

A dedicated clock page on the home screen shows the current time and date, synchronized from GPS. Timezone is applied from the settings above.

Battery Display Modes

The top-right battery indicator can be switched between:

Icon — classic fill bar
% — percentage, where 0% = low battery shutdown threshold (if set), otherwise 3.2 V
V — live voltage (e.g. 3.84V)

Battery voltage is filtered with an exponential moving average (α = 0.2) to smooth out ADC noise from uneven load.

Low Battery Auto-Shutdown

When the filtered battery voltage drops below the configured threshold, the device displays a warning on screen for 2 seconds and then shuts down gracefully. The threshold is configurable from the settings screen (3.0 V – 3.5 V) or can be disabled.

Bug Fixes

Buzzer mute at startup — the saved mute preference is now respected during the startup sound; previously the buzzer was always unmuted on boot regardless of the saved setting.
Brightness change delay — brightness changes are now applied instantly without triggering a flash write on every keypress; flash is written only when exiting the settings screen.

Build & Release

Firmware is built automatically via GitHub Actions on every wio-tracker-* tag push. Pre-built .uf2 files are published in the Releases section.

To flash: copy the .uf2 file to the device while it is in bootloader mode (double-press reset).

Syncing with Upstream

This branch tracks meshcore-dev/MeshCore. To pull upstream updates:

git fetch upstream
git rebase upstream/main
git push origin wio-tracker-l1-improvements --force-with-lease

2.9 KiB Raw Blame History Unescape Escape