1/* SPDX-License-Identifier: GPL-2.0-or-later */
2/*
3 * SiFive FU540 Platform DMA driver
4 * Copyright (C) 2019 SiFive
5 *
6 * Based partially on:
7 * - drivers/dma/fsl-edma.c
8 * - drivers/dma/dw-edma/
9 * - drivers/dma/pxa-dma.c
10 *
11 * See the following sources for further documentation:
12 * - Chapter 12 "Platform DMA Engine (PDMA)" of
13 *   SiFive FU540-C000 v1.0
14 *   https://static.dev.sifive.com/FU540-C000-v1.0.pdf
15 */
16#ifndef _SF_PDMA_H
17#define _SF_PDMA_H
18
19#include <linux/dmaengine.h>
20#include <linux/dma-direction.h>
21
22#include "../dmaengine.h"
23#include "../virt-dma.h"
24
25#define PDMA_MAX_NR_CH					4
26
27#define PDMA_BASE_ADDR					0x3000000
28#define PDMA_CHAN_OFFSET				0x1000
29
30/* Register Offset */
31#define PDMA_CTRL					0x000
32#define PDMA_XFER_TYPE					0x004
33#define PDMA_XFER_SIZE					0x008
34#define PDMA_DST_ADDR					0x010
35#define PDMA_SRC_ADDR					0x018
36#define PDMA_ACT_TYPE					0x104 /* Read-only */
37#define PDMA_REMAINING_BYTE				0x108 /* Read-only */
38#define PDMA_CUR_DST_ADDR				0x110 /* Read-only*/
39#define PDMA_CUR_SRC_ADDR				0x118 /* Read-only*/
40
41/* CTRL */
42#define PDMA_CLEAR_CTRL					0x0
43#define PDMA_CLAIM_MASK					GENMASK(0, 0)
44#define PDMA_RUN_MASK					GENMASK(1, 1)
45#define PDMA_ENABLE_DONE_INT_MASK			GENMASK(14, 14)
46#define PDMA_ENABLE_ERR_INT_MASK			GENMASK(15, 15)
47#define PDMA_DONE_STATUS_MASK				GENMASK(30, 30)
48#define PDMA_ERR_STATUS_MASK				GENMASK(31, 31)
49
50/* Transfer Type */
51#define PDMA_FULL_SPEED					0xFF000000
52#define PDMA_STRICT_ORDERING				BIT(3)
53
54/* Error Recovery */
55#define MAX_RETRY					1
56
57#define SF_PDMA_REG_BASE(ch)	(pdma->membase + (PDMA_CHAN_OFFSET * (ch)))
58
59struct pdma_regs {
60	/* read-write regs */
61	void __iomem *ctrl;		/* 4 bytes */
62
63	void __iomem *xfer_type;	/* 4 bytes */
64	void __iomem *xfer_size;	/* 8 bytes */
65	void __iomem *dst_addr;		/* 8 bytes */
66	void __iomem *src_addr;		/* 8 bytes */
67
68	/* read-only */
69	void __iomem *act_type;		/* 4 bytes */
70	void __iomem *residue;		/* 8 bytes */
71	void __iomem *cur_dst_addr;	/* 8 bytes */
72	void __iomem *cur_src_addr;	/* 8 bytes */
73};
74
75struct sf_pdma_desc {
76	u32				xfer_type;
77	u64				xfer_size;
78	u64				dst_addr;
79	u64				src_addr;
80	struct virt_dma_desc		vdesc;
81	struct sf_pdma_chan		*chan;
82	enum dma_transfer_direction	dirn;
83	struct dma_async_tx_descriptor *async_tx;
84};
85
86enum sf_pdma_pm_state {
87	RUNNING = 0,
88	SUSPENDED,
89};
90
91struct sf_pdma_chan {
92	struct virt_dma_chan		vchan;
93	enum dma_status			status;
94	enum sf_pdma_pm_state		pm_state;
95	u32				slave_id;
96	struct sf_pdma			*pdma;
97	struct sf_pdma_desc		*desc;
98	struct dma_slave_config		cfg;
99	u32				attr;
100	dma_addr_t			dma_dev_addr;
101	u32				dma_dev_size;
102	struct tasklet_struct		done_tasklet;
103	struct tasklet_struct		err_tasklet;
104	struct pdma_regs		regs;
105	spinlock_t			lock; /* protect chan data */
106	bool				xfer_err;
107	int				txirq;
108	int				errirq;
109	int				retries;
110};
111
112struct sf_pdma {
113	struct dma_device       dma_dev;
114	void __iomem            *membase;
115	void __iomem            *mappedbase;
116	u32			transfer_type;
117	u32			n_chans;
118	struct sf_pdma_chan	chans[] __counted_by(n_chans);
119};
120
121struct sf_pdma_driver_platdata {
122	u32 quirks;
123};
124
125#endif /* _SF_PDMA_H */
126