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/ctrla0bc.h | 119 +++++++++++++++++++++++++++++++ 1 file changed, 119 insertions(+) create mode 100644 userspace/sdks/nv570/inc/ctrl/ctrla0bc.h (limited to 'userspace/sdks/nv570/inc/ctrl/ctrla0bc.h') diff --git a/userspace/sdks/nv570/inc/ctrl/ctrla0bc.h b/userspace/sdks/nv570/inc/ctrl/ctrla0bc.h new file mode 100644 index 0000000..68e4810 --- /dev/null +++ b/userspace/sdks/nv570/inc/ctrl/ctrla0bc.h @@ -0,0 +1,119 @@ +/* + * SPDX-FileCopyrightText: Copyright (c) 2007-2023 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/ctrla0bc.finn +// + +#include "ctrl/ctrlxxxx.h" +/* NVENC_SW_SESSION control commands and parameters */ +#define NVA0BC_CTRL_CMD(cat,idx) NVXXXX_CTRL_CMD(0xA0BC, NVA0BC_CTRL_##cat, idx) + +/* Command categories (6bits) */ +#define NVA0BC_CTRL_RESERVED (0x00) +#define NVA0BC_CTRL_NVENC_SW_SESSION (0x01) + +#define NVA0BC_CTRL_CMD_NVENC_MAX_BUFFER_ENTRIES 60 + +/* + * NVA0BC_CTRL_CMD_NVENC_SW_SESSION_UPDATE_INFO + * + * This command is used to let RM know about runtime information about + * running NVENC session on given GPU. + * * + * hResolution + * This parameter specifies the current horizontal resolution of NVENC session. + * vResolution + * This parameter specifies the current vertical resolution of NVENC session. + * averageEncodeLatency + * This field specifies the average encode latency over last 1 second. + * averageEncodeFps + * This field specifies the average encode FPS over last 1 second. + * timestampBufferSize + * This field specifies the number of entries in the caller's timestampBuffer. + * It should not be greater than NVA0BC_CTRL_CMD_NVENC_MAX_BUFFER_ENTRIES. + * When this field is zero, RM will assume that client has calculated averageEncodeFps + * and averageEncodeLatency, thus ignore timestampBuffer. + * timestampBuffer + * This field specifies a pointer in the caller's address space + * to the buffer holding encode timestamps in microseconds. + * This buffer must be at least as big as timestampBufferSize multiplied + * by the size of the NVA0BC_CTRL_NVENC_TIMESTAMP structure. + * e.g. if there are 10 fps, buffer will contain only 10 entries and rest of + * entries should be 0x00. However if there are more than 60 fps, buffer will + * contain last/latest 60 entries of frame encoding start-end timestamps. Caller + * should make sure timestamps won't wrap around. RM assume that for each + * frame timestamp value endTime would be greater than startTime. + * + * Possible status values returned are: + * NV_OK + * NV_ERR_INVALID_ARGUMENT + */ + +#define NVA0BC_CTRL_CMD_NVENC_SW_SESSION_UPDATE_INFO (0xa0bc0101) /* finn: Evaluated from "(FINN_NVENC_SW_SESSION_NVENC_SW_SESSION_INTERFACE_ID << 8) | NVA0BC_CTRL_NVENC_SW_SESSION_UPDATE_INFO_PARAMS_MESSAGE_ID" */ + +typedef struct NVA0BC_CTRL_NVENC_TIMESTAMP { + NV_DECLARE_ALIGNED(NvU64 startTime, 8); + NV_DECLARE_ALIGNED(NvU64 endTime, 8); +} NVA0BC_CTRL_NVENC_TIMESTAMP; + +#define NVA0BC_CTRL_NVENC_SW_SESSION_UPDATE_INFO_PARAMS_MESSAGE_ID (0x1U) + +typedef struct NVA0BC_CTRL_NVENC_SW_SESSION_UPDATE_INFO_PARAMS { + NvU32 hResolution; + NvU32 vResolution; + NvU32 averageEncodeLatency; + NvU32 averageEncodeFps; + NvU32 timestampBufferSize; + NV_DECLARE_ALIGNED(NvP64 timestampBuffer, 8); +} NVA0BC_CTRL_NVENC_SW_SESSION_UPDATE_INFO_PARAMS; + +/* +* NVA0BC_CTRL_CMD_NVENC_SW_SESSION_UPDATE_INFO_V2 +* +* This command updates the NVENC software sessions information for the associate GPU. +* This command is similar to NVA0BC_CTRL_CMD_NVENC_SW_SESSION_UPDATE_INFO but doesn't have +* embedded pointers. +* +* Check NVA0BC_CTRL_CMD_NVENC_SW_SESSION_UPDATE_INFO for detailed information. +*/ + +#define NVA0BC_CTRL_CMD_NVENC_SW_SESSION_UPDATE_INFO_V2 (0xa0bc0102) /* finn: Evaluated from "(FINN_NVENC_SW_SESSION_NVENC_SW_SESSION_INTERFACE_ID << 8) | NVA0BC_CTRL_NVENC_SW_SESSION_UPDATE_INFO_V2_PARAMS_MESSAGE_ID" */ + +#define NVA0BC_CTRL_NVENC_SW_SESSION_UPDATE_INFO_V2_PARAMS_MESSAGE_ID (0x2U) + +typedef struct NVA0BC_CTRL_NVENC_SW_SESSION_UPDATE_INFO_V2_PARAMS { + NvU32 hResolution; + NvU32 vResolution; + NvU32 averageEncodeLatency; + NvU32 averageEncodeFps; + NvU32 timestampBufferSize; + NV_DECLARE_ALIGNED(NVA0BC_CTRL_NVENC_TIMESTAMP timestampBuffer[NVA0BC_CTRL_CMD_NVENC_MAX_BUFFER_ENTRIES], 8); +} NVA0BC_CTRL_NVENC_SW_SESSION_UPDATE_INFO_V2_PARAMS; + +/* _ctrla0bc_h_ */ -- cgit v1.2.3