lkml.org 
[lkml]   [2014]   [Jul]   [25]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
/
Date
From
SubjectRe: [PATCH v2 1/6] dmaengine: Update documentation for inline wrappers
On Fri, Jul 11, 2014 at 06:13:23PM +0200, Geert Uytterhoeven wrote:
> During the last few years, several inline wrappers for DMA operations have
> been introduced:
> - commit 16052827d98fbc13c31ebad560af4bd53e2b4dd5 ("dmaengine/dma_slave:
> introduce inline wrappers"),
> - commit a14acb4ac2a1486f6633c55eb7f7ded07f3ec9fc ("DMAEngine: add
> dmaengine_prep_interleaved_dma wrapper for interleaved api"),
> - commit 6e3ecaf0ad49de0bed829d409a164e7107c02993 ("dmaengine: add
> wrapper functions for device control functions").
>
> Update the documentation to use the wrappers.
>
> Signed-off-by: Geert Uytterhoeven <geert+renesas@glider.be>
> ---
> v2:
> - Added one more conversion in the textual explanation.

I have already applied v1, can you please send the update on added ones

Thanks
--
~Vinod

> ---
> Documentation/dmaengine.txt | 15 +++++++--------
> 1 file changed, 7 insertions(+), 8 deletions(-)
>
> diff --git a/Documentation/dmaengine.txt b/Documentation/dmaengine.txt
> index 87d3f192e160..11fb87ff6cd0 100644
> --- a/Documentation/dmaengine.txt
> +++ b/Documentation/dmaengine.txt
> @@ -84,21 +84,21 @@ The slave DMA usage consists of following steps:
> the given transaction.
>
> Interface:
> - struct dma_async_tx_descriptor *(*chan->device->device_prep_slave_sg)(
> + struct dma_async_tx_descriptor *dmaengine_prep_slave_sg(
> struct dma_chan *chan, struct scatterlist *sgl,
> unsigned int sg_len, enum dma_data_direction direction,
> unsigned long flags);
>
> - struct dma_async_tx_descriptor *(*chan->device->device_prep_dma_cyclic)(
> + struct dma_async_tx_descriptor *dmaengine_prep_dma_cyclic(
> struct dma_chan *chan, dma_addr_t buf_addr, size_t buf_len,
> size_t period_len, enum dma_data_direction direction);
>
> - struct dma_async_tx_descriptor *(*device_prep_interleaved_dma)(
> + struct dma_async_tx_descriptor *dmaengine_prep_interleaved_dma(
> struct dma_chan *chan, struct dma_interleaved_template *xt,
> unsigned long flags);
>
> The peripheral driver is expected to have mapped the scatterlist for
> - the DMA operation prior to calling device_prep_slave_sg, and must
> + the DMA operation prior to calling dmaengine_prep_slave_sg(), and must
> keep the scatterlist mapped until the DMA operation has completed.
> The scatterlist must be mapped using the DMA struct device.
> If a mapping needs to be synchronized later, dma_sync_*_for_*() must be
> @@ -109,8 +109,7 @@ The slave DMA usage consists of following steps:
> if (nr_sg == 0)
> /* error */
>
> - desc = chan->device->device_prep_slave_sg(chan, sgl, nr_sg,
> - direction, flags);
> + desc = dmaengine_prep_slave_sg(chan, sgl, nr_sg, direction, flags);
>
> Once a descriptor has been obtained, the callback information can be
> added and the descriptor must then be submitted. Some DMA engine
> @@ -190,11 +189,11 @@ Further APIs:
> description of this API.
>
> This can be used in conjunction with dma_async_is_complete() and
> - the cookie returned from 'descriptor->submit()' to check for
> + the cookie returned from dmaengine_submit() to check for
> completion of a specific DMA transaction.
>
> Note:
> Not all DMA engine drivers can return reliable information for
> a running DMA channel. It is recommended that DMA engine users
> - pause or stop (via dmaengine_terminate_all) the channel before
> + pause or stop (via dmaengine_terminate_all()) the channel before
> using this API.
> --
> 1.9.1
>

--


\
 
 \ /
  Last update: 2014-07-25 13:21    [W:0.086 / U:0.468 seconds]
©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site