All skills
nvidia avatar

/jetson-customize-uphy

@87053a0
by NVIDIA Corporationnvidia/skills3.5k stars
424

Configure Jetson UPHY lane allocation (uphy0/uphy1-config) on Orin/Thor custom carriers. Do NOT use for pinmux or PCIe-only edits.

Use this Skill: https://skilld.dev/gh/nvidia/skills/jetson-customize-uphy

This session only. Nothing lands on disk.

referencesrun-state-sidecar.md

≈445 tokens on demand. Your agent reads this file only when SKILL.md points to it.

jetson-customize-uphy — Run-state JSON Sidecar

Persist Step-5 answers to a JSON sidecar at <workspace>/target-platform/<profile-stem>.jetson-customize-uphy.json (2-space indent):

{
  "generator": "jetson-customize-uphy",
  "generator_version": "0.0.2",
  "generated_at": "<ISO-8601 UTC>",
  "active_profile": "<profile-stem>.yaml",
  "bsp_version": "<bsp_image.version>",
  "uphy": {
    "config": "uphy0-config-<N>",
    "config_uphy1": "uphy1-config-<M>",
    "lane_assignments": [], "uphy1_lane_assignments": [],
    "carrier_routes_lanes": "yes|no|unknown",
    "warnings": [], "notes": [], "sources": []
  },
  "odmdata_tokens": [],
  "uphy_config_clear_required": false,
  "overlay": {
    "composite_dts_path": "", "composite_dtbo": "",
    "fragments_appended": [
      { "marker": "uphy:<class><id>", "target_path": "/bus@0/<node>",
        "status": "okay|disabled", "reason": "" }
    ],
    "skipped": false
  },
  "commit_shas": { "overlay_tracker": "", "bsp_sources": "" }
}

Fields not prompted (UPHY1 on Orin) -> null, not absent.

Idempotency

  1. Read prior sidecar; use prior config / config_uphy1 as the default selection (still ask — never auto-apply); surface prior generated_at.
  2. If new answer matches prior across config + config_uphy1 + carrier_routes_lanes byte-for-byte, skip Steps 6 + 7 and jump to Step 8 with (no change) headline.
  3. Any field differs -> rewrite the sidecar (don't merge), then proceed.
  4. On-disk markers (# custom-bsp: uphy in the conf, /* custom-bsp: uphy:<class><id> */ per fragment) are the authoritative idempotency mechanism — they survive sidecar deletion. JSON is a structured view for tooling.

Atomic write: tmp + rename. Never edit in place.

Source: SKILL.md on GitHub

1 warning3mo3 checks · Risk SAFE
  • Gen Agent Trust Hub3mo

    The skill is a specialized tool for configuring Jetson UPHY lane allocations on NVIDIA hardware. It performs legitimate Board Support Package (BSP) customization tasks by fetching documentation from official NVIDIA sources, decompiling device trees, and modifying configuration files. It includes robust error checking and mandatory user confirmation gates for critical operations.

  • Socket3mo

    No alerts

  • Snyk3mo

    Risk: MEDIUM · 2 issues

Signed by skilld at 87053a0. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 3 months ago
version
0.0.2
Other metadata
metadata
{
  "data-classification": "public",
  "author": "Jetson Team",
  "tags": [
    "bsp",
    "phase-2",
    "io",
    "uphy"
  ],
  "domain": "meta"
}

README badge

README badge for nvidia/skills/jetson-customize-uphy