jetson-quick-start

クイックスタート — BSP カスタマイズのエントリーポイント

jetson-quick-start はディスパッチャー兼インテークフォームです。ソースのダウンロード、展開、実体化、ドキュメントの紐付け、キャリアファイルの派生は行いません。セットアップの経路を選び、基本的な回答を収集してから、実際の作業を担当するスキルにその回答を引き渡します。

モード

セットアップモードを別のプロンプトで尋ねないでください。コアクイックスタートの質問票の最初の項目に含め、選択肢を次の固定順で表示してください。

1. Auto Setup
2. Guided Setup
3. Use Existing Workspace

cancel はセットアップモードではなく、終了アクションとして別に提示してください。

モード	使用する場面	予定されるスキル
Auto Setup	新規ワークスペースで、ネットワークが利用可能な場合	ターゲット設定、/jetson-download-bsp、/jetson-init-image、/jetson-init-source、/jetson-link-docs、/jetson-generate-kb、オプションの /jetson-derive-carrier
Guided Setup	ユーザーがすでにパス、リポジトリ、またはアーカイブを持っている場合	ターゲット設定、/jetson-init-image、/jetson-init-source、/jetson-link-docs、/jetson-generate-kb、オプションの /jetson-derive-carrier
Use Existing Workspace	BSP イメージ、ソースツリー、ドキュメントがすでに準備されている場合	ターゲット設定、ワークスペースの検証、/jetson-generate-kb、オプションの /jetson-derive-carrier。前提条件が不足している場合のみ、初期化スキルに振り分けます

ターゲット設定とは、アクティブなプロファイルを維持するか、/jetson-set-target で切り替えるか、/jetson-init-target で作成することです。

手順

免責事項の表示

コア質問票を開いたりセットアップ入力を確認したりする前に、この免責事項ブロックを正確に1回表示してください。

================================================================================
DISCLAIMER
These skills help automate Jetson BSP setup and customization, but they do not
replace NVIDIA official documentation or engineering review. Review generated
plans, commands, diffs, and commit messages before accepting them.

Flashing can erase device storage or leave a target temporarily unbootable.
Keep backups and verify the active target, BSP release, and hardware setup
before deploy steps.
================================================================================

免責事項への同意ゲート

免責事項を表示した直後に、免責事項についての質問が1つだけある独立した AskUserQuestions フォームを開き、ユーザーが回答を送信するまで待ってください。それ以外のことは行わないでください。プレーンテキストのチャット返信、推定されたデフォルト、以前の実行状態、アクティブなプロファイル、キャッシュされた回答、その他の非 UI シグナルによって免責事項への同意を収集しないでください。

フォームには、次の質問を1つだけ含めてください。

1. accept_disclaimer — プロンプト：「免責事項に同意して、クイックスタートを続行しますか？」選択肢：accept_disclaimer および cancel。

送信された accept_disclaimer の選択肢のみを同意として扱ってください。免責事項フォームはコア質問票とは別であり、ルーティングに不可欠な4つのコア質問のいずれにも代わるものではありません。

フォームを開けない、利用できない、キャンセルされた、送信された回答セットが返されない、または accept_disclaimer 以外の回答が返された場合は、直ちに停止し、AskUserQuestions を通じて免責事項に同意するまでクイックスタートを続行できないことを報告してください。

必須質問票ゲート

免責事項への同意後、jetson-quick-start はコアの AskUserQuestions 質問票を必ず開き、セットアップのディスパッチを行う前に、ユーザーが回答を送信するまで待たなければなりません。質問票を開けない、利用できない、キャンセルされた、または送信された回答セットが返されない場合は、直ちに停止し、質問票なしではクイックスタートを続行できないことを報告してください。

既存のアクティブなプロファイル、ワークスペースの状態、tarball の名前、キャッシュされた回答、リリースの互換性、または「明らかな」デフォルトを使って続行しないでください。このゲートで mode の回答と正規化された quick_start_prefill が送信されるまで、下流のスキルを呼び出さないでください。

プラットフォームの状態を確認する

target-platform/active_target.yml と既存の target-platform/*.yaml プロファイルを確認します。有効なプロファイルがある場合は、 reference_devkit.name、任意の custom_carrier.name、有効な flash_config を表示します。tarball、リポジトリ名、 ドキュメントのタイトルからプラットフォームの識別情報を推測しないでください。

../../references/bsp-platforms-catalogue.md を読み、製品／チップ／SKU／フラッシュ設定の表にあるすべての行を解析します。 このカタログを active_platform 質問リストの全項目の情報源とします。リストが不完全な場合は、カタログを更新してください。 quick-start 内のプラットフォームリストを重複させたり、修正したりしないでください。quick-start の 前処理中に jetson-init-target/SKILL.md を読んだり、init-target フローを実行したりしないでください。後続のターゲット作成は引き続き jetson-init-target が担当します。

コアの質問票をすばやく表示できるよう、この調査は軽量に保ちます。 ターゲットプロファイルの参照情報と要約を読み、必要に応じて低コストのパス存在確認を行い、 bsp_release の選択肢を作成するために必要な、公式アーカイブの軽量な Jetson Linux リリースメタデータのみを取得します。 選択されたプラットフォームに一致すると思われるセクションだけでなく、現行リリースのすべてのセクションを解析します。 コア質問票をユーザーが送信する前に、大規模な BSP／ソース／ドキュメントのツリーをスキャンしたり、 アーカイブを調査したり、KB コンテンツを生成したり、セットアップツールを実行したりしないでください。 3 つすべてのモードについて、考えられるプランを準備します。実際に後続で使用するプランは、 フォームの送信後にのみ選択します。

プラットフォーム参照リストを表示する

AskUserQuestions UI を開く前に、今回の実行で使用する安定した数値インデックスを付けて、 bsp-platforms-catalogue.md から解析したプラットフォームの全リストを表示します。

Available platforms:
T234 - Orin
  1. Jetson AGX Orin 64GB | CVM P3701-0005 | CVB P3737-0000 | jetson-agx-orin-devkit.conf
  ...
T264 - Thor
  N. Jetson AGX Thor T5000 | CVM P3834-0008 | CVB P4071-0000 | jetson-agx-thor-devkit.conf

これらのインデックスは、直後の質問票でのみ使用してください。 有効なプロファイルがある場合や、明らかに該当する項目が 1 つしかない場合でも、インデックスを自動選択しないでください。

コア質問票を表示する

AskUserQuestions UI を使用して、セットアップ全体に対するクリック選択式のコア質問票を 1 つ生成します。 quick-start の回答を、通常のテキストプロンプト、チャット内の質問、推測したデフォルト値、 手動での要約確認によって収集しないでください。

これは必須のゲートです。省略したり、プロファイルが 1 つだけの場合の簡略化を使ったり、 active_target.yml、ファイル名、tarball、リポジトリ名、 リリースの互換性、ワークスペースの状態、キャッシュされた回答、過去の実行結果に基づいて、 mode、active_platform、bsp_release、custom_carrier を自動選択したりしないでください。 既存の有効なプロファイルを選択肢として表示することはできますが、 ユーザーが AskUserQuestions フォームを送信するまでは選択されません。

AskUserQuestions で質問できるのは最大 4 つなので、コアフォームには ルーティングに不可欠な項目のみを含めてください。

1. mode — Auto Setup、Guided Setup、Use Existing Workspace、または cancel。
2. active_platform — 出力された完全なプラットフォーム一覧を使用し、 以下のアクティブプラットフォームに関する質問ルールに従ってください。
3. bsp_release — 今回の実行のために公式 Jetson Linux アーカイブから生成された、 最近のグローバルな具体的リリース候補のショートカットを、ドット区切りの 数値順で新しい順に並べたもの、および skip。各公式リリーストークンは 記載どおりに正確に保持してください。具体的なトークンは 38.2、38.2.1、 38.4、R36.4.4 のように 2 つまたは 3 つの数値コンポーネントを持つ 場合があります。38.2 を 38.2.0 に正規化しないでください。また、 欠落しているパッチコンポーネントを推測しないでください。候補を ハードコードしたりキャッシュしたりしないでください。メタデータの取得が 遅い場合や失敗した場合でも、skip と入力可能な具体的なリリース オプションを表示してください。クイックスタートではこのリストを プラットフォームでフィルタリングしないでください。アーカイブで見つかった 現在の各メジャーリリーズラインから、少なくとも最新の具体的な行を含めて ください。解析でメジャーリリースラインが 1 つしか返されない場合は、 リリースリストが不完全であるとして扱い、部分的な候補リストを表示する 代わりに skip と手入力にフォールバックしてください。
4. custom_carrier — 選択された/アクティブなプロファイルにすでにカスタム キャリアがある場合は、keep_existing_custom_carrier、 no_custom_carrier、add_custom_carrier、および skip を提示します。 それ以外の場合は、no_custom_carrier、add_custom_carrier、および skip を提示します。

ユーザーはこの AskUserQuestions フォームを一度送信します。その送信後に はじめて、mode、アクティブプラットフォーム、BSP リリース、および カスタムキャリアの意図によって、どの下流のスキルを実行するか、どの 事前入力された回答を消費するか、または無視するかが決まります。送信された フォーム結果がない場合は停止してください。推測された回答で続行しないで ください。add_custom_carrier はルーティングの意図にすぎません。 キャリア名、ID、SKU、リビジョン、およびカスタムフラッシュ設定は下流が 所有したままです。

共有の User input prompt style を使用してフォームをレンダリングし、送信された UI の回答を quick_start_prefill に正規化してください。共有の quick_start_prefill contract に従ってください。 アクティブプラットフォームの質問ルール:

• アンケートの前に、インデックス付きの完全なプラットフォーム一覧を 出力してください。
• 明示的な選択肢は、各チップファミリーグループの最初の行のみであり、 完全な一覧のインデックスと製品名をラベルとして付けます。たとえば Index 1 — Jetson AGX Orin 64GB のようになります。
• その他すべてのプラットフォームでは、ユーザーは Type something を 選択し、出力された一覧から数値インデックスを入力します。 Type something は、ツールに組み込まれた自由入力行でなければならず、 カスタムの明示的な選択肢ではありません。
• プロンプトテキスト: 「Pick a platform shortcut, or choose Type something and enter the numeric index from the full platform list printed above. Type skip to skip platform selection and let downstream setup ask later.」
• 明示的な選択肢にできるのはプラットフォームのショートカットのみです。 skip、Other、またはカスタムの手入力選択肢を追加しないでください。 skip は組み込みの Type something 経路で入力する必要があります。 プロンプトテキストで Type something を Other と言い換えないで ください。
• ここでフラッシュ設定のバリアントを解決しないでください。選択された カタログ行を jetson-init-target に渡してください。検証とフラッシュ設定の 選択は jetson-init-target が所有します。

skip 以外の各回答は明示的であり、所有する下流のスキルが直接消費できる ものでなければなりません。不明なものには skip を使用してください。 BSP リリースの回答は、省略可能な先頭の R と 2 つまたは 3 つの数値 コンポーネントを持つ具体的なバージョントークンでなければなりません （たとえば R38.4、38.2、38.2.1、または 36.4.4）。R38.x や 「後でバージョンを固定する」といったファミリーのプレースホルダーは 受け入れられません。代わりに skip を使用してください。 quick_start_prefill.download.bsp_release を渡す際は、ユーザー/ソースの トークンを正確に保持してください。 画像パス、ソースパス、ドキュメントパス、キャリアの詳細、リポジトリの オーバーライド、ツールチェーンの選択、およびドキュメントのバインディングは、中核的でないセットアップの 詳細です。これらは所有する下流のスキルに任せてください。下流のセットアップ スキルは、安全な場合は尋ねずに文書化されたデフォルトを使用し、競合、上書き、互換性のないリリース、欠落したアーティファクト、 またはユーザーが要求したオーバーライドの場合にのみ尋ねるべきです。

自動セットアップでは、/jetson-download-bsp が選択されたプラットフォームでサポートされる BSP リリースの一覧表示と、プラットフォーム/BSP の非互換性に関する警告を担当します。 クイックスタートは、要求されたグローバル候補または型指定されたリリースを転送できますが、 サポートを検証したり、互換性の判断を自ら上書きしたりはしません。

ビルドプリフィルバンドル

明示的な非 skip の回答のみを正規化し、メモリ内に保持します。

quick_start_prefill:
  mode: Auto Setup | Guided Setup | Use Existing Workspace
  target: { active_platform, custom_carrier }
  download: { bsp_release }

スキップされたフィールドは省略し、中核的な回答がないオーナーサブセットも省略します。検証は、 空白の mode や BSP プレースホルダーなど、明らかな誤ったルーティングを避けるのに必要な 最小限にとどめます。下流のデフォルトはスキルの動作であり、プリフィルフィールドではありません。 欠落した識別子の値を勝手に作成せず、クイックスタートからプロファイルブロックを書き込みません。

下流スキルの呼び出し

quick_start_prefill.mode、ターゲット状態、 および前提条件チェックから下流プランを構築します。下流スキルを呼び出す前に、 選択された mode、ターゲットプラットフォームの意図、要求された BSP リリースまたは下流のリリース選択の ハンドオフ、カスタムキャリアの意図、順序付けられた下流スキルの計画、および下流スキルがまだ尋ねる可能性のある 中核的でない詳細を含む、非ブロッキングの実行プラン概要を出力します。この概要の承認を求めてはいけません。 ユーザーが中核的なアンケートで cancel を選択しない限り、ディスパッチを続行します。これは下流のブロッキング 検証ゲートをバイパスするものではありません。

各下流スキルに、関連する quick_start_prefill サブセットと トップレベルの mode を渡します。 下流スキルは、有効なプリフィル済みの回答を使用し、欠落、無効、曖昧、または互換性のない必須入力については再度尋ね、そのプロファイルブロックの変更を自ら所有する必要があります: reference_devkit:、custom_carrier:、 bsp_image:、source:、または documents:。

Use Existing Workspace の場合、次を検証します:

• <bsp_image.root_path or workspace/Image>/Linux_for_Tegra/ が存在すること。
• Linux_for_Tegra/rootfs/etc/nv_tegra_release が存在し、 apply_binaries.sh が実行されたことを証明すること。そうでない場合は /jetson-init-image にルーティングします。
• <source.root_path or workspace/Source>/Linux_for_Tegra/ が存在し、 git リポジトリであること。
• 記録された documents: パスが存在する場合は存在すること。

最後に、実行されたスキル、スキップされたスキル、残っている下流の質問、 およびワークスペースが customize-* の準備ができているかどうかを示して終了します。

次の I/O カスタマイズ手順の提案

ディスパッチの概要を表示した後、アクティブなプロファイルの documents: ブロックで /jetson-link-docs を通じてキャリアボード関連のスロットが 1 つ以上紐付けられている場合にのみ、ブロッキングしない「次の手順 — I/O カスタマイズ」リストを表示します。該当するスロットは次のとおりです。

• documents.carrier_board_spec
• documents.carrier_schematic
• documents.ref_devkit_pinmux_xls
• documents.custom_carrier_schematic
• documents.custom_carrier_pinmux_xls

該当するスロットが 1 つも紐付けられていない場合は、この手順を省略します。 ユーザーは、これらのスキルが必要とするキャリアボードのファイルをまだ 提供していません。その場合の適切な次の手順は、カスタマイズスキルではなく /jetson-link-docs です。次の一文で伝えて、終了します。 （「キャリアボードのドキュメントが紐付けられていません。I/O カスタマイズの前に /jetson-link-docs を実行して、キャリア回路図／ピンマックスの xlsx を登録してください」）

該当するスロットが 1 つ以上紐付けられている場合は、次のリストを表示します。 ボードを搭載済み周辺機器に適合させる作業は、通常、ピンマックスと UPHY から 始め、その後コントローラーごとに分岐します。

• /jetson-customize-pinmux — ピンごとの SFIO／方向／プル状態 （documents.custom_carrier_pinmux_xls または documents.ref_devkit_pinmux_xls を使用します）。
• /jetson-customize-uphy — ODMDATA による UPHY レーン割り当て （documents.module_design_guide と documents.custom_carrier_schematic／documents.carrier_schematic を使用します）。
• /jetson-customize-pcie — コントローラーごとの PCIe 配線 （documents.module_design_guide、 documents.custom_carrier_schematic／documents.carrier_schematic、 および documents.custom_carrier_pinmux_xls／ documents.ref_devkit_pinmux_xls を使用します）。
• /jetson-customize-usb — USB2／USB3 SS ポートの有効化／無効化 （documents.module_design_guide、 documents.custom_carrier_schematic／documents.carrier_schematic、 および documents.custom_carrier_pinmux_xls／ documents.ref_devkit_pinmux_xls を使用します）。
• /jetson-customize-mgbe — マルチギガビットイーサネット PHY の配線 （documents.module_design_guide、 documents.custom_carrier_schematic／documents.carrier_schematic、 および documents.custom_carrier_pinmux_xls／ documents.ref_devkit_pinmux_xls を使用します）。
• /jetson-customize-camera — CSI／MIPI／GMSL センサーの立ち上げ （documents.module_design_guide と documents.custom_carrier_schematic／documents.carrier_schematic を使用します）。

提案するスキルごとに、必須の documents.* スロットがまだ紐付けられて いない場合は、そのスキルを非表示にするのではなく、「まず /jetson-link-docs を実行して を紐付けてください」と示します。 ユーザーが紐付けを修正して再試行する場合があるためです。 ここでは customize-* スキルを実行しないでください。クイックスタートは 提案までで終了します。

目的

ルーティングに不可欠な 4 つの回答（mode、active_platform、 bsp_release、custom_carrier）を収集し、適切な後続のセットアップスキルに 振り分ける単一のエントリーポイントです。すべてを一括で行うインストーラーでは ありません。単独でダウンロード、展開、マテリアライズ、紐付けを行うことはありません。

前提条件

• bsp-platforms-catalogue.md にアクセスできること（プラットフォームの リスト作成に使用します）。
• ディスクレーマーの AskUserQuestions フォームから accept_disclaimer の回答が送信済みであること。
• AskUserQuestions UI が利用可能であること。送信済みのディスクレーマーと コア質問票のフォームがなければ、クイックスタートは続行しません。
• ネットワークアクセスが必要なのは Auto Setup 分岐のみです （実際に取得を行うのは /jetson-download-bsp です）。

制限事項

• コア質問は最大 4 つです。コア以外の値（イメージパス、ソースパス、 ドキュメントパス、キャリア ID、ツールチェーン）は、それぞれを担当する 後続スキルに委ねられます。
• プラットフォームと BSP リリースの互換性は検証しません。これは /jetson-download-bsp の役割です。
• target-platform/*.yaml には書き込みません。プロファイルの変更は /jetson-init-target、/jetson-init-image などが行います。

トラブルシューティング

• 「questionnaire cancelled」で終了する — フォームを送信する必要があります。/jetson-quick-start を再実行し、4 つの質問に回答してください。
• 「disclaimer not accepted」で終了する — /jetson-quick-start を再実行し、免責事項を読んでから、続行する準備ができたら免責事項フォームで accept_disclaimer を選択してください。
• アクティブなプロファイルが自動選択されない — これは仕様です。一致するプロファイルが 1 つだけの場合でも、フォームで明示的に選択する必要があります。
• 不明な bsp_release が入力された — そのまま渡してください。/jetson-download-bsp が公式アーカイブに照らしてリリースを検証します。

注意点

• コア質問票は 1 回だけ尋ねてください。後続のスキルでは、コア以外の値、空欄、無効な値、不明確な選択肢について確認します。
• ユーザーから保存を求められない限り、quick_start_prefill はメモリ内に保持してください。
• ここでは NVIDIA アーティファクトの URL を決して組み立てないでください。/jetson-download-bsp は、選択された Jetson Linux アーカイブのリリースからリンクをたどります。
• platform_template.yaml には、ユーザーガイド／リリースノート用の項目がありません。これらのファイルや URL は最終的な要約または KB に保存し、プロフィールの項目として勝手に追加しないでください。

参考資料

• ../../context/bsp-customization-workflow.md
• ../../references/bsp-platforms-catalogue.md
• ../../references/platform_template.yaml
• ../jetson-download-bsp/SKILL.md
• Jetson Linux アーカイブ：https://developer.nvidia.com/embedded/jetson-linux-archive