Skip to content

Latest commit

 

History

History
79 lines (48 loc) · 3.51 KB

apollo_software_installation_guide.md

File metadata and controls

79 lines (48 loc) · 3.51 KB

Software Overview of Apollo

Apollo has been initiated to provide an open, comprehensive, and reliable software platform for its partners in the automotive and autonomous-driving industries. Partners can use the Apollo software platform and the reference hardware that Apollo has certified as a template to customize in the development of their own autonomous vehicles.

Apollo Software Installation

This section includes:

Before getting started, please make sure you have installed Ubuntu Linux 14.04.3 and the Apollo Kernel following the steps in the Apollo core Software Installation Guide.

Download Apollo Source

  1. Download Apollo source code from the github source and check out the correct branch:

    git clone git@github.com:ApolloAuto/apollo.git
cd apollo
git checkout [release_branch_name]

  2. Set up environment variable APOLLO_HOME by the following command:

    echo "export APOLLO_HOME=$(pwd)" >> ~/.bashrc && source ~/.bashrc

  3. Open a new terminal or run source ~/.bashrc in an existing terminal.

tip In the following sections, it is assumed that the Apollo directory is located in $APOLLO_HOME.

Set Up the Docker Environment

The Docker container is the simplest way to set up the build environment for Apollo.

For more information, see the detailed Docker tutorial here.

  1. If you are working on Ubuntu 16.04+, the easiest way is to leverage the modern snap package manager which is available out of the box:
sudo snap install docker

Otherwise, please follow the official guide to install the docker-ce.

Don't forget the post-installation steps for Linux.

  1. After the installation, log out and then log back into the system to enable Docker.

  2. (Optional) If you already have Docker installed (before you installed the Apollo Kernel), add the following line in /etc/default/docker:

    DOCKER_OPTS = "-s overlay"

We encourage you to continue the Build process using Build the Dev docker environment if you have not already set it up.

Support a new Vehicle in DreamView

In order to support a new vehicle in DreamView, please follow the steps below:

  1. Create a new folder for your vehicle under modules/calibration/data

  2. There is already a sample file in the modules/calibration/data folder named mkz_example. Refer to this structure and include all necessary configuration files in the same file structure as “mkz_example”. Remember to update the configuration files with your own parameters if needed.

  3. Restart DreamView and you will be able to see your new vehicle (name is the same as your newly created folder) in the selected vehicle.

Run Apollo in Ubuntu 16

Please refer to How to run Apollo with Ubuntu 16