Jetson 时钟定制

要解决什么问题

在 Jetson 上做性能基准、功耗对比或复现「固定频率」问题时，仅靠运行时的 nvpmodel 或 sysfs 往往不够：EMC 仍会走 DVFS，CPU/GPU 的有效上限还受 BPMP 设备树 与启动脚本两层约束。若直接在 Linux_for_Tegra/bootloader/ 里改文件，又会破坏覆盖层差异跟踪，后续 jetson-promote-image 可能变成空操作。

本技能面向 映像构建阶段：在烧录前，通过规范工作流改两处输入——bootloader/ 下的 BPMP DTB（时钟 max-rate-custom、EMC DVFS 门控）以及 rootfs 里的 nvpower.sh（cpufreq/devfreq 调节器与可选的 sysfs 速率边界）。

技能如何工作

1. 前置校验：解析活跃目标配置；缺少 BSP 映像、Linux_for_Tegra/ 或源覆盖层时，路由到兄弟技能（如 jetson-init-image、jetson-init-source、jetson-set-target）。
2. 操作 1 — BPMP DTB：按 BPMP-DTB 定制协议反编译、编辑 DTS、重编译；所有写入落在 覆盖层跟踪器 内，而非直接改部署输出目录。典型编辑包括：命名时钟节点上的 max-rate-custom（仅降低硬上限，不能越过 max-rate-maxn）；禁用/启用 EMC DVFS（bwmgr/cactmon，T26x 还需 /delete-node/ osp-controller）。
3. 操作 2 — nvpower.sh：在覆盖层中做原始导入 + 定制提交，调整 set_cpufreq_governor / set_devfreq_governor 及最小/最大/静态速率，避免只读上游被静默覆盖差异。
4. 部署链：jetson-promote-image → jetson-flash-image；新 DTB 与脚本在下次启动生效。另有「全 MAXN 压力测试」配方，组合 BPMP、nvpower 与兄弟技能 jetson-customize-nvpmodel。

边界与注意点

• 仅构建时定制：运行中目标上的实时调频不在范围内。
• 有效上限是双层：运行时约为 min(BPMP cap, 当前 nvpmodel 模式 cap)；只改 BPMP 而 nvpmodel 仍钳制时，改模式后频率可能「复位」。
• T23x GPU 需同时处理 nafll_gpusys 与各 nafll_gpcX；T26x EMC 禁用 不能只关 bwmgr，须完整三件套编辑。
• nvpower.sh 随 nvidia-l4t-init 升级可能被覆盖；长期配置宜考虑 systemd drop-in 或辅助脚本。
• ODMDATA 令牌 在烧录时可能覆盖部分 BPMP 属性；勿触碰 max-rate-maxn 与 lateinit。