トラブルシューティングガイド¶
FBSAT59 の使用時に遭遇する一般的な問題への解決策。
起動の問題¶
FBSAT59 が起動しません¶
確認事項：
1. アプリをクリック / ターミナルから実行してエラーメッセージを確認
2. Python 3.11 以上がインストールされていることを確認：python3 --version
3. ディスク空き容量を確認：最低 500 MB
4. 設定を削除してみてください：rm -rf ~/.config/fbsat59
5. コンピューターを再起動
続く場合：https://github.com/jf9som/fbsat59/issues で問題を報告
スプラッシュスクリーンが応答しません¶
「Fetching TLE data...」で初期化がスタックしている場合：
- インターネット接続を確認
- WiFi/4G をオフに（利用可能な場合は有線接続を使用）
- CelesTrak サーバーが一時的にダウンしている可能性
- 2～3 分待つ（大容量 TLE ダウンロードは遅い可能性）
- 5 分以上スタック：強制終了して再起動
衛星追尾の問題¶
「見える衛星がない」 / パスリストが空¶
考えられる原因：位置が間違っているか、TLE データが読み込まれていない
修正： 1. 位置を確認（Settings → Location） - 座標が十進法度数か確認 - 半球が正しいか確認（N/S、E/W） - 標高が妥当か確認（0～3000m） 2. TLE を更新 - Help → TLE Status（年齢を確認） - Satellite メニュー → Fetch TLE Data - ダウンロードの完了を待つ
衛星位置が間違っているように見える¶
原因：古い TLE データまたは位置エラー
修正： 1. TLE データを更新（上記参照） 2. GPS またはウェブツールで位置を確認 3. ISS は検証用に最適な衛星
パス時刻が数時間ずれている¶
原因：タイムゾーンのずれまたは位置エラー
修正：
1. システム時刻を確認：date（ターミナル）
2. 位置の緯度/経度を確認（±1° はずれすぎ）
3. 表示形式を変更：View → Time Zone（UTC vs Local）
無線機制御の問題¶
「Serial Port Not Found」または「Failed to Connect」¶
ステップ 1：物理的接続を確認 - USB ケーブルが接続されているか確認 - コンピューターの別の USB ポートを試す - 別の USB デバイスでポートが動作するか確認
ステップ 2：ドライバ（Windows/macOS） - FTDI ドライバをダウンロード：https://ftdichip.com/drivers/ - インストール後 FBSAT59 を再起動
ステップ 3：ポート名
- Linux：lsusb（無線機のベンダー ID を確認）
- macOS：ls /dev/tty.*（シリアルポートを一覧表示）
- Windows：デバイスマネージャー → 無線機/COM ポートを確認
ステップ 4：設定 - 手動ポート選択を試す（自動検出ではなく） - ボーレートを変更（38400 → 19200 または 9600） - 無線機マニュアルで CAT/CI-V 設定を確認
トランスポンダー選択時に周波数が更新されない¶
考えられる原因：無線機が接切られていない、またはモードが違う
修正： 1. 無線機が接続されていることを確認：ステータスバーに ✅ RIG: 1 が表示されるはず 2. 無線機が SSB/USB/LSB モードにあることを確認（FM ではない） 3. FBSAT59 と無線機の接続を再起動 4. Hamlib から別の無線機モデルを試す（設定をトラブルシューティング）
ドップラー補正が過度またはほぼ機能していない¶
原因：位置エラーまたは古い TLE
修正： 1. 位置精度を確認（1 km 以内） 2. TLE データを更新（24 時間以内） 3. ISS でテスト（ドップラー検証に最適） 4. ドップラーシフトは以下のように機能するはず： - 衛星が接近すると周波数が増加（TCA で最大） - 衛星が遠ざかると周波数が減少
PTT（送信）が動作しない¶
確認： 1. 無線機が接続されている（ステータスバーに ✅ RIG: 1 が表示） 2. 無線機が CAT PTT をサポート（マニュアルを確認） 3. 試す：トランスポンダーをクリック → Radio Control タブ → [PTT ON] をクリック 4. 無線機が送信モード（RX ロック状態ではない）か確認
SDR の問題¶
SDR が検出されない¶
確認： 1. USB 経由で SDR をプラグイン 2. 3～5 秒待つ（ドライバが読み込まれます） 3. Settings → SDR Settings → [Detect] をクリック 4. 見つからない場合：ドライバの問題（下記参照）
Linux ドライバ：
sudo apt install libsoapysdr0 soapysdr-module-rtlsdr
macOS ドライバ：
brew install soapysdr rtl-sdr
Windows：https://osmocom.org/projects/rtl-sdr/wiki/Rtl-sdr からダウンロード
ウォーターフォールに信号が表示されない¶
修正： 1. 下り周波数を確認（衛星送信周波数のはず） 2. ゲインが十分であることを確認（40+ dB を試す） 3. アンテナ接続を確認 4. 予想周波数から ±50 kHz でチューンしてみる 5. 既知の送信機（ラジオ局）で最初にテスト
音声がノイズノイズしている / 歪んでいる¶
原因：ゲインが高すぎる、サンプルレートが低すぎる、または CPU 使用率が高い
修正： 1. RF ゲインを下げる（50 → 30 dB から削減） 2. 可能な場合はサンプルレートを上げる（2.4 MSPS が 1 MSPS より良い） 3. 他のアプリを閉じる（CPU 負荷を削減） 4. USB ケーブルを確認（安価なケーブルは干渉を引き起こす可能性）
Web インターフェース（モバイル）の問題¶
http://192.168.x.x:8080 に「接続できません」¶
修正：
1. デスクトップと 同じ WiFi ネットワーク にいることを確認
2. ステータスバーのデスクトップ IP を確認（例とは異なるかもしれません）
3. セルラーデータを無効化（WiFi + セルラーは問題を引き起こす可能性）
4. 同じデバイスにいる場合は http://localhost:8080 を試す
5. ファイアウォール確認（一部のルーターはゲストネットワークを分離します）
レーダーの更新が遅い / 反応が鈍い¶
原因：ネットワークレイテンシまたはデスクトップ CPU オーバーロード
修正： 1. WiFi ルーターに近づく 2. WiFi 信号強度（RSSI）を確認 3. 開いているブラウザタブを閉じる 4. 他のデスクトップアプリを閉じる
コンパスモードが動作しない（Android）¶
修正： 1. デバイスにコンパスセンサーがあることを確認（Settings → Sensors） 2. コンパスを再校正：電話を数字の 8 の字状に動かす 3. スクリーン回転ロックを無効化（自動回転がオンである必要） 4. ブラウザを強制終了して再度開く
データとデータベースの問題¶
「Database Locked」エラー¶
原因：データベースの破損またはファイル権限の問題
修正：
# バックアップ
cp ~/.fbsat59-db.sqlite ~/.fbsat59-db.sqlite.backup
# データベース削除（次回起動時に再構築）
rm ~/.fbsat59-db.sqlite
# FBSAT59 を再起動
TLE 更新がスタック / 完了しない¶
修正： 1. インターネット接続を確認 2. 手動更新を試す：Help → TLE Status 3. CelesTrak がダウンしているかもしれません（5 分後に再度試す） 4. ファイアウォールがアクセスをブロックしていないか確認
パフォーマンスの問題¶
CPU 使用率が高い¶
原因：表示する衛星が多すぎるか、更新レートが高い
修正： 1. View メニュー → より単純なマップ/レーダーを使用 2. 表示される衛星の数を削減（検索/フィルター） 3. バックグラウンド機能を無効化（録音、UDP ブロードキャスト）
メモリ使用率が時間経過で増加¶
原因：メモリリーク（稀）またはアプリの長時間実行
修正： 1. 定期的に FBSAT59 を再起動（日次推奨） 2. タブを閉じて再度開く 3. 続く場合：https://github.com/jf9som/fbsat59/issues で報告
詳しいヘルプを取得¶
ログを確認¶
開発者/デバッグ向け：
# アプリケーションログを表示
tail -f ~/.cache/fbsat59/fbsat59.log
# または macOS/Linux で：
journalctl -u fbsat59 -f
バグを報告¶
含める： 1. 再現手順（あなたが何をしたか） 2. 期待される動作（何が起こるべきか） 3. 実際の動作（実際に何が起きたか） 4. スクリーンショット（ビジュアル問題の場合） 5. システム情報：OS、FBSAT59 バージョン、無線機モデル
投稿先：https://github.com/jf9som/fbsat59/issues
コミュニティに質問¶
- Discord：[コミュニティサーバーに参加] （リンク）
- Reddit：r/amateurradio
- QRZ.com：「FBSAT59」を検索
一般的な誤り¶
| 誤り | 影響 | 解決策 |
|---|---|---|
| 位置が 10° 以上ずれている | パス時刻が数時間ずれる | 緯度/経度を確認 |
| TLE が 72 時間以上古い | 衛星位置が不正確 | TLE を手動更新 |
| 無線機が間違ったモード | 周波数が変わらない | ラジオを USB/SSB モードに設定 |
| SDR ゲインが高すぎる | クリッピング / 歪み | 30～40 dB に低下 |
| 古いデータベース | 新しい衛星が見つからない | データベースを削除＆再構築 |
何もうまくいかない場合¶
- すべてを再起動：コンピューター、無線機、SDR、アプリ
- FBSAT59 を更新：新しいバージョンをチェック
- キャッシュをクリア：
~/.fbsat59-db.sqliteを削除 - ヘルプを求める：詳細を含む GitHub の問題を開く
🚀 あなたは一人ではありません。ほぼすべての問題は解決可能です！