Agent Skills
返回列表
🔒

Jetson BSP 镜像烧录

IT 运维与安全 更新于 2026.08.29

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

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

技能介绍

要解决什么问题

在 Jetson BSP 定制工作流里,叠加层已经通过 /jetson-promote-image 写进 bsp_image 之后,还需要把主机上的 Linux_for_Tegra/ 树真正推到 DUT 上。手工复制文档里的 flash.sh 命令容易混用错误的板级 .conf、错误的启动介质,或在 DUT 未进 RCM、EEPROM 与配置文件不一致时仍强行烧录——这类错误往往在烧录中途或首次启动才暴露。

技能如何工作

本技能是 BSP 叠加部署链中的烧录环节(/jetson-promote-image → /jetson-flash-image)。它从活动目标平台配置解析 bsp_image、每板烧录 .conf(custom_carrier.flash_config 优先于 reference_devkit.flash_config),并绑定 BOARD 名称供后续命令使用。

核心流程包括:

  • 解析与选工具:按芯片系列与启动介质在 flash.sh 与 l4t_initrd_flash.sh 之间选择;JETSON_FLASH_DEVICE 来自配置或交互选择。
  • 恢复模式:优先用树内 boardctl 将 DUT 置于 RCM;预检用 lsusb -d 0955: 验证 VID:PID(T23x 为 0955:7X23,T26x 为 0955:7026)。
  • 预检门控:检查 bsp_image 脚手架、kernel/Image 与 rootfs/boot/Image 字节一致、initrd 工件;RCM 下用 nvautoflash.sh --print_boardid 做 EEPROM 与配置文件交叉检查(真实非空不一致才拒绝,空 EEPROM 值有效)。
  • 决议确认:向用户展示将要烧录的计划(非原始 shell 粘贴),明确接受后才构建并执行烧录命令。

工件路径(DTB_FILE、BPFDTB_FILE、分区 XML、BCT 等)在烧录时由 flash.sh / l4t_initrd_flash.sh 根据 DUT EEPROM 的 board_sku / board_FAB 解析,而非在技能里静态预览。

适用边界与注意点

  • 不在范围内:BSP 定制、/jetson-promote-image 升级镜像、定制载板 .conf 生成(分别对应其它 jetson-* 技能)。
  • DUT 必须处于 RCM;USB 瞬态错误不会自动重试。
  • T26x / Thor 烧录成功后需额外 boardctl reset(或手动重新上电);T23x / Orin 通常由工具内部复位。
  • 拒绝用户提供的「粘贴此命令」绕过路径,以避免文档片段或错误参数进入生产烧录。

使用场景

  • `/jetson-promote-image` 已将定制内核与 rootfs 写入 `bsp_image` 后,要把同一套镜像烧进实验室里的 Orin/Thor 开发板做启动验证
  • 上次烧录后未改叠加层,只需对同一 DUT 做独立重新烧录,且需先确认 RCM 与 EEPROM 是否与活动配置文件一致
  • 定制载板已通过配置指向 `custom_carrier.flash_config`,主机 `Linux_for_Tegra/` 就绪,准备按 NVMe 或 eMMC 启动介质选对 `l4t_initrd_flash.sh` 或 `flash.sh`
  • 量产或小批量前,在主机侧完成 bsp_image 预检、默认用户暂存与决议确认,再执行烧录并处理 T26x 烧录后复位

适合人员

  • 维护 Jetson BSP 叠加工作流(init → promote → flash)的嵌入式平台工程师,需要标准化烧录而非手抄文档命令
  • 首次为定制载板对接 `Linux_for_Tegra` 烧录配置的硬件集成工程师,需解析 `.conf` 并避免 EEPROM 与目标配置不一致
  • 在产线或内网 CI 上反复对多块 Jetson 模块烧录同一 `bsp_image` 的制造/测试工程师,依赖预检门控减少误烧
  • 现场支持工程师在客户 DUT 上修复 promote 遗漏(如 Image/initrd 不一致)后,需按技能流程重新预检并烧录