ApolloAuto · startcode · Jun 8, 2018 · Jun 7, 2018 · Jun 7, 2018 · Jun 7, 2018
diff --git a/README.md b/README.md
@@ -1,138 +1,214 @@
-# Apollo
-
-[![Build Status](https://travis-ci.org/ApolloAuto/apollo.svg?branch=master)](https://travis-ci.org/ApolloAuto/apollo) [![Simulation Status](https://azure.apollo.auto/dailybuildstatus.svg)](https://azure.apollo.auto/dailybuild)
-
-```
-We choose to go to the moon in this decade and do the other things,
-not because they are easy, but because they are hard.
--- John F. Kennedy, 1962
-```
-
-Welcome to the Apollo GitHub.
-
-[Apollo](http://apollo.auto) is an open autonomous driving platform. It is a high performance flexible architecture which supports fully autonomous driving capabilities.
-For business contact, please visit http://apollo.auto
-
-**Apollo Team now proudly presents to you the latest [version 2.5](https://github.com/ApolloAuto/apollo/releases/tag/v2.5.0).**
-
-## Installation
-
-We strongly recommend building Apollo in our pre-specified Docker environment.
-See the following instructions on how to set up the docker environment and build from source.
-The steps are:
- - Run a machine that runs linux (tested on Ubuntu 16.04 with and without an nVidia GPU)
- - Create a docker environment
- - Build Apollo from source
- - Bootstrap start Apollo
- - Download the demonstration loop and run it
- - Start a browser session and see the Dreamview user interface
-
-More instructions are below
-
-### The docker environment can be set by the commands below.
-
-First, you need to [install docker-ce properly](https://github.com/ApolloAuto/apollo/blob/master/docker/scripts/README.md#install-docker).
-The following scripts will get you into the container
-
-```
-docker ps  # to verify docker works without sudo
-bash docker/scripts/dev_start.sh
-# if in China, you had better use:bash docker/scripts/dev_start.sh -C to download from the server of docker in china.
-bash docker/scripts/dev_into.sh
-
-```
-
-### To build from source
-First check and make sure you are in development docker container before you proceed. Now you will need to build from the source. If you want to run the entire system, make sure you have an
-nVidia GPU and that you have installed the Linux nVidia drivers.
-
-```
-# To get a list of build commands
-./apollo.sh
-# To make sure you start clean
-./apollo.sh clean
-# This will build the full system and requires that you have an nVidia GPU with nVidia drivers loaded
-bash apollo.sh build
-```
-
-If you do not have an nVidia GPU, the system will run but with the CUDA-based perception and other modules. You must
-specify either `dbg` for debug mode or `opt` for optimized code
-
-```
-./apollo.sh build_no_perception dbg
-```
-
-If you make modifications to the Dreamview frontend, then you must run `./apollo.sh build_fe`  before you run the
-full build.
-
-If the computer is very slow, you can enter the following command to limit the CPU.
-
-```
-bash apollo.sh build --local_resources 2048,1.0,1.0
-```
-
-
-## Run Apollo
-
-Follow the steps below to launch Apollo. Note that you must build the system first before you run it. Note that the
-bootstrap.sh will actually succeed but the user interface will not come up if you skip the build step.
-
-### Start Apollo
-
-Running Apollo will start the ROS core and then startup a web user interface called Dreamview, this is handled by
-the bootstrap script, so from within the docker container, you should run:
-
-```
-# start module monitor
-bash scripts/bootstrap.sh
-```
-
-### Access Dreamview
-Access Dreamview by opening your favorite browser, e.g. Chrome, go to http://localhost:8888 and you should see this screen
-However, there will be nothing running in the system.
-
-![Access Dreamview](docs/demo_guide/images/apollo_bootstrap_screen.png)
-
-### Select Drive Mode
-From the dropdown box selet "Navigation" mode.
-
-![Navigation Mode](docs/demo_guide/images/dreamview_2_5_setup_profile.png)
-
-
-### Replay demo rosbag
-
-To see if the system works, use the demo 'bag' which feeds the system.
-
-```
-# get rosbag note that the command download is required
-python ./docs/demo_guide/rosbag_helper.py demo_2.5.bag
-
-# You can now replay this demo "bag" in a loop with the '-l' flag
-rosbag play -l demo_2.5.bag
-```
-
-Dreamview should show a running vehicle now. (The following image might be different due to changes in frontend.)
-
-![Dreamview with Trajectory](docs/demo_guide/images/dv_trajectory_2.5.png)
-
-## Documents
-
-Apollo documents can be found under the [docs](https://github.com/ApolloAuto/apollo/blob/master/docs/) repository.
-   * [quickstart](https://github.com/ApolloAuto/apollo/blob/master/docs/quickstart/): the quickstart tutorial.
-   * [demo_guide](https://github.com/ApolloAuto/apollo/blob/master/docs/demo_guide/): the guide for demonstration.
-   * [![Apollo Offline Demo](https://img.youtube.com/vi/Q4BawiLWl8c/0.jpg)](https://www.youtube.com/watch?v=Q4BawiLWl8c)
-   * [how to contribute code](https://github.com/ApolloAuto/apollo/blob/master/CONTRIBUTING.md): the guide for contributing code to Apollo.
-   * [howto](https://github.com/ApolloAuto/apollo/blob/master/docs/howto/): tutorials on how to build, run and modify codes.
-   * [specs](https://github.com/ApolloAuto/apollo/blob/master/docs/specs/): Specification documents of Apollo.
-   * [Doxygen APIs](https://apolloauto.github.io/doxygen/apollo/): Apollo Doxygen pages
-
-## Ask Questions
-
-You are welcome to submit questions and bug reports as [Github Issues](https://github.com/ApolloAuto/apollo/issues).
-
-## Copyright and License
-
-Apollo is provided under the [Apache-2.0 license](LICENSE).
-
-## Disclaimer
-Please refer the Disclaimer of Apollo in [Apollo official website](http://apollo.auto/docs/disclaimer.html).
+![image alt text](docs/demo_guide/images/Apollo_logo.png)
+
+[![Build Status](https://travis-ci.org/ApolloAuto/apollo.svg?branch=master)](https://travis-ci.org/ApolloAuto/apollo) [![Simulation Status](https://azure.apollo.auto/dailybuildstatus.svg)](https://azure.apollo.auto/dailybuild)
+
+```
+
+We choose to go to the moon in this decade and do the other things,
+
+not because they are easy, but because they are hard.
+
+-- John F. Kennedy, 1962
+
+```
+
+Welcome to Apollo's GitHub page!
+
+[Apollo](http://apollo.auto) is a high performance, flexible architecture which accelerates the development, testing, and deployment of Autonomous Vehicles.
+
+For business and partnership, please visit [our website](http://apollo.auto).
+
+## Getting Started
+
+**The Apollo Team now proudly presents to you the latest [version 2.5](https://github.com/ApolloAuto/apollo/releases/tag/v2.5.0).**
+
+
+ Apollo 2.5 is loaded with new modules and features, but needs to be callibrated and configured perfectly before you take it for a spin. Please review the prerequisites and installation steps in detail to ensure that you are well equipped to build and launch Apollo. You could also check out Apollo's architecture overview for a greater understanding on Apollo's core technology and platform. 
+
+[Want to contribute to our code?](https://github.com/ApolloAuto/apollo/blob/master/CONTRIBUTING.md) follow this guide.
+
+## Prerequisites
+
+#### Basic Requirements:
+
+* Vehicle equipped with by-wire system, including but not limited to brake by-wire, steering by-wire, throttle by-wire and shift by-wire (Apollo is currently tested on Lincoln MKZ)
+
+* A machine with a 4-core processor and 6GB memory minimum
+
+* Ubuntu 14.0.4
+
+* Working knowledge of Docker
+
+~~~ 
+ - Please note, it is recommended that you install the versions of Apollo in the following order: 
+ 1.0 > 1.5 > 2.0 > 2.5
+ The reason behind this recommendation is that you need to confirm whether individual hardware components 
+ and modules are functioning correctly and clear various version test cases,
+ before progressing to a higher more capable version for your safety and the safety of those around you.
+
+ - Please note, if you do not have a vehicle, proceed to the Installation - without hardware 
+~~~
+
+#### Individual Version Requirements:
+
+The following diagram highlights the scope and features of each Apollo release:
+
+![image alt text](docs/demo_guide/images/Apollo_versions.png)
+
+[**Apollo 1.0:**](https://github.com/ApolloAuto/apollo/blob/master/docs/quickstart/apollo_1_0_hardware_system_installation_guide.md) 
+
+Apollo 1.0 also referred to as the Automatic GPS Waypoint Following, works in an enclosed venue such as a test track or parking lot. This installation is necessary to ensure that Apollo works perfectly with your vehicle. The diagram below lists the various modules in Apollo 1.0.
+
+![image alt text](docs/demo_guide/images/Apollo_1.png)
+
+**For Setup:**
+
+* **Hardware**:
+
+    * Industrial PC (IPC)
+
+    * Global Positioning System (GPS)
+
+    * Inertial Measurement Unit (IMU)
+
+    * Controller Area Network (CAN) card
+
+    * Hard drive
+
+    * GPS Antenna
+
+    * GPS Receiver
+
+* **Software**:
+
+    * Apollo Linux Kernel (based on Linux Kernel 4.4.32)
+
+[**Apollo 1.5:**](https://github.com/ApolloAuto/apollo/blob/master/docs/quickstart/apollo_1_5_hardware_system_installation_guide.md) 
+
+Apollo 1.5 is meant for fixed lane cruising. With the addition of LiDAR, vehicles with this version now have better perception of its surroundings and can better map its current position and plan its trajectory for safer maneuvering on its lane. Please note, the modules highlighted in Yellow are additions or upgrades for version 1.5.
+
+![image alt text](docs/demo_guide/images/Apollo_1_5.png)	
+
+**For Setup:**
+
+* All the requirements mentioned in version 1.0
+
+* **Hardware**:
+
+    * Light Detection and Ranging System (LiDAR)
+
+    * ASUS GTX1080 GPU-A8G- Gaming GPU Card
+
+* **Software**:
+
+    * Nvidia GPU Driver
+
+[**Apollo 2.0:**](https://github.com/ApolloAuto/apollo/blob/master/docs/quickstart/apollo_2_0_hardware_system_installation_guide_v1.md#key-hardware-components)
+
+Apollo 2.0 supports vehicles autonomously driving on simple urban roads. Vehicles are able to cruise on roads safely, avoid collisions with obstacles, stop at traffic lights and change lanes if needed to reach their destination.  Please note, the modules highlighted in Red are additions or upgrades for version 2.0.
+
+![image alt text](docs/demo_guide/images/Apollo_2.png)
+
+**For Setup:**
+
+* All the requirements mentioned in versions 1.5 and 1.0
+
+* **Hardware**:
+
+    * Traffic Light Detection using Camera
+
+    * Ranging System (LiDAR)
+
+    * Radar
+
+* **Software**:
+
+    * Same as 1.5
+
+[**Apollo 2.5:**](https://github.com/ApolloAuto/apollo/blob/master/docs/quickstart/apollo_2_5_hardware_system_installation_guide_v1.md)
+
+Apollo 2.5 allows the vehicle to autonomously run on geo-fenced highways with a camera for obstacle detection. Vehicles are able maintain lane control, cruise and avoid collisions with vehicles ahead of them. 
+
+```
+Please note, if you need to test Apollo 2.5; for safety purposes, please seek the help of the
+Apollo Engineering team. Your safety is our #1 priority,
+and we want to ensure Apollo 2.5 was integrated correctly with your vehicle before you hit the road. 
+```
+
+![image alt text](docs/demo_guide/images/Apollo_2_5.png)
+
+**For Setup:**
+
+* All the requirements mentioned in 2.0
+
+* Hardware:
+
+    * Additional Camera
+
+* Software: 
+
+    * Same as 2.0 
+
+## Architecture
+
+* **Hardware/ Vehicle Overview**
+
+![image alt text](docs/demo_guide/images/Hardware_overview.png)
+
+* **Hardware Connection Overview**
+
+![image alt text](docs/demo_guide/images/Hardware_connection.png)
+
+* **Software Overview - Navigation Mode**
+
+![image alt text](docs/demo_guide/images/Software_Overview.png)
+
+## Installation
+
+### With Hardware:
+
+* [Fork and then Clone Apollo's GitHub code](https://github.com/ApolloAuto/apollo) 
+
+* [Build and Release using Docker](https://github.com/ApolloAuto/apollo/blob/master/docs/howto/how_to_build_and_release.md) - This step is required
+
+* [Launch and Run Apollo](https://github.com/ApolloAuto/apollo/blob/master/docs/howto/howto_launch_Apollo.md)
+* [Apollo 1.0 QuickStart Guide](https://github.com/ApolloAuto/apollo/blob/master/docs/quickstart/apollo_1_0_quick_start.md)
+
+* [Apollo 1.5 QuickStart Guide](https://github.com/ApolloAuto/apollo/blob/master/docs/quickstart/apollo_1_5_quick_start.md)
+
+* [Apollo 2.0 QuickStart Guide](https://github.com/ApolloAuto/apollo/blob/master/docs/quickstart/apollo_2_0_quick_start.md)
+
+* [Apollo 2.5 QuickStart Guide](https://github.com/ApolloAuto/apollo/blob/master/docs/quickstart/apollo_2_5_quick_start.md)
+
+### Without Hardware:
+
+* [How to Build Apollo ](https://github.com/ApolloAuto/apollo/tree/master/docs/demo_guide)
+
+## Documents
+
+* [HowTo](https://github.com/ApolloAuto/apollo/tree/master/docs/howto): A Brief technical solutions to common problems developers face during the installation and use of Apollo platform 
+
+* [Specs](https://github.com/ApolloAuto/apollo/tree/master/docs/specs): A Deep dive into Apollo's Hardware and Software specifications (only recommended for expert level developers that have successfully installed and launched Apollo) 
+
+* [FAQs](https://github.com/ApolloAuto/apollo/tree/master/docs/FAQs) 
+
+## Questions
+
+You are welcome to submit questions and bug reports as [GitHub Issues](https://github.com/ApolloAuto/apollo/issues).
+
+## Copyright and License
+
+Apollo is provided under the [Apache-2.0 license](https://github.com/natashadsouza/apollo/blob/master/LICENSE).
+
+## Disclaimer
+
+Please refer the Disclaimer of Apollo in [Apollo's official website](http://apollo.auto/docs/disclaimer.html).
+
+## Connect with us 
+* [Have suggestions for our GitHub page?](https://github.com/ApolloAuto/apollo/issues)
+* [Twitter](https://twitter.com/apolloplatform)
+* [YouTube](https://www.youtube.com/channel/UC8wR_NX_NShUTSSqIaEUY9Q)
+* [Blog](www.medium.com/apollo-auto)
+* [Newsletter](http://eepurl.com/c-mLSz)
+
+
diff --git a/docs/demo_guide/images/.DS_Store b/docs/demo_guide/images/.DS_Store
diff --git a/docs/demo_guide/images/Apollo_1.png b/docs/demo_guide/images/Apollo_1.png
diff --git a/docs/demo_guide/images/Apollo_1_5.png b/docs/demo_guide/images/Apollo_1_5.png
diff --git a/docs/demo_guide/images/Apollo_2.png b/docs/demo_guide/images/Apollo_2.png
diff --git a/docs/demo_guide/images/Apollo_2_5.png b/docs/demo_guide/images/Apollo_2_5.png
diff --git a/docs/demo_guide/images/Apollo_logo.png b/docs/demo_guide/images/Apollo_logo.png
diff --git a/docs/demo_guide/images/Apollo_versions.png b/docs/demo_guide/images/Apollo_versions.png
diff --git a/docs/demo_guide/images/Hardware_connection.png b/docs/demo_guide/images/Hardware_connection.png
diff --git a/docs/demo_guide/images/Hardware_overview.png b/docs/demo_guide/images/Hardware_overview.png
diff --git a/docs/demo_guide/images/Software_Overview.png b/docs/demo_guide/images/Software_Overview.png