xref: /OK3568_Linux_fs/kernel/drivers/dma/fsl-edma-common.h (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun /* SPDX-License-Identifier: GPL-2.0+ */
2*4882a593Smuzhiyun /*
3*4882a593Smuzhiyun  * Copyright 2013-2014 Freescale Semiconductor, Inc.
4*4882a593Smuzhiyun  * Copyright 2018 Angelo Dureghello <angelo@sysam.it>
5*4882a593Smuzhiyun  */
6*4882a593Smuzhiyun #ifndef _FSL_EDMA_COMMON_H_
7*4882a593Smuzhiyun #define _FSL_EDMA_COMMON_H_
8*4882a593Smuzhiyun 
9*4882a593Smuzhiyun #include <linux/dma-direction.h>
10*4882a593Smuzhiyun #include <linux/platform_device.h>
11*4882a593Smuzhiyun #include "virt-dma.h"
12*4882a593Smuzhiyun 
13*4882a593Smuzhiyun #define EDMA_CR_EDBG		BIT(1)
14*4882a593Smuzhiyun #define EDMA_CR_ERCA		BIT(2)
15*4882a593Smuzhiyun #define EDMA_CR_ERGA		BIT(3)
16*4882a593Smuzhiyun #define EDMA_CR_HOE		BIT(4)
17*4882a593Smuzhiyun #define EDMA_CR_HALT		BIT(5)
18*4882a593Smuzhiyun #define EDMA_CR_CLM		BIT(6)
19*4882a593Smuzhiyun #define EDMA_CR_EMLM		BIT(7)
20*4882a593Smuzhiyun #define EDMA_CR_ECX		BIT(16)
21*4882a593Smuzhiyun #define EDMA_CR_CX		BIT(17)
22*4882a593Smuzhiyun 
23*4882a593Smuzhiyun #define EDMA_SEEI_SEEI(x)	((x) & GENMASK(4, 0))
24*4882a593Smuzhiyun #define EDMA_CEEI_CEEI(x)	((x) & GENMASK(4, 0))
25*4882a593Smuzhiyun #define EDMA_CINT_CINT(x)	((x) & GENMASK(4, 0))
26*4882a593Smuzhiyun #define EDMA_CERR_CERR(x)	((x) & GENMASK(4, 0))
27*4882a593Smuzhiyun 
28*4882a593Smuzhiyun #define EDMA_TCD_ATTR_DSIZE(x)		(((x) & GENMASK(2, 0)))
29*4882a593Smuzhiyun #define EDMA_TCD_ATTR_DMOD(x)		(((x) & GENMASK(4, 0)) << 3)
30*4882a593Smuzhiyun #define EDMA_TCD_ATTR_SSIZE(x)		(((x) & GENMASK(2, 0)) << 8)
31*4882a593Smuzhiyun #define EDMA_TCD_ATTR_SMOD(x)		(((x) & GENMASK(4, 0)) << 11)
32*4882a593Smuzhiyun #define EDMA_TCD_ATTR_DSIZE_8BIT	0
33*4882a593Smuzhiyun #define EDMA_TCD_ATTR_DSIZE_16BIT	BIT(0)
34*4882a593Smuzhiyun #define EDMA_TCD_ATTR_DSIZE_32BIT	BIT(1)
35*4882a593Smuzhiyun #define EDMA_TCD_ATTR_DSIZE_64BIT	(BIT(0) | BIT(1))
36*4882a593Smuzhiyun #define EDMA_TCD_ATTR_DSIZE_32BYTE	(BIT(2) | BIT(0))
37*4882a593Smuzhiyun #define EDMA_TCD_ATTR_SSIZE_8BIT	0
38*4882a593Smuzhiyun #define EDMA_TCD_ATTR_SSIZE_16BIT	(EDMA_TCD_ATTR_DSIZE_16BIT << 8)
39*4882a593Smuzhiyun #define EDMA_TCD_ATTR_SSIZE_32BIT	(EDMA_TCD_ATTR_DSIZE_32BIT << 8)
40*4882a593Smuzhiyun #define EDMA_TCD_ATTR_SSIZE_64BIT	(EDMA_TCD_ATTR_DSIZE_64BIT << 8)
41*4882a593Smuzhiyun #define EDMA_TCD_ATTR_SSIZE_32BYTE	(EDMA_TCD_ATTR_DSIZE_32BYTE << 8)
42*4882a593Smuzhiyun 
43*4882a593Smuzhiyun #define EDMA_TCD_CITER_CITER(x)		((x) & GENMASK(14, 0))
44*4882a593Smuzhiyun #define EDMA_TCD_BITER_BITER(x)		((x) & GENMASK(14, 0))
45*4882a593Smuzhiyun 
46*4882a593Smuzhiyun #define EDMA_TCD_CSR_START		BIT(0)
47*4882a593Smuzhiyun #define EDMA_TCD_CSR_INT_MAJOR		BIT(1)
48*4882a593Smuzhiyun #define EDMA_TCD_CSR_INT_HALF		BIT(2)
49*4882a593Smuzhiyun #define EDMA_TCD_CSR_D_REQ		BIT(3)
50*4882a593Smuzhiyun #define EDMA_TCD_CSR_E_SG		BIT(4)
51*4882a593Smuzhiyun #define EDMA_TCD_CSR_E_LINK		BIT(5)
52*4882a593Smuzhiyun #define EDMA_TCD_CSR_ACTIVE		BIT(6)
53*4882a593Smuzhiyun #define EDMA_TCD_CSR_DONE		BIT(7)
54*4882a593Smuzhiyun 
55*4882a593Smuzhiyun #define EDMAMUX_CHCFG_DIS		0x0
56*4882a593Smuzhiyun #define EDMAMUX_CHCFG_ENBL		0x80
57*4882a593Smuzhiyun #define EDMAMUX_CHCFG_SOURCE(n)		((n) & 0x3F)
58*4882a593Smuzhiyun 
59*4882a593Smuzhiyun #define DMAMUX_NR	2
60*4882a593Smuzhiyun 
61*4882a593Smuzhiyun #define FSL_EDMA_BUSWIDTHS	(BIT(DMA_SLAVE_BUSWIDTH_1_BYTE) | \
62*4882a593Smuzhiyun 				 BIT(DMA_SLAVE_BUSWIDTH_2_BYTES) | \
63*4882a593Smuzhiyun 				 BIT(DMA_SLAVE_BUSWIDTH_4_BYTES) | \
64*4882a593Smuzhiyun 				 BIT(DMA_SLAVE_BUSWIDTH_8_BYTES))
65*4882a593Smuzhiyun enum fsl_edma_pm_state {
66*4882a593Smuzhiyun 	RUNNING = 0,
67*4882a593Smuzhiyun 	SUSPENDED,
68*4882a593Smuzhiyun };
69*4882a593Smuzhiyun 
70*4882a593Smuzhiyun struct fsl_edma_hw_tcd {
71*4882a593Smuzhiyun 	__le32	saddr;
72*4882a593Smuzhiyun 	__le16	soff;
73*4882a593Smuzhiyun 	__le16	attr;
74*4882a593Smuzhiyun 	__le32	nbytes;
75*4882a593Smuzhiyun 	__le32	slast;
76*4882a593Smuzhiyun 	__le32	daddr;
77*4882a593Smuzhiyun 	__le16	doff;
78*4882a593Smuzhiyun 	__le16	citer;
79*4882a593Smuzhiyun 	__le32	dlast_sga;
80*4882a593Smuzhiyun 	__le16	csr;
81*4882a593Smuzhiyun 	__le16	biter;
82*4882a593Smuzhiyun };
83*4882a593Smuzhiyun 
84*4882a593Smuzhiyun /*
85*4882a593Smuzhiyun  * These are iomem pointers, for both v32 and v64.
86*4882a593Smuzhiyun  */
87*4882a593Smuzhiyun struct edma_regs {
88*4882a593Smuzhiyun 	void __iomem *cr;
89*4882a593Smuzhiyun 	void __iomem *es;
90*4882a593Smuzhiyun 	void __iomem *erqh;
91*4882a593Smuzhiyun 	void __iomem *erql;	/* aka erq on v32 */
92*4882a593Smuzhiyun 	void __iomem *eeih;
93*4882a593Smuzhiyun 	void __iomem *eeil;	/* aka eei on v32 */
94*4882a593Smuzhiyun 	void __iomem *seei;
95*4882a593Smuzhiyun 	void __iomem *ceei;
96*4882a593Smuzhiyun 	void __iomem *serq;
97*4882a593Smuzhiyun 	void __iomem *cerq;
98*4882a593Smuzhiyun 	void __iomem *cint;
99*4882a593Smuzhiyun 	void __iomem *cerr;
100*4882a593Smuzhiyun 	void __iomem *ssrt;
101*4882a593Smuzhiyun 	void __iomem *cdne;
102*4882a593Smuzhiyun 	void __iomem *inth;
103*4882a593Smuzhiyun 	void __iomem *intl;
104*4882a593Smuzhiyun 	void __iomem *errh;
105*4882a593Smuzhiyun 	void __iomem *errl;
106*4882a593Smuzhiyun 	struct fsl_edma_hw_tcd __iomem *tcd;
107*4882a593Smuzhiyun };
108*4882a593Smuzhiyun 
109*4882a593Smuzhiyun struct fsl_edma_sw_tcd {
110*4882a593Smuzhiyun 	dma_addr_t			ptcd;
111*4882a593Smuzhiyun 	struct fsl_edma_hw_tcd		*vtcd;
112*4882a593Smuzhiyun };
113*4882a593Smuzhiyun 
114*4882a593Smuzhiyun struct fsl_edma_chan {
115*4882a593Smuzhiyun 	struct virt_dma_chan		vchan;
116*4882a593Smuzhiyun 	enum dma_status			status;
117*4882a593Smuzhiyun 	enum fsl_edma_pm_state		pm_state;
118*4882a593Smuzhiyun 	bool				idle;
119*4882a593Smuzhiyun 	u32				slave_id;
120*4882a593Smuzhiyun 	struct fsl_edma_engine		*edma;
121*4882a593Smuzhiyun 	struct fsl_edma_desc		*edesc;
122*4882a593Smuzhiyun 	struct dma_slave_config		cfg;
123*4882a593Smuzhiyun 	u32				attr;
124*4882a593Smuzhiyun 	struct dma_pool			*tcd_pool;
125*4882a593Smuzhiyun 	dma_addr_t			dma_dev_addr;
126*4882a593Smuzhiyun 	u32				dma_dev_size;
127*4882a593Smuzhiyun 	enum dma_data_direction		dma_dir;
128*4882a593Smuzhiyun 	char				chan_name[16];
129*4882a593Smuzhiyun };
130*4882a593Smuzhiyun 
131*4882a593Smuzhiyun struct fsl_edma_desc {
132*4882a593Smuzhiyun 	struct virt_dma_desc		vdesc;
133*4882a593Smuzhiyun 	struct fsl_edma_chan		*echan;
134*4882a593Smuzhiyun 	bool				iscyclic;
135*4882a593Smuzhiyun 	enum dma_transfer_direction	dirn;
136*4882a593Smuzhiyun 	unsigned int			n_tcds;
137*4882a593Smuzhiyun 	struct fsl_edma_sw_tcd		tcd[];
138*4882a593Smuzhiyun };
139*4882a593Smuzhiyun 
140*4882a593Smuzhiyun enum edma_version {
141*4882a593Smuzhiyun 	v1, /* 32ch, Vybrid, mpc57x, etc */
142*4882a593Smuzhiyun 	v2, /* 64ch Coldfire */
143*4882a593Smuzhiyun 	v3, /* 32ch, i.mx7ulp */
144*4882a593Smuzhiyun };
145*4882a593Smuzhiyun 
146*4882a593Smuzhiyun struct fsl_edma_drvdata {
147*4882a593Smuzhiyun 	enum edma_version	version;
148*4882a593Smuzhiyun 	u32			dmamuxs;
149*4882a593Smuzhiyun 	bool			has_dmaclk;
150*4882a593Smuzhiyun 	bool			mux_swap;
151*4882a593Smuzhiyun 	int			(*setup_irq)(struct platform_device *pdev,
152*4882a593Smuzhiyun 					     struct fsl_edma_engine *fsl_edma);
153*4882a593Smuzhiyun };
154*4882a593Smuzhiyun 
155*4882a593Smuzhiyun struct fsl_edma_engine {
156*4882a593Smuzhiyun 	struct dma_device	dma_dev;
157*4882a593Smuzhiyun 	void __iomem		*membase;
158*4882a593Smuzhiyun 	void __iomem		*muxbase[DMAMUX_NR];
159*4882a593Smuzhiyun 	struct clk		*muxclk[DMAMUX_NR];
160*4882a593Smuzhiyun 	struct clk		*dmaclk;
161*4882a593Smuzhiyun 	struct mutex		fsl_edma_mutex;
162*4882a593Smuzhiyun 	const struct fsl_edma_drvdata *drvdata;
163*4882a593Smuzhiyun 	u32			n_chans;
164*4882a593Smuzhiyun 	int			txirq;
165*4882a593Smuzhiyun 	int			errirq;
166*4882a593Smuzhiyun 	bool			big_endian;
167*4882a593Smuzhiyun 	struct edma_regs	regs;
168*4882a593Smuzhiyun 	struct fsl_edma_chan	chans[];
169*4882a593Smuzhiyun };
170*4882a593Smuzhiyun 
171*4882a593Smuzhiyun /*
172*4882a593Smuzhiyun  * R/W functions for big- or little-endian registers:
173*4882a593Smuzhiyun  * The eDMA controller's endian is independent of the CPU core's endian.
174*4882a593Smuzhiyun  * For the big-endian IP module, the offset for 8-bit or 16-bit registers
175*4882a593Smuzhiyun  * should also be swapped opposite to that in little-endian IP.
176*4882a593Smuzhiyun  */
edma_readl(struct fsl_edma_engine * edma,void __iomem * addr)177*4882a593Smuzhiyun static inline u32 edma_readl(struct fsl_edma_engine *edma, void __iomem *addr)
178*4882a593Smuzhiyun {
179*4882a593Smuzhiyun 	if (edma->big_endian)
180*4882a593Smuzhiyun 		return ioread32be(addr);
181*4882a593Smuzhiyun 	else
182*4882a593Smuzhiyun 		return ioread32(addr);
183*4882a593Smuzhiyun }
184*4882a593Smuzhiyun 
edma_writeb(struct fsl_edma_engine * edma,u8 val,void __iomem * addr)185*4882a593Smuzhiyun static inline void edma_writeb(struct fsl_edma_engine *edma,
186*4882a593Smuzhiyun 			       u8 val, void __iomem *addr)
187*4882a593Smuzhiyun {
188*4882a593Smuzhiyun 	/* swap the reg offset for these in big-endian mode */
189*4882a593Smuzhiyun 	if (edma->big_endian)
190*4882a593Smuzhiyun 		iowrite8(val, (void __iomem *)((unsigned long)addr ^ 0x3));
191*4882a593Smuzhiyun 	else
192*4882a593Smuzhiyun 		iowrite8(val, addr);
193*4882a593Smuzhiyun }
194*4882a593Smuzhiyun 
edma_writew(struct fsl_edma_engine * edma,u16 val,void __iomem * addr)195*4882a593Smuzhiyun static inline void edma_writew(struct fsl_edma_engine *edma,
196*4882a593Smuzhiyun 			       u16 val, void __iomem *addr)
197*4882a593Smuzhiyun {
198*4882a593Smuzhiyun 	/* swap the reg offset for these in big-endian mode */
199*4882a593Smuzhiyun 	if (edma->big_endian)
200*4882a593Smuzhiyun 		iowrite16be(val, (void __iomem *)((unsigned long)addr ^ 0x2));
201*4882a593Smuzhiyun 	else
202*4882a593Smuzhiyun 		iowrite16(val, addr);
203*4882a593Smuzhiyun }
204*4882a593Smuzhiyun 
edma_writel(struct fsl_edma_engine * edma,u32 val,void __iomem * addr)205*4882a593Smuzhiyun static inline void edma_writel(struct fsl_edma_engine *edma,
206*4882a593Smuzhiyun 			       u32 val, void __iomem *addr)
207*4882a593Smuzhiyun {
208*4882a593Smuzhiyun 	if (edma->big_endian)
209*4882a593Smuzhiyun 		iowrite32be(val, addr);
210*4882a593Smuzhiyun 	else
211*4882a593Smuzhiyun 		iowrite32(val, addr);
212*4882a593Smuzhiyun }
213*4882a593Smuzhiyun 
to_fsl_edma_chan(struct dma_chan * chan)214*4882a593Smuzhiyun static inline struct fsl_edma_chan *to_fsl_edma_chan(struct dma_chan *chan)
215*4882a593Smuzhiyun {
216*4882a593Smuzhiyun 	return container_of(chan, struct fsl_edma_chan, vchan.chan);
217*4882a593Smuzhiyun }
218*4882a593Smuzhiyun 
to_fsl_edma_desc(struct virt_dma_desc * vd)219*4882a593Smuzhiyun static inline struct fsl_edma_desc *to_fsl_edma_desc(struct virt_dma_desc *vd)
220*4882a593Smuzhiyun {
221*4882a593Smuzhiyun 	return container_of(vd, struct fsl_edma_desc, vdesc);
222*4882a593Smuzhiyun }
223*4882a593Smuzhiyun 
224*4882a593Smuzhiyun void fsl_edma_disable_request(struct fsl_edma_chan *fsl_chan);
225*4882a593Smuzhiyun void fsl_edma_chan_mux(struct fsl_edma_chan *fsl_chan,
226*4882a593Smuzhiyun 			unsigned int slot, bool enable);
227*4882a593Smuzhiyun void fsl_edma_free_desc(struct virt_dma_desc *vdesc);
228*4882a593Smuzhiyun int fsl_edma_terminate_all(struct dma_chan *chan);
229*4882a593Smuzhiyun int fsl_edma_pause(struct dma_chan *chan);
230*4882a593Smuzhiyun int fsl_edma_resume(struct dma_chan *chan);
231*4882a593Smuzhiyun int fsl_edma_slave_config(struct dma_chan *chan,
232*4882a593Smuzhiyun 				 struct dma_slave_config *cfg);
233*4882a593Smuzhiyun enum dma_status fsl_edma_tx_status(struct dma_chan *chan,
234*4882a593Smuzhiyun 		dma_cookie_t cookie, struct dma_tx_state *txstate);
235*4882a593Smuzhiyun struct dma_async_tx_descriptor *fsl_edma_prep_dma_cyclic(
236*4882a593Smuzhiyun 		struct dma_chan *chan, dma_addr_t dma_addr, size_t buf_len,
237*4882a593Smuzhiyun 		size_t period_len, enum dma_transfer_direction direction,
238*4882a593Smuzhiyun 		unsigned long flags);
239*4882a593Smuzhiyun struct dma_async_tx_descriptor *fsl_edma_prep_slave_sg(
240*4882a593Smuzhiyun 		struct dma_chan *chan, struct scatterlist *sgl,
241*4882a593Smuzhiyun 		unsigned int sg_len, enum dma_transfer_direction direction,
242*4882a593Smuzhiyun 		unsigned long flags, void *context);
243*4882a593Smuzhiyun void fsl_edma_xfer_desc(struct fsl_edma_chan *fsl_chan);
244*4882a593Smuzhiyun void fsl_edma_issue_pending(struct dma_chan *chan);
245*4882a593Smuzhiyun int fsl_edma_alloc_chan_resources(struct dma_chan *chan);
246*4882a593Smuzhiyun void fsl_edma_free_chan_resources(struct dma_chan *chan);
247*4882a593Smuzhiyun void fsl_edma_cleanup_vchan(struct dma_device *dmadev);
248*4882a593Smuzhiyun void fsl_edma_setup_regs(struct fsl_edma_engine *edma);
249*4882a593Smuzhiyun 
250*4882a593Smuzhiyun #endif /* _FSL_EDMA_COMMON_H_ */
251