publish: location-tracker 0.2.0

[u44e]

Package: location-tracker 0.2.0

A receiver/display for a LoRa (SX1262) multi-node GPS tracking mesh on the M5CardputerZero. Nodes send their position over LoRa; this app shows the fleet live and on an offline map. 320×170, dark theme.

Field	Value
Version	0.2.0 (was 0.1.0)
Architecture	arm64
Maintainer	u44e <u44e@users.noreply.github.com>
Size	3.3 MB (3,456,500 bytes)
SHA-256	13168489731fadc02301e33f24bd40fd1ea15f76b2d623b2607a27ca7f23a38e
Binary	pool/main/location-tracker/location-tracker_0.2.0_arm64.deb.release.json (served from the czdev-buffer release asset)
Source	https://github.com/u44e/cardputerzero-location-tracker
License	MIT

Supersedes #55 (location-tracker 0.1.0). Please close #55 in favor of this one.

---

English

Features

• Hub view — a live per-node list: node ID, solution quality (none / float / fixed), lat-lon, satellites, and signal (RSSI/SNR / loss), plus receive rate and radio channel.
• Node-detail view — the local node's own GPS: fix quality, speed, altitude, and TX state.
• Offline map (GIS) view (new in 0.2.0) — a full-screen map per mode. The SIDE key cycles hub → hub-map → node → node-map, so each mode has a text screen and a map, and it is always clear which mode's map you are looking at. The map draws SD-stored raw RGB565 slippy tiles ({z}/{x}/{y}.565, decode-free fopen+memcpy, independent of the launcher's LVGL image/FS config) with GPS/LoRa positions as markers, a scale bar, and pan/zoom (arrows pan, +/- zoom, 0 recenters). The hub-map auto-fits all received nodes; the node-map follows your own position at the most detail available.
• Radio + GNSS — M5Stack Cap LoRa-1262 (SX1262 + AT6668/ATGM336H GNSS), the same cap as the Cardputer ADV, driven on the CM0 via spidev/GPIO/UART, so nodes and hubs interoperate across ADV and CardputerZero (same LoRa PHY + packet + crypto).
• Data input — NDJSON (appendix E.2) on stdin: on the device from a LoRa hub over USB-CDC, or from the on-device native LoRa receiver (skeleton — currently verified as a hub-viewer).
• Self-demo without hardware — bundles a sample track and a small demo tile set (Kanto–Chubu), so both the node list/detail and the map show data out of the box. Point CZ_TILES_DIR at your own tiles for other areas.
• Companion macOS app — a native MapKit map view reads the same LoRa-hub NDJSON stream over USB-CDC/TCP, so the same fleet can be viewed on the Mac at the same time (the desktop GIS lives in the development monorepo).
• Privacy — receiver only: it displays GPS coordinates received from the user's own nodes and transmits nothing. No network access, no telemetry.

New in 0.2.0

• The full-screen offline map view above (hub-map / node-map, markers, scale bar, pan/zoom).
• Bundled demo map tiles so the map self-demos; on-screen source credit.
• Two new store screenshots (04 hub-map, 05 node-map) captured in the emulator over real tiles.

License & attribution

• App code: MIT — © 2026 Yusuke Yoshie.
• Bundled offline map tiles (share/APPLaunch/share/tiles): © 国土地理院 / GSI Japan — 地理院タイル, used under the GSI tile terms of use. The source credit ("Map: GSI Japan") is shown on-screen at the bottom-right of the map and in the bundled NOTICE file. Tiles are read from local storage only — the app makes no network requests (the network permission stays false).

---

日本語

機能

• HUB ビュー — ノードごとのライブ一覧：ノードID、解状態（none / float / fixed）、緯度経度、衛星数、信号（RSSI/SNR・ロス）、受信レート、無線チャンネル。
• NODE 詳細ビュー — 自局の GPS：測位品質、速度、高度、送信(TX)状態。
• オフライン地図(GIS)ビュー (0.2.0 で追加) — モードごとの全画面地図。サイドキーで HUB → HUB地図 → NODE → NODE地図 を循環し、各モードが「テキスト画面」と「地図」を持つため、どのモードの地図かが常に分かります。地図は SD の raw RGB565 スリッピータイル（{z}/{x}/{y}.565、デコード不要の fopen+memcpy、ランチャの LVGL 画像/FS 構成に非依存）を背景に、GPS/LoRa の位置をマーカー表示。スケールバーとパン/ズーム（矢印=パン、+/-=ズーム、0=再センタ）に対応。HUB地図は受信した全ノードが収まるよう自動フィット、NODE地図は自局位置を最詳細で追従します。
• 無線 + GNSS — M5Stack Cap LoRa-1262（SX1262 + AT6668/ATGM336H GNSS）。Cardputer ADV と同じ Cap を CM0 の spidev/GPIO/UART で駆動するので、ADV と CardputerZero のノード/ハブが相互運用できます（同一 LoRa PHY・パケット・暗号）。
• データ入力 — stdin の NDJSON（付録E.2）：実機では LoRa ハブから USB-CDC 経由、または端末内蔵の LoRa 受信（スケルトン、現状はハブビューアとして検証済み）。
• ハードなしで自己デモ — サンプル軌跡とデモタイル（関東〜中部）を同梱し、ノード一覧/詳細も地図も箱から出してすぐ表示。他地域は CZ_TILES_DIR で自前タイルを指定できます。
• macOS コンパニオンアプリ — ネイティブ MapKit の地図ビューが同じ LoRa ハブ NDJSON を USB-CDC/TCP で読み、同じ機体群を Mac でも同時に見られます（デスクトップ GIS は開発モノレポ側）。
• プライバシー — 受信専用：ユーザ自身のノードから受けた GPS 座標を表示するだけで、外部送信は一切なし。ネットワーク非使用・テレメトリなし。

0.2.0 の新機能

• 上記の全画面オフライン地図ビュー（HUB地図 / NODE地図、マーカー、スケールバー、パン/ズーム）。
• 地図が自己デモできるようデモタイルを同梱、画面上に出典表示。
• ストア用スクリーンショットを2枚追加（04 HUB地図 / 05 NODE地図、実タイル上でエミュレータ撮影）。

ライセンス / 出典

• アプリ本体: MIT — © 2026 Yusuke Yoshie。
• 同梱オフライン地図タイル（share/APPLaunch/share/tiles）: © 国土地理院（地理院タイル）。地理院タイル利用規約に基づき使用。出典（"Map: GSI Japan"）は地図画面右下に常時表示し、同梱 NOTICE にも記載。タイルはローカル読取のみで、アプリはネットワーク通信を行いません（network 権限は false）。

[github-actions]

✅ Package Validation Passed

All checks passed. Ready for maintainer review.