User guide

User guide

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.

Start here

Start here01

The basics

The keys, the Launcher, the Status Bar and what happens the first time you switch the device on.

Reference02

Every key

The keys of every screen of the firmware, as the help panel lists them on the device: one table for each screen and state.

Radio

Mesh03

Mesh

MeshCore on the Cardputer: the channels you follow, private conversations, and the nodes around. It listens by default, and sends once you choose.

LoRa Scanner04

LoRa Scanner

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.

GNSS05

GNSS

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.

MeshCore app06

Bluetooth

The official MeshCore app on an Android phone, over Bluetooth: the device's nodes, channels and messages on the phone, and sending through it.

Network

IRC07

IRC

Chat on an IRC server from the keyboard, with a connection that outlives the App and daily logs on the SD card.

SSH08

SSH

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.

Gemini09

Gemini

Browse Geminispace: follow links, go back, bookmark pages and keep them on the SD card to read offline.

Wi-Fi tools10

Wi-Fi tools

See the networks around you, which Wi-Fi channels are busy, and follow one network's signal as you move.

WireGuard11

VPN

A WireGuard tunnel: reach your own network from any Wi-Fi, or send everything through it on a network you don't trust.

Local

Notes12

Notes

Plain text notes on the SD card, with no save key: the editor saves for you, and a power cut never costs the note.

Storage13

Storage

Browse the SD card: copy, move, rename and delete with a clipboard, and open a file by its type.

Games14

Games

Pong, Snake, Tetris, Minesweeper, 2048 and Asteroids, for when the radio is quiet.

System

Settings15

Settings

The device's names, region, screen, sound, GNSS, Wi-Fi and VPN, and where firmware updates are found.

System16

System

What the device is doing right now: load, tasks, memory, network traffic, battery and temperature. Live, and read-only.

Shell17

Shell

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.

Firmware18

Updates

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.