LXR linux/drivers/net/mdio/fwnode

   1// SPDX-License-Identifier: GPL-2.0-only
   2/*
   3 * fwnode helpers for the MDIO (Ethernet PHY) API
   4 *
   5 * This file provides helper functions for extracting PHY device information
   6 * out of the fwnode and using it to populate an mii_bus.
   7 */
   8
   9#include <linux/acpi.h>
  10#include <linux/fwnode_mdio.h>
  11#include <linux/of.h>
  12#include <linux/phy.h>
  13
  14MODULE_AUTHOR("Calvin Johnson <calvin.johnson@oss.nxp.com>");
  15MODULE_LICENSE("GPL");
  16
  17static struct mii_timestamper *
  18fwnode_find_mii_timestamper(struct fwnode_handle *fwnode)
  19{
  20        struct of_phandle_args arg;
  21        int err;
  22
  23        if (is_acpi_node(fwnode))
  24                return NULL;
  25
  26        err = of_parse_phandle_with_fixed_args(to_of_node(fwnode),
  27                                               "timestamper", 1, 0, &arg);
  28        if (err == -ENOENT)
  29                return NULL;
  30        else if (err)
  31                return ERR_PTR(err);
  32
  33        if (arg.args_count != 1)
  34                return ERR_PTR(-EINVAL);
  35
  36        return register_mii_timestamper(arg.np, arg.args[0]);
  37}
  38
  39int fwnode_mdiobus_phy_device_register(struct mii_bus *mdio,
  40                                       struct phy_device *phy,
  41                                       struct fwnode_handle *child, u32 addr)
  42{
  43        int rc;
  44
  45        rc = fwnode_irq_get(child, 0);
  46        if (rc == -EPROBE_DEFER)
  47                return rc;
  48
  49        if (rc > 0) {
  50                phy->irq = rc;
  51                mdio->irq[addr] = rc;
  52        } else {
  53                phy->irq = mdio->irq[addr];
  54        }
  55
  56        if (fwnode_property_read_bool(child, "broken-turn-around"))
  57                mdio->phy_ignore_ta_mask |= 1 << addr;
  58
  59        fwnode_property_read_u32(child, "reset-assert-us",
  60                                 &phy->mdio.reset_assert_delay);
  61        fwnode_property_read_u32(child, "reset-deassert-us",
  62                                 &phy->mdio.reset_deassert_delay);
  63
  64        /* Associate the fwnode with the device structure so it
  65         * can be looked up later
  66         */
  67        fwnode_handle_get(child);
  68        device_set_node(&phy->mdio.dev, child);
  69
  70        /* All data is now stored in the phy struct;
  71         * register it
  72         */
  73        rc = phy_device_register(phy);
  74        if (rc) {
  75                fwnode_handle_put(child);
  76                return rc;
  77        }
  78
  79        dev_dbg(&mdio->dev, "registered phy %p fwnode at address %i\n",
  80                child, addr);
  81        return 0;
  82}
  83EXPORT_SYMBOL(fwnode_mdiobus_phy_device_register);
  84
  85int fwnode_mdiobus_register_phy(struct mii_bus *bus,
  86                                struct fwnode_handle *child, u32 addr)
  87{
  88        struct mii_timestamper *mii_ts = NULL;
  89        struct phy_device *phy;
  90        bool is_c45 = false;
  91        u32 phy_id;
  92        int rc;
  93
  94        mii_ts = fwnode_find_mii_timestamper(child);
  95        if (IS_ERR(mii_ts))
  96                return PTR_ERR(mii_ts);
  97
  98        rc = fwnode_property_match_string(child, "compatible",
  99                                          "ethernet-phy-ieee802.3-c45");
 100        if (rc >= 0)
 101                is_c45 = true;
 102
 103        if (is_c45 || fwnode_get_phy_id(child, &phy_id))
 104                phy = get_phy_device(bus, addr, is_c45);
 105        else
 106                phy = phy_device_create(bus, addr, phy_id, 0, NULL);
 107        if (IS_ERR(phy)) {
 108                unregister_mii_timestamper(mii_ts);
 109                return PTR_ERR(phy);
 110        }
 111
 112        if (is_acpi_node(child)) {
 113                phy->irq = bus->irq[addr];
 114
 115                /* Associate the fwnode with the device structure so it
 116                 * can be looked up later.
 117                 */
 118                phy->mdio.dev.fwnode = child;
 119
 120                /* All data is now stored in the phy struct, so register it */
 121                rc = phy_device_register(phy);
 122                if (rc) {
 123                        phy_device_free(phy);
 124                        fwnode_handle_put(phy->mdio.dev.fwnode);
 125                        return rc;
 126                }
 127        } else if (is_of_node(child)) {
 128                rc = fwnode_mdiobus_phy_device_register(bus, phy, child, addr);
 129                if (rc) {
 130                        unregister_mii_timestamper(mii_ts);
 131                        phy_device_free(phy);
 132                        return rc;
 133                }
 134        }
 135
 136        /* phy->mii_ts may already be defined by the PHY driver. A
 137         * mii_timestamper probed via the device tree will still have
 138         * precedence.
 139         */
 140        if (mii_ts)
 141                phy->mii_ts = mii_ts;
 142        return 0;
 143}
 144EXPORT_SYMBOL(fwnode_mdiobus_register_phy);
 145