1 // SPDX-License-Identifier: GPL-2.0-only
3 * Amlogic Meson8b, Meson8m2 and GXBB DWMAC glue layer
5 * Copyright (C) 2016 Martin Blumenstingl <martin.blumenstingl@googlemail.com>
8 #include <linux/bitfield.h>
10 #include <linux/clk-provider.h>
11 #include <linux/device.h>
12 #include <linux/ethtool.h>
14 #include <linux/ioport.h>
15 #include <linux/module.h>
17 #include <linux/of_net.h>
18 #include <linux/mfd/syscon.h>
19 #include <linux/platform_device.h>
20 #include <linux/stmmac.h>
22 #include "stmmac_platform.h"
26 #define PRG_ETH0_RGMII_MODE BIT(0)
28 #define PRG_ETH0_EXT_PHY_MODE_MASK GENMASK(2, 0)
29 #define PRG_ETH0_EXT_RGMII_MODE 1
30 #define PRG_ETH0_EXT_RMII_MODE 4
32 /* mux to choose between fclk_div2 (bit unset) and mpll2 (bit set) */
33 #define PRG_ETH0_CLK_M250_SEL_MASK GENMASK(4, 4)
35 /* TX clock delay in ns = "8ns / 4 * tx_dly_val" (where 8ns are exactly one
36 * cycle of the 125MHz RGMII TX clock):
37 * 0ns = 0x0, 2ns = 0x1, 4ns = 0x2, 6ns = 0x3
39 #define PRG_ETH0_TXDLY_MASK GENMASK(6, 5)
41 /* divider for the result of m250_sel */
42 #define PRG_ETH0_CLK_M250_DIV_SHIFT 7
43 #define PRG_ETH0_CLK_M250_DIV_WIDTH 3
45 #define PRG_ETH0_RGMII_TX_CLK_EN 10
47 #define PRG_ETH0_INVERTED_RMII_CLK BIT(11)
48 #define PRG_ETH0_TX_AND_PHY_REF_CLK BIT(12)
50 /* Bypass (= 0, the signal from the GPIO input directly connects to the
51 * internal sampling) or enable (= 1) the internal logic for RXEN and RXD[3:0]
54 #define PRG_ETH0_ADJ_ENABLE BIT(13)
55 /* Controls whether the RXEN and RXD[3:0] signals should be aligned with the
56 * input RX rising/falling edge and sent to the Ethernet internals. This sets
57 * the automatically delay and skew automatically (internally).
59 #define PRG_ETH0_ADJ_SETUP BIT(14)
60 /* An internal counter based on the "timing-adjustment" clock. The counter is
61 * cleared on both, the falling and rising edge of the RX_CLK. This selects the
62 * delay (= the counter value) when to start sampling RXEN and RXD[3:0].
64 #define PRG_ETH0_ADJ_DELAY GENMASK(19, 15)
65 /* Adjusts the skew between each bit of RXEN and RXD[3:0]. If a signal has a
66 * large input delay, the bit for that signal (RXEN = bit 0, RXD[3] = bit 1,
67 * ...) can be configured to be 1 to compensate for a delay of about 1ns.
69 #define PRG_ETH0_ADJ_SKEW GENMASK(24, 20)
73 /* Defined for adding a delay to the input RX_CLK for better timing.
74 * Each step is 200ps. These bits are used with external RGMII PHYs
75 * because RGMII RX only has the small window. cfg_rxclk_dly can
76 * adjust the window between RX_CLK and RX_DATA and improve the stability
79 #define PRG_ETH1_CFG_RXCLK_DLY GENMASK(19, 16)
83 struct meson8b_dwmac_data {
84 int (*set_phy_mode)(struct meson8b_dwmac *dwmac);
85 bool has_prg_eth1_rgmii_rx_delay;
88 struct meson8b_dwmac {
92 const struct meson8b_dwmac_data *data;
93 phy_interface_t phy_mode;
94 struct clk *rgmii_tx_clk;
97 struct clk *timing_adj_clk;
100 struct meson8b_dwmac_clk_configs {
101 struct clk_mux m250_mux;
102 struct clk_divider m250_div;
103 struct clk_fixed_factor fixed_div2;
104 struct clk_gate rgmii_tx_en;
107 static void meson8b_dwmac_mask_bits(struct meson8b_dwmac *dwmac, u32 reg,
112 data = readl(dwmac->regs + reg);
114 data |= (value & mask);
116 writel(data, dwmac->regs + reg);
119 static struct clk *meson8b_dwmac_register_clk(struct meson8b_dwmac *dwmac,
120 const char *name_suffix,
121 const struct clk_parent_data *parents,
123 const struct clk_ops *ops,
126 struct clk_init_data init = { };
129 snprintf(clk_name, sizeof(clk_name), "%s#%s", dev_name(dwmac->dev),
132 init.name = clk_name;
134 init.flags = CLK_SET_RATE_PARENT;
135 init.parent_data = parents;
136 init.num_parents = num_parents;
140 return devm_clk_register(dwmac->dev, hw);
143 static int meson8b_init_rgmii_tx_clk(struct meson8b_dwmac *dwmac)
146 struct device *dev = dwmac->dev;
147 static const struct clk_parent_data mux_parents[] = {
148 { .fw_name = "clkin0", },
151 static const struct clk_div_table div_table[] = {
152 { .div = 2, .val = 2, },
153 { .div = 3, .val = 3, },
154 { .div = 4, .val = 4, },
155 { .div = 5, .val = 5, },
156 { .div = 6, .val = 6, },
157 { .div = 7, .val = 7, },
158 { /* end of array */ }
160 struct meson8b_dwmac_clk_configs *clk_configs;
161 struct clk_parent_data parent_data = { };
163 clk_configs = devm_kzalloc(dev, sizeof(*clk_configs), GFP_KERNEL);
167 clk_configs->m250_mux.reg = dwmac->regs + PRG_ETH0;
168 clk_configs->m250_mux.shift = __ffs(PRG_ETH0_CLK_M250_SEL_MASK);
169 clk_configs->m250_mux.mask = PRG_ETH0_CLK_M250_SEL_MASK >>
170 clk_configs->m250_mux.shift;
171 clk = meson8b_dwmac_register_clk(dwmac, "m250_sel", mux_parents,
172 ARRAY_SIZE(mux_parents), &clk_mux_ops,
173 &clk_configs->m250_mux.hw);
174 if (WARN_ON(IS_ERR(clk)))
177 parent_data.hw = &clk_configs->m250_mux.hw;
178 clk_configs->m250_div.reg = dwmac->regs + PRG_ETH0;
179 clk_configs->m250_div.shift = PRG_ETH0_CLK_M250_DIV_SHIFT;
180 clk_configs->m250_div.width = PRG_ETH0_CLK_M250_DIV_WIDTH;
181 clk_configs->m250_div.table = div_table;
182 clk_configs->m250_div.flags = CLK_DIVIDER_ALLOW_ZERO |
183 CLK_DIVIDER_ROUND_CLOSEST;
184 clk = meson8b_dwmac_register_clk(dwmac, "m250_div", &parent_data, 1,
186 &clk_configs->m250_div.hw);
187 if (WARN_ON(IS_ERR(clk)))
190 parent_data.hw = &clk_configs->m250_div.hw;
191 clk_configs->fixed_div2.mult = 1;
192 clk_configs->fixed_div2.div = 2;
193 clk = meson8b_dwmac_register_clk(dwmac, "fixed_div2", &parent_data, 1,
194 &clk_fixed_factor_ops,
195 &clk_configs->fixed_div2.hw);
196 if (WARN_ON(IS_ERR(clk)))
199 parent_data.hw = &clk_configs->fixed_div2.hw;
200 clk_configs->rgmii_tx_en.reg = dwmac->regs + PRG_ETH0;
201 clk_configs->rgmii_tx_en.bit_idx = PRG_ETH0_RGMII_TX_CLK_EN;
202 clk = meson8b_dwmac_register_clk(dwmac, "rgmii_tx_en", &parent_data, 1,
204 &clk_configs->rgmii_tx_en.hw);
205 if (WARN_ON(IS_ERR(clk)))
208 dwmac->rgmii_tx_clk = clk;
213 static int meson8b_set_phy_mode(struct meson8b_dwmac *dwmac)
215 switch (dwmac->phy_mode) {
216 case PHY_INTERFACE_MODE_RGMII:
217 case PHY_INTERFACE_MODE_RGMII_RXID:
218 case PHY_INTERFACE_MODE_RGMII_ID:
219 case PHY_INTERFACE_MODE_RGMII_TXID:
220 /* enable RGMII mode */
221 meson8b_dwmac_mask_bits(dwmac, PRG_ETH0,
223 PRG_ETH0_RGMII_MODE);
225 case PHY_INTERFACE_MODE_RMII:
226 /* disable RGMII mode -> enables RMII mode */
227 meson8b_dwmac_mask_bits(dwmac, PRG_ETH0,
228 PRG_ETH0_RGMII_MODE, 0);
231 dev_err(dwmac->dev, "fail to set phy-mode %s\n",
232 phy_modes(dwmac->phy_mode));
239 static int meson_axg_set_phy_mode(struct meson8b_dwmac *dwmac)
241 switch (dwmac->phy_mode) {
242 case PHY_INTERFACE_MODE_RGMII:
243 case PHY_INTERFACE_MODE_RGMII_RXID:
244 case PHY_INTERFACE_MODE_RGMII_ID:
245 case PHY_INTERFACE_MODE_RGMII_TXID:
246 /* enable RGMII mode */
247 meson8b_dwmac_mask_bits(dwmac, PRG_ETH0,
248 PRG_ETH0_EXT_PHY_MODE_MASK,
249 PRG_ETH0_EXT_RGMII_MODE);
251 case PHY_INTERFACE_MODE_RMII:
252 /* disable RGMII mode -> enables RMII mode */
253 meson8b_dwmac_mask_bits(dwmac, PRG_ETH0,
254 PRG_ETH0_EXT_PHY_MODE_MASK,
255 PRG_ETH0_EXT_RMII_MODE);
258 dev_err(dwmac->dev, "fail to set phy-mode %s\n",
259 phy_modes(dwmac->phy_mode));
266 static void meson8b_clk_disable_unprepare(void *data)
268 clk_disable_unprepare(data);
271 static int meson8b_devm_clk_prepare_enable(struct meson8b_dwmac *dwmac,
276 ret = clk_prepare_enable(clk);
280 return devm_add_action_or_reset(dwmac->dev,
281 meson8b_clk_disable_unprepare, clk);
284 static int meson8b_init_rgmii_delays(struct meson8b_dwmac *dwmac)
286 u32 tx_dly_config, rx_adj_config, cfg_rxclk_dly, delay_config;
291 tx_dly_config = FIELD_PREP(PRG_ETH0_TXDLY_MASK,
292 dwmac->tx_delay_ns >> 1);
294 if (dwmac->data->has_prg_eth1_rgmii_rx_delay)
295 cfg_rxclk_dly = FIELD_PREP(PRG_ETH1_CFG_RXCLK_DLY,
296 dwmac->rx_delay_ps / 200);
297 else if (dwmac->rx_delay_ps == 2000)
298 rx_adj_config = PRG_ETH0_ADJ_ENABLE | PRG_ETH0_ADJ_SETUP;
300 switch (dwmac->phy_mode) {
301 case PHY_INTERFACE_MODE_RGMII:
302 delay_config = tx_dly_config | rx_adj_config;
304 case PHY_INTERFACE_MODE_RGMII_RXID:
305 delay_config = tx_dly_config;
308 case PHY_INTERFACE_MODE_RGMII_TXID:
309 delay_config = rx_adj_config;
311 case PHY_INTERFACE_MODE_RGMII_ID:
312 case PHY_INTERFACE_MODE_RMII:
317 dev_err(dwmac->dev, "unsupported phy-mode %s\n",
318 phy_modes(dwmac->phy_mode));
322 if (delay_config & PRG_ETH0_ADJ_ENABLE) {
323 if (!dwmac->timing_adj_clk) {
325 "The timing-adjustment clock is mandatory for the RX delay re-timing\n");
329 /* The timing adjustment logic is driven by a separate clock */
330 ret = meson8b_devm_clk_prepare_enable(dwmac,
331 dwmac->timing_adj_clk);
334 "Failed to enable the timing-adjustment clock\n");
339 meson8b_dwmac_mask_bits(dwmac, PRG_ETH0, PRG_ETH0_TXDLY_MASK |
340 PRG_ETH0_ADJ_ENABLE | PRG_ETH0_ADJ_SETUP |
341 PRG_ETH0_ADJ_DELAY | PRG_ETH0_ADJ_SKEW,
344 meson8b_dwmac_mask_bits(dwmac, PRG_ETH1, PRG_ETH1_CFG_RXCLK_DLY,
350 static int meson8b_init_prg_eth(struct meson8b_dwmac *dwmac)
354 if (phy_interface_mode_is_rgmii(dwmac->phy_mode)) {
355 /* only relevant for RMII mode -> disable in RGMII mode */
356 meson8b_dwmac_mask_bits(dwmac, PRG_ETH0,
357 PRG_ETH0_INVERTED_RMII_CLK, 0);
359 /* Configure the 125MHz RGMII TX clock, the IP block changes
360 * the output automatically (= without us having to configure
361 * a register) based on the line-speed (125MHz for Gbit speeds,
362 * 25MHz for 100Mbit/s and 2.5MHz for 10Mbit/s).
364 ret = clk_set_rate(dwmac->rgmii_tx_clk, 125 * 1000 * 1000);
367 "failed to set RGMII TX clock\n");
371 ret = meson8b_devm_clk_prepare_enable(dwmac,
372 dwmac->rgmii_tx_clk);
375 "failed to enable the RGMII TX clock\n");
379 /* invert internal clk_rmii_i to generate 25/2.5 tx_rx_clk */
380 meson8b_dwmac_mask_bits(dwmac, PRG_ETH0,
381 PRG_ETH0_INVERTED_RMII_CLK,
382 PRG_ETH0_INVERTED_RMII_CLK);
385 /* enable TX_CLK and PHY_REF_CLK generator */
386 meson8b_dwmac_mask_bits(dwmac, PRG_ETH0, PRG_ETH0_TX_AND_PHY_REF_CLK,
387 PRG_ETH0_TX_AND_PHY_REF_CLK);
392 static int meson8b_dwmac_probe(struct platform_device *pdev)
394 struct plat_stmmacenet_data *plat_dat;
395 struct stmmac_resources stmmac_res;
396 struct meson8b_dwmac *dwmac;
399 ret = stmmac_get_platform_resources(pdev, &stmmac_res);
403 plat_dat = stmmac_probe_config_dt(pdev, stmmac_res.mac);
404 if (IS_ERR(plat_dat))
405 return PTR_ERR(plat_dat);
407 dwmac = devm_kzalloc(&pdev->dev, sizeof(*dwmac), GFP_KERNEL);
410 goto err_remove_config_dt;
413 dwmac->data = (const struct meson8b_dwmac_data *)
414 of_device_get_match_data(&pdev->dev);
417 goto err_remove_config_dt;
419 dwmac->regs = devm_platform_ioremap_resource(pdev, 1);
420 if (IS_ERR(dwmac->regs)) {
421 ret = PTR_ERR(dwmac->regs);
422 goto err_remove_config_dt;
425 dwmac->dev = &pdev->dev;
426 ret = of_get_phy_mode(pdev->dev.of_node, &dwmac->phy_mode);
428 dev_err(&pdev->dev, "missing phy-mode property\n");
429 goto err_remove_config_dt;
432 /* use 2ns as fallback since this value was previously hardcoded */
433 if (of_property_read_u32(pdev->dev.of_node, "amlogic,tx-delay-ns",
434 &dwmac->tx_delay_ns))
435 dwmac->tx_delay_ns = 2;
437 /* RX delay defaults to 0ps since this is what many boards use */
438 if (of_property_read_u32(pdev->dev.of_node, "rx-internal-delay-ps",
439 &dwmac->rx_delay_ps)) {
440 if (!of_property_read_u32(pdev->dev.of_node,
441 "amlogic,rx-delay-ns",
442 &dwmac->rx_delay_ps))
443 /* convert ns to ps */
444 dwmac->rx_delay_ps *= 1000;
447 if (dwmac->data->has_prg_eth1_rgmii_rx_delay) {
448 if (dwmac->rx_delay_ps > 3000 || dwmac->rx_delay_ps % 200) {
450 "The RGMII RX delay range is 0..3000ps in 200ps steps");
452 goto err_remove_config_dt;
455 if (dwmac->rx_delay_ps != 0 && dwmac->rx_delay_ps != 2000) {
457 "The only allowed RGMII RX delays values are: 0ps, 2000ps");
459 goto err_remove_config_dt;
463 dwmac->timing_adj_clk = devm_clk_get_optional(dwmac->dev,
464 "timing-adjustment");
465 if (IS_ERR(dwmac->timing_adj_clk)) {
466 ret = PTR_ERR(dwmac->timing_adj_clk);
467 goto err_remove_config_dt;
470 ret = meson8b_init_rgmii_delays(dwmac);
472 goto err_remove_config_dt;
474 ret = meson8b_init_rgmii_tx_clk(dwmac);
476 goto err_remove_config_dt;
478 ret = dwmac->data->set_phy_mode(dwmac);
480 goto err_remove_config_dt;
482 ret = meson8b_init_prg_eth(dwmac);
484 goto err_remove_config_dt;
486 plat_dat->bsp_priv = dwmac;
488 ret = stmmac_dvr_probe(&pdev->dev, plat_dat, &stmmac_res);
490 goto err_remove_config_dt;
494 err_remove_config_dt:
495 stmmac_remove_config_dt(pdev, plat_dat);
500 static const struct meson8b_dwmac_data meson8b_dwmac_data = {
501 .set_phy_mode = meson8b_set_phy_mode,
502 .has_prg_eth1_rgmii_rx_delay = false,
505 static const struct meson8b_dwmac_data meson_axg_dwmac_data = {
506 .set_phy_mode = meson_axg_set_phy_mode,
507 .has_prg_eth1_rgmii_rx_delay = false,
510 static const struct meson8b_dwmac_data meson_g12a_dwmac_data = {
511 .set_phy_mode = meson_axg_set_phy_mode,
512 .has_prg_eth1_rgmii_rx_delay = true,
515 static const struct of_device_id meson8b_dwmac_match[] = {
517 .compatible = "amlogic,meson8b-dwmac",
518 .data = &meson8b_dwmac_data,
521 .compatible = "amlogic,meson8m2-dwmac",
522 .data = &meson8b_dwmac_data,
525 .compatible = "amlogic,meson-gxbb-dwmac",
526 .data = &meson8b_dwmac_data,
529 .compatible = "amlogic,meson-axg-dwmac",
530 .data = &meson_axg_dwmac_data,
533 .compatible = "amlogic,meson-g12a-dwmac",
534 .data = &meson_g12a_dwmac_data,
538 MODULE_DEVICE_TABLE(of, meson8b_dwmac_match);
540 static struct platform_driver meson8b_dwmac_driver = {
541 .probe = meson8b_dwmac_probe,
542 .remove_new = stmmac_pltfr_remove,
544 .name = "meson8b-dwmac",
545 .pm = &stmmac_pltfr_pm_ops,
546 .of_match_table = meson8b_dwmac_match,
549 module_platform_driver(meson8b_dwmac_driver);
551 MODULE_AUTHOR("Martin Blumenstingl <martin.blumenstingl@googlemail.com>");
552 MODULE_DESCRIPTION("Amlogic Meson8b, Meson8m2 and GXBB DWMAC glue layer");
553 MODULE_LICENSE("GPL v2");