xref: /openbmc/linux/drivers/net/phy/dp83867.c (revision 7fc38225363dd8f19e667ad7c77b63bc4a5c065d)
1 // SPDX-License-Identifier: GPL-2.0
2 /*
3  * Driver for the Texas Instruments DP83867 PHY
4  *
5  * Copyright (C) 2015 Texas Instruments Inc.
6  */
7 
8 #include <linux/ethtool.h>
9 #include <linux/kernel.h>
10 #include <linux/mii.h>
11 #include <linux/module.h>
12 #include <linux/of.h>
13 #include <linux/phy.h>
14 
15 #include <dt-bindings/net/ti-dp83867.h>
16 
17 #define DP83867_PHY_ID		0x2000a231
18 #define DP83867_DEVADDR		0x1f
19 
20 #define MII_DP83867_PHYCTRL	0x10
21 #define MII_DP83867_MICR	0x12
22 #define MII_DP83867_ISR		0x13
23 #define DP83867_CTRL		0x1f
24 #define DP83867_CFG3		0x1e
25 
26 /* Extended Registers */
27 #define DP83867_CFG4            0x0031
28 #define DP83867_RGMIICTL	0x0032
29 #define DP83867_STRAP_STS1	0x006E
30 #define DP83867_RGMIIDCTL	0x0086
31 #define DP83867_IO_MUX_CFG	0x0170
32 
33 #define DP83867_SW_RESET	BIT(15)
34 #define DP83867_SW_RESTART	BIT(14)
35 
36 /* MICR Interrupt bits */
37 #define MII_DP83867_MICR_AN_ERR_INT_EN		BIT(15)
38 #define MII_DP83867_MICR_SPEED_CHNG_INT_EN	BIT(14)
39 #define MII_DP83867_MICR_DUP_MODE_CHNG_INT_EN	BIT(13)
40 #define MII_DP83867_MICR_PAGE_RXD_INT_EN	BIT(12)
41 #define MII_DP83867_MICR_AUTONEG_COMP_INT_EN	BIT(11)
42 #define MII_DP83867_MICR_LINK_STS_CHNG_INT_EN	BIT(10)
43 #define MII_DP83867_MICR_FALSE_CARRIER_INT_EN	BIT(8)
44 #define MII_DP83867_MICR_SLEEP_MODE_CHNG_INT_EN	BIT(4)
45 #define MII_DP83867_MICR_WOL_INT_EN		BIT(3)
46 #define MII_DP83867_MICR_XGMII_ERR_INT_EN	BIT(2)
47 #define MII_DP83867_MICR_POL_CHNG_INT_EN	BIT(1)
48 #define MII_DP83867_MICR_JABBER_INT_EN		BIT(0)
49 
50 /* RGMIICTL bits */
51 #define DP83867_RGMII_TX_CLK_DELAY_EN		BIT(1)
52 #define DP83867_RGMII_RX_CLK_DELAY_EN		BIT(0)
53 
54 /* STRAP_STS1 bits */
55 #define DP83867_STRAP_STS1_RESERVED		BIT(11)
56 
57 /* PHY CTRL bits */
58 #define DP83867_PHYCR_FIFO_DEPTH_SHIFT		14
59 #define DP83867_PHYCR_FIFO_DEPTH_MASK		(3 << 14)
60 #define DP83867_PHYCR_RESERVED_MASK		BIT(11)
61 
62 /* RGMIIDCTL bits */
63 #define DP83867_RGMII_TX_CLK_DELAY_SHIFT	4
64 
65 /* IO_MUX_CFG bits */
66 #define DP83867_IO_MUX_CFG_IO_IMPEDANCE_CTRL	0x1f
67 
68 #define DP83867_IO_MUX_CFG_IO_IMPEDANCE_MAX	0x0
69 #define DP83867_IO_MUX_CFG_IO_IMPEDANCE_MIN	0x1f
70 #define DP83867_IO_MUX_CFG_CLK_O_SEL_MASK	(0x1f << 8)
71 #define DP83867_IO_MUX_CFG_CLK_O_SEL_SHIFT	8
72 
73 /* CFG4 bits */
74 #define DP83867_CFG4_PORT_MIRROR_EN              BIT(0)
75 
76 enum {
77 	DP83867_PORT_MIRROING_KEEP,
78 	DP83867_PORT_MIRROING_EN,
79 	DP83867_PORT_MIRROING_DIS,
80 };
81 
82 struct dp83867_private {
83 	int rx_id_delay;
84 	int tx_id_delay;
85 	int fifo_depth;
86 	int io_impedance;
87 	int port_mirroring;
88 	bool rxctrl_strap_quirk;
89 	int clk_output_sel;
90 };
91 
92 static int dp83867_ack_interrupt(struct phy_device *phydev)
93 {
94 	int err = phy_read(phydev, MII_DP83867_ISR);
95 
96 	if (err < 0)
97 		return err;
98 
99 	return 0;
100 }
101 
102 static int dp83867_config_intr(struct phy_device *phydev)
103 {
104 	int micr_status;
105 
106 	if (phydev->interrupts == PHY_INTERRUPT_ENABLED) {
107 		micr_status = phy_read(phydev, MII_DP83867_MICR);
108 		if (micr_status < 0)
109 			return micr_status;
110 
111 		micr_status |=
112 			(MII_DP83867_MICR_AN_ERR_INT_EN |
113 			MII_DP83867_MICR_SPEED_CHNG_INT_EN |
114 			MII_DP83867_MICR_AUTONEG_COMP_INT_EN |
115 			MII_DP83867_MICR_LINK_STS_CHNG_INT_EN |
116 			MII_DP83867_MICR_DUP_MODE_CHNG_INT_EN |
117 			MII_DP83867_MICR_SLEEP_MODE_CHNG_INT_EN);
118 
119 		return phy_write(phydev, MII_DP83867_MICR, micr_status);
120 	}
121 
122 	micr_status = 0x0;
123 	return phy_write(phydev, MII_DP83867_MICR, micr_status);
124 }
125 
126 static int dp83867_config_port_mirroring(struct phy_device *phydev)
127 {
128 	struct dp83867_private *dp83867 =
129 		(struct dp83867_private *)phydev->priv;
130 	u16 val;
131 
132 	val = phy_read_mmd(phydev, DP83867_DEVADDR, DP83867_CFG4);
133 
134 	if (dp83867->port_mirroring == DP83867_PORT_MIRROING_EN)
135 		val |= DP83867_CFG4_PORT_MIRROR_EN;
136 	else
137 		val &= ~DP83867_CFG4_PORT_MIRROR_EN;
138 
139 	phy_write_mmd(phydev, DP83867_DEVADDR, DP83867_CFG4, val);
140 
141 	return 0;
142 }
143 
144 #ifdef CONFIG_OF_MDIO
145 static int dp83867_of_init(struct phy_device *phydev)
146 {
147 	struct dp83867_private *dp83867 = phydev->priv;
148 	struct device *dev = &phydev->mdio.dev;
149 	struct device_node *of_node = dev->of_node;
150 	int ret;
151 
152 	if (!of_node)
153 		return -ENODEV;
154 
155 	dp83867->io_impedance = -EINVAL;
156 
157 	/* Optional configuration */
158 	ret = of_property_read_u32(of_node, "ti,clk-output-sel",
159 				   &dp83867->clk_output_sel);
160 	if (ret || dp83867->clk_output_sel > DP83867_CLK_O_SEL_REF_CLK)
161 		/* Keep the default value if ti,clk-output-sel is not set
162 		 * or too high
163 		 */
164 		dp83867->clk_output_sel = DP83867_CLK_O_SEL_REF_CLK;
165 
166 	if (of_property_read_bool(of_node, "ti,max-output-impedance"))
167 		dp83867->io_impedance = DP83867_IO_MUX_CFG_IO_IMPEDANCE_MAX;
168 	else if (of_property_read_bool(of_node, "ti,min-output-impedance"))
169 		dp83867->io_impedance = DP83867_IO_MUX_CFG_IO_IMPEDANCE_MIN;
170 
171 	dp83867->rxctrl_strap_quirk = of_property_read_bool(of_node,
172 					"ti,dp83867-rxctrl-strap-quirk");
173 
174 	ret = of_property_read_u32(of_node, "ti,rx-internal-delay",
175 				   &dp83867->rx_id_delay);
176 	if (ret &&
177 	    (phydev->interface == PHY_INTERFACE_MODE_RGMII_ID ||
178 	     phydev->interface == PHY_INTERFACE_MODE_RGMII_RXID))
179 		return ret;
180 
181 	ret = of_property_read_u32(of_node, "ti,tx-internal-delay",
182 				   &dp83867->tx_id_delay);
183 	if (ret &&
184 	    (phydev->interface == PHY_INTERFACE_MODE_RGMII_ID ||
185 	     phydev->interface == PHY_INTERFACE_MODE_RGMII_TXID))
186 		return ret;
187 
188 	if (of_property_read_bool(of_node, "enet-phy-lane-swap"))
189 		dp83867->port_mirroring = DP83867_PORT_MIRROING_EN;
190 
191 	if (of_property_read_bool(of_node, "enet-phy-lane-no-swap"))
192 		dp83867->port_mirroring = DP83867_PORT_MIRROING_DIS;
193 
194 	return of_property_read_u32(of_node, "ti,fifo-depth",
195 				   &dp83867->fifo_depth);
196 }
197 #else
198 static int dp83867_of_init(struct phy_device *phydev)
199 {
200 	return 0;
201 }
202 #endif /* CONFIG_OF_MDIO */
203 
204 static int dp83867_config_init(struct phy_device *phydev)
205 {
206 	struct dp83867_private *dp83867;
207 	int ret, val, bs;
208 	u16 delay;
209 
210 	if (!phydev->priv) {
211 		dp83867 = devm_kzalloc(&phydev->mdio.dev, sizeof(*dp83867),
212 				       GFP_KERNEL);
213 		if (!dp83867)
214 			return -ENOMEM;
215 
216 		phydev->priv = dp83867;
217 		ret = dp83867_of_init(phydev);
218 		if (ret)
219 			return ret;
220 	} else {
221 		dp83867 = (struct dp83867_private *)phydev->priv;
222 	}
223 
224 	/* RX_DV/RX_CTRL strapped in mode 1 or mode 2 workaround */
225 	if (dp83867->rxctrl_strap_quirk) {
226 		val = phy_read_mmd(phydev, DP83867_DEVADDR, DP83867_CFG4);
227 		val &= ~BIT(7);
228 		phy_write_mmd(phydev, DP83867_DEVADDR, DP83867_CFG4, val);
229 	}
230 
231 	if (phy_interface_is_rgmii(phydev)) {
232 		val = phy_read(phydev, MII_DP83867_PHYCTRL);
233 		if (val < 0)
234 			return val;
235 		val &= ~DP83867_PHYCR_FIFO_DEPTH_MASK;
236 		val |= (dp83867->fifo_depth << DP83867_PHYCR_FIFO_DEPTH_SHIFT);
237 
238 		/* The code below checks if "port mirroring" N/A MODE4 has been
239 		 * enabled during power on bootstrap.
240 		 *
241 		 * Such N/A mode enabled by mistake can put PHY IC in some
242 		 * internal testing mode and disable RGMII transmission.
243 		 *
244 		 * In this particular case one needs to check STRAP_STS1
245 		 * register's bit 11 (marked as RESERVED).
246 		 */
247 
248 		bs = phy_read_mmd(phydev, DP83867_DEVADDR, DP83867_STRAP_STS1);
249 		if (bs & DP83867_STRAP_STS1_RESERVED)
250 			val &= ~DP83867_PHYCR_RESERVED_MASK;
251 
252 		ret = phy_write(phydev, MII_DP83867_PHYCTRL, val);
253 		if (ret)
254 			return ret;
255 	}
256 
257 	if ((phydev->interface >= PHY_INTERFACE_MODE_RGMII_ID) &&
258 	    (phydev->interface <= PHY_INTERFACE_MODE_RGMII_RXID)) {
259 		val = phy_read_mmd(phydev, DP83867_DEVADDR, DP83867_RGMIICTL);
260 
261 		if (phydev->interface == PHY_INTERFACE_MODE_RGMII_ID)
262 			val |= (DP83867_RGMII_TX_CLK_DELAY_EN | DP83867_RGMII_RX_CLK_DELAY_EN);
263 
264 		if (phydev->interface == PHY_INTERFACE_MODE_RGMII_TXID)
265 			val |= DP83867_RGMII_TX_CLK_DELAY_EN;
266 
267 		if (phydev->interface == PHY_INTERFACE_MODE_RGMII_RXID)
268 			val |= DP83867_RGMII_RX_CLK_DELAY_EN;
269 
270 		phy_write_mmd(phydev, DP83867_DEVADDR, DP83867_RGMIICTL, val);
271 
272 		delay = (dp83867->rx_id_delay |
273 			(dp83867->tx_id_delay << DP83867_RGMII_TX_CLK_DELAY_SHIFT));
274 
275 		phy_write_mmd(phydev, DP83867_DEVADDR, DP83867_RGMIIDCTL,
276 			      delay);
277 
278 		if (dp83867->io_impedance >= 0) {
279 			val = phy_read_mmd(phydev, DP83867_DEVADDR,
280 					   DP83867_IO_MUX_CFG);
281 
282 			val &= ~DP83867_IO_MUX_CFG_IO_IMPEDANCE_CTRL;
283 			val |= dp83867->io_impedance &
284 			       DP83867_IO_MUX_CFG_IO_IMPEDANCE_CTRL;
285 
286 			phy_write_mmd(phydev, DP83867_DEVADDR,
287 				      DP83867_IO_MUX_CFG, val);
288 		}
289 	}
290 
291 	/* Enable Interrupt output INT_OE in CFG3 register */
292 	if (phy_interrupt_is_valid(phydev)) {
293 		val = phy_read(phydev, DP83867_CFG3);
294 		val |= BIT(7);
295 		phy_write(phydev, DP83867_CFG3, val);
296 	}
297 
298 	if (dp83867->port_mirroring != DP83867_PORT_MIRROING_KEEP)
299 		dp83867_config_port_mirroring(phydev);
300 
301 	/* Clock output selection if muxing property is set */
302 	if (dp83867->clk_output_sel != DP83867_CLK_O_SEL_REF_CLK) {
303 		val = phy_read_mmd(phydev, DP83867_DEVADDR, DP83867_IO_MUX_CFG);
304 		val &= ~DP83867_IO_MUX_CFG_CLK_O_SEL_MASK;
305 		val |= (dp83867->clk_output_sel << DP83867_IO_MUX_CFG_CLK_O_SEL_SHIFT);
306 		phy_write_mmd(phydev, DP83867_DEVADDR, DP83867_IO_MUX_CFG, val);
307 	}
308 
309 	return 0;
310 }
311 
312 static int dp83867_phy_reset(struct phy_device *phydev)
313 {
314 	int err;
315 
316 	err = phy_write(phydev, DP83867_CTRL, DP83867_SW_RESET);
317 	if (err < 0)
318 		return err;
319 
320 	return dp83867_config_init(phydev);
321 }
322 
323 static struct phy_driver dp83867_driver[] = {
324 	{
325 		.phy_id		= DP83867_PHY_ID,
326 		.phy_id_mask	= 0xfffffff0,
327 		.name		= "TI DP83867",
328 		.features	= PHY_GBIT_FEATURES,
329 
330 		.config_init	= dp83867_config_init,
331 		.soft_reset	= dp83867_phy_reset,
332 
333 		/* IRQ related */
334 		.ack_interrupt	= dp83867_ack_interrupt,
335 		.config_intr	= dp83867_config_intr,
336 
337 		.suspend	= genphy_suspend,
338 		.resume		= genphy_resume,
339 	},
340 };
341 module_phy_driver(dp83867_driver);
342 
343 static struct mdio_device_id __maybe_unused dp83867_tbl[] = {
344 	{ DP83867_PHY_ID, 0xfffffff0 },
345 	{ }
346 };
347 
348 MODULE_DEVICE_TABLE(mdio, dp83867_tbl);
349 
350 MODULE_DESCRIPTION("Texas Instruments DP83867 PHY driver");
351 MODULE_AUTHOR("Dan Murphy <dmurphy@ti.com");
352 MODULE_LICENSE("GPL v2");
353