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@xxxxxxxxx> > --- > 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 > -- -- To unsubscribe from this list: send the line "unsubscribe dmaengine" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html