Mirrors/MeshCore-Solo
1
0
Fork 0
mirror of https://github.com/MarekZegare4/MeshCore-Solo.git synced 2026-07-26 14:58:12 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs(readme): add GPX Trail Export section (lost in rebase merge=ours)

Browse Source
This commit is contained in:
Jakub
2026-05-31 16:24:29 +02:00
parent 3cf381e137
commit 6774a08000
1 changed files with 19 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

19
README.md
View File

@@ -136,6 +136,25 @@ Options:
---
## GPX Trail Export
Capture the GPS trail as a GPX 1.1 file by streaming it over USB serial.
```sh
uv run tools/trail_export.py
```
Run the script, then on the device: **Tools › Trail › Hold Enter ›**
- **Export (live)** — current RAM trail
- **Export (saved)** — `/trail` file from flash
The script auto-detects the port, waits for the `<?xml` start, captures bytes until `</gpx>`, and writes the file to `tools/gpx/trail_<timestamp>.gpx`.
> If the companion app is connected over BLE the export is safe (USB receive is ignored). If the app is on USB, disconnect it first — the raw GPX stream will otherwise disrupt the app's frame protocol.
---
## Development
This fork tracks the upstream [MeshCore](https://github.com/ripplebiz/MeshCore) repository. To prevent upstream changes from overwriting this README during merges, `README.md` is protected via `.gitattributes`. After cloning, run once: