Skip to content
This repository has been archived by the owner on Aug 12, 2024. It is now read-only.

Latest commit

 

History

History
216 lines (154 loc) · 5.38 KB

Example Setup for CSIE5317 Course (2021 Fall).md

File metadata and controls

216 lines (154 loc) · 5.38 KB
Raw

Example Setup for CSIE5317 Course (2021 Fall)

TA: Jerry (jerry73204@gmail.com)

Changelog

  • 2021/11/04 Announce this article
  • 2021/11/06 Change .aderc
  • 2021/11/07 Fix typo in lgsvl_msgs section and non-reproducible .aderc

Prerequisites

sudo apt update
sudo apt-get install \
    ca-certificates \
    curl \
    gnupg \
    lsb-release \
    git

Docker-ce Setup

# Import GPG key
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# Install docker-ce
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io

Add your account to the docker group, and reboot to take effect.

usermod -a -G docker $USER
# reboot your PC/laptop

ROS 2 Setup

Version: ROS 2 foxy

# Install GPG key
sudo apt update && sudo apt install curl gnupg2 lsb-release
sudo curl -sSL https://raw.githubusercontent.com/ros/rosdistro/master/ros.key  -o /usr/share/keyrings/ros-archive-keyring.gpg

#  Add the repository to source list
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/ros-archive-keyring.gpg] http://packages.ros.org/ros2/ubuntu $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/ros2.list > /dev/null

# Install ROS 2
sudo apt update
sudo apt install ros-foxy-desktop

LGSVL Simulator Setup

Version: 2021.3

Visit the official site (https://www.svlsimulator.com/) and download the version 2021.3. The downloaded zip file name will be svlsimulator-linux64-2021.3.zip. Unzip the file to home directory.

cd ~
unzip ~/Downloads/svlsimulator-linux64-2021.3.zip

ADE Setup

Version: 4.3.0

Install the ade binary at ~/.local/bin

mkdir -p ~/.local/bin && cd ~/.local/bin
wget https://gitlab.com/ApexAI/ade-cli/-/jobs/1341322851/artifacts/raw/dist/ade+x86_64
mv ade+x86_64 ade
chmod +x ade

Add ~/.local/bin to your PATH so that you can run ade command everywhere.

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
exec $0  # restart bash

Check that the versoin is correct.

ade --version
4.3.0

Autoware.Auto Setup

Version: release-1.0.0

Download Autoware.Auto repository

# Create workspace for ADE
mkdir -p ~/adehome &&cd ~/adehome
touch .adehome

# Download Autoware.Auto source code and check out to version 1.0.0
git clone https://gitlab.com/autowarefoundation/autoware.auto/AutowareAuto.git
cd AutowareAuto
git checkout tags/1.0.0 -b release-1.0.0

Enter ADE container (changed at 2021-11-07)

To enable GPU support, create the file ~/adehome/.aderc with the content below. You may ignore this step if GPU support is not needed.

export ADE_DOCKER_RUN_ARGS="--cap-add=SYS_PTRACE --net=host --privileged --add-host ade:127.0.0.1 -e RMW_IMPLEMENTATION=rmw_cyclonedds_cpp --gpus all -ti --rm -e DISPLAY -v /tmp/.X11-unix:/tmp/.X11-unix \
-e NVIDIA_VISIBLE_DEVICES=all \
-e NVIDIA_DRIVER_CAPABILITIES=compute,utility,display"
export ADE_GITLAB=gitlab.com
export ADE_REGISTRY=registry.gitlab.com
export ADE_DISABLE_NVIDIA_DOCKER=false
export ADE_IMAGES="
  registry.gitlab.com/autowarefoundation/autoware.auto/autowareauto/amd64/ade-foxy:1.0.0
  registry.gitlab.com/autowarefoundation/autoware.auto/autowareauto/amd64/binary-foxy:1.0.0
  registry.gitlab.com/autowarefoundation/autoware.auto/ade-lgsvl/foxy:2021.3
  nvidia/cuda:11.0-base
"

Start the container.

cd ~/adehome
ade start -- -p 127.0.0.1:9090:9090

If you encouter an error like this, you can either follow the instructions to force restarting or ignore the error.

ERROR: ade is already running. Use ade enter to enter or ade start -f to restart.

After the container is started, run this command to enter the continer environment. You can open multiple terminals and enter the container this way.

ade enter

Download lgsvl_msgs and ros2-lgsvl-bridge

In this section, we're going to configure and build the Autoware.Auto within the container.

Prepare the folder.

# enter ADE container
mkdir -p ~/AutowareAuto/src/external
cd ~/Autoware
vcs import < autoware.auto.$ROS_DISTRO.repos

Download lgsvl_msgs and check out to specified version. (changed 2021-11-07)

cd ~/AutowareAuto/src/external
git clone https://github.com/lgsvl/lgsvl_msgs.git
cd lgsvl_msgs
git checkout 0.0.4

Download ros2-lgsvl-bridge and check out to specified version.

cd ~/AutowareAuto/src/external
git clone https://github.com/lgsvl/ros2-lgsvl-bridge.git
cd ros2-lgsvl-bridge
git checkout 0.2.1

Build Autoware.Auto

# inside the ADE container
cd ~/AutowareAuto
colcon build --cmake-args '-DCMAKE_BUILD_TYPE=Release'

Start the Development Environment

There are two steps to go.

  • Start the simulator on host system (without entering the ADE environment).
  • Run the lgsvl_bridge within the ADE container.
# On host system, OUTSIDE pf the ADE container
source ~/svlsimulator-linux64-2021.3
./simulator

# inside the ADE container
source ~/AutowareAuto/install/setup.bash
lgsvl_bridge