1 /* SPDX-License-Identifier: GPL-2.0-or-later */
3 * include/net/dsa.h - Driver for Distributed Switch Architecture switch chips
4 * Copyright (c) 2008-2009 Marvell Semiconductor
7 #ifndef __LINUX_NET_DSA_H
8 #define __LINUX_NET_DSA_H
11 #include <linux/if_ether.h>
12 #include <linux/list.h>
13 #include <linux/notifier.h>
14 #include <linux/timer.h>
15 #include <linux/workqueue.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>
27 struct fixed_phy_status;
28 struct phylink_link_state;
30 #define DSA_TAG_PROTO_NONE_VALUE 0
31 #define DSA_TAG_PROTO_BRCM_VALUE 1
32 #define DSA_TAG_PROTO_BRCM_PREPEND_VALUE 2
33 #define DSA_TAG_PROTO_DSA_VALUE 3
34 #define DSA_TAG_PROTO_EDSA_VALUE 4
35 #define DSA_TAG_PROTO_GSWIP_VALUE 5
36 #define DSA_TAG_PROTO_KSZ9477_VALUE 6
37 #define DSA_TAG_PROTO_KSZ9893_VALUE 7
38 #define DSA_TAG_PROTO_LAN9303_VALUE 8
39 #define DSA_TAG_PROTO_MTK_VALUE 9
40 #define DSA_TAG_PROTO_QCA_VALUE 10
41 #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 #define DSA_TAG_PROTO_OCELOT_VALUE 15
47 enum dsa_tag_protocol {
48 DSA_TAG_PROTO_NONE = DSA_TAG_PROTO_NONE_VALUE,
49 DSA_TAG_PROTO_BRCM = DSA_TAG_PROTO_BRCM_VALUE,
50 DSA_TAG_PROTO_BRCM_PREPEND = DSA_TAG_PROTO_BRCM_PREPEND_VALUE,
51 DSA_TAG_PROTO_DSA = DSA_TAG_PROTO_DSA_VALUE,
52 DSA_TAG_PROTO_EDSA = DSA_TAG_PROTO_EDSA_VALUE,
53 DSA_TAG_PROTO_GSWIP = DSA_TAG_PROTO_GSWIP_VALUE,
54 DSA_TAG_PROTO_KSZ9477 = DSA_TAG_PROTO_KSZ9477_VALUE,
55 DSA_TAG_PROTO_KSZ9893 = DSA_TAG_PROTO_KSZ9893_VALUE,
56 DSA_TAG_PROTO_LAN9303 = DSA_TAG_PROTO_LAN9303_VALUE,
57 DSA_TAG_PROTO_MTK = DSA_TAG_PROTO_MTK_VALUE,
58 DSA_TAG_PROTO_QCA = DSA_TAG_PROTO_QCA_VALUE,
59 DSA_TAG_PROTO_TRAILER = DSA_TAG_PROTO_TRAILER_VALUE,
60 DSA_TAG_PROTO_8021Q = DSA_TAG_PROTO_8021Q_VALUE,
61 DSA_TAG_PROTO_SJA1105 = DSA_TAG_PROTO_SJA1105_VALUE,
62 DSA_TAG_PROTO_KSZ8795 = DSA_TAG_PROTO_KSZ8795_VALUE,
63 DSA_TAG_PROTO_OCELOT = DSA_TAG_PROTO_OCELOT_VALUE,
69 struct dsa_device_ops {
70 struct sk_buff *(*xmit)(struct sk_buff *skb, struct net_device *dev);
71 struct sk_buff *(*rcv)(struct sk_buff *skb, struct net_device *dev,
72 struct packet_type *pt);
73 int (*flow_dissect)(const struct sk_buff *skb, __be16 *proto,
75 /* Used to determine which traffic should match the DSA filter in
76 * eth_type_trans, and which, if any, should bypass it and be processed
77 * as regular on the master net device.
79 bool (*filter)(const struct sk_buff *skb, struct net_device *dev);
80 unsigned int overhead;
82 enum dsa_tag_protocol proto;
85 #define DSA_TAG_DRIVER_ALIAS "dsa_tag-"
86 #define MODULE_ALIAS_DSA_TAG_DRIVER(__proto) \
87 MODULE_ALIAS(DSA_TAG_DRIVER_ALIAS __stringify(__proto##_VALUE))
90 struct sk_buff *clone;
96 u8 priv[48 - sizeof(struct dsa_skb_cb)];
99 #define DSA_SKB_CB(skb) ((struct dsa_skb_cb *)((skb)->cb))
101 #define DSA_SKB_CB_PRIV(skb) \
102 ((void *)(skb)->cb + offsetof(struct __dsa_skb_cb, priv))
104 struct dsa_switch_tree {
105 struct list_head list;
107 /* Notifier chain for switch-wide events */
108 struct raw_notifier_head nh;
110 /* Tree identifier */
113 /* Number of switches attached to this tree */
114 struct kref refcount;
116 /* Has this tree been applied to the hardware? */
120 * Configuration data for the platform device that owns
121 * this dsa switch tree instance.
123 struct dsa_platform_data *pd;
125 /* List of switch ports */
126 struct list_head ports;
128 /* List of DSA links composing the routing table */
129 struct list_head rtable;
132 /* TC matchall action types, only mirroring for now */
133 enum dsa_port_mall_action_type {
134 DSA_PORT_MALL_MIRROR,
137 /* TC mirroring entry */
138 struct dsa_mall_mirror_tc_entry {
143 /* TC matchall entry */
144 struct dsa_mall_tc_entry {
145 struct list_head list;
146 unsigned long cookie;
147 enum dsa_port_mall_action_type type;
149 struct dsa_mall_mirror_tc_entry mirror;
155 /* A CPU port is physically connected to a master device.
156 * A user port exposed to userspace has a slave device.
159 struct net_device *master;
160 struct net_device *slave;
163 /* CPU port tagging operations used by master or slave devices */
164 const struct dsa_device_ops *tag_ops;
166 /* Copies for faster access in master receive hot path */
167 struct dsa_switch_tree *dst;
168 struct sk_buff *(*rcv)(struct sk_buff *skb, struct net_device *dev,
169 struct packet_type *pt);
170 bool (*filter)(const struct sk_buff *skb, struct net_device *dev);
173 DSA_PORT_TYPE_UNUSED = 0,
179 struct dsa_switch *ds;
182 struct dsa_port *cpu_dp;
184 struct device_node *dn;
185 unsigned int ageing_time;
188 struct net_device *bridge_dev;
189 struct devlink_port devlink_port;
191 struct phylink_config pl_config;
193 struct work_struct xmit_work;
194 struct sk_buff_head xmit_queue;
196 struct list_head list;
199 * Give the switch driver somewhere to hang its per-port private data
200 * structures (accessible from the tagger).
205 * Original copy of the master netdev ethtool_ops
207 const struct ethtool_ops *orig_ethtool_ops;
210 * Original copy of the master netdev net_device_ops
212 const struct net_device_ops *orig_ndo_ops;
217 /* TODO: ideally DSA ports would have a single dp->link_dp member,
218 * and no dst->rtable nor this struct dsa_link would be needed,
219 * but this would require some more complex tree walking,
220 * so keep it stupid at the moment and list them all.
224 struct dsa_port *link_dp;
225 struct list_head list;
234 * Parent switch tree, and switch index.
236 struct dsa_switch_tree *dst;
239 /* Listener for switch fabric events */
240 struct notifier_block nb;
243 * Give the switch driver somewhere to hang its private data
249 * Configuration data for this switch.
251 struct dsa_chip_data *cd;
254 * The switch operations.
256 const struct dsa_switch_ops *ops;
259 * Slave mii_bus and devices for the individual ports.
262 struct mii_bus *slave_mii_bus;
264 /* Ageing Time limits in msecs */
265 unsigned int ageing_time_min;
266 unsigned int ageing_time_max;
268 /* devlink used to represent this switch device */
269 struct devlink *devlink;
271 /* Number of switch port queues */
272 unsigned int num_tx_queues;
274 /* Disallow bridge core from requesting different VLAN awareness
275 * settings on ports if not hardware-supported
277 bool vlan_filtering_is_global;
279 /* In case vlan_filtering_is_global is set, the VLAN awareness state
280 * should be retrieved from here and not from the per-port settings.
287 static inline struct dsa_port *dsa_to_port(struct dsa_switch *ds, int p)
289 struct dsa_switch_tree *dst = ds->dst;
292 list_for_each_entry(dp, &dst->ports, list)
293 if (dp->ds == ds && dp->index == p)
299 static inline bool dsa_is_unused_port(struct dsa_switch *ds, int p)
301 return dsa_to_port(ds, p)->type == DSA_PORT_TYPE_UNUSED;
304 static inline bool dsa_is_cpu_port(struct dsa_switch *ds, int p)
306 return dsa_to_port(ds, p)->type == DSA_PORT_TYPE_CPU;
309 static inline bool dsa_is_dsa_port(struct dsa_switch *ds, int p)
311 return dsa_to_port(ds, p)->type == DSA_PORT_TYPE_DSA;
314 static inline bool dsa_is_user_port(struct dsa_switch *ds, int p)
316 return dsa_to_port(ds, p)->type == DSA_PORT_TYPE_USER;
319 static inline u32 dsa_user_ports(struct dsa_switch *ds)
324 for (p = 0; p < ds->num_ports; p++)
325 if (dsa_is_user_port(ds, p))
331 /* Return the local port used to reach an arbitrary switch device */
332 static inline unsigned int dsa_routing_port(struct dsa_switch *ds, int device)
334 struct dsa_switch_tree *dst = ds->dst;
337 list_for_each_entry(dl, &dst->rtable, list)
338 if (dl->dp->ds == ds && dl->link_dp->ds->index == device)
339 return dl->dp->index;
341 return ds->num_ports;
344 /* Return the local port used to reach an arbitrary switch port */
345 static inline unsigned int dsa_towards_port(struct dsa_switch *ds, int device,
348 if (device == ds->index)
351 return dsa_routing_port(ds, device);
354 /* Return the local port used to reach the dedicated CPU port */
355 static inline unsigned int dsa_upstream_port(struct dsa_switch *ds, int port)
357 const struct dsa_port *dp = dsa_to_port(ds, port);
358 const struct dsa_port *cpu_dp = dp->cpu_dp;
363 return dsa_towards_port(ds, cpu_dp->ds->index, cpu_dp->index);
366 static inline bool dsa_port_is_vlan_filtering(const struct dsa_port *dp)
368 const struct dsa_switch *ds = dp->ds;
370 if (ds->vlan_filtering_is_global)
371 return ds->vlan_filtering;
373 return dp->vlan_filtering;
376 typedef int dsa_fdb_dump_cb_t(const unsigned char *addr, u16 vid,
377 bool is_static, void *data);
378 struct dsa_switch_ops {
379 enum dsa_tag_protocol (*get_tag_protocol)(struct dsa_switch *ds,
382 int (*setup)(struct dsa_switch *ds);
383 void (*teardown)(struct dsa_switch *ds);
384 u32 (*get_phy_flags)(struct dsa_switch *ds, int port);
387 * Access to the switch's PHY registers.
389 int (*phy_read)(struct dsa_switch *ds, int port, int regnum);
390 int (*phy_write)(struct dsa_switch *ds, int port,
391 int regnum, u16 val);
394 * Link state adjustment (called from libphy)
396 void (*adjust_link)(struct dsa_switch *ds, int port,
397 struct phy_device *phydev);
398 void (*fixed_link_update)(struct dsa_switch *ds, int port,
399 struct fixed_phy_status *st);
402 * PHYLINK integration
404 void (*phylink_validate)(struct dsa_switch *ds, int port,
405 unsigned long *supported,
406 struct phylink_link_state *state);
407 int (*phylink_mac_link_state)(struct dsa_switch *ds, int port,
408 struct phylink_link_state *state);
409 void (*phylink_mac_config)(struct dsa_switch *ds, int port,
411 const struct phylink_link_state *state);
412 void (*phylink_mac_an_restart)(struct dsa_switch *ds, int port);
413 void (*phylink_mac_link_down)(struct dsa_switch *ds, int port,
415 phy_interface_t interface);
416 void (*phylink_mac_link_up)(struct dsa_switch *ds, int port,
418 phy_interface_t interface,
419 struct phy_device *phydev);
420 void (*phylink_fixed_state)(struct dsa_switch *ds, int port,
421 struct phylink_link_state *state);
423 * ethtool hardware statistics.
425 void (*get_strings)(struct dsa_switch *ds, int port,
426 u32 stringset, uint8_t *data);
427 void (*get_ethtool_stats)(struct dsa_switch *ds,
428 int port, uint64_t *data);
429 int (*get_sset_count)(struct dsa_switch *ds, int port, int sset);
430 void (*get_ethtool_phy_stats)(struct dsa_switch *ds,
431 int port, uint64_t *data);
434 * ethtool Wake-on-LAN
436 void (*get_wol)(struct dsa_switch *ds, int port,
437 struct ethtool_wolinfo *w);
438 int (*set_wol)(struct dsa_switch *ds, int port,
439 struct ethtool_wolinfo *w);
442 * ethtool timestamp info
444 int (*get_ts_info)(struct dsa_switch *ds, int port,
445 struct ethtool_ts_info *ts);
450 int (*suspend)(struct dsa_switch *ds);
451 int (*resume)(struct dsa_switch *ds);
454 * Port enable/disable
456 int (*port_enable)(struct dsa_switch *ds, int port,
457 struct phy_device *phy);
458 void (*port_disable)(struct dsa_switch *ds, int port);
461 * Port's MAC EEE settings
463 int (*set_mac_eee)(struct dsa_switch *ds, int port,
464 struct ethtool_eee *e);
465 int (*get_mac_eee)(struct dsa_switch *ds, int port,
466 struct ethtool_eee *e);
469 int (*get_eeprom_len)(struct dsa_switch *ds);
470 int (*get_eeprom)(struct dsa_switch *ds,
471 struct ethtool_eeprom *eeprom, u8 *data);
472 int (*set_eeprom)(struct dsa_switch *ds,
473 struct ethtool_eeprom *eeprom, u8 *data);
478 int (*get_regs_len)(struct dsa_switch *ds, int port);
479 void (*get_regs)(struct dsa_switch *ds, int port,
480 struct ethtool_regs *regs, void *p);
485 int (*set_ageing_time)(struct dsa_switch *ds, unsigned int msecs);
486 int (*port_bridge_join)(struct dsa_switch *ds, int port,
487 struct net_device *bridge);
488 void (*port_bridge_leave)(struct dsa_switch *ds, int port,
489 struct net_device *bridge);
490 void (*port_stp_state_set)(struct dsa_switch *ds, int port,
492 void (*port_fast_age)(struct dsa_switch *ds, int port);
493 int (*port_egress_floods)(struct dsa_switch *ds, int port,
494 bool unicast, bool multicast);
499 int (*port_vlan_filtering)(struct dsa_switch *ds, int port,
500 bool vlan_filtering);
501 int (*port_vlan_prepare)(struct dsa_switch *ds, int port,
502 const struct switchdev_obj_port_vlan *vlan);
503 void (*port_vlan_add)(struct dsa_switch *ds, int port,
504 const struct switchdev_obj_port_vlan *vlan);
505 int (*port_vlan_del)(struct dsa_switch *ds, int port,
506 const struct switchdev_obj_port_vlan *vlan);
508 * Forwarding database
510 int (*port_fdb_add)(struct dsa_switch *ds, int port,
511 const unsigned char *addr, u16 vid);
512 int (*port_fdb_del)(struct dsa_switch *ds, int port,
513 const unsigned char *addr, u16 vid);
514 int (*port_fdb_dump)(struct dsa_switch *ds, int port,
515 dsa_fdb_dump_cb_t *cb, void *data);
520 int (*port_mdb_prepare)(struct dsa_switch *ds, int port,
521 const struct switchdev_obj_port_mdb *mdb);
522 void (*port_mdb_add)(struct dsa_switch *ds, int port,
523 const struct switchdev_obj_port_mdb *mdb);
524 int (*port_mdb_del)(struct dsa_switch *ds, int port,
525 const struct switchdev_obj_port_mdb *mdb);
529 int (*get_rxnfc)(struct dsa_switch *ds, int port,
530 struct ethtool_rxnfc *nfc, u32 *rule_locs);
531 int (*set_rxnfc)(struct dsa_switch *ds, int port,
532 struct ethtool_rxnfc *nfc);
537 int (*port_mirror_add)(struct dsa_switch *ds, int port,
538 struct dsa_mall_mirror_tc_entry *mirror,
540 void (*port_mirror_del)(struct dsa_switch *ds, int port,
541 struct dsa_mall_mirror_tc_entry *mirror);
542 int (*port_setup_tc)(struct dsa_switch *ds, int port,
543 enum tc_setup_type type, void *type_data);
546 * Cross-chip operations
548 int (*crosschip_bridge_join)(struct dsa_switch *ds, int sw_index,
549 int port, struct net_device *br);
550 void (*crosschip_bridge_leave)(struct dsa_switch *ds, int sw_index,
551 int port, struct net_device *br);
556 int (*port_hwtstamp_get)(struct dsa_switch *ds, int port,
558 int (*port_hwtstamp_set)(struct dsa_switch *ds, int port,
560 bool (*port_txtstamp)(struct dsa_switch *ds, int port,
561 struct sk_buff *clone, unsigned int type);
562 bool (*port_rxtstamp)(struct dsa_switch *ds, int port,
563 struct sk_buff *skb, unsigned int type);
568 netdev_tx_t (*port_deferred_xmit)(struct dsa_switch *ds, int port,
569 struct sk_buff *skb);
570 /* Devlink parameters */
571 int (*devlink_param_get)(struct dsa_switch *ds, u32 id,
572 struct devlink_param_gset_ctx *ctx);
573 int (*devlink_param_set)(struct dsa_switch *ds, u32 id,
574 struct devlink_param_gset_ctx *ctx);
577 #define DSA_DEVLINK_PARAM_DRIVER(_id, _name, _type, _cmodes) \
578 DEVLINK_PARAM_DRIVER(_id, _name, _type, _cmodes, \
579 dsa_devlink_param_get, dsa_devlink_param_set, NULL)
581 int dsa_devlink_param_get(struct devlink *dl, u32 id,
582 struct devlink_param_gset_ctx *ctx);
583 int dsa_devlink_param_set(struct devlink *dl, u32 id,
584 struct devlink_param_gset_ctx *ctx);
585 int dsa_devlink_params_register(struct dsa_switch *ds,
586 const struct devlink_param *params,
587 size_t params_count);
588 void dsa_devlink_params_unregister(struct dsa_switch *ds,
589 const struct devlink_param *params,
590 size_t params_count);
591 int dsa_devlink_resource_register(struct dsa_switch *ds,
592 const char *resource_name,
595 u64 parent_resource_id,
596 const struct devlink_resource_size_params *size_params);
598 void dsa_devlink_resources_unregister(struct dsa_switch *ds);
600 void dsa_devlink_resource_occ_get_register(struct dsa_switch *ds,
602 devlink_resource_occ_get_t *occ_get,
604 void dsa_devlink_resource_occ_get_unregister(struct dsa_switch *ds,
607 struct dsa_devlink_priv {
608 struct dsa_switch *ds;
611 struct dsa_switch_driver {
612 struct list_head list;
613 const struct dsa_switch_ops *ops;
616 struct net_device *dsa_dev_to_net_device(struct device *dev);
618 /* Keep inline for faster access in hot path */
619 static inline bool netdev_uses_dsa(struct net_device *dev)
621 #if IS_ENABLED(CONFIG_NET_DSA)
622 return dev->dsa_ptr && dev->dsa_ptr->rcv;
627 static inline bool dsa_can_decode(const struct sk_buff *skb,
628 struct net_device *dev)
630 #if IS_ENABLED(CONFIG_NET_DSA)
631 return !dev->dsa_ptr->filter || dev->dsa_ptr->filter(skb, dev);
636 void dsa_unregister_switch(struct dsa_switch *ds);
637 int dsa_register_switch(struct dsa_switch *ds);
638 #ifdef CONFIG_PM_SLEEP
639 int dsa_switch_suspend(struct dsa_switch *ds);
640 int dsa_switch_resume(struct dsa_switch *ds);
642 static inline int dsa_switch_suspend(struct dsa_switch *ds)
646 static inline int dsa_switch_resume(struct dsa_switch *ds)
650 #endif /* CONFIG_PM_SLEEP */
652 enum dsa_notifier_type {
657 struct dsa_notifier_info {
658 struct net_device *dev;
661 struct dsa_notifier_register_info {
662 struct dsa_notifier_info info; /* must be first */
663 struct net_device *master;
664 unsigned int port_number;
665 unsigned int switch_number;
668 static inline struct net_device *
669 dsa_notifier_info_to_dev(const struct dsa_notifier_info *info)
674 #if IS_ENABLED(CONFIG_NET_DSA)
675 int register_dsa_notifier(struct notifier_block *nb);
676 int unregister_dsa_notifier(struct notifier_block *nb);
677 int call_dsa_notifiers(unsigned long val, struct net_device *dev,
678 struct dsa_notifier_info *info);
680 static inline int register_dsa_notifier(struct notifier_block *nb)
685 static inline int unregister_dsa_notifier(struct notifier_block *nb)
690 static inline int call_dsa_notifiers(unsigned long val, struct net_device *dev,
691 struct dsa_notifier_info *info)
697 /* Broadcom tag specific helpers to insert and extract queue/port number */
698 #define BRCM_TAG_SET_PORT_QUEUE(p, q) ((p) << 8 | q)
699 #define BRCM_TAG_GET_PORT(v) ((v) >> 8)
700 #define BRCM_TAG_GET_QUEUE(v) ((v) & 0xff)
703 netdev_tx_t dsa_enqueue_skb(struct sk_buff *skb, struct net_device *dev);
704 int dsa_port_get_phy_strings(struct dsa_port *dp, uint8_t *data);
705 int dsa_port_get_ethtool_phy_stats(struct dsa_port *dp, uint64_t *data);
706 int dsa_port_get_phy_sset_count(struct dsa_port *dp);
707 void dsa_port_phylink_mac_change(struct dsa_switch *ds, int port, bool up);
709 struct dsa_tag_driver {
710 const struct dsa_device_ops *ops;
711 struct list_head list;
712 struct module *owner;
715 void dsa_tag_drivers_register(struct dsa_tag_driver *dsa_tag_driver_array[],
717 struct module *owner);
718 void dsa_tag_drivers_unregister(struct dsa_tag_driver *dsa_tag_driver_array[],
721 #define dsa_tag_driver_module_drivers(__dsa_tag_drivers_array, __count) \
722 static int __init dsa_tag_driver_module_init(void) \
724 dsa_tag_drivers_register(__dsa_tag_drivers_array, __count, \
728 module_init(dsa_tag_driver_module_init); \
730 static void __exit dsa_tag_driver_module_exit(void) \
732 dsa_tag_drivers_unregister(__dsa_tag_drivers_array, __count); \
734 module_exit(dsa_tag_driver_module_exit)
737 * module_dsa_tag_drivers() - Helper macro for registering DSA tag
739 * @__ops_array: Array of tag driver strucutres
741 * Helper macro for DSA tag drivers which do not do anything special
742 * in module init/exit. Each module may only use this macro once, and
743 * calling it replaces module_init() and module_exit().
745 #define module_dsa_tag_drivers(__ops_array) \
746 dsa_tag_driver_module_drivers(__ops_array, ARRAY_SIZE(__ops_array))
748 #define DSA_TAG_DRIVER_NAME(__ops) dsa_tag_driver ## _ ## __ops
750 /* Create a static structure we can build a linked list of dsa_tag
753 #define DSA_TAG_DRIVER(__ops) \
754 static struct dsa_tag_driver DSA_TAG_DRIVER_NAME(__ops) = { \
759 * module_dsa_tag_driver() - Helper macro for registering a single DSA tag
761 * @__ops: Single tag driver structures
763 * Helper macro for DSA tag drivers which do not do anything special
764 * in module init/exit. Each module may only use this macro once, and
765 * calling it replaces module_init() and module_exit().
767 #define module_dsa_tag_driver(__ops) \
768 DSA_TAG_DRIVER(__ops); \
770 static struct dsa_tag_driver *dsa_tag_driver_array[] = { \
771 &DSA_TAG_DRIVER_NAME(__ops) \
773 module_dsa_tag_drivers(dsa_tag_driver_array)