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 int of_mdiobus_register(struct mii_bus *mdio, struct device_node *np);
  16 extern struct phy_device *of_phy_find_device(struct device_node *phy_np);
  17 extern struct phy_device *of_phy_connect(struct net_device *dev,
  18                                          struct device_node *phy_np,
  19                                          void (*hndlr)(struct net_device *),
  20                                          u32 flags, phy_interface_t iface);
  21 extern struct phy_device *
  22 of_phy_get_and_connect(struct net_device *dev, struct device_node *np,
  23                        void (*hndlr)(struct net_device *));
  24 struct phy_device *of_phy_attach(struct net_device *dev,
  25                                  struct device_node *phy_np, u32 flags,
  26                                  phy_interface_t iface);
  27
  28 extern struct mii_bus *of_mdio_find_bus(struct device_node *mdio_np);
  29 extern int of_phy_register_fixed_link(struct device_node *np);
  30 extern void of_phy_deregister_fixed_link(struct device_node *np);
  31 extern bool of_phy_is_fixed_link(struct device_node *np);
  32
  33
  34 static inline int of_mdio_parse_addr(struct device *dev,
  35                                      const struct device_node *np)
  36 {
  37         u32 addr;
  38         int ret;
  39
  40         ret = of_property_read_u32(np, "reg", &addr);
  41         if (ret < 0) {
  42                 dev_err(dev, "%s has invalid PHY address\n", np->full_name);
  43                 return ret;
  44         }
  45
  46         /* A PHY must have a reg property in the range [0-31] */
  47         if (addr >= PHY_MAX_ADDR) {
  48                 dev_err(dev, "%s PHY address %i is too large\n",
  49                         np->full_name, addr);
  50                 return -EINVAL;
  51         }
  52
  53         return addr;
  54 }
  55
  56 #else /* CONFIG_OF_MDIO */
  57 static inline int of_mdiobus_register(struct mii_bus *mdio, struct device_node *np)
  58 {
  59         /*
  60          * Fall back to the non-DT function to register a bus.
  61          * This way, we don't have to keep compat bits around in drivers.
  62          */
  63
  64         return mdiobus_register(mdio);
  65 }
  66
  67 static inline struct phy_device *of_phy_find_device(struct device_node *phy_np)
  68 {
  69         return NULL;
  70 }
  71
  72 static inline struct phy_device *of_phy_connect(struct net_device *dev,
  73                                                 struct device_node *phy_np,
  74                                                 void (*hndlr)(struct net_device *),
  75                                                 u32 flags, phy_interface_t iface)
  76 {
  77         return NULL;
  78 }
  79
  80 static inline struct phy_device *
  81 of_phy_get_and_connect(struct net_device *dev, struct device_node *np,
  82                        void (*hndlr)(struct net_device *))
  83 {
  84         return NULL;
  85 }
  86
  87 static inline struct phy_device *of_phy_attach(struct net_device *dev,
  88                                                struct device_node *phy_np,
  89                                                u32 flags, phy_interface_t iface)
  90 {
  91         return NULL;
  92 }
  93
  94 static inline struct mii_bus *of_mdio_find_bus(struct device_node *mdio_np)
  95 {
  96         return NULL;
  97 }
  98
  99 static inline int of_mdio_parse_addr(struct device *dev,
 100                                      const struct device_node *np)
 101 {
 102         return -ENOSYS;
 103 }
 104 static inline int of_phy_register_fixed_link(struct device_node *np)
 105 {
 106         return -ENOSYS;
 107 }
 108 static inline void of_phy_deregister_fixed_link(struct device_node *np)
 109 {
 110 }
 111 static inline bool of_phy_is_fixed_link(struct device_node *np)
 112 {
 113         return false;
 114 }
 115 #endif
 116
 117
 118 #endif /* __LINUX_OF_MDIO_H */