LXR linux/include/linux/of

   1/* SPDX-License-Identifier: GPL-2.0-only */
   2/*
   3 * OF helpers for the MDIO (Ethernet PHY) API
   4 *
   5 * Copyright (c) 2009 Secret Lab Technologies, Ltd.
   6 */
   7
   8#ifndef __LINUX_OF_MDIO_H
   9#define __LINUX_OF_MDIO_H
  10
  11#include <linux/phy.h>
  12#include <linux/of.h>
  13
  14#if IS_ENABLED(CONFIG_OF_MDIO)
  15extern bool of_mdiobus_child_is_phy(struct device_node *child);
  16extern int of_mdiobus_register(struct mii_bus *mdio, struct device_node *np);
  17extern struct phy_device *of_phy_find_device(struct device_node *phy_np);
  18extern struct phy_device *of_phy_connect(struct net_device *dev,
  19                                         struct device_node *phy_np,
  20                                         void (*hndlr)(struct net_device *),
  21                                         u32 flags, phy_interface_t iface);
  22extern struct phy_device *
  23of_phy_get_and_connect(struct net_device *dev, struct device_node *np,
  24                       void (*hndlr)(struct net_device *));
  25struct phy_device *of_phy_attach(struct net_device *dev,
  26                                 struct device_node *phy_np, u32 flags,
  27                                 phy_interface_t iface);
  28
  29extern struct mii_bus *of_mdio_find_bus(struct device_node *mdio_np);
  30extern int of_phy_register_fixed_link(struct device_node *np);
  31extern void of_phy_deregister_fixed_link(struct device_node *np);
  32extern bool of_phy_is_fixed_link(struct device_node *np);
  33
  34
  35static inline int of_mdio_parse_addr(struct device *dev,
  36                                     const struct device_node *np)
  37{
  38        u32 addr;
  39        int ret;
  40
  41        ret = of_property_read_u32(np, "reg", &addr);
  42        if (ret < 0) {
  43                dev_err(dev, "%s has invalid PHY address\n", np->full_name);
  44                return ret;
  45        }
  46
  47        /* A PHY must have a reg property in the range [0-31] */
  48        if (addr >= PHY_MAX_ADDR) {
  49                dev_err(dev, "%s PHY address %i is too large\n",
  50                        np->full_name, addr);
  51                return -EINVAL;
  52        }
  53
  54        return addr;
  55}
  56
  57#else /* CONFIG_OF_MDIO */
  58static inline bool of_mdiobus_child_is_phy(struct device_node *child)
  59{
  60        return false;
  61}
  62
  63static inline int of_mdiobus_register(struct mii_bus *mdio, struct device_node *np)
  64{
  65        /*
  66         * Fall back to the non-DT function to register a bus.
  67         * This way, we don't have to keep compat bits around in drivers.
  68         */
  69
  70        return mdiobus_register(mdio);
  71}
  72
  73static inline struct phy_device *of_phy_find_device(struct device_node *phy_np)
  74{
  75        return NULL;
  76}
  77
  78static inline struct phy_device *of_phy_connect(struct net_device *dev,
  79                                                struct device_node *phy_np,
  80                                                void (*hndlr)(struct net_device *),
  81                                                u32 flags, phy_interface_t iface)
  82{
  83        return NULL;
  84}
  85
  86static inline struct phy_device *
  87of_phy_get_and_connect(struct net_device *dev, struct device_node *np,
  88                       void (*hndlr)(struct net_device *))
  89{
  90        return NULL;
  91}
  92
  93static inline struct phy_device *of_phy_attach(struct net_device *dev,
  94                                               struct device_node *phy_np,
  95                                               u32 flags, phy_interface_t iface)
  96{
  97        return NULL;
  98}
  99
 100static inline struct mii_bus *of_mdio_find_bus(struct device_node *mdio_np)
 101{
 102        return NULL;
 103}
 104
 105static inline int of_mdio_parse_addr(struct device *dev,
 106                                     const struct device_node *np)
 107{
 108        return -ENOSYS;
 109}
 110static inline int of_phy_register_fixed_link(struct device_node *np)
 111{
 112        return -ENOSYS;
 113}
 114static inline void of_phy_deregister_fixed_link(struct device_node *np)
 115{
 116}
 117static inline bool of_phy_is_fixed_link(struct device_node *np)
 118{
 119        return false;
 120}
 121#endif
 122
 123
 124#endif /* __LINUX_OF_MDIO_H */
 125