Jetson BSP 镜像刷写
将已提升的 Jetson BSP 镜像安全刷入处于 RCM 模式的设备。
技能要求主机侧预检、RCM检测、EEPROM交叉核对,并在刷写前展示解析结果要求用户明确确认;使用仓库内boardctl并拒绝任意命令,体现了范围控制和外部影响意识。扣分原因是刷写本身会改写设备且使用sudo,没有备份、回滚或失败后的恢复方案;默认用户选项包含公开的ubuntu/ubuntu和nvidia/nvidia凭据,敏感凭据处理不足;数据流和日志持久化边界也未充分说明。
步骤顺序、拒绝条件、T23x/T26x分支、错误反馈和不自动重试规则较完整,静态阅读显示快乐路径合理。扣分原因是依赖外部BSP工具、板卡配置、EEPROM格式和未提供的上下文契约,未见覆盖关键路径的可执行测试;静态校准将分数限制在10分以内。
名称、触发场景、前置条件和明确的非适用范围均有说明,支持Orin和Thor的主要刷写流。扣分原因是仅适用于特定Jetson BSP、RCM硬件和目标平台配置;对主机环境、权限、网络可达性及中文交互没有说明,触发边界仍依赖其他技能和上下文文件。
SKILL.md具有清晰的目的、前置条件、分步流程、限制、故障排查和参考资料;版本、Apache-2.0许可、Jetson Team作者及NVIDIA维护背景可见。扣分原因是缺少Examples章节,基准报告还指出作者格式不符合规范;没有明确变更日志、维护承诺或更新路径,且依赖的共享上下文不在本次目标文件中。
技能直接覆盖从profile解析、预检、确认、刷写到复位和总结的核心任务,并提供可操作的命令形状和故障处理;提交的内部评估报告显示两项正向任务通过。扣分原因是评估样本很小、无负向任务,且静态审查不能验证实际刷写成功、输出完整性或相对手工操作的收益;按静态校准不超过7分。
文档提供了具体命令、检查条件、EEPROM映射、示例输出、评估文件和提交的基准报告,具备一定审计线索。扣分原因是没有本次审查可独立复现的执行记录、真实CI或关键路径测试套件;基准报告属于项目内部材料,静态校准不超过5分。
- 刷写是高影响、可能不可逆的设备写入操作;确认前应核实目标设备、启动介质、镜像和备份/恢复方案。
- 默认用户选项包含公开凭据,生产环境不应直接使用;自定义密码可能出现在命令行或日志中。
- 该评估未执行命令,未验证不同Jetson型号、BSP版本、EEPROM值或主机环境下的实际成功率。
- 依赖的target-platform契约及其他技能必须与当前版本一致,否则可能导致错误路由或预检失败。
这个 Skill 能做什么,适合哪些场景?
该技能用于通过 NVIDIA Linux_for_Tegra 工具链,将已提升的 BSP 镜像刷入 Jetson DUT。它会解析目标配置、板级 flash 配置、启动设备和刷写工具,并在刷写前检查主机文件、RCM 状态及 EEPROM 与配置文件的一致性。用户必须明确确认解析后的刷写计划后,技能才会执行命令。它不负责 BSP 定制、镜像提升或自定义载板配置生成。
读取活动目标平台配置、bsp_image、板级 flash 配置和 Linux_for_Tegra 文件;检查 BSP 目录、rootfs、内核镜像、initramfs 及 NVIDIA 标记文件;使用 boardctl 或人工按钮流程使 DUT 进入 RCM;运行 lsusb 验证恢复设备;通过 sudo ./nvautoflash.sh --print_boardid 读取 EEPROM 的 board_sku 和 board_FAB,并与配置交叉核对;按芯片家族和启动介质选择 flash.sh 或 l4t_initrd_flash.sh;必要时运行 l4t_create_default_user.sh;执行刷写并在 T26x/Thor 上执行 boardctl reset;报告命令、退出码和日志位置。
- Jetson BSP 镜像已由提升流程生成,工程师需要将其刷入处于 RCM 模式的参考开发板。
- Jetson 设备需要在未改变镜像内容的情况下重新刷写。
- 部署前需要核对 DUT EEPROM 的 SKU/FAB 与活动目标配置,避免刷入错误目标。
- T26x/Thor 设备刷写完成后需要额外复位并退出恢复模式。
这个 Skill 有哪些优点和局限?
- 在刷写前核对 BSP 文件、RCM 状态及 EEPROM 与配置的真实非空冲突。
- 根据芯片家族和启动介质选择 flash.sh 或 l4t_initrd_flash.sh。
- 要求用户确认解析后的目标、启动设备和刷写流程,避免直接粘贴原始命令。
- 明确处理 T23x/Orin 与 T26x/Thor 的复位差异。
- 只能刷写已提升的 BSP 镜像,不负责 BSP 定制、镜像提升或载板配置生成。
- 要求 DUT 通过恢复 USB 通道进入 RCM,且主机具备 Linux_for_Tegra 工具链及相关命令。
- USB 瞬时错误不会自动重试,需要重新进入 RCM 后再次调用。
- 提供的材料没有给出完整的受支持 BSP 版本矩阵或独立测试套件证据。
如何安装这个 Skill?
使用 NVIDIA 技能集合提供的 CLI 安装:
npx skills add nvidia/skills --skill jetson-flash-image --yes
CLI 会提示选择安装目标。无需手动克隆仓库或复制技能目录。该技能目录应由兼容 Agent Skills 的客户端加载。
如何使用这个 Skill?
向已加载该技能的代理提出 Jetson BSP 刷写请求,例如:“将已提升的 bsp_image 刷写到处于 RCM 模式的 Jetson DUT。”使用前必须具备活动目标平台配置、有效的 Linux_for_Tegra、已运行 apply_binaries.sh 的 BSP、可解析的板级 .conf,以及连接主机并能进入 RCM 的 DUT。技能会先完成主机和设备预检,打印解析计划并等待明确确认,然后构造并执行 flash.sh 或 l4t_initrd_flash.sh。具体目标配置格式和 boardctl 目标名称不在本技能正文中完整定义。
这个 Skill 与同类方案有什么区别?
该技能在不同场景下使用两种 NVIDIA 工具:T234/Orin 的 eMMC/SD 默认使用 flash.sh,NVMe/USB 使用 l4t_initrd_flash.sh;T264/Thor 使用 l4t_initrd_flash.sh。进入恢复模式时,in-tree boardctl 是首选,也可使用人工恢复按钮和复位按钮流程。