Jetson UPHY 通道分配配置
为 Orin 和 Thor 定制载板选择并应用 UPHY 通道分配。
技能要求活动配置、载板原理图和引脚复用文件，缺失时拒绝运行；要求用户确认 UPHY 配置，并限制修改到源树载板配置和内核覆盖层，明确不修改上游 BSP。原子提交、状态侧车和故障排查增强了可恢复性。但没有明确的备份、回滚或提交前硬件验证流程，且会影响 ODMDATA、内核 DT、构建、刷写等外部状态，因此扣分。
文档提供了详细步骤、失败关闭条件、ODMDATA 语法、常见故障和差异检查。静态证据仍不足以证明可运行；SKILL.md 要求先询问再运行子技能，而 procedure.md 要求自动调度，且分配表在提交前构建与步骤顺序存在矛盾。依赖运行时文档、DTB 工具和其他技能，异常路径反馈虽有描述但未被测试覆盖，因此仅给有限分数。
触发词、目标平台、支持范围、非适用范围和输入前提较清楚，并禁止硬编码配置表，适合 Orin/Thor 自定义载板场景。没有明确中文交互支持；Adaptation Guide 的网络回退依赖海外 NVIDIA 文档，未说明中国大陆网络不可达时的替代来源，因此扣分。
具有版本号、分层的主文档、详细 procedure、gotchas、sidecar、限制和安装相关仓库上下文，命名和输出表格较稳定。技能元数据只声明 Apache-2.0，而 skill-card 声明 CC-BY-4.0 与 Apache 2.0，且提供的许可证元数据为 NOASSERTION；作者格式不完整，缺少明确 changelog 和持续维护责任说明，因此扣分。
技能目标明确，能够将 UPHY 选择、ODMDATA、控制器状态和内核覆盖层串联，并提供可直接使用的提交和摘要格式。提交的基准报告显示两个正向任务表现较好，但样本极小、没有负向触发任务，且静态审查无法确认真实硬件结果或完整下游链路，因此不超过静态上限并扣分。
源文件包含具体语法、文件路径、状态转换、故障症状和有限的基准评估记录，部分结论可审计。基准仅覆盖两个任务，未提供实际 CI 测试套件、独立复现日志或多来源交叉验证；静态审查也未执行命令或硬件验证，因此给有限分数。
- 在采用前解决 SKILL.md 与 procedure.md 关于子技能调度时机和是否需要询问的冲突。
- 为 ODMDATA、载板配置和覆盖层补充明确的备份、回滚和刷写前验证步骤。
- 确认中国大陆网络可访问 Adaptation Guide，或提供本地镜像/离线文档。
- 统一 Apache-2.0 与 CC-BY-4.0 的许可证声明，并补充作者、变更记录和维护责任。
这个 Skill 能做什么，适合哪些场景？
该技能用于 NVIDIA Jetson Orin（Tegra234）和 Thor（Tegra264）定制载板的 UPHY 通道分配。它根据适配指南、载板原理图、模块设计指南和 SoC TRM，在运行时识别可用配置，而不是使用硬编码选项。技能会编辑载板 flash-conf 分支中的 ODMDATA，并协调 PCIe、MGBE 和 USB 子技能生成必要的内核设备树覆盖片段。它不负责 pinmux、仅 PCIe 属性修改、构建、刷写或上游 BSP 文件编辑。
检查目标平台配置、Linux_for_Tegra Git 仓库和派生载板配置文件；解析适配指南、载板原理图及相关硬件文档；枚举匹配的 uphy0-config-N 和 Thor 上的 uphy1-config-N；要求用户确认配置；在一次原子提交中写入 UPHY 和控制器 ODMDATA token，并在选择 uphy0-config-6 时清除 UPHY_CONFIG；构建 PCIe、MGBE、USB SS 和 UFS 分配表；调用对应子技能生成内核设备树覆盖片段；输出变更摘要和后续操作提示。
- Jetson Orin 定制载板需要重新分配 PCIe、MGBE、USB 3 或 UFS 的 UPHY 通道时。
- Jetson Thor 载板需要同时配置 uphy0 和 uphy1 表面时。
- 刷写后 UPHY 控制器无法枚举，需要核对 BPMP 和内核设备树分配时。
- 冷启动出现 BL31 SError 或 BPMP firmware is not ready，需要排查 UPHY 或 MGBE ODMDATA 时。
这个 Skill 有哪些优点和局限？
- 针对 Tegra234 Orin 和 Tegra264 Thor 定制载板提供完整的 UPHY 分配流程。
- 要求依据适配指南和载板原理图进行运行时发现，避免猜测或硬编码配置。
- 将 UPHY、控制器 ODMDATA 和内核设备树覆盖协调到同一工作流中。
- 包含对 uphy0-config-6、MGBE 禁用和 BPMP DTB 不一致等常见故障的处理规则。
- 仅支持 Tegra234 和 Tegra264。
- 缺少适配指南、定制载板原理图或 pinmux XLS 时会拒绝运行。
- 不编辑 pinmux，不处理部分 PCIe-only 属性，也不构建、刷写或推广镜像。
- 提供的是操作指导；资料未提供独立测试套件或平台覆盖证明。
如何安装这个 Skill？
使用 NVIDIA 技能仓库提供的 skills CLI：
npx skills add nvidia/skills --skill jetson-customize-uphy --yes
CLI 会提示选择安装目标；技能仓库没有在此资料中规定具体本地目录。
如何使用这个 Skill？
在已安装该技能的 Agent 中提出例如“configure UPHY lane allocation for my Jetson custom carrier”或“set uphy0-config-N for this carrier”。运行前需要活动目标平台配置、reference_devkit、custom_carrier、已初始化的 Linux_for_Tegra Git 仓库、派生载板 conf，以及定制载板原理图和 pinmux XLS。技能会先展示表格并要求确认，随后完成 ODMDATA 提交并串联相关子技能。