An open autonomous driving platform
Branch: simulator
Clone or download
Pull request Compare This branch is 7067 commits ahead, 10626 commits behind ApolloAuto:master.
Latest commit 7e4d637 Feb 7, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/ISSUE_TEMPLATE New issue template Aug 16, 2018
.vscode docs: add remote debugging contents in how_build_and_debug_appollo_in… Apr 9, 2018
docker Added empy installation to dockerfile Feb 6, 2019
docs Added copyright to boilerplates. Oct 19, 2018
modules Update map Feb 7, 2019
ros_pkgs use latest rosbridge submodule Jan 18, 2019
scripts add script to create one combined point cloud from rosbag Feb 2, 2019
third_party Build: fix glog and gflags multiple verison issue. Sep 8, 2018
tools Adding protobuf-aware fuzzing support (ApolloAuto#5223) Aug 14, 2018
.clang-format Updated clang-format Apr 11, 2018
.gitignore removed /modules/map/data from .gitignore Oct 19, 2018
.gitmodules add lgsvl_msgs submodule Jan 10, 2019
.travis.yml Build: fix glog and gflags multiple verison issue. Sep 8, 2018
AUTHORS.md Update AUTHORS.md Aug 15, 2018
Apollo_README.md Added README Oct 19, 2018
BUILD build: use a general USE_GPU compile flag Jul 28, 2018
CONTRIBUTING.md grammar+typos Aug 7, 2018
CPPLINT.cfg Apollo 1.0.0 release Jul 4, 2017
LICENSE Apollo 1.0.0 release Jul 4, 2017
README.md Updated README Oct 19, 2018
README_cn.md README: updated travis-ci Aug 13, 2018
RELEASE.md release.md changes Aug 6, 2018
WORKSPACE.in Build: fix glog and gflags multiple verison issue. Sep 8, 2018
apollo.doxygen Doxygen: added README as front page Jan 12, 2018
apollo.sh Modified CAN card driver version in apollo.sh Dec 21, 2018
apollo_docker.sh Build: fix glog and gflags multiple verison issue. Sep 8, 2018

README.md

LG Silicon Valley Lab Apollo Fork

This repository is a fork of Apollo maintained by the LG Electronics Silicon Valley Lab which has modified and configured to facilitate use with LG's Automotive Simulator.

The software and source code in this repository are intended only for use with LG Automotive Simulator and should not be used in a real vehicle.

Table of Contents

  1. Getting Started
  2. Prerequisites
  3. Setup
  4. Launching Apollo Alongside the Simulator

Getting Started

The guide outlines the steps required to setup Apollo for use with the LG Automotive Simulator. If you have not already set up the simulator, please do so first by following the instructions here.

Prerequisites

  • Linux operating system (preferably Ubuntu 14.04 or later)
  • Nvidia graphics card (required for Perception)
    • Nvidia proprietary driver must be installed
    • The current version of Apollo does not support Volta and Turing architectures (this includes Titan V and RTX 2080 GPUs).

Setup

Docker

Apollo is designed to run out of docker containers. The image will mount this repository as a volume so the image will not need to be rebuilt each time a modification is made.

Installing Docker CE

To install Docker CE please refer to the official documentation. We also suggest following through with the post installation steps.

Installing Nvidia Docker

Before installing nvidia-docker make sure that you have an appropriate Nvidia driver installed. To test if nvidia drivers are properly installed enter nvidia-smi in a terminal. If the drivers are installed properly an output similar to the following should appear.

    +-----------------------------------------------------------------------------+
    | NVIDIA-SMI 390.87                 Driver Version: 390.87                    |
    |-------------------------------+----------------------+----------------------+
    | GPU  Name        Persistence-M| Bus-Id        Disp.A | Volatile Uncorr. ECC |
    | Fan  Temp  Perf  Pwr:Usage/Cap|         Memory-Usage | GPU-Util  Compute M. |
    |===============================+======================+======================|
    |   0  GeForce GTX 108...  Off  | 00000000:65:00.0  On |                  N/A |
    |  0%   59C    P5    22W / 250W |   1490MiB / 11175MiB |      4%      Default |
    +-------------------------------+----------------------+----------------------+
                                                                                
    +-----------------------------------------------------------------------------+
    | Processes:                                                       GPU Memory |
    |  GPU       PID   Type   Process name                             Usage      |
    |=============================================================================|
    |    0      1187      G   /usr/lib/xorg/Xorg                           863MiB |
    |    0      3816      G   /usr/bin/gnome-shell                         305MiB |
    |    0      4161      G   ...-token=7171B24E50C2F2C595566F55F1E4D257    68MiB |
    |    0      4480      G   ...quest-channel-token=3330599186510203656   147MiB |
    |    0     17936      G   ...-token=5299D28BAAD9F3087B25687A764851BB   103MiB |
    +-----------------------------------------------------------------------------+

The installation steps for nvidia-docker are available at the official repo.

Pulling LGSVL Docker image

LGSVL maintains a docker image to be used alongside this repository. The docker image is available here.

To pull the image use the following command:

docker pull lgsvl/apollo

Cloning the Repository

This repository includes a couple of submodules for HD Maps and rosbrige. To make sure that the submodules are also cloned use the following command:

git clone --recurse-submodules git@github.com:lgsvl/apollo.git

Building Apollo and rosbridge

Now everything should be in place to build apollo. Apollo must be built from the container. To launch the container navigate to the directory where the repository was cloned and enter:

./docker/scripts/dev_start.sh

This should launch the container and mount a few volumes. It could take a few minutes to pull the latest volumes on the first run.

To get into the container:

./docker/scripts/dev_into.sh

Build Apollo:

./apollo.sh build_gpu

(optional) to build without gpu:

./apollo.sh build

Now build rosbrige:

cd ros_pkgs
catkin_make

Launching Apollo alongside the simulator

Here we only describe only a simple case of driving from point A to point B using Apollo and the simulator.

To launch apollo, first launch and enter a container as described in the previous steps.

  • To start Apollo:

      ./scripts/bootstrap.sh
    

    Note: you may receive errors about dreamview not being build if you do not run the script from the /apollo directory.

  • Launch rosbridge:

      ./scripts/rosbridge.sh
    
  • Run the LG SVL Simulator (see instructions in the simulator repository)

    • Select the San Francisco map and the XE-Rigged-apollo vehicle.
    • Enable GPS, IMU, LIDAR, HD Mode, and Telephota Camera.
    • (optional) Enable traffic.
  • Open Apollo dreamview in a browser by navigating to: localhost:8888

    • Select the LG SVL 1080 vehicle and San Francisco map in the top right corner.
    • Open the Module Controller tap (on the left bar).
    • Enable Localization, Perception, Planning, Prediction, Routing, and Control.
    • Navigate to the Route Editing tab.
    • Select a destination by clicking on a lane line and clicking Submit Route.
    • Watch the vehicle navigate to the destination.
    • To stop the docker container run the dev_stop.sh script in apollo/docker/scripts in a new terminal (not in the docker container).