* [PATCH v2 1/6] gpu: nova-core: gsp: fw: add the r000 bindings for the GMC API header
2026-11-06 7:06 [PATCH v2 0/6] gpu: nova-core: gsp: add support for GMC messages Alexandre Courbot
@ 2026-11-06 7:06 ` Alexandre Courbot
2026-11-06 7:06 ` [PATCH v2 2/6] gpu: nova-core: gsp: add " Alexandre Courbot
` (4 subsequent siblings)
5 siblings, 0 replies; 10+ messages in thread
From: Alexandre Courbot @ 2026-11-06 7:06 UTC (permalink / raw)
To: Danilo Krummrich, Alice Ryhl, David Airlie, Simona Vetter,
Benno Lossin, Gary Guo
Cc: John Hubbard, Alistair Popple, Timur Tabi, Eliot Courtney,
Zhi Wang, linux-kernel, nova-gpu, rust-for-linux,
Alexandre Courbot
From: John Hubbard <jhubbard@nvidia.com>
Nova-core boots the r570 GSP firmware, release 570.144. The GSP firmware
releases from r615 onward share one ABI, and their firmware files carry
no version number in their names, because each image records its version
internally. The driver calls that ABI "r000", so that its name does not
change with each release.
Add the first part of the bindings that bindgen generates from the r000
headers of OpenRM, the open-source NVIDIA kernel driver. The following
patch builds the GMC API header type on them, and the driver keeps
compiling against the r570 bindings until the patch that switches
firmware.
The headers are those of OpenRM release 615.71.09.
[acourbot: split the bindings by the code that needs them, name the
OpenRM release.]
Signed-off-by: John Hubbard <jhubbard@nvidia.com>
Reviewed-by: Timur Tabi <ttabi@nvidia.com>
Reviewed-by: Eliot Courtney <ecourtney@nvidia.com>
Signed-off-by: Alexandre Courbot <acourbot@nvidia.com>
---
drivers/gpu/nova-core/gsp/fw.rs | 1 +
drivers/gpu/nova-core/gsp/fw/r000_00.rs | 29 ++++++
drivers/gpu/nova-core/gsp/fw/r000_00/bindings.rs | 110 +++++++++++++++++++++++
3 files changed, 140 insertions(+)
diff --git a/drivers/gpu/nova-core/gsp/fw.rs b/drivers/gpu/nova-core/gsp/fw.rs
index b2ddeb27984f..213ef5bfb258 100644
--- a/drivers/gpu/nova-core/gsp/fw.rs
+++ b/drivers/gpu/nova-core/gsp/fw.rs
@@ -2,6 +2,7 @@
// SPDX-FileCopyrightText: Copyright (c) 2025-2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
pub(crate) mod commands;
+mod r000_00;
mod r570_144;
// Alias to avoid repeating the version number with every use.
diff --git a/drivers/gpu/nova-core/gsp/fw/r000_00.rs b/drivers/gpu/nova-core/gsp/fw/r000_00.rs
new file mode 100644
index 000000000000..0c32f4ec1e27
--- /dev/null
+++ b/drivers/gpu/nova-core/gsp/fw/r000_00.rs
@@ -0,0 +1,29 @@
+// SPDX-License-Identifier: GPL-2.0
+
+//! Bindings generated by `bindgen` from the r000 GSP firmware headers.
+//!
+//! Use them only through the parent module, which abstracts or re-exports the symbols that the
+//! driver needs.
+
+#![allow(
+ dead_code,
+ clippy::all,
+ clippy::undocumented_unsafe_blocks,
+ clippy::ptr_as_ptr,
+ clippy::ref_as_ptr,
+ missing_docs,
+ non_camel_case_types,
+ non_upper_case_globals,
+ non_snake_case,
+ improper_ctypes,
+ unreachable_pub,
+ unsafe_op_in_unsafe_fn
+)]
+use kernel::ffi;
+use pin_init::MaybeZeroable;
+
+include!("r000_00/bindings.rs");
+
+// SAFETY: This type has a size of zero, so its inclusion into another type should not affect their
+// ability to implement `Zeroable`.
+unsafe impl<T> kernel::prelude::Zeroable for __IncompleteArrayField<T> {}
diff --git a/drivers/gpu/nova-core/gsp/fw/r000_00/bindings.rs b/drivers/gpu/nova-core/gsp/fw/r000_00/bindings.rs
new file mode 100644
index 000000000000..552299c98169
--- /dev/null
+++ b/drivers/gpu/nova-core/gsp/fw/r000_00/bindings.rs
@@ -0,0 +1,110 @@
+// SPDX-License-Identifier: GPL-2.0
+
+#[repr(C)]
+#[derive(Default)]
+pub struct __IncompleteArrayField<T>(::core::marker::PhantomData<T>, [T; 0]);
+impl<T> __IncompleteArrayField<T> {
+ #[inline]
+ pub const fn new() -> Self {
+ __IncompleteArrayField(::core::marker::PhantomData, [])
+ }
+ #[inline]
+ pub fn as_ptr(&self) -> *const T {
+ self as *const _ as *const T
+ }
+ #[inline]
+ pub fn as_mut_ptr(&mut self) -> *mut T {
+ self as *mut _ as *mut T
+ }
+ #[inline]
+ pub unsafe fn as_slice(&self, len: usize) -> &[T] {
+ ::core::slice::from_raw_parts(self.as_ptr(), len)
+ }
+ #[inline]
+ pub unsafe fn as_mut_slice(&mut self, len: usize) -> &mut [T] {
+ ::core::slice::from_raw_parts_mut(self.as_mut_ptr(), len)
+ }
+}
+impl<T> ::core::fmt::Debug for __IncompleteArrayField<T> {
+ fn fmt(&self, fmt: &mut ::core::fmt::Formatter<'_>) -> ::core::fmt::Result {
+ fmt.write_str("__IncompleteArrayField")
+ }
+}
+pub type __u8 = ffi::c_uchar;
+pub type __u16 = ffi::c_ushort;
+pub type __u32 = ffi::c_uint;
+pub type __u64 = ffi::c_ulonglong;
+pub type u8_ = __u8;
+pub type u16_ = __u16;
+pub type u32_ = __u32;
+pub type u64_ = __u64;
+#[repr(C)]
+#[derive(MaybeZeroable)]
+pub struct GMCAPI_HEADER {
+ pub command: u32_,
+ pub size: u32_,
+ pub sequence: u64_,
+ pub __bindgen_anon_1: GMCAPI_HEADER__bindgen_ty_1,
+ pub reserved: [u32_; 5usize],
+ pub data: __IncompleteArrayField<u8_>,
+}
+#[repr(C)]
+#[derive(Copy, Clone, MaybeZeroable)]
+pub union GMCAPI_HEADER__bindgen_ty_1 {
+ pub request: GMCAPI_HEADER__bindgen_ty_1__bindgen_ty_1,
+ pub response: GMCAPI_HEADER__bindgen_ty_1__bindgen_ty_2,
+}
+#[repr(C)]
+#[derive(Debug, Default, Copy, Clone, MaybeZeroable)]
+pub struct GMCAPI_HEADER__bindgen_ty_1__bindgen_ty_1 {
+ pub max_response_size: u32_,
+}
+#[repr(C)]
+#[derive(Debug, Default, Copy, Clone, MaybeZeroable)]
+pub struct GMCAPI_HEADER__bindgen_ty_1__bindgen_ty_2 {
+ pub status: u32_,
+}
+impl Default for GMCAPI_HEADER__bindgen_ty_1 {
+ fn default() -> Self {
+ let mut s = ::core::mem::MaybeUninit::<Self>::uninit();
+ unsafe {
+ ::core::ptr::write_bytes(s.as_mut_ptr(), 0, 1);
+ s.assume_init()
+ }
+ }
+}
+impl Default for GMCAPI_HEADER {
+ fn default() -> Self {
+ let mut s = ::core::mem::MaybeUninit::<Self>::uninit();
+ unsafe {
+ ::core::ptr::write_bytes(s.as_mut_ptr(), 0, 1);
+ s.assume_init()
+ }
+ }
+}
+pub const GMCAPI_COMMANDS_GMCAPI_CMD_RESERVED_LAST: GMCAPI_COMMANDS = 65535;
+pub const GMCAPI_COMMANDS_GMCAPI_CMD_GSP_INIT: GMCAPI_COMMANDS = 65537;
+pub const GMCAPI_COMMANDS_GMCAPI_CMD_EXEC_GENERIC_BOOTLOADER: GMCAPI_COMMANDS = 65538;
+pub const GMCAPI_COMMANDS_GMCAPI_CMD_EXEC_HS_BINARY: GMCAPI_COMMANDS = 65539;
+pub const GMCAPI_COMMANDS_GMCAPI_CMD_GSP_SUSPEND: GMCAPI_COMMANDS = 65540;
+pub const GMCAPI_COMMANDS_GMCAPI_CMD_GSP_RESUME_DONE: GMCAPI_COMMANDS = 65541;
+pub const GMCAPI_COMMANDS_GMCAPI_CMD_ADD_VGPU_TYPE: GMCAPI_COMMANDS = 131073;
+pub const GMCAPI_COMMANDS_GMCAPI_CMD_QUERY_SUPPORTED_VGPU_TYPES: GMCAPI_COMMANDS = 131074;
+pub const GMCAPI_COMMANDS_GMCAPI_CMD_QUERY_CREATABLE_VGPU_TYPES: GMCAPI_COMMANDS = 131075;
+pub const GMCAPI_COMMANDS_GMCAPI_CMD_ASSIGN_VGPU_TYPE: GMCAPI_COMMANDS = 131076;
+pub const GMCAPI_COMMANDS_GMCAPI_CMD_DEASSIGN_VGPU_TYPE: GMCAPI_COMMANDS = 131077;
+pub const GMCAPI_COMMANDS_GMCAPI_CMD_QUERY_VGPU_PROPERTIES: GMCAPI_COMMANDS = 131078;
+pub const GMCAPI_COMMANDS_GMCAPI_CMD_QUERY_ASSIGNED_VF_VGPU_TYPE: GMCAPI_COMMANDS = 131079;
+pub const GMCAPI_COMMANDS_GMCAPI_CMD_BOOTLOAD_GSP_VGPU_PLUGIN_TASK: GMCAPI_COMMANDS = 131104;
+pub const GMCAPI_COMMANDS_GMCAPI_CMD_SHUTDOWN_GSP_VGPU_PLUGIN_TASK: GMCAPI_COMMANDS = 131105;
+pub const GMCAPI_COMMANDS_GMCAPI_CMD_SHUTDOWN_GSP_VGPU_PLUGIN_TASK_COMPLETE: GMCAPI_COMMANDS =
+ 131106;
+pub const GMCAPI_COMMANDS_GMCAPI_CMD_CLEANUP_GSP_VGPU_PLUGIN_RESOURCES: GMCAPI_COMMANDS = 131107;
+pub const GMCAPI_COMMANDS_GMCAPI_CMD_VGPU_PLUGIN_TRIGGERED_EVENT: GMCAPI_COMMANDS = 131108;
+pub const GMCAPI_COMMANDS_GMCAPI_CMD_VGPU_MGR_SCRUB_GUEST_FB: GMCAPI_COMMANDS = 131109;
+pub const GMCAPI_COMMANDS_GMCAPI_CMD_VGPU_MGR_ALLOC_GSP_CEUTILS: GMCAPI_COMMANDS = 131110;
+pub const GMCAPI_COMMANDS_GMCAPI_CMD_VGPU_MGR_FREE_GSP_CEUTILS: GMCAPI_COMMANDS = 131111;
+pub const GMCAPI_COMMANDS_GMCAPI_CMD_SCHED_CONTROL: GMCAPI_COMMANDS = 196609;
+pub const GMCAPI_COMMANDS_GMCAPI_CMD_MMU_FAULT_QUEUED: GMCAPI_COMMANDS = 262145;
+pub const GMCAPI_COMMANDS_GMCAPI_CMD_INVALID: GMCAPI_COMMANDS = 4294967295;
+pub type GMCAPI_COMMANDS = ffi::c_uint;
--
2.56.0
^ permalink raw reply [flat|nested] 10+ messages in thread* [PATCH v2 2/6] gpu: nova-core: gsp: add the GMC API header
2026-11-06 7:06 [PATCH v2 0/6] gpu: nova-core: gsp: add support for GMC messages Alexandre Courbot
2026-11-06 7:06 ` [PATCH v2 1/6] gpu: nova-core: gsp: fw: add the r000 bindings for the GMC API header Alexandre Courbot
@ 2026-11-06 7:06 ` Alexandre Courbot
2026-11-06 7:06 ` [PATCH v2 3/6] gpu: nova-core: gsp: cmdq: add the GMC send path Alexandre Courbot
` (3 subsequent siblings)
5 siblings, 0 replies; 10+ messages in thread
From: Alexandre Courbot @ 2026-11-06 7:06 UTC (permalink / raw)
To: Danilo Krummrich, Alice Ryhl, David Airlie, Simona Vetter,
Benno Lossin, Gary Guo
Cc: John Hubbard, Alistair Popple, Timur Tabi, Eliot Courtney,
Zhi Wang, linux-kernel, nova-gpu, rust-for-linux,
Alexandre Courbot
From: John Hubbard <jhubbard@nvidia.com>
The r000 firmware carries GSP-RM's boot protocol, and its newer
interfaces in general, over the GMC (GPU Management Controller) API:
messages that follow the queue element header with a GMC API header
instead of an RPC header.
Add the GmcApiHeader type as a newtype over the GMCAPI_HEADER binding,
so we can define the GMC send and receive paths in the following
patches.
[ acourbot: wrap the bindings type instead of redefining it; make
`status` return an `Option` to avoid returning a value whose semantics
are ambiguous.]
Signed-off-by: John Hubbard <jhubbard@nvidia.com>
Co-developed-by: Alexandre Courbot <acourbot@nvidia.com>
Signed-off-by: Alexandre Courbot <acourbot@nvidia.com>
Reviewed-by: Eliot Courtney <ecourtney@nvidia.com>
---
drivers/gpu/nova-core/gsp/fw.rs | 105 ++++++++++++++++++++++++++++++++++++++++
1 file changed, 105 insertions(+)
diff --git a/drivers/gpu/nova-core/gsp/fw.rs b/drivers/gpu/nova-core/gsp/fw.rs
index 213ef5bfb258..08f97c4e73a0 100644
--- a/drivers/gpu/nova-core/gsp/fw.rs
+++ b/drivers/gpu/nova-core/gsp/fw.rs
@@ -37,6 +37,7 @@
};
use crate::{
+ bounded_enum,
fb::{
FbRanges,
FbSizes, //
@@ -906,6 +907,110 @@ pub(crate) fn function(&self) -> Result<MsgFunction, u32> {
}
}
+bounded_enum! {
+ /// Commands of the GMC API.
+ #[derive(Debug, Clone, Copy, PartialEq, Eq)]
+ #[repr(u32)]
+ pub(crate) enum GmcCommandId with TryFrom<Bounded<u32, 24>> {
+ GspInit = r000_00::GMCAPI_COMMANDS_GMCAPI_CMD_GSP_INIT,
+ ExecGenericBootloader = r000_00::GMCAPI_COMMANDS_GMCAPI_CMD_EXEC_GENERIC_BOOTLOADER,
+ ExecHsBinary = r000_00::GMCAPI_COMMANDS_GMCAPI_CMD_EXEC_HS_BINARY,
+ GspSuspend = r000_00::GMCAPI_COMMANDS_GMCAPI_CMD_GSP_SUSPEND,
+ MmuFaultQueued = r000_00::GMCAPI_COMMANDS_GMCAPI_CMD_MMU_FAULT_QUEUED,
+ }
+}
+
+bitfield! {
+ /// The `command` word of a [`GmcApiHeader`].
+ pub(crate) struct GmcCommandWord(u32) {
+ /// Command ID.
+ 23:0 id ?=> GmcCommandId;
+ /// Set by GSP-RM on the response to a request. Not set for requests and events.
+ 24:24 is_response => bool;
+ }
+}
+
+/// Header of a GMC (GPU Management Controller) API message.
+///
+/// In a queue element, it follows the queue element header and precedes the payload of the
+/// command.
+#[repr(transparent)]
+pub(crate) struct GmcApiHeader {
+ inner: r000_00::GMCAPI_HEADER,
+}
+
+#[expect(dead_code)]
+impl GmcApiHeader {
+ /// Creates the header of a request for `command`, sent with sequence number `sequence` and
+ /// followed by `payload_size` bytes of payload.
+ ///
+ /// `max_reply_size` is the largest reply the sender accepts. It is zero for a request that does
+ /// not expect a reply or expects a reply with an empty payload (i.e. just the status value).
+ ///
+ /// # Errors
+ ///
+ /// - `EOVERFLOW` if `payload_size` does not fit its 32-bit field.
+ pub(crate) fn init(
+ command: GmcCommandId,
+ sequence: u64,
+ payload_size: usize,
+ max_reply_size: u32,
+ ) -> impl Init<Self, Error> {
+ let init_inner = try_init!(r000_00::GMCAPI_HEADER {
+ command: GmcCommandWord::zeroed().with_id(command).into(),
+ size: payload_size.try_into().map_err(|_| EOVERFLOW)?,
+ sequence,
+ __bindgen_anon_1: r000_00::GMCAPI_HEADER__bindgen_ty_1 {
+ request: r000_00::GMCAPI_HEADER__bindgen_ty_1__bindgen_ty_1 {
+ max_response_size: max_reply_size,
+ },
+ },
+ ..Zeroable::init_zeroed()
+ });
+
+ try_init!(GmcApiHeader {
+ inner <- init_inner,
+ })
+ }
+
+ /// Returns the `command` word of the header.
+ pub(crate) fn command(&self) -> GmcCommandWord {
+ GmcCommandWord::from(self.inner.command)
+ }
+
+ /// Returns the sequence number of the message.
+ pub(crate) fn sequence(&self) -> u64 {
+ self.inner.sequence
+ }
+
+ /// Returns the size in bytes of the payload following the header.
+ pub(crate) fn payload_size(&self) -> usize {
+ num::u32_as_usize(self.inner.size)
+ }
+
+ /// Returns the `NV_STATUS` carried by a response to a command.
+ ///
+ /// Returns `Some` with the `NV_STATUS` code if the `response` flag of [`Self::command`] is set;
+ /// otherwise returns `None`.
+ pub(crate) fn status(&self) -> Option<u32> {
+ if self.command().is_response() {
+ // SAFETY: we just checked that the message is a response.
+ let status = unsafe { self.inner.__bindgen_anon_1.response.status };
+
+ Some(status)
+ } else {
+ None
+ }
+ }
+}
+
+// SAFETY: This struct only contains integer types, including inside its union, and a zero-sized
+// array. It has no padding.
+unsafe impl AsBytes for GmcApiHeader {}
+
+// SAFETY: This struct only contains integer types for which all bit patterns are valid.
+unsafe impl FromBytes for GmcApiHeader {}
+
/// Arguments for GSP startup.
#[repr(transparent)]
#[derive(Zeroable)]
--
2.56.0
^ permalink raw reply [flat|nested] 10+ messages in thread* [PATCH v2 3/6] gpu: nova-core: gsp: cmdq: add the GMC send path
2026-11-06 7:06 [PATCH v2 0/6] gpu: nova-core: gsp: add support for GMC messages Alexandre Courbot
2026-11-06 7:06 ` [PATCH v2 1/6] gpu: nova-core: gsp: fw: add the r000 bindings for the GMC API header Alexandre Courbot
2026-11-06 7:06 ` [PATCH v2 2/6] gpu: nova-core: gsp: add " Alexandre Courbot
@ 2026-11-06 7:06 ` Alexandre Courbot
2026-11-06 7:06 ` [PATCH v2 4/6] gpu: nova-core: gsp: cmdq: move message trimming into its own function Alexandre Courbot
` (2 subsequent siblings)
5 siblings, 0 replies; 10+ messages in thread
From: Alexandre Courbot @ 2026-11-06 7:06 UTC (permalink / raw)
To: Danilo Krummrich, Alice Ryhl, David Airlie, Simona Vetter,
Benno Lossin, Gary Guo
Cc: John Hubbard, Alistair Popple, Timur Tabi, Eliot Courtney,
Zhi Wang, linux-kernel, nova-gpu, rust-for-linux,
Alexandre Courbot
From: John Hubbard <jhubbard@nvidia.com>
The r000 boot protocol has the driver send GSP_INIT, the request that
carries the driver's configuration to GSP-RM, as a GMC (GPU Management
Controller) API command. GMC and RPC commands share the command queue
and its sequence counter. A GMC command always fits in one element, as
the GMC API has no continuation records.
Add the gmc sub-module of the command queue, sibling of rpc, with trait
and type definitions mirroring those of rpc to support sending GMC
messages.
The module has no user yet, and is built as dead code until the switch
to r000.
Signed-off-by: John Hubbard <jhubbard@nvidia.com>
Co-developed-by: Alexandre Courbot <acourbot@nvidia.com>
Signed-off-by: Alexandre Courbot <acourbot@nvidia.com>
Reviewed-by: Eliot Courtney <ecourtney@nvidia.com>
---
drivers/gpu/nova-core/gsp/cmdq.rs | 4 +
drivers/gpu/nova-core/gsp/cmdq/gmc.rs | 202 ++++++++++++++++++++++++++++++++++
2 files changed, 206 insertions(+)
diff --git a/drivers/gpu/nova-core/gsp/cmdq.rs b/drivers/gpu/nova-core/gsp/cmdq.rs
index 76f5dbf2561b..9dd11ac8952b 100644
--- a/drivers/gpu/nova-core/gsp/cmdq.rs
+++ b/drivers/gpu/nova-core/gsp/cmdq.rs
@@ -1,6 +1,10 @@
// SPDX-License-Identifier: GPL-2.0
// SPDX-FileCopyrightText: Copyright (c) 2025-2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+// The transport header of the r570 firmware carries no message type, so nothing can produce or
+// consume a GMC message before the switch to r000. Until then the module is built as dead code.
+#[expect(dead_code)]
+pub(super) mod gmc;
pub(super) mod rpc;
use core::mem;
diff --git a/drivers/gpu/nova-core/gsp/cmdq/gmc.rs b/drivers/gpu/nova-core/gsp/cmdq/gmc.rs
new file mode 100644
index 000000000000..f741de8288c5
--- /dev/null
+++ b/drivers/gpu/nova-core/gsp/cmdq/gmc.rs
@@ -0,0 +1,202 @@
+// SPDX-License-Identifier: GPL-2.0
+// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+
+//! Support for the GMC (GPU Management Controller) API message type on the GSP command queue.
+
+use kernel::{
+ device,
+ prelude::*,
+ transmute::{
+ AsBytes,
+ FromBytes, //
+ },
+};
+
+use crate::{
+ gsp::{
+ cmdq::{
+ Cmdq,
+ CmdqInner,
+ CommandElement,
+ GspCommand,
+ NoReply, //
+ },
+ fw::{
+ GmcApiHeader,
+ GmcCommandId,
+ GspMsgElement, //
+ },
+ GSP_PAGE_SIZE,
+ },
+ sbuffer::SBufferIter,
+};
+
+/// Trait implemented by types representing a GMC command to send to the GSP.
+///
+/// The main purpose of this trait is to provide [`Cmdq`] with the information it needs to send
+/// a given command.
+///
+/// [`CommandToGsp::init`] in particular is responsible for initializing the command directly
+/// into the space reserved for it in the command queue buffer.
+///
+/// Some commands may be followed by a variable-length payload. For these, the
+/// [`CommandToGsp::variable_payload_len`] and [`CommandToGsp::init_variable_payload`] need to be
+/// defined as well.
+pub(crate) trait CommandToGsp {
+ /// Id identifying this command to the GSP.
+ const COMMAND: GmcCommandId;
+
+ /// Type generated by [`CommandToGsp::init`], to be written into the command queue buffer right
+ /// after the GMC API header.
+ type Command: FromBytes + AsBytes;
+
+ /// Type of the reply expected from the GSP, or [`NoReply`] for commands that don't have a
+ /// reply.
+ type Reply;
+
+ /// Largest reply this command accepts, in bytes. Zero for commands that the GSP does not
+ /// answer, or for commands that expect a reply with an empty payload (i.e. just a status
+ /// value).
+ const MAX_REPLY_SIZE: u32;
+
+ /// Error type returned by [`CommandToGsp::init`].
+ type InitError;
+
+ /// In-place command initializer responsible for filling the command in the command queue
+ /// buffer.
+ fn init(&self) -> impl Init<Self::Command, Self::InitError>;
+
+ /// Size of the variable-length payload following the command structure generated by
+ /// [`CommandToGsp::init`].
+ ///
+ /// Most commands don't have a variable-length payload, so this is zero by default.
+ fn variable_payload_len(&self) -> usize {
+ 0
+ }
+
+ /// Method initializing the variable-length payload.
+ ///
+ /// The command buffer is circular, which means that we may need to jump back to its beginning
+ /// while in the middle of a command. For this reason, the variable-length payload is
+ /// initialized using a [`SBufferIter`].
+ ///
+ /// This method will receive a buffer of the length returned by
+ /// [`CommandToGsp::variable_payload_len`], and must write every single byte of it. Leaving
+ /// unwritten space will lead to an error.
+ ///
+ /// Most commands don't have a variable-length payload, so this does nothing by default.
+ fn init_variable_payload(
+ &self,
+ _dst: &mut SBufferIter<core::array::IntoIter<&mut [u8], 2>>,
+ ) -> Result {
+ Ok(())
+ }
+
+ /// Total size of the command (including its variable-length payload) without the GMC API
+ /// header, i.e. the payload size advertised by that header.
+ fn size(&self) -> usize {
+ size_of::<Self::Command>() + self.variable_payload_len()
+ }
+}
+
+/// Wrapper type for sending a GMC command as a command queue element.
+struct GmcCommandElement<C>(C);
+
+impl<C> CommandElement for GmcCommandElement<C>
+where
+ C: CommandToGsp,
+ Error: From<C::InitError>,
+{
+ fn size(&self) -> usize {
+ size_of::<GmcApiHeader>() + self.0.size()
+ }
+
+ fn write(&self, dev: &device::Device, seq: u32, dst: &mut GspCommand<'_>) -> Result {
+ // Ensure that the command and its headers are not larger than one page, which is part of
+ // the GMC API contract.
+ const_assert!(
+ size_of::<GspMsgElement>() + size_of::<GmcApiHeader>() + size_of::<C::Command>()
+ <= GSP_PAGE_SIZE
+ );
+
+ let command = &self.0;
+ let payload_size = command.size();
+ // Extract the areas for the GMC API header and the command itself. Per the `const_assert!`
+ // above, the GSP message header, the GMC API header and the command header together are
+ // guaranteed to fit entirely into a single page, so it's ok to only look at
+ // `dst.contents.0` here.
+ let (header, contents) = GmcApiHeader::from_bytes_mut_prefix(dst.contents.0).ok_or(EIO)?;
+ let (cmd, payload_1) = C::Command::from_bytes_mut_prefix(contents).ok_or(EIO)?;
+ let header_init =
+ GmcApiHeader::init(C::COMMAND, u64::from(seq), payload_size, C::MAX_REPLY_SIZE);
+ // SAFETY: `header` is a valid reference, and is not touched if the initializer fails.
+ unsafe {
+ pin_init::raw_try_init(core::ptr::from_mut(header), header_init)?;
+ }
+ // SAFETY: `cmd` is a valid reference, and is not touched if the initializer fails.
+ unsafe {
+ pin_init::raw_try_init(core::ptr::from_mut(cmd), command.init())?;
+ }
+
+ // Fill the variable-length payload, which may be empty.
+ let mut sbuffer = SBufferIter::new_writer([&mut payload_1[..], &mut dst.contents.1[..]]);
+ command.init_variable_payload(&mut sbuffer)?;
+
+ if !sbuffer.is_empty() {
+ return Err(EIO);
+ }
+
+ dev_dbg!(
+ dev,
+ "GSP GMC: send: seq# {}, command={:?}, length=0x{:x}\n",
+ seq,
+ C::COMMAND,
+ payload_size,
+ );
+
+ Ok(())
+ }
+}
+
+impl Cmdq<'_> {
+ /// Sends `command` to the GSP without waiting for a reply.
+ ///
+ /// # Errors
+ ///
+ /// - `EMSGSIZE` if the command does not fit in a single command queue element.
+ /// - `ETIMEDOUT` if space does not become available within the timeout.
+ /// - `EIO` if the variable payload requested by the command has not been entirely
+ /// written to by its [`CommandToGsp::init_variable_payload`] method.
+ ///
+ /// Error codes returned by the command initializer are propagated as-is.
+ pub(crate) fn send_gmc_command_no_wait<C>(&self, command: C) -> Result
+ where
+ C: CommandToGsp<Reply = NoReply>,
+ Error: From<C::InitError>,
+ {
+ self.inner.lock().send_gmc_command(command).map(|_| ())
+ }
+}
+
+impl CmdqInner<'_> {
+ /// Sends `command` to the GSP, and returns the sequence number of its element.
+ ///
+ /// Unlike RPC commands, GMC commands are never split: a command that does not fit in a single
+ /// element is an error.
+ ///
+ /// # Errors
+ ///
+ /// - `EMSGSIZE` if the command does not fit in a single command queue element.
+ /// - `ETIMEDOUT` if space does not become available within the timeout.
+ /// - `EIO` if the variable payload requested by the command has not been entirely
+ /// written to by its [`CommandToGsp::init_variable_payload`] method.
+ ///
+ /// Error codes returned by the command initializer are propagated as-is.
+ fn send_gmc_command<C>(&mut self, command: C) -> Result<u32>
+ where
+ C: CommandToGsp,
+ Error: From<C::InitError>,
+ {
+ self.send_command_element(GmcCommandElement(command))
+ }
+}
--
2.56.0
^ permalink raw reply [flat|nested] 10+ messages in thread* [PATCH v2 4/6] gpu: nova-core: gsp: cmdq: move message trimming into its own function
2026-11-06 7:06 [PATCH v2 0/6] gpu: nova-core: gsp: add support for GMC messages Alexandre Courbot
` (2 preceding siblings ...)
2026-11-06 7:06 ` [PATCH v2 3/6] gpu: nova-core: gsp: cmdq: add the GMC send path Alexandre Courbot
@ 2026-11-06 7:06 ` Alexandre Courbot
2026-11-06 9:08 ` Eliot Courtney
2026-11-06 7:06 ` [PATCH v2 5/6] gpu: nova-core: gsp: cmdq: do not use ENOMSG to skip messages Alexandre Courbot
2026-11-06 7:06 ` [PATCH v2 6/6] gpu: nova-core: gsp: cmdq: add the GMC receive path Alexandre Courbot
5 siblings, 1 reply; 10+ messages in thread
From: Alexandre Courbot @ 2026-11-06 7:06 UTC (permalink / raw)
To: Danilo Krummrich, Alice Ryhl, David Airlie, Simona Vetter,
Benno Lossin, Gary Guo
Cc: John Hubbard, Alistair Popple, Timur Tabi, Eliot Courtney,
Zhi Wang, linux-kernel, nova-gpu, rust-for-linux,
Alexandre Courbot
Trimming the two driver-owned slices of the command queue to the
advertised length of a message is going to be used by both RPC and GMC
messages, so factor that part out into a private function.
The parsing itself can be improved by leveraging `split_at_checked` and
`get`, so use them.
No functional change intended.
Suggested-by: Eliot Courtney <ecourtney@nvidia.com>
Link: https://lore.kernel.org/all/DMN62G2CDG3N.ETT4GRFXWKKU@nvidia.com/
Signed-off-by: Alexandre Courbot <acourbot@nvidia.com>
---
drivers/gpu/nova-core/gsp/cmdq.rs | 21 +++++++++++++++++++++
drivers/gpu/nova-core/gsp/cmdq/rpc.rs | 20 +-------------------
2 files changed, 22 insertions(+), 19 deletions(-)
diff --git a/drivers/gpu/nova-core/gsp/cmdq.rs b/drivers/gpu/nova-core/gsp/cmdq.rs
index 9dd11ac8952b..f3151aa8ea26 100644
--- a/drivers/gpu/nova-core/gsp/cmdq.rs
+++ b/drivers/gpu/nova-core/gsp/cmdq.rs
@@ -719,3 +719,24 @@ fn drain(&mut self) -> Result {
}
}
}
+
+/// Helper function that trims the concatenation of `slice_1` and `slice_2` to `length`.
+///
+/// Returns the truncated `(slice_1, slice_2)` pair, or `EIO` if `length > slice_1.len() +
+/// slice_2.len()`.
+fn trim_message_slice<'a>(
+ (slice_1, slice_2): (&'a [u8], &'a [u8]),
+ length: usize,
+) -> Result<(&'a [u8], &'a [u8])> {
+ // See if `slice_1` covers the whole message, take it entirely if it doesn't.
+ let slice_1 = slice_1
+ .split_at_checked(length)
+ .map(|split| split.0)
+ .unwrap_or(slice_1);
+ // `slice_2` is the remainder of the message not covered by `slice_1`.
+ let slice_2 = slice_2
+ .get(..length.saturating_sub(slice_1.len()))
+ .ok_or(EIO)?;
+
+ Ok((slice_1, slice_2))
+}
diff --git a/drivers/gpu/nova-core/gsp/cmdq/rpc.rs b/drivers/gpu/nova-core/gsp/cmdq/rpc.rs
index 36cba7c28d3e..6ee28e93586b 100644
--- a/drivers/gpu/nova-core/gsp/cmdq/rpc.rs
+++ b/drivers/gpu/nova-core/gsp/cmdq/rpc.rs
@@ -214,27 +214,9 @@ pub(super) fn parse(dev: &device::Device, element: GspMessage<'a>) -> Result<Rpc
payload_length,
);
- // Check that the driver read area is large enough for the message.
- if slice_1.len() + slice_2.len() < payload_length {
- return Err(EIO);
- }
-
- // Cut the message slices down to the actual length of the message.
- let (slice_1, slice_2) = if slice_1.len() > payload_length {
- // PANIC: we checked above that `slice_1` is at least as long as `payload_length`.
- (slice_1.split_at(payload_length).0, &slice_2[0..0])
- } else {
- (
- slice_1,
- // PANIC: we checked above that `slice_1.len() + slice_2.len()` is at least as
- // large as `payload_length`.
- slice_2.split_at(payload_length - slice_1.len()).0,
- )
- };
-
Ok(RpcMessage {
header: rpc_header,
- contents: (slice_1, slice_2),
+ contents: super::trim_message_slice((slice_1, slice_2), payload_length)?,
})
}
--
2.56.0
^ permalink raw reply [flat|nested] 10+ messages in thread* Re: [PATCH v2 4/6] gpu: nova-core: gsp: cmdq: move message trimming into its own function
2026-11-06 7:06 ` [PATCH v2 4/6] gpu: nova-core: gsp: cmdq: move message trimming into its own function Alexandre Courbot
@ 2026-11-06 9:08 ` Eliot Courtney
0 siblings, 0 replies; 10+ messages in thread
From: Eliot Courtney @ 2026-11-06 9:08 UTC (permalink / raw)
To: Alexandre Courbot, Danilo Krummrich, Alice Ryhl, David Airlie,
Simona Vetter, Benno Lossin, Gary Guo
Cc: John Hubbard, Alistair Popple, Timur Tabi, Eliot Courtney,
Zhi Wang, linux-kernel, nova-gpu, rust-for-linux
On Fri Nov 6, 2026 at 4:06 PM JST, Alexandre Courbot wrote:
> Trimming the two driver-owned slices of the command queue to the
> advertised length of a message is going to be used by both RPC and GMC
> messages, so factor that part out into a private function.
>
> The parsing itself can be improved by leveraging `split_at_checked` and
> `get`, so use them.
>
> No functional change intended.
>
> Suggested-by: Eliot Courtney <ecourtney@nvidia.com>
> Link: https://lore.kernel.org/all/DMN62G2CDG3N.ETT4GRFXWKKU@nvidia.com/
> Signed-off-by: Alexandre Courbot <acourbot@nvidia.com>
> ---
> drivers/gpu/nova-core/gsp/cmdq.rs | 21 +++++++++++++++++++++
> drivers/gpu/nova-core/gsp/cmdq/rpc.rs | 20 +-------------------
> 2 files changed, 22 insertions(+), 19 deletions(-)
>
> diff --git a/drivers/gpu/nova-core/gsp/cmdq.rs b/drivers/gpu/nova-core/gsp/cmdq.rs
> index 9dd11ac8952b..f3151aa8ea26 100644
> --- a/drivers/gpu/nova-core/gsp/cmdq.rs
> +++ b/drivers/gpu/nova-core/gsp/cmdq.rs
> @@ -719,3 +719,24 @@ fn drain(&mut self) -> Result {
> }
> }
> }
> +
> +/// Helper function that trims the concatenation of `slice_1` and `slice_2` to `length`.
> +///
> +/// Returns the truncated `(slice_1, slice_2)` pair, or `EIO` if `length > slice_1.len() +
> +/// slice_2.len()`.
> +fn trim_message_slice<'a>(
> + (slice_1, slice_2): (&'a [u8], &'a [u8]),
> + length: usize,
> +) -> Result<(&'a [u8], &'a [u8])> {
> + // See if `slice_1` covers the whole message, take it entirely if it doesn't.
> + let slice_1 = slice_1
> + .split_at_checked(length)
> + .map(|split| split.0)
> + .unwrap_or(slice_1);
> + // `slice_2` is the remainder of the message not covered by `slice_1`.
> + let slice_2 = slice_2
> + .get(..length.saturating_sub(slice_1.len()))
> + .ok_or(EIO)?;
> +
> + Ok((slice_1, slice_2))
> +}
I think .split_at_checked(length).map(|x| x.0) is the same as
.get(..length), so you can prolly just write:
```
let slice_1 = slice_1.get(..length).unwrap_or(slice_1);
let slice_2 = slice_2.get(..length - slice_1.len()).ok_or(EIO)?;
```
Up to you if you want to use a checked_sub or saturating_sub but it's
locally clear that it won't underflow imo.
Reviewed-by: Eliot Courtney <ecourtney@nvidia.com>
^ permalink raw reply [flat|nested] 10+ messages in thread
* [PATCH v2 5/6] gpu: nova-core: gsp: cmdq: do not use ENOMSG to skip messages
2026-11-06 7:06 [PATCH v2 0/6] gpu: nova-core: gsp: add support for GMC messages Alexandre Courbot
` (3 preceding siblings ...)
2026-11-06 7:06 ` [PATCH v2 4/6] gpu: nova-core: gsp: cmdq: move message trimming into its own function Alexandre Courbot
@ 2026-11-06 7:06 ` Alexandre Courbot
2026-11-06 9:09 ` Eliot Courtney
2026-11-06 7:06 ` [PATCH v2 6/6] gpu: nova-core: gsp: cmdq: add the GMC receive path Alexandre Courbot
5 siblings, 1 reply; 10+ messages in thread
From: Alexandre Courbot @ 2026-11-06 7:06 UTC (permalink / raw)
To: Danilo Krummrich, Alice Ryhl, David Airlie, Simona Vetter,
Benno Lossin, Gary Guo
Cc: John Hubbard, Alistair Popple, Timur Tabi, Eliot Courtney,
Zhi Wang, linux-kernel, nova-gpu, rust-for-linux,
Alexandre Courbot
`await_msg_with` currently relies on its closure returning `ENOMSG` to
signal that the message it received is not the one it was waiting for,
and that it should be dropped. This makes `ENOMSG` an in-band control
signal, as code running inside the closure that returns `ENOMSG` for an
unrelated reason makes the queue skip the message instead of reporting
the error.
Make the closure return `Result<Option<R>>` instead, with `Ok(None)`
meaning that the message is to be dropped. Errors returned by the
closure are now always propagated to the caller, so no error code from
the closure can alter the control flow of the command queue.
Suggested-by: Eliot Courtney <ecourtney@nvidia.com>
Link: https://lore.kernel.org/all/DMN62G2CDG3N.ETT4GRFXWKKU@nvidia.com/
Signed-off-by: Alexandre Courbot <acourbot@nvidia.com>
---
drivers/gpu/nova-core/gsp/cmdq.rs | 19 ++++++++++---------
drivers/gpu/nova-core/gsp/cmdq/rpc.rs | 5 +++--
2 files changed, 13 insertions(+), 11 deletions(-)
diff --git a/drivers/gpu/nova-core/gsp/cmdq.rs b/drivers/gpu/nova-core/gsp/cmdq.rs
index f3151aa8ea26..e6a46c5b5160 100644
--- a/drivers/gpu/nova-core/gsp/cmdq.rs
+++ b/drivers/gpu/nova-core/gsp/cmdq.rs
@@ -676,27 +676,28 @@ fn consume_element<R>(
///
/// The message is waited for up to [`Cmdq::RECEIVE_TIMEOUT`] from the call.
///
- /// `f` is expected to return `Ok` with the result to return to the caller, and `Err(ENOMSG)` to
- /// signal that the received message was not the one expected (such messages are dropped). Any
- /// other error returned by `f` is propagated to the caller.
+ /// `f` is expected to return `Ok(Some(_))` with the result to return to the caller, and
+ /// `Ok(None)` to signal that the received message was not the one expected (such messages are
+ /// dropped). Errors returned by `f` are propagated to the caller.
///
/// # Errors
///
/// - `ETIMEDOUT` if no message satisfying `f` arrives before the deadline, however many other
/// messages arrive while waiting.
/// - `EIO` if a message fails framing or checksum validation.
- /// - Any error returned by `f` with the exception of `ENOMSG`.
- fn await_msg_with<R>(&mut self, f: impl Fn(GspParsedMessage<'_>) -> Result<R>) -> Result<R> {
+ /// - Any error returned by `f`.
+ fn await_msg_with<R>(
+ &mut self,
+ f: impl Fn(GspParsedMessage<'_>) -> Result<Option<R>>,
+ ) -> Result<R> {
let deadline = Instant::<Monotonic>::now() + Cmdq::RECEIVE_TIMEOUT;
loop {
let remaining = deadline - Instant::<Monotonic>::now();
if remaining.is_negative() {
break Err(ETIMEDOUT);
}
- match self.consume_element(remaining, &f)? {
- Ok(m) => break Ok(m),
- Err(ENOMSG) => continue,
- Err(e) => break Err(e),
+ if let Some(m) = self.consume_element(remaining, &f)?? {
+ break Ok(m);
}
}
}
diff --git a/drivers/gpu/nova-core/gsp/cmdq/rpc.rs b/drivers/gpu/nova-core/gsp/cmdq/rpc.rs
index 6ee28e93586b..d01a9f4f953d 100644
--- a/drivers/gpu/nova-core/gsp/cmdq/rpc.rs
+++ b/drivers/gpu/nova-core/gsp/cmdq/rpc.rs
@@ -377,7 +377,7 @@ fn await_rpc_msg<M: MessageFromGsp>(&mut self) -> Result<M>
let mut sbuffer = SBufferIter::new_reader([contents_1, rpc_message.contents.1]);
M::read(cmd, &mut sbuffer)
- .map_err(|e| e.into())
+ .map_err(Error::from)
.inspect(|_| {
if !sbuffer.is_empty() {
dev_warn!(
@@ -387,10 +387,11 @@ fn await_rpc_msg<M: MessageFromGsp>(&mut self) -> Result<M>
);
}
})
+ .map(Some)
} else {
rpc_message.log(self.dev);
- Err(ENOMSG)
+ Ok(None)
}
};
--
2.56.0
^ permalink raw reply [flat|nested] 10+ messages in thread* Re: [PATCH v2 5/6] gpu: nova-core: gsp: cmdq: do not use ENOMSG to skip messages
2026-11-06 7:06 ` [PATCH v2 5/6] gpu: nova-core: gsp: cmdq: do not use ENOMSG to skip messages Alexandre Courbot
@ 2026-11-06 9:09 ` Eliot Courtney
0 siblings, 0 replies; 10+ messages in thread
From: Eliot Courtney @ 2026-11-06 9:09 UTC (permalink / raw)
To: Alexandre Courbot, Danilo Krummrich, Alice Ryhl, David Airlie,
Simona Vetter, Benno Lossin, Gary Guo
Cc: John Hubbard, Alistair Popple, Timur Tabi, Eliot Courtney,
Zhi Wang, linux-kernel, nova-gpu, rust-for-linux
On Fri Nov 6, 2026 at 4:06 PM JST, Alexandre Courbot wrote:
> `await_msg_with` currently relies on its closure returning `ENOMSG` to
> signal that the message it received is not the one it was waiting for,
> and that it should be dropped. This makes `ENOMSG` an in-band control
> signal, as code running inside the closure that returns `ENOMSG` for an
> unrelated reason makes the queue skip the message instead of reporting
> the error.
>
> Make the closure return `Result<Option<R>>` instead, with `Ok(None)`
> meaning that the message is to be dropped. Errors returned by the
> closure are now always propagated to the caller, so no error code from
> the closure can alter the control flow of the command queue.
>
> Suggested-by: Eliot Courtney <ecourtney@nvidia.com>
> Link: https://lore.kernel.org/all/DMN62G2CDG3N.ETT4GRFXWKKU@nvidia.com/
> Signed-off-by: Alexandre Courbot <acourbot@nvidia.com>
> ---
Reviewed-by: Eliot Courtney <ecourtney@nvidia.com>
^ permalink raw reply [flat|nested] 10+ messages in thread
* [PATCH v2 6/6] gpu: nova-core: gsp: cmdq: add the GMC receive path
2026-11-06 7:06 [PATCH v2 0/6] gpu: nova-core: gsp: add support for GMC messages Alexandre Courbot
` (4 preceding siblings ...)
2026-11-06 7:06 ` [PATCH v2 5/6] gpu: nova-core: gsp: cmdq: do not use ENOMSG to skip messages Alexandre Courbot
@ 2026-11-06 7:06 ` Alexandre Courbot
2026-11-06 9:38 ` Eliot Courtney
5 siblings, 1 reply; 10+ messages in thread
From: Alexandre Courbot @ 2026-11-06 7:06 UTC (permalink / raw)
To: Danilo Krummrich, Alice Ryhl, David Airlie, Simona Vetter,
Benno Lossin, Gary Guo
Cc: John Hubbard, Alistair Popple, Timur Tabi, Eliot Courtney,
Zhi Wang, linux-kernel, nova-gpu, rust-for-linux,
Alexandre Courbot
From: John Hubbard <jhubbard@nvidia.com>
GSP-RM answers a GMC request with a GMC message whose command word
carries the response flag and the id of the request, and whose sequence
number is that of the request. It also raises GMC events, named by a
command id. During boot, the load-and-execute events arrive while the
driver is waiting for the GSP_INIT reply, and GSP-RM only answers once
they have been handled.
Add the receive side of the gmc sub-module, mirroring the
already-existing rpc sub-module.
The transport cannot produce GMC messages yet: the r570 queue element
header does not carry the type of the message it transports, so the Gmc
variant of GspParsedMessage is only constructed once the switch to r000
makes the transport dispatch on the NVDM type. The RPC receive path and
drain() account for it by logging unclaimed GMC messages.
Signed-off-by: John Hubbard <jhubbard@nvidia.com>
Co-developed-by: Alexandre Courbot <acourbot@nvidia.com>
Signed-off-by: Alexandre Courbot <acourbot@nvidia.com>
---
drivers/gpu/nova-core/gsp/cmdq.rs | 7 +
drivers/gpu/nova-core/gsp/cmdq/gmc.rs | 232 ++++++++++++++++++++++++++++++++++
drivers/gpu/nova-core/gsp/cmdq/rpc.rs | 8 +-
drivers/gpu/nova-core/gsp/fw.rs | 3 +-
4 files changed, 248 insertions(+), 2 deletions(-)
diff --git a/drivers/gpu/nova-core/gsp/cmdq.rs b/drivers/gpu/nova-core/gsp/cmdq.rs
index e6a46c5b5160..81f1d779e264 100644
--- a/drivers/gpu/nova-core/gsp/cmdq.rs
+++ b/drivers/gpu/nova-core/gsp/cmdq.rs
@@ -428,6 +428,12 @@ struct GspMessage<'a> {
enum GspParsedMessage<'a> {
/// A [RPC message](rpc::RpcMessage).
Rpc(rpc::RpcMessage<'a>),
+ /// A [GMC message](gmc::GmcMessage).
+ //
+ // The transport header of the r570 firmware carries no message type, so this variant cannot
+ // be constructed before the switch to r000.
+ #[expect(dead_code)]
+ Gmc(gmc::GmcMessage<'a>),
}
impl GspParsedMessage<'_> {
@@ -435,6 +441,7 @@ impl GspParsedMessage<'_> {
fn log(&self, dev: &device::Device) {
match self {
GspParsedMessage::Rpc(rpc) => rpc.log(dev),
+ GspParsedMessage::Gmc(gmc) => gmc.log(dev),
}
}
}
diff --git a/drivers/gpu/nova-core/gsp/cmdq/gmc.rs b/drivers/gpu/nova-core/gsp/cmdq/gmc.rs
index f741de8288c5..e7babd4aaf3b 100644
--- a/drivers/gpu/nova-core/gsp/cmdq/gmc.rs
+++ b/drivers/gpu/nova-core/gsp/cmdq/gmc.rs
@@ -19,6 +19,8 @@
CmdqInner,
CommandElement,
GspCommand,
+ GspMessage,
+ GspParsedMessage,
NoReply, //
},
fw::{
@@ -158,7 +160,154 @@ fn write(&self, dev: &device::Device, seq: u32, dst: &mut GspCommand<'_>) -> Res
}
}
+/// Trait representing GMC messages received from the GSP.
+///
+/// These can be either replies to sent commands that expect a reply, or an event not bound to any
+/// command.
+pub(crate) trait MessageFromGsp: Sized {
+ /// Error type returned by [`MessageFromGsp::read`].
+ type InitError;
+
+ /// Method reading the reply from the payload of the message and returning it.
+ fn read(
+ payload: &mut SBufferIter<core::array::IntoIter<&[u8], 2>>,
+ ) -> Result<Self, Self::InitError>;
+}
+
+/// A GMC message ready to be processed from the message queue.
+pub(crate) struct GmcMessage<'a> {
+ // Reference to the GMC API header of the message.
+ header: &'a GmcApiHeader,
+ // Slices to the payload of the message. The second slice is empty unless the message loops
+ // over the message queue.
+ contents: (&'a [u8], &'a [u8]),
+}
+
+impl<'a> GmcMessage<'a> {
+ /// Validates the GMC layer of `element` and returns its GMC API header and its contents trimmed
+ /// down to the GMC payload.
+ ///
+ /// # Errors
+ ///
+ /// - `EIO` if the element is shorter than the GMC API header, or than the payload length
+ /// advertised by the GMC API header.
+ pub(super) fn parse(dev: &device::Device, element: GspMessage<'a>) -> Result<GmcMessage<'a>> {
+ static_assert!(size_of::<GspMsgElement>() + size_of::<GmcApiHeader>() <= GSP_PAGE_SIZE);
+
+ let GspMessage {
+ contents: (slice_1, slice_2),
+ ..
+ } = element;
+
+ // Per the `static_assert!` above, the GSP message header and the GMC API header together
+ // are guaranteed to fit entirely into a single page, so it's ok to only look at `slice_1`
+ // here.
+ let (gmc_header, slice_1) = GmcApiHeader::from_bytes_prefix(slice_1).ok_or(EIO)?;
+ let payload_size = gmc_header.payload_size();
+
+ dev_dbg!(
+ dev,
+ "GSP GMC: receive: seq# {}, command={:?}, length=0x{:x}\n",
+ gmc_header.sequence(),
+ gmc_header.command(),
+ payload_size,
+ );
+
+ Ok(GmcMessage {
+ header: gmc_header,
+ contents: super::trim_message_slice((slice_1, slice_2), payload_size)?,
+ })
+ }
+
+ /// Returns the GMC API header of the message.
+ pub(crate) fn header(&self) -> &'a GmcApiHeader {
+ self.header
+ }
+
+ /// Returns the payload of the message.
+ ///
+ /// The second slice is empty unless the message loops over the message queue.
+ pub(crate) fn payload(&self) -> (&'a [u8], &'a [u8]) {
+ self.contents
+ }
+
+ /// Returns the status code of this message if it is the reply to `command` sent with sequence
+ /// number `seq`, `None` otherwise.
+ fn reply_status(&self, command: GmcCommandId, seq: u32) -> Option<u32> {
+ if matches!(self.header.command().id(), Ok(id) if id == command)
+ && self.header.sequence() == u64::from(seq)
+ {
+ self.header.status()
+ } else {
+ None
+ }
+ }
+
+ /// Logs an event, meaning a message that no caller was waiting for.
+ ///
+ /// A reply that nobody claimed (e.g. one that arrived after its request timed out) and an
+ /// unknown command id are logged at warning level. Other events are not logged.
+ pub(super) fn log(&self, dev: &device::Device) {
+ let command = self.header.command();
+ let seq = self.header.sequence();
+
+ match command.id() {
+ Ok(id) if command.is_response() => {
+ dev_warn!(dev, "unclaimed GSP GMC reply to {:?} (seq {})\n", id, seq);
+ }
+ // Nothing to do for the remaining known command ids.
+ Ok(_) => {}
+ Err(_) => {
+ dev_warn!(dev, "unknown GSP GMC command {:?} (seq {})\n", command, seq);
+ }
+ }
+ }
+}
+
impl Cmdq<'_> {
+ /// Sends `command` to the GSP and waits for the reply.
+ ///
+ /// GMC events that arrive before the reply are passed to `on_event`, and RPC messages are
+ /// logged and consumed. The boot sequence relies on this to handle the load-and-execute
+ /// events that GSP-RM raises before it answers `GSP_INIT`.
+ ///
+ /// The queue is locked for the entire send+receive cycle, including the calls to `on_event`,
+ /// to ensure that no other command can be interleaved. `on_event` must thus not use the queue.
+ /// An error returned by `on_event` stops the wait and is returned to the caller.
+ ///
+ /// Returns `Ok(Ok(reply))` if GSP-RM completed the command successfully, and `Ok(Err(status))`
+ /// with the `NV_STATUS` code of the reply if GSP-RM completed it with an error. The outer
+ /// [`Result`] is reserved for failures to send the command or to receive its reply.
+ ///
+ /// # Errors
+ ///
+ /// - `EMSGSIZE` if the command does not fit in a single command queue element.
+ /// - `ETIMEDOUT` if space does not become available to send the command, or if the reply does
+ /// not arrive within [`Self::RECEIVE_TIMEOUT`] of the send, however many events arrive
+ /// while waiting.
+ /// - `EIO` if the variable payload requested by the command has not been entirely
+ /// written to by its [`CommandToGsp::init_variable_payload`] method, or if a message fails
+ /// framing or checksum validation.
+ ///
+ /// Error codes returned by the command and reply initializers, and by `on_event`, are
+ /// propagated as-is.
+ pub(crate) fn send_gmc_command<C>(
+ &self,
+ command: C,
+ on_event: impl Fn(&GmcMessage<'_>) -> Result,
+ ) -> Result<Result<C::Reply, u32>>
+ where
+ C: CommandToGsp,
+ C::Reply: MessageFromGsp,
+ Error: From<C::InitError>,
+ Error: From<<C::Reply as MessageFromGsp>::InitError>,
+ {
+ let mut inner = self.inner.lock();
+ let seq = inner.send_gmc_command(command)?;
+
+ inner.await_gmc_reply::<C>(seq, on_event)
+ }
+
/// Sends `command` to the GSP without waiting for a reply.
///
/// # Errors
@@ -199,4 +348,87 @@ fn send_gmc_command<C>(&mut self, command: C) -> Result<u32>
{
self.send_command_element(GmcCommandElement(command))
}
+
+ /// Receives the reply of type `C::Reply` to the command sent with sequence number `seq`,
+ /// waiting up to [`Cmdq::RECEIVE_TIMEOUT`] from the call.
+ ///
+ /// Any GMC event that arrives first is passed to `on_event`, and any RPC message is logged.
+ /// Neither extends the deadline.
+ ///
+ /// Returns `Ok(Err(status))` if the reply carries a status other than `NV_OK`.
+ ///
+ /// # Errors
+ ///
+ /// - `ETIMEDOUT` if the reply does not arrive before the deadline, however many other messages
+ /// arrive while waiting.
+ /// - `EIO` if a message fails framing or checksum validation.
+ ///
+ /// Error codes returned by [`MessageFromGsp::read`] and by `on_event` are propagated as-is.
+ fn await_gmc_reply<C: CommandToGsp>(
+ &mut self,
+ seq: u32,
+ on_event: impl Fn(&GmcMessage<'_>) -> Result,
+ ) -> Result<Result<C::Reply, u32>>
+ where
+ C::Reply: MessageFromGsp,
+ // This allows all error types, including `Infallible`, to be used for `InitError`.
+ Error: From<<C::Reply as MessageFromGsp>::InitError>,
+ {
+ let dev = self.dev;
+
+ self.await_msg_with(|message| -> Result<Option<Result<C::Reply, u32>>> {
+ let gmc_message = match message {
+ GspParsedMessage::Gmc(gmc_message) => gmc_message,
+ _ => {
+ message.log(dev);
+ return Ok(None);
+ }
+ };
+
+ let status = match gmc_message.reply_status(C::COMMAND, seq) {
+ Some(status) => status,
+ // Reply to another command, e.g. one that timed out earlier.
+ None if gmc_message.header.command().is_response() => {
+ dev_warn!(
+ dev,
+ "GSP GMC: unexpected reply ({:?}, {}) while waiting for ({:?}, {})\n",
+ gmc_message.header.command(),
+ gmc_message.header.sequence(),
+ C::COMMAND,
+ seq,
+ );
+ return Ok(None);
+ }
+ // Regular event, pass to handler.
+ None => {
+ on_event(&gmc_message)?;
+ return Ok(None);
+ }
+ };
+
+ // `NV_OK` is zero, any other value means the command has failed.
+ if status != 0 {
+ dev_dbg!(
+ dev,
+ "GSP GMC: command {:?} failed with status {:#x}\n",
+ C::COMMAND,
+ status
+ );
+
+ return Ok(Some(Err(status)));
+ }
+
+ let mut sbuffer =
+ SBufferIter::new_reader([gmc_message.contents.0, gmc_message.contents.1]);
+
+ C::Reply::read(&mut sbuffer)
+ .map_err(Error::from)
+ .inspect(|_| {
+ if !sbuffer.is_empty() {
+ dev_warn!(dev, "GSP GMC reply {:?} has unprocessed data\n", C::COMMAND);
+ }
+ })
+ .map(|reply| Some(Ok(reply)))
+ })
+ }
}
diff --git a/drivers/gpu/nova-core/gsp/cmdq/rpc.rs b/drivers/gpu/nova-core/gsp/cmdq/rpc.rs
index d01a9f4f953d..10d3f68b2f61 100644
--- a/drivers/gpu/nova-core/gsp/cmdq/rpc.rs
+++ b/drivers/gpu/nova-core/gsp/cmdq/rpc.rs
@@ -369,7 +369,13 @@ fn await_rpc_msg<M: MessageFromGsp>(&mut self) -> Result<M>
Error: From<M::InitError>,
{
let f = |message: GspParsedMessage<'_>| {
- let GspParsedMessage::Rpc(rpc_message) = message;
+ let rpc_message = match message {
+ GspParsedMessage::Rpc(rpc_message) => rpc_message,
+ _ => {
+ message.log(self.dev);
+ return Ok(None);
+ }
+ };
let function = rpc_message.header.function();
if matches!(function, Ok(f) if f == M::FUNCTION) {
let (cmd, contents_1) =
diff --git a/drivers/gpu/nova-core/gsp/fw.rs b/drivers/gpu/nova-core/gsp/fw.rs
index 08f97c4e73a0..75b98f24dea1 100644
--- a/drivers/gpu/nova-core/gsp/fw.rs
+++ b/drivers/gpu/nova-core/gsp/fw.rs
@@ -939,7 +939,8 @@ pub(crate) struct GmcApiHeader {
inner: r000_00::GMCAPI_HEADER,
}
-#[expect(dead_code)]
+// Using `allow` instead of `expect` here due to rust-lang/rust#154377.
+#[allow(dead_code)]
impl GmcApiHeader {
/// Creates the header of a request for `command`, sent with sequence number `sequence` and
/// followed by `payload_size` bytes of payload.
--
2.56.0
^ permalink raw reply [flat|nested] 10+ messages in thread* Re: [PATCH v2 6/6] gpu: nova-core: gsp: cmdq: add the GMC receive path
2026-11-06 7:06 ` [PATCH v2 6/6] gpu: nova-core: gsp: cmdq: add the GMC receive path Alexandre Courbot
@ 2026-11-06 9:38 ` Eliot Courtney
0 siblings, 0 replies; 10+ messages in thread
From: Eliot Courtney @ 2026-11-06 9:38 UTC (permalink / raw)
To: Alexandre Courbot, Danilo Krummrich, Alice Ryhl, David Airlie,
Simona Vetter, Benno Lossin, Gary Guo
Cc: John Hubbard, Alistair Popple, Timur Tabi, Eliot Courtney,
Zhi Wang, linux-kernel, nova-gpu, rust-for-linux
On Fri Nov 6, 2026 at 4:06 PM JST, Alexandre Courbot wrote:
> From: John Hubbard <jhubbard@nvidia.com>
>
> GSP-RM answers a GMC request with a GMC message whose command word
> carries the response flag and the id of the request, and whose sequence
> number is that of the request. It also raises GMC events, named by a
> command id. During boot, the load-and-execute events arrive while the
> driver is waiting for the GSP_INIT reply, and GSP-RM only answers once
> they have been handled.
>
> Add the receive side of the gmc sub-module, mirroring the
> already-existing rpc sub-module.
>
> The transport cannot produce GMC messages yet: the r570 queue element
> header does not carry the type of the message it transports, so the Gmc
> variant of GspParsedMessage is only constructed once the switch to r000
> makes the transport dispatch on the NVDM type. The RPC receive path and
> drain() account for it by logging unclaimed GMC messages.
>
> Signed-off-by: John Hubbard <jhubbard@nvidia.com>
> Co-developed-by: Alexandre Courbot <acourbot@nvidia.com>
> Signed-off-by: Alexandre Courbot <acourbot@nvidia.com>
> ---
[...]
> + fn await_gmc_reply<C: CommandToGsp>(
> + &mut self,
> + seq: u32,
> + on_event: impl Fn(&GmcMessage<'_>) -> Result,
> + ) -> Result<Result<C::Reply, u32>>
> + where
> + C::Reply: MessageFromGsp,
> + // This allows all error types, including `Infallible`, to be used for `InitError`.
> + Error: From<<C::Reply as MessageFromGsp>::InitError>,
> + {
> + let dev = self.dev;
> +
> + self.await_msg_with(|message| -> Result<Option<Result<C::Reply, u32>>> {
optional nit: add a TODO to say we should make and use an NvStatus enum
instead of u32 here.
I had renamed my original nvstatus enum I sent ages ago, here's the
original [1].
The previous concern [2] for landing this is that when the bindings change
we may forget to update the enum. Now that nvstatus is being returned as
part of a stable API surface I think that concern is less strong,
because it'll have to be both append only and backwards compatible, so
we could get a nvstatus value we don't know about from newer firmwares,
which we'd have to handle somehow anyway (so forgetting to update the
enum necessarily can't cause an issue).
Anyway I say it's optional nit because I think it'll be a long while
before we want to differentiate behaviour based on anything other than
success/failure in nvstatus.
[1]: https://lore.kernel.org/all/20260227-rmcontrol-v1-2-86648e4869f9@nvidia.com/
[2]: https://lore.kernel.org/all/fd010f7a-6d0d-4faf-bdea-23bac608f03e@nvidia.com/
Reviewed-by: Eliot Courtney <ecourtney@nvidia.com>
^ permalink raw reply [flat|nested] 10+ messages in thread