トラブルシューティング
起動ログの最初のエラーから確認します。環境、モデルのリソース、シミュレーション時刻、プラグイン、データ受信の順に調べると原因を絞れます。エラーと、その前後の再現に必要なログを残してください。
パッケージが見つからない
printf 'ROS_DISTRO=%s\n' "$ROS_DISTRO"
ros2 pkg prefix posim_demos
lyricalと、選択したワークスペースのパスが表示されるはずです。インストール方法に合ったターミナル環境を読み込み、ホストとコンテナのパスを区別してください。
モデルやメッシュが見つからない
最初に見つからないと報告されたURIを確認します。パッケージのリソースがインストール済みか、正しい環境を読み込んだかを調べてください。Fuelのリソースを取得するには、Gazeboの実行環境からネットワークへ接続できる必要があります。初回のダウンロードには時間がかかるため、進行状況を見てから再起動を判断します。
画像が出ない、描画の初期化に失敗する
インストールガイドのグラフィックスドライバーと画面接続を確認します。Gazebo と画像センサーには正常な描画環境が必要です。ソナーでは選択したバックエンドと導入済みパッケージも確認してください。
水中シーンの効果では、次を調べます。
/posim/appearance/<session_nonce>/stateサービス、レンダラーとシェーダーのパス、アクティブなカメラ数。- 描画後の適用済みリビジョンと準備状態。
- 浮遊粒子を明示的に有効にしたか。初期状態では無効です。カメラの減衰サンプルだけではシーン効果のシステムは読み込まれません。
GNSSで有効な測位結果が得られない
GNSSの有効性状態、アンテナのワールド座標での高さ、局所的な水面高、取得時刻を確認します。ワールドの地理座標設定、アンテナが水上で遮られていないこと、再捕捉と遅延に必要なシミュレーション時間を確認してください。
波のトピックを設定した場合は、互換性のある新しい局所水面高データが届く必要があります。受信機をインストールしただけではモデルへの取り付けやROS・オートパイロットとの接続は行われません。
メッセージが届かない
まず時刻が進むことを確認し、トピックと型を調べます。
gz topic -l
ros2 topic list -t
ros2 topic info /underwater_camera/simulated_image --verbose
正しい通信系と、同じ設定済み環境を使ってください。QoS、ドメイン、ブリッジやプラグインのエラーを確認します。センサー起動時のnamespaceは既存の記述ファイル名に対応している必要があります。USBLはサンプルワールドに組み込まれているため、ワールドの起動コマンドを使います。
画像トピックは見えるがフレームが届かない
Gazeboが画像を生成し、ROSがPublisherを検出しているのに受信が止まる場合は、DDSのデータ経路を確認します。Cyclone DDSの大きなUDPデータグラムが、IPフラグメンテーションの制限にかかる場合があります。MTUが1500バイトのネットワークでは、データグラムを小さくすると改善することがあります。Cyclone DDSの分割設定も参照してください。
設定ファイルを用意する
rmw_cyclonedds_cppがインストールされている環境で、次の設定ファイルを一度作成します。既存のCyclone DDS設定がある場合は、そのGeneralに2つのサイズ設定を追加し、探索とネットワークインターフェースの設定を保ってください。
mkdir -p "$HOME/.config/posim"
cat > "$HOME/.config/posim/cyclonedds-images.xml" <<'XML'
<CycloneDDS xmlns="https://cdds.io/config">
<Domain Id="any">
<General>
<MaxMessageSize>1400B</MaxMessageSize>
<FragmentSize>1280B</FragmentSize>
</General>
</Domain>
</CycloneDDS>
XML
同じ設定で起動し直す
シミュレーターと表示ツールを停止します。各ターミナルでPOSIM環境を読み込んでから設定ファイルを選択し、プログラムを起動し直します。既存の設定を変更した場合は、そのファイルのパスを使ってください。
export RMW_IMPLEMENTATION=rmw_cyclonedds_cpp
export CYCLONEDDS_URI="file://$HOME/.config/posim/cyclonedds-images.xml"
同じドメインでROS CLIのバックグラウンドプロセスが動作中なら、一度停止します。以後のコマンドが新しい設定を使うようになります。
ros2 daemon stop
画像と受信頻度の確認をやり直し、取得時刻も確認します。小さいパケットには追加の処理負荷があります。MTUがさらに小さいネットワークでは、これらのサイズも下げる必要があります。
機体が動かない
コントローラーの状態、アーミング、航法情報の有効性、指令の受信、選択したモードを確認します。ジョイント名とスラスター軸も確認してください。指令元は1つだけ有効にします。中立入力、一時停止中のワールド、ディスアーム状態のオートパイロットでは、機体が静止していても異常とは限りません。
シミュレーションが終了しない
表示ツールを停止し、起動したターミナルでCtrl+Cを一度押して、子プロセスの終了を待ちます。異常終了、セグメンテーション違反、強制終了に関するログを残してください。問題を報告する際は、コマンド、リビジョン、OS、アーキテクチャ、レンダラーを記載します。
Discardを選ぶとRVizが終了時にクラッシュする
POSIMのUbuntu/WSLインストーラーとAMD64/ARM64 Dockerイメージには、RViz 15.2.6用の独立したRVizオーバーレイが含まれています。終了が確定すると更新タイマーを停止し、終了処理中にビューが所有するROSリソースを解放します。Cancelを選ぶと更新は続きます。システムのRVizパッケージは変更しません。POSIM環境を読み込んだ後、ros2 pkg prefix rviz_commonの出力が/opt/posim/rviz-close/installであることを確認してください。以前のインストール環境では、リンク先のビルドと有効化の手順に従ってください。
オーバーレイを使わないUbuntu 26.04のRViz 15.2.6では、センサー表示が正常でも、ウィンドウを閉じてDiscardを選ぶとクラッシュすることがあります。このオーバーレイは特定のタイマーとリソース解放の問題を修正するもので、すべてのレンダラーや終了経路の問題に対応するものではありません。問題が続く場合は、RVizのバージョン、読み込まれたライブラリのパス、終了操作を報告に含めてください。
RVizのウィンドウを閉じた後もプロセスが動作し続ける場合、特にソフトウェアレンダリングではメモリを過剰に消費することがあります。再実行する前に、起動したターミナルでCtrl+Cを押して残ったプロセスを停止してください。RVizが正常に終了しない場合は、ROS launchが強制終了します。ビューアーが不要なソナー実行では、multibeam_sonar_demo.launch.pyコマンドにrviz:=falseを追加してください。ROSの画像出力は引き続き利用できます。
macOSネイティブSDKで深度カメラを再作成する
macOS arm64 / Ogre-Next 2.3.3向けの独立したOgre環境には、深度カメラの破棄・再作成時に必要なマテリアル寿命の修正があります。
指定されたSDKとソースの確認手順に従ってビルドし、Gazeboコマンドをrun_overlay.pyへ渡します。ビルドするだけでは、そのライブラリを実行時に選択しません。実際に読み込まれたパスを確認し、検証結果を残してください。標準インストーラーでは有効にならず、システムライブラリの置き換えやLinuxコンテナの設定も行いません。他のバージョンや環境には、それぞれ対応するプロファイルが必要です。
再現できる報告を作る
ソースのSHAまたはイメージのダイジェスト、依存関係のバージョン、コマンドと引数、最初のエラー、期待した動作、関連トピックの型、最小の再現例を記載します。トピックが一覧に見えるだけなのか、データも受信できるのかを区別してください。
MAVROS 2.16.0 が SIGSEGV で終了する
POSIM のインストールスクリプトと公式 Docker ビルドには、MAVROS 2.16.0 の
Router の寿命管理に関する修正が含まれています。
POSIM の環境を読み込んでから ros2 pkg prefix mavros を実行すると、
/opt/posim/mavros-router/install が表示されます。既存の環境には、リンク先の
個別ビルド手順で修正を適用できます。クラッシュが続く場合は、MAVROS のログと
実際に読み込まれたライブラリのパスを不具合報告に添えてください。
POSIMはWSL、QGCはWindowsで起動している場合
Windows版QGCを閉じ、POSIMと同じUbuntuディストリビューションまたはPOSIMコンテナー内でLinux版QGCを起動してください。WSLgのウィンドウはWindowsデスクトップに表示されますが、Linuxプロセスです。QGCの設定では、テレメトリーと映像を同じ環境内で送受信します。