142 lines
3.9 KiB
C
142 lines
3.9 KiB
C
/* SPDX-License-Identifier: GPL-2.0-only */
|
|
/*
|
|
* Copyright (C) 2007-2013 ST-Ericsson
|
|
* DMA driver for COH 901 318
|
|
* Author: Per Friden <per.friden@stericsson.com>
|
|
*/
|
|
|
|
#ifndef COH901318_H
|
|
#define COH901318_H
|
|
|
|
#define MAX_DMA_PACKET_SIZE_SHIFT 11
|
|
#define MAX_DMA_PACKET_SIZE (1 << MAX_DMA_PACKET_SIZE_SHIFT)
|
|
|
|
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 coh901318_lli - linked list item for DMAC
|
|
* @control: control settings for DMAC
|
|
* @src_addr: transfer source address
|
|
* @dst_addr: transfer destination address
|
|
* @link_addr: physical address to next lli
|
|
* @virt_link_addr: virtual address of next lli (only used by pool_free)
|
|
* @phy_this: physical address of current lli (only used by pool_free)
|
|
*/
|
|
struct coh901318_lli {
|
|
u32 control;
|
|
dma_addr_t src_addr;
|
|
dma_addr_t dst_addr;
|
|
dma_addr_t link_addr;
|
|
|
|
void *virt_link_addr;
|
|
dma_addr_t phy_this;
|
|
};
|
|
|
|
/**
|
|
* 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: address 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_transfer_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_transfer_direction dir, u32 ctrl_irq_mask);
|
|
|
|
#endif /* COH901318_H */
|