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.
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.
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.
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.
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.
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.
LoRa Scanner, SweepLoRa Scanner, packetsGNSS, skyGeminiSystemNotesStorageSettings, FirmwareShellStorage, a pictureStorage, sharing with a browserSettings, VPNSSH, the hostsSSH, a server met for the first timeSSH, top on another machineSSH, this device's keySSH, a server whose key changedThe LauncherThe help panel (Fn+h)Mesh, the channelsMesh, a channelIRCWi-Fi Tools, the channelsGames, TetrisSettings, BluetoothBluetooth, 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.