Agent Skills
返回列表
🔒

Jetson 目标平台配置初始化

IT 运维与安全 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-02qudk26/jetson-init-target。

技能介绍

要解决什么问题

在 Jetson BSP 定制链里,下游技能(镜像解压、源码克隆、customize-* 等)都依赖一份当前活动的目标平台 YAML。若 target-platform/ 里还没有任何配置文件,或磁盘上缺少你要用的那一套,链会在「无活动目标」处直接停住。本技能负责新建这份配置:只写 reference_devkit: 与可选的 custom_carrier:,并视情况更新 active_target.yml 指针——不负责 bsp_image:、source:、documents:(由兄弟技能处理)。

技能如何工作

流程是线性的,数据源固定:

  • 启动时加载 platform_template.yaml 作字段模式;产品/烧录选项仅来自 bsp-platforms-catalogue.md 的映射表,不扫描 Linux_for_Tegra/*.conf。
  • 选参考产品:打印带稳定索引的完整目录,可按芯片系列快捷选第一行,或输入索引;必须选定一行才能继续。
  • 选烧录配置:默认 conf 为选项 1,变体后缀为 2..N;支持目录中的 (raw) 与 (same as …) 约定。
  • 可选自定义载板:在基线之上决定是否写入 custom_carrier:;字段按模板收集,客户元数据原样落盘,不臆造 SKU/板 ID。
  • 确认与写入:建议文件名来自产品短横线名或载板名;首份配置会自动设为 active;已有配置时询问是否激活新文件。切换已有文件请用 jetson-set-target。

支持 quick_start_prefill:当 active_platform 能唯一解析到目录行、或预填了载板意图时,可跳过重复提问。

边界与注意

  • 用户只想切换活动目标而非新建 → 应走 jetson-set-target,本技能会拒绝重编已有文件。
  • 目录里没有的产品需先维护 bsp-platforms-catalogue.md,技能内不会临时补列表。
  • 必填项填 NA 时配置仍可写入,但后续 customize-* 可能拒绝;可在设备上读 /proc/device-tree/chosen/ids 补全后重跑。
  • 写完后典型顺序:jetson-init-image → jetson-init-source →(可选)jetson-link-docs → jetson-generate-kb → 自定义载板还需 jetson-derive-carrier,再进入各类 customize-*。

使用场景

  • 首次搭建 Jetson 定制仓库时 `target-platform/` 为空,需从 BSP 目录选 DevKit 并生成首份活动目标 YAML
  • 客户自研载板基于某款 Orin/Nano DevKit,要在配置里写入 `custom_carrier` 再跑 derive-carrier
  • 同一仓库要维护 AGX Orin 与 Orin Nano 两套硬件,需新建第二份平台 YAML 供日后切换
  • 下游 `jetson-init-image` 因无活动目标失败且目录下尚无 `.yaml`,需先补目标平台文件

适合人员

  • 负责 Jetson 客户载板 bring-up 的嵌入式工程师,需先把参考 DevKit 与载板元数据落盘再进 customize 链
  • 维护多 SKU Jetson 产品线的 BSP 集成者,要为每块板子或变体单独建 `target-platform/*.yaml`
  • 用 quick_start 预填在 CI 或脚本里生成目标配置、减少交互提问的 DevOps/构建维护者
  • 现场调试已确认模块型号但仓库缺配置文件,需按目录索引快速写出可激活的平台 YAML 的 FAE