Open firmware · GPL-3.0 · v0.30.0

Open firmware for a pocket computer.

roro9stack is firmware for the M5Stack Cardputer ADV with the Cap LoRa-1262: a MeshCore messenger, a LoRa scanner that reads Meshtastic and MeshCore traffic, GNSS with a compass, an SSH client, a Gemini browser, IRC, Wi-Fi tools, notes, games and more.

  • GPL-3.0
  • Docker-only build
  • Signed updates
SNIFFERSWEEPCAPSWL863866.5870 MHz
GNSSSKYPOSITIONNSWESNR

Drawings of the LoRa Scanner's Sweep view and the GNSS sky view, not screenshots: the real screens are further down.

Before you start

What you need.

What's inside

Apps for the radio, the network, the card and the evening.

LoRa Scanner

See what is on the air

Lists every packet it hears with its signal, and reads the Meshtastic and MeshCore headers, and MeshCore's public channel. A Sweep shows signal strength from 863 to 870 MHz. Capture to a pcap for Wireshark.

Only listens, never transmits
GNSS

Find your place, and your way

Position, a Sky view of every satellite, and a Compass that leads back to a place you marked. Tracks save to the SD card as GPX, and the clock follows the fix.

No magnetometer: north from walking, or the sun
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, in sixteen colours. Files go with scp, from the Shell.

The session stays open when you leave
Gemini

Browse Geminispace

Follow links with Tab and Enter, go Back to where you were, bookmark pages and save them to the SD card to read offline.

Certificates trusted on first use
Storage

Manage the SD card

Browse, copy, cut, rename and delete with a clipboard. Opens text, pictures, hex, captures, tracks and update files. Press w and the card is a web page in your phone's browser: upload and download with nothing to install.

Checks every copy by size
Games

For when the radio is quiet

Pong, Snake and Tetris with its tune, Minesweeper, 2048, and Asteroids steered by leaning the device. Pong can be steered by tilting too.

The best of each is kept

All 13 Apps, with their screens

Also on every screen: a key that lists the keys, and a key that takes a screenshot. Every App has a page in the user guide.

On the device

The real screens.

The LoRa Scanner's Sweep, the Sniffer paused: bars of signal strength from 863.0 to 870.0 MHz with peak marks and a dotted line where the mesh's channel is, a waterfall under them, and a footer reading floor -97 dBm, nothing above it
LoRa Scanner, Sweep
The LoRa Scanner's packet list on MeshCore 869.618 MHz, noise -99: two packets with their time, RSSI and SNR, an advert from the node twisla and a channel message on channel #9f
LoRa Scanner, packets
The GNSS App's sky view: a circle with the satellites of four constellations as coloured dots, and a legend counting them: GPS 10 of 12, GLONASS 4 of 4, Galileo 2 of 2, BeiDou 3 of 3, 3D Fix
GNSS, sky
The Gemini App on the page Project Gemini at geminiprotocol.net: a heading, then the start of the text, Gemini in 100 words
Gemini
The System App's overview: Core 0 at 9 percent, Core 1 at 22 percent, memory 74 KB free, network, battery 100 percent, uptime, and a graph of both cores over two minutes
System
The Notes editor on before-the-trip.txt, 113 bytes, saved: Before the trip, charge the Cardputer, the Heltec and its antenna, and a spare SD card, with the maps copied to it, a line that wraps on the screen
Notes
The Storage App at the top of the SD card: the folders captures, gemini, gnss, irc, mesh, notes, pictures and screenshots, with 15 GB free
Storage
Settings, System, Firmware: Version v0.28.2, Status confirmed, Push to 172.16.42.25 port 3232, Latest release not checked yet, Older releases, and No .ota files in /updates
Settings, Firmware
The Shell after ls /mesh: the command in blue, then the size, date and name of each file in the mesh's folder, and ls: end of /mesh, above an empty input line
Shell
A picture open in the Storage App: colour bars, grey and colour gradients and a yellow ellipse, shrunk to fit the screen and dithered to its 256 colours
Storage, a picture
The Storage App's Share screen: a QR code, the address 172.16.42.25, the code 246 853, Nothing asked yet, Not encrypted, and the key that stops sharing
Storage, sharing with a browser
Settings, VPN: VPN On, Start with Wi-Fi On, Import /vpn/wg0.conf, Forget it; then It is up, heard 2 s ago, the server home.twis.la port 6666, and This device 10.9.0.2, through it everything. VPN shows in the Status Bar
Settings, VPN
The SSH App's list: two saved hosts, tester at 172.16.42.249 port 2222 and twisla at 172.16.42.73, then New connection and This device's key
SSH, the hosts
A dialog over the SSH App: A server not met before, the address 172.16.42.249, and a SHA256 fingerprint on two lines; buttons Cancel, selected, and Trust it
SSH, a server met for the first time
The SSH App's terminal showing top on a remote machine: uptime, tasks, memory, then a reverse-video header and eight processes. SSH shows in the Status Bar
SSH, top on another machine
This device's key: its public half, for a server's authorized_keys file, a line starting ssh-ed25519; it is also in /ssh/id_ed25519.pub, and the private half never leaves
SSH, this device's key
A dialog over the SSH App: THE SERVER'S KEY CHANGED. Someone in between? Now it is, and a SHA256 fingerprint; buttons Cancel, selected, and Replace
SSH, a server whose key changed
The Launcher: four large icons with their names, the folders Radio, selected, Network, Local and System
The Launcher
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)
The Mesh App's channels, Sending: Public, highlighted, public; #roro-test, hashtag; roro-private, private; and @ twisla, a private conversation
Mesh, the channels
The Mesh App on the roro-private channel, Sending: messages from roro9 marked sent, among them Test from ble, and two replies from twisla, Yes, received and Let!s test 3. Queued messages (as typed), above an empty line to write in
Mesh, a channel
The IRC App on #roro9stack-test, buffer 3 of 3: Joined #roro9stack-test, then two lines from roro9, Screenshots for the site, from v0.28.2, and The default theme, everywhere this time, and an empty line to type in
IRC
Wi-Fi Tools' channel occupancy: 10 networks, quietest of 1, 6 and 11: channel 11, with a bar for each channel from 1 to 13, channel 6 the tallest
Wi-Fi Tools, the channels
Tetris in the Games App: a few pieces at the bottom of the well, the next piece shown on the right, score 0, best 56, lines 0, level 1
Games, Tetris
Settings, Bluetooth: Bluetooth On, Phone Connected, Forget the phone; then The MeshCore app finds it as MeshCore-roro9, and at the bottom, IRC, Gemini and update checks wait meanwhile. B shows in the Status Bar
Settings, Bluetooth
A dialog over Settings, Bluetooth: Pair with the phone. Type this PIN on the phone: 269 800, in large figures, and an OK button
Bluetooth, pairing the phone
Updates

Update over Wi-Fi. It rolls back if it fails.

Install a new release from the project's server in Settings, from the SD card, or push one from your computer. Every update is signed: the device checks the signature before it writes anything, restarts, and runs the new firmware on Probation. If it crashes, or can't reconnect Wi-Fi, it goes back to the previous firmware and says so.

$ scripts/flash.sh --ota 10.39.39.12
60 s

The longest the device waits for you to stop typing before it restarts into an update.

3 min

How long new firmware has to reconnect Wi-Fi on Probation before it rolls back.

3

Crash restarts in a row, and it starts in Safe Mode: only Wi-Fi, updates and the Debug Console, so a fix can still be pushed.

Build and flash

Only Docker needed.

PlatformIO and the ESP32 toolchain run in a container. The first build downloads about 1 GB; after that, builds take under a minute.

If the upload can't connect, hold G0, the button next to the screen, while plugging in USB, then retry.

Prefer a ready-made build? Install it from your browser, or take the factory image and the signed update file from the downloads.

# run the tests, then build
$ scripts/ci.sh
# flash over USB-C
$ scripts/flash.sh
# or update over Wi-Fi
$ scripts/flash.sh --ota 10.39.39.12

Open source, GPL-3.0.

Read the code, flash it, send a patch.