xref: /linux/drivers/net/ethernet/stmicro/stmmac/descs.h (revision c532de5a67a70f8533d495f8f2aaa9a0491c3ad0)
1 /* SPDX-License-Identifier: GPL-2.0-only */
2 /*******************************************************************************
3   Header File to describe the DMA descriptors and related definitions.
4   This is for DWMAC100 and 1000 cores.
5 
6 
7   Author: Giuseppe Cavallaro <peppe.cavallaro@st.com>
8 *******************************************************************************/
9 
10 #ifndef __DESCS_H__
11 #define __DESCS_H__
12 
13 #include <linux/bitops.h>
14 
15 /* Normal receive descriptor defines */
16 
17 /* RDES0 */
18 #define	RDES0_PAYLOAD_CSUM_ERR	BIT(0)
19 #define	RDES0_CRC_ERROR		BIT(1)
20 #define	RDES0_DRIBBLING		BIT(2)
21 #define	RDES0_MII_ERROR		BIT(3)
22 #define	RDES0_RECEIVE_WATCHDOG	BIT(4)
23 #define	RDES0_FRAME_TYPE	BIT(5)
24 #define	RDES0_COLLISION		BIT(6)
25 #define	RDES0_IPC_CSUM_ERROR	BIT(7)
26 #define	RDES0_LAST_DESCRIPTOR	BIT(8)
27 #define	RDES0_FIRST_DESCRIPTOR	BIT(9)
28 #define	RDES0_VLAN_TAG		BIT(10)
29 #define	RDES0_OVERFLOW_ERROR	BIT(11)
30 #define	RDES0_LENGTH_ERROR	BIT(12)
31 #define	RDES0_SA_FILTER_FAIL	BIT(13)
32 #define	RDES0_DESCRIPTOR_ERROR	BIT(14)
33 #define	RDES0_ERROR_SUMMARY	BIT(15)
34 #define	RDES0_FRAME_LEN_MASK	GENMASK(29, 16)
35 #define RDES0_FRAME_LEN_SHIFT	16
36 #define	RDES0_DA_FILTER_FAIL	BIT(30)
37 #define	RDES0_OWN		BIT(31)
38 			/* RDES1 */
39 #define	RDES1_BUFFER1_SIZE_MASK		GENMASK(10, 0)
40 #define	RDES1_BUFFER2_SIZE_MASK		GENMASK(21, 11)
41 #define	RDES1_BUFFER2_SIZE_SHIFT	11
42 #define	RDES1_SECOND_ADDRESS_CHAINED	BIT(24)
43 #define	RDES1_END_RING			BIT(25)
44 #define	RDES1_DISABLE_IC		BIT(31)
45 
46 /* Enhanced receive descriptor defines */
47 
48 /* RDES0 (similar to normal RDES) */
49 #define	 ERDES0_RX_MAC_ADDR	BIT(0)
50 
51 /* RDES1: completely differ from normal desc definitions */
52 #define	ERDES1_BUFFER1_SIZE_MASK	GENMASK(12, 0)
53 #define	ERDES1_SECOND_ADDRESS_CHAINED	BIT(14)
54 #define	ERDES1_END_RING			BIT(15)
55 #define	ERDES1_BUFFER2_SIZE_MASK	GENMASK(28, 16)
56 #define ERDES1_BUFFER2_SIZE_SHIFT	16
57 #define	ERDES1_DISABLE_IC		BIT(31)
58 
59 /* Normal transmit descriptor defines */
60 /* TDES0 */
61 #define	TDES0_DEFERRED			BIT(0)
62 #define	TDES0_UNDERFLOW_ERROR		BIT(1)
63 #define	TDES0_EXCESSIVE_DEFERRAL	BIT(2)
64 #define	TDES0_COLLISION_COUNT_MASK	GENMASK(6, 3)
65 #define	TDES0_VLAN_FRAME		BIT(7)
66 #define	TDES0_EXCESSIVE_COLLISIONS	BIT(8)
67 #define	TDES0_LATE_COLLISION		BIT(9)
68 #define	TDES0_NO_CARRIER		BIT(10)
69 #define	TDES0_LOSS_CARRIER		BIT(11)
70 #define	TDES0_PAYLOAD_ERROR		BIT(12)
71 #define	TDES0_FRAME_FLUSHED		BIT(13)
72 #define	TDES0_JABBER_TIMEOUT		BIT(14)
73 #define	TDES0_ERROR_SUMMARY		BIT(15)
74 #define	TDES0_IP_HEADER_ERROR		BIT(16)
75 #define	TDES0_TIME_STAMP_STATUS		BIT(17)
76 #define	TDES0_OWN			((u32)BIT(31))	/* silence sparse */
77 /* TDES1 */
78 #define	TDES1_BUFFER1_SIZE_MASK		GENMASK(10, 0)
79 #define	TDES1_BUFFER2_SIZE_MASK		GENMASK(21, 11)
80 #define	TDES1_BUFFER2_SIZE_SHIFT	11
81 #define	TDES1_TIME_STAMP_ENABLE		BIT(22)
82 #define	TDES1_DISABLE_PADDING		BIT(23)
83 #define	TDES1_SECOND_ADDRESS_CHAINED	BIT(24)
84 #define	TDES1_END_RING			BIT(25)
85 #define	TDES1_CRC_DISABLE		BIT(26)
86 #define	TDES1_CHECKSUM_INSERTION_MASK	GENMASK(28, 27)
87 #define	TDES1_CHECKSUM_INSERTION_SHIFT	27
88 #define	TDES1_FIRST_SEGMENT		BIT(29)
89 #define	TDES1_LAST_SEGMENT		BIT(30)
90 #define	TDES1_INTERRUPT			BIT(31)
91 
92 /* Enhanced transmit descriptor defines */
93 /* TDES0 */
94 #define	ETDES0_DEFERRED			BIT(0)
95 #define	ETDES0_UNDERFLOW_ERROR		BIT(1)
96 #define	ETDES0_EXCESSIVE_DEFERRAL	BIT(2)
97 #define	ETDES0_COLLISION_COUNT_MASK	GENMASK(6, 3)
98 #define	ETDES0_VLAN_FRAME		BIT(7)
99 #define	ETDES0_EXCESSIVE_COLLISIONS	BIT(8)
100 #define	ETDES0_LATE_COLLISION		BIT(9)
101 #define	ETDES0_NO_CARRIER		BIT(10)
102 #define	ETDES0_LOSS_CARRIER		BIT(11)
103 #define	ETDES0_PAYLOAD_ERROR		BIT(12)
104 #define	ETDES0_FRAME_FLUSHED		BIT(13)
105 #define	ETDES0_JABBER_TIMEOUT		BIT(14)
106 #define	ETDES0_ERROR_SUMMARY		BIT(15)
107 #define	ETDES0_IP_HEADER_ERROR		BIT(16)
108 #define	ETDES0_TIME_STAMP_STATUS	BIT(17)
109 #define	ETDES0_SECOND_ADDRESS_CHAINED	BIT(20)
110 #define	ETDES0_END_RING			BIT(21)
111 #define	ETDES0_CHECKSUM_INSERTION_MASK	GENMASK(23, 22)
112 #define	ETDES0_CHECKSUM_INSERTION_SHIFT	22
113 #define	ETDES0_TIME_STAMP_ENABLE	BIT(25)
114 #define	ETDES0_DISABLE_PADDING		BIT(26)
115 #define	ETDES0_CRC_DISABLE		BIT(27)
116 #define	ETDES0_FIRST_SEGMENT		BIT(28)
117 #define	ETDES0_LAST_SEGMENT		BIT(29)
118 #define	ETDES0_INTERRUPT		BIT(30)
119 #define	ETDES0_OWN			((u32)BIT(31))	/* silence sparse */
120 /* TDES1 */
121 #define	ETDES1_BUFFER1_SIZE_MASK	GENMASK(12, 0)
122 #define	ETDES1_BUFFER2_SIZE_MASK	GENMASK(28, 16)
123 #define	ETDES1_BUFFER2_SIZE_SHIFT	16
124 
125 /* Extended Receive descriptor definitions */
126 #define	ERDES4_IP_PAYLOAD_TYPE_MASK	GENMASK(6, 2)
127 #define	ERDES4_IP_HDR_ERR		BIT(3)
128 #define	ERDES4_IP_PAYLOAD_ERR		BIT(4)
129 #define	ERDES4_IP_CSUM_BYPASSED		BIT(5)
130 #define	ERDES4_IPV4_PKT_RCVD		BIT(6)
131 #define	ERDES4_IPV6_PKT_RCVD		BIT(7)
132 #define	ERDES4_MSG_TYPE_MASK		GENMASK(11, 8)
133 #define	ERDES4_PTP_FRAME_TYPE		BIT(12)
134 #define	ERDES4_PTP_VER			BIT(13)
135 #define	ERDES4_TIMESTAMP_DROPPED	BIT(14)
136 #define	ERDES4_AV_PKT_RCVD		BIT(16)
137 #define	ERDES4_AV_TAGGED_PKT_RCVD	BIT(17)
138 #define	ERDES4_VLAN_TAG_PRI_VAL_MASK	GENMASK(20, 18)
139 #define	ERDES4_L3_FILTER_MATCH		BIT(24)
140 #define	ERDES4_L4_FILTER_MATCH		BIT(25)
141 #define	ERDES4_L3_L4_FILT_NO_MATCH_MASK	GENMASK(27, 26)
142 
143 /* Extended RDES4 message type definitions */
144 #define RDES_EXT_NO_PTP			0x0
145 #define RDES_EXT_SYNC			0x1
146 #define RDES_EXT_FOLLOW_UP		0x2
147 #define RDES_EXT_DELAY_REQ		0x3
148 #define RDES_EXT_DELAY_RESP		0x4
149 #define RDES_EXT_PDELAY_REQ		0x5
150 #define RDES_EXT_PDELAY_RESP		0x6
151 #define RDES_EXT_PDELAY_FOLLOW_UP	0x7
152 #define RDES_PTP_ANNOUNCE		0x8
153 #define RDES_PTP_MANAGEMENT		0x9
154 #define RDES_PTP_SIGNALING		0xa
155 #define RDES_PTP_PKT_RESERVED_TYPE	0xf
156 
157 /* Basic descriptor structure for normal and alternate descriptors */
158 struct dma_desc {
159 	__le32 des0;
160 	__le32 des1;
161 	__le32 des2;
162 	__le32 des3;
163 };
164 
165 /* Extended descriptor structure (e.g. >= databook 3.50a) */
166 struct dma_extended_desc {
167 	struct dma_desc basic;	/* Basic descriptors */
168 	__le32 des4;	/* Extended Status */
169 	__le32 des5;	/* Reserved */
170 	__le32 des6;	/* Tx/Rx Timestamp Low */
171 	__le32 des7;	/* Tx/Rx Timestamp High */
172 };
173 
174 /* Enhanced descriptor for TBS */
175 struct dma_edesc {
176 	__le32 des4;
177 	__le32 des5;
178 	__le32 des6;
179 	__le32 des7;
180 	struct dma_desc basic;
181 };
182 
183 /* Transmit checksum insertion control */
184 #define	TX_CIC_FULL	3	/* Include IP header and pseudoheader */
185 
186 #endif /* __DESCS_H__ */
187