WWW-POSIM v0.6.16シミュレーターのドキュメント
ドキュメントメニュー
WWW-POSIM / シミュレーターのドキュメント

ROSターミナルと接続

www_posim_rosパッケージは、手元のROS環境を実行中のWWW-POSIMワークスペースに接続します。コネクターは認証済みのテレメトリを受信し、ローカルのROSドメインに標準のROS 2メッセージをパブリッシュします。ROSツールの使用中はコネクターを起動したままにしてください。

WWW-POSIMワークスペース
Gazeboセンサー
→ HTTPS / WebSocket →www_posim_ros
コネクター
→ ローカルROS 2 →ros2 topic · RViz
Pythonプログラム

インストール版のROSターミナル

ワールドを開始してから、アプリのROSターミナルを開く操作を選びます。作業フォルダー(初期値はDocuments/WWW-POSIM)が開き、アプリのROS環境が準備されます。アプリから開いた複数のターミナルは、1つのローカルコネクターを共有します。

macOSでは、WWW-POSIMのヘッダー、準備状況、接続の経過時間が表示されます。ROS connectedとROS・Python・コネクターのバージョンが出るまで待ちます。色付きのWWW-POSIMプロンプトが、準備済みの環境を示します。

VS Codeで開く操作では、同じフォルダーとros_vehicle_command.pyが開き、ROSターミナルも準備されます。制御プログラムの実行方法はインストール版のワークスペースを制御をご覧ください。RVizを開く操作では、インストール済みのビューアーが起動します。

Autopilotモードでは、ROSツールはテレメトリーのみを提供します。ros_vehicle_command.pyにはROS 2直接制御が必要です。モードを変更するには機体をディスアームし、ワークスペース設定で準備済みの地形を再利用して、ROS 2直接制御を選びワールドを再起動します。再起動するとシミュレーションが初期化されます。保存済み機体の制御モードはその版に固定されます。変更するには標準機体を使うか、保存済み機体のコピーを編集してください。

インストール済みアプリのROS 2直接制御パネルには、ROSターミナルを開くとVS Codeで開くもあります。どちらもアプリで選択した作業フォルダーを使います。ウェブサイトを使う場合やローカル起動機能が利用できない場合は、ROSターミナル・VS Codeガイドを選んでください。ガイドは別ウィンドウで開きます。

ROS環境をWebワークスペースに接続する

Webサイトで自分のワールドを開始します。ROSのインストールガイドに従い、ROS 2 Lyricalと標準メッセージパッケージを用意します。UbuntuまたはWSLのターミナルでROSを読み込み、コネクターをインストールします。

source /opt/ros/lyrical/setup.bash
sudo apt install ros-lyrical-rmw-cyclonedds-cpp
python3 -m venv --system-site-packages .venv-ros
source .venv-ros/bin/activate
python -m pip install https://github.com/IOES-Lab/homebrew-www-posim/releases/download/v0.6.16/www_posim_ros-0.4.3-py3-none-any.whl
export RMW_IMPLEMENTATION=rmw_cyclonedds_cpp
export ROS_DOMAIN_ID=76
export ROS_AUTOMATIC_DISCOVERY_RANGE=LOCALHOST
www-posim-connect --server https://www-posim.vercel.app/api --email YOU@example.com

求められたらパスワードを入力し、ターミナルを開いたままにします。別のターミナルでも同じROS設定と仮想環境を読み込み、同じ3つの環境変数を設定してください。Pythonの仮想環境だけではROSやrclpyは利用できません。

Macアプリに付属する環境では、ROSを読み込むコマンドを次に置き換えます。

eval "$(/Applications/WWW-POSIM.app/Contents/MacOS/WWW-POSIM --ros-env)"

ROS環境をインストール版に接続する

アプリとワールドを起動します。準備したROS環境で、Webサイトへの接続コマンドの代わりに次を実行します。

www-posim-connect --local --server http://127.0.0.1:3300/api

アプリの実行中のセッションを使用するため、Webサイトのログイン情報は不要です。1つのROSドメインで使うコネクターは1つにしてください。同じドメインでアプリ管理のコネクターを重ねて起動しないでください。別のWSLディストリビューションからWindowsアプリのループバックアドレスに接続できない場合は、アプリからROSターミナルを開きます。

トピックとデータの流れを確認する

コネクターの準備完了後に実行します。

ros2 topic list
ros2 topic echo /model/wamv/odometry

メッセージが継続して届き、タイムスタンプが進むことを確認します。Ctrl+Cで表示を終了できます。BlueROV2では、一覧から対応するオドメトリトピックを選びます。トピック名が一覧にあるだけでは、データの受信は確認できません。

データが届かない場合は、ワールドが実行中で、両方のターミナルが同じROS環境とドメインを使っているか確認してください。ROSのトラブルシューティング、Webワークスペースを制御、インストール版のワークスペースを制御も参照できます。

ドキュメントを検索