[deliverable/linux.git] / include / linux / dw_dmac.h

/*
 * Driver for the Synopsys DesignWare DMA Controller (aka DMACA on
 * AVR32 systems.)
 *
 * Copyright (C) 2007 Atmel Corporation
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License version 2 as
 * published by the Free Software Foundation.
 */
#ifndef DW_DMAC_H
#define DW_DMAC_H

#include <linux/dmaengine.h>

/**
 * struct dw_dma_platform_data - Controller configuration parameters
 * @nr_channels: Number of channels supported by hardware (max 8)
 */
struct dw_dma_platform_data {
	unsigned int	nr_channels;
};

/**
 * enum dw_dma_slave_width - DMA slave register access width.
 * @DMA_SLAVE_WIDTH_8BIT: Do 8-bit slave register accesses
 * @DMA_SLAVE_WIDTH_16BIT: Do 16-bit slave register accesses
 * @DMA_SLAVE_WIDTH_32BIT: Do 32-bit slave register accesses
 */
enum dw_dma_slave_width {
	DW_DMA_SLAVE_WIDTH_8BIT,
	DW_DMA_SLAVE_WIDTH_16BIT,
	DW_DMA_SLAVE_WIDTH_32BIT,
};

/**
 * struct dw_dma_slave - Controller-specific information about a slave
 *
 * @dma_dev: required DMA master device
 * @tx_reg: physical address of data register used for
 *	memory-to-peripheral transfers
 * @rx_reg: physical address of data register used for
 *	peripheral-to-memory transfers
 * @reg_width: peripheral register width
 * @cfg_hi: Platform-specific initializer for the CFG_HI register
 * @cfg_lo: Platform-specific initializer for the CFG_LO register
 */
struct dw_dma_slave {
	struct device		*dma_dev;
	dma_addr_t		tx_reg;
	dma_addr_t		rx_reg;
	enum dw_dma_slave_width	reg_width;
	u32			cfg_hi;
	u32			cfg_lo;
	int			src_master;
	int			dst_master;
};

/* Platform-configurable bits in CFG_HI */
#define DWC_CFGH_FCMODE		(1 << 0)
#define DWC_CFGH_FIFO_MODE	(1 << 1)
#define DWC_CFGH_PROTCTL(x)	((x) << 2)
#define DWC_CFGH_SRC_PER(x)	((x) << 7)
#define DWC_CFGH_DST_PER(x)	((x) << 11)

/* Platform-configurable bits in CFG_LO */
#define DWC_CFGL_PRIO(x)	((x) << 5)	/* priority */
#define DWC_CFGL_LOCK_CH_XFER	(0 << 12)	/* scope of LOCK_CH */
#define DWC_CFGL_LOCK_CH_BLOCK	(1 << 12)
#define DWC_CFGL_LOCK_CH_XACT	(2 << 12)
#define DWC_CFGL_LOCK_BUS_XFER	(0 << 14)	/* scope of LOCK_BUS */
#define DWC_CFGL_LOCK_BUS_BLOCK	(1 << 14)
#define DWC_CFGL_LOCK_BUS_XACT	(2 << 14)
#define DWC_CFGL_LOCK_CH	(1 << 15)	/* channel lockout */
#define DWC_CFGL_LOCK_BUS	(1 << 16)	/* busmaster lockout */
#define DWC_CFGL_HS_DST_POL	(1 << 18)	/* dst handshake active low */
#define DWC_CFGL_HS_SRC_POL	(1 << 19)	/* src handshake active low */

/* DMA API extensions */
struct dw_cyclic_desc {
	struct dw_desc	**desc;
	unsigned long	periods;
	void		(*period_callback)(void *param);
	void		*period_callback_param;
};

struct dw_cyclic_desc *dw_dma_cyclic_prep(struct dma_chan *chan,
		dma_addr_t buf_addr, size_t buf_len, size_t period_len,
		enum dma_data_direction direction);
void dw_dma_cyclic_free(struct dma_chan *chan);
int dw_dma_cyclic_start(struct dma_chan *chan);
void dw_dma_cyclic_stop(struct dma_chan *chan);

dma_addr_t dw_dma_get_src_addr(struct dma_chan *chan);

dma_addr_t dw_dma_get_dst_addr(struct dma_chan *chan);

#endif /* DW_DMAC_H */
Commit	Line	Data
3bfb1d20 HS	1	/*
	2	* Driver for the Synopsys DesignWare DMA Controller (aka DMACA on
	3	* AVR32 systems.)
	4	*
	5	* Copyright (C) 2007 Atmel Corporation
	6	*
	7	* This program is free software; you can redistribute it and/or modify
	8	* it under the terms of the GNU General Public License version 2 as
	9	* published by the Free Software Foundation.
	10	*/
	11	#ifndef DW_DMAC_H
	12	#define DW_DMAC_H
	13
	14	#include <linux/dmaengine.h>
	15
	16	/**
	17	* struct dw_dma_platform_data - Controller configuration parameters
	18	* @nr_channels: Number of channels supported by hardware (max 8)
	19	*/
	20	struct dw_dma_platform_data {
	21	unsigned int nr_channels;
	22	};
	23
74465b4f DW	24	/**
	25	* enum dw_dma_slave_width - DMA slave register access width.
	26	* @DMA_SLAVE_WIDTH_8BIT: Do 8-bit slave register accesses
	27	* @DMA_SLAVE_WIDTH_16BIT: Do 16-bit slave register accesses
	28	* @DMA_SLAVE_WIDTH_32BIT: Do 32-bit slave register accesses
	29	*/
	30	enum dw_dma_slave_width {
	31	DW_DMA_SLAVE_WIDTH_8BIT,
	32	DW_DMA_SLAVE_WIDTH_16BIT,
	33	DW_DMA_SLAVE_WIDTH_32BIT,
	34	};
	35
3bfb1d20 HS	36	/**
3bfb1d20 HS	37	* struct dw_dma_slave - Controller-specific information about a slave
74465b4f DW	38	*
	39	* @dma_dev: required DMA master device
	40	* @tx_reg: physical address of data register used for
	41	* memory-to-peripheral transfers
	42	* @rx_reg: physical address of data register used for
	43	* peripheral-to-memory transfers
	44	* @reg_width: peripheral register width
3bfb1d20 HS	45	* @cfg_hi: Platform-specific initializer for the CFG_HI register
	46	* @cfg_lo: Platform-specific initializer for the CFG_LO register
	47	*/
	48	struct dw_dma_slave {
74465b4f DW	49	struct device *dma_dev;
	50	dma_addr_t tx_reg;
	51	dma_addr_t rx_reg;
	52	enum dw_dma_slave_width reg_width;
3bfb1d20 HS	53	u32 cfg_hi;
3bfb1d20 HS	54	u32 cfg_lo;
f301c062 JI	55	int src_master;
f301c062 JI	56	int dst_master;
3bfb1d20 HS	57	};
	58
	59	/* Platform-configurable bits in CFG_HI */
	60	#define DWC_CFGH_FCMODE (1 << 0)
	61	#define DWC_CFGH_FIFO_MODE (1 << 1)
	62	#define DWC_CFGH_PROTCTL(x) ((x) << 2)
	63	#define DWC_CFGH_SRC_PER(x) ((x) << 7)
	64	#define DWC_CFGH_DST_PER(x) ((x) << 11)
	65
	66	/* Platform-configurable bits in CFG_LO */
	67	#define DWC_CFGL_PRIO(x) ((x) << 5) /* priority */
	68	#define DWC_CFGL_LOCK_CH_XFER (0 << 12) /* scope of LOCK_CH */
	69	#define DWC_CFGL_LOCK_CH_BLOCK (1 << 12)
	70	#define DWC_CFGL_LOCK_CH_XACT (2 << 12)
	71	#define DWC_CFGL_LOCK_BUS_XFER (0 << 14) /* scope of LOCK_BUS */
	72	#define DWC_CFGL_LOCK_BUS_BLOCK (1 << 14)
	73	#define DWC_CFGL_LOCK_BUS_XACT (2 << 14)
	74	#define DWC_CFGL_LOCK_CH (1 << 15) /* channel lockout */
	75	#define DWC_CFGL_LOCK_BUS (1 << 16) /* busmaster lockout */
	76	#define DWC_CFGL_HS_DST_POL (1 << 18) /* dst handshake active low */
	77	#define DWC_CFGL_HS_SRC_POL (1 << 19) /* src handshake active low */
	78
d9de4519 HCE	79	/* DMA API extensions */
	80	struct dw_cyclic_desc {
	81	struct dw_desc **desc;
	82	unsigned long periods;
	83	void (period_callback)(void param);
	84	void *period_callback_param;
	85	};
	86
	87	struct dw_cyclic_desc dw_dma_cyclic_prep(struct dma_chan chan,
	88	dma_addr_t buf_addr, size_t buf_len, size_t period_len,
	89	enum dma_data_direction direction);
	90	void dw_dma_cyclic_free(struct dma_chan *chan);
	91	int dw_dma_cyclic_start(struct dma_chan *chan);
	92	void dw_dma_cyclic_stop(struct dma_chan *chan);
	93
	94	dma_addr_t dw_dma_get_src_addr(struct dma_chan *chan);
	95
	96	dma_addr_t dw_dma_get_dst_addr(struct dma_chan *chan);
	97
3bfb1d20	98	#endif /* DW_DMAC_H */