User Guide (Latest)
NVIDIA IGX Orin Developer Kit User Guide (Latest)

Install IGX-Software

IGX-Software includes:

  • IGX-OS, which is Long Term Supported OS based on Ubuntu. This is the main operating system running on IGX.

  • NVIDIA AI stack, which is installed on IGX-OS and supported by NVIDIA AI Enterprise-IGX.

  • Firmware for BMC, Bootloader firmware (QSPI), Safety Microcontroller firmware, ConnectX-7 firmware, and HDMI IN firmware.

Enterprise support on IGX-Software is provided by NVIDIA AI Enterprise - IGX which is purpose-built for mission-critical applications and provides unmatched performance, security, stability, and long-term enterprise support for the entire software stack. IGX-Software is accessible via NVIDIA AI Enterprise - IGX subscription. Please refer following docs on more info on NVIDIA AI Enterprise - IGX.

IGX-Software is also publicly hosted for development and evaluation in the IGX Download Center.

The installation procedures in this document are the same whether IGX-Software is downloaded from NVIDIA AI Enterprise - IGX or from a public hosted download center.

To connect a display for software installation, see Connect a Display to Your Dev Kit.

Before you install IGX-OS, you must check the firmware version.

  • If your developer kit bootloader firmware is UEFI firmware version 36.3.1-gcid-36302503 built on 2024-05-17T04:47:03+00:00 or newer, proceed to installing IGX-OS.

  • If your developer kit bootloader firmware is an older version you must update it before you can install IGX-OS.

To check your bootloader firmware version, do the following:

  1. Turn on and boot up your IGX Developer kit.

  2. There are two options:

    • Option 1 — The UEFI splash screen appears, and you see a bootloader version message similar to the following:

      UEFI firmware version 36.3.1-gcid-36302503 built on 2024-05-17T04:47:03+00:00

    • Option 2 — Login to the IGX BaseOS and run the highlighted commands.

      Copy
      Copied!
                  

      cat /sys/class/dmi/id/bios_version 36.3.1-gcid-36302503 cat /sys/class/dmi/id/bios_date 05/17/2024

  3. If necessary, update your boot firmware by following the update order and instructions in Firmware and OS Updates.

Update the firmware and OS in following order:

  1. Update the BMC firmware.

  2. Update the MCU firmware.

  3. Update the Boot firmware (QSPI).

  4. Update the Connect-X 7 (CX7) firmware (optional).

  5. Update the HDMI IN firmware (optional).

  6. Update the IGX OS.

Warning

You must follow this order or your IGX might hang during boot.

Update the BMC Firmware

Use the following procedure to update the BMC firmware.

  1. Log in to the BMC and check the version.

  2. Follow the instructions here if your BMC version is older than the version below: Update Your BMC Firmware.

Note

Command to check the BMC version:

Copy
Copied!
            

root@mgx-3809:~# cat /etc/os-release ID=openbmc-phosphor NAME="NVIDIA MGX/IGX BMC (OpenBMC Project Reference Distro)" VERSION="IGXOrinBMC-24.04-11-v3.2" VERSION_ID=igxorinbmc-24.04-11-v3.2-0-g1f7f8057b43.1713949685.0770278 PRETTY_NAME="NVIDIA MGX/IGX BMC (OpenBMC Project Reference Distro) IGXOrinBMC-24.04-11-v3.2" BUILD_ID="20240424090802" OPENBMC_TARGET_MACHINE="mgx-3809" BUILD_DESC="prod-platform

Update the MCU Firmware

Use the following procedure to update the Microcontroller (MCU) Firmware.

Warning

IGX BMC can flash the MCU Firmware and upgrade the MCU.

MCU FW

HW Board Revision

P3740-Aurix-StepB_C00.hexC TS3
P3740-Aurix-StepB_C01.hex QS2, CR
Note

The version of the IGX Developer Kit (TS3, QS2 or CR) can be found on the sticker on the developer kit or laser etched on the bottom.

To flash the MCU, follow the instructions here: Update your MCU firmware.

Note

Command to check the MCU version:

Login to MCU

Shell> version

Update the Boot Firmware (QSPI)

To flash the Boot Firmware (QSPI), follow the instructions here: Update your QSPI firmware.

Update the Connect-X 7 (CX7) Firmware

You can update the CX7 from the IGX OS.

Note

CX7 firmware is updated from IGX OS. If you have not yet done so, install IGX OS before continuing.

  1. Download or copy the .iso to the IGX.

  2. Mount the ISO image on your machine.

    Open a terminal on the IGX developer kit to the directory where the .iso was downloaded. Then mount the .iso:

    Copy
    Copied!
                

    mount -o ro,loop MLNX_OFED_LINUX-23.10-2.1.3.1-ubuntu22.04-aarch64.iso /mnt

  3. Run the following command to update the CX7 firmware:

    Copy
    Copied!
                

    /mnt/mlnxofedinstall --fw-update-only

Update the HDMI IN (Input) Firmware

Before you use the HDMI in device of your devkit, ensure that it has the latest firmware.

Note

HDMI-IN firmware is updated from IGX OS. If you have not yet done so, install IGX OS before continuing.

  1. Register an account with Lontium.

    Note

    It may take several days for Lontium to approve your registration.

  2. Downloading the firmware files from the Lontium website, or contact Nvidia Support. Download the following two files from the NVIDIA section on to your IGX.

    • lontium_lt6911_flash_update

    • LT6911UXC_RGB888

  3. Extract the downloaded files on Tegra Linux by running the following code.

    Copy
    Copied!
                

    unrar e lontium_lt6911_flash_update.rar unrar e LT6911UXC_RGB888.rar

  4. Change the updater to be executable:

    Copy
    Copied!
                

    chmod a+x lontium_lt6911_flash_update

  5. If you do not have v4l2-ctl, run the following command.

    Copy
    Copied!
                

    sudo apt-get install v4l-utils

  6. To power the HDMI in chip and flash it with the firmware file, run the following code.

    Copy
    Copied!
                

    v4l2-ctl -d /dev/video0 --stream-mmap & sudo ./lontium_lt6911_flash_update 2 0x2b LT6911UXC_RGB888.bin

  7. Reboot the IGX.

Warning

The HDMI in firmware does not support hot-plugging. For details, see Troubleshoot Your Dev Kit.

You must ensure you have Bootloader Firmware is updated before loading the IGX Base OS image. For details, see Check the Bootloader Firmware Version.

Warning

Installing the IGX OS will erase the content of the SSD (NVMe) on the IGX. Please backup your data.

To install the IGX OS ISO image locally from a UEFI-bootable USB flash drive:

  1. Download the IGX OS ISO image.

  2. Create a bootable installation medium, such as a USB flash drive, that contains the image. See the Creating a Bootable USB Flash Drive by Using BalenaEtcher topic for detailed steps.

Warning

You must install Tegra Boot Firmware update first.

  1. Plug the USB flash drive containing the OS image into the IGX Developer Kit.

  2. Connect a monitor and keyboard directly to the IGX system’s iGPU or dGPU based on whether you are using iGPU mode or dGPU mode.

  3. Boot the system. Press F11 when the NVIDIA logo appears to access the boot menu.

  4. Select the USB volume name that corresponds to the inserted USB flash drive and boot the system from that drive.

  5. Continue to the IGX OS ISO Boot Options topic for a description of the GRUB menu options and for instructions on completing the installation process.

    • Install IGX OS (iGPU)

    • Install IGX OS (dGPU)

    grub_install_igx_os.png


You can install the NVIDIA AI Stack on IGX-OS as Debian packages or as containers.

Caution

If you install by using Debian packages, the size of the installation is approximately 11 gigabytes.

Debian Packages

iGPU

dGPU

Copy
Copied!
            

$ sudo apt update $ sudo apt install nvidia-igx-ai $ sudo apt --fix-broken install

Copy
Copied!
            

$ sudo apt update $ sudo apt install nvidia-igx-ai-rm $ sudo apt --fix-broken install

Containers

NVIDIA AI Stack containers include:

  • Tensorrt Container

  • Triton Container

  • Tensorflow Container

  • PyTorch Container

  • Holoscan Container

The container supported via NVIDIA AI Enterprise - IGX can be accessed with NVIDIA AI Enterprise - IGX subscription. Please refer to <> on more info on NVIDIA AI Enterprise - IGX.

These publicly hosted versions of the containers for development and evalutaion can be found on below locations on NVIDIA GPU Cloud (NGC):

Log in to the BMC

dev-kit-back.png

Developer Kit Back Panel

  1. Connect your Linux host machine and the developer kit with an Ethernet cable. Use the Ethernet port labeled 5 in the figure above.

  2. Find out which Ethernet adapter on the host machine is connected, then start static IP configuration.

  3. Configure the remote Ubuntu host machine Ethernet adapter as a static node. Thus, the Ubuntu Host can communicate to the BMC over the static IP address 192.168.1.110. Find the network adapter in ifconfig, which is connected to the RJ45 port of the NVIDIA IGX Orin Developer Kit, then configure it as a static route. The name can be em1 or eno1 or whatever you choose. As an example:

    Copy
    Copied!
                

    ifconfig eno1 192.168.1.1 netmask 255.255.255.0

  4. Test the connection to the BMC default IP address with either an SSH or ping.

  5. ssh root@192.168.1.110

The first time you log in, you are prompted to change the password: add default password “0penBmc (here, the first character is '0' zero)”

Get the Tegra UART Port

Warning

ssh port 2200 is the default to mux the UART to Tegra. Set gpiochip0 60 to 1 to switch it to Tegra Linux.

  1. Log in to BMC

  2. root@mgx:~# gpioset -m exit gpiochip0 60=1

  3. ssh root@192.168.1.110 -p 2200

Get the MCU UART Port

Warning

ssh port 2200 is default to mux the UART to Tegra. Set gpiochip0 60 to 0 to switch to MCU.

  1. Log in to BMC

  2. root@mgx:~# gpioset -m exit gpiochip0 60=0

  3. ssh root@192.168.1.110 -p 2200

Put IGX into Recovery mode

From BMC

  1. Log in to BMC

  2. root@mgx:~# powerctrl recovery

From IGX OS

  1. Login to IGX OS.

  2. sudo reboot forced-recovery

Warning

To check if the IGX is in recovery mode, use the linux command lsusb and you should see a USB device with PID 7023. If you are still not able to see this USB device, a power cycle of the IGX is required.

Access all downloads from the IGX Download Center.

Create a Bootable USB Flash Drive using BalenaEtcher

BalenaEtcher https://etcher.balena.io/ currently supports:

  • Windows

  • MacOS

  • Linux

Follow these steps to create the bootable USB Flash drive:

  1. Download and launch the balenaEtcher https://etcher.balena.io/.

  2. Plug the USB flash drive into one of the USB ports of your Windows system.

  3. Click Flash from file, select the iso image you downloaded.

    balena_etcher_0.png

  4. Click Select target, select the USB flash drive you inserted this host.

    balena_etcher_1.png

  5. Click Flash!

Previous IGX-SW 1.0 Developer Preview Release Notes
Next Install the Holoscan SDK
© Copyright © 2024, NVIDIA Corporation. Last updated on Aug 23, 2024.