dsa.h 19.6 KB
Newer Older
1
/* SPDX-License-Identifier: GPL-2.0-or-later */
2 3
/*
 * include/net/dsa.h - Driver for Distributed Switch Architecture switch chips
4
 * Copyright (c) 2008-2009 Marvell Semiconductor
5 6 7 8 9
 */

#ifndef __LINUX_NET_DSA_H
#define __LINUX_NET_DSA_H

10
#include <linux/if.h>
11
#include <linux/if_ether.h>
12
#include <linux/list.h>
V
Vivien Didelot 已提交
13
#include <linux/notifier.h>
14 15
#include <linux/timer.h>
#include <linux/workqueue.h>
16
#include <linux/of.h>
17
#include <linux/ethtool.h>
18
#include <linux/net_tstamp.h>
19
#include <linux/phy.h>
20
#include <linux/platform_data/dsa.h>
21
#include <linux/phylink.h>
22
#include <net/devlink.h>
23
#include <net/switchdev.h>
24

25
struct tc_action;
26 27
struct phy_device;
struct fixed_phy_status;
28
struct phylink_link_state;
29

30 31 32 33 34 35 36 37 38 39 40 41
#define DSA_TAG_PROTO_NONE_VALUE		0
#define DSA_TAG_PROTO_BRCM_VALUE		1
#define DSA_TAG_PROTO_BRCM_PREPEND_VALUE	2
#define DSA_TAG_PROTO_DSA_VALUE			3
#define DSA_TAG_PROTO_EDSA_VALUE		4
#define DSA_TAG_PROTO_GSWIP_VALUE		5
#define DSA_TAG_PROTO_KSZ9477_VALUE		6
#define DSA_TAG_PROTO_KSZ9893_VALUE		7
#define DSA_TAG_PROTO_LAN9303_VALUE		8
#define DSA_TAG_PROTO_MTK_VALUE			9
#define DSA_TAG_PROTO_QCA_VALUE			10
#define DSA_TAG_PROTO_TRAILER_VALUE		11
42
#define DSA_TAG_PROTO_8021Q_VALUE		12
43
#define DSA_TAG_PROTO_SJA1105_VALUE		13
44
#define DSA_TAG_PROTO_KSZ8795_VALUE		14
45

46
enum dsa_tag_protocol {
47 48 49 50 51 52 53 54 55 56 57 58
	DSA_TAG_PROTO_NONE		= DSA_TAG_PROTO_NONE_VALUE,
	DSA_TAG_PROTO_BRCM		= DSA_TAG_PROTO_BRCM_VALUE,
	DSA_TAG_PROTO_BRCM_PREPEND	= DSA_TAG_PROTO_BRCM_PREPEND_VALUE,
	DSA_TAG_PROTO_DSA		= DSA_TAG_PROTO_DSA_VALUE,
	DSA_TAG_PROTO_EDSA		= DSA_TAG_PROTO_EDSA_VALUE,
	DSA_TAG_PROTO_GSWIP		= DSA_TAG_PROTO_GSWIP_VALUE,
	DSA_TAG_PROTO_KSZ9477		= DSA_TAG_PROTO_KSZ9477_VALUE,
	DSA_TAG_PROTO_KSZ9893		= DSA_TAG_PROTO_KSZ9893_VALUE,
	DSA_TAG_PROTO_LAN9303		= DSA_TAG_PROTO_LAN9303_VALUE,
	DSA_TAG_PROTO_MTK		= DSA_TAG_PROTO_MTK_VALUE,
	DSA_TAG_PROTO_QCA		= DSA_TAG_PROTO_QCA_VALUE,
	DSA_TAG_PROTO_TRAILER		= DSA_TAG_PROTO_TRAILER_VALUE,
59
	DSA_TAG_PROTO_8021Q		= DSA_TAG_PROTO_8021Q_VALUE,
60
	DSA_TAG_PROTO_SJA1105		= DSA_TAG_PROTO_SJA1105_VALUE,
61
	DSA_TAG_PROTO_KSZ8795		= DSA_TAG_PROTO_KSZ8795_VALUE,
62
};
63

64
struct packet_type;
65
struct dsa_switch;
66

67 68 69
struct dsa_device_ops {
	struct sk_buff *(*xmit)(struct sk_buff *skb, struct net_device *dev);
	struct sk_buff *(*rcv)(struct sk_buff *skb, struct net_device *dev,
70
			       struct packet_type *pt);
71 72
	int (*flow_dissect)(const struct sk_buff *skb, __be16 *proto,
			    int *offset);
73 74 75 76 77
	/* Used to determine which traffic should match the DSA filter in
	 * eth_type_trans, and which, if any, should bypass it and be processed
	 * as regular on the master net device.
	 */
	bool (*filter)(const struct sk_buff *skb, struct net_device *dev);
78
	unsigned int overhead;
79
	const char *name;
A
Andrew Lunn 已提交
80
	enum dsa_tag_protocol proto;
81 82
};

83 84 85 86
#define DSA_TAG_DRIVER_ALIAS "dsa_tag-"
#define MODULE_ALIAS_DSA_TAG_DRIVER(__proto)				\
	MODULE_ALIAS(DSA_TAG_DRIVER_ALIAS __stringify(__proto##_VALUE))

87 88
struct dsa_skb_cb {
	struct sk_buff *clone;
89
	bool deferred_xmit;
90 91 92 93 94 95 96 97 98 99 100 101
};

struct __dsa_skb_cb {
	struct dsa_skb_cb cb;
	u8 priv[48 - sizeof(struct dsa_skb_cb)];
};

#define DSA_SKB_CB(skb) ((struct dsa_skb_cb *)((skb)->cb))

#define DSA_SKB_CB_PRIV(skb)			\
	((void *)(skb)->cb + offsetof(struct __dsa_skb_cb, priv))

102
struct dsa_switch_tree {
103 104
	struct list_head	list;

V
Vivien Didelot 已提交
105 106 107
	/* Notifier chain for switch-wide events */
	struct raw_notifier_head	nh;

108
	/* Tree identifier */
109
	unsigned int index;
110 111 112 113 114

	/* Number of switches attached to this tree */
	struct kref refcount;

	/* Has this tree been applied to the hardware? */
V
Vivien Didelot 已提交
115
	bool setup;
116

117 118 119 120 121 122 123
	/*
	 * Configuration data for the platform device that owns
	 * this dsa switch tree instance.
	 */
	struct dsa_platform_data	*pd;

	/*
124
	 * The switch port to which the CPU is attached.
125
	 */
126
	struct dsa_port		*cpu_dp;
127

128 129 130
	/* List of switch ports */
	struct list_head ports;

131 132 133 134 135 136
	/*
	 * Data for the individual switch chips.
	 */
	struct dsa_switch	*ds[DSA_MAX_SWITCHES];
};

137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158
/* TC matchall action types, only mirroring for now */
enum dsa_port_mall_action_type {
	DSA_PORT_MALL_MIRROR,
};

/* TC mirroring entry */
struct dsa_mall_mirror_tc_entry {
	u8 to_local_port;
	bool ingress;
};

/* TC matchall entry */
struct dsa_mall_tc_entry {
	struct list_head list;
	unsigned long cookie;
	enum dsa_port_mall_action_type type;
	union {
		struct dsa_mall_mirror_tc_entry mirror;
	};
};


159
struct dsa_port {
160 161 162 163 164 165 166 167
	/* A CPU port is physically connected to a master device.
	 * A user port exposed to userspace has a slave device.
	 */
	union {
		struct net_device *master;
		struct net_device *slave;
	};

V
Vivien Didelot 已提交
168 169 170
	/* CPU port tagging operations used by master or slave devices */
	const struct dsa_device_ops *tag_ops;

171 172 173 174
	/* Copies for faster access in master receive hot path */
	struct dsa_switch_tree *dst;
	struct sk_buff *(*rcv)(struct sk_buff *skb, struct net_device *dev,
			       struct packet_type *pt);
175
	bool (*filter)(const struct sk_buff *skb, struct net_device *dev);
176

V
Vivien Didelot 已提交
177 178 179 180 181 182 183
	enum {
		DSA_PORT_TYPE_UNUSED = 0,
		DSA_PORT_TYPE_CPU,
		DSA_PORT_TYPE_DSA,
		DSA_PORT_TYPE_USER,
	} type;

184 185
	struct dsa_switch	*ds;
	unsigned int		index;
186
	const char		*name;
V
Vivien Didelot 已提交
187
	struct dsa_port		*cpu_dp;
188
	const char		*mac;
189
	struct device_node	*dn;
190
	unsigned int		ageing_time;
191
	bool			vlan_filtering;
V
Vivien Didelot 已提交
192
	u8			stp_state;
193
	struct net_device	*bridge_dev;
194
	struct devlink_port	devlink_port;
195
	struct phylink		*pl;
196
	struct phylink_config	pl_config;
197 198 199 200

	struct work_struct	xmit_work;
	struct sk_buff_head	xmit_queue;

201 202
	struct list_head list;

203 204 205 206 207 208
	/*
	 * Give the switch driver somewhere to hang its per-port private data
	 * structures (accessible from the tagger).
	 */
	void *priv;

209 210 211 212
	/*
	 * Original copy of the master netdev ethtool_ops
	 */
	const struct ethtool_ops *orig_ethtool_ops;
213 214 215 216 217

	/*
	 * Original copy of the master netdev net_device_ops
	 */
	const struct net_device_ops *orig_ndo_ops;
218 219
};

220
struct dsa_switch {
221 222
	struct device *dev;

223 224 225 226
	/*
	 * Parent switch tree, and switch index.
	 */
	struct dsa_switch_tree	*dst;
227
	unsigned int		index;
228

V
Vivien Didelot 已提交
229 230 231
	/* Listener for switch fabric events */
	struct notifier_block	nb;

232 233 234 235 236 237
	/*
	 * Give the switch driver somewhere to hang its private data
	 * structure.
	 */
	void *priv;

238 239 240
	/*
	 * Configuration data for this switch.
	 */
A
Andrew Lunn 已提交
241
	struct dsa_chip_data	*cd;
242 243

	/*
244
	 * The switch operations.
245
	 */
246
	const struct dsa_switch_ops	*ops;
247

248 249 250 251 252 253 254
	/*
	 * An array of which element [a] indicates which port on this
	 * switch should be used to send packets to that are destined
	 * for switch a. Can be NULL if there is only one switch chip.
	 */
	s8		rtable[DSA_MAX_SWITCHES];

255 256 257
	/*
	 * Slave mii_bus and devices for the individual ports.
	 */
258
	u32			phys_mii_mask;
259
	struct mii_bus		*slave_mii_bus;
260

261 262 263 264
	/* Ageing Time limits in msecs */
	unsigned int ageing_time_min;
	unsigned int ageing_time_max;

265 266 267
	/* devlink used to represent this switch device */
	struct devlink		*devlink;

268 269 270
	/* Number of switch port queues */
	unsigned int		num_tx_queues;

271 272 273 274 275
	/* Disallow bridge core from requesting different VLAN awareness
	 * settings on ports if not hardware-supported
	 */
	bool			vlan_filtering_is_global;

276 277 278 279 280
	/* In case vlan_filtering_is_global is set, the VLAN awareness state
	 * should be retrieved from here and not from the per-port settings.
	 */
	bool			vlan_filtering;

281 282 283
	/* Dynamically allocated ports, keep last */
	size_t num_ports;
	struct dsa_port ports[];
284 285
};

286
static inline struct dsa_port *dsa_to_port(struct dsa_switch *ds, int p)
287
{
288 289 290 291 292 293 294 295
	struct dsa_switch_tree *dst = ds->dst;
	struct dsa_port *dp = NULL;

	list_for_each_entry(dp, &dst->ports, list)
		if (dp->ds == ds && dp->index == p)
			break;

	return dp;
296
}
297

298 299 300
static inline bool dsa_is_unused_port(struct dsa_switch *ds, int p)
{
	return dsa_to_port(ds, p)->type == DSA_PORT_TYPE_UNUSED;
301 302
}

303 304
static inline bool dsa_is_cpu_port(struct dsa_switch *ds, int p)
{
305
	return dsa_to_port(ds, p)->type == DSA_PORT_TYPE_CPU;
306 307
}

308 309
static inline bool dsa_is_dsa_port(struct dsa_switch *ds, int p)
{
310
	return dsa_to_port(ds, p)->type == DSA_PORT_TYPE_DSA;
311 312
}

313
static inline bool dsa_is_user_port(struct dsa_switch *ds, int p)
314
{
315
	return dsa_to_port(ds, p)->type == DSA_PORT_TYPE_USER;
316 317
}

318 319
static inline u32 dsa_user_ports(struct dsa_switch *ds)
{
320 321
	u32 mask = 0;
	int p;
322

323 324 325 326 327
	for (p = 0; p < ds->num_ports; p++)
		if (dsa_is_user_port(ds, p))
			mask |= BIT(p);

	return mask;
V
Vivien Didelot 已提交
328 329
}

330 331 332 333 334 335 336 337 338 339 340
/* Return the local port used to reach an arbitrary switch port */
static inline unsigned int dsa_towards_port(struct dsa_switch *ds, int device,
					    int port)
{
	if (device == ds->index)
		return port;
	else
		return ds->rtable[device];
}

/* Return the local port used to reach the dedicated CPU port */
341
static inline unsigned int dsa_upstream_port(struct dsa_switch *ds, int port)
342
{
343 344 345 346 347
	const struct dsa_port *dp = dsa_to_port(ds, port);
	const struct dsa_port *cpu_dp = dp->cpu_dp;

	if (!cpu_dp)
		return port;
348

349
	return dsa_towards_port(ds, cpu_dp->ds->index, cpu_dp->index);
350 351
}

352 353 354 355 356 357 358 359 360 361
static inline bool dsa_port_is_vlan_filtering(const struct dsa_port *dp)
{
	const struct dsa_switch *ds = dp->ds;

	if (ds->vlan_filtering_is_global)
		return ds->vlan_filtering;
	else
		return dp->vlan_filtering;
}

362 363
typedef int dsa_fdb_dump_cb_t(const unsigned char *addr, u16 vid,
			      bool is_static, void *data);
364
struct dsa_switch_ops {
365 366
	enum dsa_tag_protocol (*get_tag_protocol)(struct dsa_switch *ds,
						  int port);
367

368
	int	(*setup)(struct dsa_switch *ds);
369
	void	(*teardown)(struct dsa_switch *ds);
370
	u32	(*get_phy_flags)(struct dsa_switch *ds, int port);
371 372 373 374 375 376 377 378

	/*
	 * Access to the switch's PHY registers.
	 */
	int	(*phy_read)(struct dsa_switch *ds, int port, int regnum);
	int	(*phy_write)(struct dsa_switch *ds, int port,
			     int regnum, u16 val);

379 380 381 382 383
	/*
	 * Link state adjustment (called from libphy)
	 */
	void	(*adjust_link)(struct dsa_switch *ds, int port,
				struct phy_device *phydev);
384 385
	void	(*fixed_link_update)(struct dsa_switch *ds, int port,
				struct fixed_phy_status *st);
386

387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407
	/*
	 * PHYLINK integration
	 */
	void	(*phylink_validate)(struct dsa_switch *ds, int port,
				    unsigned long *supported,
				    struct phylink_link_state *state);
	int	(*phylink_mac_link_state)(struct dsa_switch *ds, int port,
					  struct phylink_link_state *state);
	void	(*phylink_mac_config)(struct dsa_switch *ds, int port,
				      unsigned int mode,
				      const struct phylink_link_state *state);
	void	(*phylink_mac_an_restart)(struct dsa_switch *ds, int port);
	void	(*phylink_mac_link_down)(struct dsa_switch *ds, int port,
					 unsigned int mode,
					 phy_interface_t interface);
	void	(*phylink_mac_link_up)(struct dsa_switch *ds, int port,
				       unsigned int mode,
				       phy_interface_t interface,
				       struct phy_device *phydev);
	void	(*phylink_fixed_state)(struct dsa_switch *ds, int port,
				       struct phylink_link_state *state);
408 409 410
	/*
	 * ethtool hardware statistics.
	 */
411 412
	void	(*get_strings)(struct dsa_switch *ds, int port,
			       u32 stringset, uint8_t *data);
413 414
	void	(*get_ethtool_stats)(struct dsa_switch *ds,
				     int port, uint64_t *data);
415
	int	(*get_sset_count)(struct dsa_switch *ds, int port, int sset);
416 417
	void	(*get_ethtool_phy_stats)(struct dsa_switch *ds,
					 int port, uint64_t *data);
418

419 420 421 422 423 424 425 426
	/*
	 * ethtool Wake-on-LAN
	 */
	void	(*get_wol)(struct dsa_switch *ds, int port,
			   struct ethtool_wolinfo *w);
	int	(*set_wol)(struct dsa_switch *ds, int port,
			   struct ethtool_wolinfo *w);

427 428 429 430 431 432
	/*
	 * ethtool timestamp info
	 */
	int	(*get_ts_info)(struct dsa_switch *ds, int port,
			       struct ethtool_ts_info *ts);

433 434 435 436 437
	/*
	 * Suspend and resume
	 */
	int	(*suspend)(struct dsa_switch *ds);
	int	(*resume)(struct dsa_switch *ds);
438 439 440 441 442 443

	/*
	 * Port enable/disable
	 */
	int	(*port_enable)(struct dsa_switch *ds, int port,
			       struct phy_device *phy);
444
	void	(*port_disable)(struct dsa_switch *ds, int port);
445 446

	/*
V
Vivien Didelot 已提交
447
	 * Port's MAC EEE settings
448
	 */
V
Vivien Didelot 已提交
449 450 451 452
	int	(*set_mac_eee)(struct dsa_switch *ds, int port,
			       struct ethtool_eee *e);
	int	(*get_mac_eee)(struct dsa_switch *ds, int port,
			       struct ethtool_eee *e);
453

454 455 456 457 458 459
	/* EEPROM access */
	int	(*get_eeprom_len)(struct dsa_switch *ds);
	int	(*get_eeprom)(struct dsa_switch *ds,
			      struct ethtool_eeprom *eeprom, u8 *data);
	int	(*set_eeprom)(struct dsa_switch *ds,
			      struct ethtool_eeprom *eeprom, u8 *data);
460 461 462 463 464 465 466

	/*
	 * Register access.
	 */
	int	(*get_regs_len)(struct dsa_switch *ds, int port);
	void	(*get_regs)(struct dsa_switch *ds, int port,
			    struct ethtool_regs *regs, void *p);
467 468 469 470

	/*
	 * Bridge integration
	 */
471
	int	(*set_ageing_time)(struct dsa_switch *ds, unsigned int msecs);
472
	int	(*port_bridge_join)(struct dsa_switch *ds, int port,
473
				    struct net_device *bridge);
474 475
	void	(*port_bridge_leave)(struct dsa_switch *ds, int port,
				     struct net_device *bridge);
476 477
	void	(*port_stp_state_set)(struct dsa_switch *ds, int port,
				      u8 state);
V
Vivien Didelot 已提交
478
	void	(*port_fast_age)(struct dsa_switch *ds, int port);
479 480
	int	(*port_egress_floods)(struct dsa_switch *ds, int port,
				      bool unicast, bool multicast);
481

482 483 484
	/*
	 * VLAN support
	 */
485 486
	int	(*port_vlan_filtering)(struct dsa_switch *ds, int port,
				       bool vlan_filtering);
487 488 489 490
	int (*port_vlan_prepare)(struct dsa_switch *ds, int port,
				 const struct switchdev_obj_port_vlan *vlan);
	void (*port_vlan_add)(struct dsa_switch *ds, int port,
			      const struct switchdev_obj_port_vlan *vlan);
491 492
	int	(*port_vlan_del)(struct dsa_switch *ds, int port,
				 const struct switchdev_obj_port_vlan *vlan);
493 494 495
	/*
	 * Forwarding database
	 */
496
	int	(*port_fdb_add)(struct dsa_switch *ds, int port,
497
				const unsigned char *addr, u16 vid);
498
	int	(*port_fdb_del)(struct dsa_switch *ds, int port,
499
				const unsigned char *addr, u16 vid);
500
	int	(*port_fdb_dump)(struct dsa_switch *ds, int port,
501
				 dsa_fdb_dump_cb_t *cb, void *data);
V
Vivien Didelot 已提交
502 503 504 505

	/*
	 * Multicast database
	 */
506 507 508 509
	int (*port_mdb_prepare)(struct dsa_switch *ds, int port,
				const struct switchdev_obj_port_mdb *mdb);
	void (*port_mdb_add)(struct dsa_switch *ds, int port,
			     const struct switchdev_obj_port_mdb *mdb);
V
Vivien Didelot 已提交
510 511
	int	(*port_mdb_del)(struct dsa_switch *ds, int port,
				const struct switchdev_obj_port_mdb *mdb);
512 513 514 515 516 517 518
	/*
	 * RXNFC
	 */
	int	(*get_rxnfc)(struct dsa_switch *ds, int port,
			     struct ethtool_rxnfc *nfc, u32 *rule_locs);
	int	(*set_rxnfc)(struct dsa_switch *ds, int port,
			     struct ethtool_rxnfc *nfc);
519 520 521 522 523 524 525 526 527

	/*
	 * TC integration
	 */
	int	(*port_mirror_add)(struct dsa_switch *ds, int port,
				   struct dsa_mall_mirror_tc_entry *mirror,
				   bool ingress);
	void	(*port_mirror_del)(struct dsa_switch *ds, int port,
				   struct dsa_mall_mirror_tc_entry *mirror);
528 529
	int	(*port_setup_tc)(struct dsa_switch *ds, int port,
				 enum tc_setup_type type, void *type_data);
530 531 532 533 534 535 536 537

	/*
	 * Cross-chip operations
	 */
	int	(*crosschip_bridge_join)(struct dsa_switch *ds, int sw_index,
					 int port, struct net_device *br);
	void	(*crosschip_bridge_leave)(struct dsa_switch *ds, int sw_index,
					  int port, struct net_device *br);
538 539 540 541 542 543 544 545

	/*
	 * PTP functionality
	 */
	int	(*port_hwtstamp_get)(struct dsa_switch *ds, int port,
				     struct ifreq *ifr);
	int	(*port_hwtstamp_set)(struct dsa_switch *ds, int port,
				     struct ifreq *ifr);
546 547 548 549
	bool	(*port_txtstamp)(struct dsa_switch *ds, int port,
				 struct sk_buff *clone, unsigned int type);
	bool	(*port_rxtstamp)(struct dsa_switch *ds, int port,
				 struct sk_buff *skb, unsigned int type);
550 551 552 553 554 555

	/*
	 * Deferred frame Tx
	 */
	netdev_tx_t (*port_deferred_xmit)(struct dsa_switch *ds, int port,
					  struct sk_buff *skb);
556 557
};

558 559
struct dsa_switch_driver {
	struct list_head	list;
560
	const struct dsa_switch_ops *ops;
561 562
};

563
struct net_device *dsa_dev_to_net_device(struct device *dev);
564

565
/* Keep inline for faster access in hot path */
566 567 568
static inline bool netdev_uses_dsa(struct net_device *dev)
{
#if IS_ENABLED(CONFIG_NET_DSA)
569
	return dev->dsa_ptr && dev->dsa_ptr->rcv;
570 571 572 573
#endif
	return false;
}

574 575 576 577 578 579 580 581 582
static inline bool dsa_can_decode(const struct sk_buff *skb,
				  struct net_device *dev)
{
#if IS_ENABLED(CONFIG_NET_DSA)
	return !dev->dsa_ptr->filter || dev->dsa_ptr->filter(skb, dev);
#endif
	return false;
}

583
struct dsa_switch *dsa_switch_alloc(struct device *dev, size_t n);
584
void dsa_unregister_switch(struct dsa_switch *ds);
585
int dsa_register_switch(struct dsa_switch *ds);
586 587 588 589 590 591 592 593 594 595 596 597 598 599
#ifdef CONFIG_PM_SLEEP
int dsa_switch_suspend(struct dsa_switch *ds);
int dsa_switch_resume(struct dsa_switch *ds);
#else
static inline int dsa_switch_suspend(struct dsa_switch *ds)
{
	return 0;
}
static inline int dsa_switch_resume(struct dsa_switch *ds)
{
	return 0;
}
#endif /* CONFIG_PM_SLEEP */

600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644
enum dsa_notifier_type {
	DSA_PORT_REGISTER,
	DSA_PORT_UNREGISTER,
};

struct dsa_notifier_info {
	struct net_device *dev;
};

struct dsa_notifier_register_info {
	struct dsa_notifier_info info;	/* must be first */
	struct net_device *master;
	unsigned int port_number;
	unsigned int switch_number;
};

static inline struct net_device *
dsa_notifier_info_to_dev(const struct dsa_notifier_info *info)
{
	return info->dev;
}

#if IS_ENABLED(CONFIG_NET_DSA)
int register_dsa_notifier(struct notifier_block *nb);
int unregister_dsa_notifier(struct notifier_block *nb);
int call_dsa_notifiers(unsigned long val, struct net_device *dev,
		       struct dsa_notifier_info *info);
#else
static inline int register_dsa_notifier(struct notifier_block *nb)
{
	return 0;
}

static inline int unregister_dsa_notifier(struct notifier_block *nb)
{
	return 0;
}

static inline int call_dsa_notifiers(unsigned long val, struct net_device *dev,
				     struct dsa_notifier_info *info)
{
	return NOTIFY_DONE;
}
#endif

645 646 647 648 649
/* Broadcom tag specific helpers to insert and extract queue/port number */
#define BRCM_TAG_SET_PORT_QUEUE(p, q)	((p) << 8 | q)
#define BRCM_TAG_GET_PORT(v)		((v) >> 8)
#define BRCM_TAG_GET_QUEUE(v)		((v) & 0xff)

650

651
netdev_tx_t dsa_enqueue_skb(struct sk_buff *skb, struct net_device *dev);
652 653 654
int dsa_port_get_phy_strings(struct dsa_port *dp, uint8_t *data);
int dsa_port_get_ethtool_phy_stats(struct dsa_port *dp, uint64_t *data);
int dsa_port_get_phy_sset_count(struct dsa_port *dp);
655
void dsa_port_phylink_mac_change(struct dsa_switch *ds, int port, bool up);
656

657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 720 721
struct dsa_tag_driver {
	const struct dsa_device_ops *ops;
	struct list_head list;
	struct module *owner;
};

void dsa_tag_drivers_register(struct dsa_tag_driver *dsa_tag_driver_array[],
			      unsigned int count,
			      struct module *owner);
void dsa_tag_drivers_unregister(struct dsa_tag_driver *dsa_tag_driver_array[],
				unsigned int count);

#define dsa_tag_driver_module_drivers(__dsa_tag_drivers_array, __count)	\
static int __init dsa_tag_driver_module_init(void)			\
{									\
	dsa_tag_drivers_register(__dsa_tag_drivers_array, __count,	\
				 THIS_MODULE);				\
	return 0;							\
}									\
module_init(dsa_tag_driver_module_init);				\
									\
static void __exit dsa_tag_driver_module_exit(void)			\
{									\
	dsa_tag_drivers_unregister(__dsa_tag_drivers_array, __count);	\
}									\
module_exit(dsa_tag_driver_module_exit)

/**
 * module_dsa_tag_drivers() - Helper macro for registering DSA tag
 * drivers
 * @__ops_array: Array of tag driver strucutres
 *
 * Helper macro for DSA tag drivers which do not do anything special
 * in module init/exit. Each module may only use this macro once, and
 * calling it replaces module_init() and module_exit().
 */
#define module_dsa_tag_drivers(__ops_array)				\
dsa_tag_driver_module_drivers(__ops_array, ARRAY_SIZE(__ops_array))

#define DSA_TAG_DRIVER_NAME(__ops) dsa_tag_driver ## _ ## __ops

/* Create a static structure we can build a linked list of dsa_tag
 * drivers
 */
#define DSA_TAG_DRIVER(__ops)						\
static struct dsa_tag_driver DSA_TAG_DRIVER_NAME(__ops) = {		\
	.ops = &__ops,							\
}

/**
 * module_dsa_tag_driver() - Helper macro for registering a single DSA tag
 * driver
 * @__ops: Single tag driver structures
 *
 * Helper macro for DSA tag drivers which do not do anything special
 * in module init/exit. Each module may only use this macro once, and
 * calling it replaces module_init() and module_exit().
 */
#define module_dsa_tag_driver(__ops)					\
DSA_TAG_DRIVER(__ops);							\
									\
static struct dsa_tag_driver *dsa_tag_driver_array[] =	{		\
	&DSA_TAG_DRIVER_NAME(__ops)					\
};									\
module_dsa_tag_drivers(dsa_tag_driver_array)
722
#endif
723