An integrated framework for autonomous driving: object detection, lane detection, and free space detection.

@This is the implementation of "An integrated framework for autonomous driving: object detection, lane detection, and free space detection", Narsimlu Kemsaram, Anweshan Das, Gijs Dubbelman.

• Prerequisites
• Building on Linux Desktop or Linux x86/x64 Only
• Cross Compiling for the NVIDIA DRIVE Platform
• Loading the Sample on the NVIDIA DRIVE Platform
• Compiling on the Device

## Prerequisites

Basic Hardware Requirements

• NVIDIA DRIVE^™ PX 2 platform with the latest PDK flashed in the system.
• Desktop PC running Linux x86/x64

Linux System Requirements

These are the basic prerequisites for Linux:

• Ubuntu Linux 16.04 or 14.04 (out of the box installation)

• GCC >= 4.8.X && GCC <= 4.9.x (for 16.04, use GCC 4.9.3 or greater)

• cmake version >= 3.3

  By default, Ubuntu 14.04 installs cmake version 2.8. For guidance on installing cmake 3.x, see:
  http://askubuntu.com/questions/6102 91/how-to-install-cmake-3-2-on-ubuntu-14-04

• NVIDIA^® CUDA^® Toolkit version 9.0 or later

• NVIDIA DRIVE^™ 5.0 Linux SDK/PDK installation on the Linux Host

• You may also need to install (using apt-get install) the following packages:

   libx11-dev
   libxrandr-dev
   libxcursor-dev
   libxxf86vm-dev
   libxinerama-dev
   libxi-dev
   libglu1-mesa-dev
   libglew-dev
  

Desktop development relies on NVCUVID for video decoding, which is included with the NVIDIA drivers. In general, the cmake build scripts can find NVCUVID installation. However, if this fails, you must set a symbolic link /usr/lib/nvidia-current pointing to your NVIDIA driver lib, for instance to /usr/lib/nvidia-384.

## Building on Linux Desktop or Linux x86/x64 Only

The DriveWorks SDK samples use a standard cmake-based build system. The default approach is to create a build folder for an "out of the source tree build" and to point cmake to build the samples from there.

To build the DriveWorks samples

• On the host system, enter:

  $ mkdir build-host
  $ cd build-host
  $ cmake -DCMAKE_BUILD_TYPE=Release /path/to/driveworks/samples/folder
  $ make -j
  

## Cross-Compiling for the NVIDIA DRIVE Platform

To compile the samples or any user code using DriveWorks, you must use cross-compilation from a Linux host. For this, in addition to the requirements above, you must have the additional components:

• DriveWorks SDK cross-compilation package
• NVIDIA DRIVE SDK/PDK installation for NVIDIA DRIVE PX 2 in the Linux Host
• CUDA cross-compilation libraries.

To cross compile the DriveWorks SDK samples

1. On the host system, install CUDA cross-compilation libraries.

   $ sudo dpkg --add-architecture arm64
   $ sudo apt-get update
   $ sudo apt-get install cuda-cross-aarch64-8-0
   

   @note Some repositories may not have binaries for arm64 and apt-get update causes errors. To prevent these errors, edit /etc/apt/sources.list and files under /etc/apt/sources.list.d/ and add [arch=amd64,i386] into each line starting with deb. Ensure you specify amd64 and not arm64.

2. Configure the location of the NVIDIA DRIVE SDK/PDK.

   Set the environment variable DriveSDK to point to the SDK/PDK folders:

   /path/to/drive-t186ref-linux (NVIDIA DRIVE PX 2)
   

   -or-

   Define this location as a cmake parameter:

   -DVIBRANTE_PDK:STRING=/path/to/drive-t186ref-linux
   

3. Cross-compile.

   $ mkdir build-target
   $ cd build-target
   $ cmake -DCMAKE_BUILD_TYPE=Release \
         -DCMAKE_TOOLCHAIN_FILE=/path/to/samples/cmake/Toolchain-V4L.cmake \
         -DVIBRANTE_PDK:STRING=/path/to/drive-t186ref-linux \
          /path/to/driveworks/samples/folder
   $ make -j
   $ make install
   

   To streamline the deploy process, you can set the cmake definitions as environment variables.

## Loading the Sample on the NVIDIA DRIVE Platform

After cross-compiling your custom DriveWorks sample on the Linux host system, you must load it to the target platform. You can use automatic upload (recommended) or manually upload it.

The package-based installation will install libraries, binaries and resources in /usr/local/driveworks-<version>. However, if you build a custom DriveWorks sample, you should upload those files to a separate directory such as:

/home/nvidia/driveworks

The above path assumes your user name is "nvidia". Of course, you would use a name more appropriate to your situation. Using this path rather than /usr/local/<name> avoids security constraints that can make the upload process more difficult.

@note Important: The correct rpath for the binaries is set only during installation. As such, NVIDIA discourages copying pre-install binaries to the board because this could result in undefined behavior.

Automatic Upload (Recommended)

An upload target is provided as a convenience. Invoking this target uses rsync to sync the builds to a specified location on the device. target is set to depend on building and packaging.

The following cmake parameters configure the upload target:

• VIBRANTE_HOST : IP address of the board, the default value is 192.168.10.10.
• VIBRANTE_INSTALL_PATH : destination folder of the compiled products. The default value is /home/nvidia/driveworks.
• VIBRANTE_USER : Specifies the user that will be used to rsync the binaries. The default value is nvidia.
• VIBRANTE_PASSWORD : Password for VIBRANTE_USER. The default value is nvidia.
• VIBRANTE_PORT : Port on which ssh is listening on the target board. The default is 22.

To invoke the upload target

1. Cross-compile the binaries as described in Cross Compiling for the NVIDIA DRIVE Platform.

2. On the Linux system, enter:

   $ make upload
   

@note If the VIBRANTE_HOST parameter is set to the IP address of a running NVIDIA DRIVE PX 2 board, users can call the upload target to rsync the build folder with a folder on the board.

Manual Upload

When you manually upload the sample to the target device, you copy the cross- compiled binaries to a device with IP DPX_IP as user nvidia.

To manually upload

1. Cross-compile the binaries as described in Cross Compiling for the NVIDIA DRIVE Platform

2. On the host system, execute:

    $ scp -r install/bin/* nvidia@DPX_IP:/home/nvidia/<destination_dir>/
   

## Compiling on the Device

Related Publications

What to cite

If you use this code for your research, please kindly cite:

@INPROCEEDINGS{8904020, author = {N. {Kemsaram} and A. {Das} and G. {Dubbelman}}, booktitle = {2019 Third World Conference on Smart Trends in Systems Security and Sustainablity (WorldS4)}, title = {An Integrated Framework for Autonomous Driving: Object Detection, Lane Detection, and Free Space Detection}, year = {2019}, volume = {}, number = {}, pages = {260-265}, keywords = {advanced driver assistance system;artificial intelligence;autonomous driving;deep neural network;free space detection;lane detection;object detection}, doi = {10.1109/WorldS4.2019.8904020}, ISSN = {null}, month = {July}, }