MeshCore DeskOS for SenseCAP Indicator D1L

MeshCore DeskOS is a touch-first, non-forwarding MeshCore desk client for the Seeed SenseCAP Indicator D1L. Production 1.0 builds the core_1_0 profile with conditional SD history:

D1L_RELEASE_PROFILE=core_1_0
D1L_SD_HISTORY_MODE=conditional

For device installation, use the production ZIP from the v1.0.0 release, extract it completely, and follow its START_HERE.md. The source-code archives are for developers and are not device installers.

The current D1L is attached to Raspberry Pi 5 host neopi5 (192.168.0.24). Its only authorized release identity is:

/dev/serial/by-id/usb-1a86_USB_Serial-if00-port0
VID:PID 1a86:7523

Do not substitute a raw /dev/ttyUSB* name or a stale Windows COM assignment.

Production feature set

Area	DeskOS 1.0 production surface
Hardware	480×480 display, touch, button, SX1262 radio, backlight and power/status truth
Messaging	Public and multi-channel messaging, DMs, unread state, delivery/retry truth and retained history
Contacts and nodes	Verified contacts, USB MeshCore URI import, rename/favorite/mute/delete, up to 512 retained heard nodes, role detail and signed advert-location markers
Network tools	Finder, repeater Ping, contact PATH/TRACE, packet terminal, filters/search/raw detail, signal and route evidence
Map	Built-in attributed OpenStreetMap visible-view cache plus authorized-provider background prefetch around the device and signed nodes within 200 km
Connectivity	User-controlled multiple saved Wi-Fi profiles; BLE companion transport is not included in 1.0
Server administration	Authenticated repeater/room login, status, telemetry, neighbours, ACL, bounded CLI, room posts, logout and locally confirmed mutations
Observer	Opt-in mqtts:// TLS observer, QoS 1/PUBACK accounting, bounded queue and optional center location
Storage	Externally prepared FAT32 SD/RP2040 primary history, exports and map cache, with visible degraded operation when SD is unavailable
Not included in 1.0	BLE companion transport, contact/channel QR sharing, and signed OTA/update/recovery product workflows
Device UX	Brightness, timeout, night/high-contrast modes, notification pulse/quiet modes, curated glyph palette and service sheets
Support	Structured event terminal, diagnostics, crashlog, health, guarded reboot/factory reset and normal non-erasing USB flashing

The D1L has no onboard GPS. Map centers on an explicitly configured device location. Peer pins require signed advert coordinates and truthful time/age validation.

Built-in OpenStreetMap Standard access is visible-current-view-only: one 3×3 tile plan at one zoom per visible generation, with attribution and completed tile reuse from SD. Background/offline download is available only through an installed HTTPS provider manifest that explicitly authorizes offline storage and background prefetch. Background prefetch pauses while the interactive Map is open.

Navigation

The 1.0 dock contains:

1. Home
2. Channels
3. Contacts
4. Map
5. Settings

Settings groups Packet log, Diagnostics, Terminal, Wi-Fi, Observer, SD Card, Map options, Display, Identity, About, Radio, Server admin, and Mesh advertise. Lists and detail pages scroll on the device.

Safety and privacy

• DeskOS is a client and does not forward MeshCore packets.
• Read, navigation, search and refresh are RF-silent.
• Observer is off until configured and enabled; it never publishes message text, contacts, keys, or forwarding traffic.
• Server mutations require the exact authenticated target/session and a second local confirmation. Sensitive input is not persistently retained or logged; volatile confirmation buffers are wiped.
• Users prepare FAT32 SD cards on a computer. There is no device-side SD formatting path. First setup requires a prepared card and the included authorized NRCan provider manifest. If media is later removed or becomes unusable, a visible live-only RF chat mode remains; retained history is not silently redirected into default NVS.
• Default NVS remains a bounded configuration, identity, boot/recovery and diagnostic store, not the retained-history authority.
• Normal project flashing is non-erasing. OTA/update/recovery product workflows are not included in 1.0.

Prepare an already-formatted 32GB-or-larger FAT32 card without formatting, deleting, or overwriting files:

python .\scripts\prepare_deskos_sd.py --target E:\ --apply

The checked-in payload is under sdcard/deskos. Run the command without --apply for a read-only plan. Optional preloaded tiles require an explicit provider manifest granting offline storage; the public OpenStreetMap Standard tile service is interactive-cache only and must not be bulk downloaded.

The release includes an authorized Natural Resources Canada CBMT provider manifest for background/offline Map downloads. Card preparation installs it, and firmware seeds it when absent on a ready card without replacing any operator-supplied provider.

Build and release policy

Release firmware is built only by .github/workflows/d1l-ci.yml with the pinned ESP-IDF 5.5.4 toolchain. Local workstations may run source/host tests but do not produce release firmware.

During development, run only the focused tests for the changed slice and the relevant generated-document/package checks. The exact GitHub Actions run owns the complete release build and gate:

python -m pytest <focused-test-files> -q
git diff --check

The exact Actions run must produce a source-bound core_1_0 package, checksums, provenance, SBOM, MeshCore conformance evidence, and the conditional-SD RP2040 bridge payload. Package metadata records the exact repository, commit, workflow run, run attempt, release profile and SD mode. Only this downloaded and verified package may be used for final hardware acceptance.

Flash the current device

Extract the exact Actions package on neopi5, verify it, then use only the stable by-id link:

cd /path/to/extracted-package
sha256sum --check SHA256SUMS.txt
export D1L_PORT='/dev/serial/by-id/usb-1a86_USB_Serial-if00-port0'
test -L "$D1L_PORT" && test -r "$D1L_PORT" && test -w "$D1L_PORT"
D1L_DEVICE_PROPERTIES="$(udevadm info --query=property --name="$D1L_PORT")"
grep -qx 'ID_VENDOR_ID=1a86' <<<"$D1L_DEVICE_PROPERTIES"
grep -qx 'ID_MODEL_ID=7523' <<<"$D1L_DEVICE_PROPERTIES"
./flash_project.sh

Follow the package README for its exact file names and acceptance command. Never flash another Pi serial device. Never format SD.

That package helper is for an ordinary post-release install. It is not the closing path for v1.0.0; the production candidate must follow the authoritative RC1 release execution, including its single retained-state-preserving flash receipt, bounded four-source gate (flash, RF, protocol and Map), final audit, exact tag and checksummed release assets.

Documentation

• DeskOS 1.0 / RC1 user guide
• Authoritative RC1 release execution
• Current RC1 product contract
• Install/recovery history
• Historical 24-hour status ledger
• Known limitations and security boundaries
• Acceptance plan
• MeshCore conformance
• Attribution

Licensing

MeshCore DeskOS D1L is GPL-3.0-or-later. Release packages include third-party notices and source attribution for pinned dependencies and permitted references.