xref: /openbmc/linux/drivers/net/dsa/sja1105/sja1105.h (revision ea32690d)
1 /* SPDX-License-Identifier: GPL-2.0 */
2 /* Copyright (c) 2018, Sensor-Technik Wiedemann GmbH
3  * Copyright (c) 2018-2019, Vladimir Oltean <olteanv@gmail.com>
4  */
5 #ifndef _SJA1105_H
6 #define _SJA1105_H
7 
8 #include <linux/ptp_clock_kernel.h>
9 #include <linux/timecounter.h>
10 #include <linux/dsa/sja1105.h>
11 #include <linux/dsa/8021q.h>
12 #include <net/dsa.h>
13 #include <linux/mutex.h>
14 #include "sja1105_static_config.h"
15 
16 #define SJA1105ET_FDB_BIN_SIZE		4
17 /* The hardware value is in multiples of 10 ms.
18  * The passed parameter is in multiples of 1 ms.
19  */
20 #define SJA1105_AGEING_TIME_MS(ms)	((ms) / 10)
21 #define SJA1105_NUM_L2_POLICERS		SJA1110_MAX_L2_POLICING_COUNT
22 
23 /* Calculated assuming 1Gbps, where the clock has 125 MHz (8 ns period)
24  * To avoid floating point operations, we'll multiply the degrees by 10
25  * to get a "phase" and get 1 decimal point precision.
26  */
27 #define SJA1105_RGMII_DELAY_PS_TO_PHASE(ps) \
28 	(((ps) * 360) / 800)
29 #define SJA1105_RGMII_DELAY_PHASE_TO_PS(phase) \
30 	((800 * (phase)) / 360)
31 #define SJA1105_RGMII_DELAY_PHASE_TO_HW(phase) \
32 	(((phase) - 738) / 9)
33 #define SJA1105_RGMII_DELAY_PS_TO_HW(ps) \
34 	SJA1105_RGMII_DELAY_PHASE_TO_HW(SJA1105_RGMII_DELAY_PS_TO_PHASE(ps))
35 
36 /* Valid range in degrees is a value between 73.8 and 101.7
37  * in 0.9 degree increments
38  */
39 #define SJA1105_RGMII_DELAY_MIN_PS \
40 	SJA1105_RGMII_DELAY_PHASE_TO_PS(738)
41 #define SJA1105_RGMII_DELAY_MAX_PS \
42 	SJA1105_RGMII_DELAY_PHASE_TO_PS(1017)
43 
44 typedef enum {
45 	SPI_READ = 0,
46 	SPI_WRITE = 1,
47 } sja1105_spi_rw_mode_t;
48 
49 #include "sja1105_tas.h"
50 #include "sja1105_ptp.h"
51 
52 enum sja1105_stats_area {
53 	MAC,
54 	HL1,
55 	HL2,
56 	ETHER,
57 	__MAX_SJA1105_STATS_AREA,
58 };
59 
60 /* Keeps the different addresses between E/T and P/Q/R/S */
61 struct sja1105_regs {
62 	u64 device_id;
63 	u64 prod_id;
64 	u64 status;
65 	u64 port_control;
66 	u64 rgu;
67 	u64 vl_status;
68 	u64 config;
69 	u64 rmii_pll1;
70 	u64 ptppinst;
71 	u64 ptppindur;
72 	u64 ptp_control;
73 	u64 ptpclkval;
74 	u64 ptpclkrate;
75 	u64 ptpclkcorp;
76 	u64 ptpsyncts;
77 	u64 ptpschtm;
78 	u64 ptpegr_ts[SJA1105_MAX_NUM_PORTS];
79 	u64 pad_mii_tx[SJA1105_MAX_NUM_PORTS];
80 	u64 pad_mii_rx[SJA1105_MAX_NUM_PORTS];
81 	u64 pad_mii_id[SJA1105_MAX_NUM_PORTS];
82 	u64 cgu_idiv[SJA1105_MAX_NUM_PORTS];
83 	u64 mii_tx_clk[SJA1105_MAX_NUM_PORTS];
84 	u64 mii_rx_clk[SJA1105_MAX_NUM_PORTS];
85 	u64 mii_ext_tx_clk[SJA1105_MAX_NUM_PORTS];
86 	u64 mii_ext_rx_clk[SJA1105_MAX_NUM_PORTS];
87 	u64 rgmii_tx_clk[SJA1105_MAX_NUM_PORTS];
88 	u64 rmii_ref_clk[SJA1105_MAX_NUM_PORTS];
89 	u64 rmii_ext_tx_clk[SJA1105_MAX_NUM_PORTS];
90 	u64 stats[__MAX_SJA1105_STATS_AREA][SJA1105_MAX_NUM_PORTS];
91 	u64 mdio_100base_tx;
92 	u64 mdio_100base_t1;
93 	u64 pcs_base[SJA1105_MAX_NUM_PORTS];
94 };
95 
96 struct sja1105_mdio_private {
97 	struct sja1105_private *priv;
98 };
99 
100 enum {
101 	SJA1105_SPEED_AUTO,
102 	SJA1105_SPEED_10MBPS,
103 	SJA1105_SPEED_100MBPS,
104 	SJA1105_SPEED_1000MBPS,
105 	SJA1105_SPEED_2500MBPS,
106 	SJA1105_SPEED_MAX,
107 };
108 
109 enum sja1105_internal_phy_t {
110 	SJA1105_NO_PHY		= 0,
111 	SJA1105_PHY_BASE_TX,
112 	SJA1105_PHY_BASE_T1,
113 };
114 
115 struct sja1105_info {
116 	u64 device_id;
117 	/* Needed for distinction between P and R, and between Q and S
118 	 * (since the parts with/without SGMII share the same
119 	 * switch core and device_id)
120 	 */
121 	u64 part_no;
122 	/* E/T and P/Q/R/S have partial timestamps of different sizes.
123 	 * They must be reconstructed on both families anyway to get the full
124 	 * 64-bit values back.
125 	 */
126 	int ptp_ts_bits;
127 	/* Also SPI commands are of different sizes to retrieve
128 	 * the egress timestamps.
129 	 */
130 	int ptpegr_ts_bytes;
131 	int num_cbs_shapers;
132 	int max_frame_mem;
133 	int num_ports;
134 	bool multiple_cascade_ports;
135 	/* Every {port, TXQ} has its own CBS shaper */
136 	bool fixed_cbs_mapping;
137 	enum dsa_tag_protocol tag_proto;
138 	const struct sja1105_dynamic_table_ops *dyn_ops;
139 	const struct sja1105_table_ops *static_ops;
140 	const struct sja1105_regs *regs;
141 	bool can_limit_mcast_flood;
142 	int (*reset_cmd)(struct dsa_switch *ds);
143 	int (*setup_rgmii_delay)(const void *ctx, int port);
144 	/* Prototypes from include/net/dsa.h */
145 	int (*fdb_add_cmd)(struct dsa_switch *ds, int port,
146 			   const unsigned char *addr, u16 vid);
147 	int (*fdb_del_cmd)(struct dsa_switch *ds, int port,
148 			   const unsigned char *addr, u16 vid);
149 	void (*ptp_cmd_packing)(u8 *buf, struct sja1105_ptp_cmd *cmd,
150 				enum packing_op op);
151 	bool (*rxtstamp)(struct dsa_switch *ds, int port, struct sk_buff *skb);
152 	void (*txtstamp)(struct dsa_switch *ds, int port, struct sk_buff *skb);
153 	int (*clocking_setup)(struct sja1105_private *priv);
154 	int (*pcs_mdio_read_c45)(struct mii_bus *bus, int phy, int mmd,
155 				 int reg);
156 	int (*pcs_mdio_write_c45)(struct mii_bus *bus, int phy, int mmd,
157 				  int reg, u16 val);
158 	int (*disable_microcontroller)(struct sja1105_private *priv);
159 	const char *name;
160 	bool supports_mii[SJA1105_MAX_NUM_PORTS];
161 	bool supports_rmii[SJA1105_MAX_NUM_PORTS];
162 	bool supports_rgmii[SJA1105_MAX_NUM_PORTS];
163 	bool supports_sgmii[SJA1105_MAX_NUM_PORTS];
164 	bool supports_2500basex[SJA1105_MAX_NUM_PORTS];
165 	enum sja1105_internal_phy_t internal_phy[SJA1105_MAX_NUM_PORTS];
166 	const u64 port_speed[SJA1105_SPEED_MAX];
167 };
168 
169 enum sja1105_key_type {
170 	SJA1105_KEY_BCAST,
171 	SJA1105_KEY_TC,
172 	SJA1105_KEY_VLAN_UNAWARE_VL,
173 	SJA1105_KEY_VLAN_AWARE_VL,
174 };
175 
176 struct sja1105_key {
177 	enum sja1105_key_type type;
178 
179 	union {
180 		/* SJA1105_KEY_TC */
181 		struct {
182 			int pcp;
183 		} tc;
184 
185 		/* SJA1105_KEY_VLAN_UNAWARE_VL */
186 		/* SJA1105_KEY_VLAN_AWARE_VL */
187 		struct {
188 			u64 dmac;
189 			u16 vid;
190 			u16 pcp;
191 		} vl;
192 	};
193 };
194 
195 enum sja1105_rule_type {
196 	SJA1105_RULE_BCAST_POLICER,
197 	SJA1105_RULE_TC_POLICER,
198 	SJA1105_RULE_VL,
199 };
200 
201 enum sja1105_vl_type {
202 	SJA1105_VL_NONCRITICAL,
203 	SJA1105_VL_RATE_CONSTRAINED,
204 	SJA1105_VL_TIME_TRIGGERED,
205 };
206 
207 struct sja1105_rule {
208 	struct list_head list;
209 	unsigned long cookie;
210 	unsigned long port_mask;
211 	struct sja1105_key key;
212 	enum sja1105_rule_type type;
213 
214 	/* Action */
215 	union {
216 		/* SJA1105_RULE_BCAST_POLICER */
217 		struct {
218 			int sharindx;
219 		} bcast_pol;
220 
221 		/* SJA1105_RULE_TC_POLICER */
222 		struct {
223 			int sharindx;
224 		} tc_pol;
225 
226 		/* SJA1105_RULE_VL */
227 		struct {
228 			enum sja1105_vl_type type;
229 			unsigned long destports;
230 			int sharindx;
231 			int maxlen;
232 			int ipv;
233 			u64 base_time;
234 			u64 cycle_time;
235 			int num_entries;
236 			struct action_gate_entry *entries;
237 			struct flow_stats stats;
238 		} vl;
239 	};
240 };
241 
242 struct sja1105_flow_block {
243 	struct list_head rules;
244 	bool l2_policer_used[SJA1105_NUM_L2_POLICERS];
245 	int num_virtual_links;
246 };
247 
248 struct sja1105_private {
249 	struct sja1105_static_config static_config;
250 	int rgmii_rx_delay_ps[SJA1105_MAX_NUM_PORTS];
251 	int rgmii_tx_delay_ps[SJA1105_MAX_NUM_PORTS];
252 	phy_interface_t phy_mode[SJA1105_MAX_NUM_PORTS];
253 	bool fixed_link[SJA1105_MAX_NUM_PORTS];
254 	unsigned long ucast_egress_floods;
255 	unsigned long bcast_egress_floods;
256 	unsigned long hwts_tx_en;
257 	unsigned long hwts_rx_en;
258 	const struct sja1105_info *info;
259 	size_t max_xfer_len;
260 	struct spi_device *spidev;
261 	struct dsa_switch *ds;
262 	u16 bridge_pvid[SJA1105_MAX_NUM_PORTS];
263 	u16 tag_8021q_pvid[SJA1105_MAX_NUM_PORTS];
264 	struct sja1105_flow_block flow_block;
265 	/* Serializes transmission of management frames so that
266 	 * the switch doesn't confuse them with one another.
267 	 */
268 	struct mutex mgmt_lock;
269 	/* Serializes accesses to the FDB */
270 	struct mutex fdb_lock;
271 	/* PTP two-step TX timestamp ID, and its serialization lock */
272 	spinlock_t ts_id_lock;
273 	u8 ts_id;
274 	/* Serializes access to the dynamic config interface */
275 	struct mutex dynamic_config_lock;
276 	struct devlink_region **regions;
277 	struct sja1105_cbs_entry *cbs;
278 	struct mii_bus *mdio_base_t1;
279 	struct mii_bus *mdio_base_tx;
280 	struct mii_bus *mdio_pcs;
281 	struct dw_xpcs *xpcs[SJA1105_MAX_NUM_PORTS];
282 	struct sja1105_ptp_data ptp_data;
283 	struct sja1105_tas_data tas_data;
284 };
285 
286 #include "sja1105_dynamic_config.h"
287 
288 struct sja1105_spi_message {
289 	u64 access;
290 	u64 read_count;
291 	u64 address;
292 };
293 
294 /* From sja1105_main.c */
295 enum sja1105_reset_reason {
296 	SJA1105_VLAN_FILTERING = 0,
297 	SJA1105_AGEING_TIME,
298 	SJA1105_SCHEDULING,
299 	SJA1105_BEST_EFFORT_POLICING,
300 	SJA1105_VIRTUAL_LINKS,
301 };
302 
303 int sja1105_static_config_reload(struct sja1105_private *priv,
304 				 enum sja1105_reset_reason reason);
305 int sja1105_vlan_filtering(struct dsa_switch *ds, int port, bool enabled,
306 			   struct netlink_ext_ack *extack);
307 void sja1105_frame_memory_partitioning(struct sja1105_private *priv);
308 
309 /* From sja1105_mdio.c */
310 int sja1105_mdiobus_register(struct dsa_switch *ds);
311 void sja1105_mdiobus_unregister(struct dsa_switch *ds);
312 int sja1105_pcs_mdio_read_c45(struct mii_bus *bus, int phy, int mmd, int reg);
313 int sja1105_pcs_mdio_write_c45(struct mii_bus *bus, int phy, int mmd, int reg,
314 			       u16 val);
315 int sja1110_pcs_mdio_read_c45(struct mii_bus *bus, int phy, int mmd, int reg);
316 int sja1110_pcs_mdio_write_c45(struct mii_bus *bus, int phy, int mmd, int reg,
317 			       u16 val);
318 
319 /* From sja1105_devlink.c */
320 int sja1105_devlink_setup(struct dsa_switch *ds);
321 void sja1105_devlink_teardown(struct dsa_switch *ds);
322 int sja1105_devlink_info_get(struct dsa_switch *ds,
323 			     struct devlink_info_req *req,
324 			     struct netlink_ext_ack *extack);
325 
326 /* From sja1105_spi.c */
327 int sja1105_xfer_buf(const struct sja1105_private *priv,
328 		     sja1105_spi_rw_mode_t rw, u64 reg_addr,
329 		     u8 *buf, size_t len);
330 int sja1105_xfer_u32(const struct sja1105_private *priv,
331 		     sja1105_spi_rw_mode_t rw, u64 reg_addr, u32 *value,
332 		     struct ptp_system_timestamp *ptp_sts);
333 int sja1105_xfer_u64(const struct sja1105_private *priv,
334 		     sja1105_spi_rw_mode_t rw, u64 reg_addr, u64 *value,
335 		     struct ptp_system_timestamp *ptp_sts);
336 int static_config_buf_prepare_for_upload(struct sja1105_private *priv,
337 					 void *config_buf, int buf_len);
338 int sja1105_static_config_upload(struct sja1105_private *priv);
339 int sja1105_inhibit_tx(const struct sja1105_private *priv,
340 		       unsigned long port_bitmap, bool tx_inhibited);
341 
342 extern const struct sja1105_info sja1105e_info;
343 extern const struct sja1105_info sja1105t_info;
344 extern const struct sja1105_info sja1105p_info;
345 extern const struct sja1105_info sja1105q_info;
346 extern const struct sja1105_info sja1105r_info;
347 extern const struct sja1105_info sja1105s_info;
348 extern const struct sja1105_info sja1110a_info;
349 extern const struct sja1105_info sja1110b_info;
350 extern const struct sja1105_info sja1110c_info;
351 extern const struct sja1105_info sja1110d_info;
352 
353 /* From sja1105_clocking.c */
354 
355 typedef enum {
356 	XMII_MAC = 0,
357 	XMII_PHY = 1,
358 } sja1105_mii_role_t;
359 
360 typedef enum {
361 	XMII_MODE_MII		= 0,
362 	XMII_MODE_RMII		= 1,
363 	XMII_MODE_RGMII		= 2,
364 	XMII_MODE_SGMII		= 3,
365 } sja1105_phy_interface_t;
366 
367 int sja1105pqrs_setup_rgmii_delay(const void *ctx, int port);
368 int sja1110_setup_rgmii_delay(const void *ctx, int port);
369 int sja1105_clocking_setup_port(struct sja1105_private *priv, int port);
370 int sja1105_clocking_setup(struct sja1105_private *priv);
371 int sja1110_disable_microcontroller(struct sja1105_private *priv);
372 
373 /* From sja1105_ethtool.c */
374 void sja1105_get_ethtool_stats(struct dsa_switch *ds, int port, u64 *data);
375 void sja1105_get_strings(struct dsa_switch *ds, int port,
376 			 u32 stringset, u8 *data);
377 int sja1105_get_sset_count(struct dsa_switch *ds, int port, int sset);
378 
379 /* From sja1105_dynamic_config.c */
380 int sja1105_dynamic_config_read(struct sja1105_private *priv,
381 				enum sja1105_blk_idx blk_idx,
382 				int index, void *entry);
383 int sja1105_dynamic_config_write(struct sja1105_private *priv,
384 				 enum sja1105_blk_idx blk_idx,
385 				 int index, void *entry, bool keep);
386 
387 enum sja1105_iotag {
388 	SJA1105_C_TAG = 0, /* Inner VLAN header */
389 	SJA1105_S_TAG = 1, /* Outer VLAN header */
390 };
391 
392 enum sja1110_vlan_type {
393 	SJA1110_VLAN_INVALID = 0,
394 	SJA1110_VLAN_C_TAG = 1, /* Single inner VLAN tag */
395 	SJA1110_VLAN_S_TAG = 2, /* Single outer VLAN tag */
396 	SJA1110_VLAN_D_TAG = 3, /* Double tagged, use outer tag for lookup */
397 };
398 
399 enum sja1110_shaper_type {
400 	SJA1110_LEAKY_BUCKET_SHAPER = 0,
401 	SJA1110_CBS_SHAPER = 1,
402 };
403 
404 u8 sja1105et_fdb_hash(struct sja1105_private *priv, const u8 *addr, u16 vid);
405 int sja1105et_fdb_add(struct dsa_switch *ds, int port,
406 		      const unsigned char *addr, u16 vid);
407 int sja1105et_fdb_del(struct dsa_switch *ds, int port,
408 		      const unsigned char *addr, u16 vid);
409 int sja1105pqrs_fdb_add(struct dsa_switch *ds, int port,
410 			const unsigned char *addr, u16 vid);
411 int sja1105pqrs_fdb_del(struct dsa_switch *ds, int port,
412 			const unsigned char *addr, u16 vid);
413 
414 /* From sja1105_flower.c */
415 int sja1105_cls_flower_del(struct dsa_switch *ds, int port,
416 			   struct flow_cls_offload *cls, bool ingress);
417 int sja1105_cls_flower_add(struct dsa_switch *ds, int port,
418 			   struct flow_cls_offload *cls, bool ingress);
419 int sja1105_cls_flower_stats(struct dsa_switch *ds, int port,
420 			     struct flow_cls_offload *cls, bool ingress);
421 void sja1105_flower_setup(struct dsa_switch *ds);
422 void sja1105_flower_teardown(struct dsa_switch *ds);
423 struct sja1105_rule *sja1105_rule_find(struct sja1105_private *priv,
424 				       unsigned long cookie);
425 
426 #endif
427