設定參考
設定的逐項參考：名稱、控件、預設值、說明 —— 全部由程式碼與官方文案產生，改了程式碼重新產生即可對齊。
沒有符合的小節，換個關鍵詞試試。
手冊其它頁面也沒有符合。
設定#
設定#
電台、定位、鏈路與資料
設定頁頂部是 8 張分組卡（點進去是子頁面），下面還有 6 個直達入口。本頁把每個子頁裡的設定項逐條列出：名稱、控件、預設值、說明 —— 預設值直接取自程式碼，改了程式碼重新產生即對齊。
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
| 電臺 | 分組卡 | — | 呼號 · SSID · 符號 |
| 定位上報 | 分組卡 | — | GPS · 信標 · 手動定位 |
| 連線 | 分組卡 | — | 伺服器 · 篩選範圍 |
| 顯示 | 分組卡 | — | 座標 · 主題 |
| 裝置 | 分組卡 | — | 資料來源 · 鏈路與閘道 |
| 資料 | 分組卡 | — | 清除本機資料 |
| 高階 | 分組卡 | — | 實驗室 · 開發者 |
| 更新 | 分組卡 | — | 檢查新版本 |
| 運動排行榜 | 直達入口 | — | 今日步數排行（只統計本機收到的報文） |
| 榮譽牆 | 直達入口 | — | 我的徽章與成就 |
| 翻譯設定 | 直達入口 | — | 翻譯介面、語言與自動翻譯 |
| 匯出 ADIF | 直達入口 | — | 會話匯出為日誌檔案 |
| 主題 | 直達入口 | — | 自訂顏色、圖示與文字 |
| 歷史軌跡 | 直達入口 | — | 按天記錄自己的速度與里程，儲存在本機 |
| 備份與還原 | 直達入口 | — | 打包設定與資料為 JSON 檔 |
| 贊助與鳴謝 | 直達入口 | — | 名單與贊助方式（伺服器與地圖流量都靠它） |
| 關於 | 直達入口 | — | |
| 生命守護 | 直達入口 | — | 心率異常時告警、撥打急救、向附近臺站求助 |
電臺#
電臺#
呼號 · SSID · 符號
身份是所有封包的根：呼號必須與你的執照一致，SSID 決定臺站類型（-9 車載、-7 手持常見）。
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
| 高度（公尺，留空跟隨定位） | 輸入框 | — | 填了就用手填的這個海拔（更可靠：無氣壓計機型、室內、只有網路定位時 GPS 海拔常不可用），留空則跟隨定位的海拔。傳送時按英尺編成 /A=aaaaaa 六位；這是臺站海拔，與下面 PHG 裡的「天線高度」（高於當地平均地面）是兩個不同的量。 |
| 功率（瓦） | 輸入框 | — | 功率 / 天線高度 / 增益同屬一個 PHG 資料擴充，填了任一項就一起編碼送出（規範裡它是固定的 7 位元組欄位）。功率取不超過實際值的最大檔：25 W 報 25、30 W 也只報 25 —— 寫大了等於虛報覆蓋範圍。天線高度是「高於當地平均地面」，與上面自動傳送的 /A= 海拔是兩個不同的量。 |
| 天線高度（英尺） | 輸入框 | — | 功率 / 天線高度 / 增益同屬一個 PHG 資料擴充，填了任一項就一起編碼送出（規範裡它是固定的 7 位元組欄位）。功率取不超過實際值的最大檔：25 W 報 25、30 W 也只報 25 —— 寫大了等於虛報覆蓋範圍。天線高度是「高於當地平均地面」，與上面自動傳送的 /A= 海拔是兩個不同的量。 |
| 增益（dB） | 輸入框 | — | 功率 / 天線高度 / 增益同屬一個 PHG 資料擴充，填了任一項就一起編碼送出（規範裡它是固定的 7 位元組欄位）。功率取不超過實際值的最大檔：25 W 報 25、30 W 也只報 25 —— 寫大了等於虛報覆蓋範圍。天線高度是「高於當地平均地面」，與上面自動傳送的 /A= 海拔是兩個不同的量。 |
獨立狀態報文 aprsStatusText | 輸入框 | （空） | 這一點發的是獨立一幀狀態報文（> 開頭、不含座標、不會移動你在 aprs.fi 上的位置），與上面那行備註是兩種不同的 APRS 報文。留空則傳送內建的 APRSlocus 在線幀。 |
電臺身份
呼號、SSID 與備註
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
呼號 myCall | 輸入框 | BV2AAA | APRS 呼號，如 BV2AAA |
臺站備註 myComment | 輸入框 | （空） | 信標傳送時的備註內容 |
| 發射 | 按鈕 | — |
顯示資訊
我的符號與目前定位
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
| 網格 | 唯讀狀態 | — | |
| 我的位置 | 唯讀狀態 | — |
定位上報#
定位上報#
GPS · 信標 · 手動定位
三件事：用什麼定位（GPS / 網路 / 手動）、多久報一次（預設 60 秒、最短 5 秒）、報什麼（速度/方位角/電量可關）。
定位來源
選擇座標來源
無法自動定位時，可手動輸入經緯度或用地圖選點，用於信標上報與臺站距離計算。
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
手機 GPS模擬位置 useSimLocation | 選項卡 | 關 | 使用裝置定位 / 模擬位置：手動輸入座標 |
感測器輔助定位 sensorAssist | 開關 | 開 | 同時可用時的優先順序：模擬/手動位置 › 佳明（手錶有即時資料時）› 手機 GPS |
| 定位來源 | 唯讀狀態 | — |
定位模式
選擇定位方式
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
純 GPSGPS + 網路 · 純網路 locationMode | 選項卡 | gps_network | 僅衛星定位，更省電 / GPS + 網路：網路僅作兜底（GPS 停更時），粗定位不寫軌跡 / 純網路：僅基地台 / Wi-Fi，誤差百公尺級；最省電，適合沒有 GPS 的裝置 |
| 網路定位時的臺站圖示 | 入口 | — | 純網路定位的點可能偏幾百公尺到幾公里，換一個圖示能讓別人一眼看出「這是網路標的位」。預設跟隨「我的符號」。 |
外接 GPS 優先時手機 GPS 待機 extGpsStandby | 開關 | 開 | 外接 GPS（Garmin LiveTrack）推送資料時，停掉手機的定位以省電；外接失效時會自動切回手機 GPS，並在狀態列與日誌中說明。關掉它也不會讓位置變錯——位置優先順序本來就是「外接優先」。 |
信標上報
傳送間隔與上報內容
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
啟用位置信標 beaconEnabled | 開關 | 開 | 經典＝一行（狀態 + 立即上報）；詳細＝多一行判據：目前檔位、還差多少秒、距離打點還差多少公尺、轉彎還差多少度，並每秒更新一次。 |
純網路上報間隔（秒） beaconNetInterval | 輸入框 | 300 | 純網路模式使用固定間隔；網路定位沒有可靠速度，不使用智慧信標（依速度 / 距離 / 轉彎） |
上報間隔(秒) beaconInterval | 輸入框 | 60 | 位置信標的傳送間隔，至少 5 秒 |
智慧信標(依速度分檔) smartBeaconEnabled | 開關 | 關 | |
速度 beaconIncludeSpeed | 小開關 | 開 | |
方位角 beaconIncludeCourse | 小開關 | 開 | |
手機電量 beaconIncludeBattery | 小開關 | 開 | |
本次里程 beaconIncludeTripMileage | 小開關 | 關 | |
累計里程 beaconIncludeTotalMileage | 小開關 | 關 | |
步數 beaconIncludeSteps | 小開關 | 關 | |
| 今日步數 | 唯讀狀態 | — | 步數來自手機的計步感測器（硬體計數，比用加速度計估算準）。可以隨信標一起發出（STEPS=），對方也是 APRSlocus 時就能在運動排行榜裡看到你。 |
| 授予「身體活動」權限 | 按鈕 | — | |
| 定位狀態 | 唯讀狀態 | — | |
| 信標傳送次數 | 唯讀狀態 | — | |
| 下次上報 | 唯讀狀態 | — | 目前定位來自網路（粗，誤差常達幾百公尺）—— 自動上報已暫停，GPS 恢復後自動繼續；期間仍可手動上報。 |
| 開啟射頻信標 | 按鈕 | — | |
強制接受網路定位自動上報 beaconForceCoarse | 開關 | 關 | 正在用網路定位（粗）上報 |
| 重新定位 | 按鈕 | — |
連線#
連線#
伺服器 · 篩選範圍
APRS-IS 伺服器與 Passcode、資料來源複選、接收範圍（預設 300 km）、資料上限。改完點「儲存並套用」才生效。
APRS-IS 連線
連線狀態與資訊
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
| 連線 | 唯讀狀態 | — | |
伺服器 server | 輸入框 | rotate.aprs2.net | |
埠 port | 輸入框 | 14580 | |
| WebSocket URL(可選) | 輸入框 | — |
APRS-IS 連線
透過藍牙或串列的 TNC 與電台直接收發
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
| 已綁定裝置 | 唯讀狀態 | — | |
| 連線 | 唯讀狀態 | — | |
| 允許射頻信標 | 唯讀狀態 | — | TNC 模式下不使用伺服器與過濾器，相關設定已停用 |
| KISS 參數 | 按鈕 | — |
APRS-IS 連線
在電台 WLAN 設定裡開啟遙控並設定 Network User 名稱/密碼，手機與電台保持同一網段。WLAN 電台區域網路音訊固定 12000 Hz。
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
| 音訊後端 | 唯讀狀態 | — | |
| 取樣率 | 唯讀狀態 | — | |
| 連線 | 唯讀狀態 | — | |
| 允許射頻信標 | 唯讀狀態 | — | 音訊模式下不使用伺服器、過濾器與 KISS 參數 |
| WLAN 電台直連WLAN 電台直連 | 按鈕 | — | |
| 音訊（音效卡 TNC）音訊（音效卡 TNC） | 按鈕 | — |
APRS-IS 連線
用藍牙/串列埠讀取電台輸出的 Kenwood 航點語句（只收不發）
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
| 已綁定裝置 | 唯讀狀態 | — | |
| 連線 | 唯讀狀態 | — | |
| PKWDWPL（Kenwood 航點） | 唯讀狀態 | — | PKWDWPL 是唯讀鏈路：能收台站、不參與發射（發射請用 APRS-IS / TNC / 音訊） |
| PKWDWPL 裝置 | 按鈕 | — |
接收範圍篩選
過濾中心與接收半徑
只接收設定範圍內的臺站資料包
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
篩選中心跟隨我的位置儲存並套用篩選 filterFollow | 開關 | 開 | |
篩選半徑(km) filterRadius | 輸入框 | 300 | 接收半徑（km），點「儲存並套用」生效 |
| 用我的位置作為篩選中心 | 按鈕 | — |
資料上限
本機保留的資料量
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
最大臺站數 maxStations | 輸入框 | 100000 | 記憶體中保留的最大臺站數量（預設不限制，可設更大值） |
資料包保留條數 maxPackets | 輸入框 | 2000 | 資料包頁面保留的歷史條數（預設 2000，提高會佔用更多記憶體） |
軌跡點數上限 maxTrackPts | 輸入框 | 300 | 每個台站保留的軌跡點數（預設 300，決定運動軌跡能回溯多長；僅位移超過 20m 才記點） |
在線判定時長（分鐘） onlineWindowMin | 輸入框 | 5 | 台站最後上報超過該時長即視為離線（預設 5 分鐘） |
接收呼號篩選
按國家/地區或呼號接收
除範圍篩選外，按國家/地區分組或精確呼號接收臺站
顯示#
顯示#
座標 · 主題
深色模式、天氣小組件、單位與網格在這裡；地圖類型與離線地圖在地圖選單與對應子頁。另有一個公告橫幅開關（預設開）：橫幅顯示在首頁／地圖的頂部，內容取自官網的公告區，改官網就能發通知、不用等新版；斷網時顯示上次快取的那份，不想看到可以關掉（關掉後不再連網）。想主動查看時，用設定首頁最底部的「公告」按鈕 —— 它隨時可點，讀的是同一份內容。
全部
主題、語言與座標顯示
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
深色模式 darkMode | 開關 | 關 | |
天氣元件 weatherEnabled | 開關 | 開 | |
公告 noticeBanner | 開關 | 開 | 目前主題已固定主色，請到「主題」頁修改 |
| 單位 | 唯讀狀態 | — | |
| 網格 | 唯讀狀態 | — |
地圖
地圖類型與顯示
「地圖 2.0（向量）」使用客戶端即時向量渲染，資料量小、縮放清晰；柵格圖源為線上圖磚，畫質取決於網路。
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
永遠顯示地圖標籤 mapLabelsAlways | 開關 | 關 | 無論台站多少、縮放多小，都在地圖上顯示每個台站的呼號標籤。 |
| 離線地圖 | 入口 | — | 材質只作用於應用程式自己的表面（卡片、頂欄、導覽列、彈窗、地圖浮層），不是系統視窗的透明。模糊要佔顯卡：舊機型上可能不如關閉時順暢。 / 先把地圖圖磚下載到本機，沒有網路時也能看地圖 |
資料#
資料#
清除本機資料
唯讀統計與破壞性操作分開擺：清聊天記錄是單獨按鈕，「清除所有資料」會二次確認。
聊天記錄
聯絡人與聊天資料
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
| 聊天記錄 | 選項卡 | — | |
| 清空全部聊天記錄 | 按鈕 | — |
台站列表
收到的臺站與它們的軌跡，保存在本機
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
| 台站列表 | 選項卡 | — | |
| 清除臺站清單 | 按鈕 | — |
清除所有資料
刪除本機記錄
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
| 台站列表 | 選項卡 | — | |
| 聊天記錄 | 選項卡 | — | |
| 群組聊天 | 選項卡 | — | |
| 日誌 | 選項卡 | — | |
| 資料包 | 選項卡 | — | |
| 確認清除所有資料 | 按鈕 | — |
離線地圖
瀏覽地圖時自動快取，也可手動下載區域
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
| 離線區域 | 入口 | — | 已下載的區域可在地圖上離線檢視 |
高階#
高階#
實驗室 · 開發者
橫螢幕開關、示範資料（模擬臺站/封包）、收發計數與重新執行引導都在這裡。
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
允許手機橫屏顯示 labLandscape | 開關 | 關 | 實驗室功能仍在測試中，可能影響使用體驗。預設鎖定直向顯示，開啟後支援橫向顯示。 |
啟用模擬資料（示範臺站/資料包） devMode | 開關 | 關 | |
| 收包 / 發包 | 唯讀狀態 | — | |
| 臺站數量 | 唯讀狀態 | — | |
| 連線 | 唯讀狀態 | — |
裝置#
裝置#
資料來源、鏈路狀態與自檢
裝置總覽 = 當前鏈路 + 網關狀態 + 四個子頁入口（TNC / WLAN 電台 / 音訊 / PKWDWPL）+ 鏈路自檢與日誌。
閘道（iGate）
把射頻收到的報文送上 APRS-IS
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
啟用閘道 igateEnabled | 開關 | 關 | |
雙向閘道（向射頻轉遞訊息） igateTwoWay | 開關 | 關 | 射頻上一條報文都沒收到：閘道的條件已經全齊，但它無報文可轉。這不是閘道的問題 —— 報文根本沒進到應用程式裡。查上游：電台音量與靜噪、天線、對方是否真的在發射，也可以在日誌頁確認有沒有任何射頻報文。 |
| 射頻收到（條） | 唯讀狀態 | — | |
| 已轉遞 → APRS-IS（條） | 唯讀狀態 | — | |
| 已轉遞 → 射頻（條） | 唯讀狀態 | — | |
| 重複丟棄（條） | 唯讀狀態 | — | |
| 迴路拒收（條） | 唯讀狀態 | — | |
| 清空統計 | 按鈕 | — | |
| 允許射頻信標 | 唯讀狀態 | — |
目前鏈路
唯讀摘要 · 改參數請進對應子頁
裝置與參數
每條鏈路一個子頁，各管各的參數
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
| TNC 裝置與參數 | 選項卡 | — | 藍牙/序列綁定、初始化串、KISS 參數與發射自檢 |
WLAN 電台直連 source | 選項卡 | AudioSource.device | 已連線 |
| 音訊（音效卡 TNC） | 選項卡 | — | 用音效卡收發 AFSK 1200 報文 |
| PKWDWPL 裝置 | 選項卡 | — | 綁定電台連接埠 · 檢視航點接收狀態 |
APRSlocusBOX connected | 選項卡 | 關 | 已連線 |
| 心率 | 選項卡 | — | 藍牙心率帶（標準心率服務），可隨信標一起上報 |
| 佳明 LiveTrack | 選項卡 | — | 暫無日誌 / 把佳明手錶的活動即時位置接進來，隨信標上報 |
TNC 裝置與參數#
TNC 裝置與參數#
藍牙/序列綁定、初始化串、KISS 參數與發射自檢
接藍牙/USB TNC 的全部參數：綁定、初始化字串、線速、KISS 定時參數、中繼路徑、發射自檢。
藍牙 TNC
綁定並連接電台端的 TNC
兩條鏈路綁定了同一臺裝置
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
| 已綁定裝置 | 唯讀狀態 | — | |
| 連線 | 唯讀狀態 | — | 找不到裝置 · 請先在系統藍牙設定裡配對 TNC，或插上 USB 串列線（OTG） |
| 掃描裝置（藍牙已配對 + USB 串列） | 按鈕 | — | |
| 斷開連線重啟鏈路 | 按鈕 | — | |
| 解除綁定 | 按鈕 | — |
TNC 初始化字串
連線後逐行傳送（等價 APRSdroid 的 kiss.init）
若 TNC「能收不能發」，先在這裡試：很多藍牙/序列 TNC 模組上電停在命令模式，必須先收到 KISS ON、RESTART 等指令才進入 KISS 轉發狀態。每行一條命令（傳送時自動補 CRLF）。
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
行間隔 (ms) initDelayMs | 輸入框 | 300 | 每行命令之間的等待時間。模組處理命令需要時間，太短會丟命令 |
串列埠線速 (bd) serialBaud | 輸入框 | 9600 | USB 串列線與電台資料埠必須同速，否則一個位元組都收不到。常見值：9600 / 19200 / 38400 / 57600 / 115200。藍牙 SPP 沒有線速概念，綁藍牙裝置時此項不生效。 |
| 發射串口 | 入口 | — | 目前綁的是藍牙裝置：藍牙 SPP 沒有線速概念，此項不生效 / 已儲存。預設與接收共用一個埠；分開埠可避免 Windows 上讀寫爭用同一 COM 埠。 |
| 立即傳送初始化字串 | 按鈕 | — | |
| 未填寫初始化字串 | 選項卡 | — |
KISS 參數
直接下發到 TNC 的鏈路層參數
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
連線後下發 KISS 參數 pushKissParams | 開關 | 關 | 預設關閉（與 APRSdroid 一致）。打開後連線時會把上面的參數推給 TNC，覆蓋它自己的設定 —— 參數不合適可能讓它一直退避而不發射，所以只在需要統一管理時打開。 |
發射延時 (ms) txDelayMs | 輸入框 | 300 | KISS TXDELAY，單位 10ms。發射前留給自己 PTT 建立的時間 |
發射尾音 (ms) txTailMs | 輸入框 | 50 | KISS TXTAIL，單位 10ms。某些電台需要尾部保持才能收全 |
持續度 P persistence | 輸入框 | 63 | KISS PERSISTENCE，0-255。越小越禮讓，共用信道時能減少碰撞 |
時隙 (ms) slotTimeMs | 輸入框 | 100 | KISS SLOTTIME，單位 10ms。與持續度共同決定信道競爭節奏 |
全雙工 fullDuplex | 開關 | 關 | |
信道 / KISS 埠 channel | 輸入框 | 0 | 多信道 TNC 才有多埠，單信道電台保持 0 |
幀長上限 (位元組) maxFrame | 輸入框 | 330 | 超過此長度的報文不會發出（1200bd 下 AX.25 單幀約 330 位元組） |
射頻中繼路徑 path | 輸入框 | WIDE1-1,WIDE2-1 | 射頻上使用的中繼，如 WIDE1-1,WIDE2-1；留空則不指定 |
廠商命令碼 hardwareCmd | 輸入框 | -1 | KISS SETHARDWARE (0x06)，廠商自訂；-1 表示不下發 |
參數值 hardwareVal | 輸入框 | 0 | KISS SETHARDWARE (0x06)，廠商自訂；-1 表示不下發 |
| 下發參數 | 按鈕 | — | |
| 回到 TNC 命令模式 | 按鈕 | — | |
| 請先連接 TNC | 選項卡 | — | |
| 回到 TNC 命令模式 | 選項卡 | — | KISS SETHARDWARE (0x06)，廠商自訂；-1 表示不下發 |
發射自檢
向 TNC 寫一幀測試包，判斷問題在鏈路還是 TNC
發的是一幀狀態包（不含座標），不會把台站在 aprs.fi 上挪位置。若這裡顯示「已寫入」卻仍然不發射，問題在 TNC 側：先試初始化字串（KISS ON / RESTART），再檢查 TxDelay 與通道佔用。
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
| 寫入測試幀 | 按鈕 | — |
射頻（TNC）模式
射頻信道是共享資源，訊息能力相應受限
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
允許射頻信標 rfBeacon | 開關 | 關 | 打開後才會在射頻上定時發射位置。發射需以自己的呼號並在執照範圍內操作 |
自動回覆 ACK autoAck | 開關 | 開 | 關閉後不回覆收到的訊息回執，可減少射頻佔用 |
斷開後自動重連 autoReconnect | 開關 | 開 |
WLAN 電台直連#
WLAN 電台直連#
局域网直连 Icom 电台（IC-705 / IC-9700 / IC-7610 / IC-905），收发 12 kHz PCM 音频与 CI-V 控制
區域網路直連 Icom 電台（IC-705 / IC-9700 / IC-7610 / IC-905 等）：電台 IP/控制埠、Network User 認證、CI-V 位址與導前延時（TX Delay）、射頻中繼路徑（如 WIDE1-1,WIDE2-1）、收發 12 kHz PCM 音訊。
电台链路状态
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
| 啟用 WLAN 電台直連 | 開關 | — | 开启后，APRS 音频收发数据源将直接绑定至 $… 局域网直连 |
| 射频收发统计 | 唯讀狀態 | — | |
| 音频采样率 | 唯讀狀態 | — |
电台网络参数
选择电台型号预置并配置 IP 与 Network User 凭据
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
| 電台 IP | 輸入框 | — | |
| 控制埠 | 輸入框 | — | |
| 使用者名稱（Network User） | 輸入框 | — | |
| 密碼（Network User） | 輸入框 | — | 提示：用户名和密码必须与电台内部 Network User Setting 完全一致。 |
CI-V 控制与发射设置
PTT 自动控制、前导延时与信标参数
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
允許射頻信標 rfBeacon | 開關 | 關 | 是否允许通过电台射频自动周期发射信标（半双工，发射时自动静默监听）。 |
发射前导延迟 (TX Delay, ms) txDelayMs | 輸入框 | 300 | |
| 电台 CI-V 地址 (十六进制) | 輸入框 | — | |
| 控制器地址 | 唯讀狀態 | — | |
射頻中繼路徑 path | 輸入框 | WIDE1-1,WIDE2-1 | 射頻上使用的中繼，如 WIDE1-1,WIDE2-1；留空則不指定 |
电台设置指引
在 Icom 电台上的必要准备步骤
音訊（音效卡 TNC）#
音訊（音效卡 TNC）#
用音效卡收發 AFSK 1200 報文
把音效卡當 TNC：取樣率/鮑率/音調、發射電平與 CSMA 等待、WAV 檔案模式（離線解碼錄音）。
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
| 播放裝置 | 入口 | — | 要啟用 / 切換資料來源（鏈路），請到「設定 → 裝置」 |
音訊擷取
從麥克風/線路輸入解調 AFSK 1200
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
| 音訊後端 | 唯讀狀態 | — | |
| 連線停止擷取 · 重啟音訊鏈路 | 唯讀狀態 | — | |
| 解調鎖定 | 唯讀狀態 | — | 解碼中止 … 次（雜訊/失步） |
| 收 … 幀 | 唯讀狀態 | — | 目前平台不支援即時音訊（可用 WAV 檔案模式） |
音訊（音效卡 TNC）
用音效卡收發 AFSK 1200 報文
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
取樣率 sampleRate | 輸入框 | 22050 | 22050Hz 是音效卡 TNC 常用值；裝置不支援時改用 44100/48000。修改會重啟擷取 |
| 位元率 | 輸入框 | — | APRS 在 VHF 上固定 1200 bd（Bell 202），HF 才用 300 |
| 標號頻率 (Hz) | 輸入框 | — | Bell 202 規定標號 1200Hz、空號 2200Hz；只有 ±幾 Hz 的容差，不要隨意改 |
| 空號頻率 (Hz) | 輸入框 | — | 空號音調。與標號音調一起決定 FSK 頻偏（標準為 1000Hz） |
發射前導 (ms) txDelayMs | 輸入框 | 300 | 發射前導時長：給對端解調器鎖定時間、給電台 PTT 建立時間 |
音訊發射
發射前先聽通道，避免與其他台站碰撞
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
允許發射 txEnabled | 開關 | 開 | 關閉後只接收不發射（只想聽信標時最省心） |
允許射頻信標 rfBeacon | 開關 | 關 | 打開後才會在射頻上定時發射位置。發射需以自己的呼號並在執照範圍內操作 |
發射前等待通道空閒 (ms) csmaWaitMs | 輸入框 | 3000 | 偵測到通道佔用時最多等待多久；0 = 不等待直接發射 |
射頻中繼路徑 path | 輸入框 | WIDE1-1,WIDE2-1 | 射頻上使用的中繼，如 WIDE1-1,WIDE2-1；留空則不指定 |
幀長上限 (位元組) maxFrame | 輸入框 | 330 | 超過此長度的報文不會發出（1200bd 下 AX.25 單幀約 330 位元組） |
| 發射電平 | 唯讀狀態 | — | 發射前系統會把媒體音量拉到最大、並暫停麥克風擷取；峰值太低或削頂都會讓對端解不出 |
自動回覆 ACK autoAck | 開關 | 開 | 關閉後不回覆收到的訊息回執，可減少射頻佔用 |
斷開後自動重連 autoReconnect | 開關 | 開 | |
| 停止發射 | 按鈕 | — |
WAV 檔案模式
離線解碼一段錄音，或把報文匯出成音訊檔案
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
| 待匯出報文 (TNC2) | 輸入框 | — | 格式 SRC>DEST,PATH:info，例如 BG7LZQ-9>APALOC:>TEST |
| 檔案路徑 | 輸入框 | — | 離線解碼一段錄音，或把報文匯出成音訊檔案 |
| 選擇 WAV 檔案 | 按鈕 | — | |
| 匯出到下載目錄 | 按鈕 | — | |
| 複製路徑 | 按鈕 | — | |
| 路徑已複製 | 選項卡 | — | 接電台請用音訊線（耳機孔 → 電台資料孔/麥克風）；手機喇叭在 2200Hz 衰減很大，對著麥克風很難解出。對端是電腦上的 Direwolf 時，先用「匯出」出的 WAV 驗證一遍，能解出就說明問題在音訊通路而不是協定 |
鏈路日誌
暫無日誌
PKWDWPL 裝置#
PKWDWPL 裝置#
綁定電台連接埠 · 檢視航點接收狀態
Kenwood 航點唯讀鏈路：綁定與狀態、收到的航點計數、嚴格校驗和（預設關，只標註不丟棄）。
裝置綁定與狀態
選擇輸出 語句的那個串列埠 / 藍牙埠
兩條鏈路綁定了同一臺裝置
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
| 已綁定裝置 | 唯讀狀態 | — | |
| 連線 | 唯讀狀態 | — | |
| PKWDWPL（Kenwood 航點） | 唯讀狀態 | — | 找不到裝置 · 請先在系統藍牙設定裡配對 TNC，或插上 USB 串列線（OTG） |
| 掃描裝置（藍牙已配對 + USB 串列） | 按鈕 | — | |
| 斷開連線重啟鏈路 | 按鈕 | — | |
| 解除綁定 | 按鈕 | — |
航點接收
綁定電台連接埠 · 檢視航點接收狀態
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
| 已收航點 … 條 | 唯讀狀態 | — | |
| 丟棄/無效語句 | 唯讀狀態 | — | |
| 校驗和不符 | 唯讀狀態 | — | |
| 其它 NMEA 語句（已忽略） | 唯讀狀態 | — | 帧缓冲溢出 $… 字节 |
嚴格校驗和（不符即丟棄） strictChecksum | 開關 | 關 | 預設關閉：驗證不符時只標註並記日誌，不丟句子 —— 本機線纜上的不符多半是韌體格式與手冊有出入，整條丟棄會讓介面「什麼都不顯示」，反而更難排查 |
斷開後自動重連 autoReconnect | 開關 | 開 | 暫無 PKWDWPL 日誌 |
翻譯設定#
翻譯設定#
翻譯介面、語言與自動翻譯
目標語言、引擎（預設 auto 免金鑰）、各引擎的金鑰/實例位址、測試翻譯。
翻譯為
翻譯介面、語言與自動翻譯
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
| 翻譯為 | 唯讀狀態 | — | |
| 翻譯介面 | 唯讀狀態 | — | 翻譯會把訊息文字傳送到你選擇的第三方介面，請自行評估隱私 |
翻譯介面
依次嘗試多個免密鑰介面，取第一個真正翻譯成功的結果
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
| 本次實際使用 | 唯讀狀態 | — | 開源、可自建最可靠；公共實例現已要求密鑰且常不支援中文 |
實例網址 libreUrl | 輸入框 | https://libretranslate.com | |
實例 API Key（公共實例需要，自建可留空） libreApiKey | 輸入框 | （空） | |
Google API Key googleApiKey | 輸入框 | （空） | Google Cloud Translation v2 的 API Key，需自行到 Google Cloud 主控台申請 |
百度 App ID baiduAppId | 輸入框 | （空） | |
百度密鑰 baiduKey | 輸入框 | （空） | 在百度翻譯開放平台申請「通用文本翻譯」，密鑰只保存在本機 |
介面網址 customUrl | 輸入框 | （空） | |
請求標頭 (JSON) customHeaders | 輸入框 | {"Content-Type": "application/json"} | |
請求主體範本 customBody | 輸入框 | {"q": "{text}", "source": "{from}", "target": "{to}"} | 可用佔位符：… 原文、… 來源語言、… 目標語言。選擇 GET 時忽略此項 |
結果欄位路徑 customResultPath | 輸入框 | （空） | 用點號表示層級，陣列用序號，如 data.translations.0.translatedText |
測試翻譯
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
| 測試翻譯 | 按鈕 | — | |
| 翻譯 | 唯讀狀態 | — |
主題#
主題#
把介面配色、圖示與常用文案改成你自己的
顏色 / 圖示 / 文字 / 背景圖四大塊，改完可匯出 JSON 分享；預設皮膚可一鍵切換。
顏色
逐項覆寫配色；未修改的項跟隨預設
卡片表面
有背景圖時，卡片要多透才既看得見圖又讀得清字
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
| 不透明度（越低越透） | 選項卡 | — |
介面鬆緊與字體
只作用於卡片與輸入框的留白，不改各處細節間距
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
| 鬆緊 | 選項卡 | — | 改的是卡片內邊距；若某項看起來沒變，說明那處留白是單獨寫死的 |
| 字體 | 選項卡 | — | 只使用系統已裝的字體；某台裝置沒裝時會自動回退，不會變方框 |
強調色
入口卡片的漸變色，以及每個頁籤自己的強調色
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
| 統一入口卡片配色 | 開關 | — | |
| 漸變起始色 | 選項卡 | — | |
| 漸變結束色 | 選項卡 | — |
背景圖
用一張圖片做整個介面的底；卡片會自動變得半透明
目前主題未使用背景圖，介面底為純色
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
| 移除背景圖 | 按鈕 | — | |
| 不透明度 | 選項卡 | — | |
| 模糊 | 選項卡 | — | |
| 填滿方式 | 選項卡 | — | |
| 對齊 | 選項卡 | — | |
| 縮放 | 選項卡 | — | 背景圖只存在本機：主題檔裡只記錄引用，不含圖片本身，分享給別人後對方會看到無背景的主題。 |
卡片圓角
作用於卡片與輸入框（小徽標等不受影響）
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
| 卡片圓角 | 選項卡 | — |
圖示
為底部頁籤與設定入口換圖示
Web 版不支援匯入圖片，請使用內建圖示庫
文字
覆寫常用文案（按鈕與錯誤提示不開放，避免介面變得不可操作）
匯入與匯出
主題是 JSON 文字，可以分享給別人，也可以手動編輯
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
| 匯出時包含圖片 | 開關 | — | 圖片較大，無法透過剪貼簿傳遞，請用「匯出全部主題」存成檔案 |
| 匯出全部主題 | 選項卡 | — | |
| 匯入主題 | 選項卡 | — | |
| 從剪貼簿匯入 | 選項卡 | — | |
| 重設本主題 | 選項卡 | — |
皮膚資訊
分享給別人時，這兩項會跟著皮膚一起走
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
| 作者 | 選項卡 | — | |
| 說明 | 選項卡 | — | |
| 重新命名 | 選項卡 | — |
預設與我的主題
把介面配色、圖示與常用文案改成你自己的
預設主題不可修改，複製為我的主題後即可自由編輯
備份與還原#
備份與還原#
匯出或匯入設定與資料
一個 JSON 裝下設定與資料；白名單匯入防來路不明的檔案改設定；匯入後需重啟生效。
備份與還原
備份檔是 JSON 文字，換機或重裝後可還原；匯入會依分組覆蓋，無法復原。
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
| 備份檔包含呼號、伺服器密碼與 API 金鑰，請妥善保管。 | 選項卡 | — | |
| Web 版請用「複製到剪貼簿 / 從剪貼簿貼上」匯入匯出。 | 選項卡 | — |
匯出備份
選擇要包含的內容，再存成檔案或複製到剪貼簿
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
| 全選 | 按鈕 | — | |
| 已儲存到：… | 選項卡 | — | |
| 匯出時包含圖片 | 開關 | — | 備份會包含主題引用的圖片本體；不包含時，換機還原後主題會回退成內建圖示 |
匯入備份
選擇先前匯出的 JSON 備份檔
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
| 選擇備份檔 | 按鈕 | — | |
| 從剪貼簿貼上 | 按鈕 | — |
離線地圖#
離線地圖#
先把地圖圖磚下載到本機，沒有網路時也能看地圖
圖磚快取與「僅使用離線圖磚」開關；下載範圍 = 當前所見那一螢，入口在地圖選單。
圖磚快取
瀏覽地圖時自動快取，也可手動下載區域
| 設定項 | 控件 | 預設值 | 說明 |
|---|---|---|---|
快取地圖圖磚 tileCacheOn | 開關 | 開 | 瀏覽地圖時把圖磚存到本機，之後可離線檢視 |
僅使用離線圖磚 offlineOnly | 開關 | 關 | 不再從網路載入圖磚，只用已下載/已快取的圖（省流量） |
離線區域
已下載的區域可在地圖上離線檢視
範圍太大（約 … 張圖磚），請縮小範圍或降低最大層級