Dev & Engineering ✓ NVIDIA · Official

Jetson Thor MGBE/QSFP Configuration

Enable Jetson Thor 25G, 10G, or 1G MGBE network paths through a kernel device-tree overlay.

49/ 100
Use with care

Useful, but reliability, evidence or controls still have material gaps.

See how it was scored ↓
Works as-is in
Codex · Claude Code
Stars
★ 3.8k
Last updated
today
License
Apache-2.0
jetson-thordevice-treeethernetmgbe
+2kernel-overlaybsp-customization

What does this skill do, and when should you use it?

This skill configures MGBE controllers on custom Jetson Thor T264 carrier boards for QSFP, 10G, or 1G fiber paths. It uses BPMP allocation, PHY attachment details, pin information, and carrier documentation to configure controller status and PHY plumbing. It writes the result as a composite custom overlay in the bsp_sources hardware repository, while jetson-build-source owns compilation and registration. It does not allocate UPHY lanes or modify ODMDATA.

It validates the active target, carrier configuration, overlay tracker, and required documents; collects controller, PHY mode, attachment type, I²C, reset GPIO, and compatible-string details through a question flow; decompiles the BPMP DTB to determine the speed-token form; runs pin_verifier.py for MDC, MDIO, RESET, and INT checks; appends per-controller fragments to the composite overlay DTS; runs cpp, dtc, and fdtoverlay pre-flight checks; and writes a run-state JSON sidecar and summary. It reads workspace, source, BSP-image Linux_for_Tegra, and document paths, and writes to the target-platform and bsp_sources hardware directories.

Good fit
  • A Jetson Thor custom carrier connects a QSFP cage to an MGBE controller and needs 25G enabled.
  • A configured mgbe<N> reports DOWN or NO-CARRIER after cold boot.
  • An MGBE controller does not appear at all and its kernel device-tree or PHY wiring needs inspection.
  • jetson-customize-uphy has selected a UPHY configuration allocating the MGBE lanes, and the controller-side configuration is still required.

How do you install this skill?

Before you use it
  • Before execution, reconcile uphy1-config versus uphy0-config, jetson-customize-uphy versus legacy paths, and verify the actual locations of pin_verifier.py and the context document.
  • Add explicit user confirmation before committing the overlay and document a recoverable commit rollback plan; ensure the sidecar does not misleadingly record ODMDATA that this skill did not modify.
  • Recheck all hardware parameters against the actual BPMP/kernel DTBs, schematics, pinmap, DUT compatible strings, and PHY datasheet; the supplied documentation alone does not prove correctness.
Before you start
Your agent needs
  • Shell / CLI
  • Local filesystem
Install first
  • dtc
  • fdtoverlay
  • cpp
  • git

Install the individual skill with the NVIDIA/skills skills CLI: npx skills add nvidia/skills --skill jetson-customize-mgbe --yes. The CLI handles the installation destination; the supplied source does not specify a manual copy directory.

Generic route: install into Claude Code manually (macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/NVIDIA/skills.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/skills/jetson-customize-mgbe" ~/.claude/skills/
rm -rf "$tmp"

Generated from the source repository and skill path; it copies only this skill's folder. If the author's install steps above differ, follow those first. To scope it to one project, replace ~/.claude/skills with that project's .claude/skills.

How do you use this skill?

Try saying

Once installed, send your agent any of these to trigger it:

  • Enable 25G QSFP on MGBE0 for my custom Jetson Thor carrier
  • Configure the MGBE PHY mode and bring up a 10G fiber path.

In a prepared Jetson Thor BSP workspace, prompt the agent with wording such as “Enable 25G QSFP on MGBE0 for my custom Jetson Thor carrier” or “Configure the MGBE PHY mode and bring up a 10G fiber path.” Before running, provide an active profile, Linux_for_Tegra/.git, the carrier flash-configuration fork, the UPHY allocation result, and the Adaptation Guide, Module Design Guide, and SoC TRM. When custom_carrier is present, both the carrier schematic and pinmux XLS are required. The skill then gathers per-controller settings through its question flow.

What are this skill's strengths and limitations?

Pros
  • Produces kernel device-tree overlay fragments and leaves composite-overlay compilation to jetson-build-source.
  • Covers 25G, 10G, and 1G MGBE/QSFP or fiber paths with PHY-side checks.
  • Clearly excludes ODMDATA, UPHY allocation, flash-conf registration, and direct upstream-BSP edits.
  • Documents failure modes involving BPMP token grammar, MDIO cell properties, overlay compatibility, and pinmux mismatches.
Limitations
  • Focused on Jetson Thor T264 MGBE scenarios; it does not handle UPHY lane allocation, ODMDATA, or flash-conf registration.
  • It must refuse custom-carrier runs when the schematic or pinmux XLS is missing.
  • It requires dtc, fdtoverlay, cpp, git, and several prepared BSP workflow states.
  • The supplied material provides no test suite, platform-support matrix, or hardware-validation results.

How does this skill compare with similar options?

Side by side with related skills; every score comes from the same FSRS standard.

Skill FS score Stars Last updated License
Jetson Thor MGBE/QSFP Configuration this page ✓ NVIDIA · Official 49 · Use with care ★ 3.8k today Apache-2.0
Jetson PCIe Controller Customizer ✓ NVIDIA · Official 57 · Use with care ★ 3.8k today Apache-2.0
Jetson USB Port Customization ✓ NVIDIA · Official 55 · Use with care ★ 3.8k today Apache-2.0
Jetson Custom Carrier Derivation ✓ NVIDIA · Official 53 · Use with care ★ 3.8k today Apache-2.0
Jetson BSP Source Builder ✓ NVIDIA · Official 58 · Recommended ★ 3.8k today Apache-2.0

Unlike jetson-customize-uphy, this skill handles controller-side kernel device-tree and PHY configuration; jetson-customize-uphy owns lane allocation and the related ODMDATA commit. Pinmux mismatches are routed to jetson-customize-pinmux.

How did FollowSkills review this skill?

FollowSkills review · FSRS-2.0
Use with care
49/ 100 5-point scale 2.5 / 5
The upstream repository has new commits since this review. The score still applies to the reviewed revision shown and may not cover the latest changes.
1Trust16 / 25 · 3.2/5

The skill declares scoped file and shell permissions, public data classification, prohibition on ODMDATA and upstream-BSP edits, and confirmation for pin fixes, reducing overreach risk; however, it directly writes and commits to bsp_sources without explicit pre-commit confirmation or a complete rollback/recovery procedure, so points are deducted.

2Reliability7 / 20 · 1.8/5

The main workflow, prerequisites, preflight commands, failure conditions, and several troubleshooting cases are fairly concrete; however, referenced context files and scripts are not included in the supplied material, and questions.json contains inconsistent legacy names such as uphy0-config and /modify-uphy. Key-path execution therefore cannot be confirmed statically, and the score remains below the static ceiling.

3Adaptability10 / 15 · 3.3/5

The audience, Thor platform, QSFP/MGBE scenarios, and boundaries around UPHY, ODMDATA, and pinmux are clear, including non-fit cases; however, it is Thor-only, provides no Chinese-language interaction guidance, and gives limited broader trigger-boundary evidence. The core workflow depends on local BSPs, hardware schematics, and a DUT, not an overseas service.

4Convention7 / 15 · 2.3/5

The SKILL.md provides overview, triggers, procedure, gotchas, and references, with a recognizable version and team owner; however, Instructions, Examples, and FAQ sections are absent, as also noted by the benchmark, while license metadata says NOASSERTION and the skill card states CC-BY-4.0 plus Apache 2.0. No clear changelog or maintenance/update path is supplied.

5Effectiveness6 / 15 · 2.0/5

The material specifies question collection, DT-overlay fragments, preflight, commits, and downstream handoff, so it plausibly addresses the core configuration task; however, reported effectiveness is only about 43%–44%, and naming, path, and sidecar ODMDATA-field inconsistencies remain. Static evidence cannot establish directly usable output, so the score is conservative and capped.

6Verifiability3 / 10 · 1.5/5

The fixed-revision materials include a procedure, question schema, benchmark report, and concrete commands, providing some auditability; however, the benchmark is a small internal single-run result, and the supplied files lack the referenced scripts, CI, committed outputs, or independent corroboration. Key technical claims cannot be independently reproduced from the supplied evidence.

1 2 3 4 5 6

Open a dimension to read why it scored that way

Reviewed Jul 20, 2026 Reviewed revision 55f18499943e Review evidence[1][2][3][4][5][6][7][8][9][10]

Evidence confidence:Low — Mostly static review, author material or a limited demo; useful for discovery, not high-risk decisions.

See the full review method →

FAQ

Does it modify ODMDATA or UPHY settings?
No. UPHY lane allocation and all MGBE ODMDATA tokens belong to jetson-customize-uphy; this skill only records the BPMP DTB token-form inspection.
What documentation is required for a custom carrier?
The active profile, Adaptation Guide, Module Design Guide, and SoC TRM are required. With custom_carrier, both custom_carrier_schematic and custom_carrier_pinmux_xls are mandatory.
Does it edit the upstream BSP image?
No. Changes are placed in the overlay tracker and the bsp_sources hardware repository, following the pristine-plus-customization repository pattern.
Can it complete the whole flashing workflow by itself?
No. It creates and pre-flights the composite overlay. jetson-build-source owns compilation, the Makefile, and flash-conf registration; later flashing and validation belong to other Jetson BSP skills.

More skills from this repository

All from NVIDIA/skills

Dev & Engineering ✓ NVIDIA · Official

Jetson PCIe Controller Customizer

Configure per-controller PCIe state, lane width, and link speed on custom Jetson Thor or Orin carriers.

★ 3.8k FS 57 Use with care today
Dev & Engineering ✓ NVIDIA · Official

Jetson USB Port Customization

Safely enable, disable, or change Jetson USB port roles through a kernel device-tree overlay.

★ 3.8k FS 55 Use with care today
Dev & Engineering ✓ NVIDIA · Official

Jetson Custom Carrier Derivation

Derive a custom Jetson carrier-board fileset from a reference devkit and wire carrier differences through a device-tree overlay.

★ 3.8k FS 53 Use with care today
Dev & Engineering ✓ NVIDIA · Official

Jetson BSP Source Builder

Rebuild Jetson BSP device trees, kernels, and modules from source changes and produce a deployable artifact manifest.

★ 3.8k FS 58 Recommended today
Dev & Engineering ✓ NVIDIA · Official

Jetson BSP Quick Start

Choose a Jetson BSP customization path and hand validated intake answers to the right setup skills.

★ 3.8k FS 56 Use with care today
Dev & Engineering ✓ NVIDIA · Official

Jetson Fan Curve Customizer

Safely maintain nvfancontrol fan profiles and boot defaults in a Jetson BSP.

★ 3.8k FS 54 Use with care today
Automation & Ops ✓ NVIDIA · Official

Jetson nvpmodel Power Mode Customizer

Safely customize Jetson BSP power modes, frequency caps, and the boot-default profile.

★ 3.8k FS 54 Use with care today
Dev & Engineering ✓ NVIDIA · Official

Jetson Memory Optimizer

Reclaim unused DRAM on headless or no-camera Jetson deployments.

★ 3.8k FS 52 Use with care today
Dev & Engineering ✓ NVIDIA · Official

Jetson CSI Camera Customization

Generate and validate kernel device-tree overlays for MIPI and GMSL cameras on custom Jetson Thor or Orin carriers.

★ 3.8k FS 50 Use with care today
Automation & Ops ✓ NVIDIA · Official

Jetson BSP Image Promoter

Sync Jetson customization overlays and build artifacts into a flash-ready staged BSP image.

★ 3.8k FS 51 Use with care today
Dev & Engineering ✓ NVIDIA · Official

Jetson BSP Source Workspace Initializer

Prepares a tracked Jetson BSP source workspace and cross-compiler for downstream customization and builds.

★ 3.8k FS 58 Recommended today
Dev & Engineering ✓ NVIDIA · Official

Jetson BSP Image Validator

Validate a flashed Jetson BSP image on disk and on the target device.

★ 3.8k FS 50 Use with care today
Dev & Engineering ✓ NVIDIA · Official

Jetson BSP Info Check

Verify Jetson BSP version, board configs, and rootfs state before flashing.

★ 3.8k FS 59 Recommended today
Automation & Ops ✓ NVIDIA · Official

Jetson Device Info Snapshot

Capture a concise software, kernel, OS, and power-mode baseline from a running Jetson target.

★ 3.8k FS 58 Recommended today
Dev & Engineering ✓ NVIDIA · Official

Jetson Target Platform Initializer

Create a Jetson target-platform profile for a reference devkit or custom carrier and update the active pointer.

★ 3.8k FS 57 Use with care today
Dev & Engineering ✓ NVIDIA · Official

Jetson BSP Image Flasher

Safely flash a promoted Jetson BSP image onto a Jetson device in RCM mode.

★ 3.8k FS 56 Use with care today
Dev & Engineering ✓ NVIDIA · Official

Jetson Target Knowledge Base Generator

Scans a Jetson BSP and source tree to create a target-specific knowledge snapshot.

★ 3.8k FS 54 Use with care today
Automation & Ops ✓ NVIDIA · Official

Jetson BSP Image Initializer

Prepares a Jetson BSP image, applies binaries, and records its verified version.

★ 3.8k FS 52 Use with care today
Dev & Engineering ✓ NVIDIA · Official

Jetson Document Binder

Registers staged Jetson reference documents in the active target profile.

★ 3.8k FS 52 Use with care today
Dev & Engineering ✓ NVIDIA · Official

Jetson Pinmux Customizer

Generate Jetson carrier pinmux BCT configuration from an XLSM.

★ 3.8k FS 51 Use with care today

Related skills