Set Up DRIVE OS Linux with NVIDIA GPU Cloud (NGC)

Begin by referring to the instructions in Setup Docker and NVIDIA GPU Cloud Access, then proceed with the following installation guide for DRIVE OS Linux.

Images Available in This Release

The following images will be available on NGC in this release:

 File Name     Intent  
drive-agx-orin-linux-aarch64-sdk-build-x86:latest    Build and Flash DRIVE OS SDK Linux  

Pull Docker Images from NGC

Note: Prior to installation, you can choose to remove previously installed DRIVE OS Docker images/containers to increase space capacity.

Instructions for Running DRIVE OS Docker

  1. Log into the NVIDIA GPU Cloud (NGC) using instructions in the previous section.

  2. On the host system, pull the image using the following command:

    Note: ${MY_NGC_ORG} is the NGC Organization allocated for your team.
    sudo docker run -it --privileged --net=host -v /dev/bus/usb:/dev/bus/usb -v ${WORKSPACE}:/home/nvidia/${MY_NGC_ORG}/driveos-sdk/drive-agx-orin-linux-aarch64-sdk-build-x86:latest

Flash DRIVE OS Linux

Use the procedures in this section to flash NVIDIA DRIVE OS Linux to the target system from the Docker container.

Flash Using the DRIVE OS Docker Container

  1. Log on to the NVIDIA GPU Cloud (NGC). If you need to download a DRIVE OS Docker image, use the procedures in the Set Up Docker and NVIDIA GPU Cloud Access section of this document.

  2. Connect NVIDIA DRIVE™ AGX to the host system.

    Note: Ensure that NVIDIA DRIVE AGX is connected to the host system, and that no other processes, such as TCUMuxer or Minicom are holding a lock on /dev/ttyACM* before starting the Docker container.   
  3. Start the DRIVE OS Docker container and flash DRIVE OS onto the NVIDIA DRIVE AGX using the following command.

    sudo docker run -it --privileged --net=host -v /dev/bus/usb:/dev/bus/usb -v /drive_flashing:/drive_flashing${MY_NGC_ORG}/driveos-sdk/drive-agx-orin-linux-aarch64-sdk-build-x86:latest

Instructions for Flashing

Flash with

./ /dev/ttyACM1 p3710
Note: /dev/ttyACM1 is the default port for the DRIVE AGX Orin Developer Kit on the x86 Host system if only one Developer Kit or another USB device is connected. If there are additional devices in this device range, please disconnect them before flashing.    
Note: If flashing the target system fails, try the following:
  1. Reseat the USB cable connected from the Host PC to the LEFT USB Type-C port on the target on both ends. See the NVIDIA DRIVE AGX Orin Developer Kit Hardware Quick Start Guide for more details.
  2. Use a USB 3.1 port on the host PC if available.
  3. Use a different USB C/SS cable, OR a higher speed cable such as a USB SS10 (for example, Amazon Model Number L6LUC146-CS-R).
  4. Use a USB 2.0 port on the host PC used for flashing.

Browse DRIVE OS Documentation

The DRIVE OS Developer Guide can be browsed from within Docker. To do so, start the Docker container using the instructions above for running DRIVE OS Docker.

Once in the container, execute the following to start the documentation server.

# start-docs-server

This will start a lightweight HTTP server on port 65535 by default. If the port is not available, you can configure the process to start on a different port. The below example will attempt to use port 49350 for the HTTP server, if it is available.

# start-docs-server 49350

Once the server starts, use your preferred browser to access the docs by visiting http://localhost:65535 (replacing 65535 with your specified port, if different). If you have started the container on a remote machine, you will need to use the remote IP as opposed to localhost.

The process can be stopped with CTRL+C.