jetson-customize-usb

You can disable specific USB ports on a Jetson custom carrier board by generating a kernel device tree overlay that safely configures per-port USB2 and USB3 SuperSpeed settings while automatically handling companion port cascades and xHCI phy list ordering.

Empty lsusb output after customizing Jetson USB device tree settings often occurs because the USB lane status, port status, and host xHCI phy lists are not synchronized. Applying three-place lockstep overlay changes prevents these system-wide enumeration failures.

To prevent tegra-xusb failed to enable PHYs errors during Jetson USB3 configuration, the customization process automatically disables linked USB2 and USB3 companion port pairs to avoid mismatched port configurations.

Yes, you need UPHY lane allocation data before configuring Jetson USB ports. The generation process cross-checks prerequisite UPHY allocation and pinmux settings to ensure the produced device tree overlays are valid and flash-ready for the BSP source repository.

To generate valid kernel device tree overlays for Jetson Thor and Orin carrier boards, you need access to the target BSP source repository, carrier schematic and pinmap documentation, and prerequisite UPHY allocation run state to produce commit-ready configurations.

A key limitation when disabling USB2 and USB3 SuperSpeed ports on NVIDIA Jetson custom boards is that linked companion ports must be disabled together, and UPHY lane cross-checks are mandatory to prevent broken host xHCI probes or unresponsive ports.