1/* SPDX-License-Identifier: GPL-2.0-or-later */
2/*
3 * Actions Semi Owl SoCs Ethernet MAC driver
4 *
5 * Copyright (c) 2012 Actions Semi Inc.
6 * Copyright (c) 2021 Cristian Ciocaltea <cristian.ciocaltea@gmail.com>
7 */
8
9#ifndef __OWL_EMAC_H__
10#define __OWL_EMAC_H__
11
12#define OWL_EMAC_DRVNAME			"owl-emac"
13
14#define OWL_EMAC_POLL_DELAY_USEC		5
15#define OWL_EMAC_MDIO_POLL_TIMEOUT_USEC		1000
16#define OWL_EMAC_RESET_POLL_TIMEOUT_USEC	2000
17#define OWL_EMAC_TX_TIMEOUT			(2 * HZ)
18
19#define OWL_EMAC_MTU_MIN			ETH_MIN_MTU
20#define OWL_EMAC_MTU_MAX			ETH_DATA_LEN
21#define OWL_EMAC_RX_FRAME_MAX_LEN		(ETH_FRAME_LEN + ETH_FCS_LEN)
22#define OWL_EMAC_SKB_ALIGN			4
23#define OWL_EMAC_SKB_RESERVE			18
24
25#define OWL_EMAC_MAX_MULTICAST_ADDRS		14
26#define OWL_EMAC_SETUP_FRAME_LEN		192
27
28#define OWL_EMAC_RX_RING_SIZE			64
29#define OWL_EMAC_TX_RING_SIZE			32
30
31/* Bus mode register */
32#define OWL_EMAC_REG_MAC_CSR0			0x0000
33#define OWL_EMAC_BIT_MAC_CSR0_SWR		BIT(0)	/* Software reset */
34
35/* Transmit/receive poll demand registers */
36#define OWL_EMAC_REG_MAC_CSR1			0x0008
37#define OWL_EMAC_VAL_MAC_CSR1_TPD		0x01
38#define OWL_EMAC_REG_MAC_CSR2			0x0010
39#define OWL_EMAC_VAL_MAC_CSR2_RPD		0x01
40
41/* Receive/transmit descriptor list base address registers */
42#define OWL_EMAC_REG_MAC_CSR3			0x0018
43#define OWL_EMAC_REG_MAC_CSR4			0x0020
44
45/* Status register */
46#define OWL_EMAC_REG_MAC_CSR5			0x0028
47#define OWL_EMAC_MSK_MAC_CSR5_TS		GENMASK(22, 20)	/* Transmit process state */
48#define OWL_EMAC_OFF_MAC_CSR5_TS		20
49#define OWL_EMAC_VAL_MAC_CSR5_TS_DATA		0x03	/* Transferring data HOST -> FIFO */
50#define OWL_EMAC_VAL_MAC_CSR5_TS_CDES		0x07	/* Closing transmit descriptor */
51#define OWL_EMAC_MSK_MAC_CSR5_RS		GENMASK(19, 17)	/* Receive process state */
52#define OWL_EMAC_OFF_MAC_CSR5_RS		17
53#define OWL_EMAC_VAL_MAC_CSR5_RS_FDES		0x01	/* Fetching receive descriptor */
54#define OWL_EMAC_VAL_MAC_CSR5_RS_CDES		0x05	/* Closing receive descriptor */
55#define OWL_EMAC_VAL_MAC_CSR5_RS_DATA		0x07	/* Transferring data FIFO -> HOST */
56#define OWL_EMAC_BIT_MAC_CSR5_NIS		BIT(16)	/* Normal interrupt summary */
57#define OWL_EMAC_BIT_MAC_CSR5_AIS		BIT(15)	/* Abnormal interrupt summary */
58#define OWL_EMAC_BIT_MAC_CSR5_ERI		BIT(14)	/* Early receive interrupt */
59#define OWL_EMAC_BIT_MAC_CSR5_GTE		BIT(11)	/* General-purpose timer expiration */
60#define OWL_EMAC_BIT_MAC_CSR5_ETI		BIT(10)	/* Early transmit interrupt */
61#define OWL_EMAC_BIT_MAC_CSR5_RPS		BIT(8)	/* Receive process stopped */
62#define OWL_EMAC_BIT_MAC_CSR5_RU		BIT(7)	/* Receive buffer unavailable */
63#define OWL_EMAC_BIT_MAC_CSR5_RI		BIT(6)	/* Receive interrupt */
64#define OWL_EMAC_BIT_MAC_CSR5_UNF		BIT(5)	/* Transmit underflow */
65#define OWL_EMAC_BIT_MAC_CSR5_LCIS		BIT(4)	/* Link change status */
66#define OWL_EMAC_BIT_MAC_CSR5_LCIQ		BIT(3)	/* Link change interrupt */
67#define OWL_EMAC_BIT_MAC_CSR5_TU		BIT(2)	/* Transmit buffer unavailable */
68#define OWL_EMAC_BIT_MAC_CSR5_TPS		BIT(1)	/* Transmit process stopped */
69#define OWL_EMAC_BIT_MAC_CSR5_TI		BIT(0)	/* Transmit interrupt */
70
71/* Operation mode register */
72#define OWL_EMAC_REG_MAC_CSR6			0x0030
73#define OWL_EMAC_BIT_MAC_CSR6_RA		BIT(30)	/* Receive all */
74#define OWL_EMAC_BIT_MAC_CSR6_TTM		BIT(22)	/* Transmit threshold mode */
75#define OWL_EMAC_BIT_MAC_CSR6_SF		BIT(21)	/* Store and forward */
76#define OWL_EMAC_MSK_MAC_CSR6_SPEED		GENMASK(17, 16)	/* Eth speed selection */
77#define OWL_EMAC_OFF_MAC_CSR6_SPEED		16
78#define OWL_EMAC_VAL_MAC_CSR6_SPEED_100M	0x00
79#define OWL_EMAC_VAL_MAC_CSR6_SPEED_10M		0x02
80#define OWL_EMAC_BIT_MAC_CSR6_ST		BIT(13)	/* Start/stop transmit command */
81#define OWL_EMAC_BIT_MAC_CSR6_LP		BIT(10)	/* Loopback mode */
82#define OWL_EMAC_BIT_MAC_CSR6_FD		BIT(9)	/* Full duplex mode */
83#define OWL_EMAC_BIT_MAC_CSR6_PM		BIT(7)	/* Pass all multicast */
84#define OWL_EMAC_BIT_MAC_CSR6_PR		BIT(6)	/* Promiscuous mode */
85#define OWL_EMAC_BIT_MAC_CSR6_IF		BIT(4)	/* Inverse filtering */
86#define OWL_EMAC_BIT_MAC_CSR6_PB		BIT(3)	/* Pass bad frames */
87#define OWL_EMAC_BIT_MAC_CSR6_HO		BIT(2)	/* Hash only filtering mode */
88#define OWL_EMAC_BIT_MAC_CSR6_SR		BIT(1)	/* Start/stop receive command */
89#define OWL_EMAC_BIT_MAC_CSR6_HP		BIT(0)	/* Hash/perfect receive filtering mode */
90#define OWL_EMAC_MSK_MAC_CSR6_STSR	       (OWL_EMAC_BIT_MAC_CSR6_ST | \
91						OWL_EMAC_BIT_MAC_CSR6_SR)
92
93/* Interrupt enable register */
94#define OWL_EMAC_REG_MAC_CSR7			0x0038
95#define OWL_EMAC_BIT_MAC_CSR7_NIE		BIT(16)	/* Normal interrupt summary enable */
96#define OWL_EMAC_BIT_MAC_CSR7_AIE		BIT(15)	/* Abnormal interrupt summary enable */
97#define OWL_EMAC_BIT_MAC_CSR7_ERE		BIT(14)	/* Early receive interrupt enable */
98#define OWL_EMAC_BIT_MAC_CSR7_GTE		BIT(11)	/* General-purpose timer overflow */
99#define OWL_EMAC_BIT_MAC_CSR7_ETE		BIT(10)	/* Early transmit interrupt enable */
100#define OWL_EMAC_BIT_MAC_CSR7_RSE		BIT(8)	/* Receive stopped enable */
101#define OWL_EMAC_BIT_MAC_CSR7_RUE		BIT(7)	/* Receive buffer unavailable enable */
102#define OWL_EMAC_BIT_MAC_CSR7_RIE		BIT(6)	/* Receive interrupt enable */
103#define OWL_EMAC_BIT_MAC_CSR7_UNE		BIT(5)	/* Underflow interrupt enable */
104#define OWL_EMAC_BIT_MAC_CSR7_TUE		BIT(2)	/* Transmit buffer unavailable enable */
105#define OWL_EMAC_BIT_MAC_CSR7_TSE		BIT(1)	/* Transmit stopped enable */
106#define OWL_EMAC_BIT_MAC_CSR7_TIE		BIT(0)	/* Transmit interrupt enable */
107#define OWL_EMAC_BIT_MAC_CSR7_ALL_NOT_TUE      (OWL_EMAC_BIT_MAC_CSR7_ERE | \
108						OWL_EMAC_BIT_MAC_CSR7_GTE | \
109						OWL_EMAC_BIT_MAC_CSR7_ETE | \
110						OWL_EMAC_BIT_MAC_CSR7_RSE | \
111						OWL_EMAC_BIT_MAC_CSR7_RUE | \
112						OWL_EMAC_BIT_MAC_CSR7_RIE | \
113						OWL_EMAC_BIT_MAC_CSR7_UNE | \
114						OWL_EMAC_BIT_MAC_CSR7_TSE | \
115						OWL_EMAC_BIT_MAC_CSR7_TIE)
116
117/* Missed frames and overflow counter register */
118#define OWL_EMAC_REG_MAC_CSR8			0x0040
119/* MII management and serial ROM register */
120#define OWL_EMAC_REG_MAC_CSR9			0x0048
121
122/* MII serial management register */
123#define OWL_EMAC_REG_MAC_CSR10			0x0050
124#define OWL_EMAC_BIT_MAC_CSR10_SB		BIT(31)	/* Start transfer or busy */
125#define OWL_EMAC_MSK_MAC_CSR10_CLKDIV		GENMASK(30, 28)	/* Clock divider */
126#define OWL_EMAC_OFF_MAC_CSR10_CLKDIV		28
127#define OWL_EMAC_VAL_MAC_CSR10_CLKDIV_128	0x04
128#define OWL_EMAC_VAL_MAC_CSR10_OPCODE_WR	0x01	/* Register write command */
129#define OWL_EMAC_OFF_MAC_CSR10_OPCODE		26	/* Operation mode */
130#define OWL_EMAC_VAL_MAC_CSR10_OPCODE_DCG	0x00	/* Disable clock generation */
131#define OWL_EMAC_VAL_MAC_CSR10_OPCODE_WR	0x01	/* Register write command */
132#define OWL_EMAC_VAL_MAC_CSR10_OPCODE_RD	0x02	/* Register read command */
133#define OWL_EMAC_VAL_MAC_CSR10_OPCODE_CDS	0x03	/* Clock divider set */
134#define OWL_EMAC_MSK_MAC_CSR10_PHYADD		GENMASK(25, 21)	/* Physical layer address */
135#define OWL_EMAC_OFF_MAC_CSR10_PHYADD		21
136#define OWL_EMAC_MSK_MAC_CSR10_REGADD		GENMASK(20, 16)	/* Register address */
137#define OWL_EMAC_OFF_MAC_CSR10_REGADD		16
138#define OWL_EMAC_MSK_MAC_CSR10_DATA		GENMASK(15, 0)	/* Register data */
139
140/* General-purpose timer and interrupt mitigation control register */
141#define OWL_EMAC_REG_MAC_CSR11			0x0058
142#define OWL_EMAC_OFF_MAC_CSR11_TT		27	/* Transmit timer */
143#define OWL_EMAC_OFF_MAC_CSR11_NTP		24	/* No. of transmit packets */
144#define OWL_EMAC_OFF_MAC_CSR11_RT		20	/* Receive timer */
145#define OWL_EMAC_OFF_MAC_CSR11_NRP		17	/* No. of receive packets */
146
147/* MAC address low/high registers */
148#define OWL_EMAC_REG_MAC_CSR16			0x0080
149#define OWL_EMAC_REG_MAC_CSR17			0x0088
150
151/* Pause time & cache thresholds register */
152#define OWL_EMAC_REG_MAC_CSR18			0x0090
153#define OWL_EMAC_OFF_MAC_CSR18_CPTL		24	/* Cache pause threshold level */
154#define OWL_EMAC_OFF_MAC_CSR18_CRTL		16	/* Cache restart threshold level */
155#define OWL_EMAC_OFF_MAC_CSR18_PQT		0	/* Flow control pause quanta time */
156
157/* FIFO pause & restart threshold register */
158#define OWL_EMAC_REG_MAC_CSR19			0x0098
159#define OWL_EMAC_OFF_MAC_CSR19_FPTL		16	/* FIFO pause threshold level */
160#define OWL_EMAC_OFF_MAC_CSR19_FRTL		0	/* FIFO restart threshold level */
161
162/* Flow control setup & status register */
163#define OWL_EMAC_REG_MAC_CSR20			0x00A0
164#define OWL_EMAC_BIT_MAC_CSR20_FCE		BIT(31)	/* Flow Control Enable */
165#define OWL_EMAC_BIT_MAC_CSR20_TUE		BIT(30)	/* Transmit Un-pause frames Enable */
166#define OWL_EMAC_BIT_MAC_CSR20_TPE		BIT(29)	/* Transmit Pause frames Enable */
167#define OWL_EMAC_BIT_MAC_CSR20_RPE		BIT(28)	/* Receive Pause frames Enable */
168#define OWL_EMAC_BIT_MAC_CSR20_BPE		BIT(27)	/* Back pressure (half-duplex) Enable */
169
170/* MII control register */
171#define OWL_EMAC_REG_MAC_CTRL			0x00B0
172#define OWL_EMAC_BIT_MAC_CTRL_RRSB		BIT(8)	/* RMII_REFCLK select bit */
173#define OWL_EMAC_OFF_MAC_CTRL_SSDC		4	/* SMII SYNC delay cycle */
174#define OWL_EMAC_BIT_MAC_CTRL_RCPS		BIT(1)	/* REF_CLK phase select */
175#define OWL_EMAC_BIT_MAC_CTRL_RSIS		BIT(0)	/* RMII/SMII interface select */
176
177/* Receive descriptor status field */
178#define OWL_EMAC_BIT_RDES0_OWN			BIT(31)	/* Ownership bit */
179#define OWL_EMAC_BIT_RDES0_FF			BIT(30)	/* Filtering fail */
180#define OWL_EMAC_MSK_RDES0_FL			GENMASK(29, 16)	/* Frame length */
181#define OWL_EMAC_OFF_RDES0_FL			16
182#define OWL_EMAC_BIT_RDES0_ES			BIT(15)	/* Error summary */
183#define OWL_EMAC_BIT_RDES0_DE			BIT(14)	/* Descriptor error */
184#define OWL_EMAC_BIT_RDES0_RF			BIT(11)	/* Runt frame */
185#define OWL_EMAC_BIT_RDES0_MF			BIT(10)	/* Multicast frame */
186#define OWL_EMAC_BIT_RDES0_FS			BIT(9)	/* First descriptor */
187#define OWL_EMAC_BIT_RDES0_LS			BIT(8)	/* Last descriptor */
188#define OWL_EMAC_BIT_RDES0_TL			BIT(7)	/* Frame too long */
189#define OWL_EMAC_BIT_RDES0_CS			BIT(6)	/* Collision seen */
190#define OWL_EMAC_BIT_RDES0_FT			BIT(5)	/* Frame type */
191#define OWL_EMAC_BIT_RDES0_RE			BIT(3)	/* Report on MII error */
192#define OWL_EMAC_BIT_RDES0_DB			BIT(2)	/* Dribbling bit */
193#define OWL_EMAC_BIT_RDES0_CE			BIT(1)	/* CRC error */
194#define OWL_EMAC_BIT_RDES0_ZERO			BIT(0)	/* Legal frame length indicator */
195
196/* Receive descriptor control and count field */
197#define OWL_EMAC_BIT_RDES1_RER			BIT(25)	/* Receive end of ring */
198#define OWL_EMAC_MSK_RDES1_RBS1			GENMASK(10, 0) /* Buffer 1 size */
199
200/* Transmit descriptor status field */
201#define OWL_EMAC_BIT_TDES0_OWN			BIT(31)	/* Ownership bit */
202#define OWL_EMAC_BIT_TDES0_ES			BIT(15)	/* Error summary */
203#define OWL_EMAC_BIT_TDES0_LO			BIT(11)	/* Loss of carrier */
204#define OWL_EMAC_BIT_TDES0_NC			BIT(10)	/* No carrier */
205#define OWL_EMAC_BIT_TDES0_LC			BIT(9)	/* Late collision */
206#define OWL_EMAC_BIT_TDES0_EC			BIT(8)	/* Excessive collisions */
207#define OWL_EMAC_MSK_TDES0_CC			GENMASK(6, 3) /* Collision count */
208#define OWL_EMAC_BIT_TDES0_UF			BIT(1)	/* Underflow error */
209#define OWL_EMAC_BIT_TDES0_DE			BIT(0)	/* Deferred */
210
211/* Transmit descriptor control and count field */
212#define OWL_EMAC_BIT_TDES1_IC			BIT(31)	/* Interrupt on completion */
213#define OWL_EMAC_BIT_TDES1_LS			BIT(30)	/* Last descriptor */
214#define OWL_EMAC_BIT_TDES1_FS			BIT(29)	/* First descriptor */
215#define OWL_EMAC_BIT_TDES1_FT1			BIT(28)	/* Filtering type */
216#define OWL_EMAC_BIT_TDES1_SET			BIT(27)	/* Setup packet */
217#define OWL_EMAC_BIT_TDES1_AC			BIT(26)	/* Add CRC disable */
218#define OWL_EMAC_BIT_TDES1_TER			BIT(25)	/* Transmit end of ring */
219#define OWL_EMAC_BIT_TDES1_DPD			BIT(23)	/* Disabled padding */
220#define OWL_EMAC_BIT_TDES1_FT0			BIT(22)	/* Filtering type */
221#define OWL_EMAC_MSK_TDES1_TBS1			GENMASK(10, 0) /* Buffer 1 size */
222
223static const char *const owl_emac_clk_names[] = { "eth", "rmii" };
224#define OWL_EMAC_NCLKS ARRAY_SIZE(owl_emac_clk_names)
225
226enum owl_emac_clk_map {
227	OWL_EMAC_CLK_ETH = 0,
228	OWL_EMAC_CLK_RMII
229};
230
231struct owl_emac_addr_list {
232	u8 addrs[OWL_EMAC_MAX_MULTICAST_ADDRS][ETH_ALEN];
233	int count;
234};
235
236/* TX/RX descriptors */
237struct owl_emac_ring_desc {
238	u32 status;
239	u32 control;
240	u32 buf_addr;
241	u32 reserved;		/* 2nd buffer address is not used */
242};
243
244struct owl_emac_ring {
245	struct owl_emac_ring_desc *descs;
246	dma_addr_t descs_dma;
247	struct sk_buff **skbs;
248	dma_addr_t *skbs_dma;
249	unsigned int size;
250	unsigned int head;
251	unsigned int tail;
252};
253
254struct owl_emac_priv {
255	struct net_device *netdev;
256	void __iomem *base;
257
258	struct clk_bulk_data clks[OWL_EMAC_NCLKS];
259	struct reset_control *reset;
260
261	struct owl_emac_ring rx_ring;
262	struct owl_emac_ring tx_ring;
263
264	struct mii_bus *mii;
265	struct napi_struct napi;
266
267	phy_interface_t phy_mode;
268	unsigned int link;
269	int speed;
270	int duplex;
271	int pause;
272	struct owl_emac_addr_list mcaddr_list;
273
274	struct work_struct mac_reset_task;
275
276	u32 msg_enable;		/* Debug message level */
277	spinlock_t lock;	/* Sync concurrent ring access */
278};
279
280#endif /* __OWL_EMAC_H__ */
281