MeshTerm on the PicoCalc is a manual from the shopping list to a working radio

docs/picocalc.md starts from a stock PicoCalc with its Pico and ends with a
Linux handheld running MeshTerm with a LoRa radio soldered inside: a priced
shopping list, the Lyra swap, writing Calculinux, the serial console, Wi-Fi,
the setup script phase by phase, then PlatformIO, the firmware build with the
patch explained hunk by hunk and a by-hand route for when it stops applying,
flashing, the four wires, the Lyra setup, day-to-day use and troubleshooting.

The README gains a Documentation table and points the handheld paragraph at
the two manuals; the script indexes and the changelog follow. hardware.md
stays as the reference behind both.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
This commit is contained in:
Jean-Pierre MartineauandClaude Fable 5.1 committed 2026-09-14 23:38:21 -04:00
1 parent eb96d6b449
commit 8533d9a9e8
5 files changed
+790 -10

No files matched your search

+5 -3
View File
@@ -6,9 +6,11 @@ MeshCore radio over UART, and fronting an SPI-attached LoRa chip as if it were a
device. They run **on the device**, most of them as root, and they are meant to be read
before they are run.
**[`docs/hardware.md`](../docs/hardware.md) is the manual** — what each target is, what the
scripts assume about the machine, why each step is the way it is, and what has only ever
been proven on one bench. Start there and pick your target; the table below is the index.
**Start with the manual for your device**: [`docs/picocalc.md`](../docs/picocalc.md) walks a
stock PicoCalc from the shopping list to a working radio, and [`docs/uconsole.md`](../docs/uconsole.md)
installs the SPI bridge on a uConsole. [`docs/hardware.md`](../docs/hardware.md) is the
reference behind both — what the scripts assume about the machine, why each step is the way
it is, and what has only ever been proven on one bench. The table below is the index.
| File | Runs on | What it does |
| --- | --- | --- |
+5 -4
View File
@@ -4,10 +4,11 @@ A Seeed XIAO nRF52840 + Wio-SX1262 wired to the Luckfox Lyra's UART1, running Me
companion firmware on `Serial1`, so MeshTerm on the PicoCalc opens `/dev/ttyS1` like any
other serial companion. No BLE, no USB host, no SD-slot sacrifice.
**The manual is [`docs/hardware.md`](../../docs/hardware.md#a-real-radio-for-the-picocalc-xiao-nrf52840-over-uart)**
— parts, the firmware patch and why it is still needed, flashing a bootloader that offers no
drive, what the register poke does, troubleshooting, and what has only been proven on one
bench. This page is the bench card.
**The step-by-step guide is [`docs/picocalc.md`](../../docs/picocalc.md)** — parts, the
firmware build and the patch explained, flashing, wiring, and the Lyra setup.
[`docs/hardware.md`](../../docs/hardware.md#a-real-radio-for-the-picocalc-xiao-nrf52840-over-uart)
is the reference behind it: what the register poke does, and what has only been proven on
one bench. This page is the bench card.
**Licensing.** The firmware is MeshCore, under the MIT License. The `meshcore-uart1.patch`
modifies MeshCore source and `build-firmware.sh` produces a MeshCore binary; the licence is