SDKManager 2.0.0 File System and OS Install Error on WSL2 Ubuntu 22.04

Issue Overview

Users are experiencing installation errors while trying to use SDKManager 2.0.0 to update the QSPI bootloader for the Nvidia Jetson Orin Nano Dev Kit on WSL2 running Ubuntu 22.04. The specific symptoms include recurring error messages indicating issues with the trusted GPG keyring during the installation process, which ultimately leads to a failure in setting up the necessary tools for flashing the device.

Specific Symptoms

• Errors related to deprecated GPG keyring management:
  • "Key is stored in legacy trusted.gpg keyring."
  • "Installation failed."
• Inability to find essential files such as initrd in the expected directories.

Context

The issue arises during the installation of flash tools needed for a command-line QSPI bootloader update, after having successfully installed Jetpack 6.0 DP on an SD card using the SD Card Image method.

Hardware/Software Specifications

• Hardware: Nvidia Jetson Orin Nano Dev Kit
• Software: WSL2 with Ubuntu 22.04, SDKManager 2.0.0, Jetpack 6.0 DP

Frequency and Impact

The problem seems to be consistent among multiple users attempting similar setups, significantly hindering their ability to flash the device and utilize its functionalities effectively.

Possible Causes

• Hardware Incompatibilities: Issues may arise from using WSL2, which may not fully support all USB functionalities required for flashing.

• Software Bugs or Conflicts: The SDKManager may not handle deprecated apt-key warnings correctly, interpreting them as critical errors rather than warnings.

• Configuration Errors: Incorrect paths or missing files due to improper installation or extraction processes.

• Driver Issues: Potential USB driver problems in WSL2 leading to communication failures with the Jetson device.

• Environmental Factors: Running SDKManager from a Windows partition can lead to permission issues and file accessibility problems.

• User Errors or Misconfigurations: Incorrect commands or missing steps in the flashing process can lead to failures.

Troubleshooting Steps, Solutions & Fixes

Step-by-Step Instructions

1. Verify SDKManager Installation:

   • Ensure that SDKManager is installed correctly and that you are using a compatible version (2.0.0).

2. Check System Requirements:

   • Confirm that WSL2 is properly configured and that USB functionalities are enabled.
   • Avoid installing SDKManager in a Windows partition; use a directory within the WSL2 filesystem.

3. Install Missing Packages:

   • If you encounter errors related to missing files like initrd, ensure that you run:

     sudo ./apply_binaries.sh
     

   • This command extracts necessary binaries into the correct directories.

4. Download Necessary Files Manually:

   • If SDKManager fails, download the required BSP and root filesystem packages directly:

     wget https://developer.nvidia.com/downloads/embedded/l4t/r36_release_v2.0/release/jetson_linux_r36.2.0_aarch64.tbz2
     wget https://developer.nvidia.com/downloads/embedded/l4t/r36_release_v2.0/release/tegra_linux_sample-root-filesystem_r36.2.0_aarch64.tbz2
     

   • Extract them using:

     tar xf jetson_linux_r36.2.0_aarch64.tbz2
     sudo tar xpf tegra_linux_sample-root-filesystem_r36.2.0_aarch64.tbz2 -C Linux_for_Tegra/rootfs/
     

5. Install USB Tools:

   • Install usbip tools from GitHub to enable USB communication with the Orin Nano:
     • Download and install using MSI installer for ease.

6. Prepare for Flashing:

   • Put the Orin Nano Dev Kit into Force Recovery Mode.
   • Use PowerShell to attach the device:

     usbipd attach --busid <busid> --auto-attach --wsl
     

   • Verify attachment with:

     lsusb
     

7. Run Flash Command:

   • Execute the flash command to update the QSPI bootloader:

     sudo ./flash.sh --no-systemimg -c bootloader/generic/cfg/flash_t234_qspi.xml jetson-orin-nano-devkit mmcblk0p1
     

   • Monitor output for success messages indicating completion of flashing.

8. Post-Flashing Steps:

   • Remove any jumpers used for recovery mode.
   • Insert SD card with Jetpack 6.0 DP and boot up the Orin Nano Dev Kit.

Recommended Approach

Multiple users have reported success by avoiding SDKManager altogether and manually downloading necessary files, which is highlighted as a recommended approach for those facing persistent issues with SDKManager.

Best Practices for Future Prevention

• Always ensure that software installations are done within WSL’s native environment rather than Windows partitions.
• Regularly check for updates or patches related to SDKManager and associated tools.
• Familiarize yourself with command-line operations for flashing devices as a fallback method when GUI tools fail.

Unresolved Aspects

Some users still report issues with specific commands not functioning as expected, indicating potential bugs in SDKManager or incompatibilities with WSL2 that may require further investigation from Nvidia’s support team or community forums.