1 /* 2 * DaVinci MDIO Module driver 3 * 4 * Copyright (C) 2010 Texas Instruments. 5 * 6 * Shamelessly ripped out of davinci_emac.c, original copyrights follow: 7 * 8 * Copyright (C) 2009 Texas Instruments. 9 * 10 * --------------------------------------------------------------------------- 11 * 12 * This program is free software; you can redistribute it and/or modify 13 * it under the terms of the GNU General Public License as published by 14 * the Free Software Foundation; either version 2 of the License, or 15 * (at your option) any later version. 16 * 17 * This program is distributed in the hope that it will be useful, 18 * but WITHOUT ANY WARRANTY; without even the implied warranty of 19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 20 * GNU General Public License for more details. 21 * 22 * You should have received a copy of the GNU General Public License 23 * along with this program; if not, write to the Free Software 24 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. 25 * --------------------------------------------------------------------------- 26 */ 27 #include <linux/module.h> 28 #include <linux/kernel.h> 29 #include <linux/platform_device.h> 30 #include <linux/delay.h> 31 #include <linux/sched.h> 32 #include <linux/slab.h> 33 #include <linux/phy.h> 34 #include <linux/clk.h> 35 #include <linux/err.h> 36 #include <linux/io.h> 37 #include <linux/iopoll.h> 38 #include <linux/pm_runtime.h> 39 #include <linux/davinci_emac.h> 40 #include <linux/of.h> 41 #include <linux/of_device.h> 42 #include <linux/of_mdio.h> 43 #include <linux/pinctrl/consumer.h> 44 45 /* 46 * This timeout definition is a worst-case ultra defensive measure against 47 * unexpected controller lock ups. Ideally, we should never ever hit this 48 * scenario in practice. 49 */ 50 #define MDIO_TIMEOUT 100 /* msecs */ 51 52 #define PHY_REG_MASK 0x1f 53 #define PHY_ID_MASK 0x1f 54 55 #define DEF_OUT_FREQ 2200000 /* 2.2 MHz */ 56 57 struct davinci_mdio_of_param { 58 int autosuspend_delay_ms; 59 }; 60 61 struct davinci_mdio_regs { 62 u32 version; 63 u32 control; 64 #define CONTROL_IDLE BIT(31) 65 #define CONTROL_ENABLE BIT(30) 66 #define CONTROL_MAX_DIV (0xffff) 67 68 u32 alive; 69 u32 link; 70 u32 linkintraw; 71 u32 linkintmasked; 72 u32 __reserved_0[2]; 73 u32 userintraw; 74 u32 userintmasked; 75 u32 userintmaskset; 76 u32 userintmaskclr; 77 u32 __reserved_1[20]; 78 79 struct { 80 u32 access; 81 #define USERACCESS_GO BIT(31) 82 #define USERACCESS_WRITE BIT(30) 83 #define USERACCESS_ACK BIT(29) 84 #define USERACCESS_READ (0) 85 #define USERACCESS_DATA (0xffff) 86 87 u32 physel; 88 } user[0]; 89 }; 90 91 static const struct mdio_platform_data default_pdata = { 92 .bus_freq = DEF_OUT_FREQ, 93 }; 94 95 struct davinci_mdio_data { 96 struct mdio_platform_data pdata; 97 struct davinci_mdio_regs __iomem *regs; 98 struct clk *clk; 99 struct device *dev; 100 struct mii_bus *bus; 101 bool active_in_suspend; 102 unsigned long access_time; /* jiffies */ 103 /* Indicates that driver shouldn't modify phy_mask in case 104 * if MDIO bus is registered from DT. 105 */ 106 bool skip_scan; 107 u32 clk_div; 108 }; 109 110 static void davinci_mdio_init_clk(struct davinci_mdio_data *data) 111 { 112 u32 mdio_in, div, mdio_out_khz, access_time; 113 114 mdio_in = clk_get_rate(data->clk); 115 div = (mdio_in / data->pdata.bus_freq) - 1; 116 if (div > CONTROL_MAX_DIV) 117 div = CONTROL_MAX_DIV; 118 119 data->clk_div = div; 120 /* 121 * One mdio transaction consists of: 122 * 32 bits of preamble 123 * 32 bits of transferred data 124 * 24 bits of bus yield (not needed unless shared?) 125 */ 126 mdio_out_khz = mdio_in / (1000 * (div + 1)); 127 access_time = (88 * 1000) / mdio_out_khz; 128 129 /* 130 * In the worst case, we could be kicking off a user-access immediately 131 * after the mdio bus scan state-machine triggered its own read. If 132 * so, our request could get deferred by one access cycle. We 133 * defensively allow for 4 access cycles. 134 */ 135 data->access_time = usecs_to_jiffies(access_time * 4); 136 if (!data->access_time) 137 data->access_time = 1; 138 } 139 140 static void davinci_mdio_enable(struct davinci_mdio_data *data) 141 { 142 /* set enable and clock divider */ 143 __raw_writel(data->clk_div | CONTROL_ENABLE, &data->regs->control); 144 } 145 146 static int davinci_mdio_reset(struct mii_bus *bus) 147 { 148 struct davinci_mdio_data *data = bus->priv; 149 u32 phy_mask, ver; 150 int ret; 151 152 ret = pm_runtime_get_sync(data->dev); 153 if (ret < 0) { 154 pm_runtime_put_noidle(data->dev); 155 return ret; 156 } 157 158 /* wait for scan logic to settle */ 159 msleep(PHY_MAX_ADDR * data->access_time); 160 161 /* dump hardware version info */ 162 ver = __raw_readl(&data->regs->version); 163 dev_info(data->dev, 164 "davinci mdio revision %d.%d, bus freq %ld\n", 165 (ver >> 8) & 0xff, ver & 0xff, 166 data->pdata.bus_freq); 167 168 if (data->skip_scan) 169 goto done; 170 171 /* get phy mask from the alive register */ 172 phy_mask = __raw_readl(&data->regs->alive); 173 if (phy_mask) { 174 /* restrict mdio bus to live phys only */ 175 dev_info(data->dev, "detected phy mask %x\n", ~phy_mask); 176 phy_mask = ~phy_mask; 177 } else { 178 /* desperately scan all phys */ 179 dev_warn(data->dev, "no live phy, scanning all\n"); 180 phy_mask = 0; 181 } 182 data->bus->phy_mask = phy_mask; 183 184 done: 185 pm_runtime_mark_last_busy(data->dev); 186 pm_runtime_put_autosuspend(data->dev); 187 188 return 0; 189 } 190 191 /* wait until hardware is ready for another user access */ 192 static inline int wait_for_user_access(struct davinci_mdio_data *data) 193 { 194 struct davinci_mdio_regs __iomem *regs = data->regs; 195 unsigned long timeout = jiffies + msecs_to_jiffies(MDIO_TIMEOUT); 196 u32 reg; 197 198 while (time_after(timeout, jiffies)) { 199 reg = __raw_readl(®s->user[0].access); 200 if ((reg & USERACCESS_GO) == 0) 201 return 0; 202 203 reg = __raw_readl(®s->control); 204 if ((reg & CONTROL_IDLE) == 0) { 205 usleep_range(100, 200); 206 continue; 207 } 208 209 /* 210 * An emac soft_reset may have clobbered the mdio controller's 211 * state machine. We need to reset and retry the current 212 * operation 213 */ 214 dev_warn(data->dev, "resetting idled controller\n"); 215 davinci_mdio_enable(data); 216 return -EAGAIN; 217 } 218 219 reg = __raw_readl(®s->user[0].access); 220 if ((reg & USERACCESS_GO) == 0) 221 return 0; 222 223 dev_err(data->dev, "timed out waiting for user access\n"); 224 return -ETIMEDOUT; 225 } 226 227 /* wait until hardware state machine is idle */ 228 static inline int wait_for_idle(struct davinci_mdio_data *data) 229 { 230 struct davinci_mdio_regs __iomem *regs = data->regs; 231 u32 val, ret; 232 233 ret = readl_poll_timeout(®s->control, val, val & CONTROL_IDLE, 234 0, MDIO_TIMEOUT * 1000); 235 if (ret) 236 dev_err(data->dev, "timed out waiting for idle\n"); 237 238 return ret; 239 } 240 241 static int davinci_mdio_read(struct mii_bus *bus, int phy_id, int phy_reg) 242 { 243 struct davinci_mdio_data *data = bus->priv; 244 u32 reg; 245 int ret; 246 247 if (phy_reg & ~PHY_REG_MASK || phy_id & ~PHY_ID_MASK) 248 return -EINVAL; 249 250 ret = pm_runtime_get_sync(data->dev); 251 if (ret < 0) { 252 pm_runtime_put_noidle(data->dev); 253 return ret; 254 } 255 256 reg = (USERACCESS_GO | USERACCESS_READ | (phy_reg << 21) | 257 (phy_id << 16)); 258 259 while (1) { 260 ret = wait_for_user_access(data); 261 if (ret == -EAGAIN) 262 continue; 263 if (ret < 0) 264 break; 265 266 __raw_writel(reg, &data->regs->user[0].access); 267 268 ret = wait_for_user_access(data); 269 if (ret == -EAGAIN) 270 continue; 271 if (ret < 0) 272 break; 273 274 reg = __raw_readl(&data->regs->user[0].access); 275 ret = (reg & USERACCESS_ACK) ? (reg & USERACCESS_DATA) : -EIO; 276 break; 277 } 278 279 pm_runtime_mark_last_busy(data->dev); 280 pm_runtime_put_autosuspend(data->dev); 281 return ret; 282 } 283 284 static int davinci_mdio_write(struct mii_bus *bus, int phy_id, 285 int phy_reg, u16 phy_data) 286 { 287 struct davinci_mdio_data *data = bus->priv; 288 u32 reg; 289 int ret; 290 291 if (phy_reg & ~PHY_REG_MASK || phy_id & ~PHY_ID_MASK) 292 return -EINVAL; 293 294 ret = pm_runtime_get_sync(data->dev); 295 if (ret < 0) { 296 pm_runtime_put_noidle(data->dev); 297 return ret; 298 } 299 300 reg = (USERACCESS_GO | USERACCESS_WRITE | (phy_reg << 21) | 301 (phy_id << 16) | (phy_data & USERACCESS_DATA)); 302 303 while (1) { 304 ret = wait_for_user_access(data); 305 if (ret == -EAGAIN) 306 continue; 307 if (ret < 0) 308 break; 309 310 __raw_writel(reg, &data->regs->user[0].access); 311 312 ret = wait_for_user_access(data); 313 if (ret == -EAGAIN) 314 continue; 315 break; 316 } 317 318 pm_runtime_mark_last_busy(data->dev); 319 pm_runtime_put_autosuspend(data->dev); 320 321 return ret; 322 } 323 324 #if IS_ENABLED(CONFIG_OF) 325 static int davinci_mdio_probe_dt(struct mdio_platform_data *data, 326 struct platform_device *pdev) 327 { 328 struct device_node *node = pdev->dev.of_node; 329 u32 prop; 330 331 if (!node) 332 return -EINVAL; 333 334 if (of_property_read_u32(node, "bus_freq", &prop)) { 335 dev_err(&pdev->dev, "Missing bus_freq property in the DT.\n"); 336 return -EINVAL; 337 } 338 data->bus_freq = prop; 339 340 return 0; 341 } 342 #endif 343 344 #if IS_ENABLED(CONFIG_OF) 345 static const struct davinci_mdio_of_param of_cpsw_mdio_data = { 346 .autosuspend_delay_ms = 100, 347 }; 348 349 static const struct of_device_id davinci_mdio_of_mtable[] = { 350 { .compatible = "ti,davinci_mdio", }, 351 { .compatible = "ti,cpsw-mdio", .data = &of_cpsw_mdio_data}, 352 { /* sentinel */ }, 353 }; 354 MODULE_DEVICE_TABLE(of, davinci_mdio_of_mtable); 355 #endif 356 357 static int davinci_mdio_probe(struct platform_device *pdev) 358 { 359 struct mdio_platform_data *pdata = dev_get_platdata(&pdev->dev); 360 struct device *dev = &pdev->dev; 361 struct davinci_mdio_data *data; 362 struct resource *res; 363 struct phy_device *phy; 364 int ret, addr; 365 int autosuspend_delay_ms = -1; 366 367 data = devm_kzalloc(dev, sizeof(*data), GFP_KERNEL); 368 if (!data) 369 return -ENOMEM; 370 371 data->bus = devm_mdiobus_alloc(dev); 372 if (!data->bus) { 373 dev_err(dev, "failed to alloc mii bus\n"); 374 return -ENOMEM; 375 } 376 377 if (dev->of_node) { 378 const struct of_device_id *of_id; 379 380 ret = davinci_mdio_probe_dt(&data->pdata, pdev); 381 if (ret) 382 return ret; 383 snprintf(data->bus->id, MII_BUS_ID_SIZE, "%s", pdev->name); 384 385 of_id = of_match_device(davinci_mdio_of_mtable, &pdev->dev); 386 if (of_id) { 387 const struct davinci_mdio_of_param *of_mdio_data; 388 389 of_mdio_data = of_id->data; 390 if (of_mdio_data) 391 autosuspend_delay_ms = 392 of_mdio_data->autosuspend_delay_ms; 393 } 394 } else { 395 data->pdata = pdata ? (*pdata) : default_pdata; 396 snprintf(data->bus->id, MII_BUS_ID_SIZE, "%s-%x", 397 pdev->name, pdev->id); 398 } 399 400 data->bus->name = dev_name(dev); 401 data->bus->read = davinci_mdio_read, 402 data->bus->write = davinci_mdio_write, 403 data->bus->reset = davinci_mdio_reset, 404 data->bus->parent = dev; 405 data->bus->priv = data; 406 407 data->clk = devm_clk_get(dev, "fck"); 408 if (IS_ERR(data->clk)) { 409 dev_err(dev, "failed to get device clock\n"); 410 return PTR_ERR(data->clk); 411 } 412 413 dev_set_drvdata(dev, data); 414 data->dev = dev; 415 416 res = platform_get_resource(pdev, IORESOURCE_MEM, 0); 417 data->regs = devm_ioremap_resource(dev, res); 418 if (IS_ERR(data->regs)) 419 return PTR_ERR(data->regs); 420 421 davinci_mdio_init_clk(data); 422 423 pm_runtime_set_autosuspend_delay(&pdev->dev, autosuspend_delay_ms); 424 pm_runtime_use_autosuspend(&pdev->dev); 425 pm_runtime_enable(&pdev->dev); 426 427 /* register the mii bus 428 * Create PHYs from DT only in case if PHY child nodes are explicitly 429 * defined to support backward compatibility with DTs which assume that 430 * Davinci MDIO will always scan the bus for PHYs detection. 431 */ 432 if (dev->of_node && of_get_child_count(dev->of_node)) 433 data->skip_scan = true; 434 435 ret = of_mdiobus_register(data->bus, dev->of_node); 436 if (ret) 437 goto bail_out; 438 439 /* scan and dump the bus */ 440 for (addr = 0; addr < PHY_MAX_ADDR; addr++) { 441 phy = mdiobus_get_phy(data->bus, addr); 442 if (phy) { 443 dev_info(dev, "phy[%d]: device %s, driver %s\n", 444 phy->mdio.addr, phydev_name(phy), 445 phy->drv ? phy->drv->name : "unknown"); 446 } 447 } 448 449 return 0; 450 451 bail_out: 452 pm_runtime_dont_use_autosuspend(&pdev->dev); 453 pm_runtime_disable(&pdev->dev); 454 return ret; 455 } 456 457 static int davinci_mdio_remove(struct platform_device *pdev) 458 { 459 struct davinci_mdio_data *data = platform_get_drvdata(pdev); 460 461 if (data->bus) 462 mdiobus_unregister(data->bus); 463 464 pm_runtime_dont_use_autosuspend(&pdev->dev); 465 pm_runtime_disable(&pdev->dev); 466 467 return 0; 468 } 469 470 #ifdef CONFIG_PM 471 static int davinci_mdio_runtime_suspend(struct device *dev) 472 { 473 struct davinci_mdio_data *data = dev_get_drvdata(dev); 474 u32 ctrl; 475 476 /* shutdown the scan state machine */ 477 ctrl = __raw_readl(&data->regs->control); 478 ctrl &= ~CONTROL_ENABLE; 479 __raw_writel(ctrl, &data->regs->control); 480 wait_for_idle(data); 481 482 return 0; 483 } 484 485 static int davinci_mdio_runtime_resume(struct device *dev) 486 { 487 struct davinci_mdio_data *data = dev_get_drvdata(dev); 488 489 davinci_mdio_enable(data); 490 return 0; 491 } 492 #endif 493 494 #ifdef CONFIG_PM_SLEEP 495 static int davinci_mdio_suspend(struct device *dev) 496 { 497 struct davinci_mdio_data *data = dev_get_drvdata(dev); 498 int ret = 0; 499 500 data->active_in_suspend = !pm_runtime_status_suspended(dev); 501 if (data->active_in_suspend) 502 ret = pm_runtime_force_suspend(dev); 503 if (ret < 0) 504 return ret; 505 506 /* Select sleep pin state */ 507 pinctrl_pm_select_sleep_state(dev); 508 509 return 0; 510 } 511 512 static int davinci_mdio_resume(struct device *dev) 513 { 514 struct davinci_mdio_data *data = dev_get_drvdata(dev); 515 516 /* Select default pin state */ 517 pinctrl_pm_select_default_state(dev); 518 519 if (data->active_in_suspend) 520 pm_runtime_force_resume(dev); 521 522 return 0; 523 } 524 #endif 525 526 static const struct dev_pm_ops davinci_mdio_pm_ops = { 527 SET_RUNTIME_PM_OPS(davinci_mdio_runtime_suspend, 528 davinci_mdio_runtime_resume, NULL) 529 SET_LATE_SYSTEM_SLEEP_PM_OPS(davinci_mdio_suspend, davinci_mdio_resume) 530 }; 531 532 static struct platform_driver davinci_mdio_driver = { 533 .driver = { 534 .name = "davinci_mdio", 535 .pm = &davinci_mdio_pm_ops, 536 .of_match_table = of_match_ptr(davinci_mdio_of_mtable), 537 }, 538 .probe = davinci_mdio_probe, 539 .remove = davinci_mdio_remove, 540 }; 541 542 static int __init davinci_mdio_init(void) 543 { 544 return platform_driver_register(&davinci_mdio_driver); 545 } 546 device_initcall(davinci_mdio_init); 547 548 static void __exit davinci_mdio_exit(void) 549 { 550 platform_driver_unregister(&davinci_mdio_driver); 551 } 552 module_exit(davinci_mdio_exit); 553 554 MODULE_LICENSE("GPL"); 555 MODULE_DESCRIPTION("DaVinci MDIO driver"); 556