Installing IGX-Software on IGX 700 or IGX Developer Kit#

IGX-Software for IGX 700 and IGX Developer Kit 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.

Connect a Display for Software Installation#

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

Check the Bootloader Firmware Version#

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

  • If your developer kit bootloader firmware is UEFI firmware version 36.4.1-gcid-38375079 built on 11/19/2024 or newer, and IGX OS is not already installed, proceed to Install the IGX OS Image.

  • 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:

  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:

    GA 1.1 UEFI firmware version 36.4.1-gcid-38375079 built on 11/19/2024 GA 1.1.1 UEFI firmware version 36.4.5-gcid-39296390 built on 01/29/2025

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

       1#GA1.1 UEFI version
       2cat /sys/class/dmi/id/bios_version
       336.4.1-gcid-38375079
       4
       5cat /sys/class/dmi/id/bios_date
       611/19/2024
       7
       8#GA1.1.1 UEFI version
       9cat /sys/class/dmi/id/bios_version
      1036.4.5-gcid-39296390
      11
      12cat /sys/class/dmi/id/bios_date
      1301/29/2025
      
  3. If necessary, update your boot firmware by following the instructions in Firmware and OS Updates.

Firmware and OS Updates#

Note

If GA1.0 IGX OS is already installed, run these commands to upgrade to GA1.1 and skip to Update the BMC firmware and Update the MCU firmware: If previously installed cuda and display driver from different public repo, these Components will need to be removed first.

Upgrade from GA1.0 to GA1.1.1

  1. Download nv-update-debian-release.sh from the IGX Download Center.

  2. Upgrade the BSP.

    sudo apt update
    chmod a+x ./nv-update-debian-release.sh
    sudo ./nv-update-debian-release.sh --do-upgrade r36.4.1
    
  3. Upgrade to the GA1.1.1 kernel.

    sudo apt update
    sudo apt install linux-nvidia-tegra-igx-r36.4.1
    sudo reboot
    

Upgrade From GA1.1 to GA1.1.1

sudo apt update
sudo apt dist-upgrade

Update the firmware and OS in the 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

  1. Login to BMC WebUI to Connect to the BMC Web UI to check the version from the WebUI.

  2. SSH to the BMC to Check the version with the highlighted command:

    root@mgx-3809:~# cat /etc/os-release
    
    ID=openbmc-phosphor
    NAME="NVIDIA MGX/IGX BMC (OpenBMC Project Reference Distro)"
    VERSION="IGX-BMC-10.10-rc-4.1"
    VERSION_ID=igx-bmc-10.10-rc-4.1-6-ga662035739a.1729874607.1553206
    PRETTY_NAME="NVIDIA MGX/IGX BMC (OpenBMC     Project Reference Distro) IGX-BMC-10.10-rc-4.1"
    BUILD_ID="20241025164321"
    OPENBMC_TARGET_MACHINE="mgx-3809"
    

Update the MCU Firmware#

Use the following procedure to update the microcontroller (MCU) firmware.

Warning

You must install the BMC firmware update first.

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 at: Update your MCU firmware.

Note

Check the MCU version with the following command:

Login to MCU

Shell\> version

Update the Boot Firmware (QSPI)#

To flash the boot firmware (QSPI), follow the instructions at: 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 from the download center to the IGX.

  2. Mount the ISO image on your machine.

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

    mount -o ro,loop MLNX_OFED_LINUX-23.10-x.x.x-ubuntu22.04-aarch64.iso /mnt
    
  3. Run the following command to update the CX7 firmware:

    /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 command:

    1unrar e lontium_lt6911_flash_update.rar
    2unrar e LT6911UXC_RGB888.rar
    
  4. Change the executable flag on the updater:

    chmod a+x lontium_lt6911_flash_update
    
  5. If you do not have v4l2-ctl, run the following command:

    1sudo apt-get install v4l-utils
    
  6. To power the HDMI-IN chip and flash it with the firmware file, run the following command:

    1v4l2-ctl -d /dev/video0 --stream-mmap &
    2sudo ./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.

Install the IGX OS Image#

The bootloader firmware must be 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.

Download the IGX OS ISO image from the IGX Download Center.

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

  2. To install the IGX OS ISO image from BMC Virtual Media:

Boot the IGX OS ISO image#

Warning

Tegra Boot Firmware must be updated first.

  1. Insert 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)

    • Advanced Installation Options

      • Install IGX OS with Real-Time Kernel (iGPU)

      • Install IGX OS with Encrypted File System (iGPU)

      • Install IGX OS with Real-Time Kernel and Encrypted File System

      • Install IGX OS with Encrypted File System (dGPU)

      • Install IGX OS (headless)

      • Install IGX OS with Encrypted File System (headless)

    _images/grub_install_igx_os.png

    Warning

    Headless installation mode requires connecting the USB-C cable from the Linux host to the USB-C connector. For more information, see System Overview.

Install the NVIDIA AI Stack#

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

$ sudo apt update
$ sudo apt install nvidia-igx-ai
$ sudo apt --fix-broken install
$ 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.

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

Further References#

Log in to the BMC#

Developer Kit Back Panel

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:

    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.

    _images/balena_etcher_0.png
  4. Click Select target, select the USB flash drive you inserted this host.

    _images/balena_etcher_1.png
  5. Click Flash!