Questions and answers
What the firmware does and does not do today, what it talks to over the network, and how to run, update and fix it.
Which keys work on this screen?
Press Fn + h, on any screen: it lists the keys that work there, then the ones that work everywhere. ? does the same when you are not typing text. The screens themselves never name their keys, so this is the one key to remember. See The basics.
Can I send messages over the mesh?
Yes, once you choose to. The Mesh App follows MeshCore channels (Public, hashtag channels, private ones whose key you have) and lists the nodes around. With Settings → GNSS and radio → Mesh on Sending (Listening is the default), it posts on channels, sends private messages that come back marked delivered, and advertises the device, signed with a key it makes for itself.
Does it work with the MeshCore app?
Yes, the official Android app, over Bluetooth. Switch on Settings → Network → Bluetooth, pair with the PIN the device shows, and the app shows the device's nodes, channels and messages, and sends through it. The device keeps its name, position, radio and key to itself. While Bluetooth is on, IRC, Gemini and update checks wait for memory. See Bluetooth.
Is this Meshtastic?
No. roro9stack is its own firmware, written from scratch. Its mesh is MeshCore, the one heard around here, built on MeshCore's own protocol code; the LoRa Scanner also reads Meshtastic packets' headers. The project isn't affiliated with or endorsed by Meshtastic, MeshCore or M5Stack.
Does it ever transmit on LoRa?
Only the mesh, and only once you set Mesh to Sending, with your Region confirmed in Settings. Then it transmits at +22 dBm on MeshCore's European frequency, and never more than 10% of any hour, the band's limit: a count built into the firmware, which no setting changes. The LoRa Scanner never transmits.
What do I need?
- an M5Stack Cardputer ADV: that is the device the firmware is built and tested for;
- the Cap LoRa-1262, for the LoRa Scanner and GNSS only: the other Apps do not need it;
- a microSD card, for notes, logs, tracks, captures and saved pages;
- Wi-Fi (2.4 GHz) for IRC, Gemini and updates.
Which regions are supported?
EU868 only, today. Setup asks for your region once, and the radio does not transmit until you confirm it.
Why do I need Chrome or Edge to install it?
The browser flasher uses Web Serial, which Chrome and Edge have on desktop and Firefox and Safari don't. Without it, the esptool steps on the Install page flash the same file from a terminal.
How do I update it?
Three ways, all with the same signed update file: from the project's releases on the device itself (Settings → System → Firmware), from the SD card, or pushed over Wi-Fi from a PC. See Updates and Install an update from the SD card.
Is it safe to update? What if it goes wrong?
A new firmware runs on Probation: if it crashes, restarts, or cannot get Wi-Fi back within 3 minutes, the device returns to the previous version by itself. If a confirmed firmware crashes 3 times in a row, it starts in Safe Mode with only Wi-Fi and updates, so a fix can be installed without a cable. And an update that is not signed with the project's key is refused before anything is written.
Can I run my own build?
Yes: it is open source (GPL-3.0). The device only accepts updates signed with the key that its firmware was built with, so a build of your own, signed with your own key, is flashed once over USB (the README explains it); after that, your own updates go over Wi-Fi or the card. Releases from this project are signed with the project's key.
Does it phone home? What about privacy?
The firmware contacts the project's server once a day, to see whether a new release exists: Settings → System → Check for updates, on by default, only when Wi-Fi is up and the clock is set. It installs nothing by itself, and you can switch it off. Besides that, the device talks to what you ask it to: the IRC server and Gemini capsules you open, DNS servers (9.9.9.9 and 1.1.1.1 by default) and time servers (pool.ntp.org and time.cloudflare.com by default), all of which you can change. There is no account, no analytics and no telemetry.
It listens on the network only for what you switched on: the port that receives signed firmware updates, always; the Debug Console, the card shared with a browser and the VPN, only while you have them on. The SSH App connects out to the server you name and listens for nothing.
This website sets no cookies and has no analytics, loads nothing from other sites, and its server logs keep only a masked part of visitors' addresses. The Install page asks the project's own server for the latest release.
Why does IRC disconnect when I update, or when I open a Gemini page?
A secure connection takes about 52 KB of the 107 KB the device has, and IRC's takes about 40 KB. Both together do not always fit, and the mesh, running in the background, takes about 16 KB more. With Bluetooth on, there isn't room for a secure connection at all. See When a connection says "not enough memory".
Can it use a VPN?
Yes, WireGuard: one tunnel to one server, set up by copying the client's .conf to the SD card and importing it in Settings. It can carry everything, or just the VPN's own subnet. See VPN.
Can it log in to my server?
Yes, over SSH: the SSH App is a terminal on another machine, with a password or with a key the device makes for itself. vim, top and less work. One session at a time, and not at the same time as IRC: there isn't the memory for both. scp in the Shell copies a file between the card and a server.
How do I copy files to and from my phone?
In the Storage App, press w: the device serves a small web page to any browser on the same Wi-Fi. Scan the QR code it shows, type the code, and upload or download. Nothing to install. See From a phone.
How do I take a screenshot?
Fn + p, on any screen. The picture goes to /screenshots on the SD card. See Take a screenshot.
The network doesn't work: how do I find out why?
From the device itself, in the Shell: ifconfig, ping, nslookup, port and traceroute. When the network doesn't work puts them in order.
Do I need an SD card?
For the radio, GNSS position, Wi-Fi tools, IRC chat and Gemini browsing, no. For anything that is kept, yes: notes, IRC logs, Wi-Fi scan logs, GNSS Tracks, LoRa captures, saved Gemini pages and update files. See Find your files on the SD card.
How big can a note be?
Any size the card has room for. The editor only keeps the part around the cursor in memory, so a megabyte of text opens at once. A long note is rewritten when you leave it, which takes about a second for each 450 KB. See Long notes.
Why can't I rename or delete some folders?
The firmware keeps its files in the top-level folders of the card, and /gemini/cache and any file being written right now are protected. What is inside the top-level folders can be changed. The Storage App says why when it refuses.
The upload can't connect, or the port is missing
Try a data cable, put the Cardputer in download mode (hold G0 while plugging in USB), and see When flashing fails.
Something is wrong, or missing from this site
Write to the issue tracker or to contact@roro9stack.net. Security problems: the address in the site's security.txt, and please not in the public tracker.