From: Robert Jarzmik Date: Sun, 17 Jun 2018 17:02:14 +0000 (+0200) Subject: dmaengine: pxa: document pxad_param X-Git-Tag: v5.15~8137^2~9^2~8 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=b6d1a17f4729e4fda5740a855da91d202db2c118;p=platform%2Fkernel%2Flinux-starfive.git dmaengine: pxa: document pxad_param Add some documentation for the pxad_param structure, and describe the contract behind the minimal required priority of a DMA channel. Signed-off-by: Robert Jarzmik Acked-by: Vinod Koul --- diff --git a/include/linux/dma/pxa-dma.h b/include/linux/dma/pxa-dma.h index e56ec7a..9fc594f 100644 --- a/include/linux/dma/pxa-dma.h +++ b/include/linux/dma/pxa-dma.h @@ -9,6 +9,15 @@ enum pxad_chan_prio { PXAD_PRIO_LOWEST, }; +/** + * struct pxad_param - dma channel request parameters + * @drcmr: requestor line number + * @prio: minimal mandatory priority of the channel + * + * If a requested channel is granted, its priority will be at least @prio, + * ie. if PXAD_PRIO_LOW is required, the requested channel will be either + * PXAD_PRIO_LOW, PXAD_PRIO_NORMAL or PXAD_PRIO_HIGHEST. + */ struct pxad_param { unsigned int drcmr; enum pxad_chan_prio prio;