HSB FPGA 固件烧录

要解决什么问题

在 NVIDIA Holoscan Sensor Bridge（HSB）开发流程里，FPGA 固件升级或降级往往要选对板卡、选对 HSB 发布仓库、处理 2407↔2412 网关版本，还要在远程开发套件上通过 hololink 在 demo 容器里执行烧录。Lattice 独立板与 Leopard Imaging VB1940 一体化相机使用的编程入口不同（program_lattice_cpnx100 与 program_leopard_cpnx100），混用可能导致设备永久损坏。

技能如何工作

/hsb-flash 按阶段推进，并在有副作用的操作前停下来确认：

• 门控与环境：校验 SSH_TARGET、REMOTE_ROOT 等远程变量；展示烧录摘要（工具、清单版本、--force / --accept-eula、单步或经 2412 的两步路径）；在用户确认后再做 token 预算预检。
• 识别与规划：探测连接与当前 FPGA 版本，区分 lattice 与 vb1940；按方向选择 HSB 发布标签（Lattice 升级看目标版本、降级看当前版本；VB1940 用套件上已有仓库，无需 v2.0.0 中间仓）。
• 执行与收尾：在 demo 容器内分步烧录，必要时电源循环；烧录后核对版本，清理技能临时检出的中间仓库并生成过程报告。

对文档未列出的 FPGA 版本，技能会查阅 Holoscan Sensor Bridge 公开发布说明，尝试匹配发布仓；若无对应发布版则退回既有 HSB 仓库并如实报错。

适用边界与注意

• 切勿自动跑完整烧录：工作流会永久改写 FPGA，仅应在用户显式调用时执行。
• 板型必须明确：检测不清时由用户指定；拒绝在类型不匹配时继续。
• 版本矩阵分板卡：Lattice 支持 2407/2412/2507/2510 等路径；VB1940 不支持 2407/2412，且通常要求先通过 /hsb-setup 准备好 v2.3.0 及以上仓库。
• FPGA 2407 上 hololink enumerate 可能失败，需用 hololink --force fpga_version；v2.0.0 的 CLI 标志位置与子命令顺序与其他版本不同，须按技能摘要执行。