GNU Linux-libre 4.19.295-gnu1
[releases.git] / drivers / dma / dw-axi-dmac / dw-axi-dmac.h
1 // SPDX-License-Identifier:  GPL-2.0
2 // (C) 2017-2018 Synopsys, Inc. (www.synopsys.com)
3
4 /*
5  * Synopsys DesignWare AXI DMA Controller driver.
6  *
7  * Author: Eugeniy Paltsev <Eugeniy.Paltsev@synopsys.com>
8  */
9
10 #ifndef _AXI_DMA_PLATFORM_H
11 #define _AXI_DMA_PLATFORM_H
12
13 #include <linux/bitops.h>
14 #include <linux/clk.h>
15 #include <linux/device.h>
16 #include <linux/dmaengine.h>
17 #include <linux/types.h>
18
19 #include "../virt-dma.h"
20
21 #define DMAC_MAX_CHANNELS       8
22 #define DMAC_MAX_MASTERS        2
23 #define DMAC_MAX_BLK_SIZE       0x200000
24
25 struct dw_axi_dma_hcfg {
26         u32     nr_channels;
27         u32     nr_masters;
28         u32     m_data_width;
29         u32     block_size[DMAC_MAX_CHANNELS];
30         u32     priority[DMAC_MAX_CHANNELS];
31         /* maximum supported axi burst length */
32         u32     axi_rw_burst_len;
33         bool    restrict_axi_burst_len;
34 };
35
36 struct axi_dma_chan {
37         struct axi_dma_chip             *chip;
38         void __iomem                    *chan_regs;
39         u8                              id;
40         atomic_t                        descs_allocated;
41
42         struct virt_dma_chan            vc;
43
44         /* these other elements are all protected by vc.lock */
45         bool                            is_paused;
46 };
47
48 struct dw_axi_dma {
49         struct dma_device       dma;
50         struct dw_axi_dma_hcfg  *hdata;
51         struct dma_pool         *desc_pool;
52
53         /* channels */
54         struct axi_dma_chan     *chan;
55 };
56
57 struct axi_dma_chip {
58         struct device           *dev;
59         int                     irq;
60         void __iomem            *regs;
61         struct clk              *core_clk;
62         struct clk              *cfgr_clk;
63         struct dw_axi_dma       *dw;
64 };
65
66 /* LLI == Linked List Item */
67 struct __packed axi_dma_lli {
68         __le64          sar;
69         __le64          dar;
70         __le32          block_ts_lo;
71         __le32          block_ts_hi;
72         __le64          llp;
73         __le32          ctl_lo;
74         __le32          ctl_hi;
75         __le32          sstat;
76         __le32          dstat;
77         __le32          status_lo;
78         __le32          ststus_hi;
79         __le32          reserved_lo;
80         __le32          reserved_hi;
81 };
82
83 struct axi_dma_desc {
84         struct axi_dma_lli              lli;
85
86         struct virt_dma_desc            vd;
87         struct axi_dma_chan             *chan;
88         struct list_head                xfer_list;
89 };
90
91 static inline struct device *dchan2dev(struct dma_chan *dchan)
92 {
93         return &dchan->dev->device;
94 }
95
96 static inline struct device *chan2dev(struct axi_dma_chan *chan)
97 {
98         return &chan->vc.chan.dev->device;
99 }
100
101 static inline struct axi_dma_desc *vd_to_axi_desc(struct virt_dma_desc *vd)
102 {
103         return container_of(vd, struct axi_dma_desc, vd);
104 }
105
106 static inline struct axi_dma_chan *vc_to_axi_dma_chan(struct virt_dma_chan *vc)
107 {
108         return container_of(vc, struct axi_dma_chan, vc);
109 }
110
111 static inline struct axi_dma_chan *dchan_to_axi_dma_chan(struct dma_chan *dchan)
112 {
113         return vc_to_axi_dma_chan(to_virt_chan(dchan));
114 }
115
116
117 #define COMMON_REG_LEN          0x100
118 #define CHAN_REG_LEN            0x100
119
120 /* Common registers offset */
121 #define DMAC_ID                 0x000 /* R DMAC ID */
122 #define DMAC_COMPVER            0x008 /* R DMAC Component Version */
123 #define DMAC_CFG                0x010 /* R/W DMAC Configuration */
124 #define DMAC_CHEN               0x018 /* R/W DMAC Channel Enable */
125 #define DMAC_CHEN_L             0x018 /* R/W DMAC Channel Enable 00-31 */
126 #define DMAC_CHEN_H             0x01C /* R/W DMAC Channel Enable 32-63 */
127 #define DMAC_INTSTATUS          0x030 /* R DMAC Interrupt Status */
128 #define DMAC_COMMON_INTCLEAR    0x038 /* W DMAC Interrupt Clear */
129 #define DMAC_COMMON_INTSTATUS_ENA 0x040 /* R DMAC Interrupt Status Enable */
130 #define DMAC_COMMON_INTSIGNAL_ENA 0x048 /* R/W DMAC Interrupt Signal Enable */
131 #define DMAC_COMMON_INTSTATUS   0x050 /* R DMAC Interrupt Status */
132 #define DMAC_RESET              0x058 /* R DMAC Reset Register1 */
133
134 /* DMA channel registers offset */
135 #define CH_SAR                  0x000 /* R/W Chan Source Address */
136 #define CH_DAR                  0x008 /* R/W Chan Destination Address */
137 #define CH_BLOCK_TS             0x010 /* R/W Chan Block Transfer Size */
138 #define CH_CTL                  0x018 /* R/W Chan Control */
139 #define CH_CTL_L                0x018 /* R/W Chan Control 00-31 */
140 #define CH_CTL_H                0x01C /* R/W Chan Control 32-63 */
141 #define CH_CFG                  0x020 /* R/W Chan Configuration */
142 #define CH_CFG_L                0x020 /* R/W Chan Configuration 00-31 */
143 #define CH_CFG_H                0x024 /* R/W Chan Configuration 32-63 */
144 #define CH_LLP                  0x028 /* R/W Chan Linked List Pointer */
145 #define CH_STATUS               0x030 /* R Chan Status */
146 #define CH_SWHSSRC              0x038 /* R/W Chan SW Handshake Source */
147 #define CH_SWHSDST              0x040 /* R/W Chan SW Handshake Destination */
148 #define CH_BLK_TFR_RESUMEREQ    0x048 /* W Chan Block Transfer Resume Req */
149 #define CH_AXI_ID               0x050 /* R/W Chan AXI ID */
150 #define CH_AXI_QOS              0x058 /* R/W Chan AXI QOS */
151 #define CH_SSTAT                0x060 /* R Chan Source Status */
152 #define CH_DSTAT                0x068 /* R Chan Destination Status */
153 #define CH_SSTATAR              0x070 /* R/W Chan Source Status Fetch Addr */
154 #define CH_DSTATAR              0x078 /* R/W Chan Destination Status Fetch Addr */
155 #define CH_INTSTATUS_ENA        0x080 /* R/W Chan Interrupt Status Enable */
156 #define CH_INTSTATUS            0x088 /* R/W Chan Interrupt Status */
157 #define CH_INTSIGNAL_ENA        0x090 /* R/W Chan Interrupt Signal Enable */
158 #define CH_INTCLEAR             0x098 /* W Chan Interrupt Clear */
159
160
161 /* DMAC_CFG */
162 #define DMAC_EN_POS                     0
163 #define DMAC_EN_MASK                    BIT(DMAC_EN_POS)
164
165 #define INT_EN_POS                      1
166 #define INT_EN_MASK                     BIT(INT_EN_POS)
167
168 #define DMAC_CHAN_EN_SHIFT              0
169 #define DMAC_CHAN_EN_WE_SHIFT           8
170
171 #define DMAC_CHAN_SUSP_SHIFT            16
172 #define DMAC_CHAN_SUSP_WE_SHIFT         24
173
174 /* CH_CTL_H */
175 #define CH_CTL_H_ARLEN_EN               BIT(6)
176 #define CH_CTL_H_ARLEN_POS              7
177 #define CH_CTL_H_AWLEN_EN               BIT(15)
178 #define CH_CTL_H_AWLEN_POS              16
179
180 enum {
181         DWAXIDMAC_ARWLEN_1              = 0,
182         DWAXIDMAC_ARWLEN_2              = 1,
183         DWAXIDMAC_ARWLEN_4              = 3,
184         DWAXIDMAC_ARWLEN_8              = 7,
185         DWAXIDMAC_ARWLEN_16             = 15,
186         DWAXIDMAC_ARWLEN_32             = 31,
187         DWAXIDMAC_ARWLEN_64             = 63,
188         DWAXIDMAC_ARWLEN_128            = 127,
189         DWAXIDMAC_ARWLEN_256            = 255,
190         DWAXIDMAC_ARWLEN_MIN            = DWAXIDMAC_ARWLEN_1,
191         DWAXIDMAC_ARWLEN_MAX            = DWAXIDMAC_ARWLEN_256
192 };
193
194 #define CH_CTL_H_LLI_LAST               BIT(30)
195 #define CH_CTL_H_LLI_VALID              BIT(31)
196
197 /* CH_CTL_L */
198 #define CH_CTL_L_LAST_WRITE_EN          BIT(30)
199
200 #define CH_CTL_L_DST_MSIZE_POS          18
201 #define CH_CTL_L_SRC_MSIZE_POS          14
202
203 enum {
204         DWAXIDMAC_BURST_TRANS_LEN_1     = 0,
205         DWAXIDMAC_BURST_TRANS_LEN_4,
206         DWAXIDMAC_BURST_TRANS_LEN_8,
207         DWAXIDMAC_BURST_TRANS_LEN_16,
208         DWAXIDMAC_BURST_TRANS_LEN_32,
209         DWAXIDMAC_BURST_TRANS_LEN_64,
210         DWAXIDMAC_BURST_TRANS_LEN_128,
211         DWAXIDMAC_BURST_TRANS_LEN_256,
212         DWAXIDMAC_BURST_TRANS_LEN_512,
213         DWAXIDMAC_BURST_TRANS_LEN_1024
214 };
215
216 #define CH_CTL_L_DST_WIDTH_POS          11
217 #define CH_CTL_L_SRC_WIDTH_POS          8
218
219 #define CH_CTL_L_DST_INC_POS            6
220 #define CH_CTL_L_SRC_INC_POS            4
221 enum {
222         DWAXIDMAC_CH_CTL_L_INC          = 0,
223         DWAXIDMAC_CH_CTL_L_NOINC
224 };
225
226 #define CH_CTL_L_DST_MAST               BIT(2)
227 #define CH_CTL_L_SRC_MAST               BIT(0)
228
229 /* CH_CFG_H */
230 #define CH_CFG_H_PRIORITY_POS           17
231 #define CH_CFG_H_HS_SEL_DST_POS         4
232 #define CH_CFG_H_HS_SEL_SRC_POS         3
233 enum {
234         DWAXIDMAC_HS_SEL_HW             = 0,
235         DWAXIDMAC_HS_SEL_SW
236 };
237
238 #define CH_CFG_H_TT_FC_POS              0
239 enum {
240         DWAXIDMAC_TT_FC_MEM_TO_MEM_DMAC = 0,
241         DWAXIDMAC_TT_FC_MEM_TO_PER_DMAC,
242         DWAXIDMAC_TT_FC_PER_TO_MEM_DMAC,
243         DWAXIDMAC_TT_FC_PER_TO_PER_DMAC,
244         DWAXIDMAC_TT_FC_PER_TO_MEM_SRC,
245         DWAXIDMAC_TT_FC_PER_TO_PER_SRC,
246         DWAXIDMAC_TT_FC_MEM_TO_PER_DST,
247         DWAXIDMAC_TT_FC_PER_TO_PER_DST
248 };
249
250 /* CH_CFG_L */
251 #define CH_CFG_L_DST_MULTBLK_TYPE_POS   2
252 #define CH_CFG_L_SRC_MULTBLK_TYPE_POS   0
253 enum {
254         DWAXIDMAC_MBLK_TYPE_CONTIGUOUS  = 0,
255         DWAXIDMAC_MBLK_TYPE_RELOAD,
256         DWAXIDMAC_MBLK_TYPE_SHADOW_REG,
257         DWAXIDMAC_MBLK_TYPE_LL
258 };
259
260 /**
261  * DW AXI DMA channel interrupts
262  *
263  * @DWAXIDMAC_IRQ_NONE: Bitmask of no one interrupt
264  * @DWAXIDMAC_IRQ_BLOCK_TRF: Block transfer complete
265  * @DWAXIDMAC_IRQ_DMA_TRF: Dma transfer complete
266  * @DWAXIDMAC_IRQ_SRC_TRAN: Source transaction complete
267  * @DWAXIDMAC_IRQ_DST_TRAN: Destination transaction complete
268  * @DWAXIDMAC_IRQ_SRC_DEC_ERR: Source decode error
269  * @DWAXIDMAC_IRQ_DST_DEC_ERR: Destination decode error
270  * @DWAXIDMAC_IRQ_SRC_SLV_ERR: Source slave error
271  * @DWAXIDMAC_IRQ_DST_SLV_ERR: Destination slave error
272  * @DWAXIDMAC_IRQ_LLI_RD_DEC_ERR: LLI read decode error
273  * @DWAXIDMAC_IRQ_LLI_WR_DEC_ERR: LLI write decode error
274  * @DWAXIDMAC_IRQ_LLI_RD_SLV_ERR: LLI read slave error
275  * @DWAXIDMAC_IRQ_LLI_WR_SLV_ERR: LLI write slave error
276  * @DWAXIDMAC_IRQ_INVALID_ERR: LLI invalid error or Shadow register error
277  * @DWAXIDMAC_IRQ_MULTIBLKTYPE_ERR: Slave Interface Multiblock type error
278  * @DWAXIDMAC_IRQ_DEC_ERR: Slave Interface decode error
279  * @DWAXIDMAC_IRQ_WR2RO_ERR: Slave Interface write to read only error
280  * @DWAXIDMAC_IRQ_RD2RWO_ERR: Slave Interface read to write only error
281  * @DWAXIDMAC_IRQ_WRONCHEN_ERR: Slave Interface write to channel error
282  * @DWAXIDMAC_IRQ_SHADOWREG_ERR: Slave Interface shadow reg error
283  * @DWAXIDMAC_IRQ_WRONHOLD_ERR: Slave Interface hold error
284  * @DWAXIDMAC_IRQ_LOCK_CLEARED: Lock Cleared Status
285  * @DWAXIDMAC_IRQ_SRC_SUSPENDED: Source Suspended Status
286  * @DWAXIDMAC_IRQ_SUSPENDED: Channel Suspended Status
287  * @DWAXIDMAC_IRQ_DISABLED: Channel Disabled Status
288  * @DWAXIDMAC_IRQ_ABORTED: Channel Aborted Status
289  * @DWAXIDMAC_IRQ_ALL_ERR: Bitmask of all error interrupts
290  * @DWAXIDMAC_IRQ_ALL: Bitmask of all interrupts
291  */
292 enum {
293         DWAXIDMAC_IRQ_NONE              = 0,
294         DWAXIDMAC_IRQ_BLOCK_TRF         = BIT(0),
295         DWAXIDMAC_IRQ_DMA_TRF           = BIT(1),
296         DWAXIDMAC_IRQ_SRC_TRAN          = BIT(3),
297         DWAXIDMAC_IRQ_DST_TRAN          = BIT(4),
298         DWAXIDMAC_IRQ_SRC_DEC_ERR       = BIT(5),
299         DWAXIDMAC_IRQ_DST_DEC_ERR       = BIT(6),
300         DWAXIDMAC_IRQ_SRC_SLV_ERR       = BIT(7),
301         DWAXIDMAC_IRQ_DST_SLV_ERR       = BIT(8),
302         DWAXIDMAC_IRQ_LLI_RD_DEC_ERR    = BIT(9),
303         DWAXIDMAC_IRQ_LLI_WR_DEC_ERR    = BIT(10),
304         DWAXIDMAC_IRQ_LLI_RD_SLV_ERR    = BIT(11),
305         DWAXIDMAC_IRQ_LLI_WR_SLV_ERR    = BIT(12),
306         DWAXIDMAC_IRQ_INVALID_ERR       = BIT(13),
307         DWAXIDMAC_IRQ_MULTIBLKTYPE_ERR  = BIT(14),
308         DWAXIDMAC_IRQ_DEC_ERR           = BIT(16),
309         DWAXIDMAC_IRQ_WR2RO_ERR         = BIT(17),
310         DWAXIDMAC_IRQ_RD2RWO_ERR        = BIT(18),
311         DWAXIDMAC_IRQ_WRONCHEN_ERR      = BIT(19),
312         DWAXIDMAC_IRQ_SHADOWREG_ERR     = BIT(20),
313         DWAXIDMAC_IRQ_WRONHOLD_ERR      = BIT(21),
314         DWAXIDMAC_IRQ_LOCK_CLEARED      = BIT(27),
315         DWAXIDMAC_IRQ_SRC_SUSPENDED     = BIT(28),
316         DWAXIDMAC_IRQ_SUSPENDED         = BIT(29),
317         DWAXIDMAC_IRQ_DISABLED          = BIT(30),
318         DWAXIDMAC_IRQ_ABORTED           = BIT(31),
319         DWAXIDMAC_IRQ_ALL_ERR           = (GENMASK(21, 16) | GENMASK(14, 5)),
320         DWAXIDMAC_IRQ_ALL               = GENMASK(31, 0)
321 };
322
323 enum {
324         DWAXIDMAC_TRANS_WIDTH_8         = 0,
325         DWAXIDMAC_TRANS_WIDTH_16,
326         DWAXIDMAC_TRANS_WIDTH_32,
327         DWAXIDMAC_TRANS_WIDTH_64,
328         DWAXIDMAC_TRANS_WIDTH_128,
329         DWAXIDMAC_TRANS_WIDTH_256,
330         DWAXIDMAC_TRANS_WIDTH_512,
331         DWAXIDMAC_TRANS_WIDTH_MAX       = DWAXIDMAC_TRANS_WIDTH_512
332 };
333
334 #endif /* _AXI_DMA_PLATFORM_H */