トラブルシューティング¶

よくある問題と確認点です。以下のパスは既定のデータディレクトリを前提とします。

OS	データディレクトリ
Linux	`~/.local/share/fbsat59/`
macOS	`~/Library/Application Support/fbsat59/`
Windows	`%APPDATA%\fbsat59\`

その中の fbsat59.db がデータベースです。ログファイルのパスは起動時にコンソールへ出力されます（[FBSAT59] Log file: …）。

起動¶

起動しない — ターミナルから実行してエラーを確認します。Windows では、 8.1 でない素の Windows 8 は DLL 不足で失敗します（8.1 以降で使用）。最終手段として、終了して fbsat59.db を退避すると作り直されます。

「Fetching TLE data…」で止まる — インターネットが必要です。1〜2 分待ちます（CelesTrak が遅い・一時的にダウンしていることがあります）。終わらない場合は終了して再起動すれば、手元にある TLE で起動します。

位置を確認 — ファイル → QTH設定…。十進法度数、半球、妥当な標高
TLE を更新 — Satellite → Update TLE を実行し完了を待つ。衛星を右クリック → Satellite Info… で TLE エポックを確認できます
リストのフィルタを確認 — グループや Hidden になっていたら All Satellites に広げる

USB/CAT ケーブルを確認、別ポートを試す
OS が用意しない場合はリグの USB ドライバーを導入
ポートを確認：Linux ls /dev/ttyUSB* /dev/ttyACM*、macOS ls /dev/cu.*、 Windows はデバイスマネージャー → ポート（COM と LPT）
無線機 → 無線機設定 で Scan からポートを設定し、Baud Rate をリグの CAT 設定に合わせ（Test ボタンで確認）、正確な Rig Model（または近い機種）を選ぶ

無線機制御 タブの Cycle (ms)（CAT／ドップラーの更新間隔）を大きくします。

接続して数秒待つ
無線機 → 無線機設定 → SDR Settings タブ → Enumerate
Windows では RTL-SDR と HackRF に、Zadig で一度だけ WinUSB ドライバーを当てる必要があります（libusbK は不可）。 Windows で動くのは RTL-SDR と HackRF のみ — セットアップステップ 3 参照
Linux／macOS ではデバイス用の SoapySDR モジュールを導入します。パッケージ名は Help → SDR Device Installation… に載っています

接続できない — デスクトップと同じ Wi-Fi か、IP がステータスバーと一致するか、ゲスト／AP 分離ネットワークでないか。デスクトップ自身なら http://localhost:8080 を試す。ポートは 8080 固定
レーダーが遅い — Wi-Fi の電波、他のタブ、デスクトップの CPU 負荷
コンパスが動かない — ブラウザにモーション／方位の許可を与える。 iOS は HTTPS 配信が必要。8 の字で再較正

「Database is locked」 — 2 つ目の FBSAT59 を終了して再起動します。それでも直らなければ終了して fbsat59.db を退避します（次回起動で作り直され、TLE とトランスミッターは再取得）。お気に入りや設定を残したい場合は先にバックアップしてください。