[linux-2.6-block.git] / drivers / dma / qcom / hidma.h

/*
 * Qualcomm Technologies HIDMA data structures
 *
 * Copyright (c) 2014-2016, The Linux Foundation. All rights reserved.
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License version 2 and
 * only version 2 as published by the Free Software Foundation.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 */

#ifndef QCOM_HIDMA_H
#define QCOM_HIDMA_H

#include <linux/kfifo.h>
#include <linux/interrupt.h>
#include <linux/dmaengine.h>

#define HIDMA_TRE_SIZE			32 /* each TRE is 32 bytes  */
#define HIDMA_TRE_CFG_IDX		0
#define HIDMA_TRE_LEN_IDX		1
#define HIDMA_TRE_SRC_LOW_IDX		2
#define HIDMA_TRE_SRC_HI_IDX		3
#define HIDMA_TRE_DEST_LOW_IDX		4
#define HIDMA_TRE_DEST_HI_IDX		5

struct hidma_tre {
	atomic_t allocated;		/* if this channel is allocated	    */
	bool queued;			/* flag whether this is pending     */
	u16 status;			/* status			    */
	u32 idx;			/* index of the tre		    */
	u32 dma_sig;			/* signature of the tre		    */
	const char *dev_name;		/* name of the device		    */
	void (*callback)(void *data);	/* requester callback		    */
	void *data;			/* Data associated with this channel*/
	struct hidma_lldev *lldev;	/* lldma device pointer		    */
	u32 tre_local[HIDMA_TRE_SIZE / sizeof(u32) + 1]; /* TRE local copy  */
	u32 tre_index;			/* the offset where this was written*/
	u32 int_flags;			/* interrupt flags		    */
	u8 err_info;			/* error record in this transfer    */
	u8 err_code;			/* completion code		    */
};

struct hidma_lldev {
	bool msi_support;		/* flag indicating MSI support    */
	bool initialized;		/* initialized flag               */
	u8 trch_state;			/* trch_state of the device	  */
	u8 evch_state;			/* evch_state of the device	  */
	u8 chidx;			/* channel index in the core	  */
	u32 nr_tres;			/* max number of configs          */
	spinlock_t lock;		/* reentrancy                     */
	struct hidma_tre *trepool;	/* trepool of user configs */
	struct device *dev;		/* device			  */
	void __iomem *trca;		/* Transfer Channel address       */
	void __iomem *evca;		/* Event Channel address          */
	struct hidma_tre
		**pending_tre_list;	/* Pointers to pending TREs	  */
	atomic_t pending_tre_count;	/* Number of TREs pending	  */

	void *tre_ring;			/* TRE ring			  */
	dma_addr_t tre_dma;		/* TRE ring to be shared with HW  */
	u32 tre_ring_size;		/* Byte size of the ring	  */
	u32 tre_processed_off;		/* last processed TRE		  */

	void *evre_ring;		/* EVRE ring			   */
	dma_addr_t evre_dma;		/* EVRE ring to be shared with HW  */
	u32 evre_ring_size;		/* Byte size of the ring	   */
	u32 evre_processed_off;		/* last processed EVRE		   */

	u32 tre_write_offset;           /* TRE write location              */
	struct tasklet_struct task;	/* task delivering notifications   */
	DECLARE_KFIFO_PTR(handoff_fifo,
		struct hidma_tre *);    /* pending TREs FIFO               */
};

struct hidma_desc {
	struct dma_async_tx_descriptor	desc;
	/* link list node for this channel*/
	struct list_head		node;
	u32				tre_ch;
};

struct hidma_chan {
	bool				paused;
	bool				allocated;
	char				dbg_name[16];
	u32				dma_sig;
	dma_cookie_t			last_success;

	/*
	 * active descriptor on this channel
	 * It is used by the DMA complete notification to
	 * locate the descriptor that initiated the transfer.
	 */
	struct dentry			*debugfs;
	struct dentry			*stats;
	struct hidma_dev		*dmadev;
	struct hidma_desc		*running;

	struct dma_chan			chan;
	struct list_head		free;
	struct list_head		prepared;
	struct list_head		active;
	struct list_head		completed;

	/* Lock for this structure */
	spinlock_t			lock;
};

struct hidma_dev {
	int				irq;
	int				chidx;
	u32				nr_descriptors;

	struct hidma_lldev		*lldev;
	void				__iomem *dev_trca;
	struct resource			*trca_resource;
	void				__iomem *dev_evca;
	struct resource			*evca_resource;

	/* used to protect the pending channel list*/
	spinlock_t			lock;
	struct dma_device		ddev;

	struct dentry			*debugfs;
	struct dentry			*stats;

	/* Task delivering issue_pending */
	struct tasklet_struct		task;
};

int hidma_ll_request(struct hidma_lldev *llhndl, u32 dev_id,
			const char *dev_name,
			void (*callback)(void *data), void *data, u32 *tre_ch);

void hidma_ll_free(struct hidma_lldev *llhndl, u32 tre_ch);
enum dma_status hidma_ll_status(struct hidma_lldev *llhndl, u32 tre_ch);
bool hidma_ll_isenabled(struct hidma_lldev *llhndl);
void hidma_ll_queue_request(struct hidma_lldev *llhndl, u32 tre_ch);
void hidma_ll_start(struct hidma_lldev *llhndl);
int hidma_ll_disable(struct hidma_lldev *lldev);
int hidma_ll_enable(struct hidma_lldev *llhndl);
void hidma_ll_set_transfer_params(struct hidma_lldev *llhndl, u32 tre_ch,
	dma_addr_t src, dma_addr_t dest, u32 len, u32 flags);
void hidma_ll_setup_irq(struct hidma_lldev *lldev, bool msi);
int hidma_ll_setup(struct hidma_lldev *lldev);
struct hidma_lldev *hidma_ll_init(struct device *dev, u32 max_channels,
			void __iomem *trca, void __iomem *evca,
			u8 chidx);
int hidma_ll_uninit(struct hidma_lldev *llhndl);
irqreturn_t hidma_ll_inthandler(int irq, void *arg);
void hidma_cleanup_pending_tre(struct hidma_lldev *llhndl, u8 err_info,
				u8 err_code);
int hidma_debug_init(struct hidma_dev *dmadev);
void hidma_debug_uninit(struct hidma_dev *dmadev);
#endif
Commit	Line	Data
67a2003e SK	1	/*
	2	* Qualcomm Technologies HIDMA data structures
	3	*
d1615ca2	4	* Copyright (c) 2014-2016, The Linux Foundation. All rights reserved.
67a2003e SK	5	*
	6	* This program is free software; you can redistribute it and/or modify
	7	* it under the terms of the GNU General Public License version 2 and
	8	* only version 2 as published by the Free Software Foundation.
	9	*
	10	* This program is distributed in the hope that it will be useful,
	11	* but WITHOUT ANY WARRANTY; without even the implied warranty of
	12	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	13	* GNU General Public License for more details.
	14	*/
	15
	16	#ifndef QCOM_HIDMA_H
	17	#define QCOM_HIDMA_H
	18
	19	#include <linux/kfifo.h>
	20	#include <linux/interrupt.h>
	21	#include <linux/dmaengine.h>
	22
d1615ca2 SK	23	#define HIDMA_TRE_SIZE 32 /* each TRE is 32 bytes */
	24	#define HIDMA_TRE_CFG_IDX 0
	25	#define HIDMA_TRE_LEN_IDX 1
	26	#define HIDMA_TRE_SRC_LOW_IDX 2
	27	#define HIDMA_TRE_SRC_HI_IDX 3
	28	#define HIDMA_TRE_DEST_LOW_IDX 4
	29	#define HIDMA_TRE_DEST_HI_IDX 5
67a2003e SK	30
	31	struct hidma_tre {
	32	atomic_t allocated; /* if this channel is allocated */
	33	bool queued; /* flag whether this is pending */
	34	u16 status; /* status */
d1615ca2	35	u32 idx; /* index of the tre */
67a2003e SK	36	u32 dma_sig; /* signature of the tre */
	37	const char dev_name; / name of the device */
	38	void (callback)(void data); /* requester callback */
	39	void data; / Data associated with this channel*/
	40	struct hidma_lldev lldev; / lldma device pointer */
d1615ca2	41	u32 tre_local[HIDMA_TRE_SIZE / sizeof(u32) + 1]; /* TRE local copy */
67a2003e SK	42	u32 tre_index; /* the offset where this was written*/
67a2003e SK	43	u32 int_flags; /* interrupt flags */
d1615ca2 SK	44	u8 err_info; /* error record in this transfer */
d1615ca2 SK	45	u8 err_code; /* completion code */
67a2003e SK	46	};
	47
	48	struct hidma_lldev {
d3eab504	49	bool msi_support; /* flag indicating MSI support */
67a2003e SK	50	bool initialized; /* initialized flag */
	51	u8 trch_state; /* trch_state of the device */
	52	u8 evch_state; /* evch_state of the device */
	53	u8 chidx; /* channel index in the core */
	54	u32 nr_tres; /* max number of configs */
	55	spinlock_t lock; /* reentrancy */
	56	struct hidma_tre trepool; / trepool of user configs */
	57	struct device dev; / device */
	58	void __iomem trca; / Transfer Channel address */
	59	void __iomem evca; / Event Channel address */
	60	struct hidma_tre
	61	*pending_tre_list; / Pointers to pending TREs */
bdcfddfd	62	atomic_t pending_tre_count; /* Number of TREs pending */
67a2003e SK	63
67a2003e SK	64	void tre_ring; / TRE ring */
d1615ca2	65	dma_addr_t tre_dma; /* TRE ring to be shared with HW */
67a2003e SK	66	u32 tre_ring_size; /* Byte size of the ring */
	67	u32 tre_processed_off; /* last processed TRE */
	68
	69	void evre_ring; / EVRE ring */
d1615ca2	70	dma_addr_t evre_dma; /* EVRE ring to be shared with HW */
67a2003e SK	71	u32 evre_ring_size; /* Byte size of the ring */
	72	u32 evre_processed_off; /* last processed EVRE */
	73
	74	u32 tre_write_offset; /* TRE write location */
	75	struct tasklet_struct task; /* task delivering notifications */
	76	DECLARE_KFIFO_PTR(handoff_fifo,
	77	struct hidma_tre ); / pending TREs FIFO */
	78	};
	79
	80	struct hidma_desc {
	81	struct dma_async_tx_descriptor desc;
	82	/* link list node for this channel*/
	83	struct list_head node;
	84	u32 tre_ch;
	85	};
	86
	87	struct hidma_chan {
	88	bool paused;
	89	bool allocated;
	90	char dbg_name[16];
	91	u32 dma_sig;
793ae66c	92	dma_cookie_t last_success;
67a2003e SK	93
	94	/*
	95	* active descriptor on this channel
	96	* It is used by the DMA complete notification to
	97	* locate the descriptor that initiated the transfer.
	98	*/
	99	struct dentry *debugfs;
	100	struct dentry *stats;
	101	struct hidma_dev *dmadev;
	102	struct hidma_desc *running;
	103
	104	struct dma_chan chan;
	105	struct list_head free;
	106	struct list_head prepared;
	107	struct list_head active;
	108	struct list_head completed;
	109
	110	/* Lock for this structure */
	111	spinlock_t lock;
	112	};
	113
	114	struct hidma_dev {
	115	int irq;
	116	int chidx;
	117	u32 nr_descriptors;
	118
	119	struct hidma_lldev *lldev;
	120	void __iomem *dev_trca;
	121	struct resource *trca_resource;
	122	void __iomem *dev_evca;
	123	struct resource *evca_resource;
	124
	125	/* used to protect the pending channel list*/
	126	spinlock_t lock;
	127	struct dma_device ddev;
	128
	129	struct dentry *debugfs;
	130	struct dentry *stats;
	131
	132	/* Task delivering issue_pending */
	133	struct tasklet_struct task;
	134	};
	135
	136	int hidma_ll_request(struct hidma_lldev *llhndl, u32 dev_id,
	137	const char *dev_name,
	138	void (callback)(void data), void data, u32 tre_ch);
	139
	140	void hidma_ll_free(struct hidma_lldev *llhndl, u32 tre_ch);
	141	enum dma_status hidma_ll_status(struct hidma_lldev *llhndl, u32 tre_ch);
	142	bool hidma_ll_isenabled(struct hidma_lldev *llhndl);
	143	void hidma_ll_queue_request(struct hidma_lldev *llhndl, u32 tre_ch);
	144	void hidma_ll_start(struct hidma_lldev *llhndl);
d1615ca2 SK	145	int hidma_ll_disable(struct hidma_lldev *lldev);
d1615ca2 SK	146	int hidma_ll_enable(struct hidma_lldev *llhndl);
67a2003e SK	147	void hidma_ll_set_transfer_params(struct hidma_lldev *llhndl, u32 tre_ch,
67a2003e SK	148	dma_addr_t src, dma_addr_t dest, u32 len, u32 flags);
d3eab504	149	void hidma_ll_setup_irq(struct hidma_lldev *lldev, bool msi);
67a2003e SK	150	int hidma_ll_setup(struct hidma_lldev *lldev);
	151	struct hidma_lldev hidma_ll_init(struct device dev, u32 max_channels,
	152	void __iomem trca, void __iomem evca,
	153	u8 chidx);
	154	int hidma_ll_uninit(struct hidma_lldev *llhndl);
	155	irqreturn_t hidma_ll_inthandler(int irq, void *arg);
	156	void hidma_cleanup_pending_tre(struct hidma_lldev *llhndl, u8 err_info,
	157	u8 err_code);
570d0176 SK	158	int hidma_debug_init(struct hidma_dev *dmadev);
570d0176 SK	159	void hidma_debug_uninit(struct hidma_dev *dmadev);
67a2003e	160	#endif