xref: /openbmc/linux/drivers/phy/phy-core.c (revision 3be88125d85df587085b0be0a5c0e9953eb5ed6b)
1ff764963SKishon Vijay Abraham I /*
2ff764963SKishon Vijay Abraham I  * phy-core.c  --  Generic Phy framework.
3ff764963SKishon Vijay Abraham I  *
4ff764963SKishon Vijay Abraham I  * Copyright (C) 2013 Texas Instruments Incorporated - http://www.ti.com
5ff764963SKishon Vijay Abraham I  *
6ff764963SKishon Vijay Abraham I  * Author: Kishon Vijay Abraham I <kishon@ti.com>
7ff764963SKishon Vijay Abraham I  *
8ff764963SKishon Vijay Abraham I  * This program is free software; you can redistribute  it and/or modify it
9ff764963SKishon Vijay Abraham I  * under  the terms of  the GNU General  Public License as published by the
10ff764963SKishon Vijay Abraham I  * Free Software Foundation;  either version 2 of the  License, or (at your
11ff764963SKishon Vijay Abraham I  * option) any later version.
12ff764963SKishon Vijay Abraham I  */
13ff764963SKishon Vijay Abraham I 
14ff764963SKishon Vijay Abraham I #include <linux/kernel.h>
15ff764963SKishon Vijay Abraham I #include <linux/export.h>
16ff764963SKishon Vijay Abraham I #include <linux/module.h>
17ff764963SKishon Vijay Abraham I #include <linux/err.h>
18ff764963SKishon Vijay Abraham I #include <linux/device.h>
19ff764963SKishon Vijay Abraham I #include <linux/slab.h>
20ff764963SKishon Vijay Abraham I #include <linux/of.h>
21ff764963SKishon Vijay Abraham I #include <linux/phy/phy.h>
22ff764963SKishon Vijay Abraham I #include <linux/idr.h>
23ff764963SKishon Vijay Abraham I #include <linux/pm_runtime.h>
24*3be88125SRoger Quadros #include <linux/regulator/consumer.h>
25ff764963SKishon Vijay Abraham I 
26ff764963SKishon Vijay Abraham I static struct class *phy_class;
27ff764963SKishon Vijay Abraham I static DEFINE_MUTEX(phy_provider_mutex);
28ff764963SKishon Vijay Abraham I static LIST_HEAD(phy_provider_list);
29ff764963SKishon Vijay Abraham I static DEFINE_IDA(phy_ida);
30ff764963SKishon Vijay Abraham I 
31ff764963SKishon Vijay Abraham I static void devm_phy_release(struct device *dev, void *res)
32ff764963SKishon Vijay Abraham I {
33ff764963SKishon Vijay Abraham I 	struct phy *phy = *(struct phy **)res;
34ff764963SKishon Vijay Abraham I 
35ff764963SKishon Vijay Abraham I 	phy_put(phy);
36ff764963SKishon Vijay Abraham I }
37ff764963SKishon Vijay Abraham I 
38ff764963SKishon Vijay Abraham I static void devm_phy_provider_release(struct device *dev, void *res)
39ff764963SKishon Vijay Abraham I {
40ff764963SKishon Vijay Abraham I 	struct phy_provider *phy_provider = *(struct phy_provider **)res;
41ff764963SKishon Vijay Abraham I 
42ff764963SKishon Vijay Abraham I 	of_phy_provider_unregister(phy_provider);
43ff764963SKishon Vijay Abraham I }
44ff764963SKishon Vijay Abraham I 
45ff764963SKishon Vijay Abraham I static void devm_phy_consume(struct device *dev, void *res)
46ff764963SKishon Vijay Abraham I {
47ff764963SKishon Vijay Abraham I 	struct phy *phy = *(struct phy **)res;
48ff764963SKishon Vijay Abraham I 
49ff764963SKishon Vijay Abraham I 	phy_destroy(phy);
50ff764963SKishon Vijay Abraham I }
51ff764963SKishon Vijay Abraham I 
52ff764963SKishon Vijay Abraham I static int devm_phy_match(struct device *dev, void *res, void *match_data)
53ff764963SKishon Vijay Abraham I {
54ff764963SKishon Vijay Abraham I 	return res == match_data;
55ff764963SKishon Vijay Abraham I }
56ff764963SKishon Vijay Abraham I 
57ff764963SKishon Vijay Abraham I static struct phy *phy_lookup(struct device *device, const char *port)
58ff764963SKishon Vijay Abraham I {
59ff764963SKishon Vijay Abraham I 	unsigned int count;
60ff764963SKishon Vijay Abraham I 	struct phy *phy;
61ff764963SKishon Vijay Abraham I 	struct device *dev;
62ff764963SKishon Vijay Abraham I 	struct phy_consumer *consumers;
63ff764963SKishon Vijay Abraham I 	struct class_dev_iter iter;
64ff764963SKishon Vijay Abraham I 
65ff764963SKishon Vijay Abraham I 	class_dev_iter_init(&iter, phy_class, NULL, NULL);
66ff764963SKishon Vijay Abraham I 	while ((dev = class_dev_iter_next(&iter))) {
67ff764963SKishon Vijay Abraham I 		phy = to_phy(dev);
68743bb387SSergei Shtylyov 
69743bb387SSergei Shtylyov 		if (!phy->init_data)
70743bb387SSergei Shtylyov 			continue;
71ff764963SKishon Vijay Abraham I 		count = phy->init_data->num_consumers;
72ff764963SKishon Vijay Abraham I 		consumers = phy->init_data->consumers;
73ff764963SKishon Vijay Abraham I 		while (count--) {
74ff764963SKishon Vijay Abraham I 			if (!strcmp(consumers->dev_name, dev_name(device)) &&
75ff764963SKishon Vijay Abraham I 					!strcmp(consumers->port, port)) {
76ff764963SKishon Vijay Abraham I 				class_dev_iter_exit(&iter);
77ff764963SKishon Vijay Abraham I 				return phy;
78ff764963SKishon Vijay Abraham I 			}
79ff764963SKishon Vijay Abraham I 			consumers++;
80ff764963SKishon Vijay Abraham I 		}
81ff764963SKishon Vijay Abraham I 	}
82ff764963SKishon Vijay Abraham I 
83ff764963SKishon Vijay Abraham I 	class_dev_iter_exit(&iter);
84ff764963SKishon Vijay Abraham I 	return ERR_PTR(-ENODEV);
85ff764963SKishon Vijay Abraham I }
86ff764963SKishon Vijay Abraham I 
87ff764963SKishon Vijay Abraham I static struct phy_provider *of_phy_provider_lookup(struct device_node *node)
88ff764963SKishon Vijay Abraham I {
89ff764963SKishon Vijay Abraham I 	struct phy_provider *phy_provider;
90ff764963SKishon Vijay Abraham I 
91ff764963SKishon Vijay Abraham I 	list_for_each_entry(phy_provider, &phy_provider_list, list) {
92ff764963SKishon Vijay Abraham I 		if (phy_provider->dev->of_node == node)
93ff764963SKishon Vijay Abraham I 			return phy_provider;
94ff764963SKishon Vijay Abraham I 	}
95ff764963SKishon Vijay Abraham I 
96ff764963SKishon Vijay Abraham I 	return ERR_PTR(-EPROBE_DEFER);
97ff764963SKishon Vijay Abraham I }
98ff764963SKishon Vijay Abraham I 
99ff764963SKishon Vijay Abraham I int phy_pm_runtime_get(struct phy *phy)
100ff764963SKishon Vijay Abraham I {
101cedb7f89SFelipe Balbi 	int ret;
102cedb7f89SFelipe Balbi 
103ff764963SKishon Vijay Abraham I 	if (!pm_runtime_enabled(&phy->dev))
104ff764963SKishon Vijay Abraham I 		return -ENOTSUPP;
105ff764963SKishon Vijay Abraham I 
106cedb7f89SFelipe Balbi 	ret = pm_runtime_get(&phy->dev);
107cedb7f89SFelipe Balbi 	if (ret < 0 && ret != -EINPROGRESS)
108cedb7f89SFelipe Balbi 		pm_runtime_put_noidle(&phy->dev);
109cedb7f89SFelipe Balbi 
110cedb7f89SFelipe Balbi 	return ret;
111ff764963SKishon Vijay Abraham I }
112ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(phy_pm_runtime_get);
113ff764963SKishon Vijay Abraham I 
114ff764963SKishon Vijay Abraham I int phy_pm_runtime_get_sync(struct phy *phy)
115ff764963SKishon Vijay Abraham I {
116cedb7f89SFelipe Balbi 	int ret;
117cedb7f89SFelipe Balbi 
118ff764963SKishon Vijay Abraham I 	if (!pm_runtime_enabled(&phy->dev))
119ff764963SKishon Vijay Abraham I 		return -ENOTSUPP;
120ff764963SKishon Vijay Abraham I 
121cedb7f89SFelipe Balbi 	ret = pm_runtime_get_sync(&phy->dev);
122cedb7f89SFelipe Balbi 	if (ret < 0)
123cedb7f89SFelipe Balbi 		pm_runtime_put_sync(&phy->dev);
124cedb7f89SFelipe Balbi 
125cedb7f89SFelipe Balbi 	return ret;
126ff764963SKishon Vijay Abraham I }
127ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(phy_pm_runtime_get_sync);
128ff764963SKishon Vijay Abraham I 
129ff764963SKishon Vijay Abraham I int phy_pm_runtime_put(struct phy *phy)
130ff764963SKishon Vijay Abraham I {
131ff764963SKishon Vijay Abraham I 	if (!pm_runtime_enabled(&phy->dev))
132ff764963SKishon Vijay Abraham I 		return -ENOTSUPP;
133ff764963SKishon Vijay Abraham I 
134ff764963SKishon Vijay Abraham I 	return pm_runtime_put(&phy->dev);
135ff764963SKishon Vijay Abraham I }
136ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(phy_pm_runtime_put);
137ff764963SKishon Vijay Abraham I 
138ff764963SKishon Vijay Abraham I int phy_pm_runtime_put_sync(struct phy *phy)
139ff764963SKishon Vijay Abraham I {
140ff764963SKishon Vijay Abraham I 	if (!pm_runtime_enabled(&phy->dev))
141ff764963SKishon Vijay Abraham I 		return -ENOTSUPP;
142ff764963SKishon Vijay Abraham I 
143ff764963SKishon Vijay Abraham I 	return pm_runtime_put_sync(&phy->dev);
144ff764963SKishon Vijay Abraham I }
145ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(phy_pm_runtime_put_sync);
146ff764963SKishon Vijay Abraham I 
147ff764963SKishon Vijay Abraham I void phy_pm_runtime_allow(struct phy *phy)
148ff764963SKishon Vijay Abraham I {
149ff764963SKishon Vijay Abraham I 	if (!pm_runtime_enabled(&phy->dev))
150ff764963SKishon Vijay Abraham I 		return;
151ff764963SKishon Vijay Abraham I 
152ff764963SKishon Vijay Abraham I 	pm_runtime_allow(&phy->dev);
153ff764963SKishon Vijay Abraham I }
154ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(phy_pm_runtime_allow);
155ff764963SKishon Vijay Abraham I 
156ff764963SKishon Vijay Abraham I void phy_pm_runtime_forbid(struct phy *phy)
157ff764963SKishon Vijay Abraham I {
158ff764963SKishon Vijay Abraham I 	if (!pm_runtime_enabled(&phy->dev))
159ff764963SKishon Vijay Abraham I 		return;
160ff764963SKishon Vijay Abraham I 
161ff764963SKishon Vijay Abraham I 	pm_runtime_forbid(&phy->dev);
162ff764963SKishon Vijay Abraham I }
163ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(phy_pm_runtime_forbid);
164ff764963SKishon Vijay Abraham I 
165ff764963SKishon Vijay Abraham I int phy_init(struct phy *phy)
166ff764963SKishon Vijay Abraham I {
167ff764963SKishon Vijay Abraham I 	int ret;
168ff764963SKishon Vijay Abraham I 
16904c2facaSAndrew Lunn 	if (!phy)
17004c2facaSAndrew Lunn 		return 0;
17104c2facaSAndrew Lunn 
172ff764963SKishon Vijay Abraham I 	ret = phy_pm_runtime_get_sync(phy);
173ff764963SKishon Vijay Abraham I 	if (ret < 0 && ret != -ENOTSUPP)
174ff764963SKishon Vijay Abraham I 		return ret;
175ff764963SKishon Vijay Abraham I 
176ff764963SKishon Vijay Abraham I 	mutex_lock(&phy->mutex);
177637d378cSKishon Vijay Abraham I 	if (phy->init_count == 0 && phy->ops->init) {
178ff764963SKishon Vijay Abraham I 		ret = phy->ops->init(phy);
179ff764963SKishon Vijay Abraham I 		if (ret < 0) {
180ff764963SKishon Vijay Abraham I 			dev_err(&phy->dev, "phy init failed --> %d\n", ret);
181ff764963SKishon Vijay Abraham I 			goto out;
182ff764963SKishon Vijay Abraham I 		}
183767a1b5dSHans de Goede 	} else {
184767a1b5dSHans de Goede 		ret = 0; /* Override possible ret == -ENOTSUPP */
185ff764963SKishon Vijay Abraham I 	}
186637d378cSKishon Vijay Abraham I 	++phy->init_count;
187ff764963SKishon Vijay Abraham I 
188ff764963SKishon Vijay Abraham I out:
189ff764963SKishon Vijay Abraham I 	mutex_unlock(&phy->mutex);
190ff764963SKishon Vijay Abraham I 	phy_pm_runtime_put(phy);
191ff764963SKishon Vijay Abraham I 	return ret;
192ff764963SKishon Vijay Abraham I }
193ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(phy_init);
194ff764963SKishon Vijay Abraham I 
195ff764963SKishon Vijay Abraham I int phy_exit(struct phy *phy)
196ff764963SKishon Vijay Abraham I {
197ff764963SKishon Vijay Abraham I 	int ret;
198ff764963SKishon Vijay Abraham I 
19904c2facaSAndrew Lunn 	if (!phy)
20004c2facaSAndrew Lunn 		return 0;
20104c2facaSAndrew Lunn 
202ff764963SKishon Vijay Abraham I 	ret = phy_pm_runtime_get_sync(phy);
203ff764963SKishon Vijay Abraham I 	if (ret < 0 && ret != -ENOTSUPP)
204ff764963SKishon Vijay Abraham I 		return ret;
205ff764963SKishon Vijay Abraham I 
206ff764963SKishon Vijay Abraham I 	mutex_lock(&phy->mutex);
207637d378cSKishon Vijay Abraham I 	if (phy->init_count == 1 && phy->ops->exit) {
208ff764963SKishon Vijay Abraham I 		ret = phy->ops->exit(phy);
209ff764963SKishon Vijay Abraham I 		if (ret < 0) {
210ff764963SKishon Vijay Abraham I 			dev_err(&phy->dev, "phy exit failed --> %d\n", ret);
211ff764963SKishon Vijay Abraham I 			goto out;
212ff764963SKishon Vijay Abraham I 		}
213ff764963SKishon Vijay Abraham I 	}
214637d378cSKishon Vijay Abraham I 	--phy->init_count;
215ff764963SKishon Vijay Abraham I 
216ff764963SKishon Vijay Abraham I out:
217ff764963SKishon Vijay Abraham I 	mutex_unlock(&phy->mutex);
218ff764963SKishon Vijay Abraham I 	phy_pm_runtime_put(phy);
219ff764963SKishon Vijay Abraham I 	return ret;
220ff764963SKishon Vijay Abraham I }
221ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(phy_exit);
222ff764963SKishon Vijay Abraham I 
223ff764963SKishon Vijay Abraham I int phy_power_on(struct phy *phy)
224ff764963SKishon Vijay Abraham I {
225d18c9604SKishon Vijay Abraham I 	int ret;
226ff764963SKishon Vijay Abraham I 
22704c2facaSAndrew Lunn 	if (!phy)
22804c2facaSAndrew Lunn 		return 0;
22904c2facaSAndrew Lunn 
230*3be88125SRoger Quadros 	if (phy->pwr) {
231*3be88125SRoger Quadros 		ret = regulator_enable(phy->pwr);
232*3be88125SRoger Quadros 		if (ret)
233*3be88125SRoger Quadros 			return ret;
234*3be88125SRoger Quadros 	}
235*3be88125SRoger Quadros 
236ff764963SKishon Vijay Abraham I 	ret = phy_pm_runtime_get_sync(phy);
237ff764963SKishon Vijay Abraham I 	if (ret < 0 && ret != -ENOTSUPP)
238ff764963SKishon Vijay Abraham I 		return ret;
239ff764963SKishon Vijay Abraham I 
240ff764963SKishon Vijay Abraham I 	mutex_lock(&phy->mutex);
241637d378cSKishon Vijay Abraham I 	if (phy->power_count == 0 && phy->ops->power_on) {
242ff764963SKishon Vijay Abraham I 		ret = phy->ops->power_on(phy);
243ff764963SKishon Vijay Abraham I 		if (ret < 0) {
244ff764963SKishon Vijay Abraham I 			dev_err(&phy->dev, "phy poweron failed --> %d\n", ret);
245ff764963SKishon Vijay Abraham I 			goto out;
246ff764963SKishon Vijay Abraham I 		}
247767a1b5dSHans de Goede 	} else {
248767a1b5dSHans de Goede 		ret = 0; /* Override possible ret == -ENOTSUPP */
249ff764963SKishon Vijay Abraham I 	}
250637d378cSKishon Vijay Abraham I 	++phy->power_count;
251637d378cSKishon Vijay Abraham I 	mutex_unlock(&phy->mutex);
252637d378cSKishon Vijay Abraham I 	return 0;
253ff764963SKishon Vijay Abraham I 
254ff764963SKishon Vijay Abraham I out:
255ff764963SKishon Vijay Abraham I 	mutex_unlock(&phy->mutex);
256637d378cSKishon Vijay Abraham I 	phy_pm_runtime_put_sync(phy);
257*3be88125SRoger Quadros 	if (phy->pwr)
258*3be88125SRoger Quadros 		regulator_disable(phy->pwr);
259ff764963SKishon Vijay Abraham I 
260ff764963SKishon Vijay Abraham I 	return ret;
261ff764963SKishon Vijay Abraham I }
262ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(phy_power_on);
263ff764963SKishon Vijay Abraham I 
264ff764963SKishon Vijay Abraham I int phy_power_off(struct phy *phy)
265ff764963SKishon Vijay Abraham I {
266d18c9604SKishon Vijay Abraham I 	int ret;
267ff764963SKishon Vijay Abraham I 
26804c2facaSAndrew Lunn 	if (!phy)
26904c2facaSAndrew Lunn 		return 0;
27004c2facaSAndrew Lunn 
271ff764963SKishon Vijay Abraham I 	mutex_lock(&phy->mutex);
272637d378cSKishon Vijay Abraham I 	if (phy->power_count == 1 && phy->ops->power_off) {
273ff764963SKishon Vijay Abraham I 		ret =  phy->ops->power_off(phy);
274ff764963SKishon Vijay Abraham I 		if (ret < 0) {
275ff764963SKishon Vijay Abraham I 			dev_err(&phy->dev, "phy poweroff failed --> %d\n", ret);
276637d378cSKishon Vijay Abraham I 			mutex_unlock(&phy->mutex);
277637d378cSKishon Vijay Abraham I 			return ret;
278ff764963SKishon Vijay Abraham I 		}
279ff764963SKishon Vijay Abraham I 	}
280637d378cSKishon Vijay Abraham I 	--phy->power_count;
281ff764963SKishon Vijay Abraham I 	mutex_unlock(&phy->mutex);
282ff764963SKishon Vijay Abraham I 	phy_pm_runtime_put(phy);
283ff764963SKishon Vijay Abraham I 
284*3be88125SRoger Quadros 	if (phy->pwr)
285*3be88125SRoger Quadros 		regulator_disable(phy->pwr);
286*3be88125SRoger Quadros 
287637d378cSKishon Vijay Abraham I 	return 0;
288ff764963SKishon Vijay Abraham I }
289ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(phy_power_off);
290ff764963SKishon Vijay Abraham I 
291ff764963SKishon Vijay Abraham I /**
2920b3f3b2cSKamil Debski  * _of_phy_get() - lookup and obtain a reference to a phy by phandle
2930b3f3b2cSKamil Debski  * @np: device_node for which to get the phy
294ff764963SKishon Vijay Abraham I  * @index: the index of the phy
295ff764963SKishon Vijay Abraham I  *
296ff764963SKishon Vijay Abraham I  * Returns the phy associated with the given phandle value,
297ff764963SKishon Vijay Abraham I  * after getting a refcount to it or -ENODEV if there is no such phy or
298ff764963SKishon Vijay Abraham I  * -EPROBE_DEFER if there is a phandle to the phy, but the device is
299ff764963SKishon Vijay Abraham I  * not yet loaded. This function uses of_xlate call back function provided
300ff764963SKishon Vijay Abraham I  * while registering the phy_provider to find the phy instance.
301ff764963SKishon Vijay Abraham I  */
3020b3f3b2cSKamil Debski static struct phy *_of_phy_get(struct device_node *np, int index)
303ff764963SKishon Vijay Abraham I {
304ff764963SKishon Vijay Abraham I 	int ret;
305ff764963SKishon Vijay Abraham I 	struct phy_provider *phy_provider;
306ff764963SKishon Vijay Abraham I 	struct phy *phy = NULL;
307ff764963SKishon Vijay Abraham I 	struct of_phandle_args args;
308ff764963SKishon Vijay Abraham I 
3090b3f3b2cSKamil Debski 	ret = of_parse_phandle_with_args(np, "phys", "#phy-cells",
310ff764963SKishon Vijay Abraham I 		index, &args);
3110b3f3b2cSKamil Debski 	if (ret)
312ff764963SKishon Vijay Abraham I 		return ERR_PTR(-ENODEV);
313ff764963SKishon Vijay Abraham I 
314ff764963SKishon Vijay Abraham I 	mutex_lock(&phy_provider_mutex);
315ff764963SKishon Vijay Abraham I 	phy_provider = of_phy_provider_lookup(args.np);
316ff764963SKishon Vijay Abraham I 	if (IS_ERR(phy_provider) || !try_module_get(phy_provider->owner)) {
317ff764963SKishon Vijay Abraham I 		phy = ERR_PTR(-EPROBE_DEFER);
318ff764963SKishon Vijay Abraham I 		goto err0;
319ff764963SKishon Vijay Abraham I 	}
320ff764963SKishon Vijay Abraham I 
321ff764963SKishon Vijay Abraham I 	phy = phy_provider->of_xlate(phy_provider->dev, &args);
322ff764963SKishon Vijay Abraham I 	module_put(phy_provider->owner);
323ff764963SKishon Vijay Abraham I 
324ff764963SKishon Vijay Abraham I err0:
325ff764963SKishon Vijay Abraham I 	mutex_unlock(&phy_provider_mutex);
326ff764963SKishon Vijay Abraham I 	of_node_put(args.np);
327ff764963SKishon Vijay Abraham I 
328ff764963SKishon Vijay Abraham I 	return phy;
329ff764963SKishon Vijay Abraham I }
330ff764963SKishon Vijay Abraham I 
331ff764963SKishon Vijay Abraham I /**
3320b3f3b2cSKamil Debski  * of_phy_get() - lookup and obtain a reference to a phy using a device_node.
3330b3f3b2cSKamil Debski  * @np: device_node for which to get the phy
3340b3f3b2cSKamil Debski  * @con_id: name of the phy from device's point of view
3350b3f3b2cSKamil Debski  *
3360b3f3b2cSKamil Debski  * Returns the phy driver, after getting a refcount to it; or
3370b3f3b2cSKamil Debski  * -ENODEV if there is no such phy. The caller is responsible for
3380b3f3b2cSKamil Debski  * calling phy_put() to release that count.
3390b3f3b2cSKamil Debski  */
3400b3f3b2cSKamil Debski struct phy *of_phy_get(struct device_node *np, const char *con_id)
3410b3f3b2cSKamil Debski {
3420b3f3b2cSKamil Debski 	struct phy *phy = NULL;
3430b3f3b2cSKamil Debski 	int index = 0;
3440b3f3b2cSKamil Debski 
3450b3f3b2cSKamil Debski 	if (con_id)
3460b3f3b2cSKamil Debski 		index = of_property_match_string(np, "phy-names", con_id);
3470b3f3b2cSKamil Debski 
3480b3f3b2cSKamil Debski 	phy = _of_phy_get(np, index);
3490b3f3b2cSKamil Debski 	if (IS_ERR(phy))
3500b3f3b2cSKamil Debski 		return phy;
3510b3f3b2cSKamil Debski 
3520b3f3b2cSKamil Debski 	if (!try_module_get(phy->ops->owner))
3530b3f3b2cSKamil Debski 		return ERR_PTR(-EPROBE_DEFER);
3540b3f3b2cSKamil Debski 
3550b3f3b2cSKamil Debski 	get_device(&phy->dev);
3560b3f3b2cSKamil Debski 
3570b3f3b2cSKamil Debski 	return phy;
3580b3f3b2cSKamil Debski }
3590b3f3b2cSKamil Debski EXPORT_SYMBOL_GPL(of_phy_get);
3600b3f3b2cSKamil Debski 
3610b3f3b2cSKamil Debski /**
362ff764963SKishon Vijay Abraham I  * phy_put() - release the PHY
363ff764963SKishon Vijay Abraham I  * @phy: the phy returned by phy_get()
364ff764963SKishon Vijay Abraham I  *
365ff764963SKishon Vijay Abraham I  * Releases a refcount the caller received from phy_get().
366ff764963SKishon Vijay Abraham I  */
367ff764963SKishon Vijay Abraham I void phy_put(struct phy *phy)
368ff764963SKishon Vijay Abraham I {
36904c2facaSAndrew Lunn 	if (!phy || IS_ERR(phy))
370ff764963SKishon Vijay Abraham I 		return;
371ff764963SKishon Vijay Abraham I 
372ff764963SKishon Vijay Abraham I 	module_put(phy->ops->owner);
373ff764963SKishon Vijay Abraham I 	put_device(&phy->dev);
374ff764963SKishon Vijay Abraham I }
375ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(phy_put);
376ff764963SKishon Vijay Abraham I 
377ff764963SKishon Vijay Abraham I /**
378ff764963SKishon Vijay Abraham I  * devm_phy_put() - release the PHY
379ff764963SKishon Vijay Abraham I  * @dev: device that wants to release this phy
380ff764963SKishon Vijay Abraham I  * @phy: the phy returned by devm_phy_get()
381ff764963SKishon Vijay Abraham I  *
382ff764963SKishon Vijay Abraham I  * destroys the devres associated with this phy and invokes phy_put
383ff764963SKishon Vijay Abraham I  * to release the phy.
384ff764963SKishon Vijay Abraham I  */
385ff764963SKishon Vijay Abraham I void devm_phy_put(struct device *dev, struct phy *phy)
386ff764963SKishon Vijay Abraham I {
387ff764963SKishon Vijay Abraham I 	int r;
388ff764963SKishon Vijay Abraham I 
38904c2facaSAndrew Lunn 	if (!phy)
39004c2facaSAndrew Lunn 		return;
39104c2facaSAndrew Lunn 
392ff764963SKishon Vijay Abraham I 	r = devres_destroy(dev, devm_phy_release, devm_phy_match, phy);
393ff764963SKishon Vijay Abraham I 	dev_WARN_ONCE(dev, r, "couldn't find PHY resource\n");
394ff764963SKishon Vijay Abraham I }
395ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(devm_phy_put);
396ff764963SKishon Vijay Abraham I 
397ff764963SKishon Vijay Abraham I /**
398ff764963SKishon Vijay Abraham I  * of_phy_simple_xlate() - returns the phy instance from phy provider
399ff764963SKishon Vijay Abraham I  * @dev: the PHY provider device
400ff764963SKishon Vijay Abraham I  * @args: of_phandle_args (not used here)
401ff764963SKishon Vijay Abraham I  *
402ff764963SKishon Vijay Abraham I  * Intended to be used by phy provider for the common case where #phy-cells is
403ff764963SKishon Vijay Abraham I  * 0. For other cases where #phy-cells is greater than '0', the phy provider
404ff764963SKishon Vijay Abraham I  * should provide a custom of_xlate function that reads the *args* and returns
405ff764963SKishon Vijay Abraham I  * the appropriate phy.
406ff764963SKishon Vijay Abraham I  */
407ff764963SKishon Vijay Abraham I struct phy *of_phy_simple_xlate(struct device *dev, struct of_phandle_args
408ff764963SKishon Vijay Abraham I 	*args)
409ff764963SKishon Vijay Abraham I {
410ff764963SKishon Vijay Abraham I 	struct phy *phy;
411ff764963SKishon Vijay Abraham I 	struct class_dev_iter iter;
412ff764963SKishon Vijay Abraham I 	struct device_node *node = dev->of_node;
413ff764963SKishon Vijay Abraham I 
414ff764963SKishon Vijay Abraham I 	class_dev_iter_init(&iter, phy_class, NULL, NULL);
415ff764963SKishon Vijay Abraham I 	while ((dev = class_dev_iter_next(&iter))) {
416ff764963SKishon Vijay Abraham I 		phy = to_phy(dev);
417ff764963SKishon Vijay Abraham I 		if (node != phy->dev.of_node)
418ff764963SKishon Vijay Abraham I 			continue;
419ff764963SKishon Vijay Abraham I 
420ff764963SKishon Vijay Abraham I 		class_dev_iter_exit(&iter);
421ff764963SKishon Vijay Abraham I 		return phy;
422ff764963SKishon Vijay Abraham I 	}
423ff764963SKishon Vijay Abraham I 
424ff764963SKishon Vijay Abraham I 	class_dev_iter_exit(&iter);
425ff764963SKishon Vijay Abraham I 	return ERR_PTR(-ENODEV);
426ff764963SKishon Vijay Abraham I }
427ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(of_phy_simple_xlate);
428ff764963SKishon Vijay Abraham I 
429ff764963SKishon Vijay Abraham I /**
430ff764963SKishon Vijay Abraham I  * phy_get() - lookup and obtain a reference to a phy.
431ff764963SKishon Vijay Abraham I  * @dev: device that requests this phy
432ff764963SKishon Vijay Abraham I  * @string: the phy name as given in the dt data or the name of the controller
433ff764963SKishon Vijay Abraham I  * port for non-dt case
434ff764963SKishon Vijay Abraham I  *
435ff764963SKishon Vijay Abraham I  * Returns the phy driver, after getting a refcount to it; or
436ff764963SKishon Vijay Abraham I  * -ENODEV if there is no such phy.  The caller is responsible for
437ff764963SKishon Vijay Abraham I  * calling phy_put() to release that count.
438ff764963SKishon Vijay Abraham I  */
439ff764963SKishon Vijay Abraham I struct phy *phy_get(struct device *dev, const char *string)
440ff764963SKishon Vijay Abraham I {
441ff764963SKishon Vijay Abraham I 	int index = 0;
442d18c9604SKishon Vijay Abraham I 	struct phy *phy;
443ff764963SKishon Vijay Abraham I 
444ff764963SKishon Vijay Abraham I 	if (string == NULL) {
445ff764963SKishon Vijay Abraham I 		dev_WARN(dev, "missing string\n");
446ff764963SKishon Vijay Abraham I 		return ERR_PTR(-EINVAL);
447ff764963SKishon Vijay Abraham I 	}
448ff764963SKishon Vijay Abraham I 
449ff764963SKishon Vijay Abraham I 	if (dev->of_node) {
450ff764963SKishon Vijay Abraham I 		index = of_property_match_string(dev->of_node, "phy-names",
451ff764963SKishon Vijay Abraham I 			string);
4520b3f3b2cSKamil Debski 		phy = _of_phy_get(dev->of_node, index);
453ff764963SKishon Vijay Abraham I 	} else {
454ff764963SKishon Vijay Abraham I 		phy = phy_lookup(dev, string);
455f40037fdSHans de Goede 	}
456f40037fdSHans de Goede 	if (IS_ERR(phy))
457ff764963SKishon Vijay Abraham I 		return phy;
458ff764963SKishon Vijay Abraham I 
459ff764963SKishon Vijay Abraham I 	if (!try_module_get(phy->ops->owner))
460ff764963SKishon Vijay Abraham I 		return ERR_PTR(-EPROBE_DEFER);
461ff764963SKishon Vijay Abraham I 
462ff764963SKishon Vijay Abraham I 	get_device(&phy->dev);
463ff764963SKishon Vijay Abraham I 
464ff764963SKishon Vijay Abraham I 	return phy;
465ff764963SKishon Vijay Abraham I }
466ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(phy_get);
467ff764963SKishon Vijay Abraham I 
468ff764963SKishon Vijay Abraham I /**
469788a4d56SAndrew Lunn  * phy_optional_get() - lookup and obtain a reference to an optional phy.
470788a4d56SAndrew Lunn  * @dev: device that requests this phy
471788a4d56SAndrew Lunn  * @string: the phy name as given in the dt data or the name of the controller
472788a4d56SAndrew Lunn  * port for non-dt case
473788a4d56SAndrew Lunn  *
474788a4d56SAndrew Lunn  * Returns the phy driver, after getting a refcount to it; or
475788a4d56SAndrew Lunn  * NULL if there is no such phy.  The caller is responsible for
476788a4d56SAndrew Lunn  * calling phy_put() to release that count.
477788a4d56SAndrew Lunn  */
478788a4d56SAndrew Lunn struct phy *phy_optional_get(struct device *dev, const char *string)
479788a4d56SAndrew Lunn {
480788a4d56SAndrew Lunn 	struct phy *phy = phy_get(dev, string);
481788a4d56SAndrew Lunn 
482788a4d56SAndrew Lunn 	if (PTR_ERR(phy) == -ENODEV)
483788a4d56SAndrew Lunn 		phy = NULL;
484788a4d56SAndrew Lunn 
485788a4d56SAndrew Lunn 	return phy;
486788a4d56SAndrew Lunn }
487788a4d56SAndrew Lunn EXPORT_SYMBOL_GPL(phy_optional_get);
488788a4d56SAndrew Lunn 
489788a4d56SAndrew Lunn /**
490ff764963SKishon Vijay Abraham I  * devm_phy_get() - lookup and obtain a reference to a phy.
491ff764963SKishon Vijay Abraham I  * @dev: device that requests this phy
492ff764963SKishon Vijay Abraham I  * @string: the phy name as given in the dt data or phy device name
493ff764963SKishon Vijay Abraham I  * for non-dt case
494ff764963SKishon Vijay Abraham I  *
495ff764963SKishon Vijay Abraham I  * Gets the phy using phy_get(), and associates a device with it using
496ff764963SKishon Vijay Abraham I  * devres. On driver detach, release function is invoked on the devres data,
497ff764963SKishon Vijay Abraham I  * then, devres data is freed.
498ff764963SKishon Vijay Abraham I  */
499ff764963SKishon Vijay Abraham I struct phy *devm_phy_get(struct device *dev, const char *string)
500ff764963SKishon Vijay Abraham I {
501ff764963SKishon Vijay Abraham I 	struct phy **ptr, *phy;
502ff764963SKishon Vijay Abraham I 
503ff764963SKishon Vijay Abraham I 	ptr = devres_alloc(devm_phy_release, sizeof(*ptr), GFP_KERNEL);
504ff764963SKishon Vijay Abraham I 	if (!ptr)
505ff764963SKishon Vijay Abraham I 		return ERR_PTR(-ENOMEM);
506ff764963SKishon Vijay Abraham I 
507ff764963SKishon Vijay Abraham I 	phy = phy_get(dev, string);
508ff764963SKishon Vijay Abraham I 	if (!IS_ERR(phy)) {
509ff764963SKishon Vijay Abraham I 		*ptr = phy;
510ff764963SKishon Vijay Abraham I 		devres_add(dev, ptr);
511ff764963SKishon Vijay Abraham I 	} else {
512ff764963SKishon Vijay Abraham I 		devres_free(ptr);
513ff764963SKishon Vijay Abraham I 	}
514ff764963SKishon Vijay Abraham I 
515ff764963SKishon Vijay Abraham I 	return phy;
516ff764963SKishon Vijay Abraham I }
517ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(devm_phy_get);
518ff764963SKishon Vijay Abraham I 
519ff764963SKishon Vijay Abraham I /**
520788a4d56SAndrew Lunn  * devm_phy_optional_get() - lookup and obtain a reference to an optional phy.
521788a4d56SAndrew Lunn  * @dev: device that requests this phy
522788a4d56SAndrew Lunn  * @string: the phy name as given in the dt data or phy device name
523788a4d56SAndrew Lunn  * for non-dt case
524788a4d56SAndrew Lunn  *
525788a4d56SAndrew Lunn  * Gets the phy using phy_get(), and associates a device with it using
526788a4d56SAndrew Lunn  * devres. On driver detach, release function is invoked on the devres
527788a4d56SAndrew Lunn  * data, then, devres data is freed. This differs to devm_phy_get() in
528788a4d56SAndrew Lunn  * that if the phy does not exist, it is not considered an error and
529788a4d56SAndrew Lunn  * -ENODEV will not be returned. Instead the NULL phy is returned,
530788a4d56SAndrew Lunn  * which can be passed to all other phy consumer calls.
531788a4d56SAndrew Lunn  */
532788a4d56SAndrew Lunn struct phy *devm_phy_optional_get(struct device *dev, const char *string)
533788a4d56SAndrew Lunn {
534788a4d56SAndrew Lunn 	struct phy *phy = devm_phy_get(dev, string);
535788a4d56SAndrew Lunn 
536788a4d56SAndrew Lunn 	if (PTR_ERR(phy) == -ENODEV)
537788a4d56SAndrew Lunn 		phy = NULL;
538788a4d56SAndrew Lunn 
539788a4d56SAndrew Lunn 	return phy;
540788a4d56SAndrew Lunn }
541788a4d56SAndrew Lunn EXPORT_SYMBOL_GPL(devm_phy_optional_get);
542788a4d56SAndrew Lunn 
543788a4d56SAndrew Lunn /**
544b5d682f4SKamil Debski  * devm_of_phy_get() - lookup and obtain a reference to a phy.
545b5d682f4SKamil Debski  * @dev: device that requests this phy
546b5d682f4SKamil Debski  * @np: node containing the phy
547b5d682f4SKamil Debski  * @con_id: name of the phy from device's point of view
548b5d682f4SKamil Debski  *
549b5d682f4SKamil Debski  * Gets the phy using of_phy_get(), and associates a device with it using
550b5d682f4SKamil Debski  * devres. On driver detach, release function is invoked on the devres data,
551b5d682f4SKamil Debski  * then, devres data is freed.
552b5d682f4SKamil Debski  */
553b5d682f4SKamil Debski struct phy *devm_of_phy_get(struct device *dev, struct device_node *np,
554b5d682f4SKamil Debski 			    const char *con_id)
555b5d682f4SKamil Debski {
556b5d682f4SKamil Debski 	struct phy **ptr, *phy;
557b5d682f4SKamil Debski 
558b5d682f4SKamil Debski 	ptr = devres_alloc(devm_phy_release, sizeof(*ptr), GFP_KERNEL);
559b5d682f4SKamil Debski 	if (!ptr)
560b5d682f4SKamil Debski 		return ERR_PTR(-ENOMEM);
561b5d682f4SKamil Debski 
562b5d682f4SKamil Debski 	phy = of_phy_get(np, con_id);
563b5d682f4SKamil Debski 	if (!IS_ERR(phy)) {
564b5d682f4SKamil Debski 		*ptr = phy;
565b5d682f4SKamil Debski 		devres_add(dev, ptr);
566b5d682f4SKamil Debski 	} else {
567b5d682f4SKamil Debski 		devres_free(ptr);
568b5d682f4SKamil Debski 	}
569b5d682f4SKamil Debski 
570b5d682f4SKamil Debski 	return phy;
571b5d682f4SKamil Debski }
572b5d682f4SKamil Debski EXPORT_SYMBOL_GPL(devm_of_phy_get);
573b5d682f4SKamil Debski 
574b5d682f4SKamil Debski /**
575ff764963SKishon Vijay Abraham I  * phy_create() - create a new phy
576ff764963SKishon Vijay Abraham I  * @dev: device that is creating the new phy
577ff764963SKishon Vijay Abraham I  * @ops: function pointers for performing phy operations
578ff764963SKishon Vijay Abraham I  * @init_data: contains the list of PHY consumers or NULL
579ff764963SKishon Vijay Abraham I  *
580ff764963SKishon Vijay Abraham I  * Called to create a phy using phy framework.
581ff764963SKishon Vijay Abraham I  */
582ff764963SKishon Vijay Abraham I struct phy *phy_create(struct device *dev, const struct phy_ops *ops,
583ff764963SKishon Vijay Abraham I 	struct phy_init_data *init_data)
584ff764963SKishon Vijay Abraham I {
585ff764963SKishon Vijay Abraham I 	int ret;
586ff764963SKishon Vijay Abraham I 	int id;
587ff764963SKishon Vijay Abraham I 	struct phy *phy;
588ff764963SKishon Vijay Abraham I 
58952797d29SDan Carpenter 	if (WARN_ON(!dev))
59052797d29SDan Carpenter 		return ERR_PTR(-EINVAL);
591ff764963SKishon Vijay Abraham I 
592ff764963SKishon Vijay Abraham I 	phy = kzalloc(sizeof(*phy), GFP_KERNEL);
59352797d29SDan Carpenter 	if (!phy)
59452797d29SDan Carpenter 		return ERR_PTR(-ENOMEM);
595ff764963SKishon Vijay Abraham I 
596ff764963SKishon Vijay Abraham I 	id = ida_simple_get(&phy_ida, 0, 0, GFP_KERNEL);
597ff764963SKishon Vijay Abraham I 	if (id < 0) {
598ff764963SKishon Vijay Abraham I 		dev_err(dev, "unable to get id\n");
599ff764963SKishon Vijay Abraham I 		ret = id;
60052797d29SDan Carpenter 		goto free_phy;
601ff764963SKishon Vijay Abraham I 	}
602ff764963SKishon Vijay Abraham I 
603*3be88125SRoger Quadros 	/* phy-supply */
604*3be88125SRoger Quadros 	phy->pwr = regulator_get_optional(dev, "phy");
605*3be88125SRoger Quadros 	if (IS_ERR(phy->pwr)) {
606*3be88125SRoger Quadros 		if (PTR_ERR(phy->pwr) == -EPROBE_DEFER) {
607*3be88125SRoger Quadros 			ret = -EPROBE_DEFER;
608*3be88125SRoger Quadros 			goto free_ida;
609*3be88125SRoger Quadros 		}
610*3be88125SRoger Quadros 		phy->pwr = NULL;
611*3be88125SRoger Quadros 	}
612*3be88125SRoger Quadros 
613ff764963SKishon Vijay Abraham I 	device_initialize(&phy->dev);
614ff764963SKishon Vijay Abraham I 	mutex_init(&phy->mutex);
615ff764963SKishon Vijay Abraham I 
616ff764963SKishon Vijay Abraham I 	phy->dev.class = phy_class;
617ff764963SKishon Vijay Abraham I 	phy->dev.parent = dev;
618ff764963SKishon Vijay Abraham I 	phy->dev.of_node = dev->of_node;
619ff764963SKishon Vijay Abraham I 	phy->id = id;
620ff764963SKishon Vijay Abraham I 	phy->ops = ops;
621ff764963SKishon Vijay Abraham I 	phy->init_data = init_data;
622ff764963SKishon Vijay Abraham I 
623ff764963SKishon Vijay Abraham I 	ret = dev_set_name(&phy->dev, "phy-%s.%d", dev_name(dev), id);
624ff764963SKishon Vijay Abraham I 	if (ret)
62552797d29SDan Carpenter 		goto put_dev;
626ff764963SKishon Vijay Abraham I 
627ff764963SKishon Vijay Abraham I 	ret = device_add(&phy->dev);
628ff764963SKishon Vijay Abraham I 	if (ret)
62952797d29SDan Carpenter 		goto put_dev;
630ff764963SKishon Vijay Abraham I 
631ff764963SKishon Vijay Abraham I 	if (pm_runtime_enabled(dev)) {
632ff764963SKishon Vijay Abraham I 		pm_runtime_enable(&phy->dev);
633ff764963SKishon Vijay Abraham I 		pm_runtime_no_callbacks(&phy->dev);
634ff764963SKishon Vijay Abraham I 	}
635ff764963SKishon Vijay Abraham I 
636ff764963SKishon Vijay Abraham I 	return phy;
637ff764963SKishon Vijay Abraham I 
63852797d29SDan Carpenter put_dev:
639e73b49f1SRoger Quadros 	put_device(&phy->dev);  /* calls phy_release() which frees resources */
640e73b49f1SRoger Quadros 	return ERR_PTR(ret);
641e73b49f1SRoger Quadros 
642*3be88125SRoger Quadros free_ida:
643*3be88125SRoger Quadros 	ida_simple_remove(&phy_ida, phy->id);
644*3be88125SRoger Quadros 
64552797d29SDan Carpenter free_phy:
646ff764963SKishon Vijay Abraham I 	kfree(phy);
647ff764963SKishon Vijay Abraham I 	return ERR_PTR(ret);
648ff764963SKishon Vijay Abraham I }
649ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(phy_create);
650ff764963SKishon Vijay Abraham I 
651ff764963SKishon Vijay Abraham I /**
652ff764963SKishon Vijay Abraham I  * devm_phy_create() - create a new phy
653ff764963SKishon Vijay Abraham I  * @dev: device that is creating the new phy
654ff764963SKishon Vijay Abraham I  * @ops: function pointers for performing phy operations
655ff764963SKishon Vijay Abraham I  * @init_data: contains the list of PHY consumers or NULL
656ff764963SKishon Vijay Abraham I  *
657ff764963SKishon Vijay Abraham I  * Creates a new PHY device adding it to the PHY class.
658ff764963SKishon Vijay Abraham I  * While at that, it also associates the device with the phy using devres.
659ff764963SKishon Vijay Abraham I  * On driver detach, release function is invoked on the devres data,
660ff764963SKishon Vijay Abraham I  * then, devres data is freed.
661ff764963SKishon Vijay Abraham I  */
662ff764963SKishon Vijay Abraham I struct phy *devm_phy_create(struct device *dev, const struct phy_ops *ops,
663ff764963SKishon Vijay Abraham I 	struct phy_init_data *init_data)
664ff764963SKishon Vijay Abraham I {
665ff764963SKishon Vijay Abraham I 	struct phy **ptr, *phy;
666ff764963SKishon Vijay Abraham I 
667ff764963SKishon Vijay Abraham I 	ptr = devres_alloc(devm_phy_consume, sizeof(*ptr), GFP_KERNEL);
668ff764963SKishon Vijay Abraham I 	if (!ptr)
669ff764963SKishon Vijay Abraham I 		return ERR_PTR(-ENOMEM);
670ff764963SKishon Vijay Abraham I 
671ff764963SKishon Vijay Abraham I 	phy = phy_create(dev, ops, init_data);
672ff764963SKishon Vijay Abraham I 	if (!IS_ERR(phy)) {
673ff764963SKishon Vijay Abraham I 		*ptr = phy;
674ff764963SKishon Vijay Abraham I 		devres_add(dev, ptr);
675ff764963SKishon Vijay Abraham I 	} else {
676ff764963SKishon Vijay Abraham I 		devres_free(ptr);
677ff764963SKishon Vijay Abraham I 	}
678ff764963SKishon Vijay Abraham I 
679ff764963SKishon Vijay Abraham I 	return phy;
680ff764963SKishon Vijay Abraham I }
681ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(devm_phy_create);
682ff764963SKishon Vijay Abraham I 
683ff764963SKishon Vijay Abraham I /**
684ff764963SKishon Vijay Abraham I  * phy_destroy() - destroy the phy
685ff764963SKishon Vijay Abraham I  * @phy: the phy to be destroyed
686ff764963SKishon Vijay Abraham I  *
687ff764963SKishon Vijay Abraham I  * Called to destroy the phy.
688ff764963SKishon Vijay Abraham I  */
689ff764963SKishon Vijay Abraham I void phy_destroy(struct phy *phy)
690ff764963SKishon Vijay Abraham I {
691ff764963SKishon Vijay Abraham I 	pm_runtime_disable(&phy->dev);
692ff764963SKishon Vijay Abraham I 	device_unregister(&phy->dev);
693ff764963SKishon Vijay Abraham I }
694ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(phy_destroy);
695ff764963SKishon Vijay Abraham I 
696ff764963SKishon Vijay Abraham I /**
697ff764963SKishon Vijay Abraham I  * devm_phy_destroy() - destroy the PHY
698ff764963SKishon Vijay Abraham I  * @dev: device that wants to release this phy
699ff764963SKishon Vijay Abraham I  * @phy: the phy returned by devm_phy_get()
700ff764963SKishon Vijay Abraham I  *
701ff764963SKishon Vijay Abraham I  * destroys the devres associated with this phy and invokes phy_destroy
702ff764963SKishon Vijay Abraham I  * to destroy the phy.
703ff764963SKishon Vijay Abraham I  */
704ff764963SKishon Vijay Abraham I void devm_phy_destroy(struct device *dev, struct phy *phy)
705ff764963SKishon Vijay Abraham I {
706ff764963SKishon Vijay Abraham I 	int r;
707ff764963SKishon Vijay Abraham I 
708ff764963SKishon Vijay Abraham I 	r = devres_destroy(dev, devm_phy_consume, devm_phy_match, phy);
709ff764963SKishon Vijay Abraham I 	dev_WARN_ONCE(dev, r, "couldn't find PHY resource\n");
710ff764963SKishon Vijay Abraham I }
711ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(devm_phy_destroy);
712ff764963SKishon Vijay Abraham I 
713ff764963SKishon Vijay Abraham I /**
714ff764963SKishon Vijay Abraham I  * __of_phy_provider_register() - create/register phy provider with the framework
715ff764963SKishon Vijay Abraham I  * @dev: struct device of the phy provider
716ff764963SKishon Vijay Abraham I  * @owner: the module owner containing of_xlate
717ff764963SKishon Vijay Abraham I  * @of_xlate: function pointer to obtain phy instance from phy provider
718ff764963SKishon Vijay Abraham I  *
719ff764963SKishon Vijay Abraham I  * Creates struct phy_provider from dev and of_xlate function pointer.
720ff764963SKishon Vijay Abraham I  * This is used in the case of dt boot for finding the phy instance from
721ff764963SKishon Vijay Abraham I  * phy provider.
722ff764963SKishon Vijay Abraham I  */
723ff764963SKishon Vijay Abraham I struct phy_provider *__of_phy_provider_register(struct device *dev,
724ff764963SKishon Vijay Abraham I 	struct module *owner, struct phy * (*of_xlate)(struct device *dev,
725ff764963SKishon Vijay Abraham I 	struct of_phandle_args *args))
726ff764963SKishon Vijay Abraham I {
727ff764963SKishon Vijay Abraham I 	struct phy_provider *phy_provider;
728ff764963SKishon Vijay Abraham I 
729ff764963SKishon Vijay Abraham I 	phy_provider = kzalloc(sizeof(*phy_provider), GFP_KERNEL);
730ff764963SKishon Vijay Abraham I 	if (!phy_provider)
731ff764963SKishon Vijay Abraham I 		return ERR_PTR(-ENOMEM);
732ff764963SKishon Vijay Abraham I 
733ff764963SKishon Vijay Abraham I 	phy_provider->dev = dev;
734ff764963SKishon Vijay Abraham I 	phy_provider->owner = owner;
735ff764963SKishon Vijay Abraham I 	phy_provider->of_xlate = of_xlate;
736ff764963SKishon Vijay Abraham I 
737ff764963SKishon Vijay Abraham I 	mutex_lock(&phy_provider_mutex);
738ff764963SKishon Vijay Abraham I 	list_add_tail(&phy_provider->list, &phy_provider_list);
739ff764963SKishon Vijay Abraham I 	mutex_unlock(&phy_provider_mutex);
740ff764963SKishon Vijay Abraham I 
741ff764963SKishon Vijay Abraham I 	return phy_provider;
742ff764963SKishon Vijay Abraham I }
743ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(__of_phy_provider_register);
744ff764963SKishon Vijay Abraham I 
745ff764963SKishon Vijay Abraham I /**
746ff764963SKishon Vijay Abraham I  * __devm_of_phy_provider_register() - create/register phy provider with the
747ff764963SKishon Vijay Abraham I  * framework
748ff764963SKishon Vijay Abraham I  * @dev: struct device of the phy provider
749ff764963SKishon Vijay Abraham I  * @owner: the module owner containing of_xlate
750ff764963SKishon Vijay Abraham I  * @of_xlate: function pointer to obtain phy instance from phy provider
751ff764963SKishon Vijay Abraham I  *
752ff764963SKishon Vijay Abraham I  * Creates struct phy_provider from dev and of_xlate function pointer.
753ff764963SKishon Vijay Abraham I  * This is used in the case of dt boot for finding the phy instance from
754ff764963SKishon Vijay Abraham I  * phy provider. While at that, it also associates the device with the
755ff764963SKishon Vijay Abraham I  * phy provider using devres. On driver detach, release function is invoked
756ff764963SKishon Vijay Abraham I  * on the devres data, then, devres data is freed.
757ff764963SKishon Vijay Abraham I  */
758ff764963SKishon Vijay Abraham I struct phy_provider *__devm_of_phy_provider_register(struct device *dev,
759ff764963SKishon Vijay Abraham I 	struct module *owner, struct phy * (*of_xlate)(struct device *dev,
760ff764963SKishon Vijay Abraham I 	struct of_phandle_args *args))
761ff764963SKishon Vijay Abraham I {
762ff764963SKishon Vijay Abraham I 	struct phy_provider **ptr, *phy_provider;
763ff764963SKishon Vijay Abraham I 
764ff764963SKishon Vijay Abraham I 	ptr = devres_alloc(devm_phy_provider_release, sizeof(*ptr), GFP_KERNEL);
765ff764963SKishon Vijay Abraham I 	if (!ptr)
766ff764963SKishon Vijay Abraham I 		return ERR_PTR(-ENOMEM);
767ff764963SKishon Vijay Abraham I 
768ff764963SKishon Vijay Abraham I 	phy_provider = __of_phy_provider_register(dev, owner, of_xlate);
769ff764963SKishon Vijay Abraham I 	if (!IS_ERR(phy_provider)) {
770ff764963SKishon Vijay Abraham I 		*ptr = phy_provider;
771ff764963SKishon Vijay Abraham I 		devres_add(dev, ptr);
772ff764963SKishon Vijay Abraham I 	} else {
773ff764963SKishon Vijay Abraham I 		devres_free(ptr);
774ff764963SKishon Vijay Abraham I 	}
775ff764963SKishon Vijay Abraham I 
776ff764963SKishon Vijay Abraham I 	return phy_provider;
777ff764963SKishon Vijay Abraham I }
778ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(__devm_of_phy_provider_register);
779ff764963SKishon Vijay Abraham I 
780ff764963SKishon Vijay Abraham I /**
781ff764963SKishon Vijay Abraham I  * of_phy_provider_unregister() - unregister phy provider from the framework
782ff764963SKishon Vijay Abraham I  * @phy_provider: phy provider returned by of_phy_provider_register()
783ff764963SKishon Vijay Abraham I  *
784ff764963SKishon Vijay Abraham I  * Removes the phy_provider created using of_phy_provider_register().
785ff764963SKishon Vijay Abraham I  */
786ff764963SKishon Vijay Abraham I void of_phy_provider_unregister(struct phy_provider *phy_provider)
787ff764963SKishon Vijay Abraham I {
788ff764963SKishon Vijay Abraham I 	if (IS_ERR(phy_provider))
789ff764963SKishon Vijay Abraham I 		return;
790ff764963SKishon Vijay Abraham I 
791ff764963SKishon Vijay Abraham I 	mutex_lock(&phy_provider_mutex);
792ff764963SKishon Vijay Abraham I 	list_del(&phy_provider->list);
793ff764963SKishon Vijay Abraham I 	kfree(phy_provider);
794ff764963SKishon Vijay Abraham I 	mutex_unlock(&phy_provider_mutex);
795ff764963SKishon Vijay Abraham I }
796ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(of_phy_provider_unregister);
797ff764963SKishon Vijay Abraham I 
798ff764963SKishon Vijay Abraham I /**
799ff764963SKishon Vijay Abraham I  * devm_of_phy_provider_unregister() - remove phy provider from the framework
800ff764963SKishon Vijay Abraham I  * @dev: struct device of the phy provider
801ff764963SKishon Vijay Abraham I  *
802ff764963SKishon Vijay Abraham I  * destroys the devres associated with this phy provider and invokes
803ff764963SKishon Vijay Abraham I  * of_phy_provider_unregister to unregister the phy provider.
804ff764963SKishon Vijay Abraham I  */
805ff764963SKishon Vijay Abraham I void devm_of_phy_provider_unregister(struct device *dev,
806ff764963SKishon Vijay Abraham I 	struct phy_provider *phy_provider) {
807ff764963SKishon Vijay Abraham I 	int r;
808ff764963SKishon Vijay Abraham I 
809ff764963SKishon Vijay Abraham I 	r = devres_destroy(dev, devm_phy_provider_release, devm_phy_match,
810ff764963SKishon Vijay Abraham I 		phy_provider);
811ff764963SKishon Vijay Abraham I 	dev_WARN_ONCE(dev, r, "couldn't find PHY provider device resource\n");
812ff764963SKishon Vijay Abraham I }
813ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(devm_of_phy_provider_unregister);
814ff764963SKishon Vijay Abraham I 
815ff764963SKishon Vijay Abraham I /**
816ff764963SKishon Vijay Abraham I  * phy_release() - release the phy
817ff764963SKishon Vijay Abraham I  * @dev: the dev member within phy
818ff764963SKishon Vijay Abraham I  *
819ff764963SKishon Vijay Abraham I  * When the last reference to the device is removed, it is called
820ff764963SKishon Vijay Abraham I  * from the embedded kobject as release method.
821ff764963SKishon Vijay Abraham I  */
822ff764963SKishon Vijay Abraham I static void phy_release(struct device *dev)
823ff764963SKishon Vijay Abraham I {
824ff764963SKishon Vijay Abraham I 	struct phy *phy;
825ff764963SKishon Vijay Abraham I 
826ff764963SKishon Vijay Abraham I 	phy = to_phy(dev);
827ff764963SKishon Vijay Abraham I 	dev_vdbg(dev, "releasing '%s'\n", dev_name(dev));
828*3be88125SRoger Quadros 	regulator_put(phy->pwr);
829e73b49f1SRoger Quadros 	ida_simple_remove(&phy_ida, phy->id);
830ff764963SKishon Vijay Abraham I 	kfree(phy);
831ff764963SKishon Vijay Abraham I }
832ff764963SKishon Vijay Abraham I 
833ff764963SKishon Vijay Abraham I static int __init phy_core_init(void)
834ff764963SKishon Vijay Abraham I {
835ff764963SKishon Vijay Abraham I 	phy_class = class_create(THIS_MODULE, "phy");
836ff764963SKishon Vijay Abraham I 	if (IS_ERR(phy_class)) {
837ff764963SKishon Vijay Abraham I 		pr_err("failed to create phy class --> %ld\n",
838ff764963SKishon Vijay Abraham I 			PTR_ERR(phy_class));
839ff764963SKishon Vijay Abraham I 		return PTR_ERR(phy_class);
840ff764963SKishon Vijay Abraham I 	}
841ff764963SKishon Vijay Abraham I 
842ff764963SKishon Vijay Abraham I 	phy_class->dev_release = phy_release;
843ff764963SKishon Vijay Abraham I 
844ff764963SKishon Vijay Abraham I 	return 0;
845ff764963SKishon Vijay Abraham I }
846ff764963SKishon Vijay Abraham I module_init(phy_core_init);
847ff764963SKishon Vijay Abraham I 
848ff764963SKishon Vijay Abraham I static void __exit phy_core_exit(void)
849ff764963SKishon Vijay Abraham I {
850ff764963SKishon Vijay Abraham I 	class_destroy(phy_class);
851ff764963SKishon Vijay Abraham I }
852ff764963SKishon Vijay Abraham I module_exit(phy_core_exit);
853ff764963SKishon Vijay Abraham I 
854ff764963SKishon Vijay Abraham I MODULE_DESCRIPTION("Generic PHY Framework");
855ff764963SKishon Vijay Abraham I MODULE_AUTHOR("Kishon Vijay Abraham I <kishon@ti.com>");
856ff764963SKishon Vijay Abraham I MODULE_LICENSE("GPL v2");
857