Agent skill · NVIDIA
jetson-customize-pcie
Per-controller PCIe enable / disable / lanes / link-speed for a Jetson Thor or Orin custom carrier via ODMDATA + kernel-DT overlay. Do NOT use for UPHY lane allocation or endpoint-mode bring-up.
What it needs
About 4k tokens when loaded.
What this skill does
Customize PCIe (per-controller status / lanes / speed) Overview PCIe on Tegra264 (Thor, pcie@C0..C5) and Tegra234 (Orin, pcie@C0..C10) is split across multiple controllers that share the UPHY lane pool with USB3 / MGBE / UFS. Each controller's runtime behavior is determined by two surfaces, both required: Surface Target Authoritative for --- --- --- ODMDATA pcie@Nstatus=… (+ pcie@Nmax-link-speed, pcie@Npcie-mode, pcie@Nclk-scheme, pcie-cN-endpoint-enable) /pcie/pcie@N in BPMP DTB UPHY lane power, refclk gating, controller-side power rails Kernel-DT overlay on &pcieN /bus@0/pcie@<addr> in kernel DTB Kernel probe, lane width, link speed, RC/EP mode Skipping the kernel overlay on a disable lets the kernel probe a powered-down PHY (link timeouts in dmesg). Skipping the ODMDATA token on a disable leaves BPMP holding the PHY hot. Agentic, not table-driven — no controller table, no questions.json. Every controller, lane width, schematic-routed receptacle, and authoritative DT node address is discovered at runtime from the docs + DTB + carrier pinmap. The output is a kernel-DT overlay commit only. Per-controller fragment@N blocks are appended to the composite custom overlay .dts per ../../references/bsp-customization-kernel-dtb.md and committed to the bspsources/ hardware repo. /jetson-build-source compiles the composite to .dtbo and owns its Makefile + flash-conf registration. This skill MUST NOT edit ODMDATA="...". All ODMDATA tokens (pcie@Nstatus=…, pcie@Nmax-link-speed, pcie@Npcie-mode, pcie@Nclk-scheme, pcie-cN-endpoint-enable, plus the uphyX-config-N surface tokens and UPHYCONFIG="" clear) are emitted by /jetson-customize-uphy in a single atomic commit on the carrier flash-conf fork. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills NVIDIA/jetson-customize-pcie