]> git.proxmox.com Git - mirror_ubuntu-focal-kernel.git/blame - drivers/net/ethernet/ibm/emac/core.h
treewide: Replace GPLv2 boilerplate/reference with SPDX - rule 152
[mirror_ubuntu-focal-kernel.git] / drivers / net / ethernet / ibm / emac / core.h
CommitLineData
2874c5fd 1/* SPDX-License-Identifier: GPL-2.0-or-later */
1d3bb996 2/*
3396c782 3 * drivers/net/ethernet/ibm/emac/core.h
1d3bb996
DG
4 *
5 * Driver for PowerPC 4xx on-chip ethernet controller.
6 *
17cf803a
BH
7 * Copyright 2007 Benjamin Herrenschmidt, IBM Corp.
8 * <benh@kernel.crashing.org>
9 *
10 * Based on the arch/ppc version of the driver:
11 *
1d3bb996
DG
12 * Copyright (c) 2004, 2005 Zultys Technologies.
13 * Eugene Surovegin <eugene.surovegin@zultys.com> or <ebs@ebshome.net>
14 *
15 * Based on original work by
16 * Armin Kuster <akuster@mvista.com>
17 * Johnnie Peters <jpeters@mvista.com>
18 * Copyright 2000, 2001 MontaVista Softare Inc.
1d3bb996
DG
19 */
20#ifndef __IBM_NEWEMAC_CORE_H
21#define __IBM_NEWEMAC_CORE_H
22
23#include <linux/module.h>
1d3bb996
DG
24#include <linux/list.h>
25#include <linux/kernel.h>
26#include <linux/interrupt.h>
27#include <linux/netdevice.h>
28#include <linux/dma-mapping.h>
29#include <linux/spinlock.h>
55b6c8e9 30#include <linux/of_platform.h>
5a0e3ad6 31#include <linux/slab.h>
1d3bb996 32
1d3bb996
DG
33#include <asm/io.h>
34#include <asm/dcr.h>
35
36#include "emac.h"
37#include "phy.h"
38#include "zmii.h"
39#include "rgmii.h"
40#include "mal.h"
41#include "tah.h"
42#include "debug.h"
43
3b3bceef
TB
44#define NUM_TX_BUFF CONFIG_IBM_EMAC_TXB
45#define NUM_RX_BUFF CONFIG_IBM_EMAC_RXB
1d3bb996
DG
46
47/* Simple sanity check */
48#if NUM_TX_BUFF > 256 || NUM_RX_BUFF > 256
49#error Invalid number of buffer descriptors (greater than 256)
50#endif
51
52#define EMAC_MIN_MTU 46
53
54/* Maximum L2 header length (VLAN tagged, no FCS) */
55#define EMAC_MTU_OVERHEAD (6 * 2 + 2 + 4)
56
57/* RX BD size for the given MTU */
58static inline int emac_rx_size(int mtu)
59{
60 if (mtu > ETH_DATA_LEN)
61 return MAL_MAX_RX_SIZE;
62 else
63 return mal_rx_size(ETH_DATA_LEN + EMAC_MTU_OVERHEAD);
64}
65
1d3bb996
DG
66/* Size of RX skb for the given MTU */
67static inline int emac_rx_skb_size(int mtu)
68{
69 int size = max(mtu + EMAC_MTU_OVERHEAD, emac_rx_size(mtu));
22087d65
CL
70
71 return SKB_DATA_ALIGN(size + NET_IP_ALIGN) + NET_SKB_PAD;
1d3bb996
DG
72}
73
74/* RX DMA sync size */
75static inline int emac_rx_sync_size(int mtu)
76{
22087d65 77 return SKB_DATA_ALIGN(emac_rx_size(mtu) + NET_IP_ALIGN);
1d3bb996
DG
78}
79
80/* Driver statistcs is split into two parts to make it more cache friendly:
81 * - normal statistics (packet count, etc)
82 * - error statistics
83 *
84 * When statistics is requested by ethtool, these parts are concatenated,
85 * normal one goes first.
86 *
87 * Please, keep these structures in sync with emac_stats_keys.
88 */
89
90/* Normal TX/RX Statistics */
91struct emac_stats {
92 u64 rx_packets;
93 u64 rx_bytes;
94 u64 tx_packets;
95 u64 tx_bytes;
96 u64 rx_packets_csum;
97 u64 tx_packets_csum;
98};
99
100/* Error statistics */
101struct emac_error_stats {
102 u64 tx_undo;
103
104 /* Software RX Errors */
105 u64 rx_dropped_stack;
106 u64 rx_dropped_oom;
107 u64 rx_dropped_error;
108 u64 rx_dropped_resize;
109 u64 rx_dropped_mtu;
110 u64 rx_stopped;
111 /* BD reported RX errors */
112 u64 rx_bd_errors;
113 u64 rx_bd_overrun;
114 u64 rx_bd_bad_packet;
115 u64 rx_bd_runt_packet;
116 u64 rx_bd_short_event;
117 u64 rx_bd_alignment_error;
118 u64 rx_bd_bad_fcs;
119 u64 rx_bd_packet_too_long;
120 u64 rx_bd_out_of_range;
121 u64 rx_bd_in_range;
122 /* EMAC IRQ reported RX errors */
123 u64 rx_parity;
124 u64 rx_fifo_overrun;
125 u64 rx_overrun;
126 u64 rx_bad_packet;
127 u64 rx_runt_packet;
128 u64 rx_short_event;
129 u64 rx_alignment_error;
130 u64 rx_bad_fcs;
131 u64 rx_packet_too_long;
132 u64 rx_out_of_range;
133 u64 rx_in_range;
134
135 /* Software TX Errors */
136 u64 tx_dropped;
137 /* BD reported TX errors */
138 u64 tx_bd_errors;
139 u64 tx_bd_bad_fcs;
140 u64 tx_bd_carrier_loss;
141 u64 tx_bd_excessive_deferral;
142 u64 tx_bd_excessive_collisions;
143 u64 tx_bd_late_collision;
144 u64 tx_bd_multple_collisions;
145 u64 tx_bd_single_collision;
146 u64 tx_bd_underrun;
147 u64 tx_bd_sqe;
148 /* EMAC IRQ reported TX errors */
149 u64 tx_parity;
150 u64 tx_underrun;
151 u64 tx_sqe;
152 u64 tx_errors;
153};
154
155#define EMAC_ETHTOOL_STATS_COUNT ((sizeof(struct emac_stats) + \
156 sizeof(struct emac_error_stats)) \
157 / sizeof(u64))
158
159struct emac_instance {
160 struct net_device *ndev;
1d3bb996 161 struct emac_regs __iomem *emacp;
2dc11581 162 struct platform_device *ofdev;
1d3bb996
DG
163 struct device_node **blist; /* bootlist entry */
164
165 /* MAL linkage */
166 u32 mal_ph;
2dc11581 167 struct platform_device *mal_dev;
1d3bb996
DG
168 u32 mal_rx_chan;
169 u32 mal_tx_chan;
170 struct mal_instance *mal;
171 struct mal_commac commac;
172
173 /* PHY infos */
7d2fa710 174 int phy_mode;
1d3bb996
DG
175 u32 phy_map;
176 u32 phy_address;
177 u32 phy_feat_exc;
178 struct mii_phy phy;
179 struct mutex link_lock;
180 struct delayed_work link_work;
181 int link_polling;
182
9e3cb294
VG
183 /* GPCS PHY infos */
184 u32 gpcs_address;
185
1d3bb996
DG
186 /* Shared MDIO if any */
187 u32 mdio_ph;
2dc11581 188 struct platform_device *mdio_dev;
1d3bb996
DG
189 struct emac_instance *mdio_instance;
190 struct mutex mdio_lock;
191
a577ca6b
CL
192 /* Device-tree based phy configuration */
193 struct mii_bus *mii_bus;
194 struct phy_device *phy_dev;
195
1d3bb996
DG
196 /* ZMII infos if any */
197 u32 zmii_ph;
198 u32 zmii_port;
2dc11581 199 struct platform_device *zmii_dev;
1d3bb996
DG
200
201 /* RGMII infos if any */
202 u32 rgmii_ph;
203 u32 rgmii_port;
2dc11581 204 struct platform_device *rgmii_dev;
1d3bb996
DG
205
206 /* TAH infos if any */
207 u32 tah_ph;
208 u32 tah_port;
2dc11581 209 struct platform_device *tah_dev;
1d3bb996
DG
210
211 /* IRQs */
212 int wol_irq;
213 int emac_irq;
214
215 /* OPB bus frequency in Mhz */
216 u32 opb_bus_freq;
217
218 /* Cell index within an ASIC (for clk mgmnt) */
219 u32 cell_index;
220
221 /* Max supported MTU */
222 u32 max_mtu;
223
224 /* Feature bits (from probe table) */
225 unsigned int features;
226
227 /* Tx and Rx fifo sizes & other infos in bytes */
228 u32 tx_fifo_size;
229 u32 tx_fifo_size_gige;
230 u32 rx_fifo_size;
231 u32 rx_fifo_size_gige;
232 u32 fifo_entry_size;
233 u32 mal_burst_size; /* move to MAL ? */
234
05781ccd
GE
235 /* IAHT and GAHT filter parameterization */
236 u32 xaht_slots_shift;
237 u32 xaht_width_shift;
238
1d3bb996
DG
239 /* Descriptor management
240 */
241 struct mal_descriptor *tx_desc;
242 int tx_cnt;
243 int tx_slot;
244 int ack_slot;
245
246 struct mal_descriptor *rx_desc;
247 int rx_slot;
248 struct sk_buff *rx_sg_skb; /* 1 */
249 int rx_skb_size;
250 int rx_sync_size;
251
252 struct sk_buff *tx_skb[NUM_TX_BUFF];
253 struct sk_buff *rx_skb[NUM_RX_BUFF];
254
255 /* Stats
256 */
257 struct emac_error_stats estats;
1d3bb996
DG
258 struct emac_stats stats;
259
260 /* Misc
261 */
262 int reset_failed;
263 int stop_timeout; /* in us */
264 int no_mcast;
265 int mcast_pending;
61dbcece 266 int opened;
1d3bb996
DG
267 struct work_struct reset_work;
268 spinlock_t lock;
269};
270
271/*
272 * Features of various EMAC implementations
273 */
274
275/*
276 * No flow control on 40x according to the original driver
277 */
278#define EMAC_FTR_NO_FLOW_CONTROL_40x 0x00000001
279/*
280 * Cell is an EMAC4
281 */
282#define EMAC_FTR_EMAC4 0x00000002
283/*
284 * For the 440SPe, AMCC inexplicably changed the polarity of
285 * the "operation complete" bit in the MII control register.
286 */
287#define EMAC_FTR_STACR_OC_INVERT 0x00000004
288/*
289 * Set if we have a TAH.
290 */
291#define EMAC_FTR_HAS_TAH 0x00000008
292/*
293 * Set if we have a ZMII.
294 */
295#define EMAC_FTR_HAS_ZMII 0x00000010
296/*
297 * Set if we have a RGMII.
298 */
299#define EMAC_FTR_HAS_RGMII 0x00000020
300/*
bff713b5 301 * Set if we have new type STACR with STAOPC
1d3bb996 302 */
bff713b5 303#define EMAC_FTR_HAS_NEW_STACR 0x00000040
0925ab5d
VB
304/*
305 * Set if we need phy clock workaround for 440gx
306 */
307#define EMAC_FTR_440GX_PHY_CLK_FIX 0x00000080
11121e30
VB
308/*
309 * Set if we need phy clock workaround for 440ep or 440gr
310 */
311#define EMAC_FTR_440EP_PHY_CLK_FIX 0x00000100
05781ccd
GE
312/*
313 * The 405EX and 460EX contain the EMAC4SYNC core
314 */
315#define EMAC_FTR_EMAC4SYNC 0x00000200
9e3cb294
VG
316/*
317 * Set if we need phy clock workaround for 460ex or 460gt
318 */
319#define EMAC_FTR_460EX_PHY_CLK_FIX 0x00000400
ae5d3372
DD
320/*
321 * APM821xx requires Jumbo frame size set explicitly
322 */
323#define EMAC_APM821XX_REQ_JUMBO_FRAME_SIZE 0x00000800
324/*
325 * APM821xx does not support Half Duplex mode
326 */
327#define EMAC_FTR_APM821XX_NO_HALF_DUPLEX 0x00001000
1d3bb996
DG
328
329/* Right now, we don't quite handle the always/possible masks on the
330 * most optimal way as we don't have a way to say something like
331 * always EMAC4. Patches welcome.
332 */
333enum {
334 EMAC_FTRS_ALWAYS = 0,
335
336 EMAC_FTRS_POSSIBLE =
3b3bceef 337#ifdef CONFIG_IBM_EMAC_EMAC4
05781ccd
GE
338 EMAC_FTR_EMAC4 | EMAC_FTR_EMAC4SYNC |
339 EMAC_FTR_HAS_NEW_STACR |
0925ab5d 340 EMAC_FTR_STACR_OC_INVERT | EMAC_FTR_440GX_PHY_CLK_FIX |
1d3bb996 341#endif
3b3bceef 342#ifdef CONFIG_IBM_EMAC_TAH
1d3bb996
DG
343 EMAC_FTR_HAS_TAH |
344#endif
3b3bceef 345#ifdef CONFIG_IBM_EMAC_ZMII
1d3bb996
DG
346 EMAC_FTR_HAS_ZMII |
347#endif
3b3bceef 348#ifdef CONFIG_IBM_EMAC_RGMII
1d3bb996 349 EMAC_FTR_HAS_RGMII |
b68d185a 350#endif
3b3bceef 351#ifdef CONFIG_IBM_EMAC_NO_FLOW_CTRL
b68d185a 352 EMAC_FTR_NO_FLOW_CONTROL_40x |
1d3bb996 353#endif
9e3cb294 354 EMAC_FTR_460EX_PHY_CLK_FIX |
ae5d3372
DD
355 EMAC_FTR_440EP_PHY_CLK_FIX |
356 EMAC_APM821XX_REQ_JUMBO_FRAME_SIZE |
357 EMAC_FTR_APM821XX_NO_HALF_DUPLEX,
1d3bb996
DG
358};
359
360static inline int emac_has_feature(struct emac_instance *dev,
361 unsigned long feature)
362{
363 return (EMAC_FTRS_ALWAYS & feature) ||
364 (EMAC_FTRS_POSSIBLE & dev->features & feature);
365}
366
05781ccd
GE
367/*
368 * Various instances of the EMAC core have varying 1) number of
369 * address match slots, 2) width of the registers for handling address
370 * match slots, 3) number of registers for handling address match
371 * slots and 4) base offset for those registers.
372 *
373 * These macros and inlines handle these differences based on
374 * parameters supplied by the device structure which are, in turn,
375 * initialized based on the "compatible" entry in the device tree.
376 */
377
378#define EMAC4_XAHT_SLOTS_SHIFT 6
379#define EMAC4_XAHT_WIDTH_SHIFT 4
380
381#define EMAC4SYNC_XAHT_SLOTS_SHIFT 8
382#define EMAC4SYNC_XAHT_WIDTH_SHIFT 5
383
ee4fccbe
KC
384/* The largest span between slots and widths above is 3 */
385#define EMAC_XAHT_MAX_REGS (1 << 3)
386
05781ccd
GE
387#define EMAC_XAHT_SLOTS(dev) (1 << (dev)->xaht_slots_shift)
388#define EMAC_XAHT_WIDTH(dev) (1 << (dev)->xaht_width_shift)
389#define EMAC_XAHT_REGS(dev) (1 << ((dev)->xaht_slots_shift - \
390 (dev)->xaht_width_shift))
391
392#define EMAC_XAHT_CRC_TO_SLOT(dev, crc) \
393 ((EMAC_XAHT_SLOTS(dev) - 1) - \
394 ((crc) >> ((sizeof (u32) * BITS_PER_BYTE) - \
395 (dev)->xaht_slots_shift)))
396
397#define EMAC_XAHT_SLOT_TO_REG(dev, slot) \
398 ((slot) >> (dev)->xaht_width_shift)
399
400#define EMAC_XAHT_SLOT_TO_MASK(dev, slot) \
401 ((u32)(1 << (EMAC_XAHT_WIDTH(dev) - 1)) >> \
402 ((slot) & (u32)(EMAC_XAHT_WIDTH(dev) - 1)))
403
404static inline u32 *emac_xaht_base(struct emac_instance *dev)
405{
406 struct emac_regs __iomem *p = dev->emacp;
407 int offset;
408
409 /* The first IAHT entry always is the base of the block of
410 * IAHT and GAHT registers.
411 */
412 if (emac_has_feature(dev, EMAC_FTR_EMAC4SYNC))
413 offset = offsetof(struct emac_regs, u1.emac4sync.iaht1);
414 else
415 offset = offsetof(struct emac_regs, u0.emac4.iaht1);
416
807540ba 417 return (u32 *)((ptrdiff_t)p + offset);
05781ccd
GE
418}
419
420static inline u32 *emac_gaht_base(struct emac_instance *dev)
421{
422 /* GAHT registers always come after an identical number of
423 * IAHT registers.
424 */
807540ba 425 return emac_xaht_base(dev) + EMAC_XAHT_REGS(dev);
05781ccd
GE
426}
427
428static inline u32 *emac_iaht_base(struct emac_instance *dev)
429{
430 /* IAHT registers always come before an identical number of
431 * GAHT registers.
432 */
807540ba 433 return emac_xaht_base(dev);
05781ccd 434}
1d3bb996
DG
435
436/* Ethtool get_regs complex data.
437 * We want to get not just EMAC registers, but also MAL, ZMII, RGMII, TAH
438 * when available.
439 *
440 * Returned BLOB consists of the ibm_emac_ethtool_regs_hdr,
441 * MAL registers, EMAC registers and optional ZMII, RGMII, TAH registers.
442 * Each register component is preceded with emac_ethtool_regs_subhdr.
443 * Order of the optional headers follows their relative bit posititions
444 * in emac_ethtool_regs_hdr.components
445 */
446#define EMAC_ETHTOOL_REGS_ZMII 0x00000001
447#define EMAC_ETHTOOL_REGS_RGMII 0x00000002
448#define EMAC_ETHTOOL_REGS_TAH 0x00000004
449
450struct emac_ethtool_regs_hdr {
451 u32 components;
452};
453
454struct emac_ethtool_regs_subhdr {
455 u32 version;
456 u32 index;
457};
458
661dfc65
IM
459#define EMAC_ETHTOOL_REGS_VER 3
460#define EMAC4_ETHTOOL_REGS_VER 4
461#define EMAC4SYNC_ETHTOOL_REGS_VER 5
05781ccd 462
1d3bb996 463#endif /* __IBM_NEWEMAC_CORE_H */