tjh.dev
Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
1/*
2 * OF helpers for network devices.
3 *
4 * This file is released under the GPLv2
5 *
6 * Initially copied out of arch/powerpc/kernel/prom_parse.c
7 */
8#include <linux/etherdevice.h>
9#include <linux/kernel.h>
10#include <linux/of_net.h>
11#include <linux/phy.h>
12#include <linux/export.h>
13
14/**
15 * It maps 'enum phy_interface_t' found in include/linux/phy.h
16 * into the device tree binding of 'phy-mode', so that Ethernet
17 * device driver can get phy interface from device tree.
18 */
19static const char *phy_modes[] = {
20 [PHY_INTERFACE_MODE_NA] = "",
21 [PHY_INTERFACE_MODE_MII] = "mii",
22 [PHY_INTERFACE_MODE_GMII] = "gmii",
23 [PHY_INTERFACE_MODE_SGMII] = "sgmii",
24 [PHY_INTERFACE_MODE_TBI] = "tbi",
25 [PHY_INTERFACE_MODE_REVMII] = "rev-mii",
26 [PHY_INTERFACE_MODE_RMII] = "rmii",
27 [PHY_INTERFACE_MODE_RGMII] = "rgmii",
28 [PHY_INTERFACE_MODE_RGMII_ID] = "rgmii-id",
29 [PHY_INTERFACE_MODE_RGMII_RXID] = "rgmii-rxid",
30 [PHY_INTERFACE_MODE_RGMII_TXID] = "rgmii-txid",
31 [PHY_INTERFACE_MODE_RTBI] = "rtbi",
32 [PHY_INTERFACE_MODE_SMII] = "smii",
33 [PHY_INTERFACE_MODE_XGMII] = "xgmii",
34};
35
36/**
37 * of_get_phy_mode - Get phy mode for given device_node
38 * @np: Pointer to the given device_node
39 *
40 * The function gets phy interface string from property 'phy-mode',
41 * and return its index in phy_modes table, or errno in error case.
42 */
43int of_get_phy_mode(struct device_node *np)
44{
45 const char *pm;
46 int err, i;
47
48 err = of_property_read_string(np, "phy-mode", &pm);
49 if (err < 0)
50 return err;
51
52 for (i = 0; i < ARRAY_SIZE(phy_modes); i++)
53 if (!strcasecmp(pm, phy_modes[i]))
54 return i;
55
56 return -ENODEV;
57}
58EXPORT_SYMBOL_GPL(of_get_phy_mode);
59
60/**
61 * Search the device tree for the best MAC address to use. 'mac-address' is
62 * checked first, because that is supposed to contain to "most recent" MAC
63 * address. If that isn't set, then 'local-mac-address' is checked next,
64 * because that is the default address. If that isn't set, then the obsolete
65 * 'address' is checked, just in case we're using an old device tree.
66 *
67 * Note that the 'address' property is supposed to contain a virtual address of
68 * the register set, but some DTS files have redefined that property to be the
69 * MAC address.
70 *
71 * All-zero MAC addresses are rejected, because those could be properties that
72 * exist in the device tree, but were not set by U-Boot. For example, the
73 * DTS could define 'mac-address' and 'local-mac-address', with zero MAC
74 * addresses. Some older U-Boots only initialized 'local-mac-address'. In
75 * this case, the real MAC is in 'local-mac-address', and 'mac-address' exists
76 * but is all zeros.
77*/
78const void *of_get_mac_address(struct device_node *np)
79{
80 struct property *pp;
81
82 pp = of_find_property(np, "mac-address", NULL);
83 if (pp && (pp->length == 6) && is_valid_ether_addr(pp->value))
84 return pp->value;
85
86 pp = of_find_property(np, "local-mac-address", NULL);
87 if (pp && (pp->length == 6) && is_valid_ether_addr(pp->value))
88 return pp->value;
89
90 pp = of_find_property(np, "address", NULL);
91 if (pp && (pp->length == 6) && is_valid_ether_addr(pp->value))
92 return pp->value;
93
94 return NULL;
95}
96EXPORT_SYMBOL(of_get_mac_address);