linux/drivers/net/ethernet/marvell/mvmdio.c
<<
>>
Prefs
   1/*
   2 * Driver for the MDIO interface of Marvell network interfaces.
   3 *
   4 * Since the MDIO interface of Marvell network interfaces is shared
   5 * between all network interfaces, having a single driver allows to
   6 * handle concurrent accesses properly (you may have four Ethernet
   7 * ports, but they in fact share the same SMI interface to access
   8 * the MDIO bus). This driver is currently used by the mvneta and
   9 * mv643xx_eth drivers.
  10 *
  11 * Copyright (C) 2012 Marvell
  12 *
  13 * Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
  14 *
  15 * This file is licensed under the terms of the GNU General Public
  16 * License version 2. This program is licensed "as is" without any
  17 * warranty of any kind, whether express or implied.
  18 */
  19
  20#include <linux/clk.h>
  21#include <linux/delay.h>
  22#include <linux/interrupt.h>
  23#include <linux/io.h>
  24#include <linux/kernel.h>
  25#include <linux/module.h>
  26#include <linux/of_device.h>
  27#include <linux/of_mdio.h>
  28#include <linux/phy.h>
  29#include <linux/platform_device.h>
  30#include <linux/sched.h>
  31#include <linux/wait.h>
  32
  33#define MVMDIO_SMI_DATA_SHIFT           0
  34#define MVMDIO_SMI_PHY_ADDR_SHIFT       16
  35#define MVMDIO_SMI_PHY_REG_SHIFT        21
  36#define MVMDIO_SMI_READ_OPERATION       BIT(26)
  37#define MVMDIO_SMI_WRITE_OPERATION      0
  38#define MVMDIO_SMI_READ_VALID           BIT(27)
  39#define MVMDIO_SMI_BUSY                 BIT(28)
  40#define MVMDIO_ERR_INT_CAUSE            0x007C
  41#define  MVMDIO_ERR_INT_SMI_DONE        0x00000010
  42#define MVMDIO_ERR_INT_MASK             0x0080
  43
  44#define MVMDIO_XSMI_MGNT_REG            0x0
  45#define  MVMDIO_XSMI_PHYADDR_SHIFT      16
  46#define  MVMDIO_XSMI_DEVADDR_SHIFT      21
  47#define  MVMDIO_XSMI_WRITE_OPERATION    (0x5 << 26)
  48#define  MVMDIO_XSMI_READ_OPERATION     (0x7 << 26)
  49#define  MVMDIO_XSMI_READ_VALID         BIT(29)
  50#define  MVMDIO_XSMI_BUSY               BIT(30)
  51#define MVMDIO_XSMI_ADDR_REG            0x8
  52
  53/*
  54 * SMI Timeout measurements:
  55 * - Kirkwood 88F6281 (Globalscale Dreamplug): 45us to 95us (Interrupt)
  56 * - Armada 370       (Globalscale Mirabox):   41us to 43us (Polled)
  57 */
  58#define MVMDIO_SMI_TIMEOUT              1000 /* 1000us = 1ms */
  59#define MVMDIO_SMI_POLL_INTERVAL_MIN    45
  60#define MVMDIO_SMI_POLL_INTERVAL_MAX    55
  61
  62#define MVMDIO_XSMI_POLL_INTERVAL_MIN   150
  63#define MVMDIO_XSMI_POLL_INTERVAL_MAX   160
  64
  65struct orion_mdio_dev {
  66        void __iomem *regs;
  67        struct clk *clk[3];
  68        /*
  69         * If we have access to the error interrupt pin (which is
  70         * somewhat misnamed as it not only reflects internal errors
  71         * but also reflects SMI completion), use that to wait for
  72         * SMI access completion instead of polling the SMI busy bit.
  73         */
  74        int err_interrupt;
  75        wait_queue_head_t smi_busy_wait;
  76};
  77
  78enum orion_mdio_bus_type {
  79        BUS_TYPE_SMI,
  80        BUS_TYPE_XSMI
  81};
  82
  83struct orion_mdio_ops {
  84        int (*is_done)(struct orion_mdio_dev *);
  85        unsigned int poll_interval_min;
  86        unsigned int poll_interval_max;
  87};
  88
  89/* Wait for the SMI unit to be ready for another operation
  90 */
  91static int orion_mdio_wait_ready(const struct orion_mdio_ops *ops,
  92                                 struct mii_bus *bus)
  93{
  94        struct orion_mdio_dev *dev = bus->priv;
  95        unsigned long timeout = usecs_to_jiffies(MVMDIO_SMI_TIMEOUT);
  96        unsigned long end = jiffies + timeout;
  97        int timedout = 0;
  98
  99        while (1) {
 100                if (ops->is_done(dev))
 101                        return 0;
 102                else if (timedout)
 103                        break;
 104
 105                if (dev->err_interrupt <= 0) {
 106                        usleep_range(ops->poll_interval_min,
 107                                     ops->poll_interval_max);
 108
 109                        if (time_is_before_jiffies(end))
 110                                ++timedout;
 111                } else {
 112                        /* wait_event_timeout does not guarantee a delay of at
 113                         * least one whole jiffie, so timeout must be no less
 114                         * than two.
 115                         */
 116                        if (timeout < 2)
 117                                timeout = 2;
 118                        wait_event_timeout(dev->smi_busy_wait,
 119                                           ops->is_done(dev), timeout);
 120
 121                        ++timedout;
 122                }
 123        }
 124
 125        dev_err(bus->parent, "Timeout: SMI busy for too long\n");
 126        return  -ETIMEDOUT;
 127}
 128
 129static int orion_mdio_smi_is_done(struct orion_mdio_dev *dev)
 130{
 131        return !(readl(dev->regs) & MVMDIO_SMI_BUSY);
 132}
 133
 134static const struct orion_mdio_ops orion_mdio_smi_ops = {
 135        .is_done = orion_mdio_smi_is_done,
 136        .poll_interval_min = MVMDIO_SMI_POLL_INTERVAL_MIN,
 137        .poll_interval_max = MVMDIO_SMI_POLL_INTERVAL_MAX,
 138};
 139
 140static int orion_mdio_smi_read(struct mii_bus *bus, int mii_id,
 141                               int regnum)
 142{
 143        struct orion_mdio_dev *dev = bus->priv;
 144        u32 val;
 145        int ret;
 146
 147        if (regnum & MII_ADDR_C45)
 148                return -EOPNOTSUPP;
 149
 150        ret = orion_mdio_wait_ready(&orion_mdio_smi_ops, bus);
 151        if (ret < 0)
 152                return ret;
 153
 154        writel(((mii_id << MVMDIO_SMI_PHY_ADDR_SHIFT) |
 155                (regnum << MVMDIO_SMI_PHY_REG_SHIFT)  |
 156                MVMDIO_SMI_READ_OPERATION),
 157               dev->regs);
 158
 159        ret = orion_mdio_wait_ready(&orion_mdio_smi_ops, bus);
 160        if (ret < 0)
 161                return ret;
 162
 163        val = readl(dev->regs);
 164        if (!(val & MVMDIO_SMI_READ_VALID)) {
 165                dev_err(bus->parent, "SMI bus read not valid\n");
 166                return -ENODEV;
 167        }
 168
 169        return val & GENMASK(15, 0);
 170}
 171
 172static int orion_mdio_smi_write(struct mii_bus *bus, int mii_id,
 173                                int regnum, u16 value)
 174{
 175        struct orion_mdio_dev *dev = bus->priv;
 176        int ret;
 177
 178        if (regnum & MII_ADDR_C45)
 179                return -EOPNOTSUPP;
 180
 181        ret = orion_mdio_wait_ready(&orion_mdio_smi_ops, bus);
 182        if (ret < 0)
 183                return ret;
 184
 185        writel(((mii_id << MVMDIO_SMI_PHY_ADDR_SHIFT) |
 186                (regnum << MVMDIO_SMI_PHY_REG_SHIFT)  |
 187                MVMDIO_SMI_WRITE_OPERATION            |
 188                (value << MVMDIO_SMI_DATA_SHIFT)),
 189               dev->regs);
 190
 191        return 0;
 192}
 193
 194static int orion_mdio_xsmi_is_done(struct orion_mdio_dev *dev)
 195{
 196        return !(readl(dev->regs + MVMDIO_XSMI_MGNT_REG) & MVMDIO_XSMI_BUSY);
 197}
 198
 199static const struct orion_mdio_ops orion_mdio_xsmi_ops = {
 200        .is_done = orion_mdio_xsmi_is_done,
 201        .poll_interval_min = MVMDIO_XSMI_POLL_INTERVAL_MIN,
 202        .poll_interval_max = MVMDIO_XSMI_POLL_INTERVAL_MAX,
 203};
 204
 205static int orion_mdio_xsmi_read(struct mii_bus *bus, int mii_id,
 206                                int regnum)
 207{
 208        struct orion_mdio_dev *dev = bus->priv;
 209        u16 dev_addr = (regnum >> 16) & GENMASK(4, 0);
 210        int ret;
 211
 212        if (!(regnum & MII_ADDR_C45))
 213                return -EOPNOTSUPP;
 214
 215        ret = orion_mdio_wait_ready(&orion_mdio_xsmi_ops, bus);
 216        if (ret < 0)
 217                return ret;
 218
 219        writel(regnum & GENMASK(15, 0), dev->regs + MVMDIO_XSMI_ADDR_REG);
 220        writel((mii_id << MVMDIO_XSMI_PHYADDR_SHIFT) |
 221               (dev_addr << MVMDIO_XSMI_DEVADDR_SHIFT) |
 222               MVMDIO_XSMI_READ_OPERATION,
 223               dev->regs + MVMDIO_XSMI_MGNT_REG);
 224
 225        ret = orion_mdio_wait_ready(&orion_mdio_xsmi_ops, bus);
 226        if (ret < 0)
 227                return ret;
 228
 229        if (!(readl(dev->regs + MVMDIO_XSMI_MGNT_REG) &
 230              MVMDIO_XSMI_READ_VALID)) {
 231                dev_err(bus->parent, "XSMI bus read not valid\n");
 232                return -ENODEV;
 233        }
 234
 235        return readl(dev->regs + MVMDIO_XSMI_MGNT_REG) & GENMASK(15, 0);
 236}
 237
 238static int orion_mdio_xsmi_write(struct mii_bus *bus, int mii_id,
 239                                int regnum, u16 value)
 240{
 241        struct orion_mdio_dev *dev = bus->priv;
 242        u16 dev_addr = (regnum >> 16) & GENMASK(4, 0);
 243        int ret;
 244
 245        if (!(regnum & MII_ADDR_C45))
 246                return -EOPNOTSUPP;
 247
 248        ret = orion_mdio_wait_ready(&orion_mdio_xsmi_ops, bus);
 249        if (ret < 0)
 250                return ret;
 251
 252        writel(regnum & GENMASK(15, 0), dev->regs + MVMDIO_XSMI_ADDR_REG);
 253        writel((mii_id << MVMDIO_XSMI_PHYADDR_SHIFT) |
 254               (dev_addr << MVMDIO_XSMI_DEVADDR_SHIFT) |
 255               MVMDIO_XSMI_WRITE_OPERATION | value,
 256               dev->regs + MVMDIO_XSMI_MGNT_REG);
 257
 258        return 0;
 259}
 260
 261static irqreturn_t orion_mdio_err_irq(int irq, void *dev_id)
 262{
 263        struct orion_mdio_dev *dev = dev_id;
 264
 265        if (readl(dev->regs + MVMDIO_ERR_INT_CAUSE) &
 266                        MVMDIO_ERR_INT_SMI_DONE) {
 267                writel(~MVMDIO_ERR_INT_SMI_DONE,
 268                                dev->regs + MVMDIO_ERR_INT_CAUSE);
 269                wake_up(&dev->smi_busy_wait);
 270                return IRQ_HANDLED;
 271        }
 272
 273        return IRQ_NONE;
 274}
 275
 276static int orion_mdio_probe(struct platform_device *pdev)
 277{
 278        enum orion_mdio_bus_type type;
 279        struct resource *r;
 280        struct mii_bus *bus;
 281        struct orion_mdio_dev *dev;
 282        int i, ret;
 283
 284        type = (enum orion_mdio_bus_type)of_device_get_match_data(&pdev->dev);
 285
 286        r = platform_get_resource(pdev, IORESOURCE_MEM, 0);
 287        if (!r) {
 288                dev_err(&pdev->dev, "No SMI register address given\n");
 289                return -ENODEV;
 290        }
 291
 292        bus = devm_mdiobus_alloc_size(&pdev->dev,
 293                                      sizeof(struct orion_mdio_dev));
 294        if (!bus)
 295                return -ENOMEM;
 296
 297        switch (type) {
 298        case BUS_TYPE_SMI:
 299                bus->read = orion_mdio_smi_read;
 300                bus->write = orion_mdio_smi_write;
 301                break;
 302        case BUS_TYPE_XSMI:
 303                bus->read = orion_mdio_xsmi_read;
 304                bus->write = orion_mdio_xsmi_write;
 305                break;
 306        }
 307
 308        bus->name = "orion_mdio_bus";
 309        snprintf(bus->id, MII_BUS_ID_SIZE, "%s-mii",
 310                 dev_name(&pdev->dev));
 311        bus->parent = &pdev->dev;
 312
 313        dev = bus->priv;
 314        dev->regs = devm_ioremap(&pdev->dev, r->start, resource_size(r));
 315        if (!dev->regs) {
 316                dev_err(&pdev->dev, "Unable to remap SMI register\n");
 317                return -ENODEV;
 318        }
 319
 320        init_waitqueue_head(&dev->smi_busy_wait);
 321
 322        for (i = 0; i < ARRAY_SIZE(dev->clk); i++) {
 323                dev->clk[i] = of_clk_get(pdev->dev.of_node, i);
 324                if (IS_ERR(dev->clk[i]))
 325                        break;
 326                clk_prepare_enable(dev->clk[i]);
 327        }
 328
 329        dev->err_interrupt = platform_get_irq(pdev, 0);
 330        if (dev->err_interrupt > 0 &&
 331            resource_size(r) < MVMDIO_ERR_INT_MASK + 4) {
 332                dev_err(&pdev->dev,
 333                        "disabling interrupt, resource size is too small\n");
 334                dev->err_interrupt = 0;
 335        }
 336        if (dev->err_interrupt > 0) {
 337                ret = devm_request_irq(&pdev->dev, dev->err_interrupt,
 338                                        orion_mdio_err_irq,
 339                                        IRQF_SHARED, pdev->name, dev);
 340                if (ret)
 341                        goto out_mdio;
 342
 343                writel(MVMDIO_ERR_INT_SMI_DONE,
 344                        dev->regs + MVMDIO_ERR_INT_MASK);
 345
 346        } else if (dev->err_interrupt == -EPROBE_DEFER) {
 347                ret = -EPROBE_DEFER;
 348                goto out_mdio;
 349        }
 350
 351        if (pdev->dev.of_node)
 352                ret = of_mdiobus_register(bus, pdev->dev.of_node);
 353        else
 354                ret = mdiobus_register(bus);
 355        if (ret < 0) {
 356                dev_err(&pdev->dev, "Cannot register MDIO bus (%d)\n", ret);
 357                goto out_mdio;
 358        }
 359
 360        platform_set_drvdata(pdev, bus);
 361
 362        return 0;
 363
 364out_mdio:
 365        if (dev->err_interrupt > 0)
 366                writel(0, dev->regs + MVMDIO_ERR_INT_MASK);
 367
 368        for (i = 0; i < ARRAY_SIZE(dev->clk); i++) {
 369                if (IS_ERR(dev->clk[i]))
 370                        break;
 371                clk_disable_unprepare(dev->clk[i]);
 372                clk_put(dev->clk[i]);
 373        }
 374
 375        return ret;
 376}
 377
 378static int orion_mdio_remove(struct platform_device *pdev)
 379{
 380        struct mii_bus *bus = platform_get_drvdata(pdev);
 381        struct orion_mdio_dev *dev = bus->priv;
 382        int i;
 383
 384        if (dev->err_interrupt > 0)
 385                writel(0, dev->regs + MVMDIO_ERR_INT_MASK);
 386        mdiobus_unregister(bus);
 387
 388        for (i = 0; i < ARRAY_SIZE(dev->clk); i++) {
 389                if (IS_ERR(dev->clk[i]))
 390                        break;
 391                clk_disable_unprepare(dev->clk[i]);
 392                clk_put(dev->clk[i]);
 393        }
 394
 395        return 0;
 396}
 397
 398static const struct of_device_id orion_mdio_match[] = {
 399        { .compatible = "marvell,orion-mdio", .data = (void *)BUS_TYPE_SMI },
 400        { .compatible = "marvell,xmdio", .data = (void *)BUS_TYPE_XSMI },
 401        { }
 402};
 403MODULE_DEVICE_TABLE(of, orion_mdio_match);
 404
 405static struct platform_driver orion_mdio_driver = {
 406        .probe = orion_mdio_probe,
 407        .remove = orion_mdio_remove,
 408        .driver = {
 409                .name = "orion-mdio",
 410                .of_match_table = orion_mdio_match,
 411        },
 412};
 413
 414module_platform_driver(orion_mdio_driver);
 415
 416MODULE_DESCRIPTION("Marvell MDIO interface driver");
 417MODULE_AUTHOR("Thomas Petazzoni <thomas.petazzoni@free-electrons.com>");
 418MODULE_LICENSE("GPL");
 419MODULE_ALIAS("platform:orion-mdio");
 420