JakubandClaude Opus 5.5
64321bf12b
Map screen (Home > Map): Web-Mercator tiles from /maps/{z}/{x}/{y}.png on
the card (Meshtastic MUI layout; per-column TPK1 .pak also read), drag to
pan, +/- zoom, re-centre/follow GPS, Nearby nodes with a position as
markers opening node detail. Tiles decode one per loop pass into a
12-slot RGB565 cache in PSRAM. map/TileProvider.h is the swap point for a
later vector renderer: the screen only calls renderTile(). The tile set's
credit line comes from maps/attribution.txt.
L2 mounts the card over SDMMC 1-bit (CLK 2, CMD 3, D0 1). LVGL's lodepng
is enabled; note its LVGL patch returns an lv_draw_buf_t*, not pixels.
LVGL pool 2 MB for PNG decoding. Fonts gain map / users icons.
tools/maps/fetch_tiles.py prepares a card for an area (presets for
Poland), requires an explicit tile URL (tile.openstreetmap.org blocks
offline use) and stops on placeholder images. The LVGL sim preloads
web/maps into the L2's /sdcard and puts its GPS on Kraków.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Host-side tools
Helper scripts that run on your computer, not on the device.
| Tool | Purpose |
|---|---|
screenshot.py |
capture the device display over USB serial and save it as a PNG |
trail_export.py |
capture a GPX track from the device over USB serial |
gpx-downloader/index.html |
the same GPX capture in a browser, via Web Serial |
bdf2gfx.py |
convert a BDF bitmap font to an Adafruit-GFX header |
Python dependencies are managed with uv — run the
scripts with uv run tools/<script>.py from the repository root.
Tip
The hosted Solo Tools Web App does both screenshots and GPX export with nothing to install, and is the easiest option for most people. The scripts here are the offline equivalents.
Important
USB serial is suspended while a BLE connection is active, so disconnect the companion app from BLE before using any of these. If the app is connected over USB, disconnect it too — the raw stream would otherwise disrupt its frame protocol.
Display screenshot
All solo firmware environments are built with -D ENABLE_SCREENSHOT, so no
special build is needed. On other environments (repeater, room server, the
non-solo companion builds) add the flag yourself:
PLATFORMIO_BUILD_FLAGS="-D ENABLE_SCREENSHOT" pio run -e <env> -t upload
Usage:
-
Connect the device over USB, with no companion app attached
-
Run the tool:
uv run tools/screenshot.pyOptions:
--port PORT— serial port to use (default: auto-detect)--scale SCALE— upscale factor for the output image (1 = none; default: 1)
-
Press S in the tool's interactive menu to capture
-
The PNG lands in
tools/pngs/with a timestamped filename
How it works:
- The tool sends
CMD_GET_SCREENSHOT(66) to the device - The device replies with
RESP_CODE_SCREENSHOT(29) carrying the framebuffer - The framebuffer arrives in chunks (a 128 × 64 display is 1024 bytes, split across several frames), which the tool reassembles into a PNG
GPX trail export
-
Connect the device over USB, with no companion app attached
-
Start the listener:
uv run tools/trail_export.pyOptions:
--port PORT— serial port to use (default: auto-detect)--out OUT— output file (default: a timestamped file intools/gpx/)
-
On the device: Tools › Trail › Hold Enter › Export (live) or Export (saved)
-
The script captures the GPX 1.1 XML stream and writes it to disk
Font conversion
uv run tools/bdf2gfx.py <font.bdf> <first_hex> <last_hex> <VarPrefix> > out.h
Emits a contiguous glyph table over the given codepoint range, with empty
placeholders for codepoints the BDF does not define, so the renderer can index
by cp - first. This is how src/helpers/ui/MiscFixedFont.h
— the unified 6×9 Latin/Greek/Cyrillic display font — was generated from
6x9.bdf.