
名称	jetson-flash-image
描述	该技能通过 flash.sh 或 l4t_initrd_flash.sh，将处于 RCM 模式的 Jetson DUT 烧录已提升的 BSP 镜像。不适用于 BSP 定制、镜像提升或载板衍生。
版本	0.0.1
开源协议	“Apache-2.0” metadata: data-classification: public
作者	“Jetson Team” tags: - bsp - flash domain: meta

烧录 BSP 镜像

目的

该技能用于将已提升（promoted）的 bsp_image 通过 NVIDIA 烧录工具链（flash.sh 或 l4t_initrd_flash.sh）烧录到处于 RCM 模式的 Jetson DUT。它是 BSP overlay 部署链中的烧录环节，由镜像提升技能（/jetson-promote-image）驱动。不处理 BSP 定制、镜像提升或载板派生。

前提条件

已解析的目标 profile 且 bsp_image: 存在。
Linux_for_Tegra/ 已运行 apply_binaries.sh。
每板 .conf 可通过优先级解析到 custom_carrier.flash_config 或 reference_devkit.flash_config。
DUT 已连接并可通过 boardctl 或手动按钮进入 RCM。

指令

解析活动 profile，确认 bsp_image 与 flash conf。
绑定 <board>，并确定 <boot-dev> 和流程工具（flash.sh 或 l4t_initrd_flash.sh，按芯片家族选择）。
使 DUT 进入 RCM（推荐 boardctl，参考文档）。
执行预检查：BSP 就绪性、设备是否在 RCM、EEPROM 与 profile 交叉校验、默认用户配置。
向用户打印待执行方案并要求确认，然后调用烧录命令。
对于 T26x/Thor，烧录后需手动执行 <boardctl> -t <target> reset，T23x/Orin 则自动重启。

不变项（设计原则）

主机侧 flash 变量从 profile / 树内 BSP 解析。
产物路径由烧录工具在运行时从 DUT EEPROM 解析。
EEPROM 是权威，空值有效，真实非空不一致会拒绝。
必须通过用户确认。

限制

DUT 必须处于 RCM。
产物路径在烧录时通过 EEPROM 解析。
禁止使用用户粘贴的原始命令。
T26x 需要显式烧录后重置。

故障排查

参考完整文档中的表格，包括 RCM 未进入、EEPROM 不匹配、conf 缺失、boardctl 失败、T26x 无自动重启、默认用户未配置等。

参考

references/recovery-mode-boardctl.md
references/eeprom-cross-check.md
references/default-user-staging.md
上下文文档等。