From 872b4fbdc3c607b522211839a6b3b82e18310a1b Mon Sep 17 00:00:00 2001 From: hathach Date: Thu, 20 Aug 2026 14:30:59 +0700 Subject: docs: add hardware-in-the-loop rig reference Document the ci and hfp HIL rigs in enough detail to reproduce one: bill of materials with photos, BIOS/IOMMU and vfio-pci passthrough on the Proxmox host, the Renesas uPD720201 firmware install, the guest software and permissions, the one-hub-per-root-port USB topology rule and the per-box split of probe and DUT hubs, how CI drives the rigs, and the operational gotchas. The attached-board table is generated from test/hil/tinyusb.json and test/hil/hfp.json by tools/gen_doc.py into docs/reference/hil_boards.md, which the page includes. Sphinx excludes that partial so it is not also built as an orphan document. Also exclude docs/superpowers/ from the Sphinx build: it holds internal plans, specs and handoffs rather than published documentation, and since nothing references them from a toctree each emitted "document isn't included in any toctree" -- 26 warnings in total, so build_doc.py -W could never pass. It now does. --- docs/assets/hil/cable-xh254.jpg | Bin 0 -> 13306 bytes docs/assets/hil/leaf-hub.jpg | Bin 0 -> 94557 bytes docs/assets/hil/pcie-card.jpg | Bin 0 -> 80079 bytes docs/assets/hil/storage-box.jpg | Bin 0 -> 177136 bytes 4 files changed, 0 insertions(+), 0 deletions(-) create mode 100644 docs/assets/hil/cable-xh254.jpg create mode 100644 docs/assets/hil/leaf-hub.jpg create mode 100644 docs/assets/hil/pcie-card.jpg create mode 100644 docs/assets/hil/storage-box.jpg (limited to 'docs/assets') diff --git a/docs/assets/hil/cable-xh254.jpg b/docs/assets/hil/cable-xh254.jpg new file mode 100644 index 000000000..1f8ec8a07 Binary files /dev/null and b/docs/assets/hil/cable-xh254.jpg differ diff --git a/docs/assets/hil/leaf-hub.jpg b/docs/assets/hil/leaf-hub.jpg new file mode 100644 index 000000000..3557047e6 Binary files /dev/null and b/docs/assets/hil/leaf-hub.jpg differ diff --git a/docs/assets/hil/pcie-card.jpg b/docs/assets/hil/pcie-card.jpg new file mode 100644 index 000000000..4563bb9f7 Binary files /dev/null and b/docs/assets/hil/pcie-card.jpg differ diff --git a/docs/assets/hil/storage-box.jpg b/docs/assets/hil/storage-box.jpg new file mode 100644 index 000000000..03f389ab0 Binary files /dev/null and b/docs/assets/hil/storage-box.jpg differ -- cgit v1.3.1