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

feat(tools): trail_export.py — capture GPX over USB serial

Browse Source 
Adds tools/trail_export.py: auto-detects the Wio port, waits for the
<?xml header, captures bytes until </gpx>, and writes a timestamped file
to tools/gpx/. Replaces the abandoned synthetic-FAT USB-MSC approach with
a simple host-side script.

- README: new "GPX Trail Export" section
- tools_screen.md: trail_export.py shown as the recommended download path,
  cat/PuTTY kept as a manual fallback
- .gitignore: ignore tools/gpx/ output dir (mirrors tools/pngs/)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Jakub
2026-05-31 16:23:16 +02:00
parent 43d989821a
commit 3cf381e137
3 changed files with 186 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

21
docs/solo_features/tools_screen/tools_screen.md
View File

@@ -100,13 +100,20 @@ Cycle views with **LEFT / RIGHT**:
### Downloading GPX
1. Connect the device via USB cable
2. Open a serial terminal at **115200 baud**:
- **macOS/Linux** — `cat /dev/tty.usbmodem* > track.gpx` (stop with Ctrl-C after dump completes)
- **Windows** — PuTTY (Serial, 115200) or Arduino IDE Serial Monitor (no line ending)
3. On the device: **Tools › Trail** → **Hold Enter** → **Export (live)** or **Export (saved)**
4. The device streams a GPX 1.1 XML document. Save the output from `<?xml` to `</gpx>` as a `.gpx` file
5. Import into OsmAnd, Garmin BaseCamp, GPX Studio, Google Earth, etc.
**Recommended — `tools/trail_export.py`** (auto-detects the port, captures from `<?xml` to `</gpx>`, writes a timestamped file under `tools/gpx/`):
```sh
uv run tools/trail_export.py
```
Then on the device: **Tools › Trail** → **Hold Enter** → **Export (live)** or **Export (saved)**.
**Manual fallback** — open a serial terminal at **115200 baud** and capture the stream by hand:
- **macOS/Linux** — `cat /dev/tty.usbmodem* > track.gpx` (stop with Ctrl-C after the dump finishes)
- **Windows** — PuTTY (Serial, 115200) or Arduino IDE Serial Monitor with no line ending; copy the text from `<?xml` to `</gpx>` into a `.gpx` file
Either way, the resulting file imports into OsmAnd, Garmin BaseCamp, GPX Studio, Google Earth, etc.
> [!NOTE]
> If the companion app is connected via **BLE**, the export is safe — BLE and USB operate independently. If connected via **USB**, disconnect the app before exporting.