jetson-customize-usb

What problem does it solve?

This Skill solves the high-risk, error-prone task of customizing per-port USB2 and USB3 SuperSpeed settings on NVIDIA Jetson custom carrier boards, where incorrect device tree changes can cause system-wide USB enumeration failures, broken host xHCI probes, or unresponsive ports.

Core Features & Use Cases

• Three-place lockstep overlay generation: Automatically applies synchronized changes to USB lane status, port status, and host xHCI phy lists to prevent the common failure mode of empty lsusb output after customization.
• Companion cascade handling: Automatically disables linked USB2/USB3 port pairs when requested, avoiding tegra-xusb: failed to enable PHYs errors from mismatched port configurations.
• Prerequisite integration: Cross-checks UPHY lane allocation from the jetson-customize-uphy skill and pinmux settings from jetson-customize-pinmux to ensure generated overlays are valid and flash-ready.
• Use Case: For example, if your custom Jetson carrier routes a USB hub to the usb2-3 and usb3-2 port pair, the skill will automatically disable both ports, generate a valid kernel device tree overlay, and commit it to your BSP source repository with full provenance tracking.

Quick Start

Use the jetson-customize-usb skill to disable the USB2 and USB3 ports connected to the on-carrier USB hub on your custom Jetson carrier board and generate a valid kernel device tree overlay commit for your BSP source repository.