diff --git a/AGENTS.md b/AGENTS.md index 967dd86..71efbd9 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -24,7 +24,7 @@ This repository checks one NVIDIA CMP 170HX at a time on a fresh Ubuntu 26.04 x8 ## Working in this repository -- Git is **local only**. Do not run `git push`, `git remote` commands, or add a remote. Local status, diff, and commits are allowed. +- The repository has a single remote, `origin` (`git@git.ssh.qbuissondebon.eu.org:qbuissondebon/cmp170hx_check.git`, web: https://git.qbuissondebon.eu.org/qbuissondebon/cmp170hx_check), default branch `main`. Local status, diff, and commits are allowed at any time. Push to `origin` only when the user explicitly asks for it. Never force-push, never rewrite pushed history, and never add another remote without an explicit request. - Do not run host setup, unlock, VBIOS, or PCIe mutation commands on a development machine. Those actions belong on the intended Ubuntu host when the user requests them. - Keep reports and long-running installation logs visible and useful to an operator. Save full output on disk; show installation progress in the terminal. - If asked to verify without a card, `python3 check_cards.py --demo` is the synthetic path. It does not establish hardware correctness. diff --git a/README.md b/README.md index 7e7bc45..d1106eb 100755 --- a/README.md +++ b/README.md @@ -1,5 +1,7 @@ # cmp170hx_check +Repo: https://git.qbuissondebon.eu.org/qbuissondebon/cmp170hx_check (SSH push: `git@git.ssh.qbuissondebon.eu.org:qbuissondebon/cmp170hx_check.git`) + Single-card checker for **NVIDIA CMP 170HX** cards (PCI IDs `10de:20c2` / `10de:2082`) — run it **one card at a time**: it waits for the card, verifies the PCIe capacitor mod, records PCIe bus health, backs up VBIOS, runs the cmpunlocker verification, offers the **opt-in** cmpunlocker unlock install (then a cold reboot and a re-run for the final PCIe check), and optionally stresses VRAM. Each card gets its own folder + JSON report named by serial, so the folders accumulate as you go through your batch (e.g. 23 cards). Reference harness (auto-cloned into `harness/` by preflight): @@ -12,7 +14,7 @@ Reference harness (auto-cloned into `harness/` by preflight): - Linux x86-64 (tested target: **Ubuntu 26.04**), Python 3.8+ - **sudo privileges** — precondition for `--preflight` package installation, for privileged checks (PCI rescan, link retrain, sysfs ROM, `dmesg`, `verify.sh`), and for the opt-in unlock install - `pciutils` (`lspci`, `setpci`), `git` — installed automatically by preflight -- NVIDIA driver with `nvidia-smi` (nvidia-open 610.xx+, see cmpunlocker) for unlock verification — preflight can install it for you (asks first) +- NVIDIA driver with `nvidia-smi` (nvidia-open, version list in cmpunlocker `driver/VERSION` — 610.xx / 615.xx) for unlock verification — preflight can install it for you (asks first) - `nvflash` — **bundled in this repo** (`nvflash_5.867_linux/x64/nvflash`), used directly by the script; no system install needed (see [nvflash](#nvflash-bundled-in-this-repo)) - Optional: `vkmark` or `vulkan-tools` for the 5-minute VRAM stress test