xref: /openbmc/linux/drivers/dma/qcom/bam_dma.c (revision 22d55f02)
1 // SPDX-License-Identifier: GPL-2.0-only
2 /*
3  * Copyright (c) 2013-2014, The Linux Foundation. All rights reserved.
4  */
5 /*
6  * QCOM BAM DMA engine driver
7  *
8  * QCOM BAM DMA blocks are distributed amongst a number of the on-chip
9  * peripherals on the MSM 8x74.  The configuration of the channels are dependent
10  * on the way they are hard wired to that specific peripheral.  The peripheral
11  * device tree entries specify the configuration of each channel.
12  *
13  * The DMA controller requires the use of external memory for storage of the
14  * hardware descriptors for each channel.  The descriptor FIFO is accessed as a
15  * circular buffer and operations are managed according to the offset within the
16  * FIFO.  After pipe/channel reset, all of the pipe registers and internal state
17  * are back to defaults.
18  *
19  * During DMA operations, we write descriptors to the FIFO, being careful to
20  * handle wrapping and then write the last FIFO offset to that channel's
21  * P_EVNT_REG register to kick off the transaction.  The P_SW_OFSTS register
22  * indicates the current FIFO offset that is being processed, so there is some
23  * indication of where the hardware is currently working.
24  */
25 
26 #include <linux/kernel.h>
27 #include <linux/io.h>
28 #include <linux/init.h>
29 #include <linux/slab.h>
30 #include <linux/module.h>
31 #include <linux/interrupt.h>
32 #include <linux/dma-mapping.h>
33 #include <linux/scatterlist.h>
34 #include <linux/device.h>
35 #include <linux/platform_device.h>
36 #include <linux/of.h>
37 #include <linux/of_address.h>
38 #include <linux/of_irq.h>
39 #include <linux/of_dma.h>
40 #include <linux/circ_buf.h>
41 #include <linux/clk.h>
42 #include <linux/dmaengine.h>
43 #include <linux/pm_runtime.h>
44 
45 #include "../dmaengine.h"
46 #include "../virt-dma.h"
47 
48 struct bam_desc_hw {
49 	__le32 addr;		/* Buffer physical address */
50 	__le16 size;		/* Buffer size in bytes */
51 	__le16 flags;
52 };
53 
54 #define BAM_DMA_AUTOSUSPEND_DELAY 100
55 
56 #define DESC_FLAG_INT BIT(15)
57 #define DESC_FLAG_EOT BIT(14)
58 #define DESC_FLAG_EOB BIT(13)
59 #define DESC_FLAG_NWD BIT(12)
60 #define DESC_FLAG_CMD BIT(11)
61 
62 struct bam_async_desc {
63 	struct virt_dma_desc vd;
64 
65 	u32 num_desc;
66 	u32 xfer_len;
67 
68 	/* transaction flags, EOT|EOB|NWD */
69 	u16 flags;
70 
71 	struct bam_desc_hw *curr_desc;
72 
73 	/* list node for the desc in the bam_chan list of descriptors */
74 	struct list_head desc_node;
75 	enum dma_transfer_direction dir;
76 	size_t length;
77 	struct bam_desc_hw desc[0];
78 };
79 
80 enum bam_reg {
81 	BAM_CTRL,
82 	BAM_REVISION,
83 	BAM_NUM_PIPES,
84 	BAM_DESC_CNT_TRSHLD,
85 	BAM_IRQ_SRCS,
86 	BAM_IRQ_SRCS_MSK,
87 	BAM_IRQ_SRCS_UNMASKED,
88 	BAM_IRQ_STTS,
89 	BAM_IRQ_CLR,
90 	BAM_IRQ_EN,
91 	BAM_CNFG_BITS,
92 	BAM_IRQ_SRCS_EE,
93 	BAM_IRQ_SRCS_MSK_EE,
94 	BAM_P_CTRL,
95 	BAM_P_RST,
96 	BAM_P_HALT,
97 	BAM_P_IRQ_STTS,
98 	BAM_P_IRQ_CLR,
99 	BAM_P_IRQ_EN,
100 	BAM_P_EVNT_DEST_ADDR,
101 	BAM_P_EVNT_REG,
102 	BAM_P_SW_OFSTS,
103 	BAM_P_DATA_FIFO_ADDR,
104 	BAM_P_DESC_FIFO_ADDR,
105 	BAM_P_EVNT_GEN_TRSHLD,
106 	BAM_P_FIFO_SIZES,
107 };
108 
109 struct reg_offset_data {
110 	u32 base_offset;
111 	unsigned int pipe_mult, evnt_mult, ee_mult;
112 };
113 
114 static const struct reg_offset_data bam_v1_3_reg_info[] = {
115 	[BAM_CTRL]		= { 0x0F80, 0x00, 0x00, 0x00 },
116 	[BAM_REVISION]		= { 0x0F84, 0x00, 0x00, 0x00 },
117 	[BAM_NUM_PIPES]		= { 0x0FBC, 0x00, 0x00, 0x00 },
118 	[BAM_DESC_CNT_TRSHLD]	= { 0x0F88, 0x00, 0x00, 0x00 },
119 	[BAM_IRQ_SRCS]		= { 0x0F8C, 0x00, 0x00, 0x00 },
120 	[BAM_IRQ_SRCS_MSK]	= { 0x0F90, 0x00, 0x00, 0x00 },
121 	[BAM_IRQ_SRCS_UNMASKED]	= { 0x0FB0, 0x00, 0x00, 0x00 },
122 	[BAM_IRQ_STTS]		= { 0x0F94, 0x00, 0x00, 0x00 },
123 	[BAM_IRQ_CLR]		= { 0x0F98, 0x00, 0x00, 0x00 },
124 	[BAM_IRQ_EN]		= { 0x0F9C, 0x00, 0x00, 0x00 },
125 	[BAM_CNFG_BITS]		= { 0x0FFC, 0x00, 0x00, 0x00 },
126 	[BAM_IRQ_SRCS_EE]	= { 0x1800, 0x00, 0x00, 0x80 },
127 	[BAM_IRQ_SRCS_MSK_EE]	= { 0x1804, 0x00, 0x00, 0x80 },
128 	[BAM_P_CTRL]		= { 0x0000, 0x80, 0x00, 0x00 },
129 	[BAM_P_RST]		= { 0x0004, 0x80, 0x00, 0x00 },
130 	[BAM_P_HALT]		= { 0x0008, 0x80, 0x00, 0x00 },
131 	[BAM_P_IRQ_STTS]	= { 0x0010, 0x80, 0x00, 0x00 },
132 	[BAM_P_IRQ_CLR]		= { 0x0014, 0x80, 0x00, 0x00 },
133 	[BAM_P_IRQ_EN]		= { 0x0018, 0x80, 0x00, 0x00 },
134 	[BAM_P_EVNT_DEST_ADDR]	= { 0x102C, 0x00, 0x40, 0x00 },
135 	[BAM_P_EVNT_REG]	= { 0x1018, 0x00, 0x40, 0x00 },
136 	[BAM_P_SW_OFSTS]	= { 0x1000, 0x00, 0x40, 0x00 },
137 	[BAM_P_DATA_FIFO_ADDR]	= { 0x1024, 0x00, 0x40, 0x00 },
138 	[BAM_P_DESC_FIFO_ADDR]	= { 0x101C, 0x00, 0x40, 0x00 },
139 	[BAM_P_EVNT_GEN_TRSHLD]	= { 0x1028, 0x00, 0x40, 0x00 },
140 	[BAM_P_FIFO_SIZES]	= { 0x1020, 0x00, 0x40, 0x00 },
141 };
142 
143 static const struct reg_offset_data bam_v1_4_reg_info[] = {
144 	[BAM_CTRL]		= { 0x0000, 0x00, 0x00, 0x00 },
145 	[BAM_REVISION]		= { 0x0004, 0x00, 0x00, 0x00 },
146 	[BAM_NUM_PIPES]		= { 0x003C, 0x00, 0x00, 0x00 },
147 	[BAM_DESC_CNT_TRSHLD]	= { 0x0008, 0x00, 0x00, 0x00 },
148 	[BAM_IRQ_SRCS]		= { 0x000C, 0x00, 0x00, 0x00 },
149 	[BAM_IRQ_SRCS_MSK]	= { 0x0010, 0x00, 0x00, 0x00 },
150 	[BAM_IRQ_SRCS_UNMASKED]	= { 0x0030, 0x00, 0x00, 0x00 },
151 	[BAM_IRQ_STTS]		= { 0x0014, 0x00, 0x00, 0x00 },
152 	[BAM_IRQ_CLR]		= { 0x0018, 0x00, 0x00, 0x00 },
153 	[BAM_IRQ_EN]		= { 0x001C, 0x00, 0x00, 0x00 },
154 	[BAM_CNFG_BITS]		= { 0x007C, 0x00, 0x00, 0x00 },
155 	[BAM_IRQ_SRCS_EE]	= { 0x0800, 0x00, 0x00, 0x80 },
156 	[BAM_IRQ_SRCS_MSK_EE]	= { 0x0804, 0x00, 0x00, 0x80 },
157 	[BAM_P_CTRL]		= { 0x1000, 0x1000, 0x00, 0x00 },
158 	[BAM_P_RST]		= { 0x1004, 0x1000, 0x00, 0x00 },
159 	[BAM_P_HALT]		= { 0x1008, 0x1000, 0x00, 0x00 },
160 	[BAM_P_IRQ_STTS]	= { 0x1010, 0x1000, 0x00, 0x00 },
161 	[BAM_P_IRQ_CLR]		= { 0x1014, 0x1000, 0x00, 0x00 },
162 	[BAM_P_IRQ_EN]		= { 0x1018, 0x1000, 0x00, 0x00 },
163 	[BAM_P_EVNT_DEST_ADDR]	= { 0x182C, 0x00, 0x1000, 0x00 },
164 	[BAM_P_EVNT_REG]	= { 0x1818, 0x00, 0x1000, 0x00 },
165 	[BAM_P_SW_OFSTS]	= { 0x1800, 0x00, 0x1000, 0x00 },
166 	[BAM_P_DATA_FIFO_ADDR]	= { 0x1824, 0x00, 0x1000, 0x00 },
167 	[BAM_P_DESC_FIFO_ADDR]	= { 0x181C, 0x00, 0x1000, 0x00 },
168 	[BAM_P_EVNT_GEN_TRSHLD]	= { 0x1828, 0x00, 0x1000, 0x00 },
169 	[BAM_P_FIFO_SIZES]	= { 0x1820, 0x00, 0x1000, 0x00 },
170 };
171 
172 static const struct reg_offset_data bam_v1_7_reg_info[] = {
173 	[BAM_CTRL]		= { 0x00000, 0x00, 0x00, 0x00 },
174 	[BAM_REVISION]		= { 0x01000, 0x00, 0x00, 0x00 },
175 	[BAM_NUM_PIPES]		= { 0x01008, 0x00, 0x00, 0x00 },
176 	[BAM_DESC_CNT_TRSHLD]	= { 0x00008, 0x00, 0x00, 0x00 },
177 	[BAM_IRQ_SRCS]		= { 0x03010, 0x00, 0x00, 0x00 },
178 	[BAM_IRQ_SRCS_MSK]	= { 0x03014, 0x00, 0x00, 0x00 },
179 	[BAM_IRQ_SRCS_UNMASKED]	= { 0x03018, 0x00, 0x00, 0x00 },
180 	[BAM_IRQ_STTS]		= { 0x00014, 0x00, 0x00, 0x00 },
181 	[BAM_IRQ_CLR]		= { 0x00018, 0x00, 0x00, 0x00 },
182 	[BAM_IRQ_EN]		= { 0x0001C, 0x00, 0x00, 0x00 },
183 	[BAM_CNFG_BITS]		= { 0x0007C, 0x00, 0x00, 0x00 },
184 	[BAM_IRQ_SRCS_EE]	= { 0x03000, 0x00, 0x00, 0x1000 },
185 	[BAM_IRQ_SRCS_MSK_EE]	= { 0x03004, 0x00, 0x00, 0x1000 },
186 	[BAM_P_CTRL]		= { 0x13000, 0x1000, 0x00, 0x00 },
187 	[BAM_P_RST]		= { 0x13004, 0x1000, 0x00, 0x00 },
188 	[BAM_P_HALT]		= { 0x13008, 0x1000, 0x00, 0x00 },
189 	[BAM_P_IRQ_STTS]	= { 0x13010, 0x1000, 0x00, 0x00 },
190 	[BAM_P_IRQ_CLR]		= { 0x13014, 0x1000, 0x00, 0x00 },
191 	[BAM_P_IRQ_EN]		= { 0x13018, 0x1000, 0x00, 0x00 },
192 	[BAM_P_EVNT_DEST_ADDR]	= { 0x1382C, 0x00, 0x1000, 0x00 },
193 	[BAM_P_EVNT_REG]	= { 0x13818, 0x00, 0x1000, 0x00 },
194 	[BAM_P_SW_OFSTS]	= { 0x13800, 0x00, 0x1000, 0x00 },
195 	[BAM_P_DATA_FIFO_ADDR]	= { 0x13824, 0x00, 0x1000, 0x00 },
196 	[BAM_P_DESC_FIFO_ADDR]	= { 0x1381C, 0x00, 0x1000, 0x00 },
197 	[BAM_P_EVNT_GEN_TRSHLD]	= { 0x13828, 0x00, 0x1000, 0x00 },
198 	[BAM_P_FIFO_SIZES]	= { 0x13820, 0x00, 0x1000, 0x00 },
199 };
200 
201 /* BAM CTRL */
202 #define BAM_SW_RST			BIT(0)
203 #define BAM_EN				BIT(1)
204 #define BAM_EN_ACCUM			BIT(4)
205 #define BAM_TESTBUS_SEL_SHIFT		5
206 #define BAM_TESTBUS_SEL_MASK		0x3F
207 #define BAM_DESC_CACHE_SEL_SHIFT	13
208 #define BAM_DESC_CACHE_SEL_MASK		0x3
209 #define BAM_CACHED_DESC_STORE		BIT(15)
210 #define IBC_DISABLE			BIT(16)
211 
212 /* BAM REVISION */
213 #define REVISION_SHIFT		0
214 #define REVISION_MASK		0xFF
215 #define NUM_EES_SHIFT		8
216 #define NUM_EES_MASK		0xF
217 #define CE_BUFFER_SIZE		BIT(13)
218 #define AXI_ACTIVE		BIT(14)
219 #define USE_VMIDMT		BIT(15)
220 #define SECURED			BIT(16)
221 #define BAM_HAS_NO_BYPASS	BIT(17)
222 #define HIGH_FREQUENCY_BAM	BIT(18)
223 #define INACTIV_TMRS_EXST	BIT(19)
224 #define NUM_INACTIV_TMRS	BIT(20)
225 #define DESC_CACHE_DEPTH_SHIFT	21
226 #define DESC_CACHE_DEPTH_1	(0 << DESC_CACHE_DEPTH_SHIFT)
227 #define DESC_CACHE_DEPTH_2	(1 << DESC_CACHE_DEPTH_SHIFT)
228 #define DESC_CACHE_DEPTH_3	(2 << DESC_CACHE_DEPTH_SHIFT)
229 #define DESC_CACHE_DEPTH_4	(3 << DESC_CACHE_DEPTH_SHIFT)
230 #define CMD_DESC_EN		BIT(23)
231 #define INACTIV_TMR_BASE_SHIFT	24
232 #define INACTIV_TMR_BASE_MASK	0xFF
233 
234 /* BAM NUM PIPES */
235 #define BAM_NUM_PIPES_SHIFT		0
236 #define BAM_NUM_PIPES_MASK		0xFF
237 #define PERIPH_NON_PIPE_GRP_SHIFT	16
238 #define PERIPH_NON_PIP_GRP_MASK		0xFF
239 #define BAM_NON_PIPE_GRP_SHIFT		24
240 #define BAM_NON_PIPE_GRP_MASK		0xFF
241 
242 /* BAM CNFG BITS */
243 #define BAM_PIPE_CNFG		BIT(2)
244 #define BAM_FULL_PIPE		BIT(11)
245 #define BAM_NO_EXT_P_RST	BIT(12)
246 #define BAM_IBC_DISABLE		BIT(13)
247 #define BAM_SB_CLK_REQ		BIT(14)
248 #define BAM_PSM_CSW_REQ		BIT(15)
249 #define BAM_PSM_P_RES		BIT(16)
250 #define BAM_AU_P_RES		BIT(17)
251 #define BAM_SI_P_RES		BIT(18)
252 #define BAM_WB_P_RES		BIT(19)
253 #define BAM_WB_BLK_CSW		BIT(20)
254 #define BAM_WB_CSW_ACK_IDL	BIT(21)
255 #define BAM_WB_RETR_SVPNT	BIT(22)
256 #define BAM_WB_DSC_AVL_P_RST	BIT(23)
257 #define BAM_REG_P_EN		BIT(24)
258 #define BAM_PSM_P_HD_DATA	BIT(25)
259 #define BAM_AU_ACCUMED		BIT(26)
260 #define BAM_CMD_ENABLE		BIT(27)
261 
262 #define BAM_CNFG_BITS_DEFAULT	(BAM_PIPE_CNFG |	\
263 				 BAM_NO_EXT_P_RST |	\
264 				 BAM_IBC_DISABLE |	\
265 				 BAM_SB_CLK_REQ |	\
266 				 BAM_PSM_CSW_REQ |	\
267 				 BAM_PSM_P_RES |	\
268 				 BAM_AU_P_RES |		\
269 				 BAM_SI_P_RES |		\
270 				 BAM_WB_P_RES |		\
271 				 BAM_WB_BLK_CSW |	\
272 				 BAM_WB_CSW_ACK_IDL |	\
273 				 BAM_WB_RETR_SVPNT |	\
274 				 BAM_WB_DSC_AVL_P_RST |	\
275 				 BAM_REG_P_EN |		\
276 				 BAM_PSM_P_HD_DATA |	\
277 				 BAM_AU_ACCUMED |	\
278 				 BAM_CMD_ENABLE)
279 
280 /* PIPE CTRL */
281 #define P_EN			BIT(1)
282 #define P_DIRECTION		BIT(3)
283 #define P_SYS_STRM		BIT(4)
284 #define P_SYS_MODE		BIT(5)
285 #define P_AUTO_EOB		BIT(6)
286 #define P_AUTO_EOB_SEL_SHIFT	7
287 #define P_AUTO_EOB_SEL_512	(0 << P_AUTO_EOB_SEL_SHIFT)
288 #define P_AUTO_EOB_SEL_256	(1 << P_AUTO_EOB_SEL_SHIFT)
289 #define P_AUTO_EOB_SEL_128	(2 << P_AUTO_EOB_SEL_SHIFT)
290 #define P_AUTO_EOB_SEL_64	(3 << P_AUTO_EOB_SEL_SHIFT)
291 #define P_PREFETCH_LIMIT_SHIFT	9
292 #define P_PREFETCH_LIMIT_32	(0 << P_PREFETCH_LIMIT_SHIFT)
293 #define P_PREFETCH_LIMIT_16	(1 << P_PREFETCH_LIMIT_SHIFT)
294 #define P_PREFETCH_LIMIT_4	(2 << P_PREFETCH_LIMIT_SHIFT)
295 #define P_WRITE_NWD		BIT(11)
296 #define P_LOCK_GROUP_SHIFT	16
297 #define P_LOCK_GROUP_MASK	0x1F
298 
299 /* BAM_DESC_CNT_TRSHLD */
300 #define CNT_TRSHLD		0xffff
301 #define DEFAULT_CNT_THRSHLD	0x4
302 
303 /* BAM_IRQ_SRCS */
304 #define BAM_IRQ			BIT(31)
305 #define P_IRQ			0x7fffffff
306 
307 /* BAM_IRQ_SRCS_MSK */
308 #define BAM_IRQ_MSK		BAM_IRQ
309 #define P_IRQ_MSK		P_IRQ
310 
311 /* BAM_IRQ_STTS */
312 #define BAM_TIMER_IRQ		BIT(4)
313 #define BAM_EMPTY_IRQ		BIT(3)
314 #define BAM_ERROR_IRQ		BIT(2)
315 #define BAM_HRESP_ERR_IRQ	BIT(1)
316 
317 /* BAM_IRQ_CLR */
318 #define BAM_TIMER_CLR		BIT(4)
319 #define BAM_EMPTY_CLR		BIT(3)
320 #define BAM_ERROR_CLR		BIT(2)
321 #define BAM_HRESP_ERR_CLR	BIT(1)
322 
323 /* BAM_IRQ_EN */
324 #define BAM_TIMER_EN		BIT(4)
325 #define BAM_EMPTY_EN		BIT(3)
326 #define BAM_ERROR_EN		BIT(2)
327 #define BAM_HRESP_ERR_EN	BIT(1)
328 
329 /* BAM_P_IRQ_EN */
330 #define P_PRCSD_DESC_EN		BIT(0)
331 #define P_TIMER_EN		BIT(1)
332 #define P_WAKE_EN		BIT(2)
333 #define P_OUT_OF_DESC_EN	BIT(3)
334 #define P_ERR_EN		BIT(4)
335 #define P_TRNSFR_END_EN		BIT(5)
336 #define P_DEFAULT_IRQS_EN	(P_PRCSD_DESC_EN | P_ERR_EN | P_TRNSFR_END_EN)
337 
338 /* BAM_P_SW_OFSTS */
339 #define P_SW_OFSTS_MASK		0xffff
340 
341 #define BAM_DESC_FIFO_SIZE	SZ_32K
342 #define MAX_DESCRIPTORS (BAM_DESC_FIFO_SIZE / sizeof(struct bam_desc_hw) - 1)
343 #define BAM_FIFO_SIZE	(SZ_32K - 8)
344 #define IS_BUSY(chan)	(CIRC_SPACE(bchan->tail, bchan->head,\
345 			 MAX_DESCRIPTORS + 1) == 0)
346 
347 struct bam_chan {
348 	struct virt_dma_chan vc;
349 
350 	struct bam_device *bdev;
351 
352 	/* configuration from device tree */
353 	u32 id;
354 
355 	/* runtime configuration */
356 	struct dma_slave_config slave;
357 
358 	/* fifo storage */
359 	struct bam_desc_hw *fifo_virt;
360 	dma_addr_t fifo_phys;
361 
362 	/* fifo markers */
363 	unsigned short head;		/* start of active descriptor entries */
364 	unsigned short tail;		/* end of active descriptor entries */
365 
366 	unsigned int initialized;	/* is the channel hw initialized? */
367 	unsigned int paused;		/* is the channel paused? */
368 	unsigned int reconfigure;	/* new slave config? */
369 	/* list of descriptors currently processed */
370 	struct list_head desc_list;
371 
372 	struct list_head node;
373 };
374 
375 static inline struct bam_chan *to_bam_chan(struct dma_chan *common)
376 {
377 	return container_of(common, struct bam_chan, vc.chan);
378 }
379 
380 struct bam_device {
381 	void __iomem *regs;
382 	struct device *dev;
383 	struct dma_device common;
384 	struct device_dma_parameters dma_parms;
385 	struct bam_chan *channels;
386 	u32 num_channels;
387 	u32 num_ees;
388 
389 	/* execution environment ID, from DT */
390 	u32 ee;
391 	bool controlled_remotely;
392 
393 	const struct reg_offset_data *layout;
394 
395 	struct clk *bamclk;
396 	int irq;
397 
398 	/* dma start transaction tasklet */
399 	struct tasklet_struct task;
400 };
401 
402 /**
403  * bam_addr - returns BAM register address
404  * @bdev: bam device
405  * @pipe: pipe instance (ignored when register doesn't have multiple instances)
406  * @reg:  register enum
407  */
408 static inline void __iomem *bam_addr(struct bam_device *bdev, u32 pipe,
409 		enum bam_reg reg)
410 {
411 	const struct reg_offset_data r = bdev->layout[reg];
412 
413 	return bdev->regs + r.base_offset +
414 		r.pipe_mult * pipe +
415 		r.evnt_mult * pipe +
416 		r.ee_mult * bdev->ee;
417 }
418 
419 /**
420  * bam_reset_channel - Reset individual BAM DMA channel
421  * @bchan: bam channel
422  *
423  * This function resets a specific BAM channel
424  */
425 static void bam_reset_channel(struct bam_chan *bchan)
426 {
427 	struct bam_device *bdev = bchan->bdev;
428 
429 	lockdep_assert_held(&bchan->vc.lock);
430 
431 	/* reset channel */
432 	writel_relaxed(1, bam_addr(bdev, bchan->id, BAM_P_RST));
433 	writel_relaxed(0, bam_addr(bdev, bchan->id, BAM_P_RST));
434 
435 	/* don't allow cpu to reorder BAM register accesses done after this */
436 	wmb();
437 
438 	/* make sure hw is initialized when channel is used the first time  */
439 	bchan->initialized = 0;
440 }
441 
442 /**
443  * bam_chan_init_hw - Initialize channel hardware
444  * @bchan: bam channel
445  * @dir: DMA transfer direction
446  *
447  * This function resets and initializes the BAM channel
448  */
449 static void bam_chan_init_hw(struct bam_chan *bchan,
450 	enum dma_transfer_direction dir)
451 {
452 	struct bam_device *bdev = bchan->bdev;
453 	u32 val;
454 
455 	/* Reset the channel to clear internal state of the FIFO */
456 	bam_reset_channel(bchan);
457 
458 	/*
459 	 * write out 8 byte aligned address.  We have enough space for this
460 	 * because we allocated 1 more descriptor (8 bytes) than we can use
461 	 */
462 	writel_relaxed(ALIGN(bchan->fifo_phys, sizeof(struct bam_desc_hw)),
463 			bam_addr(bdev, bchan->id, BAM_P_DESC_FIFO_ADDR));
464 	writel_relaxed(BAM_FIFO_SIZE,
465 			bam_addr(bdev, bchan->id, BAM_P_FIFO_SIZES));
466 
467 	/* enable the per pipe interrupts, enable EOT, ERR, and INT irqs */
468 	writel_relaxed(P_DEFAULT_IRQS_EN,
469 			bam_addr(bdev, bchan->id, BAM_P_IRQ_EN));
470 
471 	/* unmask the specific pipe and EE combo */
472 	val = readl_relaxed(bam_addr(bdev, 0, BAM_IRQ_SRCS_MSK_EE));
473 	val |= BIT(bchan->id);
474 	writel_relaxed(val, bam_addr(bdev, 0, BAM_IRQ_SRCS_MSK_EE));
475 
476 	/* don't allow cpu to reorder the channel enable done below */
477 	wmb();
478 
479 	/* set fixed direction and mode, then enable channel */
480 	val = P_EN | P_SYS_MODE;
481 	if (dir == DMA_DEV_TO_MEM)
482 		val |= P_DIRECTION;
483 
484 	writel_relaxed(val, bam_addr(bdev, bchan->id, BAM_P_CTRL));
485 
486 	bchan->initialized = 1;
487 
488 	/* init FIFO pointers */
489 	bchan->head = 0;
490 	bchan->tail = 0;
491 }
492 
493 /**
494  * bam_alloc_chan - Allocate channel resources for DMA channel.
495  * @chan: specified channel
496  *
497  * This function allocates the FIFO descriptor memory
498  */
499 static int bam_alloc_chan(struct dma_chan *chan)
500 {
501 	struct bam_chan *bchan = to_bam_chan(chan);
502 	struct bam_device *bdev = bchan->bdev;
503 
504 	if (bchan->fifo_virt)
505 		return 0;
506 
507 	/* allocate FIFO descriptor space, but only if necessary */
508 	bchan->fifo_virt = dma_alloc_wc(bdev->dev, BAM_DESC_FIFO_SIZE,
509 					&bchan->fifo_phys, GFP_KERNEL);
510 
511 	if (!bchan->fifo_virt) {
512 		dev_err(bdev->dev, "Failed to allocate desc fifo\n");
513 		return -ENOMEM;
514 	}
515 
516 	return 0;
517 }
518 
519 static int bam_pm_runtime_get_sync(struct device *dev)
520 {
521 	if (pm_runtime_enabled(dev))
522 		return pm_runtime_get_sync(dev);
523 
524 	return 0;
525 }
526 
527 /**
528  * bam_free_chan - Frees dma resources associated with specific channel
529  * @chan: specified channel
530  *
531  * Free the allocated fifo descriptor memory and channel resources
532  *
533  */
534 static void bam_free_chan(struct dma_chan *chan)
535 {
536 	struct bam_chan *bchan = to_bam_chan(chan);
537 	struct bam_device *bdev = bchan->bdev;
538 	u32 val;
539 	unsigned long flags;
540 	int ret;
541 
542 	ret = bam_pm_runtime_get_sync(bdev->dev);
543 	if (ret < 0)
544 		return;
545 
546 	vchan_free_chan_resources(to_virt_chan(chan));
547 
548 	if (!list_empty(&bchan->desc_list)) {
549 		dev_err(bchan->bdev->dev, "Cannot free busy channel\n");
550 		goto err;
551 	}
552 
553 	spin_lock_irqsave(&bchan->vc.lock, flags);
554 	bam_reset_channel(bchan);
555 	spin_unlock_irqrestore(&bchan->vc.lock, flags);
556 
557 	dma_free_wc(bdev->dev, BAM_DESC_FIFO_SIZE, bchan->fifo_virt,
558 		    bchan->fifo_phys);
559 	bchan->fifo_virt = NULL;
560 
561 	/* mask irq for pipe/channel */
562 	val = readl_relaxed(bam_addr(bdev, 0, BAM_IRQ_SRCS_MSK_EE));
563 	val &= ~BIT(bchan->id);
564 	writel_relaxed(val, bam_addr(bdev, 0, BAM_IRQ_SRCS_MSK_EE));
565 
566 	/* disable irq */
567 	writel_relaxed(0, bam_addr(bdev, bchan->id, BAM_P_IRQ_EN));
568 
569 err:
570 	pm_runtime_mark_last_busy(bdev->dev);
571 	pm_runtime_put_autosuspend(bdev->dev);
572 }
573 
574 /**
575  * bam_slave_config - set slave configuration for channel
576  * @chan: dma channel
577  * @cfg: slave configuration
578  *
579  * Sets slave configuration for channel
580  *
581  */
582 static int bam_slave_config(struct dma_chan *chan,
583 			    struct dma_slave_config *cfg)
584 {
585 	struct bam_chan *bchan = to_bam_chan(chan);
586 	unsigned long flag;
587 
588 	spin_lock_irqsave(&bchan->vc.lock, flag);
589 	memcpy(&bchan->slave, cfg, sizeof(*cfg));
590 	bchan->reconfigure = 1;
591 	spin_unlock_irqrestore(&bchan->vc.lock, flag);
592 
593 	return 0;
594 }
595 
596 /**
597  * bam_prep_slave_sg - Prep slave sg transaction
598  *
599  * @chan: dma channel
600  * @sgl: scatter gather list
601  * @sg_len: length of sg
602  * @direction: DMA transfer direction
603  * @flags: DMA flags
604  * @context: transfer context (unused)
605  */
606 static struct dma_async_tx_descriptor *bam_prep_slave_sg(struct dma_chan *chan,
607 	struct scatterlist *sgl, unsigned int sg_len,
608 	enum dma_transfer_direction direction, unsigned long flags,
609 	void *context)
610 {
611 	struct bam_chan *bchan = to_bam_chan(chan);
612 	struct bam_device *bdev = bchan->bdev;
613 	struct bam_async_desc *async_desc;
614 	struct scatterlist *sg;
615 	u32 i;
616 	struct bam_desc_hw *desc;
617 	unsigned int num_alloc = 0;
618 
619 
620 	if (!is_slave_direction(direction)) {
621 		dev_err(bdev->dev, "invalid dma direction\n");
622 		return NULL;
623 	}
624 
625 	/* calculate number of required entries */
626 	for_each_sg(sgl, sg, sg_len, i)
627 		num_alloc += DIV_ROUND_UP(sg_dma_len(sg), BAM_FIFO_SIZE);
628 
629 	/* allocate enough room to accomodate the number of entries */
630 	async_desc = kzalloc(struct_size(async_desc, desc, num_alloc),
631 			     GFP_NOWAIT);
632 
633 	if (!async_desc)
634 		goto err_out;
635 
636 	if (flags & DMA_PREP_FENCE)
637 		async_desc->flags |= DESC_FLAG_NWD;
638 
639 	if (flags & DMA_PREP_INTERRUPT)
640 		async_desc->flags |= DESC_FLAG_EOT;
641 
642 	async_desc->num_desc = num_alloc;
643 	async_desc->curr_desc = async_desc->desc;
644 	async_desc->dir = direction;
645 
646 	/* fill in temporary descriptors */
647 	desc = async_desc->desc;
648 	for_each_sg(sgl, sg, sg_len, i) {
649 		unsigned int remainder = sg_dma_len(sg);
650 		unsigned int curr_offset = 0;
651 
652 		do {
653 			if (flags & DMA_PREP_CMD)
654 				desc->flags |= cpu_to_le16(DESC_FLAG_CMD);
655 
656 			desc->addr = cpu_to_le32(sg_dma_address(sg) +
657 						 curr_offset);
658 
659 			if (remainder > BAM_FIFO_SIZE) {
660 				desc->size = cpu_to_le16(BAM_FIFO_SIZE);
661 				remainder -= BAM_FIFO_SIZE;
662 				curr_offset += BAM_FIFO_SIZE;
663 			} else {
664 				desc->size = cpu_to_le16(remainder);
665 				remainder = 0;
666 			}
667 
668 			async_desc->length += le16_to_cpu(desc->size);
669 			desc++;
670 		} while (remainder > 0);
671 	}
672 
673 	return vchan_tx_prep(&bchan->vc, &async_desc->vd, flags);
674 
675 err_out:
676 	kfree(async_desc);
677 	return NULL;
678 }
679 
680 /**
681  * bam_dma_terminate_all - terminate all transactions on a channel
682  * @chan: bam dma channel
683  *
684  * Dequeues and frees all transactions
685  * No callbacks are done
686  *
687  */
688 static int bam_dma_terminate_all(struct dma_chan *chan)
689 {
690 	struct bam_chan *bchan = to_bam_chan(chan);
691 	struct bam_async_desc *async_desc, *tmp;
692 	unsigned long flag;
693 	LIST_HEAD(head);
694 
695 	/* remove all transactions, including active transaction */
696 	spin_lock_irqsave(&bchan->vc.lock, flag);
697 	list_for_each_entry_safe(async_desc, tmp,
698 				 &bchan->desc_list, desc_node) {
699 		list_add(&async_desc->vd.node, &bchan->vc.desc_issued);
700 		list_del(&async_desc->desc_node);
701 	}
702 
703 	vchan_get_all_descriptors(&bchan->vc, &head);
704 	spin_unlock_irqrestore(&bchan->vc.lock, flag);
705 
706 	vchan_dma_desc_free_list(&bchan->vc, &head);
707 
708 	return 0;
709 }
710 
711 /**
712  * bam_pause - Pause DMA channel
713  * @chan: dma channel
714  *
715  */
716 static int bam_pause(struct dma_chan *chan)
717 {
718 	struct bam_chan *bchan = to_bam_chan(chan);
719 	struct bam_device *bdev = bchan->bdev;
720 	unsigned long flag;
721 	int ret;
722 
723 	ret = bam_pm_runtime_get_sync(bdev->dev);
724 	if (ret < 0)
725 		return ret;
726 
727 	spin_lock_irqsave(&bchan->vc.lock, flag);
728 	writel_relaxed(1, bam_addr(bdev, bchan->id, BAM_P_HALT));
729 	bchan->paused = 1;
730 	spin_unlock_irqrestore(&bchan->vc.lock, flag);
731 	pm_runtime_mark_last_busy(bdev->dev);
732 	pm_runtime_put_autosuspend(bdev->dev);
733 
734 	return 0;
735 }
736 
737 /**
738  * bam_resume - Resume DMA channel operations
739  * @chan: dma channel
740  *
741  */
742 static int bam_resume(struct dma_chan *chan)
743 {
744 	struct bam_chan *bchan = to_bam_chan(chan);
745 	struct bam_device *bdev = bchan->bdev;
746 	unsigned long flag;
747 	int ret;
748 
749 	ret = bam_pm_runtime_get_sync(bdev->dev);
750 	if (ret < 0)
751 		return ret;
752 
753 	spin_lock_irqsave(&bchan->vc.lock, flag);
754 	writel_relaxed(0, bam_addr(bdev, bchan->id, BAM_P_HALT));
755 	bchan->paused = 0;
756 	spin_unlock_irqrestore(&bchan->vc.lock, flag);
757 	pm_runtime_mark_last_busy(bdev->dev);
758 	pm_runtime_put_autosuspend(bdev->dev);
759 
760 	return 0;
761 }
762 
763 /**
764  * process_channel_irqs - processes the channel interrupts
765  * @bdev: bam controller
766  *
767  * This function processes the channel interrupts
768  *
769  */
770 static u32 process_channel_irqs(struct bam_device *bdev)
771 {
772 	u32 i, srcs, pipe_stts, offset, avail;
773 	unsigned long flags;
774 	struct bam_async_desc *async_desc, *tmp;
775 
776 	srcs = readl_relaxed(bam_addr(bdev, 0, BAM_IRQ_SRCS_EE));
777 
778 	/* return early if no pipe/channel interrupts are present */
779 	if (!(srcs & P_IRQ))
780 		return srcs;
781 
782 	for (i = 0; i < bdev->num_channels; i++) {
783 		struct bam_chan *bchan = &bdev->channels[i];
784 
785 		if (!(srcs & BIT(i)))
786 			continue;
787 
788 		/* clear pipe irq */
789 		pipe_stts = readl_relaxed(bam_addr(bdev, i, BAM_P_IRQ_STTS));
790 
791 		writel_relaxed(pipe_stts, bam_addr(bdev, i, BAM_P_IRQ_CLR));
792 
793 		spin_lock_irqsave(&bchan->vc.lock, flags);
794 
795 		offset = readl_relaxed(bam_addr(bdev, i, BAM_P_SW_OFSTS)) &
796 				       P_SW_OFSTS_MASK;
797 		offset /= sizeof(struct bam_desc_hw);
798 
799 		/* Number of bytes available to read */
800 		avail = CIRC_CNT(offset, bchan->head, MAX_DESCRIPTORS + 1);
801 
802 		list_for_each_entry_safe(async_desc, tmp,
803 					 &bchan->desc_list, desc_node) {
804 			/* Not enough data to read */
805 			if (avail < async_desc->xfer_len)
806 				break;
807 
808 			/* manage FIFO */
809 			bchan->head += async_desc->xfer_len;
810 			bchan->head %= MAX_DESCRIPTORS;
811 
812 			async_desc->num_desc -= async_desc->xfer_len;
813 			async_desc->curr_desc += async_desc->xfer_len;
814 			avail -= async_desc->xfer_len;
815 
816 			/*
817 			 * if complete, process cookie. Otherwise
818 			 * push back to front of desc_issued so that
819 			 * it gets restarted by the tasklet
820 			 */
821 			if (!async_desc->num_desc) {
822 				vchan_cookie_complete(&async_desc->vd);
823 			} else {
824 				list_add(&async_desc->vd.node,
825 					 &bchan->vc.desc_issued);
826 			}
827 			list_del(&async_desc->desc_node);
828 		}
829 
830 		spin_unlock_irqrestore(&bchan->vc.lock, flags);
831 	}
832 
833 	return srcs;
834 }
835 
836 /**
837  * bam_dma_irq - irq handler for bam controller
838  * @irq: IRQ of interrupt
839  * @data: callback data
840  *
841  * IRQ handler for the bam controller
842  */
843 static irqreturn_t bam_dma_irq(int irq, void *data)
844 {
845 	struct bam_device *bdev = data;
846 	u32 clr_mask = 0, srcs = 0;
847 	int ret;
848 
849 	srcs |= process_channel_irqs(bdev);
850 
851 	/* kick off tasklet to start next dma transfer */
852 	if (srcs & P_IRQ)
853 		tasklet_schedule(&bdev->task);
854 
855 	ret = bam_pm_runtime_get_sync(bdev->dev);
856 	if (ret < 0)
857 		return ret;
858 
859 	if (srcs & BAM_IRQ) {
860 		clr_mask = readl_relaxed(bam_addr(bdev, 0, BAM_IRQ_STTS));
861 
862 		/*
863 		 * don't allow reorder of the various accesses to the BAM
864 		 * registers
865 		 */
866 		mb();
867 
868 		writel_relaxed(clr_mask, bam_addr(bdev, 0, BAM_IRQ_CLR));
869 	}
870 
871 	pm_runtime_mark_last_busy(bdev->dev);
872 	pm_runtime_put_autosuspend(bdev->dev);
873 
874 	return IRQ_HANDLED;
875 }
876 
877 /**
878  * bam_tx_status - returns status of transaction
879  * @chan: dma channel
880  * @cookie: transaction cookie
881  * @txstate: DMA transaction state
882  *
883  * Return status of dma transaction
884  */
885 static enum dma_status bam_tx_status(struct dma_chan *chan, dma_cookie_t cookie,
886 		struct dma_tx_state *txstate)
887 {
888 	struct bam_chan *bchan = to_bam_chan(chan);
889 	struct bam_async_desc *async_desc;
890 	struct virt_dma_desc *vd;
891 	int ret;
892 	size_t residue = 0;
893 	unsigned int i;
894 	unsigned long flags;
895 
896 	ret = dma_cookie_status(chan, cookie, txstate);
897 	if (ret == DMA_COMPLETE)
898 		return ret;
899 
900 	if (!txstate)
901 		return bchan->paused ? DMA_PAUSED : ret;
902 
903 	spin_lock_irqsave(&bchan->vc.lock, flags);
904 	vd = vchan_find_desc(&bchan->vc, cookie);
905 	if (vd) {
906 		residue = container_of(vd, struct bam_async_desc, vd)->length;
907 	} else {
908 		list_for_each_entry(async_desc, &bchan->desc_list, desc_node) {
909 			if (async_desc->vd.tx.cookie != cookie)
910 				continue;
911 
912 			for (i = 0; i < async_desc->num_desc; i++)
913 				residue += le16_to_cpu(
914 						async_desc->curr_desc[i].size);
915 		}
916 	}
917 
918 	spin_unlock_irqrestore(&bchan->vc.lock, flags);
919 
920 	dma_set_residue(txstate, residue);
921 
922 	if (ret == DMA_IN_PROGRESS && bchan->paused)
923 		ret = DMA_PAUSED;
924 
925 	return ret;
926 }
927 
928 /**
929  * bam_apply_new_config
930  * @bchan: bam dma channel
931  * @dir: DMA direction
932  */
933 static void bam_apply_new_config(struct bam_chan *bchan,
934 	enum dma_transfer_direction dir)
935 {
936 	struct bam_device *bdev = bchan->bdev;
937 	u32 maxburst;
938 
939 	if (!bdev->controlled_remotely) {
940 		if (dir == DMA_DEV_TO_MEM)
941 			maxburst = bchan->slave.src_maxburst;
942 		else
943 			maxburst = bchan->slave.dst_maxburst;
944 
945 		writel_relaxed(maxburst,
946 			       bam_addr(bdev, 0, BAM_DESC_CNT_TRSHLD));
947 	}
948 
949 	bchan->reconfigure = 0;
950 }
951 
952 /**
953  * bam_start_dma - start next transaction
954  * @bchan: bam dma channel
955  */
956 static void bam_start_dma(struct bam_chan *bchan)
957 {
958 	struct virt_dma_desc *vd = vchan_next_desc(&bchan->vc);
959 	struct bam_device *bdev = bchan->bdev;
960 	struct bam_async_desc *async_desc = NULL;
961 	struct bam_desc_hw *desc;
962 	struct bam_desc_hw *fifo = PTR_ALIGN(bchan->fifo_virt,
963 					sizeof(struct bam_desc_hw));
964 	int ret;
965 	unsigned int avail;
966 	struct dmaengine_desc_callback cb;
967 
968 	lockdep_assert_held(&bchan->vc.lock);
969 
970 	if (!vd)
971 		return;
972 
973 	ret = bam_pm_runtime_get_sync(bdev->dev);
974 	if (ret < 0)
975 		return;
976 
977 	while (vd && !IS_BUSY(bchan)) {
978 		list_del(&vd->node);
979 
980 		async_desc = container_of(vd, struct bam_async_desc, vd);
981 
982 		/* on first use, initialize the channel hardware */
983 		if (!bchan->initialized)
984 			bam_chan_init_hw(bchan, async_desc->dir);
985 
986 		/* apply new slave config changes, if necessary */
987 		if (bchan->reconfigure)
988 			bam_apply_new_config(bchan, async_desc->dir);
989 
990 		desc = async_desc->curr_desc;
991 		avail = CIRC_SPACE(bchan->tail, bchan->head,
992 				   MAX_DESCRIPTORS + 1);
993 
994 		if (async_desc->num_desc > avail)
995 			async_desc->xfer_len = avail;
996 		else
997 			async_desc->xfer_len = async_desc->num_desc;
998 
999 		/* set any special flags on the last descriptor */
1000 		if (async_desc->num_desc == async_desc->xfer_len)
1001 			desc[async_desc->xfer_len - 1].flags |=
1002 						cpu_to_le16(async_desc->flags);
1003 
1004 		vd = vchan_next_desc(&bchan->vc);
1005 
1006 		dmaengine_desc_get_callback(&async_desc->vd.tx, &cb);
1007 
1008 		/*
1009 		 * An interrupt is generated at this desc, if
1010 		 *  - FIFO is FULL.
1011 		 *  - No more descriptors to add.
1012 		 *  - If a callback completion was requested for this DESC,
1013 		 *     In this case, BAM will deliver the completion callback
1014 		 *     for this desc and continue processing the next desc.
1015 		 */
1016 		if (((avail <= async_desc->xfer_len) || !vd ||
1017 		     dmaengine_desc_callback_valid(&cb)) &&
1018 		    !(async_desc->flags & DESC_FLAG_EOT))
1019 			desc[async_desc->xfer_len - 1].flags |=
1020 				cpu_to_le16(DESC_FLAG_INT);
1021 
1022 		if (bchan->tail + async_desc->xfer_len > MAX_DESCRIPTORS) {
1023 			u32 partial = MAX_DESCRIPTORS - bchan->tail;
1024 
1025 			memcpy(&fifo[bchan->tail], desc,
1026 			       partial * sizeof(struct bam_desc_hw));
1027 			memcpy(fifo, &desc[partial],
1028 			       (async_desc->xfer_len - partial) *
1029 				sizeof(struct bam_desc_hw));
1030 		} else {
1031 			memcpy(&fifo[bchan->tail], desc,
1032 			       async_desc->xfer_len *
1033 			       sizeof(struct bam_desc_hw));
1034 		}
1035 
1036 		bchan->tail += async_desc->xfer_len;
1037 		bchan->tail %= MAX_DESCRIPTORS;
1038 		list_add_tail(&async_desc->desc_node, &bchan->desc_list);
1039 	}
1040 
1041 	/* ensure descriptor writes and dma start not reordered */
1042 	wmb();
1043 	writel_relaxed(bchan->tail * sizeof(struct bam_desc_hw),
1044 			bam_addr(bdev, bchan->id, BAM_P_EVNT_REG));
1045 
1046 	pm_runtime_mark_last_busy(bdev->dev);
1047 	pm_runtime_put_autosuspend(bdev->dev);
1048 }
1049 
1050 /**
1051  * dma_tasklet - DMA IRQ tasklet
1052  * @data: tasklet argument (bam controller structure)
1053  *
1054  * Sets up next DMA operation and then processes all completed transactions
1055  */
1056 static void dma_tasklet(unsigned long data)
1057 {
1058 	struct bam_device *bdev = (struct bam_device *)data;
1059 	struct bam_chan *bchan;
1060 	unsigned long flags;
1061 	unsigned int i;
1062 
1063 	/* go through the channels and kick off transactions */
1064 	for (i = 0; i < bdev->num_channels; i++) {
1065 		bchan = &bdev->channels[i];
1066 		spin_lock_irqsave(&bchan->vc.lock, flags);
1067 
1068 		if (!list_empty(&bchan->vc.desc_issued) && !IS_BUSY(bchan))
1069 			bam_start_dma(bchan);
1070 		spin_unlock_irqrestore(&bchan->vc.lock, flags);
1071 	}
1072 
1073 }
1074 
1075 /**
1076  * bam_issue_pending - starts pending transactions
1077  * @chan: dma channel
1078  *
1079  * Calls tasklet directly which in turn starts any pending transactions
1080  */
1081 static void bam_issue_pending(struct dma_chan *chan)
1082 {
1083 	struct bam_chan *bchan = to_bam_chan(chan);
1084 	unsigned long flags;
1085 
1086 	spin_lock_irqsave(&bchan->vc.lock, flags);
1087 
1088 	/* if work pending and idle, start a transaction */
1089 	if (vchan_issue_pending(&bchan->vc) && !IS_BUSY(bchan))
1090 		bam_start_dma(bchan);
1091 
1092 	spin_unlock_irqrestore(&bchan->vc.lock, flags);
1093 }
1094 
1095 /**
1096  * bam_dma_free_desc - free descriptor memory
1097  * @vd: virtual descriptor
1098  *
1099  */
1100 static void bam_dma_free_desc(struct virt_dma_desc *vd)
1101 {
1102 	struct bam_async_desc *async_desc = container_of(vd,
1103 			struct bam_async_desc, vd);
1104 
1105 	kfree(async_desc);
1106 }
1107 
1108 static struct dma_chan *bam_dma_xlate(struct of_phandle_args *dma_spec,
1109 		struct of_dma *of)
1110 {
1111 	struct bam_device *bdev = container_of(of->of_dma_data,
1112 					struct bam_device, common);
1113 	unsigned int request;
1114 
1115 	if (dma_spec->args_count != 1)
1116 		return NULL;
1117 
1118 	request = dma_spec->args[0];
1119 	if (request >= bdev->num_channels)
1120 		return NULL;
1121 
1122 	return dma_get_slave_channel(&(bdev->channels[request].vc.chan));
1123 }
1124 
1125 /**
1126  * bam_init
1127  * @bdev: bam device
1128  *
1129  * Initialization helper for global bam registers
1130  */
1131 static int bam_init(struct bam_device *bdev)
1132 {
1133 	u32 val;
1134 
1135 	/* read revision and configuration information */
1136 	if (!bdev->num_ees) {
1137 		val = readl_relaxed(bam_addr(bdev, 0, BAM_REVISION));
1138 		bdev->num_ees = (val >> NUM_EES_SHIFT) & NUM_EES_MASK;
1139 	}
1140 
1141 	/* check that configured EE is within range */
1142 	if (bdev->ee >= bdev->num_ees)
1143 		return -EINVAL;
1144 
1145 	if (!bdev->num_channels) {
1146 		val = readl_relaxed(bam_addr(bdev, 0, BAM_NUM_PIPES));
1147 		bdev->num_channels = val & BAM_NUM_PIPES_MASK;
1148 	}
1149 
1150 	if (bdev->controlled_remotely)
1151 		return 0;
1152 
1153 	/* s/w reset bam */
1154 	/* after reset all pipes are disabled and idle */
1155 	val = readl_relaxed(bam_addr(bdev, 0, BAM_CTRL));
1156 	val |= BAM_SW_RST;
1157 	writel_relaxed(val, bam_addr(bdev, 0, BAM_CTRL));
1158 	val &= ~BAM_SW_RST;
1159 	writel_relaxed(val, bam_addr(bdev, 0, BAM_CTRL));
1160 
1161 	/* make sure previous stores are visible before enabling BAM */
1162 	wmb();
1163 
1164 	/* enable bam */
1165 	val |= BAM_EN;
1166 	writel_relaxed(val, bam_addr(bdev, 0, BAM_CTRL));
1167 
1168 	/* set descriptor threshhold, start with 4 bytes */
1169 	writel_relaxed(DEFAULT_CNT_THRSHLD,
1170 			bam_addr(bdev, 0, BAM_DESC_CNT_TRSHLD));
1171 
1172 	/* Enable default set of h/w workarounds, ie all except BAM_FULL_PIPE */
1173 	writel_relaxed(BAM_CNFG_BITS_DEFAULT, bam_addr(bdev, 0, BAM_CNFG_BITS));
1174 
1175 	/* enable irqs for errors */
1176 	writel_relaxed(BAM_ERROR_EN | BAM_HRESP_ERR_EN,
1177 			bam_addr(bdev, 0, BAM_IRQ_EN));
1178 
1179 	/* unmask global bam interrupt */
1180 	writel_relaxed(BAM_IRQ_MSK, bam_addr(bdev, 0, BAM_IRQ_SRCS_MSK_EE));
1181 
1182 	return 0;
1183 }
1184 
1185 static void bam_channel_init(struct bam_device *bdev, struct bam_chan *bchan,
1186 	u32 index)
1187 {
1188 	bchan->id = index;
1189 	bchan->bdev = bdev;
1190 
1191 	vchan_init(&bchan->vc, &bdev->common);
1192 	bchan->vc.desc_free = bam_dma_free_desc;
1193 	INIT_LIST_HEAD(&bchan->desc_list);
1194 }
1195 
1196 static const struct of_device_id bam_of_match[] = {
1197 	{ .compatible = "qcom,bam-v1.3.0", .data = &bam_v1_3_reg_info },
1198 	{ .compatible = "qcom,bam-v1.4.0", .data = &bam_v1_4_reg_info },
1199 	{ .compatible = "qcom,bam-v1.7.0", .data = &bam_v1_7_reg_info },
1200 	{}
1201 };
1202 
1203 MODULE_DEVICE_TABLE(of, bam_of_match);
1204 
1205 static int bam_dma_probe(struct platform_device *pdev)
1206 {
1207 	struct bam_device *bdev;
1208 	const struct of_device_id *match;
1209 	struct resource *iores;
1210 	int ret, i;
1211 
1212 	bdev = devm_kzalloc(&pdev->dev, sizeof(*bdev), GFP_KERNEL);
1213 	if (!bdev)
1214 		return -ENOMEM;
1215 
1216 	bdev->dev = &pdev->dev;
1217 
1218 	match = of_match_node(bam_of_match, pdev->dev.of_node);
1219 	if (!match) {
1220 		dev_err(&pdev->dev, "Unsupported BAM module\n");
1221 		return -ENODEV;
1222 	}
1223 
1224 	bdev->layout = match->data;
1225 
1226 	iores = platform_get_resource(pdev, IORESOURCE_MEM, 0);
1227 	bdev->regs = devm_ioremap_resource(&pdev->dev, iores);
1228 	if (IS_ERR(bdev->regs))
1229 		return PTR_ERR(bdev->regs);
1230 
1231 	bdev->irq = platform_get_irq(pdev, 0);
1232 	if (bdev->irq < 0)
1233 		return bdev->irq;
1234 
1235 	ret = of_property_read_u32(pdev->dev.of_node, "qcom,ee", &bdev->ee);
1236 	if (ret) {
1237 		dev_err(bdev->dev, "Execution environment unspecified\n");
1238 		return ret;
1239 	}
1240 
1241 	bdev->controlled_remotely = of_property_read_bool(pdev->dev.of_node,
1242 						"qcom,controlled-remotely");
1243 
1244 	if (bdev->controlled_remotely) {
1245 		ret = of_property_read_u32(pdev->dev.of_node, "num-channels",
1246 					   &bdev->num_channels);
1247 		if (ret)
1248 			dev_err(bdev->dev, "num-channels unspecified in dt\n");
1249 
1250 		ret = of_property_read_u32(pdev->dev.of_node, "qcom,num-ees",
1251 					   &bdev->num_ees);
1252 		if (ret)
1253 			dev_err(bdev->dev, "num-ees unspecified in dt\n");
1254 	}
1255 
1256 	bdev->bamclk = devm_clk_get(bdev->dev, "bam_clk");
1257 	if (IS_ERR(bdev->bamclk)) {
1258 		if (!bdev->controlled_remotely)
1259 			return PTR_ERR(bdev->bamclk);
1260 
1261 		bdev->bamclk = NULL;
1262 	}
1263 
1264 	ret = clk_prepare_enable(bdev->bamclk);
1265 	if (ret) {
1266 		dev_err(bdev->dev, "failed to prepare/enable clock\n");
1267 		return ret;
1268 	}
1269 
1270 	ret = bam_init(bdev);
1271 	if (ret)
1272 		goto err_disable_clk;
1273 
1274 	tasklet_init(&bdev->task, dma_tasklet, (unsigned long)bdev);
1275 
1276 	bdev->channels = devm_kcalloc(bdev->dev, bdev->num_channels,
1277 				sizeof(*bdev->channels), GFP_KERNEL);
1278 
1279 	if (!bdev->channels) {
1280 		ret = -ENOMEM;
1281 		goto err_tasklet_kill;
1282 	}
1283 
1284 	/* allocate and initialize channels */
1285 	INIT_LIST_HEAD(&bdev->common.channels);
1286 
1287 	for (i = 0; i < bdev->num_channels; i++)
1288 		bam_channel_init(bdev, &bdev->channels[i], i);
1289 
1290 	ret = devm_request_irq(bdev->dev, bdev->irq, bam_dma_irq,
1291 			IRQF_TRIGGER_HIGH, "bam_dma", bdev);
1292 	if (ret)
1293 		goto err_bam_channel_exit;
1294 
1295 	/* set max dma segment size */
1296 	bdev->common.dev = bdev->dev;
1297 	bdev->common.dev->dma_parms = &bdev->dma_parms;
1298 	ret = dma_set_max_seg_size(bdev->common.dev, BAM_FIFO_SIZE);
1299 	if (ret) {
1300 		dev_err(bdev->dev, "cannot set maximum segment size\n");
1301 		goto err_bam_channel_exit;
1302 	}
1303 
1304 	platform_set_drvdata(pdev, bdev);
1305 
1306 	/* set capabilities */
1307 	dma_cap_zero(bdev->common.cap_mask);
1308 	dma_cap_set(DMA_SLAVE, bdev->common.cap_mask);
1309 
1310 	/* initialize dmaengine apis */
1311 	bdev->common.directions = BIT(DMA_DEV_TO_MEM) | BIT(DMA_MEM_TO_DEV);
1312 	bdev->common.residue_granularity = DMA_RESIDUE_GRANULARITY_SEGMENT;
1313 	bdev->common.src_addr_widths = DMA_SLAVE_BUSWIDTH_4_BYTES;
1314 	bdev->common.dst_addr_widths = DMA_SLAVE_BUSWIDTH_4_BYTES;
1315 	bdev->common.device_alloc_chan_resources = bam_alloc_chan;
1316 	bdev->common.device_free_chan_resources = bam_free_chan;
1317 	bdev->common.device_prep_slave_sg = bam_prep_slave_sg;
1318 	bdev->common.device_config = bam_slave_config;
1319 	bdev->common.device_pause = bam_pause;
1320 	bdev->common.device_resume = bam_resume;
1321 	bdev->common.device_terminate_all = bam_dma_terminate_all;
1322 	bdev->common.device_issue_pending = bam_issue_pending;
1323 	bdev->common.device_tx_status = bam_tx_status;
1324 	bdev->common.dev = bdev->dev;
1325 
1326 	ret = dma_async_device_register(&bdev->common);
1327 	if (ret) {
1328 		dev_err(bdev->dev, "failed to register dma async device\n");
1329 		goto err_bam_channel_exit;
1330 	}
1331 
1332 	ret = of_dma_controller_register(pdev->dev.of_node, bam_dma_xlate,
1333 					&bdev->common);
1334 	if (ret)
1335 		goto err_unregister_dma;
1336 
1337 	if (bdev->controlled_remotely) {
1338 		pm_runtime_disable(&pdev->dev);
1339 		return 0;
1340 	}
1341 
1342 	pm_runtime_irq_safe(&pdev->dev);
1343 	pm_runtime_set_autosuspend_delay(&pdev->dev, BAM_DMA_AUTOSUSPEND_DELAY);
1344 	pm_runtime_use_autosuspend(&pdev->dev);
1345 	pm_runtime_mark_last_busy(&pdev->dev);
1346 	pm_runtime_set_active(&pdev->dev);
1347 	pm_runtime_enable(&pdev->dev);
1348 
1349 	return 0;
1350 
1351 err_unregister_dma:
1352 	dma_async_device_unregister(&bdev->common);
1353 err_bam_channel_exit:
1354 	for (i = 0; i < bdev->num_channels; i++)
1355 		tasklet_kill(&bdev->channels[i].vc.task);
1356 err_tasklet_kill:
1357 	tasklet_kill(&bdev->task);
1358 err_disable_clk:
1359 	clk_disable_unprepare(bdev->bamclk);
1360 
1361 	return ret;
1362 }
1363 
1364 static int bam_dma_remove(struct platform_device *pdev)
1365 {
1366 	struct bam_device *bdev = platform_get_drvdata(pdev);
1367 	u32 i;
1368 
1369 	pm_runtime_force_suspend(&pdev->dev);
1370 
1371 	of_dma_controller_free(pdev->dev.of_node);
1372 	dma_async_device_unregister(&bdev->common);
1373 
1374 	/* mask all interrupts for this execution environment */
1375 	writel_relaxed(0, bam_addr(bdev, 0,  BAM_IRQ_SRCS_MSK_EE));
1376 
1377 	devm_free_irq(bdev->dev, bdev->irq, bdev);
1378 
1379 	for (i = 0; i < bdev->num_channels; i++) {
1380 		bam_dma_terminate_all(&bdev->channels[i].vc.chan);
1381 		tasklet_kill(&bdev->channels[i].vc.task);
1382 
1383 		if (!bdev->channels[i].fifo_virt)
1384 			continue;
1385 
1386 		dma_free_wc(bdev->dev, BAM_DESC_FIFO_SIZE,
1387 			    bdev->channels[i].fifo_virt,
1388 			    bdev->channels[i].fifo_phys);
1389 	}
1390 
1391 	tasklet_kill(&bdev->task);
1392 
1393 	clk_disable_unprepare(bdev->bamclk);
1394 
1395 	return 0;
1396 }
1397 
1398 static int __maybe_unused bam_dma_runtime_suspend(struct device *dev)
1399 {
1400 	struct bam_device *bdev = dev_get_drvdata(dev);
1401 
1402 	clk_disable(bdev->bamclk);
1403 
1404 	return 0;
1405 }
1406 
1407 static int __maybe_unused bam_dma_runtime_resume(struct device *dev)
1408 {
1409 	struct bam_device *bdev = dev_get_drvdata(dev);
1410 	int ret;
1411 
1412 	ret = clk_enable(bdev->bamclk);
1413 	if (ret < 0) {
1414 		dev_err(dev, "clk_enable failed: %d\n", ret);
1415 		return ret;
1416 	}
1417 
1418 	return 0;
1419 }
1420 
1421 static int __maybe_unused bam_dma_suspend(struct device *dev)
1422 {
1423 	struct bam_device *bdev = dev_get_drvdata(dev);
1424 
1425 	if (!bdev->controlled_remotely)
1426 		pm_runtime_force_suspend(dev);
1427 
1428 	clk_unprepare(bdev->bamclk);
1429 
1430 	return 0;
1431 }
1432 
1433 static int __maybe_unused bam_dma_resume(struct device *dev)
1434 {
1435 	struct bam_device *bdev = dev_get_drvdata(dev);
1436 	int ret;
1437 
1438 	ret = clk_prepare(bdev->bamclk);
1439 	if (ret)
1440 		return ret;
1441 
1442 	if (!bdev->controlled_remotely)
1443 		pm_runtime_force_resume(dev);
1444 
1445 	return 0;
1446 }
1447 
1448 static const struct dev_pm_ops bam_dma_pm_ops = {
1449 	SET_LATE_SYSTEM_SLEEP_PM_OPS(bam_dma_suspend, bam_dma_resume)
1450 	SET_RUNTIME_PM_OPS(bam_dma_runtime_suspend, bam_dma_runtime_resume,
1451 				NULL)
1452 };
1453 
1454 static struct platform_driver bam_dma_driver = {
1455 	.probe = bam_dma_probe,
1456 	.remove = bam_dma_remove,
1457 	.driver = {
1458 		.name = "bam-dma-engine",
1459 		.pm = &bam_dma_pm_ops,
1460 		.of_match_table = bam_of_match,
1461 	},
1462 };
1463 
1464 module_platform_driver(bam_dma_driver);
1465 
1466 MODULE_AUTHOR("Andy Gross <agross@codeaurora.org>");
1467 MODULE_DESCRIPTION("QCOM BAM DMA engine driver");
1468 MODULE_LICENSE("GPL v2");
1469