include/linux/of_mdio.h

   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)
  15 extern bool of_mdiobus_child_is_phy(struct device_node *child);
  16 extern int of_mdiobus_register(struct mii_bus *mdio, struct device_node *np);
  17 extern struct phy_device *of_phy_find_device(struct device_node *phy_np);
  18 extern 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);
  22 extern struct phy_device *
  23 of_phy_get_and_connect(struct net_device *dev, struct device_node *np,
  24                        void (*hndlr)(struct net_device *));
  25 struct phy_device *of_phy_attach(struct net_device *dev,
  26                                  struct device_node *phy_np, u32 flags,
  27                                  phy_interface_t iface);
  28
  29 extern struct mii_bus *of_mdio_find_bus(struct device_node *mdio_np);
  30 extern int of_phy_register_fixed_link(struct device_node *np);
  31 extern void of_phy_deregister_fixed_link(struct device_node *np);
  32 extern bool of_phy_is_fixed_link(struct device_node *np);
  33
  34
  35 static 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 */
  58 static inline bool of_mdiobus_child_is_phy(struct device_node *child)
  59 {
  60         return false;
  61 }
  62
  63 static 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
  73 static inline struct phy_device *of_phy_find_device(struct device_node *phy_np)
  74 {
  75         return NULL;
  76 }
  77
  78 static 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
  86 static inline struct phy_device *
  87 of_phy_get_and_connect(struct net_device *dev, struct device_node *np,
  88                        void (*hndlr)(struct net_device *))
  89 {
  90         return NULL;
  91 }
  92
  93 static 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
 100 static inline struct mii_bus *of_mdio_find_bus(struct device_node *mdio_np)
 101 {
 102         return NULL;
 103 }
 104
 105 static inline int of_mdio_parse_addr(struct device *dev,
 106                                      const struct device_node *np)
 107 {
 108         return -ENOSYS;
 109 }
 110 static inline int of_phy_register_fixed_link(struct device_node *np)
 111 {
 112         return -ENOSYS;
 113 }
 114 static inline void of_phy_deregister_fixed_link(struct device_node *np)
 115 {
 116 }
 117 static 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 */