xref: /linux/include/linux/stmmac.h (revision 37a93dd5c49b5fda807fd204edf2547c3493319c)
1 /* SPDX-License-Identifier: GPL-2.0-only */
2 /*******************************************************************************
3 
4   Header file for stmmac platform data
5 
6   Copyright (C) 2009  STMicroelectronics Ltd
7 
8 
9   Author: Giuseppe Cavallaro <peppe.cavallaro@st.com>
10 *******************************************************************************/
11 
12 #ifndef __STMMAC_PLATFORM_DATA
13 #define __STMMAC_PLATFORM_DATA
14 
15 #include <linux/platform_device.h>
16 #include <linux/phylink.h>
17 
18 #define MTL_MAX_RX_QUEUES	8
19 #define MTL_MAX_TX_QUEUES	8
20 #define STMMAC_CH_MAX		8
21 
22 #define STMMAC_RX_COE_NONE	0
23 #define STMMAC_RX_COE_TYPE1	1
24 #define STMMAC_RX_COE_TYPE2	2
25 
26 /* Define the macros for CSR clock range parameters to be passed by
27  * platform code.
28  * This could also be configured at run time using CPU freq framework. */
29 
30 /* MDC Clock Selection define*/
31 #define	STMMAC_CSR_60_100M	0x0	/* MDC = clk_csr_i/42 */
32 #define	STMMAC_CSR_100_150M	0x1	/* MDC = clk_csr_i/62 */
33 #define	STMMAC_CSR_20_35M	0x2	/* MDC = clk_csr_i/16 */
34 #define	STMMAC_CSR_35_60M	0x3	/* MDC = clk_csr_i/26 */
35 #define	STMMAC_CSR_150_250M	0x4	/* MDC = clk_csr_i/102 */
36 #define	STMMAC_CSR_250_300M	0x5	/* MDC = clk_csr_i/124 */
37 #define	STMMAC_CSR_300_500M	0x6	/* MDC = clk_csr_i/204 */
38 #define	STMMAC_CSR_500_800M	0x7	/* MDC = clk_csr_i/324 */
39 
40 /* MTL algorithms identifiers */
41 #define MTL_TX_ALGORITHM_WRR	0x0
42 #define MTL_TX_ALGORITHM_WFQ	0x1
43 #define MTL_TX_ALGORITHM_DWRR	0x2
44 #define MTL_TX_ALGORITHM_SP	0x3
45 #define MTL_RX_ALGORITHM_SP	0x4
46 #define MTL_RX_ALGORITHM_WSP	0x5
47 
48 /* RX/TX Queue Mode */
49 #define MTL_QUEUE_AVB		0x0
50 #define MTL_QUEUE_DCB		0x1
51 
52 /* The MDC clock could be set higher than the IEEE 802.3
53  * specified frequency limit 0f 2.5 MHz, by programming a clock divider
54  * of value different than the above defined values. The resultant MDIO
55  * clock frequency of 12.5 MHz is applicable for the interfacing chips
56  * supporting higher MDC clocks.
57  * The MDC clock selection macros need to be defined for MDC clock rate
58  * of 12.5 MHz, corresponding to the following selection.
59  */
60 #define STMMAC_CSR_I_4		0x8	/* clk_csr_i/4 */
61 #define STMMAC_CSR_I_6		0x9	/* clk_csr_i/6 */
62 #define STMMAC_CSR_I_8		0xA	/* clk_csr_i/8 */
63 #define STMMAC_CSR_I_10		0xB	/* clk_csr_i/10 */
64 #define STMMAC_CSR_I_12		0xC	/* clk_csr_i/12 */
65 #define STMMAC_CSR_I_14		0xD	/* clk_csr_i/14 */
66 #define STMMAC_CSR_I_16		0xE	/* clk_csr_i/16 */
67 #define STMMAC_CSR_I_18		0xF	/* clk_csr_i/18 */
68 
69 /* AXI DMA Burst length supported */
70 #define DMA_AXI_BLEN_4		(1 << 1)
71 #define DMA_AXI_BLEN_8		(1 << 2)
72 #define DMA_AXI_BLEN_16		(1 << 3)
73 #define DMA_AXI_BLEN_32		(1 << 4)
74 #define DMA_AXI_BLEN_64		(1 << 5)
75 #define DMA_AXI_BLEN_128	(1 << 6)
76 #define DMA_AXI_BLEN_256	(1 << 7)
77 #define DMA_AXI_BLEN_ALL (DMA_AXI_BLEN_4 | DMA_AXI_BLEN_8 | DMA_AXI_BLEN_16 \
78 			| DMA_AXI_BLEN_32 | DMA_AXI_BLEN_64 \
79 			| DMA_AXI_BLEN_128 | DMA_AXI_BLEN_256)
80 
81 struct clk;
82 struct stmmac_priv;
83 
84 /* Platfrom data for platform device structure's platform_data field */
85 
86 struct stmmac_mdio_bus_data {
87 	unsigned int phy_mask;
88 	unsigned int pcs_mask;
89 	unsigned int default_an_inband;
90 	int *irqs;
91 	int probed_phy_irq;
92 	bool needs_reset;
93 };
94 
95 struct stmmac_dma_cfg {
96 	int pbl;
97 	int txpbl;
98 	int rxpbl;
99 	bool pblx8;
100 	int fixed_burst;
101 	int mixed_burst;
102 	bool aal;
103 	bool eame;
104 	bool multi_msi_en;
105 	bool dche;
106 	bool atds;
107 };
108 
109 #define AXI_BLEN	7
110 struct stmmac_axi {
111 	bool axi_lpi_en;
112 	bool axi_xit_frm;
113 	u32 axi_wr_osr_lmt;
114 	u32 axi_rd_osr_lmt;
115 	bool axi_kbbe;
116 	u32 axi_blen_regval;
117 	bool axi_fb;
118 	bool axi_mb;
119 	bool axi_rb;
120 };
121 
122 struct stmmac_rxq_cfg {
123 	u8 mode_to_use;
124 	u32 chan;
125 	u8 pkt_route;
126 	bool use_prio;
127 	u32 prio;
128 };
129 
130 struct stmmac_txq_cfg {
131 	u32 weight;
132 	bool coe_unsupported;
133 	u8 mode_to_use;
134 	/* Credit Base Shaper parameters */
135 	u32 send_slope;
136 	u32 idle_slope;
137 	u32 high_credit;
138 	u32 low_credit;
139 	bool use_prio;
140 	u32 prio;
141 	int tbs_en;
142 };
143 
144 struct stmmac_safety_feature_cfg {
145 	u32 tsoee;
146 	u32 mrxpee;
147 	u32 mestee;
148 	u32 mrxee;
149 	u32 mtxee;
150 	u32 epsi;
151 	u32 edpp;
152 	u32 prtyen;
153 	u32 tmouten;
154 };
155 
156 /* Addresses that may be customized by a platform */
157 struct dwmac4_addrs {
158 	u32 dma_chan;
159 	u32 dma_chan_offset;
160 	u32 mtl_chan;
161 	u32 mtl_chan_offset;
162 	u32 mtl_ets_ctrl;
163 	u32 mtl_ets_ctrl_offset;
164 	u32 mtl_txq_weight;
165 	u32 mtl_txq_weight_offset;
166 	u32 mtl_send_slp_cred;
167 	u32 mtl_send_slp_cred_offset;
168 	u32 mtl_high_cred;
169 	u32 mtl_high_cred_offset;
170 	u32 mtl_low_cred;
171 	u32 mtl_low_cred_offset;
172 };
173 
174 enum dwmac_core_type {
175 	DWMAC_CORE_MAC100,
176 	DWMAC_CORE_GMAC,
177 	DWMAC_CORE_GMAC4,
178 	DWMAC_CORE_XGMAC,
179 };
180 
181 #define STMMAC_FLAG_SPH_DISABLE			BIT(1)
182 #define STMMAC_FLAG_USE_PHY_WOL			BIT(2)
183 #define STMMAC_FLAG_HAS_SUN8I			BIT(3)
184 #define STMMAC_FLAG_TSO_EN			BIT(4)
185 #define STMMAC_FLAG_SERDES_UP_AFTER_PHY_LINKUP	BIT(5)
186 #define STMMAC_FLAG_VLAN_FAIL_Q_EN		BIT(6)
187 #define STMMAC_FLAG_MULTI_MSI_EN		BIT(7)
188 #define STMMAC_FLAG_EXT_SNAPSHOT_EN		BIT(8)
189 #define STMMAC_FLAG_INT_SNAPSHOT_EN		BIT(9)
190 #define STMMAC_FLAG_RX_CLK_RUNS_IN_LPI		BIT(10)
191 #define STMMAC_FLAG_EN_TX_LPI_CLOCKGATING	BIT(11)
192 #define STMMAC_FLAG_EN_TX_LPI_CLK_PHY_CAP	BIT(12)
193 #define STMMAC_FLAG_HWTSTAMP_CORRECT_LATENCY	BIT(13)
194 #define STMMAC_FLAG_KEEP_PREAMBLE_BEFORE_SFD	BIT(14)
195 
196 struct mac_device_info;
197 
198 struct plat_stmmacenet_data {
199 	enum dwmac_core_type core_type;
200 	int bus_id;
201 	int phy_addr;
202 	/* MAC ----- optional PCS ----- SerDes ----- optional PHY ----- Media
203 	 *                                       ^
204 	 *                                  phy_interface
205 	 *
206 	 * The Synopsys dwmac core only covers the MAC and an optional
207 	 * integrated PCS. Where the integrated PCS is used with a SerDes,
208 	 * e.g. for 1000base-X or Cisco SGMII, the connection between the
209 	 * PCS and SerDes will be TBI.
210 	 *
211 	 * Where the Synopsys dwmac core has been instantiated with multiple
212 	 * interface modes, these are selected via core-external configuration
213 	 * which is sampled when the dwmac core is reset. How this is done is
214 	 * platform glue specific, but this defines the interface used from
215 	 * the Synopsys dwmac core to the rest of the SoC.
216 	 *
217 	 * Where PCS other than the optional integrated Synopsys dwmac PCS
218 	 * is used, this counts as "the rest of the SoC" in the above
219 	 * paragraph.
220 	 *
221 	 * phy_interface is the PHY-side interface - the interface used by
222 	 * an attached PHY or SFP etc. This is equivalent to the interface
223 	 * that phylink uses.
224 	 */
225 	phy_interface_t phy_interface;
226 	struct stmmac_mdio_bus_data *mdio_bus_data;
227 	struct device_node *phy_node;
228 	struct fwnode_handle *port_node;
229 	struct device_node *mdio_node;
230 	struct stmmac_dma_cfg *dma_cfg;
231 	struct stmmac_safety_feature_cfg *safety_feat_cfg;
232 	int clk_csr;
233 	int enh_desc;
234 	int tx_coe;
235 	int rx_coe;
236 	int bugged_jumbo;
237 	int pmt;
238 	int force_sf_dma_mode;
239 	int force_thresh_dma_mode;
240 	int riwt_off;
241 	int max_speed;
242 	int maxmtu;
243 	int multicast_filter_bins;
244 	int unicast_filter_entries;
245 	int tx_fifo_size;
246 	int rx_fifo_size;
247 	u32 host_dma_width;
248 	u32 rx_queues_to_use;
249 	u32 tx_queues_to_use;
250 	u8 rx_sched_algorithm;
251 	u8 tx_sched_algorithm;
252 	struct stmmac_rxq_cfg rx_queues_cfg[MTL_MAX_RX_QUEUES];
253 	struct stmmac_txq_cfg tx_queues_cfg[MTL_MAX_TX_QUEUES];
254 	void (*get_interfaces)(struct stmmac_priv *priv, void *bsp_priv,
255 			       unsigned long *interfaces);
256 	int (*set_phy_intf_sel)(void *priv, u8 phy_intf_sel);
257 	int (*set_clk_tx_rate)(void *priv, struct clk *clk_tx_i,
258 			       phy_interface_t interface, int speed);
259 	void (*fix_mac_speed)(void *priv, int speed, unsigned int mode);
260 	int (*fix_soc_reset)(struct stmmac_priv *priv);
261 	int (*serdes_powerup)(struct net_device *ndev, void *priv);
262 	void (*serdes_powerdown)(struct net_device *ndev, void *priv);
263 	int (*mac_finish)(struct net_device *ndev,
264 			  void *priv,
265 			  unsigned int mode,
266 			  phy_interface_t interface);
267 	void (*ptp_clk_freq_config)(struct stmmac_priv *priv);
268 	int (*init)(struct device *dev, void *priv);
269 	void (*exit)(struct device *dev, void *priv);
270 	int (*suspend)(struct device *dev, void *priv);
271 	int (*resume)(struct device *dev, void *priv);
272 	int (*mac_setup)(void *priv, struct mac_device_info *mac);
273 	int (*clks_config)(void *priv, bool enabled);
274 	int (*crosststamp)(ktime_t *device, struct system_counterval_t *system,
275 			   void *ctx);
276 	void (*dump_debug_regs)(void *priv);
277 	int (*pcs_init)(struct stmmac_priv *priv);
278 	void (*pcs_exit)(struct stmmac_priv *priv);
279 	struct phylink_pcs *(*select_pcs)(struct stmmac_priv *priv,
280 					  phy_interface_t interface);
281 	void *bsp_priv;
282 	struct clk *stmmac_clk;
283 	struct clk *pclk;
284 	struct clk *clk_ptp_ref;
285 	struct clk *clk_tx_i;		/* clk_tx_i to MAC core */
286 	unsigned long clk_ptp_rate;
287 	unsigned long clk_ref_rate;
288 	struct clk_bulk_data *clks;
289 	int num_clks;
290 	unsigned int mult_fact_100ns;
291 	s32 ptp_max_adj;
292 	u32 cdc_error_adj;
293 	struct reset_control *stmmac_rst;
294 	struct reset_control *stmmac_ahb_rst;
295 	struct stmmac_axi *axi;
296 	int rss_en;
297 	int mac_port_sel_speed;
298 	u8 vlan_fail_q;
299 	struct pci_dev *pdev;
300 	int int_snapshot_num;
301 	int msi_mac_vec;
302 	int msi_wol_vec;
303 	int msi_sfty_ce_vec;
304 	int msi_sfty_ue_vec;
305 	int msi_rx_base_vec;
306 	int msi_tx_base_vec;
307 	const struct dwmac4_addrs *dwmac4_addrs;
308 	unsigned int flags;
309 };
310 #endif
311