Repository navigation
Releases
v0.3.1 — All three mesh backends, Home screen, Settings
The first release targeting all three mesh ecosystems: MeshMonitor, Meshtastic, and MeshCore. Submitted to the CardputerZero AppStore as PR #414. Installed, launched, and exercised on real CardputerZero hardware.
What's new since v0.3.0
- Icon-grid Home screen to switch between Meshtastic, MeshCore, MeshMonitor, and Settings
- In-app Settings screen (server/port/token/HTTPS/auto-update/tile-server/home-screen-default)
- Multi-channel MeshCore support (channel picker, matching the existing Meshtastic channel picker)
- Key-mapping fixes to match the CardputerZero's own documented key spec (https://cardputer.cc/#/documents/cp0-keys) -- this hardware has no dedicated arrow keys;
Z/X/C/Fact as Left/Down/Right/Up, andfn+K(Home) jumps to the icon grid from any screen - On-screen key hints corrected to match (previously said "Arrows"/"Up-Down")
Backends
- MeshMonitor (REST relay)
- Direct Meshtastic over the onboard LoRa hat
- Direct MeshCore over the onboard LoRa hat
Only one direct protocol (Meshtastic or MeshCore) can be active at a time -- they share the single physical radio, switched with a tap.
Install: sudo dpkg -i cardmesh_0.3.1_arm64.deb
v0.3.0 — Direct LoRa bring-up (re-versioned test build)
Note: identical code to v0.1.1 and v0.2.0 -- all three version strings were stamped on the same commit (e600119) within about 50 minutes of each other while iterating on the packaging/versioning flow during testing, with no code changes between them. Published here for a complete version history; see v0.1.1 for the real feature list.
The next real feature milestone is v0.3.1, which adds the icon-grid Home screen, Settings screen, and multi-channel MeshCore support.
Install: sudo dpkg -i cardmesh_0.3.0_arm64.deb
v0.2.0 — Direct LoRa bring-up (re-versioned test build)
Note: identical code to v0.1.1 -- this version string was stamped on the same commit (e600119) about 13 minutes later while iterating on the packaging/versioning flow during testing, with no code changes in between. Published here for a complete version history; see v0.1.1 for the real feature list.
Install: sudo dpkg -i cardmesh_0.2.0_arm64.deb
v0.1.1 — Direct LoRa bring-up (Meshtastic)
Device-test build from the same commit as v0.2.0 and v0.3.0 below (e600119) -- these three version strings were all stamped onto identical code while iterating on the packaging/versioning flow during testing; see v0.3.0's notes for a disambiguation note. This tag/release is being published retroactively for a complete version history.
What's in this build
- Direct SX1262 LoRa hardware bring-up, verified on real CardputerZero hardware
- Direct Meshtastic protocol support over the onboard LoRa hat (no MeshMonitor required)
- Real channel PSK-based decoding for direct-LoRa channels
- A Messages screen for the direct-LoRa path, with message composing
- A MeshMonitor-relayed Messages screen
- Three bugs fixed from on-device testing
Install: sudo dpkg -i cardmesh_0.1.1_arm64.deb
v0.1.0 — Dashboard-only device build (unverified)
CardMesh v0.1.0 — Dashboard-only, release candidate
docs/DEVICE_BUILD.md before submitting it anywhere — it lists every assumption this build makes and exactly what to try if it doesn't run.
What's in cardmesh_0.1.0_arm64.deb
A self-contained package: a real aarch64 Linux ELF binary (cross-compiled with zig cc against a Debian bookworm sysroot) plus all 29 of its transitive runtime shared-library dependencies, bundled under /usr/lib/cardmesh and SONAME-verified. Only libc6 is required from the target system.
sudo dpkg -i cardmesh_0.1.0_arm64.deb
What's implemented
- Dashboard screen only (per the README's Dashboard mock): source name, node/active/channel/unread counts, connection status.
- A background thread polls MeshMonitor every 10s so the UI never blocks on network I/O.
- Global shortcuts:
Rrefresh,Q/Escquit. - Reads
~/.config/cardmesh/config.json— there is no first-run setup UI yet, so this file must exist before launch (see README for the format).
What's NOT implemented yet
Channels, Chat, Nodes, Node Details, Direct Messages, Sources, Telemetry, Traceroute, Field Mode, Settings screens; first-run setup UI; local SQLite caching is wired into storage but not yet used by the device UI.
Known unverified assumptions (see DEVICE_BUILD.md for details)
- Framebuffer device path (
/dev/fb0, override viaCARDMESH_FB_DEVICE) - Input device path (
/dev/input/event0, override viaCARDMESH_INPUT_DEVICE) - Display color depth (16bpp/RGB565 assumed)
- Target glibc ≥ 2.36 (Debian bookworm baseline — bundled libs will fail to load on an older glibc)
- Whether the online emulator even runs a plain Linux fbdev/evdev binary, vs. requiring AppBuilder-specific integration
Also new in this release
Community health files: CODE_OF_CONDUCT.md, CONTRIBUTING.md, LICENSE (MIT), SECURITY.md.
The host-testable core (HTTP client, MeshMonitor API client, models, config, SQLite storage — no CardputerZero hardware needed) builds and passes its full test suite via cmake + ctest; see the main README.