NVIDIA SDK Manager Documentation
Windows Subsystem for Linux - v - Last updated February 10, 2023

1. Windows Subsystem for Linux (WSL)

SDK Manager supports flashing and installing SDKs on Jetson, Holoscan, and Ethernet Switch hardware from a Windows computer using WSL systems. To setup your environment, follow the instructions below.

1.1. Setup the WSL Environment

  • It is recommended that you use Windows Terminal instead of the Windows command prompt.

  • Install Linux distributions that comply with the SDK you are about to install.
    • See a list of available distros with the following command:

      wsl --list --online 
    • Install the required distribution by running the below command (it may require elevated mode and system reboot):

      wsl --install -d <DistroName>
    • Ensure you have the latest WSL kernel with the following command:

      wsl.exe --update 
    • More information is available at the Install WSL @ Microsoft Documentation.

  • Verify your Linux distribution is set to WSL2 by following the steps at: Set distribution to WSL 2.

  • To use the SDK Manager GUI, you need to verify WSL GUI is set with the instructions found at Run Linux GUI apps with WSL. This requires Windows 11 (Build 22000 or later).

To flash a NVIDIA physical device which is connected over USB to your host Windows machine, you will need to install USBIPD. To do so, follow the article Connect USB devices with WSL.

1.2. Setup the Linux Distribution Environment

In your Linux distribution:

  • Install additional recommended packages by running the below commands:

    sudo apt update
    sudo apt install iputils-ping iproute2 netcat iptables dnsutils network-manager usbutils net-tools python3-yaml dosfstools libgetopt-complete-perl openssh-client binutils xxd cpio udev dmidecode -y
  • To flash a NVIDIA device connected over USB, install the following packages by running the below commands:

    sudo apt install linux-tools-virtual hwdata
    sudo update-alternatives --install /usr/local/bin/usbip usbip `ls /usr/lib/linux-tools/*/usbip | tail -n1` 20
  • Install SDK Manager, which is available from https://developer.nvidia.com/nvidia-sdk-manager.

Run SDK Manager in CLI mode (or GUI if enabled) and follow the standard SDK install instructions.

1.2.1. Flash a Jetson Device

  1. Run your WSL Linux distribution.

  2. Connect the Jetson device to a USB port on your Windows machine.

  3. Boot the Jetson device into Recovery mode.

  4. Attach the USB BUS ID of the Jetson device to the WSL distribution.

    1. From Windows PowerShell terminal, run the following command:

      usbipd.exe list
    2. Identify the BUS ID of the selected Jetson device (starting 0955).

    3. Attach the BUS ID to the WSL Linux distribution by running the following command:

      usbipd.exe wsl attach --busid <BUSID> --auto-attach --distribution <distribution>
  5. Validate that the Jetson device appears in the WSL Linux distribution by running the following command:

    lsusb
  6. Run the SDK Manager command to flash.

    1. Run SDK Manager in CLI mode (or GUI if enabled).

    2. Select the device that is attached to your machine.

    3. In the SDK Manager flash configuration dialog (in STEP 3), choose Manual Setup Mode for the recovery method.

    4. Continue with the flash operation.

      Flash progress can take a long time (up to 25 minutes). If a time-warning dialog is prompt, it is advised to click Continue and wait a bit longer.

    5. When the flash process is done, detach the USB by running the following command from your Windows PowerShell terminal:

      usbipd.exe wsl detach --busid <BUSID>

1.3. Known Issues

  1. Detection of the Jetson device in running mode is not available.

  2. To install SDK components on the Jetson device:

    1. Connect the Jetson device to the Internet using an Ethernet cable or to a Wi-Fi network.

    2. In the SDK Manager Install SDK Components dialog, choose ETH and enter the external IP address of the device.

Previous | Next

  Previous Topics     Next Topics  

System Requirements    

Download and Install SDK Manager    

SDK Manager Settings    

Home    

 

Notices

Notice

THE INFORMATION IN THIS GUIDE AND ALL OTHER INFORMATION CONTAINED IN NVIDIA DOCUMENTATION REFERENCED IN THIS GUIDE IS PROVIDED “AS IS.” NVIDIA MAKES NO WARRANTIES, EXPRESSED, IMPLIED, STATUTORY, OR OTHERWISE WITH RESPECT TO THE INFORMATION FOR THE PRODUCT, AND EXPRESSLY DISCLAIMS ALL IMPLIED WARRANTIES OF NONINFRINGEMENT, MERCHANTABILITY, AND FITNESS FOR A PARTICULAR PURPOSE. Notwithstanding any damages that customer might incur for any reason whatsoever, NVIDIA’s aggregate and cumulative liability towards customer for the product described in this guide shall be limited in accordance with the NVIDIA terms and conditions of sale for the product.

THE NVIDIA PRODUCT DESCRIBED IN THIS GUIDE IS NOT FAULT TOLERANT AND IS NOT DESIGNED, MANUFACTURED OR INTENDED FOR USE IN CONNECTION WITH THE DESIGN, CONSTRUCTION, MAINTENANCE, AND/OR OPERATION OF ANY SYSTEM WHERE THE USE OR A FAILURE OF SUCH SYSTEM COULD RESULT IN A SITUATION THAT THREATENS THE SAFETY OF HUMAN LIFE OR SEVERE PHYSICAL HARM OR PROPERTY DAMAGE (INCLUDING, FOR EXAMPLE, USE IN CONNECTION WITH ANY NUCLEAR, AVIONICS, LIFE SUPPORT OR OTHER LIFE CRITICAL APPLICATION). NVIDIA EXPRESSLY DISCLAIMS ANY EXPRESS OR IMPLIED WARRANTY OF FITNESS FOR SUCH HIGH RISK USES. NVIDIA SHALL NOT BE LIABLE TO CUSTOMER OR ANY THIRD PARTY, IN WHOLE OR IN PART, FOR ANY CLAIMS OR DAMAGES ARISING FROM SUCH HIGH RISK USES.

NVIDIA makes no representation or warranty that the product described in this guide will be suitable for any specified use without further testing or modification. Testing of all parameters of each product is not necessarily performed by NVIDIA. It is customer’s sole responsibility to ensure the product is suitable and fit for the application planned by customer and to do the necessary testing for the application in order to avoid a default of the application or the product. Weaknesses in customer’s product designs may affect the quality and reliability of the NVIDIA product and may result in additional or different conditions and/or requirements beyond those contained in this guide. NVIDIA does not accept any liability related to any default, damage, costs or problem which may be based on or attributable to: (i) the use of the NVIDIA product in any manner that is contrary to this guide, or (ii) customer product designs.

Other than the right for customer to use the information in this guide with the product, no other license, either expressed or implied, is hereby granted by NVIDIA under this guide. Reproduction of information in this guide is permissible only if reproduction is approved by NVIDIA in writing, is reproduced without alteration, and is accompanied by all associated conditions, limitations, and notices.

Trademarks

NVIDIA, the NVIDIA logo, Bluefield-2, CLARA, NVIDIA CLARA AGX SDK, cuBLAS, CUDA, CUDA-GDB, CUDA-MEMCHECK, cuDNN, cuFFT, cuSPARSE, DIGITS, DGX, DGX-1, DGX Station, NVIDIA DOCA SDK, NVIDIA DRIVE, NVIDIA DRIVE AGX, NVIDIA DRIVE Software, NVIDIA DRIVE OS, NVIDIA Developer Zone (aka "DevZone"), NVIDIA DOCA SDK, NVIDIA Ethernet Switch, NVIDIA Ethernet Switch SDK, GRID, Jetson, NVIDIA Jetson Nano, NVIDIA Jetson AGX Xavier, NVIDIA Jetson TX2, NVIDIA Jetson TX2i, NVIDIA Jetson TX1, NVIDIA Jetson TK1, Kepler, NGX, NVIDIA GPU Cloud, Maxwell, Multimedia API, NCCL, NVIDIA Nsight Compute, NVIDIA Nsight Eclipse Edition, NVIDIA Nsight Graphics, NVIDIA Nsight Systems, NVLink, nvprof, Pascal, NVIDIA Rivermax SDK, NVIDIA SDK Manager, Tegra, TensorRT, Tesla, Visual Profiler, VisionWorks and Volta are trademarks and/or registered trademarks of NVIDIA Corporation in the United States and other countries. Other company and product names may be trademarks of the respective companies with which they are associated.