User guide · Start here

The basics

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

The Launcher: four large icons with their names, the folders Radio, selected, Network, Local and System
The Launcher
The Radio folder open: Radio in the Status Bar, and Mesh, selected, LoRa Scanner and GNSS, each a large icon with its name
The Radio folder
The help panel over the Launcher: Keys: Launcher, the four arrows move, Enter opens, then Everywhere: back, home, the arrows, Fn h for these keys and Fn p for a screenshot
The help panel (Fn+h)

One key to remember

Fn + h, on any screen, lists the keys that work there. No screen names its keys: that key does. It works everywhere, in a text field too, and ? does the same whenever you are not typing. The arrows scroll the list; any other key closes it.

The list is for the screen you are on: in Storage it is the file keys, in a dialog it is the dialog's, in a text field it is the editing keys. Each list ends with the keys that work everywhere.

If you only read one paragraph of this guide, this was it.

The keys

The Cardputer's keyboard has no arrow keys and no Escape, so the firmware gives a few keys a second job:

KeyDoes
EnterOpens or confirms the selected item
`Back: one step out of a screen, and out of an App
Fn + `Home: back to the Launcher
Fn + ; . , /The arrows: up, down, left, right
; . , / aloneThe same arrows, as long as you are not typing text
Fn + h, or ? when not typingHelp: the keys of the screen you are on
Fn + pA screenshot: the screen as it is, saved as a picture in /screenshots on the SD card
TabSwitches view in an App that has more than one
DelDeletes backwards when you type
opt then an accent, then a letterTypes an accented letter: opt ' e gives é

While you type text (a note, an IRC line, a setting), ; . , / type their own characters and you need Fn for the arrows. The Status Bar shows opt while a compose is waiting for its letter.

The Launcher

The home screen shows four folders, Radio, Network, Local and System, as large icons with their names. Move with the four arrows and open one with Enter; a folder shows its Apps the same way, and Enter opens one.

FolderIts Apps
RadioMesh, LoRa Scanner, GNSS
NetworkIRC, SSH, Gemini, Wi-Fi Tools
LocalNotes, Storage, Games
SystemSettings, System, Shell

An open folder has its name in the Status Bar. Back goes up one level: from an App to its folder, with that App still selected, and from a folder to the four folders. Home (Fn + `) always goes to the four folders. Each folder remembers the App you chose last until the device restarts.

Left and right go through every tile and wrap around; up and down stay in the column. A folder of more than four Apps would scroll, with a bar on the right.

An orange dot on an icon says something is going on in that App: unread messages in IRC or Mesh, a Track being recorded in GNSS, a Capture running in the LoRa Scanner, a session open in SSH. A folder has the dot when one of its Apps has it.

If you prefer a list of names, Settings → Display → Launcher switches between Grid and List. In the list, a * on the right stands for the dot, and a > marks a folder.

The Status Bar

A strip at the top of every screen: the name of the App on the left, and on the right, from the edge inwards:

ShowsMeans
the timeThe clock, once Wi-Fi, a GNSS fix or the MeshCore app has set it
[3]Unread IRC messages that mention you, or private ones
97%The battery (in the warning colour at 15% and under)
SDA card is in; the warning colour at 80% full
bars and WWi-Fi connected, with its signal; W? is searching; MON is the Wi-Fi radio in its monitoring mode, which pauses IRC
SSHAn SSH session is open, whatever App is in front
VPNThe WireGuard tunnel is wanted; brighter once the server has answered
BBluetooth is on, waiting for the phone; bright while the MeshCore app is connected
DBGThe Debug Console is switched on (Settings → System → Debug Console); brighter while a PC is connected to it
RECA GNSS Track is being recorded
CAPA LoRa capture is being recorded
LThe radio is listening, for the mesh or the LoRa Scanner; it lights up for a moment on each packet. A dot after it: a mesh channel or conversation has new messages. SW while a Sweep runs
G or G12The GNSS receiver is searching (G, dim), has a 2D fix (G), or has a 3D fix with that many satellites (G12)

Toasts

News from a background service (an IRC mention, a Storage warning, an update that is out) shows as a short message over whatever App is open, and can beep and flash the LED. Sound & LED in Settings turns that off.

The first start

On a new device a short Setup asks four things, then never appears again. It also tells you about Fn + h, twice, and it is the only part of the firmware that names keys on the screen:

  1. Long name, up to 39 bytes.
  2. Short name, up to 4 characters.
  3. Radio region. Nothing will transmit until you confirm yours. EU868 is the supported region.
  4. Timezone.

The SD card

Put a microSD card in the Cardputer. Without one the radio, GNSS, Wi-Fi and IRC still work, but nothing can be saved: no notes, IRC logs, Wi-Fi scan logs, GPX tracks, LoRa captures, screenshots or saved Gemini pages. The Storage App shows what is on the card.

The firmware keeps its own folders at the top of the card (captures, gemini, gnss, irc, mesh, notes, screenshots, ssh, system, updates, wifi). You can use the card in a computer too, but those names are the firmware's.

The keys, as the device lists them

What Fn + h shows on these screens. These tables are generated from the firmware's own lists, so they are always the current ones.

Everywhere

`back
Fn `home, the Launcher
; . , /arrows (Fn+ while typing)
Fn h ?these keys (? not typing)
Fn pa screenshot, on the card

A question

, /the other answer
Enterchoose it
`cancel

A text field

Entersave
`cancel
Deldelete backwards
Fn , /move the cursor
opt ' ean accent: é

The Launcher

; . , /move
Enteropen