The upcoming r000 firmware support [1] introduces a new type of command named GMC alongside the existing and already supported RPC command type.
Since RPC was the only command type supported so far, it was embedded into the lowest command queue level: the message header actually includes the RPC header and the code considers them as one. This makes the r000/GMC support difficult to land without a refactor, with the result of transport layer code being duplicated between the two message types, and no clear separation between the RPC and GMC code which are mixed together in the command queue. Merging the code that way would introduce quite some technical debt. Thus, this series prepares a proper landing ground for a new message type by extracting all the RPC layer code and moving it into its own sub-modules, making the `cmdq` module completely agnostic of the type of message it transports. By the end of the series, the only mention of RPC in `cmdq.rs` is for the `rpc` sub-module. With the transport and message layers properly separated, support for GMC can be added into sibling modules of `rpc`, and the transport layer can be converted once when doing the switch to r000. This moves quite a bit of code around, but most of it is moved verbatim. No significant functional change is intended. For the r000 series, this essentially means the following: - Its patch 7 making `allocate_command` generic can be dropped as the transport layer makes no assumption about the message type. - Patches adding GMC support will do it in dedicated `gmc` sub-modules, following the model set by RPC. These `gmc` sub-modules will start as `dead_code` as they are being built. - The "switch to r000" patch will essentially operate on the transport layer level, i.e. `cmdq.rs`. - There should be no need for extra post-switch RPC fixing, as the transport layer code will already be shared with GMC. Overall, this should make the r000 series much easier to review and eventually land, while not creating new technical debt. This series is based on `drm-rust-next`. [1] https://lore.kernel.org/all/[email protected]/ Signed-off-by: Alexandre Courbot <[email protected]> --- Changes in v3: - Use dedicated `RpcMessage` type to distinguish parsed RPC message from the transport-level `GspMessage`. - Introduce traits for sending and receiving elements on the command queue (thanks Eliot!). - Split unsafe blocks, drop unused impls, and other fixes on patch 2. (thanks Eliot!) - Squash the two move commits into a single one. - Link to v2: https://patch.msgid.link/[email protected] Changes in v2: - Fix checksum on receive incorrectly using the whole slots allocated to the message instead of its actual length. (Sashiko) - Drop patch 1 to avoid having to validate the `elemCount` header member against edge cases. (Sashiko) - Fix incorrect layer separation in receive path, where the CPU read pointer was advanced in the message layer. - Fix doclinks pointing to old function names. (Sashiko) - Link to v1: https://patch.msgid.link/[email protected] --- Alexandre Courbot (9): gpu: nova-core: gsp: cmdq: validate checksum earlier on receive gpu: nova-core: gsp: introduce and use proper RpcMessageHeader type gpu: nova-core: gsp: cmdq: group the RPC-specific part of send_single_command gpu: nova-core: gsp: cmdq: split the transport part of the send path gpu: nova-core: gsp: cmdq: split RPC parsing part of the receive path gpu: nova-core: gsp: cmdq: split the transport part of the receive path gpu: nova-core: gsp: cmdq: move the RPC code into a sub-module gpu: nova-core: gsp: move the RPC commands into a sub-module gpu: nova-core: gsp: add `rpc` to RPC message send/receive methods drivers/gpu/nova-core/api.rs | 2 +- drivers/gpu/nova-core/gpu.rs | 2 +- drivers/gpu/nova-core/gsp.rs | 4 +- drivers/gpu/nova-core/gsp/boot.rs | 12 +- drivers/gpu/nova-core/gsp/cmdq.rs | 351 +++---------------- drivers/gpu/nova-core/gsp/cmdq/rpc.rs | 380 +++++++++++++++++++++ .../nova-core/gsp/cmdq/{ => rpc}/continuation.rs | 0 drivers/gpu/nova-core/gsp/commands.rs | 335 +----------------- drivers/gpu/nova-core/gsp/commands/rpc.rs | 339 ++++++++++++++++++ drivers/gpu/nova-core/gsp/fw.rs | 88 +++-- drivers/gpu/nova-core/gsp/sequencer.rs | 6 +- 11 files changed, 834 insertions(+), 685 deletions(-) --- base-commit: 10a6623a24a85708650efad7be15182289403cd7 change-id: 20260927-cmdq-rpc-ed5f850b207e Best regards, -- Alexandre Courbot <[email protected]>
