drivers/dma/dmaengine.h

   1 /*
   2  * The contents of this file are private to DMA engine drivers, and is not
   3  * part of the API to be used by DMA engine users.
   4  */
   5 #ifndef DMAENGINE_H
   6 #define DMAENGINE_H
   7
   8 #include <linux/bug.h>
   9 #include <linux/dmaengine.h>
  10
  11 /**
  12  * dma_cookie_assign - assign a DMA engine cookie to the descriptor
  13  * @tx: descriptor needing cookie
  14  *
  15  * Assign a unique non-zero per-channel cookie to the descriptor.
  16  * Note: caller is expected to hold a lock to prevent concurrency.
  17  */
  18 static inline dma_cookie_t dma_cookie_assign(struct dma_async_tx_descriptor *tx)
  19 {
  20         struct dma_chan *chan = tx->chan;
  21         dma_cookie_t cookie;
  22
  23         cookie = chan->cookie + 1;
  24         if (cookie < DMA_MIN_COOKIE)
  25                 cookie = DMA_MIN_COOKIE;
  26         tx->cookie = chan->cookie = cookie;
  27
  28         return cookie;
  29 }
  30
  31 /**
  32  * dma_cookie_complete - complete a descriptor
  33  * @tx: descriptor to complete
  34  *
  35  * Mark this descriptor complete by updating the channels completed
  36  * cookie marker.  Zero the descriptors cookie to prevent accidental
  37  * repeated completions.
  38  *
  39  * Note: caller is expected to hold a lock to prevent concurrency.
  40  */
  41 static inline void dma_cookie_complete(struct dma_async_tx_descriptor *tx)
  42 {
  43         BUG_ON(tx->cookie < DMA_MIN_COOKIE);
  44         tx->chan->completed_cookie = tx->cookie;
  45         tx->cookie = 0;
  46 }
  47
  48 /**
  49  * dma_cookie_status - report cookie status
  50  * @chan: dma channel
  51  * @cookie: cookie we are interested in
  52  * @state: dma_tx_state structure to return last/used cookies
  53  *
  54  * Report the status of the cookie, filling in the state structure if
  55  * non-NULL.  No locking is required.
  56  */
  57 static inline enum dma_status dma_cookie_status(struct dma_chan *chan,
  58         dma_cookie_t cookie, struct dma_tx_state *state)
  59 {
  60         dma_cookie_t used, complete;
  61
  62         used = chan->cookie;
  63         complete = chan->completed_cookie;
  64         barrier();
  65         if (state) {
  66                 state->last = complete;
  67                 state->used = used;
  68                 state->residue = 0;
  69         }
  70         return dma_async_is_complete(cookie, complete, used);
  71 }
  72
  73 static inline void dma_set_residue(struct dma_tx_state *state, u32 residue)
  74 {
  75         if (state)
  76                 state->residue = residue;
  77 }
  78
  79 #endif