Autoware をローカル環境でビルドしてインストールする

1. はじめに

Autoware は、Free/Libre and Open Source Software (FLOSS) の自動運転車ソフトウェアスタックであり、自動運転技術の研究開発と実装を加速させることを目的としています。Robot Operating System (ROS) を基盤として構築されており、センサーの統合、周囲環境の認識、局所的な経路計画、車両制御など、自動運転に必要な主要な機能を包括的に提供します。Autoware は、産業界や学術界で広く採用されており、リアルタイムでの運用能力や、様々な車両やセンサー構成に柔軟に対応できる設計が特徴です。また、現在は TIER IV と自動運転車の開発を進める研究者や技術者が中心となって、継続的な改良と拡張が行われています。

• Official Home Page：https://autoware.org/
• Official Docs：https://autowarefoundation.github.io/autoware-documentation/main/
• Official GitHub Repository：https://github.com/autowarefoundation/autoware

Autoware には、様々なディストリビューション ¹ が存在しています。Autoware.AI は 2015 年にリリースされた最初のディストリビューションであり、その後、多くの機能が追加されました。しかし、アーキテクチャの統一性やコードの品質には問題が残っていました。2019 年には、ROS 2 の登場に伴い、Autoware.Auto が開発され、システム設計や開発プロセスが全面的に見直されました。しかし、これによりコードの統合要求が厳格化され、開発の柔軟性や速度に影響が出ました。2022 年からは、これらの課題を解決するために新たなコンセプトである Autoware Core/Universe が提案され、Autoware は 2 つの異なる基準で管理される新しい方向へと進化しています。

• Autoware.AI：https://github.com/Autoware-AI
• Autoware.Auto：https://autowarefoundation.gitlab.io/autoware.auto/AutowareAuto/
• Autoware Core：https://github.com/autowarefoundation/autoware.core
• Autoware Universe：https://github.com/autowarefoundation/autoware.universe

Autoware をローカル環境にインストールする方法は 2 つあります。1 つ目は、公開されている Docker Image を Pull してローカル環境に展開する方法 ² です。2 つ目は、ソースコードをビルドしてインストールする方法です ³ です。本記事では、2 つ目のソースコードをビルドしてインストールする方法について記述します。

本記事では、Proxmox 上に以下のスペックの VM 作成し、Autoware をインストールします。

2. パッケージをインストールする

まず初めに、Git をインストールし、GitHub で公開されている Autoware のリポジトリをローカル環境にクローンします。次に、Autoware のリポジトリ内に含まれる Ansible スクリプトを実行し、ROS 2 や Nvidia CUDA などのパッケージをインストールします。

1
$ sudo apt update
2
$ sudo apt -y install git
3
$ git clone https://github.com/autowarefoundation/autoware.git
4
$ cd ~/autoware
5
$ ./setup-dev-env.sh -y

3. ワークスペースを構築する

次に、ワークスペースを構築します。ワークスペースは ROS 2 の概念です。そのため、以下のコマンドで実行されている vcs rosdep colcon は、ROS 2 をインストールする仮定で一緒にインストールされています。これらのコマンドについて詳しく知りたい場合は、ROS 2 の公式ドキュメント ^{4 5} を参照ください。

1
$ cd ~/autoware
2
$ mkdir src
3
$ vcs import src < autoware.repos
4
$ source /opt/ros/humble/setup.bash
5
$ rosdep update
6
$ rosdep install -y --from-paths src --ignore-src --rosdistro $ROS_DISTRO
7
$ colcon build --symlink-install --cmake-args -DCMAKE_BUILD_TYPE=Release

4. 実行動作を確認する

最後に、Autoware が起動するか確認します。Planning Simulation を実行するチュートリアルドキュメント ⁵ を参考に、以下のコマンドを実行します。上記で構築したワークスペースには、マップデータが存在しません。そのため、マップデータをダウンロードする必要があります。ここでは、TIER IV が公開しているマップデータをダウンロードします。また、チュートリアルドキュメントに記載されている通り、$HOME をチルダにするとマップデータのロードに失敗するので注意が必要です。

1
$ gdown -O ~/autoware_map/ 'https://docs.google.com/uc?export=download&id=1499_nsbUbIeturZaDj7jhUownh5fvXHd'
2
$ unzip -d ~/autoware_map ~/autoware_map/sample-map-planning.zip
3
$ source ~/autoware/install/setup.bash
4
$ ros2 launch autoware_launch planning_simulator.launch.xml \
5
    map_path:=$HOME/autoware_map/sample-map-planning\
6
    vehicle_model:=sample_vehicle \
7
    sensor_model:=sample_sensor_kit

ROS 2 のインストールと Autoware ワークスペースの構築が正常に完了していれば、可視化ツールである Rviz が起動するはずです。Rviz 内で 2D Pose Estimate と 2D Goal Pose を設定し、OperationMode を AUTO にすることにより、自動運転のシミュレーションが実行されます。これにより、Autoware のインストール作業が完了します。

5. おわりに

ここまで、Autoware をローカル環境にソースコードからインストールする方法について記述してきました。経験上、Node や Topic といった ROS 2 の基本概念やコマンドを知っておくと沼にハマるリスクを減らせると思います。そのため、ROS 2 が提供しているチュートリアル ⁶ を、手元で動かしてみることをオススメします。