From 00e54c13c7c9030c4d5f7151467f2d85a3730e29 Mon Sep 17 00:00:00 2001
From: Arthur Hanson Rasmusson <arthur@vgpu.io>
Date: Sun, 13 Sep 2026 18:36:21 -0400
Subject: Initial commit: Open-IOV vGPU-IO complete stack

- Firmware decompilation: GSP 570.144W (28.5MB ELF, RV64IMAC), 132 decompiled C files
- Kernel modules: nvidia.ko (34MB, OpenRM), open-iov-vfio.ko (2.8MB, VFIO mdev), gsp-vgpu.ko (1.8MB, guest driver)
- Userspace: libiov.so/libvgpu.so (76KB), example_vgpu (28KB), rpc_emulator.c
- PCI config space emulation (256B with PM, MSI, MSI-X, PCIe caps)
- 12 RPC types fully mapped from firmware decompilation
- BAR trap, WPR, scheduling, notification, migration emulation
- Helper scripts: load_vgpu_stack, create_mdev, launch_qemu_vgpu, test_vgpu_stack, setup_guest_driver, unload_vgpu_stack
- Architecture documentation
- Wiki: 10 technical documents
- Git LFS for large binaries (.ko, .bin, .iso, .img, .o, ghidra repos)
- nvidia-open-gpu-kernel-modules as submodule
---
 tools/firmware/verify_gsp_firmware.sh | 60 +++++++++++++++++++++++++++++++++++
 1 file changed, 60 insertions(+)
 create mode 100755 tools/firmware/verify_gsp_firmware.sh

(limited to 'tools/firmware')

diff --git a/tools/firmware/verify_gsp_firmware.sh b/tools/firmware/verify_gsp_firmware.sh
new file mode 100755
index 0000000..79f474c
--- /dev/null
+++ b/tools/firmware/verify_gsp_firmware.sh
@@ -0,0 +1,60 @@
+#!/bin/bash
+# Verify GSP firmware for TU104
+# Usage: ./verify_gsp_firmware.sh
+
+set -euo pipefail
+
+FIRMWARE_DIR="/lib/firmware/nvidia/tu104/gsp"
+
+echo "=== GSP Firmware Verification (TU104) ==="
+echo ""
+
+if [[ ! -d "$FIRMWARE_DIR" ]]; then
+    echo "ERROR: Firmware directory not found: $FIRMWARE_DIR"
+    echo "Install firmware with: rzsh nvidia vgpu firmware install"
+    exit 1
+fi
+
+echo "Firmware directory: $FIRMWARE_DIR"
+echo ""
+
+# Check required files
+required_files=(
+    "gsp-535.113.01.bin"
+    "gsp-570.144.bin"
+    "booter_load-535.113.01.bin"
+    "booter_load-570.144.bin"
+    "booter_unload-535.113.01.bin"
+    "booter_unload-570.144.bin"
+    "bootloader-535.113.01.bin"
+    "bootloader-570.144.bin"
+)
+
+all_ok=true
+for file in "${required_files[@]}"; do
+    if [[ -f "$FIRMWARE_DIR/$file" ]]; then
+        size=$(stat -c%s "$FIRMWARE_DIR/$file")
+        echo "  ✓ $file ($size bytes)"
+    else
+        echo "  ✗ $file MISSING"
+        all_ok=false
+    fi
+done
+
+echo ""
+if $all_ok; then
+    echo "✓ All required firmware files present"
+else
+    echo "✗ Some firmware files missing"
+    echo ""
+    echo "To install firmware:"
+    echo "  1. Download from NVIDIA or copy from nvidia-linux-firmware repo"
+    echo "  2. sudo cp -r nvidia/tu104/gsp/* /lib/firmware/nvidia/tu104/gsp/"
+    echo "  3. sudo update-initramfs -u"
+fi
+
+echo ""
+echo "Current kernel module version:"
+if lsmod | grep -q nvidia; then
+    cat /proc/driver/nvidia/version 2>/dev/null | head -1
+fi
\ No newline at end of file
-- 
cgit v1.2.3