[linux-2.6-block.git] / net / core / of_net.c

// SPDX-License-Identifier: GPL-2.0-only
/*
 * OF helpers for network devices.
 *
 * Initially copied out of arch/powerpc/kernel/prom_parse.c
 */
#include <linux/etherdevice.h>
#include <linux/kernel.h>
#include <linux/of_net.h>
#include <linux/of_platform.h>
#include <linux/platform_device.h>
#include <linux/phy.h>
#include <linux/export.h>
#include <linux/device.h>
#include <linux/nvmem-consumer.h>

/**
 * of_get_phy_mode - Get phy mode for given device_node
 * @np:	Pointer to the given device_node
 * @interface: Pointer to the result
 *
 * The function gets phy interface string from property 'phy-mode' or
 * 'phy-connection-type'. The index in phy_modes table is set in
 * interface and 0 returned. In case of error interface is set to
 * PHY_INTERFACE_MODE_NA and an errno is returned, e.g. -ENODEV.
 */
int of_get_phy_mode(struct device_node *np, phy_interface_t *interface)
{
	const char *pm;
	int err, i;

	*interface = PHY_INTERFACE_MODE_NA;

	err = of_property_read_string(np, "phy-mode", &pm);
	if (err < 0)
		err = of_property_read_string(np, "phy-connection-type", &pm);
	if (err < 0)
		return err;

	for (i = 0; i < PHY_INTERFACE_MODE_MAX; i++)
		if (!strcasecmp(pm, phy_modes(i))) {
			*interface = i;
			return 0;
		}

	return -ENODEV;
}
EXPORT_SYMBOL_GPL(of_get_phy_mode);

static int of_get_mac_addr(struct device_node *np, const char *name, u8 *addr)
{
	struct property *pp = of_find_property(np, name, NULL);

	if (pp && pp->length == ETH_ALEN && is_valid_ether_addr(pp->value)) {
		memcpy(addr, pp->value, ETH_ALEN);
		return 0;
	}
	return -ENODEV;
}

int of_get_mac_address_nvmem(struct device_node *np, u8 *addr)
{
	struct platform_device *pdev = of_find_device_by_node(np);
	struct nvmem_cell *cell;
	const void *mac;
	size_t len;
	int ret;

	/* Try lookup by device first, there might be a nvmem_cell_lookup
	 * associated with a given device.
	 */
	if (pdev) {
		ret = nvmem_get_mac_address(&pdev->dev, addr);
		put_device(&pdev->dev);
		return ret;
	}

	cell = of_nvmem_cell_get(np, "mac-address");
	if (IS_ERR(cell))
		return PTR_ERR(cell);

	mac = nvmem_cell_read(cell, &len);
	nvmem_cell_put(cell);

	if (IS_ERR(mac))
		return PTR_ERR(mac);

	if (len != ETH_ALEN || !is_valid_ether_addr(mac)) {
		kfree(mac);
		return -EINVAL;
	}

	memcpy(addr, mac, ETH_ALEN);
	kfree(mac);

	return 0;
}
EXPORT_SYMBOL(of_get_mac_address_nvmem);

/**
 * of_get_mac_address()
 * @np:		Caller's Device Node
 * @addr:	Pointer to a six-byte array for the result
 *
 * Search the device tree for the best MAC address to use.  'mac-address' is
 * checked first, because that is supposed to contain to "most recent" MAC
 * address. If that isn't set, then 'local-mac-address' is checked next,
 * because that is the default address. If that isn't set, then the obsolete
 * 'address' is checked, just in case we're using an old device tree. If any
 * of the above isn't set, then try to get MAC address from nvmem cell named
 * 'mac-address'.
 *
 * Note that the 'address' property is supposed to contain a virtual address of
 * the register set, but some DTS files have redefined that property to be the
 * MAC address.
 *
 * All-zero MAC addresses are rejected, because those could be properties that
 * exist in the device tree, but were not set by U-Boot.  For example, the
 * DTS could define 'mac-address' and 'local-mac-address', with zero MAC
 * addresses.  Some older U-Boots only initialized 'local-mac-address'.  In
 * this case, the real MAC is in 'local-mac-address', and 'mac-address' exists
 * but is all zeros.
 *
 * Return: 0 on success and errno in case of error.
*/
int of_get_mac_address(struct device_node *np, u8 *addr)
{
	int ret;

	if (!np)
		return -ENODEV;

	ret = of_get_mac_addr(np, "mac-address", addr);
	if (!ret)
		return 0;

	ret = of_get_mac_addr(np, "local-mac-address", addr);
	if (!ret)
		return 0;

	ret = of_get_mac_addr(np, "address", addr);
	if (!ret)
		return 0;

	return of_get_mac_address_nvmem(np, addr);
}
EXPORT_SYMBOL(of_get_mac_address);

/**
 * of_get_ethdev_address()
 * @np:		Caller's Device Node
 * @dev:	Pointer to netdevice which address will be updated
 *
 * Search the device tree for the best MAC address to use.
 * If found set @dev->dev_addr to that address.
 *
 * See documentation of of_get_mac_address() for more information on how
 * the best address is determined.
 *
 * Return: 0 on success and errno in case of error.
 */
int of_get_ethdev_address(struct device_node *np, struct net_device *dev)
{
	u8 addr[ETH_ALEN];
	int ret;

	ret = of_get_mac_address(np, addr);
	if (!ret)
		eth_hw_addr_set(dev, addr);
	return ret;
}
EXPORT_SYMBOL(of_get_ethdev_address);
Commit	Line	Data
	1	// SPDX-License-Identifier: GPL-2.0-only
	2	/*
	3	* OF helpers for network devices.
	4	*
	5	* Initially copied out of arch/powerpc/kernel/prom_parse.c
	6	*/
	7	#include <linux/etherdevice.h>
	8	#include <linux/kernel.h>
	9	#include <linux/of_net.h>
	10	#include <linux/of_platform.h>
	11	#include <linux/platform_device.h>
	12	#include <linux/phy.h>
	13	#include <linux/export.h>
	14	#include <linux/device.h>
	15	#include <linux/nvmem-consumer.h>
	16
	17	/**
	18	* of_get_phy_mode - Get phy mode for given device_node
	19	* @np: Pointer to the given device_node
	20	* @interface: Pointer to the result
	21	*
	22	* The function gets phy interface string from property 'phy-mode' or
	23	* 'phy-connection-type'. The index in phy_modes table is set in
	24	* interface and 0 returned. In case of error interface is set to
	25	* PHY_INTERFACE_MODE_NA and an errno is returned, e.g. -ENODEV.
	26	*/
	27	int of_get_phy_mode(struct device_node np, phy_interface_t interface)
	28	{
	29	const char *pm;
	30	int err, i;
	31
	32	*interface = PHY_INTERFACE_MODE_NA;
	33
	34	err = of_property_read_string(np, "phy-mode", &pm);
	35	if (err < 0)
	36	err = of_property_read_string(np, "phy-connection-type", &pm);
	37	if (err < 0)
	38	return err;
	39
	40	for (i = 0; i < PHY_INTERFACE_MODE_MAX; i++)
	41	if (!strcasecmp(pm, phy_modes(i))) {
	42	*interface = i;
	43	return 0;
	44	}
	45
	46	return -ENODEV;
	47	}
	48	EXPORT_SYMBOL_GPL(of_get_phy_mode);
	49
	50	static int of_get_mac_addr(struct device_node np, const char name, u8 *addr)
	51	{
	52	struct property *pp = of_find_property(np, name, NULL);
	53
	54	if (pp && pp->length == ETH_ALEN && is_valid_ether_addr(pp->value)) {
	55	memcpy(addr, pp->value, ETH_ALEN);
	56	return 0;
	57	}
	58	return -ENODEV;
	59	}
	60
	61	int of_get_mac_address_nvmem(struct device_node np, u8 addr)
	62	{
	63	struct platform_device *pdev = of_find_device_by_node(np);
	64	struct nvmem_cell *cell;
	65	const void *mac;
	66	size_t len;
	67	int ret;
	68
	69	/* Try lookup by device first, there might be a nvmem_cell_lookup
	70	* associated with a given device.
	71	*/
	72	if (pdev) {
	73	ret = nvmem_get_mac_address(&pdev->dev, addr);
	74	put_device(&pdev->dev);
	75	return ret;
	76	}
	77
	78	cell = of_nvmem_cell_get(np, "mac-address");
	79	if (IS_ERR(cell))
	80	return PTR_ERR(cell);
	81
	82	mac = nvmem_cell_read(cell, &len);
	83	nvmem_cell_put(cell);
	84
	85	if (IS_ERR(mac))
	86	return PTR_ERR(mac);
	87
	88	if (len != ETH_ALEN \|\| !is_valid_ether_addr(mac)) {
	89	kfree(mac);
	90	return -EINVAL;
	91	}
	92
	93	memcpy(addr, mac, ETH_ALEN);
	94	kfree(mac);
	95
	96	return 0;
	97	}
	98	EXPORT_SYMBOL(of_get_mac_address_nvmem);
	99
	100	/**
	101	* of_get_mac_address()
	102	* @np: Caller's Device Node
	103	* @addr: Pointer to a six-byte array for the result
	104	*
	105	* Search the device tree for the best MAC address to use. 'mac-address' is
	106	* checked first, because that is supposed to contain to "most recent" MAC
	107	* address. If that isn't set, then 'local-mac-address' is checked next,
	108	* because that is the default address. If that isn't set, then the obsolete
	109	* 'address' is checked, just in case we're using an old device tree. If any
	110	* of the above isn't set, then try to get MAC address from nvmem cell named
	111	* 'mac-address'.
	112	*
	113	* Note that the 'address' property is supposed to contain a virtual address of
	114	* the register set, but some DTS files have redefined that property to be the
	115	* MAC address.
	116	*
	117	* All-zero MAC addresses are rejected, because those could be properties that
	118	* exist in the device tree, but were not set by U-Boot. For example, the
	119	* DTS could define 'mac-address' and 'local-mac-address', with zero MAC
	120	* addresses. Some older U-Boots only initialized 'local-mac-address'. In
	121	* this case, the real MAC is in 'local-mac-address', and 'mac-address' exists
	122	* but is all zeros.
	123	*
	124	* Return: 0 on success and errno in case of error.
	125	*/
	126	int of_get_mac_address(struct device_node np, u8 addr)
	127	{
	128	int ret;
	129
	130	if (!np)
	131	return -ENODEV;
	132
	133	ret = of_get_mac_addr(np, "mac-address", addr);
	134	if (!ret)
	135	return 0;
	136
	137	ret = of_get_mac_addr(np, "local-mac-address", addr);
	138	if (!ret)
	139	return 0;
	140
	141	ret = of_get_mac_addr(np, "address", addr);
	142	if (!ret)
	143	return 0;
	144
	145	return of_get_mac_address_nvmem(np, addr);
	146	}
	147	EXPORT_SYMBOL(of_get_mac_address);
	148
	149	/**
	150	* of_get_ethdev_address()
	151	* @np: Caller's Device Node
	152	* @dev: Pointer to netdevice which address will be updated
	153	*
	154	* Search the device tree for the best MAC address to use.
	155	* If found set @dev->dev_addr to that address.
	156	*
	157	* See documentation of of_get_mac_address() for more information on how
	158	* the best address is determined.
	159	*
	160	* Return: 0 on success and errno in case of error.
	161	*/
	162	int of_get_ethdev_address(struct device_node np, struct net_device dev)
	163	{
	164	u8 addr[ETH_ALEN];
	165	int ret;
	166
	167	ret = of_get_mac_address(np, addr);
	168	if (!ret)
	169	eth_hw_addr_set(dev, addr);
	170	return ret;
	171	}
	172	EXPORT_SYMBOL(of_get_ethdev_address);