快速上手

目标：装好应用、跑完七步向导，让 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，去 故障排查。