ターミナルの準備
ターミナルは、コマンドを入力して実行結果を確認するウィンドウです。このガイドでは、通常のターミナルを2つ開き、シミュレーションを実行する方をターミナルA、センサーデータの確認や操作に使う方をターミナルBと呼びます。AとBは役割を表す名前で、別のアプリではありません。
インストール方法に合った場所で開く
| インストール方法 | ターミナルA・Bの開き方 |
|---|---|
| Ubuntuへのネイティブインストール | Ubuntuの「端末」を2つ開く |
| LinuxのDocker | Linuxのターミナルを2つ開き、両方から同じコンテナに入る |
| WindowsのWSL | Windows Terminalで同じWSLディストリビューションのUbuntuタブを2つ開く |
| WindowsのWSLとDocker | Ubuntuタブを2つ開き、両方から同じコンテナに入る |
| macOSのDockerとRDP | RDPで接続したLinuxデスクトップ内でターミナルを2つ開く |
Linux・WindowsのDocker環境では、ホスト側の各ターミナルで次を実行し、posimコンテナに入ります。
docker exec -it posim bash
macOSで利用するRDPデスクトップは、すでにコンテナ内にあります。ROSのコマンドはそのLinuxターミナルで実行してください。PowerShellやmacOSのターミナルは、コンテナの起動などホスト側の操作に使います。
ワークスペースとは
ROSワークスペースは、ソースコードとビルドしたパッケージをまとめるディレクトリです。src/にソースコード、build/にビルド途中のファイル、install/にROSが読み込むパッケージが入ります。
| インストール方法 | パス |
|---|---|
| Ubuntu・WSLへのネイティブインストール | ~/posim_ws |
| AMD64 Dockerイメージ | /opt/posim_ws |
| ARM64 RDPイメージ | /home/docker/posim_ws |
~はLinuxユーザーのホームディレクトリを表します。以下のPOSIM_WSは、ワークスペースのパスを保持する変数です。
AとBの両方で環境を読み込む
Ubuntu・WSLへのネイティブインストールの場合:
export POSIM_WS="$HOME/posim_ws"
source /opt/ros/lyrical/setup.bash
source "$HOME/.ros_ardusub_env/env"
source "$POSIM_WS/install/setup.bash"
cd "$POSIM_WS"
Dockerの場合(RDPデスクトップ内も同じ):
export POSIM_WS="${POSIM_WS:-${POSIM_UNDERLAY:-/home/docker/posim_ws}}"
source /opt/ros/lyrical/setup.bash
source "$POSIM_WS/install/setup.bash"
cd "$POSIM_WS"
sourceは、ROSやPOSIMを見つけるためのパスと設定をターミナルに読み込むコマンドです。新しいターミナルを開くたびに実行してください。
起動前に確認する
ros2 pkg prefix posim_demos
ros2 pkg prefix ros_gz_sim
どちらもワークスペース内のinstall/を指していれば準備完了です。パッケージが見つからない場合はインストール手順を確認してください。ros_gz_simが/opt/ros/lyricalを指す場合、ワークスペース側のパッケージが読み込まれていません。
次は初めてのシミュレーションです。メッセージを出力し続けているコマンドは実行中です。そのターミナルでCtrl+Cを押して停止し、入力待ちの表示に戻ってから次のコマンドを実行します。