The basics
The keys, the Launcher, the Status Bar and what happens the first time you switch the device on.
How to use each App on the Cardputer: the keys, what the screens show, and what is written to the SD card.
This guide says what the firmware does today and nothing else. Start with the basics (the keys, the Launcher, the first start), then read the page of any App. On the device itself, Fn + h lists the keys of whatever screen you are on: nothing else on a screen names them. It describes the latest release; the numbers and key names come from the firmware's own source.
The mesh listens by default, and sends once you choose. The Mesh App follows MeshCore channels and lists the nodes around, in the background; with Settings → GNSS and radio → Mesh on Sending, it also sends messages, private ones with a receipt, and its own advert, within 10% of the air.
Three things work on every screen: Fn + h for the keys, Fn + p for a screenshot, and Fn + ` to go back to the Launcher.
The MeshCore app on a phone can drive the mesh too, over Bluetooth: the same node, its nodes, channels and messages, on the phone.
Three things keep running when you leave their App: IRC stays connected, an SSH session stays open, and the mesh keeps listening.
Looking for a recipe or a quick answer? There are how-tos and a FAQ.
Something missing or wrong? Write to the issue tracker or to contact@roro9stack.net.
The keys, the Launcher, the Status Bar and what happens the first time you switch the device on.
The keys of every screen of the firmware, as the help panel lists them on the device: one table for each screen and state.
MeshCore on the Cardputer: the channels you follow, private conversations, and the nodes around. It listens by default, and sends once you choose.
Listen to the radio: every packet it hears, a survey of signal strength from 863 to 870 MHz, and captures for Wireshark. It only listens.
Where you are, which satellites you can see, and a compass that leads back to a place you marked, from the Cap's receiver, with Tracks saved to the SD card as GPX.
The official MeshCore app on an Android phone, over Bluetooth: the device's nodes, channels and messages on the phone, and sending through it.
Chat on an IRC server from the keyboard, with a connection that outlives the App and daily logs on the SD card.
A terminal on another machine: log in to a server with a password or with the device's own key, and run a shell, vim or top on the Cardputer's screen.
Browse Geminispace: follow links, go back, bookmark pages and keep them on the SD card to read offline.
See the networks around you, which Wi-Fi channels are busy, and follow one network's signal as you move.
A WireGuard tunnel: reach your own network from any Wi-Fi, or send everything through it on a network you don't trust.
Plain text notes on the SD card, with no save key: the editor saves for you, and a power cut never costs the note.
Browse the SD card: copy, move, rename and delete with a clipboard, and open a file by its type.
Pong, Snake, Tetris, Minesweeper, 2048 and Asteroids, for when the radio is quiet.
The device's names, region, screen, sound, GNSS, Wi-Fi and VPN, and where firmware updates are found.
What the device is doing right now: load, tasks, memory, network traffic, battery and temperature. Live, and read-only.
The firmware's own commands, typed on the device: look at its state, the SD card, the radio and the network with no PC and no cable.
How the device updates itself from the project's releases, from the SD card or from a PC, and how it protects itself when an update goes wrong.