phy: core: Add devm_of_phy_get_by_index to phy-core (6be109b3) · Commits · 戴 / test

Documentation/phy.txt

+6 −1

Original line number	Diff line number	Diff line
		@@ -76,6 +76,8 @@ struct phy phy_get(struct device dev, const char *string);
		struct phy phy_optional_get(struct device dev, const char *string);
		struct phy devm_phy_get(struct device dev, const char *string);
		struct phy devm_phy_optional_get(struct device dev, const char *string);
		struct phy devm_of_phy_get_by_index(struct device dev, struct device_node *np,
		int index);

		phy_get, phy_optional_get, devm_phy_get and devm_phy_optional_get can
		be used to get the PHY. In the case of dt boot, the string arguments
		@@ -86,7 +88,10 @@ successful PHY get. On driver detach, release function is invoked on
		the the devres data and devres data is freed. phy_optional_get and
		devm_phy_optional_get should be used when the phy is optional. These
		two functions will never return -ENODEV, but instead returns NULL when
		the phy cannot be found.
		the phy cannot be found.Some generic drivers, such as ehci, may use multiple
		phys and for such drivers referencing phy(s) by name(s) does not make sense. In
		this case, devm_of_phy_get_by_index can be used to get a phy reference based on
		the index.

		It should be noted that NULL is a valid phy reference. All phy
		consumer calls on the NULL phy become NOPs. That is the release calls,

+32 −0

Original line number	Diff line number	Diff line
		@@ -622,6 +622,38 @@ struct phy devm_of_phy_get(struct device dev, struct device_node *np,
		}
		EXPORT_SYMBOL_GPL(devm_of_phy_get);

		/**
		* devm_of_phy_get_by_index() - lookup and obtain a reference to a phy by index.
		* @dev: device that requests this phy
		* @np: node containing the phy
		* @index: index of the phy
		*
		* Gets the phy using _of_phy_get(), and associates a device with it using
		* devres. On driver detach, release function is invoked on the devres data,
		* then, devres data is freed.
		*
		*/
		struct phy devm_of_phy_get_by_index(struct device dev, struct device_node *np,
		int index)
		{
		struct phy *ptr, phy;

		ptr = devres_alloc(devm_phy_release, sizeof(*ptr), GFP_KERNEL);
		if (!ptr)
		return ERR_PTR(-ENOMEM);

		phy = _of_phy_get(np, index);
		if (!IS_ERR(phy)) {
		*ptr = phy;
		devres_add(dev, ptr);
		} else {
		devres_free(ptr);
		}

		return phy;
		}
		EXPORT_SYMBOL_GPL(devm_of_phy_get_by_index);

		/**
		* phy_create() - create a new phy
		* @dev: device that is creating the new phy

+9 −0

Original line number	Diff line number	Diff line
		@@ -133,6 +133,8 @@ struct phy devm_phy_get(struct device dev, const char *string);
		struct phy devm_phy_optional_get(struct device dev, const char *string);
		struct phy devm_of_phy_get(struct device dev, struct device_node *np,
		const char *con_id);
		struct phy devm_of_phy_get_by_index(struct device dev, struct device_node *np,
		int index);
		void phy_put(struct phy *phy);
		void devm_phy_put(struct device dev, struct phy phy);
		struct phy of_phy_get(struct device_node np, const char *con_id);
		@@ -261,6 +263,13 @@ static inline struct phy devm_of_phy_get(struct device dev,
		return ERR_PTR(-ENOSYS);
		}

		static inline struct phy devm_of_phy_get_by_index(struct device dev,
		struct device_node *np,
		int index)
		{
		return ERR_PTR(-ENOSYS);
		}

		static inline void phy_put(struct phy *phy)
		{
		}