C

NVIDIA Jetson AGX Xavier Guide

To successfully set up the Boot to Qt Software Stack, you must closely follow the instructions in this section and perform all the described tasks.

In case of problems, see Troubleshooting.

Note: After you have installed the Boot to Qt software stack and want to connect to the target device with SSH or a serial cable, you can access the device by using the user root and an empty password.

Before you install the Boot to Qt Software Stack, you should note the requirements related to the development hosts:

2. Installing Boot to Qt Software Stack

You can install the Boot to Qt Software Stack via the Qt online installer. On Linux, see General Installation Issues for Linux.

Download the Qt online installer via Qt Customer Portal and follow the instructions in the installer. The Select components page in the installer lists all the components that are available for your Qt account.

Select the Boot to Qt Software Stack for NVIDIA Jetson AGX Xavier with the following steps:

  1. Select Boot to Qt Software Stack.
  2. Select the Boot to Qt Software Stack version.
  3. Select NVIDIA Jetson AGX Xavier.
  4. Select Next.

To finish the installation, follow the instructions in the installer.

Installation Content

The Boot to Qt Software Stack provides a system image (<target-device> System) and a toolchain (<target-device> Toolchain) for each target device. The system image contains the Boot to Qt Software Stack and needs to be flashed to the SD card or directly to the target device (see 3. Installing Boot to Qt on Target Device). The toolchain is required for building and developing applications for the target devices.

General Installation Issues for Linux

On Linux, remember to allow the execution of the installer binary. You can do this by using one of the following methods:

  • On the command line enter the chmod +x <filename> command.
  • Right-click the file, and select Properties > Permissions > Allow executing file as program.

Note: Do not execute the installer as a root user or with sudo.

Installation Directory

The installer will let you select a directory where the Boot to Qt Software Stack will be installed. In this documentation, the installation directory is referred to as <INSTALL_DIR>. The default installation directories are:

  • ~/Qt on Linux
  • C:\Qt on Windows
  • ~/Qt on macOS

3. Installing Boot to Qt on Target Device

Before you can test your Qt applications on the target device, you must flash the target device with an image containing the Boot to Qt Software Stack. After you have successfully flashed your device, Boot to Qt Startup Screen automatically appears on the screen when you power on the device.

This device can be booted from an internal eMMC or from an SD card, however, the Boot to Qt image only supports an internal eMMC.

Note: Qt Flashing Wizard is not applicable to this device.

Flashing Boot to Qt image onto the system's internal eMMC

  1. Connect the target device to the PC with a suitable USB-C cable.

    Note: Connecting the device via a USB hub will greatly decrease transmission speed during flashing.

  2. Put the target device into the factory recovery mode.
    1. Press and hold the factory recovery button.
    2. Press and release the power button, if the device is already turned on, press and release reset button.
    3. Release the factory recovery button.
  3. Run the following scripts to flash the image onto the system's internal eMMC:
    cd <INSTALL_DIR>/<Qt version>/Boot2Qt/jetson-agx-xavier-devkit/images
    mkdir tegraflash
    cd tegraflash
    tar xf ../b2qt-embedded-qt6-image-jetson-agx-xavier-devkit.tegraflash.tar.gz
    ./prepare-image.sh
    sudo ./doflash.sh

For more detailed information, see Flashing the Jetson Dev Kit.

Note: Flashing the internal eMMC is supported only on a Linux host.

4. Configuring a Device Kit in Qt Creator

After you have prepared the target device, you must set up the development tools in Qt Creator for your device. That is, you must configure your target device to be used for each build and run kit.

Connect your device to the development host via USB and launch Qt Creator. In Qt Creator:

  1. Select Edit > Preferences > Kits.
  2. Select one of the predefined kits starting with Boot to Qt... that matches the type of your device.
  3. Select the correct device in the Device field.
  4. Select OK.

You are now ready to start developing with Qt for your device. For detailed information about how to deploy Qt projects to the device, see Tutorial: Deploying Your First Project with Boot to Qt.

5. Powering on with Boot to Qt Startup Screen

After you have successfully flashed your device with Boot to Qt Software Stack, Boot to Qt Startup Screen automatically appears on the screen when you power on the device.

Available under certain Qt licenses.
Find out more.