jetson-print-device-info

jetson-print-device-info

このスキルが実行されている Jetson デバイスの概要を簡潔に表示します。

このスキルは、jetson-device-skills リポジトリおよび NVIDIA 全体のスキル CI 向けの参考例です。ホスト PC ではなく Jetson ターゲット上で実行され、読み取り専用の調査を行います。パフォーマンステストの実行前にベースラインを取得するのに役立ちます。

目的

パフォーマンス、リグレッション、互換性テストの実行前に、Jetson ターゲットのソフトウェアスタックと電力モードのベースラインスナップショットを取得します。

使用する場面

• パフォーマンス測定を開始する際に、デバイスのソフトウェアスタックと電力モードのベースラインを取得したい場合。
• 書き込んだばかりの Jetson が、想定される L4T／JetPack バージョンと一致することを確認する場合。

前提条件

• Jetson ターゲット上で実行されていること（ホスト PC ではないこと）。
• 標準的な CLI が利用可能であること：tr、cat、uname、uptime、lsb_release（または /etc/os-release）。
• 電力モードの確認に nvpmodel が利用可能であること（任意。利用できない場合もスキルは適切に代替処理します）。

入力

ありません。スキルはローカルの Jetson ファイルシステムと標準的な CLI のみを読み取ります。

手順

各ステップを順番に実行し、取得した値を出力形式に示すレポートに出力します。

1. モジュールのモデルを取得し、Jetson ターゲットであることを検証します。該当しない場合は早期に終了します：

   # 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. L4T リリースヘッダーの行を抽出します。ファイルの残りの部分（ライブラリ SHA の長い一覧）は読み飛ばします：

   head -1 /etc/nv_tegra_release 2>/dev/null || echo "L4T release info not found"
   # Equivalent: grep -m1 '^# R' /etc/nv_tegra_release
   

3. nvpmodel -q を実行し、出力される2行（NV Power Mode: <name> とモード番号）を1行に結合します。paste -sd が使用するのは区切り文字の先頭の1文字だけなので、awk を使用してリテラルの / 区切り文字を挿入します：

   nvpmodel -q 2>/dev/null | awk 'NR==1{a=$0; next} {print a" / "$0}' \
     || echo "nvpmodel not available"
   

4. カーネルバージョンと稼働時間を表示します：

   uname -r
   uptime -p
   

5. OS バージョンを表示します（lsb_release を優先し、利用できない場合は /etc/os-release にフォールバックします）：

   lsb_release -ds 2>/dev/null || (. /etc/os-release && echo "$PRETTY_NAME") || echo "OS version not found"
   

出力形式

可能な場合は各行に1項目ずつ、次のセクションを含む短いレポートを出力します：

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>

例

Orin AGX 開発者キットでの出力例（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

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

エラー処理

ファイルまたはバイナリが見つからない場合、各コマンドは明確にラベル付けされた "... not found"／"... not available" 文字列にフォールバックします。スキルがレポートの途中でエラーになることはありません。/proc/device-tree/model が存在しない場合、または Jetson を示す文字列が含まれていない場合は、明確な「Jetson ターゲット上で実行されていません」というメッセージを表示して早期に終了します。

制限事項

• 読み取り専用の調査のみを行います。GPU／CPU クロック、温度状態、レールごとの電力は検出しません。
• nvpmodel の出力形式は L4T のバージョンによって異なるため、解析せず、そのまま表示します。

トラブルシューティング

• エラー： /proc/device-tree/model: No such file or directory 原因： Jetson ターゲットではなく、ホスト PC 上で実行しています。 解決策： スキルを Jetson デバイス上で直接実行します（例：SSH 経由）。

• エラー： nvpmodel: command not found 原因： L4T BSP がインストールされていないか、nvpmodel のない最小構成のコンテナ内で実行しています。 解決策： Jetson 以外の環境や不要なものを削除した環境では想定される状態です。スキルは "nvpmodel not available" を表示して処理を続行します。

注意事項

• 読み取り専用です。電力モードの変更、パッケージのインストール、ファイルの変更は行わないでください。
• 誤ってホスト PC 上でスキルを実行した場合、/proc/device-tree/model に Jetson のモデルを示す文字列は含まれません。誤解を招く情報を表示するのではなく、この状態を検出して明確なメッセージを表示し、終了してください。