jetson-print-device-info
NVIDIA/skills
Erfasst einen Baseline-Snapshot des Modulmodells, der L4T-Version, des Kernels, der OS-Version und des Leistungsmodus eines Jetson-Geräts für Leistungstests oder Verifizierungen.
...Alle erweiternjetson-print-device-info
Gibt eine prägnante Zusammenfassung des Jetson-Geräts aus, auf dem diese Funktion ausgeführt wird.
Diese Funktion dient als Referenzbeispiel für das jetson-device-skills-Repository und die NVIDIA-weite CI-Pipeline für Funktionen. Sie wird auf dem Jetson-Zielsystem (nicht auf dem Host-PC) ausgeführt und führt eine schreibgeschützte Inspektion durch — nützlich als Baseline-Erfassung vor der Ausführung von Leistungstests.
Zweck
Erfassen einer Baseline-Snapshot der Software-Stacks und des Leistungsmodus eines Jetson-Zielsystems vor der Ausführung von Leistungs-, Regressionstests oder Kompatibilitätstests.
Wann verwenden
- Beim Starten eines Leistungstests, wenn eine erfasste Baseline des Software-Stacks und des Leistungsmodus des Geräts gewünscht ist.
- Zur Überprüfung, ob ein frisch geflashtes Jetson-Gerät einer erwarteten L4T-/JetPack-Version entspricht.
Voraussetzungen
- Ausführung auf einem Jetson-Zielsystem (nicht auf dem Host-PC).
- Standard-CLIs sind verfügbar:
tr,cat,uname,uptime,lsb_release(oder/etc/os-release). nvpmodelist für den Leistungsmodus verfügbar (optional — die Funktion fällt bei Fehlen auf eine alternative Methode zurück).
Eingaben
Keine. Die Funktion liest nur aus dem lokalen Jetson-Dateisystem und standardmäßigen CLIs.
Anweisungen
Führen Sie jeden Schritt in der angegebenen Reihenfolge aus und geben Sie die erfassten Werte in dem unter Ausgabeformat gezeigten Bericht aus.
Erfassen Sie das Modulmodell und validieren Sie, dass es sich um ein Jetson-Zielsystem handelt — andernfalls frühzeitig beenden:```
Device-Tree-Zeichenfolgen sind NULL-terminiert, daher NUL-Zeichen vor der Ausgabe entfernen.
model=$(tr -d '\0' /dev/null) case "$model" in Jetson) ;; *) echo "Nicht auf einem Jetson-Zielsystem ausgeführt (Modell: '${model:-unknown}')"; exit 1 ;; esac echo "$model"
Extrahieren Sie die L4T-Release-Kopfzeile — den Rest der Datei überspringen (lange Liste von Bibliotheks-SHAs):``` head -1 /etc/nv_tegra_release 2>/dev/null || echo "L4T-Release-Informationen nicht gefunden"
Äquivalent: grep -m1 '^# R' /etc/nv_tegra_release
Ausführen von
nvpmodel -qund Verknüpfen seiner beiden Ausgabezeilen (NV Power Mode: <name></name>und die Modusnummer) zu einer einzigen Zeile.paste -sdverwendet nur das erste Zeichen seines Trennzeichens, daher verwenden Sieawk, um den literalen/-Trenner einzufügen:``` nvpmodel -q 2>/dev/null | awk 'NR==1{a=$0; next} {print a" / "$0}' \ || echo "nvpmodel nicht verfügbar"Ausgeben der Kernel-Version und der Uptime:``` uname -r uptime -p
Ausgeben der OS-Version (bevorzugen Sie
lsb_release, fallen Sie auf/etc/os-releasezurück):``` lsb_release -ds 2>/dev/null || (. /etc/os-release && echo "$PRETTY_NAME") || echo "OS-Version nicht gefunden"
Ausgabeformat
Geben Sie einen kurzen Bericht mit diesen Abschnitten aus, wobei jeweils eine Zeile pro Abschnitt möglich ist:
Model: <device-tree>
L4T release: <release>
Power mode: <nvpmodel> / <mode>
Kernel: <uname>
Uptime: <uptime>
OS version: <lsb_release></lsb_release></uptime></uname></mode></nvpmodel></release></device-tree>Beispiele
Beispielausgabe auf einem Orin AGX-Entwicklerkit (L4T R36 / Ubuntu 22.04):
Model: NVIDIA Jetson AGX Orin Developer Kit
L4T release: # R36 (release), REVISION: 3.0
Power mode: NV Power Mode: MAXN / 0
Kernel: 5.15.136-tegra
Uptime: up 2 hours, 14 minutes
OS version: Ubuntu 22.04.4 LTS
Beispielausgabe auf einem AGX Thor (L4T R39 / Ubuntu 24.04):
Model: NVIDIA Jetson AGX Thor Developer Kit
L4T release: # R39 (release), REVISION: 0.0
Power mode: NV Power Mode: 120W / 1
Kernel: 6.8.0-tegra
Uptime: up 12 minutes
OS version: Ubuntu 24.04 LTS
Fehlerbehandlung
Jeder Befehl fällt auf eine klar beschriftete Zeichenfolge "... not found" / "... not available" zurück, wenn die zugrunde liegende Datei oder das Binärprogramm fehlt — die Funktion bricht den Bericht niemals ab. Wenn /proc/device-tree/model fehlt oder keine Jetson-Zeichenfolge enthält, wird frühzeitig mit einer klaren Meldung „Nicht auf einem Jetson-Zielsystem ausgeführt“ beendet.
Einschränkungen
- Nur schreibgeschützte Inspektion — erkennt keine GPU/CPU-Taktraten, thermischen Zustand oder stromversorgungsbezogene Leistungsdaten pro Rail.
- Das Ausgabeformat von
nvpmodelvariiert zwischen L4T-Versionen; die Funktion gibt es wortwörtlich aus, anstatt sie zu parsen.
Fehlerbehebung
- Fehler:
/proc/device-tree/model: No such file or directoryUrsache: Ausführung auf einem Host-PC, nicht auf einem Jetson-Zielsystem. Lösung: Führen Sie die Funktion direkt auf dem Jetson-Gerät aus (z. B. über SSH). - Fehler:
nvpmodel: command not foundUrsache: L4T-BSP nicht installiert oder Ausführung in einem minimalen Container ohnenvpmodel. Lösung: Erwartet auf Nicht-Jetson- oder abgespeckten Umgebungen — die Funktion gibt „nvpmodel not available“ aus und fährt fort.
Hinweise
- Nur lesend. Ändern Sie nicht den Leistungsmodus, installieren Sie keine Pakete oder ändern Sie keine Dateien.
- Wenn die Funktion versehentlich auf einem Host-PC aufgerufen wird, enthält
/proc/device-tree/modelkeine Jetson-Modellzeichenfolge — erkennen Sie dies und beenden Sie das Programm mit einer klaren Meldung, anstatt irreführende Informationen auszugeben.
---
name: jetson-print-device-info
description: Captures a baseline snapshot of a Jetson device's module model, L4T version, kernel, OS version, and power mode for performance testing or verification.
license: Apache-2.0
---
# jetson-print-device-info
Prints a concise summary of the Jetson device this skill runs on.
This skill is intended as a reference example for the `jetson-device-skills` repo and the NVIDIA-wide skills CI. It runs on the Jetson target (not the host PC) and performs read-only inspection — useful as a baseline capture before running performance tests.
## Purpose
Capture a baseline snapshot of a Jetson target's software stack and power mode before running performance, regression, or compatibility tests.
## When to use
- Starting a performance run and you want a captured baseline of the device's software stack and power mode.
- Verifying that a freshly flashed Jetson matches an expected L4T / JetPack version.
## Prerequisites
- Running on a Jetson target (not the host PC).
- Standard CLIs available: `tr`, `cat`, `uname`, `uptime`, `lsb_release` (or `/etc/os-release`).
- `nvpmodel` available for power mode (optional — skill falls back gracefully).
## Inputs
None. The skill reads only from the local Jetson filesystem and standard CLIs.
## Instructions
Run each step in order and print the captured values into the report shown under [Output format](#output-format).
1. **Capture** the module model and **validate** it is a Jetson target — exit early otherwise:
```bash
# Device-tree strings are null-terminated, so strip NULs before printing.
model=$(tr -d '\0' < /proc/device-tree/model 2>/dev/null)
case "$model" in
*Jetson*) ;;
*) echo "Not running on a Jetson target (model: '${model:-unknown}')"; exit 1 ;;
esac
echo "$model"
```
2. **Extract** the L4T release header line — skip the rest of the file (long list of library SHAs):
```bash
head -1 /etc/nv_tegra_release 2>/dev/null || echo "L4T release info not found"
# Equivalent: grep -m1 '^# R' /etc/nv_tegra_release
```
3. **Run** `nvpmodel -q` and **join** its two output lines (`NV Power Mode: <name>` and the mode number) onto one line. `paste -sd` only uses the first char of its delimiter, so use `awk` to insert the literal ` / ` separator:
```bash
nvpmodel -q 2>/dev/null | awk 'NR==1{a=$0; next} {print a" / "$0}' \
|| echo "nvpmodel not available"
```
4. **Print** the kernel version and uptime:
```bash
uname -r
uptime -p
```
5. **Print** the OS version (prefer `lsb_release`, fall back to `/etc/os-release`):
```bash
lsb_release -ds 2>/dev/null || (. /etc/os-release && echo "$PRETTY_NAME") || echo "OS version not found"
```
## Output format
Print a short report with these sections, one line each where possible:
```text
Model: <device-tree model string>
L4T release: <release header line>
Power mode: <nvpmodel name> / <mode number>
Kernel: <uname -r>
Uptime: <uptime -p>
OS version: <lsb_release / /etc/os-release output>
```
## Examples
Example output on an Orin AGX dev kit (L4T R36 / Ubuntu 22.04):
```text
Model: NVIDIA Jetson AGX Orin Developer Kit
L4T release: # R36 (release), REVISION: 3.0
Power mode: NV Power Mode: MAXN / 0
Kernel: 5.15.136-tegra
Uptime: up 2 hours, 14 minutes
OS version: Ubuntu 22.04.4 LTS
```
Example output on an AGX Thor (L4T R39 / Ubuntu 24.04):
```text
Model: NVIDIA Jetson AGX Thor Developer Kit
L4T release: # R39 (release), REVISION: 0.0
Power mode: NV Power Mode: 120W / 1
Kernel: 6.8.0-tegra
Uptime: up 12 minutes
OS version: Ubuntu 24.04 LTS
```
## Error handling
Each command falls back to a clearly labeled `"... not found"` / `"... not available"` string if the underlying file or binary is missing — the skill never errors out mid-report. If `/proc/device-tree/model` is missing or does not contain a Jetson string, exit early with a clear "not running on a Jetson target" message.
## Limitations
- Read-only inspection only — does not detect GPU/CPU clocks, thermal state, or per-rail power.
- `nvpmodel` output format varies between L4T versions; the skill prints it verbatim rather than parsing.
## Troubleshooting
- **Error:** `/proc/device-tree/model: No such file or directory`
**Cause:** Running on a host PC, not a Jetson target.
**Solution:** Run the skill on the Jetson device directly (e.g. via SSH).
- **Error:** `nvpmodel: command not found`
**Cause:** L4T BSP not installed, or running in a minimal container without `nvpmodel`.
**Solution:** Expected on non-Jetson or stripped environments — the skill prints `"nvpmodel not available"` and continues.
## Notes
- Read-only. Do not change power mode, install packages, or modify any files.
- If the skill is invoked on a host PC by mistake, `/proc/device-tree/model` will not contain a Jetson model string — detect that and exit with a clear message rather than printing misleading info.
Alle Dateien
5 Dateienjetson-print-device-info installieren
Laden Sie die Skill-Dateien herunter und extrahieren Sie diese in Ihr .claude/skills/-Verzeichnis.
ZIP herunterladenKlonen Sie das Repository und kopieren Sie die Skill-Dateien in Ihr Projekt.
git clone https://github.com/NVIDIA/skills/tree/main/skills/jetson-print-device-info # Copy SKILL.md to your .claude/skills/ directory
Kopieren





Heim
