[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-nvidia-jetson-validate-image":3,"mdc--74qmb8-key":34,"related-repo-nvidia-jetson-validate-image":2032,"related-org-nvidia-jetson-validate-image":2136},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":23,"repoUrl":24,"updatedAt":25,"license":26,"forks":27,"topics":28,"repo":29,"sourceUrl":32,"mdContent":33},"jetson-validate-image","validate Jetson BSP images","Use after jetson-flash-image to run static BSP checks, on-target smoke\u002Fregression tests on a flashed DUT, or both. Not for build or flash steps. Triggers: validate bsp, on-target validation.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},"nvidia","NVIDIA","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fnvidia.png",[12,16,19,20],{"name":13,"slug":14,"type":15},"Hardware","hardware","tag",{"name":17,"slug":18,"type":15},"QA","qa",{"name":9,"slug":8,"type":15},{"name":21,"slug":22,"type":15},"Testing","testing",2473,"https:\u002F\u002Fgithub.com\u002FNVIDIA\u002Fskills","2026-07-14T05:28:14.43434","Apache-2.0",281,[],{"repoUrl":24,"stars":23,"forks":27,"topics":30,"description":31},[],"AI agent skills published by NVIDIA","https:\u002F\u002Fgithub.com\u002FNVIDIA\u002Fskills\u002Ftree\u002FHEAD\u002Fskills\u002Fjetson-validate-image","---\nname: jetson-validate-image\ndescription: >-\n  Use after jetson-flash-image to run static BSP checks, on-target\n  smoke\u002Fregression tests on a flashed DUT, or both. Not for build\n  or flash steps. Triggers: validate bsp, on-target validation.\nversion: 0.0.1\nlicense: \"Apache-2.0\"\nmetadata:\n  data-classification: public\n  author: \"Jetson Team\"\n  tags:\n    - bsp\n    - validation\n    - test\n    - deploy\n  domain: meta\n---\n\n# Validate BSP Image\n\n> **Status:** the DUT-access contract is stable; the rest of the\n> validation procedure is a skeleton.\n\n## Purpose\n\nConfirm that a freshly customized BSP landed correctly — both as a\nstatic artifact on disk and as a running system on the target —\nwithout re-promoting or re-flashing. Forms the **validation tail of\nDeploy** in the Setup → Customize → Build → Deploy pipeline (see\n[`..\u002F..\u002Fcontext\u002Fbsp-customization-workflow.md`](..\u002F..\u002Fcontext\u002Fbsp-customization-workflow.md)\nfor the pipeline view) and is independently re-runnable.\n\n## Prerequisites\n\n- Active target-platform profile with `bsp_image:` resolved (run\n  `\u002Fjetson-init-image` first).\n- For static-only scope: nothing further; the skill reads\n  `\u003Cbsp_image.root_path>` directly.\n- For on-target scope:\n  - `\u002Fjetson-flash-image` already pushed the staged BSP to the DUT.\n  - `dut_access:` block authored in the active profile (or filled\n    interactively at runtime — see [`## DUT access`](#dut-access)).\n  - Host tooling per transport: `ssh` + `sshpass` for SSH; Python\n    3.6+ with `pyserial` for UART.\n  - Required env vars resolvable on the host when `auth=password`\n    or `sudo.method=password` (`password_env` \u002F `sudo.password_env`\n    name the env var; never inline the secret in YAML).\n\n## When to invoke\n\n- After `jetson-flash-image` has put the BSP onto a target.\n- The user explicitly asks to validate, test, or run smoke \u002F\n  regression checks on a flashed device.\n- As a CI gate before declaring a customization batch shippable.\n\n## Instructions\n\nThe procedure below is a skeleton.\n\n1. **Read the active target** per the prerequisite contract.\n2. **Choose validation scope** — static (against `bsp_image` on\n   disk, no DUT needed) and\u002For on-target (DUT must be booted\n   from the just-flashed image).\n3. **Static checks** (if in scope):\n     - Required artifacts present at expected paths in\n       `\u003Cbsp_image.root_path>\u002FLinux_for_Tegra\u002F`.\n     - DTB \u002F module checksum or signature verification.\n     - Partition-layout sanity vs. the per-board `.conf`'s XML.\n     - Cross-check overlay-staged outputs against `bsp_image`\n       (they should be identical post-promotion).\n     - **Initramfs ↔ kernel + rootfs module coherence.** Extract\n       `\u003Cbsp_image>\u002FLinux_for_Tegra\u002Fbootloader\u002Fl4t_initrd.img` and\n       `\u003Cbsp_image>\u002FLinux_for_Tegra\u002Frootfs\u002Fboot\u002Finitrd`; verify\n       three invariants against the *promoted* `bsp_image` state:\n       (a) `\u003Cbsp_image>\u002FLinux_for_Tegra\u002Fkernel\u002FImage` matches\n       `\u003Cbsp_image>\u002FLinux_for_Tegra\u002Frootfs\u002Fboot\u002FImage` byte-for-\n       byte — drift here means\n       [the \"Mirror kernel Image into rootfs\" step](..\u002Fjetson-promote-image\u002FSKILL.md#mirror-kernel-image-into-rootfs-when-kernel-changed)\n       was skipped and any subsequent initramfs refresh built\n       against the previous kernel.\n       (b) for each module path the two initrd images ship, the\n       bytes \u002F md5 match the file under\n       `\u003Cbsp_image>\u002FLinux_for_Tegra\u002Frootfs\u002Flib\u002Fmodules\u002F\u003Cver>\u002F` —\n       any drift means modules will be shadowed at early boot.\n       (c) the vermagic stamped on every initramfs `*.ko` matches\n       the `UTS_RELEASE` reachable from\n       `\u003Cbsp_image>\u002FLinux_for_Tegra\u002Fkernel\u002FImage` (e.g. parse the\n       `Linux version …` string with `strings`) — a vermagic skew\n       means the kernel `Image` was refreshed without rerunning\n       `l4t_update_initrd.sh`, and modules will fail to load with\n       \"disagrees about version of symbol …\". All three failure\n       modes are closed by `\u002Fjetson-promote-image`'s gate on\n       either `kernel\u002FImage` or `rootfs\u002Flib\u002Fmodules\u002F` plus the\n       kernel-Image mirror; surface drift here and route the user\n       back to a clean promote. See\n       [`..\u002Fjetson-promote-image\u002FSKILL.md`](..\u002Fjetson-promote-image\u002FSKILL.md#refresh-initramfs-when-kernel-or-modules-changed).\n4. **On-target checks** (if in scope):\n     - **Connect to the DUT** per the [`## DUT access`](#dut-access)\n       section below — resolve transport (ssh \u002F uart), credentials,\n       and sudo method from the active profile's `dut_access:`\n       block (with interactive fallback when fields are missing \u002F\n       marked `prompt`), then run the connection probe and refuse\n       if it fails.\n     - Confirm boot reached userspace.\n     - Run the selected test suite (smoke, regression, focused\n       per-customization, ad-hoc).\n     - **Loaded-module srcversion drift.** For modules a\n       customization is known to have rebuilt, compare\n       `cat \u002Fsys\u002Fmodule\u002F\u003Cname>\u002Fsrcversion` on the DUT against the\n       `modinfo \u002Flib\u002Fmodules\u002F$(uname -r)\u002F...\u002F\u003Cname>.ko | awk\n       '\u002Fsrcversion\u002F {print $2}'` reading. A mismatch means the\n       kernel is running an older copy than the rootfs ships —\n       almost always a stale initramfs (the bootloader-side initrd\n       shipped a pre-customize module, it loaded first, and the\n       rootfs copy cannot replace a live module). Recommend\n       re-running `\u002Fjetson-promote-image` and re-flashing. Note:\n       some modules don't emit `srcversion`; fall back to an md5\n       check against the binary the kernel loaded by extracting the\n       region under `\u002Fsys\u002Fmodule\u002F\u003Cname>\u002Fsections\u002F` or by comparing\n       behaviorally (printk \u002F sysfs nodes \u002F DT properties the new\n       version is known to expose).\n     - **Running kernel vs. rootfs kernel `Image`.** Compare\n       `cat \u002Fproc\u002Fversion` (or `uname -v`) on the DUT against the\n       `Linux version …` string extracted from\n       `\u002Fboot\u002FImage` (`strings \u002Fboot\u002FImage | grep -m1 'Linux version'`).\n       A mismatch — usually the build timestamp \u002F `LOCALVERSION` —\n       means the bootloader is running an older kernel `Image` than\n       the rootfs holds, almost certainly because a fresh `Image`\n       was promoted but the initramfs \u002F `extlinux.conf` \u002F QSPI\n       boot partition wasn't refreshed. Modules in the rootfs\n       will then have a different vermagic and any subsequent\n       `modprobe` of a built-against-the-new-kernel `.ko` will\n       fail. Recommend `\u002Fjetson-promote-image` and re-flash.\n     - **Userspace dmesg readability.** Ubuntu 22.04 sets\n       `kernel.dmesg_restrict=1`; non-root `dmesg` reads return\n       \"Operation not permitted\" and silently zero hits. Every\n       `dmesg`-based check must run with `sudo` (or temporarily\n       lower the restriction via `sudo sysctl\n       kernel.dmesg_restrict=0`). Surfacing this in the validate\n       layer keeps printk-based customization checks honest.\n     - Collect results, logs, artifacts.\n5. **Summary**: per-check pass\u002Ffail, overall verdict, where\n   logs and artifacts landed.\n\n## DUT access\n\nThe on-target leg needs a way to reach the just-flashed DUT.\nTwo transports are supported as full peers: `ssh` (primary) and\n`uart` (fallback for DUTs with no network).\n\nThe contract is locked in but lives in\n[`references\u002Fdut-access.md`](references\u002Fdut-access.md) to keep this\nSKILL.md under the agent-routing budget. That reference covers:\n\n- The `dut_access:` profile schema (ssh, uart, sudo, workdir).\n- Resolution order (profile → env var → interactive prompt) with\n  the full refusal-trigger table.\n- The mandatory connection probe (`uname -r` +\n  `cat \u002Fetc\u002Fnv_tegra_release`) and its output-validation rules.\n- File transfer per transport (`scp` vs. base64-over-tty, with\n  the >100 KB warning).\n- Sudo invocation matrix per `sudo.method` × transport.\n- UART implementation contract that `scripts\u002Fuart_session.py`\n  honors (state machines for login \u002F exec \u002F push \u002F pull, exit\n  codes, robustness notes).\n- Security notes (password handling, host-key pinning).\n\n## Available Scripts\n\n| Script | Purpose | Arguments |\n|---|---|---|\n| `scripts\u002Fuart_session.py` | UART transport black box for the on-target leg: login, command exec (with optional sudo), and base64-over-tty file transfer. Replaces ssh when the DUT has no network or ssh is broken. | `--tty \u003Cdev> [--baud \u003Cn>] --user \u003Cname> --password-env \u003CENVVAR> [--sudo-password-env \u003CENVVAR>] [--shell-prompt \u003Cregex>] [--lock-strategy refuse\\|wait] \u003Cprobe\\|exec\\|push\\|pull> [...]` |\n\nInvocation (the skill calls scripts as a subprocess — `run_script()`\nin agent-runtime terminology):\n\n```bash\n# run_script: probe the DUT over UART\nDUT_UART_PASSWORD_ENV=DUT_UART_PWD \\\nDUT_UART_PWD=\"$(read -rs -p 'UART login pw: '; echo \"$REPLY\")\" \\\n  scripts\u002Fuart_session.py \\\n    --tty \u002Fdev\u002FttyACM0 --baud 115200 \\\n    --user ubuntu --password-env DUT_UART_PASSWORD_ENV \\\n    probe\n\n# run_script: exec a sudo command and capture exit code\nscripts\u002Fuart_session.py --tty \u002Fdev\u002FttyACM0 --user ubuntu \\\n  --password-env DUT_UART_PASSWORD_ENV \\\n  --sudo-password-env DUT_SUDO_PWD \\\n  exec --use-sudo 'dmesg | tail -200'\n```\n\nThe script's exit code is the contract — see the exit-code table in\n[`UART implementation contract`](references\u002Fdut-access.md#uart-implementation-contract).\n\n## Examples\n\nStatic-only validation (no DUT needed):\n\n```\n\u002Fjetson-validate-image\n> static checks only against the staged BSP\n```\n\nOn-target validation over SSH after a freshly flashed DUT:\n\n```\n\u002Fjetson-flash-image\n   ↓\n\u002Fjetson-validate-image\n> on-target checks via dut_access.ssh\n```\n\nOn-target validation over UART (no network on the DUT):\n\n```\n\u002Fjetson-validate-image\n> use the uart transport at \u002Fdev\u002FttyACM0; the dut_access.uart block\n  in the profile already has the tty and login_password_env wired up\n```\n\n## Limitations\n\n- Placeholder skill — only the DUT-access contract and the\n  `uart_session.py` helper are locked in. The static-check list,\n  test-suite selection, result-sink layout, and pass\u002Ffail policy\n  are tracked under `## Open items` and may change.\n- UART file transfer is byte-banged base64 at ~10 KB\u002Fs on 115200\n  baud — emits a warning for sources > 100 KB but proceeds. For\n  high-volume transfers, switch to the SSH transport.\n- `uart_session.py` opens and closes the tty per subcommand\n  invocation (~1–2 s login per call). Validation passes running\n  > 10 commands amortize poorly on UART; prefer SSH.\n- SSH uses `StrictHostKeyChecking=accept-new` with a per-profile\n  `known_hosts` file. A fingerprint change refuses — typically\n  means the DUT was reflashed (host keys regenerated) or the IP\n  was reassigned. Remove the per-profile entry manually rather\n  than auto-accepting.\n- Passwords are never inlined in the profile YAML — only\n  `password_env` (env-var name) is persisted. `auth=prompt` \u002F\n  `sudo.method=prompt` exposes the password in the conversation\n  log, which is the user's responsibility to manage.\n- `transport=uart` with `lock_strategy=steal` is **not implemented**\n  (would require sending control characters that could corrupt the\n  holder's state).\n\n## Troubleshooting\n\n| Error | Cause | Solution |\n|---|---|---|\n| `no DUT transport configured` (refuse) | On-target scope requested but `dut_access.transport` unresolved across profile \u002F env \u002F interactive prompt | Author `dut_access:` in the active profile, or rerun with static-only scope. |\n| `$PASSWORD_ENV is unset` (refuse) | `auth=password` (or `sudo.method=password`) names an env var that isn't exported on the host | `export \u003CENVVAR>=...` before invoking the skill; do NOT inline the password in YAML. |\n| `tty held by another process` (refuse, exit 3) | `lock_strategy=refuse` and `fuser` reports another holder (minicom, picocom, getty) | Close the holding process (`sudo fuser -k \u003Ctty>` only if you know what's there), or rerun with `lock_strategy=wait`. |\n| `pyserial import failed` (exit 4) | UART transport selected but `pyserial` not installed in the skill's Python | `apt install python3-serial` or `pip install pyserial`. |\n| SSH fingerprint refused | DUT's host keys changed since the per-profile `known_hosts` was pinned (typically a reflash) | Remove the matching line from `\u003Cworkspace>\u002Ftarget-platform\u002F\u003Cprofile-stem>.known_hosts` and rerun — the new key will be accepted on first connect. |\n| `login failed` (exit 128) | UART probe couldn't match a login or shell prompt within timeout | Confirm the DUT is powered + booted to userspace; check `--shell-prompt` override if the DUT carries an unusual `PS1`; verify the `--user` matches a real account. |\n| `DUT not booted from the just-flashed BSP` (warn \u002F refuse) | `\u002Fetc\u002Fnv_tegra_release` on the DUT doesn't match `bsp_image.version` | Re-run `\u002Fjetson-flash-image` and confirm the DUT actually power-cycled into the new BSP, not the previous one. |\n| `sudo prompt detected but no sudo password configured` (exit 130) | `--use-sudo` passed to `uart_session.py exec` but `--sudo-password-env` not set, and DUT user lacks NOPASSWD | Set `sudo.method=password` + `sudo.password_env` in the profile, or grant NOPASSWD on the DUT via `\u002Fetc\u002Fsudoers.d\u002F`. |\n| `command timed out` (exit 129) | Long-running DUT command exceeded the script's timeout | Run the command directly via `ssh` transport, or split into shorter steps. |\n\n## References\n\n- [`references\u002Fdut-access.md`](references\u002Fdut-access.md) — full DUT-access contract: profile schema, resolution order, probe, file transfer, sudo, UART implementation, security.\n- [`..\u002F..\u002Fcontext\u002Ftarget-platform-contract.md`](..\u002F..\u002Fcontext\u002Ftarget-platform-contract.md) — target-platform contract.\n- [`..\u002F..\u002Fcontext\u002Fbsp-customization-workflow.md`](..\u002F..\u002Fcontext\u002Fbsp-customization-workflow.md#workflow-invariants) — Workspace edit protocol (this skill is the Deploy tail).\n- [`..\u002Fjetson-build-source\u002FSKILL.md`](..\u002Fjetson-build-source\u002FSKILL.md) — Build builder; produces the artifacts this skill validates.\n",{"data":35,"body":46},{"name":4,"description":6,"version":36,"license":26,"metadata":37},"0.0.1",{"data-classification":38,"author":39,"tags":40,"domain":45},"public","Jetson Team",[41,42,43,44],"bsp","validation","test","deploy","meta",{"type":47,"children":48},"root",[49,58,74,81,106,112,259,265,291,297,302,830,836,856,872,957,963,1020,1033,1340,1356,1362,1367,1377,1382,1391,1396,1405,1411,1533,1539,1962,1968,2026],{"type":50,"tag":51,"props":52,"children":54},"element","h1",{"id":53},"validate-bsp-image",[55],{"type":56,"value":57},"text","Validate BSP Image",{"type":50,"tag":59,"props":60,"children":61},"blockquote",{},[62],{"type":50,"tag":63,"props":64,"children":65},"p",{},[66,72],{"type":50,"tag":67,"props":68,"children":69},"strong",{},[70],{"type":56,"value":71},"Status:",{"type":56,"value":73}," the DUT-access contract is stable; the rest of the\nvalidation procedure is a skeleton.",{"type":50,"tag":75,"props":76,"children":78},"h2",{"id":77},"purpose",[79],{"type":56,"value":80},"Purpose",{"type":50,"tag":63,"props":82,"children":83},{},[84,86,91,93,104],{"type":56,"value":85},"Confirm that a freshly customized BSP landed correctly — both as a\nstatic artifact on disk and as a running system on the target —\nwithout re-promoting or re-flashing. Forms the ",{"type":50,"tag":67,"props":87,"children":88},{},[89],{"type":56,"value":90},"validation tail of\nDeploy",{"type":56,"value":92}," in the Setup → Customize → Build → Deploy pipeline (see\n",{"type":50,"tag":94,"props":95,"children":97},"a",{"href":96},"..\u002F..\u002Fcontext\u002Fbsp-customization-workflow.md",[98],{"type":50,"tag":99,"props":100,"children":102},"code",{"className":101},[],[103],{"type":56,"value":96},{"type":56,"value":105},"\nfor the pipeline view) and is independently re-runnable.",{"type":50,"tag":75,"props":107,"children":109},{"id":108},"prerequisites",[110],{"type":56,"value":111},"Prerequisites",{"type":50,"tag":113,"props":114,"children":115},"ul",{},[116,138,151],{"type":50,"tag":117,"props":118,"children":119},"li",{},[120,122,128,130,136],{"type":56,"value":121},"Active target-platform profile with ",{"type":50,"tag":99,"props":123,"children":125},{"className":124},[],[126],{"type":56,"value":127},"bsp_image:",{"type":56,"value":129}," resolved (run\n",{"type":50,"tag":99,"props":131,"children":133},{"className":132},[],[134],{"type":56,"value":135},"\u002Fjetson-init-image",{"type":56,"value":137}," first).",{"type":50,"tag":117,"props":139,"children":140},{},[141,143,149],{"type":56,"value":142},"For static-only scope: nothing further; the skill reads\n",{"type":50,"tag":99,"props":144,"children":146},{"className":145},[],[147],{"type":56,"value":148},"\u003Cbsp_image.root_path>",{"type":56,"value":150}," directly.",{"type":50,"tag":117,"props":152,"children":153},{},[154,156],{"type":56,"value":155},"For on-target scope:\n",{"type":50,"tag":113,"props":157,"children":158},{},[159,170,193,222],{"type":50,"tag":117,"props":160,"children":161},{},[162,168],{"type":50,"tag":99,"props":163,"children":165},{"className":164},[],[166],{"type":56,"value":167},"\u002Fjetson-flash-image",{"type":56,"value":169}," already pushed the staged BSP to the DUT.",{"type":50,"tag":117,"props":171,"children":172},{},[173,179,181,191],{"type":50,"tag":99,"props":174,"children":176},{"className":175},[],[177],{"type":56,"value":178},"dut_access:",{"type":56,"value":180}," block authored in the active profile (or filled\ninteractively at runtime — see ",{"type":50,"tag":94,"props":182,"children":184},{"href":183},"#dut-access",[185],{"type":50,"tag":99,"props":186,"children":188},{"className":187},[],[189],{"type":56,"value":190},"## DUT access",{"type":56,"value":192},").",{"type":50,"tag":117,"props":194,"children":195},{},[196,198,204,206,212,214,220],{"type":56,"value":197},"Host tooling per transport: ",{"type":50,"tag":99,"props":199,"children":201},{"className":200},[],[202],{"type":56,"value":203},"ssh",{"type":56,"value":205}," + ",{"type":50,"tag":99,"props":207,"children":209},{"className":208},[],[210],{"type":56,"value":211},"sshpass",{"type":56,"value":213}," for SSH; Python\n3.6+ with ",{"type":50,"tag":99,"props":215,"children":217},{"className":216},[],[218],{"type":56,"value":219},"pyserial",{"type":56,"value":221}," for UART.",{"type":50,"tag":117,"props":223,"children":224},{},[225,227,233,235,241,243,249,251,257],{"type":56,"value":226},"Required env vars resolvable on the host when ",{"type":50,"tag":99,"props":228,"children":230},{"className":229},[],[231],{"type":56,"value":232},"auth=password",{"type":56,"value":234},"\nor ",{"type":50,"tag":99,"props":236,"children":238},{"className":237},[],[239],{"type":56,"value":240},"sudo.method=password",{"type":56,"value":242}," (",{"type":50,"tag":99,"props":244,"children":246},{"className":245},[],[247],{"type":56,"value":248},"password_env",{"type":56,"value":250}," \u002F ",{"type":50,"tag":99,"props":252,"children":254},{"className":253},[],[255],{"type":56,"value":256},"sudo.password_env",{"type":56,"value":258},"\nname the env var; never inline the secret in YAML).",{"type":50,"tag":75,"props":260,"children":262},{"id":261},"when-to-invoke",[263],{"type":56,"value":264},"When to invoke",{"type":50,"tag":113,"props":266,"children":267},{},[268,281,286],{"type":50,"tag":117,"props":269,"children":270},{},[271,273,279],{"type":56,"value":272},"After ",{"type":50,"tag":99,"props":274,"children":276},{"className":275},[],[277],{"type":56,"value":278},"jetson-flash-image",{"type":56,"value":280}," has put the BSP onto a target.",{"type":50,"tag":117,"props":282,"children":283},{},[284],{"type":56,"value":285},"The user explicitly asks to validate, test, or run smoke \u002F\nregression checks on a flashed device.",{"type":50,"tag":117,"props":287,"children":288},{},[289],{"type":56,"value":290},"As a CI gate before declaring a customization batch shippable.",{"type":50,"tag":75,"props":292,"children":294},{"id":293},"instructions",[295],{"type":56,"value":296},"Instructions",{"type":50,"tag":63,"props":298,"children":299},{},[300],{"type":56,"value":301},"The procedure below is a skeleton.",{"type":50,"tag":303,"props":304,"children":305},"ol",{},[306,316,334,553,820],{"type":50,"tag":117,"props":307,"children":308},{},[309,314],{"type":50,"tag":67,"props":310,"children":311},{},[312],{"type":56,"value":313},"Read the active target",{"type":56,"value":315}," per the prerequisite contract.",{"type":50,"tag":117,"props":317,"children":318},{},[319,324,326,332],{"type":50,"tag":67,"props":320,"children":321},{},[322],{"type":56,"value":323},"Choose validation scope",{"type":56,"value":325}," — static (against ",{"type":50,"tag":99,"props":327,"children":329},{"className":328},[],[330],{"type":56,"value":331},"bsp_image",{"type":56,"value":333}," on\ndisk, no DUT needed) and\u002For on-target (DUT must be booted\nfrom the just-flashed image).",{"type":50,"tag":117,"props":335,"children":336},{},[337,342,344],{"type":50,"tag":67,"props":338,"children":339},{},[340],{"type":56,"value":341},"Static checks",{"type":56,"value":343}," (if in scope):\n",{"type":50,"tag":113,"props":345,"children":346},{},[347,360,365,378,390],{"type":50,"tag":117,"props":348,"children":349},{},[350,352,358],{"type":56,"value":351},"Required artifacts present at expected paths in\n",{"type":50,"tag":99,"props":353,"children":355},{"className":354},[],[356],{"type":56,"value":357},"\u003Cbsp_image.root_path>\u002FLinux_for_Tegra\u002F",{"type":56,"value":359},".",{"type":50,"tag":117,"props":361,"children":362},{},[363],{"type":56,"value":364},"DTB \u002F module checksum or signature verification.",{"type":50,"tag":117,"props":366,"children":367},{},[368,370,376],{"type":56,"value":369},"Partition-layout sanity vs. the per-board ",{"type":50,"tag":99,"props":371,"children":373},{"className":372},[],[374],{"type":56,"value":375},".conf",{"type":56,"value":377},"'s XML.",{"type":50,"tag":117,"props":379,"children":380},{},[381,383,388],{"type":56,"value":382},"Cross-check overlay-staged outputs against ",{"type":50,"tag":99,"props":384,"children":386},{"className":385},[],[387],{"type":56,"value":331},{"type":56,"value":389},"\n(they should be identical post-promotion).",{"type":50,"tag":117,"props":391,"children":392},{},[393,398,400,406,408,414,416,422,424,429,431,437,439,445,447,453,455,461,463,469,471,477,479,484,486,492,494,500,502,508,510,516,518,524,526,532,534,540,542,552],{"type":50,"tag":67,"props":394,"children":395},{},[396],{"type":56,"value":397},"Initramfs ↔ kernel + rootfs module coherence.",{"type":56,"value":399}," Extract\n",{"type":50,"tag":99,"props":401,"children":403},{"className":402},[],[404],{"type":56,"value":405},"\u003Cbsp_image>\u002FLinux_for_Tegra\u002Fbootloader\u002Fl4t_initrd.img",{"type":56,"value":407}," and\n",{"type":50,"tag":99,"props":409,"children":411},{"className":410},[],[412],{"type":56,"value":413},"\u003Cbsp_image>\u002FLinux_for_Tegra\u002Frootfs\u002Fboot\u002Finitrd",{"type":56,"value":415},"; verify\nthree invariants against the ",{"type":50,"tag":417,"props":418,"children":419},"em",{},[420],{"type":56,"value":421},"promoted",{"type":56,"value":423}," ",{"type":50,"tag":99,"props":425,"children":427},{"className":426},[],[428],{"type":56,"value":331},{"type":56,"value":430}," state:\n(a) ",{"type":50,"tag":99,"props":432,"children":434},{"className":433},[],[435],{"type":56,"value":436},"\u003Cbsp_image>\u002FLinux_for_Tegra\u002Fkernel\u002FImage",{"type":56,"value":438}," matches\n",{"type":50,"tag":99,"props":440,"children":442},{"className":441},[],[443],{"type":56,"value":444},"\u003Cbsp_image>\u002FLinux_for_Tegra\u002Frootfs\u002Fboot\u002FImage",{"type":56,"value":446}," byte-for-\nbyte — drift here means\n",{"type":50,"tag":94,"props":448,"children":450},{"href":449},"..\u002Fjetson-promote-image\u002FSKILL.md#mirror-kernel-image-into-rootfs-when-kernel-changed",[451],{"type":56,"value":452},"the \"Mirror kernel Image into rootfs\" step",{"type":56,"value":454},"\nwas skipped and any subsequent initramfs refresh built\nagainst the previous kernel.\n(b) for each module path the two initrd images ship, the\nbytes \u002F md5 match the file under\n",{"type":50,"tag":99,"props":456,"children":458},{"className":457},[],[459],{"type":56,"value":460},"\u003Cbsp_image>\u002FLinux_for_Tegra\u002Frootfs\u002Flib\u002Fmodules\u002F\u003Cver>\u002F",{"type":56,"value":462}," —\nany drift means modules will be shadowed at early boot.\n(c) the vermagic stamped on every initramfs ",{"type":50,"tag":99,"props":464,"children":466},{"className":465},[],[467],{"type":56,"value":468},"*.ko",{"type":56,"value":470}," matches\nthe ",{"type":50,"tag":99,"props":472,"children":474},{"className":473},[],[475],{"type":56,"value":476},"UTS_RELEASE",{"type":56,"value":478}," reachable from\n",{"type":50,"tag":99,"props":480,"children":482},{"className":481},[],[483],{"type":56,"value":436},{"type":56,"value":485}," (e.g. parse the\n",{"type":50,"tag":99,"props":487,"children":489},{"className":488},[],[490],{"type":56,"value":491},"Linux version …",{"type":56,"value":493}," string with ",{"type":50,"tag":99,"props":495,"children":497},{"className":496},[],[498],{"type":56,"value":499},"strings",{"type":56,"value":501},") — a vermagic skew\nmeans the kernel ",{"type":50,"tag":99,"props":503,"children":505},{"className":504},[],[506],{"type":56,"value":507},"Image",{"type":56,"value":509}," was refreshed without rerunning\n",{"type":50,"tag":99,"props":511,"children":513},{"className":512},[],[514],{"type":56,"value":515},"l4t_update_initrd.sh",{"type":56,"value":517},", and modules will fail to load with\n\"disagrees about version of symbol …\". All three failure\nmodes are closed by ",{"type":50,"tag":99,"props":519,"children":521},{"className":520},[],[522],{"type":56,"value":523},"\u002Fjetson-promote-image",{"type":56,"value":525},"'s gate on\neither ",{"type":50,"tag":99,"props":527,"children":529},{"className":528},[],[530],{"type":56,"value":531},"kernel\u002FImage",{"type":56,"value":533}," or ",{"type":50,"tag":99,"props":535,"children":537},{"className":536},[],[538],{"type":56,"value":539},"rootfs\u002Flib\u002Fmodules\u002F",{"type":56,"value":541}," plus the\nkernel-Image mirror; surface drift here and route the user\nback to a clean promote. See\n",{"type":50,"tag":94,"props":543,"children":545},{"href":544},"..\u002Fjetson-promote-image\u002FSKILL.md#refresh-initramfs-when-kernel-or-modules-changed",[546],{"type":50,"tag":99,"props":547,"children":549},{"className":548},[],[550],{"type":56,"value":551},"..\u002Fjetson-promote-image\u002FSKILL.md",{"type":56,"value":359},{"type":50,"tag":117,"props":554,"children":555},{},[556,561,562],{"type":50,"tag":67,"props":557,"children":558},{},[559],{"type":56,"value":560},"On-target checks",{"type":56,"value":343},{"type":50,"tag":113,"props":563,"children":564},{},[565,600,605,610,659,766,815],{"type":50,"tag":117,"props":566,"children":567},{},[568,573,575,583,585,590,592,598],{"type":50,"tag":67,"props":569,"children":570},{},[571],{"type":56,"value":572},"Connect to the DUT",{"type":56,"value":574}," per the ",{"type":50,"tag":94,"props":576,"children":577},{"href":183},[578],{"type":50,"tag":99,"props":579,"children":581},{"className":580},[],[582],{"type":56,"value":190},{"type":56,"value":584},"\nsection below — resolve transport (ssh \u002F uart), credentials,\nand sudo method from the active profile's ",{"type":50,"tag":99,"props":586,"children":588},{"className":587},[],[589],{"type":56,"value":178},{"type":56,"value":591},"\nblock (with interactive fallback when fields are missing \u002F\nmarked ",{"type":50,"tag":99,"props":593,"children":595},{"className":594},[],[596],{"type":56,"value":597},"prompt",{"type":56,"value":599},"), then run the connection probe and refuse\nif it fails.",{"type":50,"tag":117,"props":601,"children":602},{},[603],{"type":56,"value":604},"Confirm boot reached userspace.",{"type":50,"tag":117,"props":606,"children":607},{},[608],{"type":56,"value":609},"Run the selected test suite (smoke, regression, focused\nper-customization, ad-hoc).",{"type":50,"tag":117,"props":611,"children":612},{},[613,618,620,626,628,634,636,641,643,649,651,657],{"type":50,"tag":67,"props":614,"children":615},{},[616],{"type":56,"value":617},"Loaded-module srcversion drift.",{"type":56,"value":619}," For modules a\ncustomization is known to have rebuilt, compare\n",{"type":50,"tag":99,"props":621,"children":623},{"className":622},[],[624],{"type":56,"value":625},"cat \u002Fsys\u002Fmodule\u002F\u003Cname>\u002Fsrcversion",{"type":56,"value":627}," on the DUT against the\n",{"type":50,"tag":99,"props":629,"children":631},{"className":630},[],[632],{"type":56,"value":633},"modinfo \u002Flib\u002Fmodules\u002F$(uname -r)\u002F...\u002F\u003Cname>.ko | awk '\u002Fsrcversion\u002F {print $2}'",{"type":56,"value":635}," reading. A mismatch means the\nkernel is running an older copy than the rootfs ships —\nalmost always a stale initramfs (the bootloader-side initrd\nshipped a pre-customize module, it loaded first, and the\nrootfs copy cannot replace a live module). Recommend\nre-running ",{"type":50,"tag":99,"props":637,"children":639},{"className":638},[],[640],{"type":56,"value":523},{"type":56,"value":642}," and re-flashing. Note:\nsome modules don't emit ",{"type":50,"tag":99,"props":644,"children":646},{"className":645},[],[647],{"type":56,"value":648},"srcversion",{"type":56,"value":650},"; fall back to an md5\ncheck against the binary the kernel loaded by extracting the\nregion under ",{"type":50,"tag":99,"props":652,"children":654},{"className":653},[],[655],{"type":56,"value":656},"\u002Fsys\u002Fmodule\u002F\u003Cname>\u002Fsections\u002F",{"type":56,"value":658}," or by comparing\nbehaviorally (printk \u002F sysfs nodes \u002F DT properties the new\nversion is known to expose).",{"type":50,"tag":117,"props":660,"children":661},{},[662,673,675,681,683,689,691,696,698,704,705,711,713,719,721,726,728,733,735,741,743,749,751,757,759,764],{"type":50,"tag":67,"props":663,"children":664},{},[665,667,672],{"type":56,"value":666},"Running kernel vs. rootfs kernel ",{"type":50,"tag":99,"props":668,"children":670},{"className":669},[],[671],{"type":56,"value":507},{"type":56,"value":359},{"type":56,"value":674}," Compare\n",{"type":50,"tag":99,"props":676,"children":678},{"className":677},[],[679],{"type":56,"value":680},"cat \u002Fproc\u002Fversion",{"type":56,"value":682}," (or ",{"type":50,"tag":99,"props":684,"children":686},{"className":685},[],[687],{"type":56,"value":688},"uname -v",{"type":56,"value":690},") on the DUT against the\n",{"type":50,"tag":99,"props":692,"children":694},{"className":693},[],[695],{"type":56,"value":491},{"type":56,"value":697}," string extracted from\n",{"type":50,"tag":99,"props":699,"children":701},{"className":700},[],[702],{"type":56,"value":703},"\u002Fboot\u002FImage",{"type":56,"value":242},{"type":50,"tag":99,"props":706,"children":708},{"className":707},[],[709],{"type":56,"value":710},"strings \u002Fboot\u002FImage | grep -m1 'Linux version'",{"type":56,"value":712},").\nA mismatch — usually the build timestamp \u002F ",{"type":50,"tag":99,"props":714,"children":716},{"className":715},[],[717],{"type":56,"value":718},"LOCALVERSION",{"type":56,"value":720}," —\nmeans the bootloader is running an older kernel ",{"type":50,"tag":99,"props":722,"children":724},{"className":723},[],[725],{"type":56,"value":507},{"type":56,"value":727}," than\nthe rootfs holds, almost certainly because a fresh ",{"type":50,"tag":99,"props":729,"children":731},{"className":730},[],[732],{"type":56,"value":507},{"type":56,"value":734},"\nwas promoted but the initramfs \u002F ",{"type":50,"tag":99,"props":736,"children":738},{"className":737},[],[739],{"type":56,"value":740},"extlinux.conf",{"type":56,"value":742}," \u002F QSPI\nboot partition wasn't refreshed. Modules in the rootfs\nwill then have a different vermagic and any subsequent\n",{"type":50,"tag":99,"props":744,"children":746},{"className":745},[],[747],{"type":56,"value":748},"modprobe",{"type":56,"value":750}," of a built-against-the-new-kernel ",{"type":50,"tag":99,"props":752,"children":754},{"className":753},[],[755],{"type":56,"value":756},".ko",{"type":56,"value":758}," will\nfail. Recommend ",{"type":50,"tag":99,"props":760,"children":762},{"className":761},[],[763],{"type":56,"value":523},{"type":56,"value":765}," and re-flash.",{"type":50,"tag":117,"props":767,"children":768},{},[769,774,776,782,784,790,792,797,799,805,807,813],{"type":50,"tag":67,"props":770,"children":771},{},[772],{"type":56,"value":773},"Userspace dmesg readability.",{"type":56,"value":775}," Ubuntu 22.04 sets\n",{"type":50,"tag":99,"props":777,"children":779},{"className":778},[],[780],{"type":56,"value":781},"kernel.dmesg_restrict=1",{"type":56,"value":783},"; non-root ",{"type":50,"tag":99,"props":785,"children":787},{"className":786},[],[788],{"type":56,"value":789},"dmesg",{"type":56,"value":791}," reads return\n\"Operation not permitted\" and silently zero hits. Every\n",{"type":50,"tag":99,"props":793,"children":795},{"className":794},[],[796],{"type":56,"value":789},{"type":56,"value":798},"-based check must run with ",{"type":50,"tag":99,"props":800,"children":802},{"className":801},[],[803],{"type":56,"value":804},"sudo",{"type":56,"value":806}," (or temporarily\nlower the restriction via ",{"type":50,"tag":99,"props":808,"children":810},{"className":809},[],[811],{"type":56,"value":812},"sudo sysctl kernel.dmesg_restrict=0",{"type":56,"value":814},"). Surfacing this in the validate\nlayer keeps printk-based customization checks honest.",{"type":50,"tag":117,"props":816,"children":817},{},[818],{"type":56,"value":819},"Collect results, logs, artifacts.",{"type":50,"tag":117,"props":821,"children":822},{},[823,828],{"type":50,"tag":67,"props":824,"children":825},{},[826],{"type":56,"value":827},"Summary",{"type":56,"value":829},": per-check pass\u002Ffail, overall verdict, where\nlogs and artifacts landed.",{"type":50,"tag":75,"props":831,"children":833},{"id":832},"dut-access",[834],{"type":56,"value":835},"DUT access",{"type":50,"tag":63,"props":837,"children":838},{},[839,841,846,848,854],{"type":56,"value":840},"The on-target leg needs a way to reach the just-flashed DUT.\nTwo transports are supported as full peers: ",{"type":50,"tag":99,"props":842,"children":844},{"className":843},[],[845],{"type":56,"value":203},{"type":56,"value":847}," (primary) and\n",{"type":50,"tag":99,"props":849,"children":851},{"className":850},[],[852],{"type":56,"value":853},"uart",{"type":56,"value":855}," (fallback for DUTs with no network).",{"type":50,"tag":63,"props":857,"children":858},{},[859,861,870],{"type":56,"value":860},"The contract is locked in but lives in\n",{"type":50,"tag":94,"props":862,"children":864},{"href":863},"references\u002Fdut-access.md",[865],{"type":50,"tag":99,"props":866,"children":868},{"className":867},[],[869],{"type":56,"value":863},{"type":56,"value":871}," to keep this\nSKILL.md under the agent-routing budget. That reference covers:",{"type":50,"tag":113,"props":873,"children":874},{},[875,887,892,913,926,939,952],{"type":50,"tag":117,"props":876,"children":877},{},[878,880,885],{"type":56,"value":879},"The ",{"type":50,"tag":99,"props":881,"children":883},{"className":882},[],[884],{"type":56,"value":178},{"type":56,"value":886}," profile schema (ssh, uart, sudo, workdir).",{"type":50,"tag":117,"props":888,"children":889},{},[890],{"type":56,"value":891},"Resolution order (profile → env var → interactive prompt) with\nthe full refusal-trigger table.",{"type":50,"tag":117,"props":893,"children":894},{},[895,897,903,905,911],{"type":56,"value":896},"The mandatory connection probe (",{"type":50,"tag":99,"props":898,"children":900},{"className":899},[],[901],{"type":56,"value":902},"uname -r",{"type":56,"value":904}," +\n",{"type":50,"tag":99,"props":906,"children":908},{"className":907},[],[909],{"type":56,"value":910},"cat \u002Fetc\u002Fnv_tegra_release",{"type":56,"value":912},") and its output-validation rules.",{"type":50,"tag":117,"props":914,"children":915},{},[916,918,924],{"type":56,"value":917},"File transfer per transport (",{"type":50,"tag":99,"props":919,"children":921},{"className":920},[],[922],{"type":56,"value":923},"scp",{"type":56,"value":925}," vs. base64-over-tty, with\nthe >100 KB warning).",{"type":50,"tag":117,"props":927,"children":928},{},[929,931,937],{"type":56,"value":930},"Sudo invocation matrix per ",{"type":50,"tag":99,"props":932,"children":934},{"className":933},[],[935],{"type":56,"value":936},"sudo.method",{"type":56,"value":938}," × transport.",{"type":50,"tag":117,"props":940,"children":941},{},[942,944,950],{"type":56,"value":943},"UART implementation contract that ",{"type":50,"tag":99,"props":945,"children":947},{"className":946},[],[948],{"type":56,"value":949},"scripts\u002Fuart_session.py",{"type":56,"value":951},"\nhonors (state machines for login \u002F exec \u002F push \u002F pull, exit\ncodes, robustness notes).",{"type":50,"tag":117,"props":953,"children":954},{},[955],{"type":56,"value":956},"Security notes (password handling, host-key pinning).",{"type":50,"tag":75,"props":958,"children":960},{"id":959},"available-scripts",[961],{"type":56,"value":962},"Available Scripts",{"type":50,"tag":964,"props":965,"children":966},"table",{},[967,990],{"type":50,"tag":968,"props":969,"children":970},"thead",{},[971],{"type":50,"tag":972,"props":973,"children":974},"tr",{},[975,981,985],{"type":50,"tag":976,"props":977,"children":978},"th",{},[979],{"type":56,"value":980},"Script",{"type":50,"tag":976,"props":982,"children":983},{},[984],{"type":56,"value":80},{"type":50,"tag":976,"props":986,"children":987},{},[988],{"type":56,"value":989},"Arguments",{"type":50,"tag":991,"props":992,"children":993},"tbody",{},[994],{"type":50,"tag":972,"props":995,"children":996},{},[997,1006,1011],{"type":50,"tag":998,"props":999,"children":1000},"td",{},[1001],{"type":50,"tag":99,"props":1002,"children":1004},{"className":1003},[],[1005],{"type":56,"value":949},{"type":50,"tag":998,"props":1007,"children":1008},{},[1009],{"type":56,"value":1010},"UART transport black box for the on-target leg: login, command exec (with optional sudo), and base64-over-tty file transfer. Replaces ssh when the DUT has no network or ssh is broken.",{"type":50,"tag":998,"props":1012,"children":1013},{},[1014],{"type":50,"tag":99,"props":1015,"children":1017},{"className":1016},[],[1018],{"type":56,"value":1019},"--tty \u003Cdev> [--baud \u003Cn>] --user \u003Cname> --password-env \u003CENVVAR> [--sudo-password-env \u003CENVVAR>] [--shell-prompt \u003Cregex>] [--lock-strategy refuse|wait] \u003Cprobe|exec|push|pull> [...]",{"type":50,"tag":63,"props":1021,"children":1022},{},[1023,1025,1031],{"type":56,"value":1024},"Invocation (the skill calls scripts as a subprocess — ",{"type":50,"tag":99,"props":1026,"children":1028},{"className":1027},[],[1029],{"type":56,"value":1030},"run_script()",{"type":56,"value":1032},"\nin agent-runtime terminology):",{"type":50,"tag":1034,"props":1035,"children":1040},"pre",{"className":1036,"code":1037,"language":1038,"meta":1039,"style":1039},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","# run_script: probe the DUT over UART\nDUT_UART_PASSWORD_ENV=DUT_UART_PWD \\\nDUT_UART_PWD=\"$(read -rs -p 'UART login pw: '; echo \"$REPLY\")\" \\\n  scripts\u002Fuart_session.py \\\n    --tty \u002Fdev\u002FttyACM0 --baud 115200 \\\n    --user ubuntu --password-env DUT_UART_PASSWORD_ENV \\\n    probe\n\n# run_script: exec a sudo command and capture exit code\nscripts\u002Fuart_session.py --tty \u002Fdev\u002FttyACM0 --user ubuntu \\\n  --password-env DUT_UART_PASSWORD_ENV \\\n  --sudo-password-env DUT_SUDO_PWD \\\n  exec --use-sudo 'dmesg | tail -200'\n","bash","",[1041],{"type":50,"tag":99,"props":1042,"children":1043},{"__ignoreMap":1039},[1044,1056,1084,1148,1161,1190,1218,1227,1237,1246,1276,1293,1311],{"type":50,"tag":1045,"props":1046,"children":1049},"span",{"class":1047,"line":1048},"line",1,[1050],{"type":50,"tag":1045,"props":1051,"children":1053},{"style":1052},"--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic",[1054],{"type":56,"value":1055},"# run_script: probe the DUT over UART\n",{"type":50,"tag":1045,"props":1057,"children":1059},{"class":1047,"line":1058},2,[1060,1066,1072,1078],{"type":50,"tag":1045,"props":1061,"children":1063},{"style":1062},"--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8",[1064],{"type":56,"value":1065},"DUT_UART_PASSWORD_ENV",{"type":50,"tag":1045,"props":1067,"children":1069},{"style":1068},"--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF",[1070],{"type":56,"value":1071},"=",{"type":50,"tag":1045,"props":1073,"children":1075},{"style":1074},"--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D",[1076],{"type":56,"value":1077},"DUT_UART_PWD",{"type":50,"tag":1045,"props":1079,"children":1081},{"style":1080},"--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B",[1082],{"type":56,"value":1083}," \\\n",{"type":50,"tag":1045,"props":1085,"children":1087},{"class":1047,"line":1086},3,[1088,1093,1098,1104,1109,1114,1119,1124,1129,1134,1139,1144],{"type":50,"tag":1045,"props":1089,"children":1090},{"style":1062},[1091],{"type":56,"value":1092},"DUT_UART_PWD=",{"type":50,"tag":1045,"props":1094,"children":1095},{"style":1068},[1096],{"type":56,"value":1097},"\"$(",{"type":50,"tag":1045,"props":1099,"children":1101},{"style":1100},"--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF",[1102],{"type":56,"value":1103},"read",{"type":50,"tag":1045,"props":1105,"children":1106},{"style":1074},[1107],{"type":56,"value":1108}," -rs -p ",{"type":50,"tag":1045,"props":1110,"children":1111},{"style":1068},[1112],{"type":56,"value":1113},"'",{"type":50,"tag":1045,"props":1115,"children":1116},{"style":1074},[1117],{"type":56,"value":1118},"UART login pw: ",{"type":50,"tag":1045,"props":1120,"children":1121},{"style":1068},[1122],{"type":56,"value":1123},"';",{"type":50,"tag":1045,"props":1125,"children":1126},{"style":1100},[1127],{"type":56,"value":1128}," echo",{"type":50,"tag":1045,"props":1130,"children":1131},{"style":1068},[1132],{"type":56,"value":1133}," \"",{"type":50,"tag":1045,"props":1135,"children":1136},{"style":1062},[1137],{"type":56,"value":1138},"$REPLY",{"type":50,"tag":1045,"props":1140,"children":1141},{"style":1068},[1142],{"type":56,"value":1143},"\")\"",{"type":50,"tag":1045,"props":1145,"children":1146},{"style":1062},[1147],{"type":56,"value":1083},{"type":50,"tag":1045,"props":1149,"children":1151},{"class":1047,"line":1150},4,[1152,1157],{"type":50,"tag":1045,"props":1153,"children":1154},{"style":1074},[1155],{"type":56,"value":1156},"  scripts\u002Fuart_session.py",{"type":50,"tag":1045,"props":1158,"children":1159},{"style":1062},[1160],{"type":56,"value":1083},{"type":50,"tag":1045,"props":1162,"children":1164},{"class":1047,"line":1163},5,[1165,1170,1175,1180,1186],{"type":50,"tag":1045,"props":1166,"children":1167},{"style":1074},[1168],{"type":56,"value":1169},"    --tty",{"type":50,"tag":1045,"props":1171,"children":1172},{"style":1074},[1173],{"type":56,"value":1174}," \u002Fdev\u002FttyACM0",{"type":50,"tag":1045,"props":1176,"children":1177},{"style":1074},[1178],{"type":56,"value":1179}," --baud",{"type":50,"tag":1045,"props":1181,"children":1183},{"style":1182},"--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C",[1184],{"type":56,"value":1185}," 115200",{"type":50,"tag":1045,"props":1187,"children":1188},{"style":1062},[1189],{"type":56,"value":1083},{"type":50,"tag":1045,"props":1191,"children":1193},{"class":1047,"line":1192},6,[1194,1199,1204,1209,1214],{"type":50,"tag":1045,"props":1195,"children":1196},{"style":1074},[1197],{"type":56,"value":1198},"    --user",{"type":50,"tag":1045,"props":1200,"children":1201},{"style":1074},[1202],{"type":56,"value":1203}," ubuntu",{"type":50,"tag":1045,"props":1205,"children":1206},{"style":1074},[1207],{"type":56,"value":1208}," --password-env",{"type":50,"tag":1045,"props":1210,"children":1211},{"style":1074},[1212],{"type":56,"value":1213}," DUT_UART_PASSWORD_ENV",{"type":50,"tag":1045,"props":1215,"children":1216},{"style":1062},[1217],{"type":56,"value":1083},{"type":50,"tag":1045,"props":1219,"children":1221},{"class":1047,"line":1220},7,[1222],{"type":50,"tag":1045,"props":1223,"children":1224},{"style":1074},[1225],{"type":56,"value":1226},"    probe\n",{"type":50,"tag":1045,"props":1228,"children":1230},{"class":1047,"line":1229},8,[1231],{"type":50,"tag":1045,"props":1232,"children":1234},{"emptyLinePlaceholder":1233},true,[1235],{"type":56,"value":1236},"\n",{"type":50,"tag":1045,"props":1238,"children":1240},{"class":1047,"line":1239},9,[1241],{"type":50,"tag":1045,"props":1242,"children":1243},{"style":1052},[1244],{"type":56,"value":1245},"# run_script: exec a sudo command and capture exit code\n",{"type":50,"tag":1045,"props":1247,"children":1249},{"class":1047,"line":1248},10,[1250,1254,1259,1263,1268,1272],{"type":50,"tag":1045,"props":1251,"children":1252},{"style":1080},[1253],{"type":56,"value":949},{"type":50,"tag":1045,"props":1255,"children":1256},{"style":1074},[1257],{"type":56,"value":1258}," --tty",{"type":50,"tag":1045,"props":1260,"children":1261},{"style":1074},[1262],{"type":56,"value":1174},{"type":50,"tag":1045,"props":1264,"children":1265},{"style":1074},[1266],{"type":56,"value":1267}," --user",{"type":50,"tag":1045,"props":1269,"children":1270},{"style":1074},[1271],{"type":56,"value":1203},{"type":50,"tag":1045,"props":1273,"children":1274},{"style":1062},[1275],{"type":56,"value":1083},{"type":50,"tag":1045,"props":1277,"children":1279},{"class":1047,"line":1278},11,[1280,1285,1289],{"type":50,"tag":1045,"props":1281,"children":1282},{"style":1074},[1283],{"type":56,"value":1284},"  --password-env",{"type":50,"tag":1045,"props":1286,"children":1287},{"style":1074},[1288],{"type":56,"value":1213},{"type":50,"tag":1045,"props":1290,"children":1291},{"style":1062},[1292],{"type":56,"value":1083},{"type":50,"tag":1045,"props":1294,"children":1296},{"class":1047,"line":1295},12,[1297,1302,1307],{"type":50,"tag":1045,"props":1298,"children":1299},{"style":1074},[1300],{"type":56,"value":1301},"  --sudo-password-env",{"type":50,"tag":1045,"props":1303,"children":1304},{"style":1074},[1305],{"type":56,"value":1306}," DUT_SUDO_PWD",{"type":50,"tag":1045,"props":1308,"children":1309},{"style":1062},[1310],{"type":56,"value":1083},{"type":50,"tag":1045,"props":1312,"children":1314},{"class":1047,"line":1313},13,[1315,1320,1325,1330,1335],{"type":50,"tag":1045,"props":1316,"children":1317},{"style":1074},[1318],{"type":56,"value":1319},"  exec",{"type":50,"tag":1045,"props":1321,"children":1322},{"style":1074},[1323],{"type":56,"value":1324}," --use-sudo",{"type":50,"tag":1045,"props":1326,"children":1327},{"style":1068},[1328],{"type":56,"value":1329}," '",{"type":50,"tag":1045,"props":1331,"children":1332},{"style":1074},[1333],{"type":56,"value":1334},"dmesg | tail -200",{"type":50,"tag":1045,"props":1336,"children":1337},{"style":1068},[1338],{"type":56,"value":1339},"'\n",{"type":50,"tag":63,"props":1341,"children":1342},{},[1343,1345,1355],{"type":56,"value":1344},"The script's exit code is the contract — see the exit-code table in\n",{"type":50,"tag":94,"props":1346,"children":1348},{"href":1347},"references\u002Fdut-access.md#uart-implementation-contract",[1349],{"type":50,"tag":99,"props":1350,"children":1352},{"className":1351},[],[1353],{"type":56,"value":1354},"UART implementation contract",{"type":56,"value":359},{"type":50,"tag":75,"props":1357,"children":1359},{"id":1358},"examples",[1360],{"type":56,"value":1361},"Examples",{"type":50,"tag":63,"props":1363,"children":1364},{},[1365],{"type":56,"value":1366},"Static-only validation (no DUT needed):",{"type":50,"tag":1034,"props":1368,"children":1372},{"className":1369,"code":1371,"language":56},[1370],"language-text","\u002Fjetson-validate-image\n> static checks only against the staged BSP\n",[1373],{"type":50,"tag":99,"props":1374,"children":1375},{"__ignoreMap":1039},[1376],{"type":56,"value":1371},{"type":50,"tag":63,"props":1378,"children":1379},{},[1380],{"type":56,"value":1381},"On-target validation over SSH after a freshly flashed DUT:",{"type":50,"tag":1034,"props":1383,"children":1386},{"className":1384,"code":1385,"language":56},[1370],"\u002Fjetson-flash-image\n   ↓\n\u002Fjetson-validate-image\n> on-target checks via dut_access.ssh\n",[1387],{"type":50,"tag":99,"props":1388,"children":1389},{"__ignoreMap":1039},[1390],{"type":56,"value":1385},{"type":50,"tag":63,"props":1392,"children":1393},{},[1394],{"type":56,"value":1395},"On-target validation over UART (no network on the DUT):",{"type":50,"tag":1034,"props":1397,"children":1400},{"className":1398,"code":1399,"language":56},[1370],"\u002Fjetson-validate-image\n> use the uart transport at \u002Fdev\u002FttyACM0; the dut_access.uart block\n  in the profile already has the tty and login_password_env wired up\n",[1401],{"type":50,"tag":99,"props":1402,"children":1403},{"__ignoreMap":1039},[1404],{"type":56,"value":1399},{"type":50,"tag":75,"props":1406,"children":1408},{"id":1407},"limitations",[1409],{"type":56,"value":1410},"Limitations",{"type":50,"tag":113,"props":1412,"children":1413},{},[1414,1435,1440,1458,1479,1507],{"type":50,"tag":117,"props":1415,"children":1416},{},[1417,1419,1425,1427,1433],{"type":56,"value":1418},"Placeholder skill — only the DUT-access contract and the\n",{"type":50,"tag":99,"props":1420,"children":1422},{"className":1421},[],[1423],{"type":56,"value":1424},"uart_session.py",{"type":56,"value":1426}," helper are locked in. The static-check list,\ntest-suite selection, result-sink layout, and pass\u002Ffail policy\nare tracked under ",{"type":50,"tag":99,"props":1428,"children":1430},{"className":1429},[],[1431],{"type":56,"value":1432},"## Open items",{"type":56,"value":1434}," and may change.",{"type":50,"tag":117,"props":1436,"children":1437},{},[1438],{"type":56,"value":1439},"UART file transfer is byte-banged base64 at ~10 KB\u002Fs on 115200\nbaud — emits a warning for sources > 100 KB but proceeds. For\nhigh-volume transfers, switch to the SSH transport.",{"type":50,"tag":117,"props":1441,"children":1442},{},[1443,1448,1450],{"type":50,"tag":99,"props":1444,"children":1446},{"className":1445},[],[1447],{"type":56,"value":1424},{"type":56,"value":1449}," opens and closes the tty per subcommand\ninvocation (~1–2 s login per call). Validation passes running\n",{"type":50,"tag":59,"props":1451,"children":1452},{},[1453],{"type":50,"tag":63,"props":1454,"children":1455},{},[1456],{"type":56,"value":1457},"10 commands amortize poorly on UART; prefer SSH.",{"type":50,"tag":117,"props":1459,"children":1460},{},[1461,1463,1469,1471,1477],{"type":56,"value":1462},"SSH uses ",{"type":50,"tag":99,"props":1464,"children":1466},{"className":1465},[],[1467],{"type":56,"value":1468},"StrictHostKeyChecking=accept-new",{"type":56,"value":1470}," with a per-profile\n",{"type":50,"tag":99,"props":1472,"children":1474},{"className":1473},[],[1475],{"type":56,"value":1476},"known_hosts",{"type":56,"value":1478}," file. A fingerprint change refuses — typically\nmeans the DUT was reflashed (host keys regenerated) or the IP\nwas reassigned. Remove the per-profile entry manually rather\nthan auto-accepting.",{"type":50,"tag":117,"props":1480,"children":1481},{},[1482,1484,1489,1491,1497,1499,1505],{"type":56,"value":1483},"Passwords are never inlined in the profile YAML — only\n",{"type":50,"tag":99,"props":1485,"children":1487},{"className":1486},[],[1488],{"type":56,"value":248},{"type":56,"value":1490}," (env-var name) is persisted. ",{"type":50,"tag":99,"props":1492,"children":1494},{"className":1493},[],[1495],{"type":56,"value":1496},"auth=prompt",{"type":56,"value":1498}," \u002F\n",{"type":50,"tag":99,"props":1500,"children":1502},{"className":1501},[],[1503],{"type":56,"value":1504},"sudo.method=prompt",{"type":56,"value":1506}," exposes the password in the conversation\nlog, which is the user's responsibility to manage.",{"type":50,"tag":117,"props":1508,"children":1509},{},[1510,1516,1518,1524,1526,1531],{"type":50,"tag":99,"props":1511,"children":1513},{"className":1512},[],[1514],{"type":56,"value":1515},"transport=uart",{"type":56,"value":1517}," with ",{"type":50,"tag":99,"props":1519,"children":1521},{"className":1520},[],[1522],{"type":56,"value":1523},"lock_strategy=steal",{"type":56,"value":1525}," is ",{"type":50,"tag":67,"props":1527,"children":1528},{},[1529],{"type":56,"value":1530},"not implemented",{"type":56,"value":1532},"\n(would require sending control characters that could corrupt the\nholder's state).",{"type":50,"tag":75,"props":1534,"children":1536},{"id":1535},"troubleshooting",[1537],{"type":56,"value":1538},"Troubleshooting",{"type":50,"tag":964,"props":1540,"children":1541},{},[1542,1563],{"type":50,"tag":968,"props":1543,"children":1544},{},[1545],{"type":50,"tag":972,"props":1546,"children":1547},{},[1548,1553,1558],{"type":50,"tag":976,"props":1549,"children":1550},{},[1551],{"type":56,"value":1552},"Error",{"type":50,"tag":976,"props":1554,"children":1555},{},[1556],{"type":56,"value":1557},"Cause",{"type":50,"tag":976,"props":1559,"children":1560},{},[1561],{"type":56,"value":1562},"Solution",{"type":50,"tag":991,"props":1564,"children":1565},{},[1566,1605,1645,1698,1741,1774,1822,1865,1931],{"type":50,"tag":972,"props":1567,"children":1568},{},[1569,1580,1593],{"type":50,"tag":998,"props":1570,"children":1571},{},[1572,1578],{"type":50,"tag":99,"props":1573,"children":1575},{"className":1574},[],[1576],{"type":56,"value":1577},"no DUT transport configured",{"type":56,"value":1579}," (refuse)",{"type":50,"tag":998,"props":1581,"children":1582},{},[1583,1585,1591],{"type":56,"value":1584},"On-target scope requested but ",{"type":50,"tag":99,"props":1586,"children":1588},{"className":1587},[],[1589],{"type":56,"value":1590},"dut_access.transport",{"type":56,"value":1592}," unresolved across profile \u002F env \u002F interactive prompt",{"type":50,"tag":998,"props":1594,"children":1595},{},[1596,1598,1603],{"type":56,"value":1597},"Author ",{"type":50,"tag":99,"props":1599,"children":1601},{"className":1600},[],[1602],{"type":56,"value":178},{"type":56,"value":1604}," in the active profile, or rerun with static-only scope.",{"type":50,"tag":972,"props":1606,"children":1607},{},[1608,1618,1634],{"type":50,"tag":998,"props":1609,"children":1610},{},[1611,1617],{"type":50,"tag":99,"props":1612,"children":1614},{"className":1613},[],[1615],{"type":56,"value":1616},"$PASSWORD_ENV is unset",{"type":56,"value":1579},{"type":50,"tag":998,"props":1619,"children":1620},{},[1621,1626,1627,1632],{"type":50,"tag":99,"props":1622,"children":1624},{"className":1623},[],[1625],{"type":56,"value":232},{"type":56,"value":682},{"type":50,"tag":99,"props":1628,"children":1630},{"className":1629},[],[1631],{"type":56,"value":240},{"type":56,"value":1633},") names an env var that isn't exported on the host",{"type":50,"tag":998,"props":1635,"children":1636},{},[1637,1643],{"type":50,"tag":99,"props":1638,"children":1640},{"className":1639},[],[1641],{"type":56,"value":1642},"export \u003CENVVAR>=...",{"type":56,"value":1644}," before invoking the skill; do NOT inline the password in YAML.",{"type":50,"tag":972,"props":1646,"children":1647},{},[1648,1659,1678],{"type":50,"tag":998,"props":1649,"children":1650},{},[1651,1657],{"type":50,"tag":99,"props":1652,"children":1654},{"className":1653},[],[1655],{"type":56,"value":1656},"tty held by another process",{"type":56,"value":1658}," (refuse, exit 3)",{"type":50,"tag":998,"props":1660,"children":1661},{},[1662,1668,1670,1676],{"type":50,"tag":99,"props":1663,"children":1665},{"className":1664},[],[1666],{"type":56,"value":1667},"lock_strategy=refuse",{"type":56,"value":1669}," and ",{"type":50,"tag":99,"props":1671,"children":1673},{"className":1672},[],[1674],{"type":56,"value":1675},"fuser",{"type":56,"value":1677}," reports another holder (minicom, picocom, getty)",{"type":50,"tag":998,"props":1679,"children":1680},{},[1681,1683,1689,1691,1697],{"type":56,"value":1682},"Close the holding process (",{"type":50,"tag":99,"props":1684,"children":1686},{"className":1685},[],[1687],{"type":56,"value":1688},"sudo fuser -k \u003Ctty>",{"type":56,"value":1690}," only if you know what's there), or rerun with ",{"type":50,"tag":99,"props":1692,"children":1694},{"className":1693},[],[1695],{"type":56,"value":1696},"lock_strategy=wait",{"type":56,"value":359},{"type":50,"tag":972,"props":1699,"children":1700},{},[1701,1712,1724],{"type":50,"tag":998,"props":1702,"children":1703},{},[1704,1710],{"type":50,"tag":99,"props":1705,"children":1707},{"className":1706},[],[1708],{"type":56,"value":1709},"pyserial import failed",{"type":56,"value":1711}," (exit 4)",{"type":50,"tag":998,"props":1713,"children":1714},{},[1715,1717,1722],{"type":56,"value":1716},"UART transport selected but ",{"type":50,"tag":99,"props":1718,"children":1720},{"className":1719},[],[1721],{"type":56,"value":219},{"type":56,"value":1723}," not installed in the skill's Python",{"type":50,"tag":998,"props":1725,"children":1726},{},[1727,1733,1734,1740],{"type":50,"tag":99,"props":1728,"children":1730},{"className":1729},[],[1731],{"type":56,"value":1732},"apt install python3-serial",{"type":56,"value":533},{"type":50,"tag":99,"props":1735,"children":1737},{"className":1736},[],[1738],{"type":56,"value":1739},"pip install pyserial",{"type":56,"value":359},{"type":50,"tag":972,"props":1742,"children":1743},{},[1744,1749,1761],{"type":50,"tag":998,"props":1745,"children":1746},{},[1747],{"type":56,"value":1748},"SSH fingerprint refused",{"type":50,"tag":998,"props":1750,"children":1751},{},[1752,1754,1759],{"type":56,"value":1753},"DUT's host keys changed since the per-profile ",{"type":50,"tag":99,"props":1755,"children":1757},{"className":1756},[],[1758],{"type":56,"value":1476},{"type":56,"value":1760}," was pinned (typically a reflash)",{"type":50,"tag":998,"props":1762,"children":1763},{},[1764,1766,1772],{"type":56,"value":1765},"Remove the matching line from ",{"type":50,"tag":99,"props":1767,"children":1769},{"className":1768},[],[1770],{"type":56,"value":1771},"\u003Cworkspace>\u002Ftarget-platform\u002F\u003Cprofile-stem>.known_hosts",{"type":56,"value":1773}," and rerun — the new key will be accepted on first connect.",{"type":50,"tag":972,"props":1775,"children":1776},{},[1777,1788,1793],{"type":50,"tag":998,"props":1778,"children":1779},{},[1780,1786],{"type":50,"tag":99,"props":1781,"children":1783},{"className":1782},[],[1784],{"type":56,"value":1785},"login failed",{"type":56,"value":1787}," (exit 128)",{"type":50,"tag":998,"props":1789,"children":1790},{},[1791],{"type":56,"value":1792},"UART probe couldn't match a login or shell prompt within timeout",{"type":50,"tag":998,"props":1794,"children":1795},{},[1796,1798,1804,1806,1812,1814,1820],{"type":56,"value":1797},"Confirm the DUT is powered + booted to userspace; check ",{"type":50,"tag":99,"props":1799,"children":1801},{"className":1800},[],[1802],{"type":56,"value":1803},"--shell-prompt",{"type":56,"value":1805}," override if the DUT carries an unusual ",{"type":50,"tag":99,"props":1807,"children":1809},{"className":1808},[],[1810],{"type":56,"value":1811},"PS1",{"type":56,"value":1813},"; verify the ",{"type":50,"tag":99,"props":1815,"children":1817},{"className":1816},[],[1818],{"type":56,"value":1819},"--user",{"type":56,"value":1821}," matches a real account.",{"type":50,"tag":972,"props":1823,"children":1824},{},[1825,1836,1853],{"type":50,"tag":998,"props":1826,"children":1827},{},[1828,1834],{"type":50,"tag":99,"props":1829,"children":1831},{"className":1830},[],[1832],{"type":56,"value":1833},"DUT not booted from the just-flashed BSP",{"type":56,"value":1835}," (warn \u002F refuse)",{"type":50,"tag":998,"props":1837,"children":1838},{},[1839,1845,1847],{"type":50,"tag":99,"props":1840,"children":1842},{"className":1841},[],[1843],{"type":56,"value":1844},"\u002Fetc\u002Fnv_tegra_release",{"type":56,"value":1846}," on the DUT doesn't match ",{"type":50,"tag":99,"props":1848,"children":1850},{"className":1849},[],[1851],{"type":56,"value":1852},"bsp_image.version",{"type":50,"tag":998,"props":1854,"children":1855},{},[1856,1858,1863],{"type":56,"value":1857},"Re-run ",{"type":50,"tag":99,"props":1859,"children":1861},{"className":1860},[],[1862],{"type":56,"value":167},{"type":56,"value":1864}," and confirm the DUT actually power-cycled into the new BSP, not the previous one.",{"type":50,"tag":972,"props":1866,"children":1867},{},[1868,1879,1906],{"type":50,"tag":998,"props":1869,"children":1870},{},[1871,1877],{"type":50,"tag":99,"props":1872,"children":1874},{"className":1873},[],[1875],{"type":56,"value":1876},"sudo prompt detected but no sudo password configured",{"type":56,"value":1878}," (exit 130)",{"type":50,"tag":998,"props":1880,"children":1881},{},[1882,1888,1890,1896,1898,1904],{"type":50,"tag":99,"props":1883,"children":1885},{"className":1884},[],[1886],{"type":56,"value":1887},"--use-sudo",{"type":56,"value":1889}," passed to ",{"type":50,"tag":99,"props":1891,"children":1893},{"className":1892},[],[1894],{"type":56,"value":1895},"uart_session.py exec",{"type":56,"value":1897}," but ",{"type":50,"tag":99,"props":1899,"children":1901},{"className":1900},[],[1902],{"type":56,"value":1903},"--sudo-password-env",{"type":56,"value":1905}," not set, and DUT user lacks NOPASSWD",{"type":50,"tag":998,"props":1907,"children":1908},{},[1909,1911,1916,1917,1922,1924,1930],{"type":56,"value":1910},"Set ",{"type":50,"tag":99,"props":1912,"children":1914},{"className":1913},[],[1915],{"type":56,"value":240},{"type":56,"value":205},{"type":50,"tag":99,"props":1918,"children":1920},{"className":1919},[],[1921],{"type":56,"value":256},{"type":56,"value":1923}," in the profile, or grant NOPASSWD on the DUT via ",{"type":50,"tag":99,"props":1925,"children":1927},{"className":1926},[],[1928],{"type":56,"value":1929},"\u002Fetc\u002Fsudoers.d\u002F",{"type":56,"value":359},{"type":50,"tag":972,"props":1932,"children":1933},{},[1934,1945,1950],{"type":50,"tag":998,"props":1935,"children":1936},{},[1937,1943],{"type":50,"tag":99,"props":1938,"children":1940},{"className":1939},[],[1941],{"type":56,"value":1942},"command timed out",{"type":56,"value":1944}," (exit 129)",{"type":50,"tag":998,"props":1946,"children":1947},{},[1948],{"type":56,"value":1949},"Long-running DUT command exceeded the script's timeout",{"type":50,"tag":998,"props":1951,"children":1952},{},[1953,1955,1960],{"type":56,"value":1954},"Run the command directly via ",{"type":50,"tag":99,"props":1956,"children":1958},{"className":1957},[],[1959],{"type":56,"value":203},{"type":56,"value":1961}," transport, or split into shorter steps.",{"type":50,"tag":75,"props":1963,"children":1965},{"id":1964},"references",[1966],{"type":56,"value":1967},"References",{"type":50,"tag":113,"props":1969,"children":1970},{},[1971,1984,1998,2012],{"type":50,"tag":117,"props":1972,"children":1973},{},[1974,1982],{"type":50,"tag":94,"props":1975,"children":1976},{"href":863},[1977],{"type":50,"tag":99,"props":1978,"children":1980},{"className":1979},[],[1981],{"type":56,"value":863},{"type":56,"value":1983}," — full DUT-access contract: profile schema, resolution order, probe, file transfer, sudo, UART implementation, security.",{"type":50,"tag":117,"props":1985,"children":1986},{},[1987,1996],{"type":50,"tag":94,"props":1988,"children":1990},{"href":1989},"..\u002F..\u002Fcontext\u002Ftarget-platform-contract.md",[1991],{"type":50,"tag":99,"props":1992,"children":1994},{"className":1993},[],[1995],{"type":56,"value":1989},{"type":56,"value":1997}," — target-platform contract.",{"type":50,"tag":117,"props":1999,"children":2000},{},[2001,2010],{"type":50,"tag":94,"props":2002,"children":2004},{"href":2003},"..\u002F..\u002Fcontext\u002Fbsp-customization-workflow.md#workflow-invariants",[2005],{"type":50,"tag":99,"props":2006,"children":2008},{"className":2007},[],[2009],{"type":56,"value":96},{"type":56,"value":2011}," — Workspace edit protocol (this skill is the Deploy tail).",{"type":50,"tag":117,"props":2013,"children":2014},{},[2015,2024],{"type":50,"tag":94,"props":2016,"children":2018},{"href":2017},"..\u002Fjetson-build-source\u002FSKILL.md",[2019],{"type":50,"tag":99,"props":2020,"children":2022},{"className":2021},[],[2023],{"type":56,"value":2017},{"type":56,"value":2025}," — Build builder; produces the artifacts this skill validates.",{"type":50,"tag":2027,"props":2028,"children":2029},"style",{},[2030],{"type":56,"value":2031},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"items":2033,"total":2135},[2034,2051,2065,2079,2089,2106,2121],{"slug":2035,"name":2035,"fn":2036,"description":2037,"org":2038,"tags":2039,"stars":23,"repoUrl":24,"updatedAt":2050},"accelerated-computing-cudf","accelerate data processing with cuDF","Official NVIDIA-authored guidance for NVIDIA cuDF GPU DataFrames, pandas acceleration, dask-cuDF, ETL, joins, groupby, CSV\u002FParquet I\u002FO, nullable semantics, and multi-GPU DataFrame workloads.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2040,2043,2046,2047],{"name":2041,"slug":2042,"type":15},"Data Analysis","data-analysis",{"name":2044,"slug":2045,"type":15},"Data Engineering","data-engineering",{"name":9,"slug":8,"type":15},{"name":2048,"slug":2049,"type":15},"Performance","performance","2026-07-14T05:28:43.176466",{"slug":2052,"name":2052,"fn":2053,"description":2054,"org":2055,"tags":2056,"stars":23,"repoUrl":24,"updatedAt":2064},"aiq-deploy","deploy and manage NVIDIA AI-Q infrastructure","Use when asked to install, deploy, run, validate, troubleshoot, or stop NVIDIA AI-Q Blueprint infrastructure.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2057,2060,2063],{"name":2058,"slug":2059,"type":15},"Deployment","deployment",{"name":2061,"slug":2062,"type":15},"Infrastructure","infrastructure",{"name":9,"slug":8,"type":15},"2026-07-14T05:29:06.667109",{"slug":2066,"name":2066,"fn":2067,"description":2068,"org":2069,"tags":2070,"stars":23,"repoUrl":24,"updatedAt":2078},"aiq-research","conduct deep research with AI-Q","Use when asked to run deep research or AI-Q research through a reachable NVIDIA AI-Q Blueprint backend.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2071,2074,2075],{"name":2072,"slug":2073,"type":15},"Agents","agents",{"name":9,"slug":8,"type":15},{"name":2076,"slug":2077,"type":15},"Research","research","2026-07-14T05:28:06.816956",{"slug":2080,"name":2080,"fn":2081,"description":2082,"org":2083,"tags":2084,"stars":23,"repoUrl":24,"updatedAt":2088},"amc-run-sample-calibration","run AMC sample dataset calibration","Run end-to-end calibration on the shipped sample dataset (sdg_08_2_sample_data_010926.zip) against a running AMC microservice. Use when user says 'test sample dataset', 'run sample calibration', 'verify AMC install', or 'launch and test'.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2085,2086,2087],{"name":2041,"slug":2042,"type":15},{"name":9,"slug":8,"type":15},{"name":21,"slug":22,"type":15},"2026-07-17T05:29:03.913266",{"slug":2090,"name":2090,"fn":2091,"description":2092,"org":2093,"tags":2094,"stars":23,"repoUrl":24,"updatedAt":2105},"amc-run-video-calibration","calibrate video datasets with AutoMagicCalib","Calibrate a new dataset from pre-recorded video files via the AutoMagicCalib REST API. Use when user has local MP4s and says 'calibrate my videos', 'run AMC on these videos', or similar. For RTSP\u002Flive streams, use amc-run-rtsp-calibration instead.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2095,2098,2101,2102],{"name":2096,"slug":2097,"type":15},"Automation","automation",{"name":2099,"slug":2100,"type":15},"Imaging","imaging",{"name":9,"slug":8,"type":15},{"name":2103,"slug":2104,"type":15},"Video","video","2026-07-17T05:28:53.905004",{"slug":2107,"name":2107,"fn":2108,"description":2109,"org":2110,"tags":2111,"stars":23,"repoUrl":24,"updatedAt":2120},"amc-setup-calibration-stack","deploy AutoMagicCalib microservice with Docker","Launch AutoMagicCalib microservice and web UI from NGC release images via Docker Compose. Use when user says 'deploy auto calibration', 'launch auto calibration', 'launch AMC', 'start MS+UI', or 'set up auto-magic-calib'. Requires NGC API key.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2112,2113,2116,2117],{"name":2058,"slug":2059,"type":15},{"name":2114,"slug":2115,"type":15},"Docker","docker",{"name":9,"slug":8,"type":15},{"name":2118,"slug":2119,"type":15},"Operations","operations","2026-07-17T05:28:56.913999",{"slug":2122,"name":2122,"fn":2123,"description":2124,"org":2125,"tags":2126,"stars":23,"repoUrl":24,"updatedAt":2134},"cudaq-guide","develop quantum applications with CUDA-Q","CUDA-Q onboarding guide for installation, test programs, GPU simulation, QPU hardware, and quantum applications.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2127,2128,2131],{"name":9,"slug":8,"type":15},{"name":2129,"slug":2130,"type":15},"Quantum Computing","quantum-computing",{"name":2132,"slug":2133,"type":15},"Simulation","simulation","2026-07-14T05:26:58.898253",305,{"items":2137,"total":2286},[2138,2156,2172,2183,2195,2209,2222,2236,2245,2254,2268,2277],{"slug":2139,"name":2139,"fn":2140,"description":2141,"org":2142,"tags":2143,"stars":2153,"repoUrl":2154,"updatedAt":2155},"nemoclaw-user-guide","retrieve NemoClaw documentation and configuration","Guides human users' AI agents to the NemoClaw docs MCP server and canonical Fern documentation in Markdown form. Use when users ask how to install, configure, operate, troubleshoot, secure, or learn NemoClaw with an AI coding assistant. Trigger keywords - nemoclaw docs, use nemoclaw with ai agent, nemoclaw mcp docs, nemoclaw install help, nemoclaw quickstart, nemoclaw markdown docs, llms.txt, agent skills.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2144,2147,2150],{"name":2145,"slug":2146,"type":15},"Documentation","documentation",{"name":2148,"slug":2149,"type":15},"MCP","mcp",{"name":2151,"slug":2152,"type":15},"Search","search",21777,"https:\u002F\u002Fgithub.com\u002FNVIDIA\u002FNemoClaw","2026-07-20T06:00:01.461044",{"slug":2157,"name":2157,"fn":2158,"description":2159,"org":2160,"tags":2161,"stars":2169,"repoUrl":2170,"updatedAt":2171},"mcore-build-and-dependency","manage Megatron-LM development environments","Container-based dev environment setup and dependency management for Megatron-LM. Covers acquiring and launching the CI container, uv package management, and updating uv.lock.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2162,2165,2166],{"name":2163,"slug":2164,"type":15},"Containers","containers",{"name":2058,"slug":2059,"type":15},{"name":2167,"slug":2168,"type":15},"Python","python",17049,"https:\u002F\u002Fgithub.com\u002FNVIDIA\u002FMegatron-LM","2026-07-27T06:06:11.249662",{"slug":2173,"name":2173,"fn":2174,"description":2175,"org":2176,"tags":2177,"stars":2169,"repoUrl":2170,"updatedAt":2182},"mcore-bump-base-image","update NVIDIA PyTorch base images","Bump the NVIDIA PyTorch base image (`nvcr.io\u002Fnvidia\u002Fpytorch:YY.MM-py3`) used by Megatron-LM CI. Covers the two pin sites (GitHub CI in `docker\u002F.ngc_version.dev` and GitLab CI in `.gitlab\u002Fstages\u002F01.build.yml`), the post-bump CI loop (re-run functional tests, refresh golden values, mark broken tests), and the gotchas that bit PRs",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2178,2181],{"name":2179,"slug":2180,"type":15},"CI\u002FCD","ci-cd",{"name":2058,"slug":2059,"type":15},"2026-07-14T05:25:59.97109",{"slug":2184,"name":2184,"fn":2185,"description":2186,"org":2187,"tags":2188,"stars":2169,"repoUrl":2170,"updatedAt":2194},"mcore-cicd","manage CI\u002FCD pipelines for Megatron-LM","CI\u002FCD reference for Megatron-LM. Covers CI pipeline structure, PR scope labels, triggering internal GitLab CI (which force-pushes the current branch to a pull-request\u002FBRANCH ref — always dry-run and verify the destination first; never run against shared or protected branches), and CI failure investigation.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2189,2190,2191],{"name":2179,"slug":2180,"type":15},{"name":2058,"slug":2059,"type":15},{"name":2192,"slug":2193,"type":15},"GitHub","github","2026-07-27T06:06:12.278222",{"slug":2196,"name":2196,"fn":2197,"description":2198,"org":2199,"tags":2200,"stars":2169,"repoUrl":2170,"updatedAt":2208},"mcore-create-issue","investigate CI failures and create issues","Investigate a failing GitHub Actions run or job and create a GitHub issue for the failure.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2201,2204,2205],{"name":2202,"slug":2203,"type":15},"Debugging","debugging",{"name":2192,"slug":2193,"type":15},{"name":2206,"slug":2207,"type":15},"Triage","triage","2026-07-14T05:25:57.442089",{"slug":2210,"name":2210,"fn":2211,"description":2212,"org":2213,"tags":2214,"stars":2169,"repoUrl":2170,"updatedAt":2221},"mcore-linting-and-formatting","lint and format Megatron-LM code","Linting and formatting for Megatron-LM. Covers running autoformat.sh, tools (ruff, black, isort, pylint, mypy), and code style rules.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2215,2218],{"name":2216,"slug":2217,"type":15},"Best Practices","best-practices",{"name":2219,"slug":2220,"type":15},"Code Analysis","code-analysis","2026-07-14T05:25:56.18433",{"slug":2223,"name":2223,"fn":2224,"description":2225,"org":2226,"tags":2227,"stars":2169,"repoUrl":2170,"updatedAt":2235},"mcore-migrate-gpt-to-hybrid","migrate Megatron-LM models to HybridModel","Migration guide for moving Megatron Core GPTModel checkpoints, model providers, training commands, and layer mappings to HybridModel.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2228,2231,2234],{"name":2229,"slug":2230,"type":15},"Machine Learning","machine-learning",{"name":2232,"slug":2233,"type":15},"Migration","migration",{"name":9,"slug":8,"type":15},"2026-07-17T06:07:11.777011",{"slug":2237,"name":2237,"fn":2238,"description":2239,"org":2240,"tags":2241,"stars":2169,"repoUrl":2170,"updatedAt":2244},"mcore-onboard-gb200-1node-tests","onboard functional tests for GB200","Onboard 1-node GitHub MR functional tests for GB200 from existing mr-scoped 2-node tests.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2242,2243],{"name":17,"slug":18,"type":15},{"name":21,"slug":22,"type":15},"2026-07-14T05:25:53.673039",{"slug":2246,"name":2246,"fn":2247,"description":2248,"org":2249,"tags":2250,"stars":2169,"repoUrl":2170,"updatedAt":2253},"mcore-run-on-slurm","launch distributed training jobs on SLURM","How to launch distributed Megatron-LM training jobs on a SLURM cluster. Covers a minimal sbatch skeleton, environment-variable setup for torch.distributed.run, CUDA_DEVICE_MAX_CONNECTIONS rules across hardware and parallelism modes, container conventions, monitoring, and per-rank failure diagnosis.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2251,2252],{"name":2058,"slug":2059,"type":15},{"name":2061,"slug":2062,"type":15},"2026-07-14T05:25:49.362534",{"slug":2255,"name":2255,"fn":2256,"description":2257,"org":2258,"tags":2259,"stars":2169,"repoUrl":2170,"updatedAt":2267},"mcore-split-pr","split pull requests to reduce review load","Split a PR into multiple PRs to reduce the number of required CODEOWNERS reviewer groups.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2260,2263,2264],{"name":2261,"slug":2262,"type":15},"Code Review","code-review",{"name":2192,"slug":2193,"type":15},{"name":2265,"slug":2266,"type":15},"Pull Requests","pull-requests","2026-07-14T05:26:01.226578",{"slug":2269,"name":2269,"fn":2270,"description":2271,"org":2272,"tags":2273,"stars":2169,"repoUrl":2170,"updatedAt":2276},"mcore-testing","run and manage Megatron-LM tests","Test system for Megatron-LM. Covers test layout, recipe YAML structure, adding and running unit and functional tests, golden values, marker filters, and CI parity.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2274,2275],{"name":17,"slug":18,"type":15},{"name":21,"slug":22,"type":15},"2026-07-14T05:25:54.928983",{"slug":2278,"name":2278,"fn":2279,"description":2280,"org":2281,"tags":2282,"stars":2169,"repoUrl":2170,"updatedAt":2285},"nightly-sync","manage nightly main-to-dev sync workflows","Domain knowledge for the nightly main-to-dev sync workflow. Covers merge strategy, CI architecture, failure investigation, and known issues.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2283,2284],{"name":2096,"slug":2097,"type":15},{"name":2179,"slug":2180,"type":15},"2026-07-30T05:29:03.275638",496]