summaryrefslogtreecommitdiffstats
path: root/userspace/sdks/nv570/inc/ctrl/ctrlb0cc/ctrlb0ccinternal.h
diff options
context:
space:
mode:
authorArthur Hanson Rasmusson <arthur@vgpu.io>2026-09-13 18:36:21 -0400
committerArthur Hanson Rasmusson <arthur@vgpu.io>2026-09-13 18:36:21 -0400
commit00e54c13c7c9030c4d5f7151467f2d85a3730e29 (patch)
tree17a45239df8d2e4912ff3697ed06e85a10b969de /userspace/sdks/nv570/inc/ctrl/ctrlb0cc/ctrlb0ccinternal.h
downloadopen-iov-00e54c13c7c9030c4d5f7151467f2d85a3730e29.tar.gz
open-iov-00e54c13c7c9030c4d5f7151467f2d85a3730e29.zip
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
Diffstat (limited to 'userspace/sdks/nv570/inc/ctrl/ctrlb0cc/ctrlb0ccinternal.h')
-rw-r--r--userspace/sdks/nv570/inc/ctrl/ctrlb0cc/ctrlb0ccinternal.h283
1 files changed, 283 insertions, 0 deletions
diff --git a/userspace/sdks/nv570/inc/ctrl/ctrlb0cc/ctrlb0ccinternal.h b/userspace/sdks/nv570/inc/ctrl/ctrlb0cc/ctrlb0ccinternal.h
new file mode 100644
index 0000000..3723dea
--- /dev/null
+++ b/userspace/sdks/nv570/inc/ctrl/ctrlb0cc/ctrlb0ccinternal.h
@@ -0,0 +1,283 @@
+/*
+ * SPDX-FileCopyrightText: Copyright (c) 2020-2024 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 <nvtypes.h>
+
+//
+// This file was generated with FINN, an NVIDIA coding tool.
+// Source file: ctrl/ctrlb0cc/ctrlb0ccinternal.finn
+//
+
+#include "ctrl/ctrlb0cc/ctrlb0ccbase.h"
+
+#include "ctrl/ctrlb0cc/ctrlb0ccprofiler.h" /* Some controls derivative of b0ccprofiler */
+/*!
+ * @ref NVB0CC_CTRL_CMD_ALLOC_PMA_STREAM
+ */
+#define NVB0CC_CTRL_CMD_INTERNAL_ALLOC_PMA_STREAM (0xb0cc0204) /* finn: Evaluated from "(FINN_MAXWELL_PROFILER_INTERNAL_INTERFACE_ID << 8) | NVB0CC_CTRL_INTERNAL_ALLOC_PMA_STREAM_PARAMS_MESSAGE_ID" */
+
+
+// FINN PORT: The below type was generated by the FINN port to
+// ensure that all API's have a unique structure associated
+// with them!
+#define NVB0CC_CTRL_CMD_INTERNAL_ALLOC_PMA_STREAM_FINN_PARAMS_MESSAGE_ID (0x0U)
+
+typedef struct NVB0CC_CTRL_CMD_INTERNAL_ALLOC_PMA_STREAM_FINN_PARAMS {
+ NV_DECLARE_ALIGNED(NVB0CC_CTRL_ALLOC_PMA_STREAM_PARAMS params, 8);
+} NVB0CC_CTRL_CMD_INTERNAL_ALLOC_PMA_STREAM_FINN_PARAMS;
+
+/*!
+ * NVB0CC_CTRL_CMD_INTERNAL_QUIESCE_PMA_CHANNEL
+ *
+ * This command is used to quiesce ongoing HWPM streamout and wait for PMA engine to
+ * become idle. After this point, no new PMA records would be generated and
+ * membytes streaming would be triggered if GR context is resident or HWPM ctxsw is disabled.
+ */
+#define NVB0CC_CTRL_CMD_INTERNAL_QUIESCE_PMA_CHANNEL (0xb0cc0201) /* finn: Evaluated from "(FINN_MAXWELL_PROFILER_INTERNAL_INTERFACE_ID << 8) | NVB0CC_CTRL_INTERNAL_QUIESCE_PMA_CHANNEL_PARAMS_MESSAGE_ID" */
+
+#define NVB0CC_CTRL_INTERNAL_QUIESCE_PMA_CHANNEL_PARAMS_MESSAGE_ID (0x1U)
+
+typedef struct NVB0CC_CTRL_INTERNAL_QUIESCE_PMA_CHANNEL_PARAMS {
+ /*!
+ * [in] The PMA Channel Index associated with a given PMA stream.
+ */
+ NvU32 pmaChannelIdx;
+
+ /*!
+ * [out] Will return if membytes streaming was triggered, to decide if
+ * we need to poll membytes value on guest to complete streamout.
+ */
+ NvBool bMembytesPollingRequired;
+} NVB0CC_CTRL_INTERNAL_QUIESCE_PMA_CHANNEL_PARAMS;
+
+/*!
+ * NVB0CC_CTRL_CMD_INTERNAL_SRIOV_PROMOTE_PMA_STREAM
+ *
+ * Currently only used in vGPU full SRIOV mode.
+ * This command is used to promote VAs and required info about the HWPM IB
+ * and PMA buffers from guest to host in full SRIOV mode.
+ */
+#define NVB0CC_CTRL_CMD_INTERNAL_SRIOV_PROMOTE_PMA_STREAM (0xb0cc0202) /* finn: Evaluated from "(FINN_MAXWELL_PROFILER_INTERNAL_INTERFACE_ID << 8) | NVB0CC_CTRL_INTERNAL_SRIOV_PROMOTE_PMA_STREAM_PARAMS_MESSAGE_ID" */
+
+#define NVB0CC_CTRL_INTERNAL_SRIOV_PROMOTE_PMA_STREAM_PARAMS_MESSAGE_ID (0x2U)
+
+typedef struct NVB0CC_CTRL_INTERNAL_SRIOV_PROMOTE_PMA_STREAM_PARAMS {
+ /*!
+ * [in] The PMA Channel Index associated with a given PMA stream.
+ */
+ NvU32 pmaChannelIdx;
+ /*!
+ * [in] PMA records buffer VA.
+ */
+ NV_DECLARE_ALIGNED(NvU64 pmaBufferVA, 8);
+
+ /*!
+ * [in] size of the PMA records buffer. This must be <= NVB0CC_PMA_BUFFER_SIZE_MAX.
+ */
+ NV_DECLARE_ALIGNED(NvU64 pmaBufferSize, 8);
+
+ /*!
+ * [in] Membytes buffer VA.
+ */
+ NV_DECLARE_ALIGNED(NvU64 membytesVA, 8);
+
+ /*!
+ * [in] HWPM PMA Instance Block PA
+ */
+ NV_DECLARE_ALIGNED(NvU64 hwpmIBPA, 8);
+
+ /*!
+ * [in] HWPM PMA Instance Block aperture
+ */
+ NvU8 hwpmIBAperture;
+} NVB0CC_CTRL_INTERNAL_SRIOV_PROMOTE_PMA_STREAM_PARAMS;
+
+/*!
+ * NVB0CC_CTRL_CMD_INTERNAL_PERMISSIONS_INIT
+ *
+ * This command is used to convey the client permissions for appropriate
+ * profiling capability initialization
+ */
+#define NVB0CC_CTRL_CMD_INTERNAL_PERMISSIONS_INIT (0xb0cc0203) /* finn: Evaluated from "(FINN_MAXWELL_PROFILER_INTERNAL_INTERFACE_ID << 8) | NVB0CC_CTRL_INTERNAL_PERMISSIONS_INIT_PARAMS_MESSAGE_ID" */
+
+#define NVB0CC_CTRL_INTERNAL_PERMISSIONS_INIT_PARAMS_MESSAGE_ID (0x3U)
+
+typedef struct NVB0CC_CTRL_INTERNAL_PERMISSIONS_INIT_PARAMS {
+ /*!
+ * [in] Is Admin profiling permitted
+ */
+ NvBool bAdminProfilingPermitted;
+
+ /*!
+ * [in] Is Device profiling permitted
+ */
+ NvBool bDevProfilingPermitted;
+
+ /*!
+ * [in] Is Device tracing permitted
+ */
+ NvBool bDevTracePermitted;
+
+ /*!
+ * [in] Is Context profiling permitted
+ */
+ NvBool bCtxProfilingPermitted;
+
+ /*!
+ * [in] Is Video memory profiling permitted
+ */
+ NvBool bVideoMemoryProfilingPermitted;
+
+ /*!
+ * [in] Is SYS memory profiling permitted
+ */
+ NvBool bSysMemoryProfilingPermitted;
+
+ /*!
+ * [in] Is Async CE profiling permitted
+ */
+ NvBool bAsyncCeProfilingPermitted;
+} NVB0CC_CTRL_INTERNAL_PERMISSIONS_INIT_PARAMS;
+
+#define NVB0CC_CTRL_INTERNAL_ALLOC_PMA_STREAM_PARAMS_MESSAGE_ID (0x4U)
+
+typedef struct NVB0CC_CTRL_INTERNAL_ALLOC_PMA_STREAM_PARAMS {
+ /*!
+ * [in] Memory handle (RW memory) for streaming records.
+ * Size of this must be >= @ref pmaBufferOffset + @ref pmaBufferSize.
+ */
+ NvHandle hMemPmaBuffer;
+
+ /*!
+ * [in] Start offset of PMA buffer (offset in @ref hMemPmaBuffer).
+ */
+ NV_DECLARE_ALIGNED(NvU64 pmaBufferOffset, 8);
+
+ /*!
+ * [in] size of the buffer. This must be <= NVB0CC_PMA_BUFFER_SIZE_MAX.
+ */
+ NV_DECLARE_ALIGNED(NvU64 pmaBufferSize, 8);
+
+ /*!
+ * [in] Memory handle (RO memory) for streaming number of bytes available.
+ * Size of this must be of at least @ref pmaBytesAvailableOffset +
+ * @ref NVB0CC_PMA_BYTES_AVAILABLE_SIZE.
+ */
+ NvHandle hMemPmaBytesAvailable;
+
+ /*!
+ * [in] Start offset of PMA bytes available buffer (offset in @ref hMemPmaBytesAvailable).
+ */
+ NV_DECLARE_ALIGNED(NvU64 pmaBytesAvailableOffset, 8);
+
+ /*!
+ * [in] Enable ctxsw for PMA stream.
+ */
+ NvBool ctxsw;
+
+ /*!
+ * [in/out] The PMA Channel Index associated with a given PMA stream.
+ * This parameter is input when bInputPmaChIdx is true, else it's output parameter.
+ */
+ NvU32 pmaChannelIdx;
+
+ /*!
+ * [out] PMA buffer VA. Note that this is a HWPM Virtual address.
+ */
+ NV_DECLARE_ALIGNED(NvU64 pmaBufferVA, 8);
+
+ /*!
+ * [In] This field must be specified by the client to indicate whether the
+ * pmaChannelIdx is input parameter or output parameter.
+ */
+ NvBool bInputPmaChIdx;
+} NVB0CC_CTRL_INTERNAL_ALLOC_PMA_STREAM_PARAMS;
+
+
+
+/*!
+ * NVB0CC_CTRL_CMD_INTERNAL_FREE_PMA_STREAM
+ *
+ * Internal logic for PMA Stream Free
+ */
+#define NVB0CC_CTRL_CMD_INTERNAL_FREE_PMA_STREAM (0xb0cc0206) /* finn: Evaluated from "(FINN_MAXWELL_PROFILER_INTERNAL_INTERFACE_ID << 8) | NVB0CC_CTRL_INTERNAL_FREE_PMA_STREAM_PARAMS_MESSAGE_ID" */
+
+#define NVB0CC_CTRL_INTERNAL_FREE_PMA_STREAM_PARAMS_MESSAGE_ID (0x6U)
+
+typedef struct NVB0CC_CTRL_INTERNAL_FREE_PMA_STREAM_PARAMS {
+ /*!
+ * [in] The PMA channel index associated with a given PMA stream.
+ */
+ NvU32 pmaChannelIdx;
+} NVB0CC_CTRL_INTERNAL_FREE_PMA_STREAM_PARAMS;
+
+/*!
+ * NVB0CC_CTRL_CMD_INTERNAL_GET_MAX_PMAS
+ *
+ * Get the maximum number of PMA channels
+ */
+#define NVB0CC_CTRL_CMD_INTERNAL_GET_MAX_PMAS (0xb0cc0207) /* finn: Evaluated from "(FINN_MAXWELL_PROFILER_INTERNAL_INTERFACE_ID << 8) | NVB0CC_CTRL_INTERNAL_GET_MAX_PMAS_PARAMS_MESSAGE_ID" */
+
+#define NVB0CC_CTRL_INTERNAL_GET_MAX_PMAS_PARAMS_MESSAGE_ID (0x7U)
+
+typedef struct NVB0CC_CTRL_INTERNAL_GET_MAX_PMAS_PARAMS {
+ /*!
+ * [out] Max number of PMA channels
+ */
+ NvU32 maxPmaChannels;
+} NVB0CC_CTRL_INTERNAL_GET_MAX_PMAS_PARAMS;
+
+/*!
+ * NVB0CC_CTRL_CMD_INTERNAL_BIND_PM_RESOURCES
+ *
+ * Internally bind PM resources.
+ */
+#define NVB0CC_CTRL_CMD_INTERNAL_BIND_PM_RESOURCES (0xb0cc0208) /* finn: Evaluated from "(FINN_MAXWELL_PROFILER_INTERNAL_INTERFACE_ID << 8) | 0x8" */
+
+
+/*!
+ * NVB0CC_CTRL_CMD_INTERNAL_UNBIND_PM_RESOURCES
+ *
+ * Internally unbind PM resources.
+ */
+#define NVB0CC_CTRL_CMD_INTERNAL_UNBIND_PM_RESOURCES (0xb0cc0209) /* finn: Evaluated from "(FINN_MAXWELL_PROFILER_INTERNAL_INTERFACE_ID << 8) | 0x9" */
+
+/*!
+ * NVB0CC_CTRL_CMD_INTERNAL_RESERVE_HWPM_LEGACY
+ *
+ * Reserve legacy HWPM resources
+ */
+#define NVB0CC_CTRL_CMD_INTERNAL_RESERVE_HWPM_LEGACY (0xb0cc020a) /* finn: Evaluated from "(FINN_MAXWELL_PROFILER_INTERNAL_INTERFACE_ID << 8) | NVB0CC_CTRL_INTERNAL_RESERVE_HWPM_LEGACY_PARAMS_MESSAGE_ID" */
+
+#define NVB0CC_CTRL_INTERNAL_RESERVE_HWPM_LEGACY_PARAMS_MESSAGE_ID (0xaU)
+
+typedef struct NVB0CC_CTRL_INTERNAL_RESERVE_HWPM_LEGACY_PARAMS {
+ /*!
+ * [in] Enable ctxsw for HWPM.
+ */
+ NvBool ctxsw;
+} NVB0CC_CTRL_INTERNAL_RESERVE_HWPM_LEGACY_PARAMS;
+
+/* _ctrlb0ccinternal_h_ */