1/* SPDX-License-Identifier: GPL-2.0-or-later */
2/*
3 * Marvell 88E6xxx Ethernet switch single-chip definition
4 *
5 * Copyright (c) 2008 Marvell Semiconductor
6 */
7
8#ifndef _MV88E6XXX_CHIP_H
9#define _MV88E6XXX_CHIP_H
10
11#include <linux/idr.h>
12#include <linux/if_vlan.h>
13#include <linux/irq.h>
14#include <linux/gpio/consumer.h>
15#include <linux/kthread.h>
16#include <linux/phy.h>
17#include <linux/ptp_clock_kernel.h>
18#include <linux/timecounter.h>
19#include <net/dsa.h>
20
21#define EDSA_HLEN		8
22#define MV88E6XXX_N_FID		4096
23#define MV88E6XXX_N_SID		64
24
25#define MV88E6XXX_FID_STANDALONE	0
26#define MV88E6XXX_FID_BRIDGED		1
27
28/* PVT limits for 4-bit port and 5-bit switch */
29#define MV88E6XXX_MAX_PVT_SWITCHES	32
30#define MV88E6XXX_MAX_PVT_PORTS		16
31#define MV88E6XXX_MAX_PVT_ENTRIES	\
32	(MV88E6XXX_MAX_PVT_SWITCHES * MV88E6XXX_MAX_PVT_PORTS)
33
34#define MV88E6XXX_MAX_GPIO	16
35
36enum mv88e6xxx_egress_mode {
37	MV88E6XXX_EGRESS_MODE_UNMODIFIED,
38	MV88E6XXX_EGRESS_MODE_UNTAGGED,
39	MV88E6XXX_EGRESS_MODE_TAGGED,
40	MV88E6XXX_EGRESS_MODE_ETHERTYPE,
41};
42
43enum mv88e6xxx_egress_direction {
44        MV88E6XXX_EGRESS_DIR_INGRESS,
45        MV88E6XXX_EGRESS_DIR_EGRESS,
46};
47
48enum mv88e6xxx_frame_mode {
49	MV88E6XXX_FRAME_MODE_NORMAL,
50	MV88E6XXX_FRAME_MODE_DSA,
51	MV88E6XXX_FRAME_MODE_PROVIDER,
52	MV88E6XXX_FRAME_MODE_ETHERTYPE,
53};
54
55/* List of supported models */
56enum mv88e6xxx_model {
57	MV88E6020,
58	MV88E6071,
59	MV88E6085,
60	MV88E6095,
61	MV88E6097,
62	MV88E6123,
63	MV88E6131,
64	MV88E6141,
65	MV88E6161,
66	MV88E6165,
67	MV88E6171,
68	MV88E6172,
69	MV88E6175,
70	MV88E6176,
71	MV88E6185,
72	MV88E6190,
73	MV88E6190X,
74	MV88E6191,
75	MV88E6191X,
76	MV88E6193X,
77	MV88E6220,
78	MV88E6240,
79	MV88E6250,
80	MV88E6290,
81	MV88E6320,
82	MV88E6321,
83	MV88E6341,
84	MV88E6350,
85	MV88E6351,
86	MV88E6352,
87	MV88E6361,
88	MV88E6390,
89	MV88E6390X,
90	MV88E6393X,
91};
92
93enum mv88e6xxx_family {
94	MV88E6XXX_FAMILY_NONE,
95	MV88E6XXX_FAMILY_6065,	/* 6031 6035 6061 6065 */
96	MV88E6XXX_FAMILY_6095,	/* 6092 6095 */
97	MV88E6XXX_FAMILY_6097,	/* 6046 6085 6096 6097 */
98	MV88E6XXX_FAMILY_6165,	/* 6123 6161 6165 */
99	MV88E6XXX_FAMILY_6185,	/* 6108 6121 6122 6131 6152 6155 6182 6185 */
100	MV88E6XXX_FAMILY_6250,	/* 6220 6250 6020 6071 */
101	MV88E6XXX_FAMILY_6320,	/* 6320 6321 */
102	MV88E6XXX_FAMILY_6341,	/* 6141 6341 */
103	MV88E6XXX_FAMILY_6351,	/* 6171 6175 6350 6351 */
104	MV88E6XXX_FAMILY_6352,	/* 6172 6176 6240 6352 */
105	MV88E6XXX_FAMILY_6390,  /* 6190 6190X 6191 6290 6390 6390X */
106	MV88E6XXX_FAMILY_6393,	/* 6191X 6193X 6361 6393X */
107};
108
109/**
110 * enum mv88e6xxx_edsa_support - Ethertype DSA tag support level
111 * @MV88E6XXX_EDSA_UNSUPPORTED:  Device has no support for EDSA tags
112 * @MV88E6XXX_EDSA_UNDOCUMENTED: Documentation indicates that
113 *                               egressing FORWARD frames with an EDSA
114 *                               tag is reserved for future use, but
115 *                               empirical data shows that this mode
116 *                               is supported.
117 * @MV88E6XXX_EDSA_SUPPORTED:    EDSA tags are fully supported.
118 */
119enum mv88e6xxx_edsa_support {
120	MV88E6XXX_EDSA_UNSUPPORTED = 0,
121	MV88E6XXX_EDSA_UNDOCUMENTED,
122	MV88E6XXX_EDSA_SUPPORTED,
123};
124
125struct mv88e6xxx_ops;
126
127struct mv88e6xxx_info {
128	enum mv88e6xxx_family family;
129	u16 prod_num;
130	const char *name;
131	unsigned int num_databases;
132	unsigned int num_macs;
133	unsigned int num_ports;
134	unsigned int num_internal_phys;
135	unsigned int num_gpio;
136	unsigned int max_vid;
137	unsigned int max_sid;
138	unsigned int port_base_addr;
139	unsigned int phy_base_addr;
140	unsigned int global1_addr;
141	unsigned int global2_addr;
142	unsigned int age_time_coeff;
143	unsigned int g1_irqs;
144	unsigned int g2_irqs;
145	bool pvt;
146
147	/* Mark certain ports as invalid. This is required for example for the
148	 * MV88E6220 (which is in general a MV88E6250 with 7 ports) but the
149	 * ports 2-4 are not routet to pins.
150	 */
151	unsigned int invalid_port_mask;
152	/* Multi-chip Addressing Mode.
153	 * Some chips respond to only 2 registers of its own SMI device address
154	 * when it is non-zero, and use indirect access to internal registers.
155	 */
156	bool multi_chip;
157	/* Dual-chip Addressing Mode
158	 * Some chips respond to only half of the 32 SMI addresses,
159	 * allowing two to coexist on the same SMI interface.
160	 */
161	bool dual_chip;
162
163	enum mv88e6xxx_edsa_support edsa_support;
164
165	/* Mask for FromPort and ToPort value of PortVec used in ATU Move
166	 * operation. 0 means that the ATU Move operation is not supported.
167	 */
168	u8 atu_move_port_mask;
169	const struct mv88e6xxx_ops *ops;
170
171	/* Supports PTP */
172	bool ptp_support;
173
174	/* Internal PHY start index. 0 means that internal PHYs range starts at
175	 * port 0, 1 means internal PHYs range starts at port 1, etc
176	 */
177	unsigned int internal_phys_offset;
178};
179
180struct mv88e6xxx_atu_entry {
181	u8	state;
182	bool	trunk;
183	u16	portvec;
184	u8	mac[ETH_ALEN];
185};
186
187struct mv88e6xxx_vtu_entry {
188	u16	vid;
189	u16	fid;
190	u8	sid;
191	bool	valid;
192	bool	policy;
193	u8	member[DSA_MAX_PORTS];
194	u8	state[DSA_MAX_PORTS];	/* Older silicon has no STU */
195};
196
197struct mv88e6xxx_stu_entry {
198	u8	sid;
199	bool	valid;
200	u8	state[DSA_MAX_PORTS];
201};
202
203struct mv88e6xxx_bus_ops;
204struct mv88e6xxx_irq_ops;
205struct mv88e6xxx_gpio_ops;
206struct mv88e6xxx_avb_ops;
207struct mv88e6xxx_ptp_ops;
208struct mv88e6xxx_pcs_ops;
209
210struct mv88e6xxx_irq {
211	u16 masked;
212	struct irq_chip chip;
213	struct irq_domain *domain;
214	int nirqs;
215};
216
217/* state flags for mv88e6xxx_port_hwtstamp::state */
218enum {
219	MV88E6XXX_HWTSTAMP_ENABLED,
220	MV88E6XXX_HWTSTAMP_TX_IN_PROGRESS,
221};
222
223struct mv88e6xxx_port_hwtstamp {
224	/* Port index */
225	int port_id;
226
227	/* Timestamping state */
228	unsigned long state;
229
230	/* Resources for receive timestamping */
231	struct sk_buff_head rx_queue;
232	struct sk_buff_head rx_queue2;
233
234	/* Resources for transmit timestamping */
235	unsigned long tx_tstamp_start;
236	struct sk_buff *tx_skb;
237	u16 tx_seq_id;
238
239	/* Current timestamp configuration */
240	struct hwtstamp_config tstamp_config;
241};
242
243enum mv88e6xxx_policy_mapping {
244	MV88E6XXX_POLICY_MAPPING_DA,
245	MV88E6XXX_POLICY_MAPPING_SA,
246	MV88E6XXX_POLICY_MAPPING_VTU,
247	MV88E6XXX_POLICY_MAPPING_ETYPE,
248	MV88E6XXX_POLICY_MAPPING_PPPOE,
249	MV88E6XXX_POLICY_MAPPING_VBAS,
250	MV88E6XXX_POLICY_MAPPING_OPT82,
251	MV88E6XXX_POLICY_MAPPING_UDP,
252};
253
254enum mv88e6xxx_policy_action {
255	MV88E6XXX_POLICY_ACTION_NORMAL,
256	MV88E6XXX_POLICY_ACTION_MIRROR,
257	MV88E6XXX_POLICY_ACTION_TRAP,
258	MV88E6XXX_POLICY_ACTION_DISCARD,
259};
260
261struct mv88e6xxx_policy {
262	enum mv88e6xxx_policy_mapping mapping;
263	enum mv88e6xxx_policy_action action;
264	struct ethtool_rx_flow_spec fs;
265	u8 addr[ETH_ALEN];
266	int port;
267	u16 vid;
268};
269
270struct mv88e6xxx_vlan {
271	u16	vid;
272	bool	valid;
273};
274
275struct mv88e6xxx_port {
276	struct mv88e6xxx_chip *chip;
277	int port;
278	struct mv88e6xxx_vlan bridge_pvid;
279	u64 serdes_stats[2];
280	u64 atu_member_violation;
281	u64 atu_miss_violation;
282	u64 atu_full_violation;
283	u64 vtu_member_violation;
284	u64 vtu_miss_violation;
285	phy_interface_t interface;
286	u8 cmode;
287	bool mirror_ingress;
288	bool mirror_egress;
289	struct devlink_region *region;
290	void *pcs_private;
291
292	/* MacAuth Bypass control flag */
293	bool mab;
294};
295
296enum mv88e6xxx_region_id {
297	MV88E6XXX_REGION_GLOBAL1 = 0,
298	MV88E6XXX_REGION_GLOBAL2,
299	MV88E6XXX_REGION_ATU,
300	MV88E6XXX_REGION_VTU,
301	MV88E6XXX_REGION_STU,
302	MV88E6XXX_REGION_PVT,
303
304	_MV88E6XXX_REGION_MAX,
305};
306
307struct mv88e6xxx_region_priv {
308	enum mv88e6xxx_region_id id;
309};
310
311struct mv88e6xxx_mst {
312	struct list_head node;
313
314	refcount_t refcnt;
315	struct net_device *br;
316	u16 msti;
317
318	struct mv88e6xxx_stu_entry stu;
319};
320
321#define STATS_TYPE_PORT		BIT(0)
322#define STATS_TYPE_BANK0	BIT(1)
323#define STATS_TYPE_BANK1	BIT(2)
324
325struct mv88e6xxx_hw_stat {
326	char string[ETH_GSTRING_LEN];
327	size_t size;
328	int reg;
329	int type;
330};
331
332struct mv88e6xxx_chip {
333	const struct mv88e6xxx_info *info;
334
335	/* Currently configured tagging protocol */
336	enum dsa_tag_protocol tag_protocol;
337
338	/* The dsa_switch this private structure is related to */
339	struct dsa_switch *ds;
340
341	/* The device this structure is associated to */
342	struct device *dev;
343
344	/* This mutex protects the access to the switch registers */
345	struct mutex reg_lock;
346
347	/* The MII bus and the address on the bus that is used to
348	 * communication with the switch
349	 */
350	const struct mv88e6xxx_bus_ops *smi_ops;
351	struct mii_bus *bus;
352	int sw_addr;
353
354	/* Handles automatic disabling and re-enabling of the PHY
355	 * polling unit.
356	 */
357	const struct mv88e6xxx_bus_ops *phy_ops;
358	struct mutex		ppu_mutex;
359	int			ppu_disabled;
360	struct work_struct	ppu_work;
361	struct timer_list	ppu_timer;
362
363	/* This mutex serialises access to the statistics unit.
364	 * Hold this mutex over snapshot + dump sequences.
365	 */
366	struct mutex	stats_mutex;
367
368	/* A switch may have a GPIO line tied to its reset pin. Parse
369	 * this from the device tree, and use it before performing
370	 * switch soft reset.
371	 */
372	struct gpio_desc *reset;
373
374	/* set to size of eeprom if supported by the switch */
375	u32 eeprom_len;
376
377	/* List of mdio busses */
378	struct list_head mdios;
379
380	/* Policy Control List IDs and rules */
381	struct idr policies;
382
383	/* There can be two interrupt controllers, which are chained
384	 * off a GPIO as interrupt source
385	 */
386	struct mv88e6xxx_irq g1_irq;
387	struct mv88e6xxx_irq g2_irq;
388	int irq;
389	char irq_name[64];
390	int device_irq;
391	char device_irq_name[64];
392	int watchdog_irq;
393	char watchdog_irq_name[64];
394
395	int atu_prob_irq;
396	char atu_prob_irq_name[64];
397	int vtu_prob_irq;
398	char vtu_prob_irq_name[64];
399	struct kthread_worker *kworker;
400	struct kthread_delayed_work irq_poll_work;
401
402	/* GPIO resources */
403	u8 gpio_data[2];
404
405	/* This cyclecounter abstracts the switch PTP time.
406	 * reg_lock must be held for any operation that read()s.
407	 */
408	struct cyclecounter	tstamp_cc;
409	struct timecounter	tstamp_tc;
410	struct delayed_work	overflow_work;
411
412	struct ptp_clock	*ptp_clock;
413	struct ptp_clock_info	ptp_clock_info;
414	struct delayed_work	tai_event_work;
415	struct ptp_pin_desc	pin_config[MV88E6XXX_MAX_GPIO];
416	u16 trig_config;
417	u16 evcap_config;
418	u16 enable_count;
419
420	/* Current ingress and egress monitor ports */
421	int egress_dest_port;
422	int ingress_dest_port;
423
424	/* Per-port timestamping resources. */
425	struct mv88e6xxx_port_hwtstamp port_hwtstamp[DSA_MAX_PORTS];
426
427	/* Array of port structures. */
428	struct mv88e6xxx_port ports[DSA_MAX_PORTS];
429
430	/* devlink regions */
431	struct devlink_region *regions[_MV88E6XXX_REGION_MAX];
432
433	/* Bridge MST to SID mappings */
434	struct list_head msts;
435};
436
437struct mv88e6xxx_bus_ops {
438	int (*read)(struct mv88e6xxx_chip *chip, int addr, int reg, u16 *val);
439	int (*write)(struct mv88e6xxx_chip *chip, int addr, int reg, u16 val);
440	int (*init)(struct mv88e6xxx_chip *chip);
441};
442
443struct mv88e6xxx_mdio_bus {
444	struct mii_bus *bus;
445	struct mv88e6xxx_chip *chip;
446	struct list_head list;
447	bool external;
448};
449
450struct mv88e6xxx_ops {
451	/* Switch Setup Errata, called early in the switch setup to
452	 * allow any errata actions to be performed
453	 */
454	int (*setup_errata)(struct mv88e6xxx_chip *chip);
455
456	int (*ieee_pri_map)(struct mv88e6xxx_chip *chip);
457	int (*ip_pri_map)(struct mv88e6xxx_chip *chip);
458
459	/* Ingress Rate Limit unit (IRL) operations */
460	int (*irl_init_all)(struct mv88e6xxx_chip *chip, int port);
461
462	int (*get_eeprom)(struct mv88e6xxx_chip *chip,
463			  struct ethtool_eeprom *eeprom, u8 *data);
464	int (*set_eeprom)(struct mv88e6xxx_chip *chip,
465			  struct ethtool_eeprom *eeprom, u8 *data);
466
467	int (*set_switch_mac)(struct mv88e6xxx_chip *chip, u8 *addr);
468
469	int (*phy_read)(struct mv88e6xxx_chip *chip,
470			struct mii_bus *bus,
471			int addr, int reg, u16 *val);
472	int (*phy_write)(struct mv88e6xxx_chip *chip,
473			 struct mii_bus *bus,
474			 int addr, int reg, u16 val);
475
476	int (*phy_read_c45)(struct mv88e6xxx_chip *chip,
477			    struct mii_bus *bus,
478			    int addr, int devad, int reg, u16 *val);
479	int (*phy_write_c45)(struct mv88e6xxx_chip *chip,
480			     struct mii_bus *bus,
481			     int addr, int devad, int reg, u16 val);
482
483	/* Priority Override Table operations */
484	int (*pot_clear)(struct mv88e6xxx_chip *chip);
485
486	/* PHY Polling Unit (PPU) operations */
487	int (*ppu_enable)(struct mv88e6xxx_chip *chip);
488	int (*ppu_disable)(struct mv88e6xxx_chip *chip);
489
490	/* Additional handlers to run before and after hard reset, to make sure
491	 * that the switch and EEPROM are in a good state.
492	 */
493	int (*hardware_reset_pre)(struct mv88e6xxx_chip *chip);
494	int (*hardware_reset_post)(struct mv88e6xxx_chip *chip);
495
496	/* Switch Software Reset */
497	int (*reset)(struct mv88e6xxx_chip *chip);
498
499	/* RGMII Receive/Transmit Timing Control
500	 * Add delay on PHY_INTERFACE_MODE_RGMII_*ID, no delay otherwise.
501	 */
502	int (*port_set_rgmii_delay)(struct mv88e6xxx_chip *chip, int port,
503				    phy_interface_t mode);
504
505#define LINK_FORCED_DOWN	0
506#define LINK_FORCED_UP		1
507#define LINK_UNFORCED		-2
508
509	/* Port's MAC link state
510	 * Use LINK_FORCED_UP or LINK_FORCED_DOWN to force link up or down,
511	 * or LINK_UNFORCED for normal link detection.
512	 */
513	int (*port_set_link)(struct mv88e6xxx_chip *chip, int port, int link);
514
515	/* Synchronise the port link state with that of the SERDES
516	 */
517	int (*port_sync_link)(struct mv88e6xxx_chip *chip, int port, unsigned int mode, bool isup);
518
519#define PAUSE_ON		1
520#define PAUSE_OFF		0
521
522	/* Enable/disable sending Pause */
523	int (*port_set_pause)(struct mv88e6xxx_chip *chip, int port,
524			      int pause);
525
526#define SPEED_UNFORCED		-2
527#define DUPLEX_UNFORCED		-2
528
529	/* Port's MAC speed (in Mbps) and MAC duplex mode
530	 *
531	 * Depending on the chip, 10, 100, 200, 1000, 2500, 10000 are valid.
532	 * Use SPEED_UNFORCED for normal detection.
533	 *
534	 * Use DUPLEX_HALF or DUPLEX_FULL to force half or full duplex,
535	 * or DUPLEX_UNFORCED for normal duplex detection.
536	 */
537	int (*port_set_speed_duplex)(struct mv88e6xxx_chip *chip, int port,
538				     int speed, int duplex);
539
540	/* What interface mode should be used for maximum speed? */
541	phy_interface_t (*port_max_speed_mode)(struct mv88e6xxx_chip *chip,
542					       int port);
543
544	int (*port_tag_remap)(struct mv88e6xxx_chip *chip, int port);
545
546	int (*port_set_policy)(struct mv88e6xxx_chip *chip, int port,
547			       enum mv88e6xxx_policy_mapping mapping,
548			       enum mv88e6xxx_policy_action action);
549
550	int (*port_set_frame_mode)(struct mv88e6xxx_chip *chip, int port,
551				   enum mv88e6xxx_frame_mode mode);
552	int (*port_set_ucast_flood)(struct mv88e6xxx_chip *chip, int port,
553				    bool unicast);
554	int (*port_set_mcast_flood)(struct mv88e6xxx_chip *chip, int port,
555				    bool multicast);
556	int (*port_set_ether_type)(struct mv88e6xxx_chip *chip, int port,
557				   u16 etype);
558	int (*port_set_jumbo_size)(struct mv88e6xxx_chip *chip, int port,
559				   size_t size);
560
561	int (*port_egress_rate_limiting)(struct mv88e6xxx_chip *chip, int port);
562	int (*port_pause_limit)(struct mv88e6xxx_chip *chip, int port, u8 in,
563				u8 out);
564	int (*port_disable_learn_limit)(struct mv88e6xxx_chip *chip, int port);
565	int (*port_disable_pri_override)(struct mv88e6xxx_chip *chip, int port);
566	int (*port_setup_message_port)(struct mv88e6xxx_chip *chip, int port);
567
568	/* CMODE control what PHY mode the MAC will use, eg. SGMII, RGMII, etc.
569	 * Some chips allow this to be configured on specific ports.
570	 */
571	int (*port_set_cmode)(struct mv88e6xxx_chip *chip, int port,
572			      phy_interface_t mode);
573	int (*port_get_cmode)(struct mv88e6xxx_chip *chip, int port, u8 *cmode);
574
575	/* Some devices have a per port register indicating what is
576	 * the upstream port this port should forward to.
577	 */
578	int (*port_set_upstream_port)(struct mv88e6xxx_chip *chip, int port,
579				      int upstream_port);
580
581	/* Snapshot the statistics for a port. The statistics can then
582	 * be read back a leisure but still with a consistent view.
583	 */
584	int (*stats_snapshot)(struct mv88e6xxx_chip *chip, int port);
585
586	/* Set the histogram mode for statistics, when the control registers
587	 * are separated out of the STATS_OP register.
588	 */
589	int (*stats_set_histogram)(struct mv88e6xxx_chip *chip);
590
591	/* Return the number of strings describing statistics */
592	int (*stats_get_sset_count)(struct mv88e6xxx_chip *chip);
593	int (*stats_get_strings)(struct mv88e6xxx_chip *chip,  uint8_t *data);
594	size_t (*stats_get_stat)(struct mv88e6xxx_chip *chip, int port,
595				 const struct mv88e6xxx_hw_stat *stat,
596				 uint64_t *data);
597	int (*set_cpu_port)(struct mv88e6xxx_chip *chip, int port);
598	int (*set_egress_port)(struct mv88e6xxx_chip *chip,
599			       enum mv88e6xxx_egress_direction direction,
600			       int port);
601
602#define MV88E6XXX_CASCADE_PORT_NONE		0xe
603#define MV88E6XXX_CASCADE_PORT_MULTIPLE		0xf
604
605	int (*set_cascade_port)(struct mv88e6xxx_chip *chip, int port);
606
607	const struct mv88e6xxx_irq_ops *watchdog_ops;
608
609	int (*mgmt_rsvd2cpu)(struct mv88e6xxx_chip *chip);
610
611	/* SERDES lane mapping */
612	int (*serdes_get_lane)(struct mv88e6xxx_chip *chip, int port);
613
614	/* SERDES interrupt handling */
615	unsigned int (*serdes_irq_mapping)(struct mv88e6xxx_chip *chip,
616					   int port);
617
618	/* Statistics from the SERDES interface */
619	int (*serdes_get_sset_count)(struct mv88e6xxx_chip *chip, int port);
620	int (*serdes_get_strings)(struct mv88e6xxx_chip *chip,  int port,
621				  uint8_t *data);
622	size_t (*serdes_get_stats)(struct mv88e6xxx_chip *chip, int port,
623				   uint64_t *data);
624
625	/* SERDES registers for ethtool */
626	int (*serdes_get_regs_len)(struct mv88e6xxx_chip *chip,  int port);
627	void (*serdes_get_regs)(struct mv88e6xxx_chip *chip, int port,
628				void *_p);
629
630	/* SERDES SGMII/Fiber Output Amplitude */
631	int (*serdes_set_tx_amplitude)(struct mv88e6xxx_chip *chip, int port,
632				       int val);
633
634	/* Address Translation Unit operations */
635	int (*atu_get_hash)(struct mv88e6xxx_chip *chip, u8 *hash);
636	int (*atu_set_hash)(struct mv88e6xxx_chip *chip, u8 hash);
637
638	/* VLAN Translation Unit operations */
639	int (*vtu_getnext)(struct mv88e6xxx_chip *chip,
640			   struct mv88e6xxx_vtu_entry *entry);
641	int (*vtu_loadpurge)(struct mv88e6xxx_chip *chip,
642			     struct mv88e6xxx_vtu_entry *entry);
643
644	/* Spanning Tree Unit operations */
645	int (*stu_getnext)(struct mv88e6xxx_chip *chip,
646			   struct mv88e6xxx_stu_entry *entry);
647	int (*stu_loadpurge)(struct mv88e6xxx_chip *chip,
648			     struct mv88e6xxx_stu_entry *entry);
649
650	/* GPIO operations */
651	const struct mv88e6xxx_gpio_ops *gpio_ops;
652
653	/* Interface to the AVB/PTP registers */
654	const struct mv88e6xxx_avb_ops *avb_ops;
655
656	/* Remote Management Unit operations */
657	int (*rmu_disable)(struct mv88e6xxx_chip *chip);
658
659	/* Precision Time Protocol operations */
660	const struct mv88e6xxx_ptp_ops *ptp_ops;
661
662	/* Phylink */
663	void (*phylink_get_caps)(struct mv88e6xxx_chip *chip, int port,
664				 struct phylink_config *config);
665
666	const struct mv88e6xxx_pcs_ops *pcs_ops;
667
668	/* Max Frame Size */
669	int (*set_max_frame_size)(struct mv88e6xxx_chip *chip, int mtu);
670};
671
672struct mv88e6xxx_irq_ops {
673	/* Action to be performed when the interrupt happens */
674	int (*irq_action)(struct mv88e6xxx_chip *chip, int irq);
675	/* Setup the hardware to generate the interrupt */
676	int (*irq_setup)(struct mv88e6xxx_chip *chip);
677	/* Reset the hardware to stop generating the interrupt */
678	void (*irq_free)(struct mv88e6xxx_chip *chip);
679};
680
681struct mv88e6xxx_gpio_ops {
682	/* Get/set data on GPIO pin */
683	int (*get_data)(struct mv88e6xxx_chip *chip, unsigned int pin);
684	int (*set_data)(struct mv88e6xxx_chip *chip, unsigned int pin,
685			int value);
686
687	/* get/set GPIO direction */
688	int (*get_dir)(struct mv88e6xxx_chip *chip, unsigned int pin);
689	int (*set_dir)(struct mv88e6xxx_chip *chip, unsigned int pin,
690		       bool input);
691
692	/* get/set GPIO pin control */
693	int (*get_pctl)(struct mv88e6xxx_chip *chip, unsigned int pin,
694			int *func);
695	int (*set_pctl)(struct mv88e6xxx_chip *chip, unsigned int pin,
696			int func);
697};
698
699struct mv88e6xxx_avb_ops {
700	/* Access port-scoped Precision Time Protocol registers */
701	int (*port_ptp_read)(struct mv88e6xxx_chip *chip, int port, int addr,
702			     u16 *data, int len);
703	int (*port_ptp_write)(struct mv88e6xxx_chip *chip, int port, int addr,
704			      u16 data);
705
706	/* Access global Precision Time Protocol registers */
707	int (*ptp_read)(struct mv88e6xxx_chip *chip, int addr, u16 *data,
708			int len);
709	int (*ptp_write)(struct mv88e6xxx_chip *chip, int addr, u16 data);
710
711	/* Access global Time Application Interface registers */
712	int (*tai_read)(struct mv88e6xxx_chip *chip, int addr, u16 *data,
713			int len);
714	int (*tai_write)(struct mv88e6xxx_chip *chip, int addr, u16 data);
715};
716
717struct mv88e6xxx_ptp_ops {
718	u64 (*clock_read)(const struct cyclecounter *cc);
719	int (*ptp_enable)(struct ptp_clock_info *ptp,
720			  struct ptp_clock_request *rq, int on);
721	int (*ptp_verify)(struct ptp_clock_info *ptp, unsigned int pin,
722			  enum ptp_pin_function func, unsigned int chan);
723	void (*event_work)(struct work_struct *ugly);
724	int (*port_enable)(struct mv88e6xxx_chip *chip, int port);
725	int (*port_disable)(struct mv88e6xxx_chip *chip, int port);
726	int (*global_enable)(struct mv88e6xxx_chip *chip);
727	int (*global_disable)(struct mv88e6xxx_chip *chip);
728	int (*set_ptp_cpu_port)(struct mv88e6xxx_chip *chip, int port);
729	int n_ext_ts;
730	int arr0_sts_reg;
731	int arr1_sts_reg;
732	int dep_sts_reg;
733	u32 rx_filters;
734	u32 cc_shift;
735	u32 cc_mult;
736	u32 cc_mult_num;
737	u32 cc_mult_dem;
738};
739
740struct mv88e6xxx_pcs_ops {
741	int (*pcs_init)(struct mv88e6xxx_chip *chip, int port);
742	void (*pcs_teardown)(struct mv88e6xxx_chip *chip, int port);
743	struct phylink_pcs *(*pcs_select)(struct mv88e6xxx_chip *chip, int port,
744					  phy_interface_t mode);
745
746};
747
748static inline bool mv88e6xxx_has_stu(struct mv88e6xxx_chip *chip)
749{
750	return chip->info->max_sid > 0 &&
751		chip->info->ops->stu_loadpurge &&
752		chip->info->ops->stu_getnext;
753}
754
755static inline bool mv88e6xxx_has_pvt(struct mv88e6xxx_chip *chip)
756{
757	return chip->info->pvt;
758}
759
760static inline bool mv88e6xxx_has_lag(struct mv88e6xxx_chip *chip)
761{
762	return !!chip->info->global2_addr;
763}
764
765static inline unsigned int mv88e6xxx_num_databases(struct mv88e6xxx_chip *chip)
766{
767	return chip->info->num_databases;
768}
769
770static inline unsigned int mv88e6xxx_num_macs(struct  mv88e6xxx_chip *chip)
771{
772	return chip->info->num_macs;
773}
774
775static inline unsigned int mv88e6xxx_num_ports(struct mv88e6xxx_chip *chip)
776{
777	return chip->info->num_ports;
778}
779
780static inline unsigned int mv88e6xxx_max_vid(struct mv88e6xxx_chip *chip)
781{
782	return chip->info->max_vid;
783}
784
785static inline unsigned int mv88e6xxx_max_sid(struct mv88e6xxx_chip *chip)
786{
787	return chip->info->max_sid;
788}
789
790static inline u16 mv88e6xxx_port_mask(struct mv88e6xxx_chip *chip)
791{
792	return GENMASK((s32)mv88e6xxx_num_ports(chip) - 1, 0);
793}
794
795static inline unsigned int mv88e6xxx_num_gpio(struct mv88e6xxx_chip *chip)
796{
797	return chip->info->num_gpio;
798}
799
800static inline bool mv88e6xxx_is_invalid_port(struct mv88e6xxx_chip *chip, int port)
801{
802	return (chip->info->invalid_port_mask & BIT(port)) != 0;
803}
804
805static inline void mv88e6xxx_port_set_mab(struct mv88e6xxx_chip *chip,
806					  int port, bool mab)
807{
808	chip->ports[port].mab = mab;
809}
810
811int mv88e6xxx_read(struct mv88e6xxx_chip *chip, int addr, int reg, u16 *val);
812int mv88e6xxx_write(struct mv88e6xxx_chip *chip, int addr, int reg, u16 val);
813int mv88e6xxx_wait_mask(struct mv88e6xxx_chip *chip, int addr, int reg,
814			u16 mask, u16 val);
815int mv88e6xxx_wait_bit(struct mv88e6xxx_chip *chip, int addr, int reg,
816		       int bit, int val);
817struct mii_bus *mv88e6xxx_default_mdio_bus(struct mv88e6xxx_chip *chip);
818
819static inline void mv88e6xxx_reg_lock(struct mv88e6xxx_chip *chip)
820{
821	mutex_lock(&chip->reg_lock);
822}
823
824static inline void mv88e6xxx_reg_unlock(struct mv88e6xxx_chip *chip)
825{
826	mutex_unlock(&chip->reg_lock);
827}
828
829int mv88e6xxx_vtu_walk(struct mv88e6xxx_chip *chip,
830		       int (*cb)(struct mv88e6xxx_chip *chip,
831				 const struct mv88e6xxx_vtu_entry *entry,
832				 void *priv),
833		       void *priv);
834
835int mv88e6xxx_fid_map(struct mv88e6xxx_chip *chip, unsigned long *bitmap);
836
837#endif /* _MV88E6XXX_CHIP_H */
838