HSB FPGA 刷写助手
安全执行 HSB 板卡与 VB1940 相机的 FPGA 固件刷写。
证据显示技能要求显式确认、板卡类型确认、分阶段审批、容器内执行并强调错误工具可能永久损坏设备;但允许--force绕过版本不匹配、--y跳过阶段确认,失败时还可假定版本为2407继续,且涉及SSH、远程仓库检出、特权Docker和永久固件修改,回滚与恢复方案不完整,清单下载也主要依赖外部地址。因此扣分。
证据显示有版本映射、单步/双步转换规则、2407兼容性回退、日志和失败摘要要求;但关键命令依赖远程仓库文档和未提供的环境,寄希望于动态修改技能,寄存器读取示例未完成,且“无法读取即假定2407并继续”会增加误操作风险。静态审查不支持超过10分,故保守扣分。
目标用户、板卡类型、版本范围、转换边界和触发方式较清楚,且支持Codex与Claude Code;但中文语言支持未说明,核心流程依赖SSH、Docker、GitHub及NGC/外部下载,未证明在中国大陆网络环境下可达,未充分定义非适用场景。
证据显示有元数据、作者团队、版本1.0.0、标签、分阶段文档、帮助文本和基准报告;但缺少推荐的Examples/Purpose结构,前置条件和限制披露不足,版本变更日志、维护责任与更新路径不完整,仓库提供的license metadata为NOASSERTION,尽管技能声明Apache-2.0。
证据显示技能覆盖板卡识别、版本选择、清单准备、刷写、验证、报告和清理,且BENCHMARK记录了有限的执行评估结果;但结果仍依赖现场硬件、远程环境、未提供的参考文件和外部工件,基准总体结论为FAIL,静态审查无法确认代表性输出可直接使用。因此仅给中等分数。
证据包括版本映射、命令示例、清单哈希、基准指标和评估任务定义,提供了一定可审计性;但没有原始运行日志、独立复现结果、完整测试套件或覆盖关键路径的CI证据,且若干关键内容位于未提供文件中。静态审查上限为5,故不满分。
- 不要在板卡类型或当前版本无法可靠确认时继续刷写;尤其不要依赖“假定2407”的回退。
- --force和--y会削弱关键确认与安全门,使用前应明确记录用户授权、目标版本和恢复方案。
- 先验证远程依赖、容器、仓库文档、清单来源及网络可达性,并准备硬件级恢复措施。
这个 Skill 能做什么,适合哪些场景?
hsb-flash 面向连接 NVIDIA 开发套件的 HSB 硬件,指导 FPGA 固件升级或降级。它支持 HSB Lattice 板和 Leopard Imaging VB1940 一体化相机,并根据板型选择不同命令。流程涵盖连接检查、版本识别、目标版本选择、YAML 清单准备、刷写验证、报告和清理。由于刷写会永久修改固件,技能要求用户明确触发并在关键阶段确认。
读取 SSH_TARGET、REMOTE_ROOT 等环境变量;通过 SSH 检查开发套件和板卡连接;调用 hololink 读取 FPGA 版本并识别板型;根据当前版本、目标版本和板型选择 HSB 发布仓库、YAML 清单及刷写命令;在 demo 容器内执行带有 --force 和 --accept-eula 的刷写操作;处理必要的断电重启;验证目标 FPGA 版本,生成总结并清理临时仓库和刷写文件。
- 需要将 HSB Lattice 板从 FPGA 2407 升级到 2412、2507 或 2510 的开发者。
- 需要在支持的版本之间降级 HSB Lattice FPGA 的硬件工程师。
- 需要刷写 Leopard Imaging VB1940 一体化相机 FPGA 2507 或 2510 的用户。
- 需要通过 NVIDIA 开发套件远程完成 HSB 固件维护并保留操作摘要的团队。
这个 Skill 有哪些优点和局限?
- 覆盖 Lattice 与 VB1940 两种板型,并明确禁止混用刷写命令。
- 支持版本识别、单步或两步迁移、断电重启验证和刷写后版本核对。
- 包含远程 SSH、发布仓库选择、YAML 清单和临时资源清理流程。
- 只支持文档列出的 FPGA 版本;Lattice 不支持早于 2407 或已知版本之间的版本,VB1940 不支持早于 2507 的版本。
- 刷写会永久修改 FPGA 固件,流程依赖用户确认、远程开发套件、SSH、hololink 和 demo 容器。
- 材料未提供自动化测试套件、实际硬件兼容性测试结果或完整参考文件内容。
- frontmatter 含有 Claude Code 风格的禁用自动调用设置,迁移到其他客户端可能需要调整。
如何安装这个 Skill?
使用仓库 README 提供的命令安装:npx skills add nvidia/skills --skill hsb-flash --yes。也可以指定客户端,例如:npx skills add nvidia/skills --skill hsb-flash --agent codex --yes。仓库是包含多个技能的集合,不需要手动复制技能目录。
如何使用这个 Skill?
仅在明确需要刷写时触发:/hsb-flash [OPTIONS]。使用前必须提供 SSH_TARGET 和 REMOTE_ROOT;技能会先展示远程设置、令牌预算预检和阶段计划,然后要求确认。开始任何刷写命令前,还必须明确确认板型为 Lattice 或 VB1940。具体 --help 输出和参考文件内容未在给定材料中提供。