/* * driver/dma/coh901318_lli.h * * Copyright (C) 2007-2009 ST-Ericsson * License terms: GNU General Public License (GPL) version 2 * Support functions for handling lli for coh901318 * Author: Per Friden <per.friden@stericsson.com> */ #ifndef COH901318_LLI_H #define COH901318_LLI_H #include <mach/coh901318.h> struct device; struct coh901318_pool { spinlock_t lock; struct dma_pool *dmapool; struct device *dev; #ifdef CONFIG_DEBUG_FS int debugfs_pool_counter; #endif }; struct device; /** * coh901318_pool_create() - Creates an dma pool for lli:s * @pool: pool handle * @dev: dma device * @lli_nbr: number of lli:s in the pool * @algin: adress alignemtn of lli:s * returns 0 on success otherwise none zero */ int coh901318_pool_create(struct coh901318_pool *pool, struct device *dev, size_t lli_nbr, size_t align); /** * coh901318_pool_destroy() - Destroys the dma pool * @pool: pool handle * returns 0 on success otherwise none zero */ int coh901318_pool_destroy(struct coh901318_pool *pool); /** * coh901318_lli_alloc() - Allocates a linked list * * @pool: pool handle * @len: length to list * return: none NULL if success otherwise NULL */ struct coh901318_lli * coh901318_lli_alloc(struct coh901318_pool *pool, unsigned int len); /** * coh901318_lli_free() - Returns the linked list items to the pool * @pool: pool handle * @lli: reference to lli pointer to be freed */ void coh901318_lli_free(struct coh901318_pool *pool, struct coh901318_lli **lli); /** * coh901318_lli_fill_memcpy() - Prepares the lli:s for dma memcpy * @pool: pool handle * @lli: allocated lli * @src: src address * @size: transfer size * @dst: destination address * @ctrl_chained: ctrl for chained lli * @ctrl_last: ctrl for the last lli * returns number of CPU interrupts for the lli, negative on error. */ int coh901318_lli_fill_memcpy(struct coh901318_pool *pool, struct coh901318_lli *lli, dma_addr_t src, unsigned int size, dma_addr_t dst, u32 ctrl_chained, u32 ctrl_last); /** * coh901318_lli_fill_single() - Prepares the lli:s for dma single transfer * @pool: pool handle * @lli: allocated lli * @buf: transfer buffer * @size: transfer size * @dev_addr: address of periphal * @ctrl_chained: ctrl for chained lli * @ctrl_last: ctrl for the last lli * @dir: direction of transfer (to or from device) * returns number of CPU interrupts for the lli, negative on error. */ int coh901318_lli_fill_single(struct coh901318_pool *pool, struct coh901318_lli *lli, dma_addr_t buf, unsigned int size, dma_addr_t dev_addr, u32 ctrl_chained, u32 ctrl_last, enum dma_data_direction dir); /** * coh901318_lli_fill_single() - Prepares the lli:s for dma scatter list transfer * @pool: pool handle * @lli: allocated lli * @sg: scatter gather list * @nents: number of entries in sg * @dev_addr: address of periphal * @ctrl_chained: ctrl for chained lli * @ctrl: ctrl of middle lli * @ctrl_last: ctrl for the last lli * @dir: direction of transfer (to or from device) * @ctrl_irq_mask: ctrl mask for CPU interrupt * returns number of CPU interrupts for the lli, negative on error. */ int coh901318_lli_fill_sg(struct coh901318_pool *pool, struct coh901318_lli *lli, struct scatterlist *sg, unsigned int nents, dma_addr_t dev_addr, u32 ctrl_chained, u32 ctrl, u32 ctrl_last, enum dma_data_direction dir, u32 ctrl_irq_mask); #endif /* COH901318_LLI_H */