xref: /freebsd/sys/dev/xilinx/axidma.h (revision 783d3ff6d7fae619db8a7990b8a6387de0c677b5)
1 /*-
2  * SPDX-License-Identifier: BSD-2-Clause
3  *
4  * Copyright (c) 2019 Ruslan Bukin <br@bsdpad.com>
5  *
6  * This software was developed by SRI International and the University of
7  * Cambridge Computer Laboratory (Department of Computer Science and
8  * Technology) under DARPA contract HR0011-18-C-0016 ("ECATS"), as part of the
9  * DARPA SSITH research programme.
10  *
11  * Redistribution and use in source and binary forms, with or without
12  * modification, are permitted provided that the following conditions
13  * are met:
14  * 1. Redistributions of source code must retain the above copyright
15  *    notice, this list of conditions and the following disclaimer.
16  * 2. Redistributions in binary form must reproduce the above copyright
17  *    notice, this list of conditions and the following disclaimer in the
18  *    documentation and/or other materials provided with the distribution.
19  *
20  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
21  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
24  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30  * SUCH DAMAGE.
31  */
32 
33 #ifndef _DEV_XILINX_AXIDMA_H_
34 #define _DEV_XILINX_AXIDMA_H_
35 
36 #define	AXI_DMACR(n)		(0x00 + 0x30 * (n)) /* DMA Control register */
37 #define	 DMACR_RS		(1 << 0) /* Run / Stop. */
38 #define	 DMACR_RESET		(1 << 2) /* Soft reset the AXI DMA core. */
39 #define	 DMACR_IOC_IRQEN	(1 << 12) /* Interrupt on Complete (IOC) Interrupt Enable. */
40 #define	 DMACR_DLY_IRQEN	(1 << 13) /* Interrupt on Delay Timer Interrupt Enable. */
41 #define	 DMACR_ERR_IRQEN	(1 << 14) /* Interrupt on Error Interrupt Enable. */
42 #define	AXI_DMASR(n)		(0x04 + 0x30 * (n)) /* DMA Status register */
43 #define	 DMASR_HALTED		(1 << 0)
44 #define	 DMASR_IDLE		(1 << 1)
45 #define	 DMASR_SGINCLD		(1 << 3) /* Scatter Gather Enabled */
46 #define	 DMASR_DMAINTERR	(1 << 4) /* DMA Internal Error. */
47 #define	 DMASR_DMASLVERR	(1 << 5) /* DMA Slave Error. */
48 #define	 DMASR_DMADECOREERR	(1 << 6) /* Decode Error. */
49 #define	 DMASR_SGINTERR		(1 << 8) /* Scatter Gather Internal Error. */
50 #define	 DMASR_SGSLVERR		(1 << 9) /* Scatter Gather Slave Error. */
51 #define	 DMASR_SGDECERR		(1 << 10) /* Scatter Gather Decode Error. */
52 #define	 DMASR_IOC_IRQ		(1 << 12) /* Interrupt on Complete. */
53 #define	 DMASR_DLY_IRQ		(1 << 13) /* Interrupt on Delay. */
54 #define	 DMASR_ERR_IRQ		(1 << 14) /* Interrupt on Error. */
55 #define	AXI_CURDESC(n)		(0x08 + 0x30 * (n)) /* Current Descriptor Pointer. Lower 32 bits of the address. */
56 #define	AXI_CURDESC_MSB(n)	(0x0C + 0x30 * (n)) /* Current Descriptor Pointer. Upper 32 bits of address. */
57 #define	AXI_TAILDESC(n)		(0x10 + 0x30 * (n)) /* Tail Descriptor Pointer. Lower 32 bits. */
58 #define	AXI_TAILDESC_MSB(n)	(0x14 + 0x30 * (n)) /* Tail Descriptor Pointer. Upper 32 bits of address. */
59 #define	AXI_SG_CTL		0x2C /* Scatter/Gather User and Cache */
60 
61 #define	AXIDMA_NCHANNELS	2
62 #define	AXIDMA_DESCS_NUM	512
63 #define	AXIDMA_TX_CHAN		0
64 #define	AXIDMA_RX_CHAN		1
65 
66 struct axidma_desc {
67 	uint32_t next;
68 	uint32_t reserved1;
69 	uint32_t phys;
70 	uint32_t reserved2;
71 	uint32_t reserved3;
72 	uint32_t reserved4;
73 	uint32_t control;
74 #define	BD_CONTROL_TXSOF	(1 << 27) /* Start of Frame. */
75 #define	BD_CONTROL_TXEOF	(1 << 26) /* End of Frame. */
76 #define	BD_CONTROL_LEN_S	0	/* Buffer Length. */
77 #define	BD_CONTROL_LEN_M	(0x3ffffff << BD_CONTROL_LEN_S)
78 	uint32_t status;
79 #define	BD_STATUS_CMPLT		(1 << 31)
80 #define	BD_STATUS_TRANSFERRED_S	0
81 #define	BD_STATUS_TRANSFERRED_M	(0x7fffff << BD_STATUS_TRANSFERRED_S)
82 	uint32_t app0;
83 	uint32_t app1;
84 	uint32_t app2;
85 	uint32_t app3;
86 	uint32_t app4;
87 	uint32_t reserved[3];
88 };
89 
90 struct axidma_fdt_data {
91 	int id;
92 };
93 
94 #endif /* !_DEV_XILINX_AXIDMA_H_ */
95