191da11f8SLennert Buytenhek /* 291da11f8SLennert Buytenhek * include/net/dsa.h - Driver for Distributed Switch Architecture switch chips 3e84665c9SLennert Buytenhek * Copyright (c) 2008-2009 Marvell Semiconductor 491da11f8SLennert Buytenhek * 591da11f8SLennert Buytenhek * This program is free software; you can redistribute it and/or modify 691da11f8SLennert Buytenhek * it under the terms of the GNU General Public License as published by 791da11f8SLennert Buytenhek * the Free Software Foundation; either version 2 of the License, or 891da11f8SLennert Buytenhek * (at your option) any later version. 991da11f8SLennert Buytenhek */ 1091da11f8SLennert Buytenhek 1191da11f8SLennert Buytenhek #ifndef __LINUX_NET_DSA_H 1291da11f8SLennert Buytenhek #define __LINUX_NET_DSA_H 1391da11f8SLennert Buytenhek 14ea1f51beSAxel Lin #include <linux/if_ether.h> 15c8f0b869SBen Hutchings #include <linux/list.h> 16cf50dcc2SBen Hutchings #include <linux/timer.h> 17cf50dcc2SBen Hutchings #include <linux/workqueue.h> 18fa981d9aSFlorian Fainelli #include <linux/of.h> 19cc30c163SAndrew Lunn #include <linux/of_gpio.h> 20ec9436baSFlorian Fainelli #include <linux/phy.h> 21ce31b31cSFlorian Fainelli #include <linux/phy_fixed.h> 22a2820543SFlorian Fainelli #include <linux/ethtool.h> 23cf50dcc2SBen Hutchings 24ac7a04c3SFlorian Fainelli enum dsa_tag_protocol { 25ac7a04c3SFlorian Fainelli DSA_TAG_PROTO_NONE = 0, 26ac7a04c3SFlorian Fainelli DSA_TAG_PROTO_DSA, 27ac7a04c3SFlorian Fainelli DSA_TAG_PROTO_TRAILER, 28ac7a04c3SFlorian Fainelli DSA_TAG_PROTO_EDSA, 29ac7a04c3SFlorian Fainelli DSA_TAG_PROTO_BRCM, 30ac7a04c3SFlorian Fainelli }; 315037d532SFlorian Fainelli 32e84665c9SLennert Buytenhek #define DSA_MAX_SWITCHES 4 3391da11f8SLennert Buytenhek #define DSA_MAX_PORTS 12 3491da11f8SLennert Buytenhek 35e84665c9SLennert Buytenhek struct dsa_chip_data { 36e84665c9SLennert Buytenhek /* 37e84665c9SLennert Buytenhek * How to access the switch configuration registers. 38e84665c9SLennert Buytenhek */ 39b4d2394dSAlexander Duyck struct device *host_dev; 40e84665c9SLennert Buytenhek int sw_addr; 41e84665c9SLennert Buytenhek 426793abb4SGuenter Roeck /* set to size of eeprom if supported by the switch */ 436793abb4SGuenter Roeck int eeprom_len; 446793abb4SGuenter Roeck 45fa981d9aSFlorian Fainelli /* Device tree node pointer for this specific switch chip 46fa981d9aSFlorian Fainelli * used during switch setup in case additional properties 47fa981d9aSFlorian Fainelli * and resources needs to be used 48fa981d9aSFlorian Fainelli */ 49fa981d9aSFlorian Fainelli struct device_node *of_node; 50fa981d9aSFlorian Fainelli 51e84665c9SLennert Buytenhek /* 52e84665c9SLennert Buytenhek * The names of the switch's ports. Use "cpu" to 53e84665c9SLennert Buytenhek * designate the switch port that the cpu is connected to, 54e84665c9SLennert Buytenhek * "dsa" to indicate that this port is a DSA link to 55e84665c9SLennert Buytenhek * another switch, NULL to indicate the port is unused, 56e84665c9SLennert Buytenhek * or any other string to indicate this is a physical port. 57e84665c9SLennert Buytenhek */ 58e84665c9SLennert Buytenhek char *port_names[DSA_MAX_PORTS]; 59bd47497aSFlorian Fainelli struct device_node *port_dn[DSA_MAX_PORTS]; 60e84665c9SLennert Buytenhek 61e84665c9SLennert Buytenhek /* 62e84665c9SLennert Buytenhek * An array (with nr_chips elements) of which element [a] 63e84665c9SLennert Buytenhek * indicates which port on this switch should be used to 64e84665c9SLennert Buytenhek * send packets to that are destined for switch a. Can be 65e84665c9SLennert Buytenhek * NULL if there is only one switch chip. 66e84665c9SLennert Buytenhek */ 67e84665c9SLennert Buytenhek s8 *rtable; 68cc30c163SAndrew Lunn 69cc30c163SAndrew Lunn /* 70cc30c163SAndrew Lunn * A switch may have a GPIO line tied to its reset pin. Parse 71cc30c163SAndrew Lunn * this from the device tree, and use it before performing 72cc30c163SAndrew Lunn * switch soft reset. 73cc30c163SAndrew Lunn */ 74cc30c163SAndrew Lunn struct gpio_desc *reset; 75e84665c9SLennert Buytenhek }; 76e84665c9SLennert Buytenhek 7791da11f8SLennert Buytenhek struct dsa_platform_data { 7891da11f8SLennert Buytenhek /* 7991da11f8SLennert Buytenhek * Reference to a Linux network interface that connects 80e84665c9SLennert Buytenhek * to the root switch chip of the tree. 8191da11f8SLennert Buytenhek */ 8291da11f8SLennert Buytenhek struct device *netdev; 83769a0202SFlorian Fainelli struct net_device *of_netdev; 8491da11f8SLennert Buytenhek 8591da11f8SLennert Buytenhek /* 86e84665c9SLennert Buytenhek * Info structs describing each of the switch chips 87e84665c9SLennert Buytenhek * connected via this network interface. 8891da11f8SLennert Buytenhek */ 89e84665c9SLennert Buytenhek int nr_chips; 90e84665c9SLennert Buytenhek struct dsa_chip_data *chip; 9191da11f8SLennert Buytenhek }; 9291da11f8SLennert Buytenhek 935075314eSAlexander Duyck struct packet_type; 943e8a72d1SFlorian Fainelli 95cf50dcc2SBen Hutchings struct dsa_switch_tree { 96cf50dcc2SBen Hutchings /* 97cf50dcc2SBen Hutchings * Configuration data for the platform device that owns 98cf50dcc2SBen Hutchings * this dsa switch tree instance. 99cf50dcc2SBen Hutchings */ 100cf50dcc2SBen Hutchings struct dsa_platform_data *pd; 101cf85d08fSLennert Buytenhek 102cf50dcc2SBen Hutchings /* 103cf50dcc2SBen Hutchings * Reference to network device to use, and which tagging 104cf50dcc2SBen Hutchings * protocol to use. 105cf50dcc2SBen Hutchings */ 106cf50dcc2SBen Hutchings struct net_device *master_netdev; 1075075314eSAlexander Duyck int (*rcv)(struct sk_buff *skb, 1085075314eSAlexander Duyck struct net_device *dev, 1095075314eSAlexander Duyck struct packet_type *pt, 1105075314eSAlexander Duyck struct net_device *orig_dev); 111ac7a04c3SFlorian Fainelli enum dsa_tag_protocol tag_protocol; 112cf50dcc2SBen Hutchings 113cf50dcc2SBen Hutchings /* 114cf50dcc2SBen Hutchings * The switch and port to which the CPU is attached. 115cf50dcc2SBen Hutchings */ 116cf50dcc2SBen Hutchings s8 cpu_switch; 117cf50dcc2SBen Hutchings s8 cpu_port; 118cf50dcc2SBen Hutchings 119cf50dcc2SBen Hutchings /* 120cf50dcc2SBen Hutchings * Link state polling. 121cf50dcc2SBen Hutchings */ 122cf50dcc2SBen Hutchings int link_poll_needed; 123cf50dcc2SBen Hutchings struct work_struct link_poll_work; 124cf50dcc2SBen Hutchings struct timer_list link_poll_timer; 125cf50dcc2SBen Hutchings 126cf50dcc2SBen Hutchings /* 127cf50dcc2SBen Hutchings * Data for the individual switch chips. 128cf50dcc2SBen Hutchings */ 129cf50dcc2SBen Hutchings struct dsa_switch *ds[DSA_MAX_SWITCHES]; 130cf50dcc2SBen Hutchings }; 131cf50dcc2SBen Hutchings 132c8f0b869SBen Hutchings struct dsa_switch { 133c8f0b869SBen Hutchings /* 134c8f0b869SBen Hutchings * Parent switch tree, and switch index. 135c8f0b869SBen Hutchings */ 136c8f0b869SBen Hutchings struct dsa_switch_tree *dst; 137c8f0b869SBen Hutchings int index; 138c8f0b869SBen Hutchings 139c8f0b869SBen Hutchings /* 14059299031SFlorian Fainelli * Tagging protocol understood by this switch 14159299031SFlorian Fainelli */ 14259299031SFlorian Fainelli enum dsa_tag_protocol tag_protocol; 14359299031SFlorian Fainelli 14459299031SFlorian Fainelli /* 145c8f0b869SBen Hutchings * Configuration data for this switch. 146c8f0b869SBen Hutchings */ 147c8f0b869SBen Hutchings struct dsa_chip_data *pd; 148c8f0b869SBen Hutchings 149c8f0b869SBen Hutchings /* 150c8f0b869SBen Hutchings * The used switch driver. 151c8f0b869SBen Hutchings */ 152c8f0b869SBen Hutchings struct dsa_switch_driver *drv; 153c8f0b869SBen Hutchings 154c8f0b869SBen Hutchings /* 155b4d2394dSAlexander Duyck * Reference to host device to use. 156c8f0b869SBen Hutchings */ 157b4d2394dSAlexander Duyck struct device *master_dev; 158c8f0b869SBen Hutchings 15951579c3fSGuenter Roeck #ifdef CONFIG_NET_DSA_HWMON 16051579c3fSGuenter Roeck /* 16151579c3fSGuenter Roeck * Hardware monitoring information 16251579c3fSGuenter Roeck */ 16351579c3fSGuenter Roeck char hwmon_name[IFNAMSIZ + 8]; 16451579c3fSGuenter Roeck struct device *hwmon_dev; 16551579c3fSGuenter Roeck #endif 16651579c3fSGuenter Roeck 167c8f0b869SBen Hutchings /* 168c8f0b869SBen Hutchings * Slave mii_bus and devices for the individual ports. 169c8f0b869SBen Hutchings */ 170c8f0b869SBen Hutchings u32 dsa_port_mask; 171c8f0b869SBen Hutchings u32 phys_port_mask; 1720d8bcdd3SFlorian Fainelli u32 phys_mii_mask; 173c8f0b869SBen Hutchings struct mii_bus *slave_mii_bus; 174c8f0b869SBen Hutchings struct net_device *ports[DSA_MAX_PORTS]; 175c8f0b869SBen Hutchings }; 176c8f0b869SBen Hutchings 177c8f0b869SBen Hutchings static inline bool dsa_is_cpu_port(struct dsa_switch *ds, int p) 178c8f0b869SBen Hutchings { 179c8f0b869SBen Hutchings return !!(ds->index == ds->dst->cpu_switch && p == ds->dst->cpu_port); 180c8f0b869SBen Hutchings } 181c8f0b869SBen Hutchings 18260045cbfSAndrew Lunn static inline bool dsa_is_dsa_port(struct dsa_switch *ds, int p) 18360045cbfSAndrew Lunn { 18460045cbfSAndrew Lunn return !!((ds->dsa_port_mask) & (1 << p)); 18560045cbfSAndrew Lunn } 18660045cbfSAndrew Lunn 187d79d2107SGuenter Roeck static inline bool dsa_is_port_initialized(struct dsa_switch *ds, int p) 188d79d2107SGuenter Roeck { 189d79d2107SGuenter Roeck return ds->phys_port_mask & (1 << p) && ds->ports[p]; 190d79d2107SGuenter Roeck } 191d79d2107SGuenter Roeck 192c8f0b869SBen Hutchings static inline u8 dsa_upstream_port(struct dsa_switch *ds) 193c8f0b869SBen Hutchings { 194c8f0b869SBen Hutchings struct dsa_switch_tree *dst = ds->dst; 195c8f0b869SBen Hutchings 196c8f0b869SBen Hutchings /* 197c8f0b869SBen Hutchings * If this is the root switch (i.e. the switch that connects 198c8f0b869SBen Hutchings * to the CPU), return the cpu port number on this switch. 199c8f0b869SBen Hutchings * Else return the (DSA) port number that connects to the 200c8f0b869SBen Hutchings * switch that is one hop closer to the cpu. 201c8f0b869SBen Hutchings */ 202c8f0b869SBen Hutchings if (dst->cpu_switch == ds->index) 203c8f0b869SBen Hutchings return dst->cpu_port; 204c8f0b869SBen Hutchings else 205c8f0b869SBen Hutchings return ds->pd->rtable[dst->cpu_switch]; 206c8f0b869SBen Hutchings } 207c8f0b869SBen Hutchings 208146a3206SVivien Didelot struct switchdev_trans; 209ea70ba98SVivien Didelot struct switchdev_obj; 210146a3206SVivien Didelot struct switchdev_obj_port_fdb; 21176e398a6SVivien Didelot struct switchdev_obj_port_vlan; 212146a3206SVivien Didelot 213c8f0b869SBen Hutchings struct dsa_switch_driver { 214c8f0b869SBen Hutchings struct list_head list; 215c8f0b869SBen Hutchings 216ac7a04c3SFlorian Fainelli enum dsa_tag_protocol tag_protocol; 217c8f0b869SBen Hutchings int priv_size; 218c8f0b869SBen Hutchings 219c8f0b869SBen Hutchings /* 220c8f0b869SBen Hutchings * Probing and setup. 221c8f0b869SBen Hutchings */ 222b4d2394dSAlexander Duyck char *(*probe)(struct device *host_dev, int sw_addr); 223c8f0b869SBen Hutchings int (*setup)(struct dsa_switch *ds); 224c8f0b869SBen Hutchings int (*set_addr)(struct dsa_switch *ds, u8 *addr); 2256819563eSFlorian Fainelli u32 (*get_phy_flags)(struct dsa_switch *ds, int port); 226c8f0b869SBen Hutchings 227c8f0b869SBen Hutchings /* 228c8f0b869SBen Hutchings * Access to the switch's PHY registers. 229c8f0b869SBen Hutchings */ 230c8f0b869SBen Hutchings int (*phy_read)(struct dsa_switch *ds, int port, int regnum); 231c8f0b869SBen Hutchings int (*phy_write)(struct dsa_switch *ds, int port, 232c8f0b869SBen Hutchings int regnum, u16 val); 233c8f0b869SBen Hutchings 234c8f0b869SBen Hutchings /* 235c8f0b869SBen Hutchings * Link state polling and IRQ handling. 236c8f0b869SBen Hutchings */ 237c8f0b869SBen Hutchings void (*poll_link)(struct dsa_switch *ds); 238c8f0b869SBen Hutchings 239c8f0b869SBen Hutchings /* 240ec9436baSFlorian Fainelli * Link state adjustment (called from libphy) 241ec9436baSFlorian Fainelli */ 242ec9436baSFlorian Fainelli void (*adjust_link)(struct dsa_switch *ds, int port, 243ec9436baSFlorian Fainelli struct phy_device *phydev); 244ce31b31cSFlorian Fainelli void (*fixed_link_update)(struct dsa_switch *ds, int port, 245ce31b31cSFlorian Fainelli struct fixed_phy_status *st); 246ec9436baSFlorian Fainelli 247ec9436baSFlorian Fainelli /* 248c8f0b869SBen Hutchings * ethtool hardware statistics. 249c8f0b869SBen Hutchings */ 250c8f0b869SBen Hutchings void (*get_strings)(struct dsa_switch *ds, int port, uint8_t *data); 251c8f0b869SBen Hutchings void (*get_ethtool_stats)(struct dsa_switch *ds, 252c8f0b869SBen Hutchings int port, uint64_t *data); 253c8f0b869SBen Hutchings int (*get_sset_count)(struct dsa_switch *ds); 25424462549SFlorian Fainelli 25524462549SFlorian Fainelli /* 25619e57c4eSFlorian Fainelli * ethtool Wake-on-LAN 25719e57c4eSFlorian Fainelli */ 25819e57c4eSFlorian Fainelli void (*get_wol)(struct dsa_switch *ds, int port, 25919e57c4eSFlorian Fainelli struct ethtool_wolinfo *w); 26019e57c4eSFlorian Fainelli int (*set_wol)(struct dsa_switch *ds, int port, 26119e57c4eSFlorian Fainelli struct ethtool_wolinfo *w); 26219e57c4eSFlorian Fainelli 26319e57c4eSFlorian Fainelli /* 26424462549SFlorian Fainelli * Suspend and resume 26524462549SFlorian Fainelli */ 26624462549SFlorian Fainelli int (*suspend)(struct dsa_switch *ds); 26724462549SFlorian Fainelli int (*resume)(struct dsa_switch *ds); 268b2f2af21SFlorian Fainelli 269b2f2af21SFlorian Fainelli /* 270b2f2af21SFlorian Fainelli * Port enable/disable 271b2f2af21SFlorian Fainelli */ 272b2f2af21SFlorian Fainelli int (*port_enable)(struct dsa_switch *ds, int port, 273b2f2af21SFlorian Fainelli struct phy_device *phy); 274b2f2af21SFlorian Fainelli void (*port_disable)(struct dsa_switch *ds, int port, 275b2f2af21SFlorian Fainelli struct phy_device *phy); 2767905288fSFlorian Fainelli 2777905288fSFlorian Fainelli /* 2787905288fSFlorian Fainelli * EEE setttings 2797905288fSFlorian Fainelli */ 2807905288fSFlorian Fainelli int (*set_eee)(struct dsa_switch *ds, int port, 2817905288fSFlorian Fainelli struct phy_device *phydev, 2827905288fSFlorian Fainelli struct ethtool_eee *e); 2837905288fSFlorian Fainelli int (*get_eee)(struct dsa_switch *ds, int port, 2847905288fSFlorian Fainelli struct ethtool_eee *e); 28551579c3fSGuenter Roeck 28651579c3fSGuenter Roeck #ifdef CONFIG_NET_DSA_HWMON 28751579c3fSGuenter Roeck /* Hardware monitoring */ 28851579c3fSGuenter Roeck int (*get_temp)(struct dsa_switch *ds, int *temp); 28951579c3fSGuenter Roeck int (*get_temp_limit)(struct dsa_switch *ds, int *temp); 29051579c3fSGuenter Roeck int (*set_temp_limit)(struct dsa_switch *ds, int temp); 29151579c3fSGuenter Roeck int (*get_temp_alarm)(struct dsa_switch *ds, bool *alarm); 29251579c3fSGuenter Roeck #endif 2936793abb4SGuenter Roeck 2946793abb4SGuenter Roeck /* EEPROM access */ 2956793abb4SGuenter Roeck int (*get_eeprom_len)(struct dsa_switch *ds); 2966793abb4SGuenter Roeck int (*get_eeprom)(struct dsa_switch *ds, 2976793abb4SGuenter Roeck struct ethtool_eeprom *eeprom, u8 *data); 2986793abb4SGuenter Roeck int (*set_eeprom)(struct dsa_switch *ds, 2996793abb4SGuenter Roeck struct ethtool_eeprom *eeprom, u8 *data); 3003d762a0fSGuenter Roeck 3013d762a0fSGuenter Roeck /* 3023d762a0fSGuenter Roeck * Register access. 3033d762a0fSGuenter Roeck */ 3043d762a0fSGuenter Roeck int (*get_regs_len)(struct dsa_switch *ds, int port); 3053d762a0fSGuenter Roeck void (*get_regs)(struct dsa_switch *ds, int port, 3063d762a0fSGuenter Roeck struct ethtool_regs *regs, void *p); 307b73adef6SFlorian Fainelli 308b73adef6SFlorian Fainelli /* 309b73adef6SFlorian Fainelli * Bridge integration 310b73adef6SFlorian Fainelli */ 311b73adef6SFlorian Fainelli int (*port_join_bridge)(struct dsa_switch *ds, int port, 312b73adef6SFlorian Fainelli u32 br_port_mask); 313b73adef6SFlorian Fainelli int (*port_leave_bridge)(struct dsa_switch *ds, int port, 314b73adef6SFlorian Fainelli u32 br_port_mask); 315b73adef6SFlorian Fainelli int (*port_stp_update)(struct dsa_switch *ds, int port, 316b73adef6SFlorian Fainelli u8 state); 3172a778e1bSVivien Didelot 3182a778e1bSVivien Didelot /* 31911149536SVivien Didelot * VLAN support 32011149536SVivien Didelot */ 32176e398a6SVivien Didelot int (*port_vlan_prepare)(struct dsa_switch *ds, int port, 32276e398a6SVivien Didelot const struct switchdev_obj_port_vlan *vlan, 32376e398a6SVivien Didelot struct switchdev_trans *trans); 32476e398a6SVivien Didelot int (*port_vlan_add)(struct dsa_switch *ds, int port, 32576e398a6SVivien Didelot const struct switchdev_obj_port_vlan *vlan, 32676e398a6SVivien Didelot struct switchdev_trans *trans); 32776e398a6SVivien Didelot int (*port_vlan_del)(struct dsa_switch *ds, int port, 32876e398a6SVivien Didelot const struct switchdev_obj_port_vlan *vlan); 32911149536SVivien Didelot int (*port_pvid_get)(struct dsa_switch *ds, int port, u16 *pvid); 33011149536SVivien Didelot int (*vlan_getnext)(struct dsa_switch *ds, u16 *vid, 33111149536SVivien Didelot unsigned long *ports, unsigned long *untagged); 33211149536SVivien Didelot 33311149536SVivien Didelot /* 3342a778e1bSVivien Didelot * Forwarding database 3352a778e1bSVivien Didelot */ 336146a3206SVivien Didelot int (*port_fdb_prepare)(struct dsa_switch *ds, int port, 337146a3206SVivien Didelot const struct switchdev_obj_port_fdb *fdb, 338146a3206SVivien Didelot struct switchdev_trans *trans); 3392a778e1bSVivien Didelot int (*port_fdb_add)(struct dsa_switch *ds, int port, 3401f36faf2SVivien Didelot const struct switchdev_obj_port_fdb *fdb, 3411f36faf2SVivien Didelot struct switchdev_trans *trans); 3422a778e1bSVivien Didelot int (*port_fdb_del)(struct dsa_switch *ds, int port, 3438057b3e7SVivien Didelot const struct switchdev_obj_port_fdb *fdb); 344ea70ba98SVivien Didelot int (*port_fdb_dump)(struct dsa_switch *ds, int port, 345ea70ba98SVivien Didelot struct switchdev_obj_port_fdb *fdb, 346ea70ba98SVivien Didelot int (*cb)(struct switchdev_obj *obj)); 347c8f0b869SBen Hutchings }; 348c8f0b869SBen Hutchings 349c8f0b869SBen Hutchings void register_switch_driver(struct dsa_switch_driver *type); 350c8f0b869SBen Hutchings void unregister_switch_driver(struct dsa_switch_driver *type); 351b4d2394dSAlexander Duyck struct mii_bus *dsa_host_dev_to_mii_bus(struct device *dev); 352c8f0b869SBen Hutchings 3537fa857edSFlorian Fainelli static inline void *ds_to_priv(struct dsa_switch *ds) 3547fa857edSFlorian Fainelli { 3557fa857edSFlorian Fainelli return (void *)(ds + 1); 3567fa857edSFlorian Fainelli } 3577fa857edSFlorian Fainelli 3585aed85ceSFlorian Fainelli static inline bool dsa_uses_tagged_protocol(struct dsa_switch_tree *dst) 3595aed85ceSFlorian Fainelli { 3605075314eSAlexander Duyck return dst->rcv != NULL; 3615aed85ceSFlorian Fainelli } 36291da11f8SLennert Buytenhek #endif 363