[PATCH 1/3] doc: dmaengine: client-api: Add immediate commands in the DMA client API

From: Nickolay Goppen

Date: Sun Nov 15 2026 - 09:05:02 EST


From: Sireesh Kodali <sireeshkodali1@xxxxxxxxx>

Immediate commands are used by the IPA driver to send commands to the
microcontroller over BAM. These are different from PREP_CMD.

Signed-off-by: Sireesh Kodali <sireeshkodali1@xxxxxxxxx>
Signed-off-by: Nickolay Goppen <setotau@xxxxxxxxxxxxxx>
---
Documentation/driver-api/dmaengine/provider.rst | 10 ++++++++++
1 file changed, 10 insertions(+)

diff --git a/Documentation/driver-api/dmaengine/provider.rst b/Documentation/driver-api/dmaengine/provider.rst
index be47852e5a0f..05911c03558d 100644
--- a/Documentation/driver-api/dmaengine/provider.rst
+++ b/Documentation/driver-api/dmaengine/provider.rst
@@ -612,6 +612,16 @@ DMA_CTRL_REUSE
writes for which the descriptor should be in different format from
normal data descriptors.

+- DMA_PREP_IMM_CMD
+
+ - If set, the client driver tells DMA controller that passed data in DMA
+ API is immediate command data.
+
+ - Interpretation of command data is DMA controller specific. It can be
+ used for issuing immediate commands to other peripherals/register
+ reads/register writes for which the descriptor should be in a
+ different format from normal data descriptors.
+
- DMA_PREP_REPEAT

- If set, the transfer will be automatically repeated when it ends until a

--
2.56.1