Jetson Customize Usb

Enables or disables individual USB2/USB3 ports on Jetson Thor and Orin custom carriers by generating a kernel device tree overlay that keeps three critical places in lockstep: the PHY lane, the port controller binding, and the host xHCI phys array. Miss any of those and the entire USB subsystem crashes on boot, leaving lsusb empty even on working ports. It walks the companion graph from the DTB, asks which ports to flip, validates GPIO routing from your schematic and pinmux spreadsheet, then appends fragments to your composite overlay. Requires both schematic and pinmux docs for custom carriers because there's no safe way to guess VBUS-EN, overcurrent, or USB3 SuperSpeed lane wiring. Strictly DT only, doesn't touch UPHY allocation or ODMDATA.

skills.sh installs: 1.1K
GitHub stars: 3.9K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add nvidia/skills --skill jetson-customize-usb --agent claude-code

Installs into .claude/skills of the current project.

Files

Customize USB (per-port enable / disable / role)

Purpose

Enable, disable, or change the role of USB2 / USB3 SS ports on a Jetson Thor (Tegra264) or Orin (Tegra234) custom carrier. Captures per-port wiring (role, max speed, VBUS-EN / OC GPIOs, CC1/CC2 GPIOs for Type-C, USB3 SS UPHY lane), resolves the SS to USB2 companion graph from the in-tree DTB, then renders a self-contained kernel-DT overlay that flips every port action in three places in lockstep (lane status, port status, host xHCI phys + phy-names).

UPHY lane allocation belongs to jetson-customize-uphy. No ODMDATA edit. Output is one commit to the composite custom overlay .dts in the bsp_sources/ hardware repo.