xref: /linux/drivers/net/ethernet/altera/altera_tse.h (revision d642ef71)
1 /* SPDX-License-Identifier: GPL-2.0-only */
2 /* Altera Triple-Speed Ethernet MAC driver
3  * Copyright (C) 2008-2014 Altera Corporation. All rights reserved
4  *
5  * Contributors:
6  *   Dalon Westergreen
7  *   Thomas Chou
8  *   Ian Abbott
9  *   Yuriy Kozlov
10  *   Tobias Klauser
11  *   Andriy Smolskyy
12  *   Roman Bulgakov
13  *   Dmytro Mytarchuk
14  *   Matthew Gerlach
15  *
16  * Original driver contributed by SLS.
17  * Major updates contributed by GlobalLogic
18  */
19 
20 #ifndef __ALTERA_TSE_H__
21 #define __ALTERA_TSE_H__
22 
23 #define ALTERA_TSE_RESOURCE_NAME	"altera_tse"
24 
25 #include <linux/bitops.h>
26 #include <linux/if_vlan.h>
27 #include <linux/list.h>
28 #include <linux/netdevice.h>
29 #include <linux/phy.h>
30 #include <linux/phylink.h>
31 
32 #define ALTERA_TSE_SW_RESET_WATCHDOG_CNTR	10000
33 #define ALTERA_TSE_MAC_FIFO_WIDTH		4	/* TX/RX FIFO width in
34 							 * bytes
35 							 */
36 /* Rx FIFO default settings */
37 #define ALTERA_TSE_RX_SECTION_EMPTY	16
38 #define ALTERA_TSE_RX_SECTION_FULL	0
39 #define ALTERA_TSE_RX_ALMOST_EMPTY	8
40 #define ALTERA_TSE_RX_ALMOST_FULL	8
41 
42 /* Tx FIFO default settings */
43 #define ALTERA_TSE_TX_SECTION_EMPTY	16
44 #define ALTERA_TSE_TX_SECTION_FULL	0
45 #define ALTERA_TSE_TX_ALMOST_EMPTY	8
46 #define ALTERA_TSE_TX_ALMOST_FULL	3
47 
48 /* MAC function configuration default settings */
49 #define ALTERA_TSE_TX_IPG_LENGTH	12
50 
51 #define ALTERA_TSE_PAUSE_QUANTA		0xffff
52 
53 #define GET_BIT_VALUE(v, bit)		(((v) >> (bit)) & 0x1)
54 
55 /* MAC Command_Config Register Bit Definitions
56  */
57 #define MAC_CMDCFG_TX_ENA			BIT(0)
58 #define MAC_CMDCFG_RX_ENA			BIT(1)
59 #define MAC_CMDCFG_XON_GEN			BIT(2)
60 #define MAC_CMDCFG_ETH_SPEED			BIT(3)
61 #define MAC_CMDCFG_PROMIS_EN			BIT(4)
62 #define MAC_CMDCFG_PAD_EN			BIT(5)
63 #define MAC_CMDCFG_CRC_FWD			BIT(6)
64 #define MAC_CMDCFG_PAUSE_FWD			BIT(7)
65 #define MAC_CMDCFG_PAUSE_IGNORE			BIT(8)
66 #define MAC_CMDCFG_TX_ADDR_INS			BIT(9)
67 #define MAC_CMDCFG_HD_ENA			BIT(10)
68 #define MAC_CMDCFG_EXCESS_COL			BIT(11)
69 #define MAC_CMDCFG_LATE_COL			BIT(12)
70 #define MAC_CMDCFG_SW_RESET			BIT(13)
71 #define MAC_CMDCFG_MHASH_SEL			BIT(14)
72 #define MAC_CMDCFG_LOOP_ENA			BIT(15)
73 #define MAC_CMDCFG_TX_ADDR_SEL(v)		(((v) & 0x7) << 16)
74 #define MAC_CMDCFG_MAGIC_ENA			BIT(19)
75 #define MAC_CMDCFG_SLEEP			BIT(20)
76 #define MAC_CMDCFG_WAKEUP			BIT(21)
77 #define MAC_CMDCFG_XOFF_GEN			BIT(22)
78 #define MAC_CMDCFG_CNTL_FRM_ENA			BIT(23)
79 #define MAC_CMDCFG_NO_LGTH_CHECK		BIT(24)
80 #define MAC_CMDCFG_ENA_10			BIT(25)
81 #define MAC_CMDCFG_RX_ERR_DISC			BIT(26)
82 #define MAC_CMDCFG_DISABLE_READ_TIMEOUT		BIT(27)
83 #define MAC_CMDCFG_CNT_RESET			BIT(31)
84 
85 #define MAC_CMDCFG_TX_ENA_GET(v)		GET_BIT_VALUE(v, 0)
86 #define MAC_CMDCFG_RX_ENA_GET(v)		GET_BIT_VALUE(v, 1)
87 #define MAC_CMDCFG_XON_GEN_GET(v)		GET_BIT_VALUE(v, 2)
88 #define MAC_CMDCFG_ETH_SPEED_GET(v)		GET_BIT_VALUE(v, 3)
89 #define MAC_CMDCFG_PROMIS_EN_GET(v)		GET_BIT_VALUE(v, 4)
90 #define MAC_CMDCFG_PAD_EN_GET(v)		GET_BIT_VALUE(v, 5)
91 #define MAC_CMDCFG_CRC_FWD_GET(v)		GET_BIT_VALUE(v, 6)
92 #define MAC_CMDCFG_PAUSE_FWD_GET(v)		GET_BIT_VALUE(v, 7)
93 #define MAC_CMDCFG_PAUSE_IGNORE_GET(v)		GET_BIT_VALUE(v, 8)
94 #define MAC_CMDCFG_TX_ADDR_INS_GET(v)		GET_BIT_VALUE(v, 9)
95 #define MAC_CMDCFG_HD_ENA_GET(v)		GET_BIT_VALUE(v, 10)
96 #define MAC_CMDCFG_EXCESS_COL_GET(v)		GET_BIT_VALUE(v, 11)
97 #define MAC_CMDCFG_LATE_COL_GET(v)		GET_BIT_VALUE(v, 12)
98 #define MAC_CMDCFG_SW_RESET_GET(v)		GET_BIT_VALUE(v, 13)
99 #define MAC_CMDCFG_MHASH_SEL_GET(v)		GET_BIT_VALUE(v, 14)
100 #define MAC_CMDCFG_LOOP_ENA_GET(v)		GET_BIT_VALUE(v, 15)
101 #define MAC_CMDCFG_TX_ADDR_SEL_GET(v)		(((v) >> 16) & 0x7)
102 #define MAC_CMDCFG_MAGIC_ENA_GET(v)		GET_BIT_VALUE(v, 19)
103 #define MAC_CMDCFG_SLEEP_GET(v)			GET_BIT_VALUE(v, 20)
104 #define MAC_CMDCFG_WAKEUP_GET(v)		GET_BIT_VALUE(v, 21)
105 #define MAC_CMDCFG_XOFF_GEN_GET(v)		GET_BIT_VALUE(v, 22)
106 #define MAC_CMDCFG_CNTL_FRM_ENA_GET(v)		GET_BIT_VALUE(v, 23)
107 #define MAC_CMDCFG_NO_LGTH_CHECK_GET(v)		GET_BIT_VALUE(v, 24)
108 #define MAC_CMDCFG_ENA_10_GET(v)		GET_BIT_VALUE(v, 25)
109 #define MAC_CMDCFG_RX_ERR_DISC_GET(v)		GET_BIT_VALUE(v, 26)
110 #define MAC_CMDCFG_DISABLE_READ_TIMEOUT_GET(v)	GET_BIT_VALUE(v, 27)
111 #define MAC_CMDCFG_CNT_RESET_GET(v)		GET_BIT_VALUE(v, 31)
112 
113 /* MDIO registers within MAC register Space
114  */
115 struct altera_tse_mdio {
116 	u32 control;	/* PHY device operation control register */
117 	u32 status;	/* PHY device operation status register */
118 	u32 phy_id1;	/* Bits 31:16 of PHY identifier */
119 	u32 phy_id2;	/* Bits 15:0 of PHY identifier */
120 	u32 auto_negotiation_advertisement;	/* Auto-negotiation
121 							 * advertisement
122 							 * register
123 							 */
124 	u32 remote_partner_base_page_ability;
125 
126 	u32 reg6;
127 	u32 reg7;
128 	u32 reg8;
129 	u32 reg9;
130 	u32 rega;
131 	u32 regb;
132 	u32 regc;
133 	u32 regd;
134 	u32 rege;
135 	u32 regf;
136 	u32 reg10;
137 	u32 reg11;
138 	u32 reg12;
139 	u32 reg13;
140 	u32 reg14;
141 	u32 reg15;
142 	u32 reg16;
143 	u32 reg17;
144 	u32 reg18;
145 	u32 reg19;
146 	u32 reg1a;
147 	u32 reg1b;
148 	u32 reg1c;
149 	u32 reg1d;
150 	u32 reg1e;
151 	u32 reg1f;
152 };
153 
154 /* MAC register Space. Note that some of these registers may or may not be
155  * present depending upon options chosen by the user when the core was
156  * configured and built. Please consult the Altera Triple Speed Ethernet User
157  * Guide for details.
158  */
159 struct altera_tse_mac {
160 	/* Bits 15:0: MegaCore function revision (0x0800). Bit 31:16: Customer
161 	 * specific revision
162 	 */
163 	u32 megacore_revision;
164 	/* Provides a memory location for user applications to test the device
165 	 * memory operation.
166 	 */
167 	u32 scratch_pad;
168 	/* The host processor uses this register to control and configure the
169 	 * MAC block
170 	 */
171 	u32 command_config;
172 	/* 32-bit primary MAC address word 0 bits 0 to 31 of the primary
173 	 * MAC address
174 	 */
175 	u32 mac_addr_0;
176 	/* 32-bit primary MAC address word 1 bits 32 to 47 of the primary
177 	 * MAC address
178 	 */
179 	u32 mac_addr_1;
180 	/* 14-bit maximum frame length. The MAC receive logic */
181 	u32 frm_length;
182 	/* The pause quanta is used in each pause frame sent to a remote
183 	 * Ethernet device, in increments of 512 Ethernet bit times
184 	 */
185 	u32 pause_quanta;
186 	/* 12-bit receive FIFO section-empty threshold */
187 	u32 rx_section_empty;
188 	/* 12-bit receive FIFO section-full threshold */
189 	u32 rx_section_full;
190 	/* 12-bit transmit FIFO section-empty threshold */
191 	u32 tx_section_empty;
192 	/* 12-bit transmit FIFO section-full threshold */
193 	u32 tx_section_full;
194 	/* 12-bit receive FIFO almost-empty threshold */
195 	u32 rx_almost_empty;
196 	/* 12-bit receive FIFO almost-full threshold */
197 	u32 rx_almost_full;
198 	/* 12-bit transmit FIFO almost-empty threshold */
199 	u32 tx_almost_empty;
200 	/* 12-bit transmit FIFO almost-full threshold */
201 	u32 tx_almost_full;
202 	/* MDIO address of PHY Device 0. Bits 0 to 4 hold a 5-bit PHY address */
203 	u32 mdio_phy0_addr;
204 	/* MDIO address of PHY Device 1. Bits 0 to 4 hold a 5-bit PHY address */
205 	u32 mdio_phy1_addr;
206 
207 	/* Bit[15:0]—16-bit holdoff quanta */
208 	u32 holdoff_quant;
209 
210 	/* only if 100/1000 BaseX PCS, reserved otherwise */
211 	u32 reserved1[5];
212 
213 	/* Minimum IPG between consecutive transmit frame in terms of bytes */
214 	u32 tx_ipg_length;
215 
216 	/* IEEE 802.3 oEntity Managed Object Support */
217 
218 	/* The MAC addresses */
219 	u32 mac_id_1;
220 	u32 mac_id_2;
221 
222 	/* Number of frames transmitted without error including pause frames */
223 	u32 frames_transmitted_ok;
224 	/* Number of frames received without error including pause frames */
225 	u32 frames_received_ok;
226 	/* Number of frames received with a CRC error */
227 	u32 frames_check_sequence_errors;
228 	/* Frame received with an alignment error */
229 	u32 alignment_errors;
230 	/* Sum of payload and padding octets of frames transmitted without
231 	 * error
232 	 */
233 	u32 octets_transmitted_ok;
234 	/* Sum of payload and padding octets of frames received without error */
235 	u32 octets_received_ok;
236 
237 	/* IEEE 802.3 oPausedEntity Managed Object Support */
238 
239 	/* Number of transmitted pause frames */
240 	u32 tx_pause_mac_ctrl_frames;
241 	/* Number of Received pause frames */
242 	u32 rx_pause_mac_ctrl_frames;
243 
244 	/* IETF MIB (MIB-II) Object Support */
245 
246 	/* Number of frames received with error */
247 	u32 if_in_errors;
248 	/* Number of frames transmitted with error */
249 	u32 if_out_errors;
250 	/* Number of valid received unicast frames */
251 	u32 if_in_ucast_pkts;
252 	/* Number of valid received multicasts frames (without pause) */
253 	u32 if_in_multicast_pkts;
254 	/* Number of valid received broadcast frames */
255 	u32 if_in_broadcast_pkts;
256 	u32 if_out_discards;
257 	/* The number of valid unicast frames transmitted */
258 	u32 if_out_ucast_pkts;
259 	/* The number of valid multicast frames transmitted,
260 	 * excluding pause frames
261 	 */
262 	u32 if_out_multicast_pkts;
263 	u32 if_out_broadcast_pkts;
264 
265 	/* IETF RMON MIB Object Support */
266 
267 	/* Counts the number of dropped packets due to internal errors
268 	 * of the MAC client.
269 	 */
270 	u32 ether_stats_drop_events;
271 	/* Total number of bytes received. Good and bad frames. */
272 	u32 ether_stats_octets;
273 	/* Total number of packets received. Counts good and bad packets. */
274 	u32 ether_stats_pkts;
275 	/* Number of packets received with less than 64 bytes. */
276 	u32 ether_stats_undersize_pkts;
277 	/* The number of frames received that are longer than the
278 	 * value configured in the frm_length register
279 	 */
280 	u32 ether_stats_oversize_pkts;
281 	/* Number of received packet with 64 bytes */
282 	u32 ether_stats_pkts_64_octets;
283 	/* Frames (good and bad) with 65 to 127 bytes */
284 	u32 ether_stats_pkts_65to127_octets;
285 	/* Frames (good and bad) with 128 to 255 bytes */
286 	u32 ether_stats_pkts_128to255_octets;
287 	/* Frames (good and bad) with 256 to 511 bytes */
288 	u32 ether_stats_pkts_256to511_octets;
289 	/* Frames (good and bad) with 512 to 1023 bytes */
290 	u32 ether_stats_pkts_512to1023_octets;
291 	/* Frames (good and bad) with 1024 to 1518 bytes */
292 	u32 ether_stats_pkts_1024to1518_octets;
293 
294 	/* Any frame length from 1519 to the maximum length configured in the
295 	 * frm_length register, if it is greater than 1518
296 	 */
297 	u32 ether_stats_pkts_1519tox_octets;
298 	/* Too long frames with CRC error */
299 	u32 ether_stats_jabbers;
300 	/* Too short frames with CRC error */
301 	u32 ether_stats_fragments;
302 
303 	u32 reserved2;
304 
305 	/* FIFO control register */
306 	u32 tx_cmd_stat;
307 	u32 rx_cmd_stat;
308 
309 	/* Extended Statistics Counters */
310 	u32 msb_octets_transmitted_ok;
311 	u32 msb_octets_received_ok;
312 	u32 msb_ether_stats_octets;
313 
314 	u32 reserved3;
315 
316 	/* Multicast address resolution table, mapped in the controller address
317 	 * space
318 	 */
319 	u32 hash_table[64];
320 
321 	/* Registers 0 to 31 within PHY device 0/1 connected to the MDIO PHY
322 	 * management interface
323 	 */
324 	struct altera_tse_mdio mdio_phy0;
325 	struct altera_tse_mdio mdio_phy1;
326 
327 	/* 4 Supplemental MAC Addresses */
328 	u32 supp_mac_addr_0_0;
329 	u32 supp_mac_addr_0_1;
330 	u32 supp_mac_addr_1_0;
331 	u32 supp_mac_addr_1_1;
332 	u32 supp_mac_addr_2_0;
333 	u32 supp_mac_addr_2_1;
334 	u32 supp_mac_addr_3_0;
335 	u32 supp_mac_addr_3_1;
336 
337 	u32 reserved4[8];
338 
339 	/* IEEE 1588v2 Feature */
340 	u32 tx_period;
341 	u32 tx_adjust_fns;
342 	u32 tx_adjust_ns;
343 	u32 rx_period;
344 	u32 rx_adjust_fns;
345 	u32 rx_adjust_ns;
346 
347 	u32 reserved5[42];
348 };
349 
350 #define tse_csroffs(a) (offsetof(struct altera_tse_mac, a))
351 
352 /* Transmit and Receive Command Registers Bit Definitions
353  */
354 #define ALTERA_TSE_TX_CMD_STAT_OMIT_CRC		BIT(17)
355 #define ALTERA_TSE_TX_CMD_STAT_TX_SHIFT16	BIT(18)
356 #define ALTERA_TSE_RX_CMD_STAT_RX_SHIFT16	BIT(25)
357 
358 /* Wrapper around a pointer to a socket buffer,
359  * so a DMA handle can be stored along with the buffer
360  */
361 struct tse_buffer {
362 	struct list_head lh;
363 	struct sk_buff *skb;
364 	dma_addr_t dma_addr;
365 	u32 len;
366 	int mapped_as_page;
367 };
368 
369 struct altera_tse_private;
370 
371 #define ALTERA_DTYPE_SGDMA 1
372 #define ALTERA_DTYPE_MSGDMA 2
373 
374 /* standard DMA interface for SGDMA and MSGDMA */
375 struct altera_dmaops {
376 	int altera_dtype;
377 	int dmamask;
378 	void (*reset_dma)(struct altera_tse_private *);
379 	void (*enable_txirq)(struct altera_tse_private *);
380 	void (*enable_rxirq)(struct altera_tse_private *);
381 	void (*disable_txirq)(struct altera_tse_private *);
382 	void (*disable_rxirq)(struct altera_tse_private *);
383 	void (*clear_txirq)(struct altera_tse_private *);
384 	void (*clear_rxirq)(struct altera_tse_private *);
385 	int (*tx_buffer)(struct altera_tse_private *, struct tse_buffer *);
386 	u32 (*tx_completions)(struct altera_tse_private *);
387 	void (*add_rx_desc)(struct altera_tse_private *, struct tse_buffer *);
388 	u32 (*get_rx_status)(struct altera_tse_private *);
389 	int (*init_dma)(struct altera_tse_private *);
390 	void (*uninit_dma)(struct altera_tse_private *);
391 	void (*start_rxdma)(struct altera_tse_private *);
392 };
393 
394 /* This structure is private to each device.
395  */
396 struct altera_tse_private {
397 	struct net_device *dev;
398 	struct device *device;
399 	struct napi_struct napi;
400 
401 	/* MAC address space */
402 	struct altera_tse_mac __iomem *mac_dev;
403 
404 	/* TSE Revision */
405 	u32	revision;
406 
407 	/* mSGDMA Rx Dispatcher address space */
408 	void __iomem *rx_dma_csr;
409 	void __iomem *rx_dma_desc;
410 	void __iomem *rx_dma_resp;
411 
412 	/* mSGDMA Tx Dispatcher address space */
413 	void __iomem *tx_dma_csr;
414 	void __iomem *tx_dma_desc;
415 
416 	/* SGMII PCS address space */
417 	void __iomem *pcs_base;
418 
419 	/* Rx buffers queue */
420 	struct tse_buffer *rx_ring;
421 	u32 rx_cons;
422 	u32 rx_prod;
423 	u32 rx_ring_size;
424 	u32 rx_dma_buf_sz;
425 
426 	/* Tx ring buffer */
427 	struct tse_buffer *tx_ring;
428 	u32 tx_prod;
429 	u32 tx_cons;
430 	u32 tx_ring_size;
431 
432 	/* Interrupts */
433 	u32 tx_irq;
434 	u32 rx_irq;
435 
436 	/* RX/TX MAC FIFO configs */
437 	u32 tx_fifo_depth;
438 	u32 rx_fifo_depth;
439 
440 	/* Hash filter settings */
441 	u32 hash_filter;
442 	u32 added_unicast;
443 
444 	/* Descriptor memory info for managing SGDMA */
445 	u32 txdescmem;
446 	u32 rxdescmem;
447 	dma_addr_t rxdescmem_busaddr;
448 	dma_addr_t txdescmem_busaddr;
449 	u32 txctrlreg;
450 	u32 rxctrlreg;
451 	dma_addr_t rxdescphys;
452 	dma_addr_t txdescphys;
453 
454 	struct list_head txlisthd;
455 	struct list_head rxlisthd;
456 
457 	/* MAC command_config register protection */
458 	spinlock_t mac_cfg_lock;
459 	/* Tx path protection */
460 	spinlock_t tx_lock;
461 	/* Rx DMA & interrupt control protection */
462 	spinlock_t rxdma_irq_lock;
463 
464 	/* PHY */
465 	int phy_addr;		/* PHY's MDIO address, -1 for autodetection */
466 	phy_interface_t phy_iface;
467 	struct mii_bus *mdio;
468 	int oldspeed;
469 	int oldduplex;
470 	int oldlink;
471 
472 	/* ethtool msglvl option */
473 	u32 msg_enable;
474 
475 	const struct altera_dmaops *dmaops;
476 
477 	struct phylink *phylink;
478 	struct phylink_config phylink_config;
479 	struct phylink_pcs *pcs;
480 };
481 
482 /* Function prototypes
483  */
484 void altera_tse_set_ethtool_ops(struct net_device *);
485 
486 static inline
487 u32 csrrd32(void __iomem *mac, size_t offs)
488 {
489 	void __iomem *paddr = (void __iomem *)((uintptr_t)mac + offs);
490 	return readl(paddr);
491 }
492 
493 static inline
494 u16 csrrd16(void __iomem *mac, size_t offs)
495 {
496 	void __iomem *paddr = (void __iomem *)((uintptr_t)mac + offs);
497 	return readw(paddr);
498 }
499 
500 static inline
501 u8 csrrd8(void __iomem *mac, size_t offs)
502 {
503 	void __iomem *paddr = (void __iomem *)((uintptr_t)mac + offs);
504 	return readb(paddr);
505 }
506 
507 static inline
508 void csrwr32(u32 val, void __iomem *mac, size_t offs)
509 {
510 	void __iomem *paddr = (void __iomem *)((uintptr_t)mac + offs);
511 
512 	writel(val, paddr);
513 }
514 
515 static inline
516 void csrwr16(u16 val, void __iomem *mac, size_t offs)
517 {
518 	void __iomem *paddr = (void __iomem *)((uintptr_t)mac + offs);
519 
520 	writew(val, paddr);
521 }
522 
523 static inline
524 void csrwr8(u8 val, void __iomem *mac, size_t offs)
525 {
526 	void __iomem *paddr = (void __iomem *)((uintptr_t)mac + offs);
527 
528 	writeb(val, paddr);
529 }
530 
531 #endif /* __ALTERA_TSE_H__ */
532