快速上手

目標：裝好應用、跑完七步引導，讓 APRS-IS 顯示「已驗證」並收到第一則封包。

安裝#

  1. 打開 GitHub Releases，按平台取包：Android → *.apk；Windows → 安裝程式。
  2. Android 自 v1.5.2 起使用正式 release 簽章，直接覆蓋安裝即可；從更老的版本升級請先解除安裝（簽章不同會裝不上）。
  3. 裝完先別急著點 —— 下一步要準備 Passcode，沒有它只能連上、收不到訊息。
🧩

桌面端是綠色安裝：裝完在開始功能表找 APRSLocus；解壓版直接執行 aprslocus.exe。

首次啟動：七步引導#

引導每一步都能返回修改；之後隨時可在 設定 → 進階 裡重新執行，目前設定不會丟。

  1. 介面語言 —— 簡體 / 繁體 / English / 日本語 / Indonesia / Español。
  2. 使用者協議 —— 必須勾選同意《使用者協議》與 GPL-3.0；注意 APRS 資料是公開的，發出後可能被全球接收與轉發。
  3. 歡迎頁 —— 即時地圖、GPS 上報、APRS 訊息、APRS-IS 四項能力。
  4. 呼號與 SSID —— 輸入完整呼號（含 SSID，如 BG7LZQ-3）；留空無法繼續。
  5. 臺站符號 —— 代表臺站類型，隨每一則信標發送。
  6. 接收地區 —— 勾選要收的國家/地區；不勾 = 全收。
  7. 伺服器與 Passcode —— 伺服器預設 rotate.aprs2.net 可不動；Passcode 見下一節。
✅

怎麼算完成：引導最後一頁點完成后，首頁頂部的鏈路狀態卡應顯示已連線； 若顯示黃色「未驗證」，代表 Passcode 還沒填對，繼續看下一節。

Passcode 與背景執行#

⚠️

Passcode 是 APRS-IS 的登入驗證碼，把你的呼號驗證到網路。 留空或預設 -1 只能連線，訊息與群組都收發不了。到 APRS Passcode 查詢 用完整呼號產生後填入 設定 → 連線 → Passcode。 填錯時首頁頂部會出現黃色「未驗證」橫幅 —— 那就是它。

  • 改完要儲存：連線頁的改动點「儲存並套用」才生效。
  • 要它一直上報：系統設定裡允許 APRSLocus 背景執行、關掉省電最佳化、允許自啟動；通知欄可一鍵結束。

驗證：收到第一則封包#

  1. 首頁頂部鏈路狀態卡：狀態為「已連線」，收包計數在漲。
  2. 切到 資料封包 頁籤：幾秒內應出現原始封包（等寬字型、可長按複製）。
  3. 看不懂沒關係 —— 下面是一幀真實位置封包的逐段拆解（取自專案測試用例）。
BG7LZG-9>APALOC,TCPIP*:!3904.25N/11624.44E>123/045/A=000100 Bat:88% APRSlocus v1.6.67
片段含義
BG7LZG-9發信人呼號（含 SSID）
APALOC目的呼號 / tocall —— APRSLocus 的軟體標識
TCPIP*路徑：走網際網路，星號 = 本裝置最後一次中繼
!3904.25N/11624.44E>定位串：緯度 / 經度 / 臺站符號（車）
123/045航向 123°、速度 45 節
A=000100高度 100 英尺
Bat:88% …註釋：電量與軟體版本（緊跟定位串，無空格）
✅

怎麼算成功：封包頁有封包 + 收包計數增長 = 接收鏈路通。 若計數一直為 0，去 故障排除。