blob: ce8f9b748a77c7e16ab35dc8ba4b6f38c3661f5d [file] [log] [blame]
Lennert Buytenhek91da11f2008-10-07 13:44:02 +00001/*
2 * include/net/dsa.h - Driver for Distributed Switch Architecture switch chips
Lennert Buytenheke84665c2009-03-20 09:52:09 +00003 * Copyright (c) 2008-2009 Marvell Semiconductor
Lennert Buytenhek91da11f2008-10-07 13:44:02 +00004 *
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; either version 2 of the License, or
8 * (at your option) any later version.
9 */
10
11#ifndef __LINUX_NET_DSA_H
12#define __LINUX_NET_DSA_H
13
Axel Linea1f51b2011-11-30 22:07:18 +000014#include <linux/if_ether.h>
Ben Hutchingsc8f0b862011-11-27 17:06:08 +000015#include <linux/list.h>
Ben Hutchingscf50dcc2011-11-25 14:32:52 +000016#include <linux/timer.h>
17#include <linux/workqueue.h>
Florian Fainellifa981d92014-08-27 17:04:49 -070018#include <linux/of.h>
Florian Fainelliec9436b2014-08-27 17:04:53 -070019#include <linux/phy.h>
Florian Fainellice31b312014-08-27 17:04:54 -070020#include <linux/phy_fixed.h>
Florian Fainellia2820542014-10-17 16:02:13 -070021#include <linux/ethtool.h>
Ben Hutchingscf50dcc2011-11-25 14:32:52 +000022
Florian Fainelliac7a04c2014-09-11 21:18:09 -070023enum dsa_tag_protocol {
24 DSA_TAG_PROTO_NONE = 0,
25 DSA_TAG_PROTO_DSA,
26 DSA_TAG_PROTO_TRAILER,
27 DSA_TAG_PROTO_EDSA,
28 DSA_TAG_PROTO_BRCM,
29};
Florian Fainelli5037d532014-08-27 17:04:55 -070030
Lennert Buytenheke84665c2009-03-20 09:52:09 +000031#define DSA_MAX_SWITCHES 4
32#define DSA_MAX_PORTS 12
33
34struct dsa_chip_data {
35 /*
36 * How to access the switch configuration registers.
37 */
Alexander Duyckb4d23942014-09-15 13:00:27 -040038 struct device *host_dev;
Lennert Buytenheke84665c2009-03-20 09:52:09 +000039 int sw_addr;
40
Guenter Roeck6793abb2014-10-29 10:45:01 -070041 /* set to size of eeprom if supported by the switch */
42 int eeprom_len;
43
Florian Fainellifa981d92014-08-27 17:04:49 -070044 /* Device tree node pointer for this specific switch chip
45 * used during switch setup in case additional properties
46 * and resources needs to be used
47 */
48 struct device_node *of_node;
49
Lennert Buytenheke84665c2009-03-20 09:52:09 +000050 /*
51 * The names of the switch's ports. Use "cpu" to
52 * designate the switch port that the cpu is connected to,
53 * "dsa" to indicate that this port is a DSA link to
54 * another switch, NULL to indicate the port is unused,
55 * or any other string to indicate this is a physical port.
56 */
57 char *port_names[DSA_MAX_PORTS];
Florian Fainellibd474972014-08-27 17:04:50 -070058 struct device_node *port_dn[DSA_MAX_PORTS];
Lennert Buytenheke84665c2009-03-20 09:52:09 +000059
60 /*
61 * An array (with nr_chips elements) of which element [a]
62 * indicates which port on this switch should be used to
63 * send packets to that are destined for switch a. Can be
64 * NULL if there is only one switch chip.
65 */
66 s8 *rtable;
67};
Lennert Buytenhek91da11f2008-10-07 13:44:02 +000068
69struct dsa_platform_data {
70 /*
71 * Reference to a Linux network interface that connects
Lennert Buytenheke84665c2009-03-20 09:52:09 +000072 * to the root switch chip of the tree.
Lennert Buytenhek91da11f2008-10-07 13:44:02 +000073 */
74 struct device *netdev;
Florian Fainelli769a0202015-03-09 14:31:21 -070075 struct net_device *of_netdev;
Lennert Buytenhek91da11f2008-10-07 13:44:02 +000076
77 /*
Lennert Buytenheke84665c2009-03-20 09:52:09 +000078 * Info structs describing each of the switch chips
79 * connected via this network interface.
Lennert Buytenhek91da11f2008-10-07 13:44:02 +000080 */
Lennert Buytenheke84665c2009-03-20 09:52:09 +000081 int nr_chips;
82 struct dsa_chip_data *chip;
Lennert Buytenhek91da11f2008-10-07 13:44:02 +000083};
84
Alexander Duyck50753142014-09-15 13:00:19 -040085struct packet_type;
Florian Fainelli3e8a72d2014-08-27 17:04:46 -070086
Ben Hutchingscf50dcc2011-11-25 14:32:52 +000087struct dsa_switch_tree {
88 /*
89 * Configuration data for the platform device that owns
90 * this dsa switch tree instance.
91 */
92 struct dsa_platform_data *pd;
Lennert Buytenhekcf85d082008-10-07 13:45:02 +000093
Ben Hutchingscf50dcc2011-11-25 14:32:52 +000094 /*
95 * Reference to network device to use, and which tagging
96 * protocol to use.
97 */
98 struct net_device *master_netdev;
Alexander Duyck50753142014-09-15 13:00:19 -040099 int (*rcv)(struct sk_buff *skb,
100 struct net_device *dev,
101 struct packet_type *pt,
102 struct net_device *orig_dev);
Florian Fainelliac7a04c2014-09-11 21:18:09 -0700103 enum dsa_tag_protocol tag_protocol;
Ben Hutchingscf50dcc2011-11-25 14:32:52 +0000104
105 /*
106 * The switch and port to which the CPU is attached.
107 */
108 s8 cpu_switch;
109 s8 cpu_port;
110
111 /*
112 * Link state polling.
113 */
114 int link_poll_needed;
115 struct work_struct link_poll_work;
116 struct timer_list link_poll_timer;
117
118 /*
119 * Data for the individual switch chips.
120 */
121 struct dsa_switch *ds[DSA_MAX_SWITCHES];
122};
123
Ben Hutchingsc8f0b862011-11-27 17:06:08 +0000124struct dsa_switch {
125 /*
126 * Parent switch tree, and switch index.
127 */
128 struct dsa_switch_tree *dst;
129 int index;
130
131 /*
Florian Fainelli59299032015-03-05 12:35:07 -0800132 * Tagging protocol understood by this switch
133 */
134 enum dsa_tag_protocol tag_protocol;
135
136 /*
Ben Hutchingsc8f0b862011-11-27 17:06:08 +0000137 * Configuration data for this switch.
138 */
139 struct dsa_chip_data *pd;
140
141 /*
142 * The used switch driver.
143 */
144 struct dsa_switch_driver *drv;
145
146 /*
Alexander Duyckb4d23942014-09-15 13:00:27 -0400147 * Reference to host device to use.
Ben Hutchingsc8f0b862011-11-27 17:06:08 +0000148 */
Alexander Duyckb4d23942014-09-15 13:00:27 -0400149 struct device *master_dev;
Ben Hutchingsc8f0b862011-11-27 17:06:08 +0000150
Guenter Roeck51579c32014-10-29 10:44:58 -0700151#ifdef CONFIG_NET_DSA_HWMON
152 /*
153 * Hardware monitoring information
154 */
155 char hwmon_name[IFNAMSIZ + 8];
156 struct device *hwmon_dev;
157#endif
158
Ben Hutchingsc8f0b862011-11-27 17:06:08 +0000159 /*
160 * Slave mii_bus and devices for the individual ports.
161 */
162 u32 dsa_port_mask;
163 u32 phys_port_mask;
Florian Fainelli0d8bcdd2014-08-27 17:04:51 -0700164 u32 phys_mii_mask;
Ben Hutchingsc8f0b862011-11-27 17:06:08 +0000165 struct mii_bus *slave_mii_bus;
166 struct net_device *ports[DSA_MAX_PORTS];
167};
168
169static inline bool dsa_is_cpu_port(struct dsa_switch *ds, int p)
170{
171 return !!(ds->index == ds->dst->cpu_switch && p == ds->dst->cpu_port);
172}
173
Andrew Lunn60045cb2015-08-17 23:52:51 +0200174static inline bool dsa_is_dsa_port(struct dsa_switch *ds, int p)
175{
176 return !!((ds->dsa_port_mask) & (1 << p));
177}
178
Guenter Roeckd79d2102015-02-24 23:02:02 -0800179static inline bool dsa_is_port_initialized(struct dsa_switch *ds, int p)
180{
181 return ds->phys_port_mask & (1 << p) && ds->ports[p];
182}
183
Ben Hutchingsc8f0b862011-11-27 17:06:08 +0000184static inline u8 dsa_upstream_port(struct dsa_switch *ds)
185{
186 struct dsa_switch_tree *dst = ds->dst;
187
188 /*
189 * If this is the root switch (i.e. the switch that connects
190 * to the CPU), return the cpu port number on this switch.
191 * Else return the (DSA) port number that connects to the
192 * switch that is one hop closer to the cpu.
193 */
194 if (dst->cpu_switch == ds->index)
195 return dst->cpu_port;
196 else
197 return ds->pd->rtable[dst->cpu_switch];
198}
199
Vivien Didelot146a3202015-10-08 11:35:12 -0400200struct switchdev_trans;
201struct switchdev_obj_port_fdb;
202
Ben Hutchingsc8f0b862011-11-27 17:06:08 +0000203struct dsa_switch_driver {
204 struct list_head list;
205
Florian Fainelliac7a04c2014-09-11 21:18:09 -0700206 enum dsa_tag_protocol tag_protocol;
Ben Hutchingsc8f0b862011-11-27 17:06:08 +0000207 int priv_size;
208
209 /*
210 * Probing and setup.
211 */
Alexander Duyckb4d23942014-09-15 13:00:27 -0400212 char *(*probe)(struct device *host_dev, int sw_addr);
Ben Hutchingsc8f0b862011-11-27 17:06:08 +0000213 int (*setup)(struct dsa_switch *ds);
214 int (*set_addr)(struct dsa_switch *ds, u8 *addr);
Florian Fainelli68195632014-09-19 13:07:54 -0700215 u32 (*get_phy_flags)(struct dsa_switch *ds, int port);
Ben Hutchingsc8f0b862011-11-27 17:06:08 +0000216
217 /*
218 * Access to the switch's PHY registers.
219 */
220 int (*phy_read)(struct dsa_switch *ds, int port, int regnum);
221 int (*phy_write)(struct dsa_switch *ds, int port,
222 int regnum, u16 val);
223
224 /*
225 * Link state polling and IRQ handling.
226 */
227 void (*poll_link)(struct dsa_switch *ds);
228
229 /*
Florian Fainelliec9436b2014-08-27 17:04:53 -0700230 * Link state adjustment (called from libphy)
231 */
232 void (*adjust_link)(struct dsa_switch *ds, int port,
233 struct phy_device *phydev);
Florian Fainellice31b312014-08-27 17:04:54 -0700234 void (*fixed_link_update)(struct dsa_switch *ds, int port,
235 struct fixed_phy_status *st);
Florian Fainelliec9436b2014-08-27 17:04:53 -0700236
237 /*
Ben Hutchingsc8f0b862011-11-27 17:06:08 +0000238 * ethtool hardware statistics.
239 */
240 void (*get_strings)(struct dsa_switch *ds, int port, uint8_t *data);
241 void (*get_ethtool_stats)(struct dsa_switch *ds,
242 int port, uint64_t *data);
243 int (*get_sset_count)(struct dsa_switch *ds);
Florian Fainelli24462542014-09-18 17:31:22 -0700244
245 /*
Florian Fainelli19e57c42014-09-18 17:31:24 -0700246 * ethtool Wake-on-LAN
247 */
248 void (*get_wol)(struct dsa_switch *ds, int port,
249 struct ethtool_wolinfo *w);
250 int (*set_wol)(struct dsa_switch *ds, int port,
251 struct ethtool_wolinfo *w);
252
253 /*
Florian Fainelli24462542014-09-18 17:31:22 -0700254 * Suspend and resume
255 */
256 int (*suspend)(struct dsa_switch *ds);
257 int (*resume)(struct dsa_switch *ds);
Florian Fainellib2f2af22014-09-24 17:05:18 -0700258
259 /*
260 * Port enable/disable
261 */
262 int (*port_enable)(struct dsa_switch *ds, int port,
263 struct phy_device *phy);
264 void (*port_disable)(struct dsa_switch *ds, int port,
265 struct phy_device *phy);
Florian Fainelli79052882014-09-24 17:05:21 -0700266
267 /*
268 * EEE setttings
269 */
270 int (*set_eee)(struct dsa_switch *ds, int port,
271 struct phy_device *phydev,
272 struct ethtool_eee *e);
273 int (*get_eee)(struct dsa_switch *ds, int port,
274 struct ethtool_eee *e);
Guenter Roeck51579c32014-10-29 10:44:58 -0700275
276#ifdef CONFIG_NET_DSA_HWMON
277 /* Hardware monitoring */
278 int (*get_temp)(struct dsa_switch *ds, int *temp);
279 int (*get_temp_limit)(struct dsa_switch *ds, int *temp);
280 int (*set_temp_limit)(struct dsa_switch *ds, int temp);
281 int (*get_temp_alarm)(struct dsa_switch *ds, bool *alarm);
282#endif
Guenter Roeck6793abb2014-10-29 10:45:01 -0700283
284 /* EEPROM access */
285 int (*get_eeprom_len)(struct dsa_switch *ds);
286 int (*get_eeprom)(struct dsa_switch *ds,
287 struct ethtool_eeprom *eeprom, u8 *data);
288 int (*set_eeprom)(struct dsa_switch *ds,
289 struct ethtool_eeprom *eeprom, u8 *data);
Guenter Roeck3d762a02014-10-29 10:45:04 -0700290
291 /*
292 * Register access.
293 */
294 int (*get_regs_len)(struct dsa_switch *ds, int port);
295 void (*get_regs)(struct dsa_switch *ds, int port,
296 struct ethtool_regs *regs, void *p);
Florian Fainellib73adef2015-02-24 13:15:33 -0800297
298 /*
299 * Bridge integration
300 */
301 int (*port_join_bridge)(struct dsa_switch *ds, int port,
302 u32 br_port_mask);
303 int (*port_leave_bridge)(struct dsa_switch *ds, int port,
304 u32 br_port_mask);
305 int (*port_stp_update)(struct dsa_switch *ds, int port,
306 u8 state);
Vivien Didelot2a778e12015-08-10 09:09:49 -0400307
308 /*
Vivien Didelot11149532015-08-13 12:52:17 -0400309 * VLAN support
310 */
311 int (*port_pvid_get)(struct dsa_switch *ds, int port, u16 *pvid);
312 int (*port_pvid_set)(struct dsa_switch *ds, int port, u16 pvid);
313 int (*port_vlan_add)(struct dsa_switch *ds, int port, u16 vid,
314 bool untagged);
315 int (*port_vlan_del)(struct dsa_switch *ds, int port, u16 vid);
316 int (*vlan_getnext)(struct dsa_switch *ds, u16 *vid,
317 unsigned long *ports, unsigned long *untagged);
318
319 /*
Vivien Didelot2a778e12015-08-10 09:09:49 -0400320 * Forwarding database
321 */
Vivien Didelot146a3202015-10-08 11:35:12 -0400322 int (*port_fdb_prepare)(struct dsa_switch *ds, int port,
323 const struct switchdev_obj_port_fdb *fdb,
324 struct switchdev_trans *trans);
Vivien Didelot2a778e12015-08-10 09:09:49 -0400325 int (*port_fdb_add)(struct dsa_switch *ds, int port,
Vivien Didelot1f36faf2015-10-08 11:35:13 -0400326 const struct switchdev_obj_port_fdb *fdb,
327 struct switchdev_trans *trans);
Vivien Didelot2a778e12015-08-10 09:09:49 -0400328 int (*port_fdb_del)(struct dsa_switch *ds, int port,
329 const unsigned char *addr, u16 vid);
330 int (*port_fdb_getnext)(struct dsa_switch *ds, int port,
331 unsigned char *addr, u16 *vid,
332 bool *is_static);
Ben Hutchingsc8f0b862011-11-27 17:06:08 +0000333};
334
335void register_switch_driver(struct dsa_switch_driver *type);
336void unregister_switch_driver(struct dsa_switch_driver *type);
Alexander Duyckb4d23942014-09-15 13:00:27 -0400337struct mii_bus *dsa_host_dev_to_mii_bus(struct device *dev);
Ben Hutchingsc8f0b862011-11-27 17:06:08 +0000338
Florian Fainelli7fa857e2014-04-28 11:14:27 -0700339static inline void *ds_to_priv(struct dsa_switch *ds)
340{
341 return (void *)(ds + 1);
342}
343
Florian Fainelli5aed85c2014-08-27 17:04:52 -0700344static inline bool dsa_uses_tagged_protocol(struct dsa_switch_tree *dst)
345{
Alexander Duyck50753142014-09-15 13:00:19 -0400346 return dst->rcv != NULL;
Florian Fainelli5aed85c2014-08-27 17:04:52 -0700347}
Lennert Buytenhek91da11f2008-10-07 13:44:02 +0000348#endif