From 00e54c13c7c9030c4d5f7151467f2d85a3730e29 Mon Sep 17 00:00:00 2001 From: Arthur Hanson Rasmusson 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 --- userspace/sdks/nv570/inc/ctrl/ctrl00fe.h | 107 +++++++++++++++++++++++++++++++ 1 file changed, 107 insertions(+) create mode 100644 userspace/sdks/nv570/inc/ctrl/ctrl00fe.h (limited to 'userspace/sdks/nv570/inc/ctrl/ctrl00fe.h') diff --git a/userspace/sdks/nv570/inc/ctrl/ctrl00fe.h b/userspace/sdks/nv570/inc/ctrl/ctrl00fe.h new file mode 100644 index 0000000..a5cf2b6 --- /dev/null +++ b/userspace/sdks/nv570/inc/ctrl/ctrl00fe.h @@ -0,0 +1,107 @@ +/* + * SPDX-FileCopyrightText: Copyright (c) 2022-2025 NVIDIA CORPORATION & AFFILIATES. All rights reserved. + * SPDX-License-Identifier: MIT + * + * Permission is hereby granted, free of charge, to any person obtaining a + * copy of this software and associated documentation files (the "Software"), + * to deal in the Software without restriction, including without limitation + * the rights to use, copy, modify, merge, publish, distribute, sublicense, + * and/or sell copies of the Software, and to permit persons to whom the + * Software is furnished to do so, subject to the following conditions: + * + * The above copyright notice and this permission notice shall be included in + * all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL + * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING + * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER + * DEALINGS IN THE SOFTWARE. + */ + +#pragma once + +#include + +// +// This file was generated with FINN, an NVIDIA coding tool. +// Source file: ctrl/ctrl00fe.finn +// + +typedef enum NV00FE_CTRL_OPERATION_TYPE { + NV00FE_CTRL_OPERATION_TYPE_NOP = 0, // operation is ignored, used internally + NV00FE_CTRL_OPERATION_TYPE_MAP = 1, + NV00FE_CTRL_OPERATION_TYPE_UNMAP = 2, + NV00FE_CTRL_OPERATION_TYPE_SEMAPHORE_WAIT = 3, + NV00FE_CTRL_OPERATION_TYPE_SEMAPHORE_SIGNAL = 4, +} NV00FE_CTRL_OPERATION_TYPE; + +typedef struct NV00FE_CTRL_OPERATION_MAP { + NvHandle hVirtualMemory; + NV_DECLARE_ALIGNED(NvU64 virtualOffset, 8); + NvHandle hPhysicalMemory; + NV_DECLARE_ALIGNED(NvU64 physicalOffset, 8); + NV_DECLARE_ALIGNED(NvU64 size, 8); + NvU32 dmaFlags; // NVOS46_FLAGS + NvU32 kindOverride; +} NV00FE_CTRL_OPERATION_MAP; + +typedef struct NV00FE_CTRL_OPERATION_UNMAP { + NvHandle hVirtualMemory; + NV_DECLARE_ALIGNED(NvU64 virtualOffset, 8); + NV_DECLARE_ALIGNED(NvU64 size, 8); + NvU32 dmaFlags; // NVOS47_FLAGS +} NV00FE_CTRL_OPERATION_UNMAP; + +typedef struct NV00FE_CTRL_OPERATION_SEMAPHORE { + NvU32 index; + NV_DECLARE_ALIGNED(NvU64 value, 8); +} NV00FE_CTRL_OPERATION_SEMAPHORE; + +typedef struct NV00FE_CTRL_OPERATION { + NV00FE_CTRL_OPERATION_TYPE type; + + union { + NV_DECLARE_ALIGNED(NV00FE_CTRL_OPERATION_MAP map, 8); + NV_DECLARE_ALIGNED(NV00FE_CTRL_OPERATION_UNMAP unmap, 8); + NV_DECLARE_ALIGNED(NV00FE_CTRL_OPERATION_SEMAPHORE semaphore, 8); + } data; +} NV00FE_CTRL_OPERATION; + +/* + * NV00FE_CTRL_CMD_SUBMIT_OPERATIONS + * + * Execute a list of mapping/semaphore operations + * Page size is determined by the virtual allocation + * Offsets/sizes must respect the page size + * + */ +#define NV00FE_CTRL_CMD_SUBMIT_OPERATIONS (0xfe0101U) /* finn: Evaluated from "(FINN_NV_MEMORY_MAPPER_INTERFACE_ID << 8) | NV00FE_CTRL_SUBMIT_OPERATIONS_PARAMS_MESSAGE_ID" */ + +#define NV00FE_MAX_OPERATIONS_COUNT (0x00001000U) + +#define NV00FE_CTRL_SUBMIT_OPERATIONS_PARAMS_MESSAGE_ID (0x1U) + +typedef struct NV00FE_CTRL_SUBMIT_OPERATIONS_PARAMS { + NvU32 operationsCount; + NV_DECLARE_ALIGNED(NV00FE_CTRL_OPERATION pOperations[NV00FE_MAX_OPERATIONS_COUNT], 8); + NvU32 operationsProcessedCount; +} NV00FE_CTRL_SUBMIT_OPERATIONS_PARAMS; + +/* + * NV00FE_CTRL_CMD_RESIZE_QUEUE + * + * Resize the MemoryMapper command queue + * All pending commands remain in queue + * + */ +#define NV00FE_CTRL_CMD_RESIZE_QUEUE (0xfe0102U) /* finn: Evaluated from "(FINN_NV_MEMORY_MAPPER_INTERFACE_ID << 8) | NV00FE_CTRL_RESIZE_QUEUE_PARAMS_MESSAGE_ID" */ + +#define NV00FE_CTRL_RESIZE_QUEUE_PARAMS_MESSAGE_ID (0x2U) + +typedef struct NV00FE_CTRL_RESIZE_QUEUE_PARAMS { + NvU32 maxQueueSize; +} NV00FE_CTRL_RESIZE_QUEUE_PARAMS; + -- cgit v1.2.3