xref: /openbmc/linux/drivers/phy/phy-core.c (revision f0ed817638b59aa927f1f7e9564dd8796b18dc4f)
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>
243be88125SRoger 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;
902a4c3701SKishon Vijay Abraham I 	struct device_node *child;
91ff764963SKishon Vijay Abraham I 
92ff764963SKishon Vijay Abraham I 	list_for_each_entry(phy_provider, &phy_provider_list, list) {
93ff764963SKishon Vijay Abraham I 		if (phy_provider->dev->of_node == node)
94ff764963SKishon Vijay Abraham I 			return phy_provider;
952a4c3701SKishon Vijay Abraham I 
962a4c3701SKishon Vijay Abraham I 		for_each_child_of_node(phy_provider->dev->of_node, child)
972a4c3701SKishon Vijay Abraham I 			if (child == node)
982a4c3701SKishon Vijay Abraham I 				return phy_provider;
99ff764963SKishon Vijay Abraham I 	}
100ff764963SKishon Vijay Abraham I 
101ff764963SKishon Vijay Abraham I 	return ERR_PTR(-EPROBE_DEFER);
102ff764963SKishon Vijay Abraham I }
103ff764963SKishon Vijay Abraham I 
104ff764963SKishon Vijay Abraham I int phy_pm_runtime_get(struct phy *phy)
105ff764963SKishon Vijay Abraham I {
106cedb7f89SFelipe Balbi 	int ret;
107cedb7f89SFelipe Balbi 
108ff764963SKishon Vijay Abraham I 	if (!pm_runtime_enabled(&phy->dev))
109ff764963SKishon Vijay Abraham I 		return -ENOTSUPP;
110ff764963SKishon Vijay Abraham I 
111cedb7f89SFelipe Balbi 	ret = pm_runtime_get(&phy->dev);
112cedb7f89SFelipe Balbi 	if (ret < 0 && ret != -EINPROGRESS)
113cedb7f89SFelipe Balbi 		pm_runtime_put_noidle(&phy->dev);
114cedb7f89SFelipe Balbi 
115cedb7f89SFelipe Balbi 	return ret;
116ff764963SKishon Vijay Abraham I }
117ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(phy_pm_runtime_get);
118ff764963SKishon Vijay Abraham I 
119ff764963SKishon Vijay Abraham I int phy_pm_runtime_get_sync(struct phy *phy)
120ff764963SKishon Vijay Abraham I {
121cedb7f89SFelipe Balbi 	int ret;
122cedb7f89SFelipe Balbi 
123ff764963SKishon Vijay Abraham I 	if (!pm_runtime_enabled(&phy->dev))
124ff764963SKishon Vijay Abraham I 		return -ENOTSUPP;
125ff764963SKishon Vijay Abraham I 
126cedb7f89SFelipe Balbi 	ret = pm_runtime_get_sync(&phy->dev);
127cedb7f89SFelipe Balbi 	if (ret < 0)
128cedb7f89SFelipe Balbi 		pm_runtime_put_sync(&phy->dev);
129cedb7f89SFelipe Balbi 
130cedb7f89SFelipe Balbi 	return ret;
131ff764963SKishon Vijay Abraham I }
132ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(phy_pm_runtime_get_sync);
133ff764963SKishon Vijay Abraham I 
134ff764963SKishon Vijay Abraham I int phy_pm_runtime_put(struct phy *phy)
135ff764963SKishon Vijay Abraham I {
136ff764963SKishon Vijay Abraham I 	if (!pm_runtime_enabled(&phy->dev))
137ff764963SKishon Vijay Abraham I 		return -ENOTSUPP;
138ff764963SKishon Vijay Abraham I 
139ff764963SKishon Vijay Abraham I 	return pm_runtime_put(&phy->dev);
140ff764963SKishon Vijay Abraham I }
141ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(phy_pm_runtime_put);
142ff764963SKishon Vijay Abraham I 
143ff764963SKishon Vijay Abraham I int phy_pm_runtime_put_sync(struct phy *phy)
144ff764963SKishon Vijay Abraham I {
145ff764963SKishon Vijay Abraham I 	if (!pm_runtime_enabled(&phy->dev))
146ff764963SKishon Vijay Abraham I 		return -ENOTSUPP;
147ff764963SKishon Vijay Abraham I 
148ff764963SKishon Vijay Abraham I 	return pm_runtime_put_sync(&phy->dev);
149ff764963SKishon Vijay Abraham I }
150ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(phy_pm_runtime_put_sync);
151ff764963SKishon Vijay Abraham I 
152ff764963SKishon Vijay Abraham I void phy_pm_runtime_allow(struct phy *phy)
153ff764963SKishon Vijay Abraham I {
154ff764963SKishon Vijay Abraham I 	if (!pm_runtime_enabled(&phy->dev))
155ff764963SKishon Vijay Abraham I 		return;
156ff764963SKishon Vijay Abraham I 
157ff764963SKishon Vijay Abraham I 	pm_runtime_allow(&phy->dev);
158ff764963SKishon Vijay Abraham I }
159ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(phy_pm_runtime_allow);
160ff764963SKishon Vijay Abraham I 
161ff764963SKishon Vijay Abraham I void phy_pm_runtime_forbid(struct phy *phy)
162ff764963SKishon Vijay Abraham I {
163ff764963SKishon Vijay Abraham I 	if (!pm_runtime_enabled(&phy->dev))
164ff764963SKishon Vijay Abraham I 		return;
165ff764963SKishon Vijay Abraham I 
166ff764963SKishon Vijay Abraham I 	pm_runtime_forbid(&phy->dev);
167ff764963SKishon Vijay Abraham I }
168ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(phy_pm_runtime_forbid);
169ff764963SKishon Vijay Abraham I 
170ff764963SKishon Vijay Abraham I int phy_init(struct phy *phy)
171ff764963SKishon Vijay Abraham I {
172ff764963SKishon Vijay Abraham I 	int ret;
173ff764963SKishon Vijay Abraham I 
17404c2facaSAndrew Lunn 	if (!phy)
17504c2facaSAndrew Lunn 		return 0;
17604c2facaSAndrew Lunn 
177ff764963SKishon Vijay Abraham I 	ret = phy_pm_runtime_get_sync(phy);
178ff764963SKishon Vijay Abraham I 	if (ret < 0 && ret != -ENOTSUPP)
179ff764963SKishon Vijay Abraham I 		return ret;
180ff764963SKishon Vijay Abraham I 
181ff764963SKishon Vijay Abraham I 	mutex_lock(&phy->mutex);
182637d378cSKishon Vijay Abraham I 	if (phy->init_count == 0 && phy->ops->init) {
183ff764963SKishon Vijay Abraham I 		ret = phy->ops->init(phy);
184ff764963SKishon Vijay Abraham I 		if (ret < 0) {
185ff764963SKishon Vijay Abraham I 			dev_err(&phy->dev, "phy init failed --> %d\n", ret);
186ff764963SKishon Vijay Abraham I 			goto out;
187ff764963SKishon Vijay Abraham I 		}
188767a1b5dSHans de Goede 	} else {
189767a1b5dSHans de Goede 		ret = 0; /* Override possible ret == -ENOTSUPP */
190ff764963SKishon Vijay Abraham I 	}
191637d378cSKishon Vijay Abraham I 	++phy->init_count;
192ff764963SKishon Vijay Abraham I 
193ff764963SKishon Vijay Abraham I out:
194ff764963SKishon Vijay Abraham I 	mutex_unlock(&phy->mutex);
195ff764963SKishon Vijay Abraham I 	phy_pm_runtime_put(phy);
196ff764963SKishon Vijay Abraham I 	return ret;
197ff764963SKishon Vijay Abraham I }
198ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(phy_init);
199ff764963SKishon Vijay Abraham I 
200ff764963SKishon Vijay Abraham I int phy_exit(struct phy *phy)
201ff764963SKishon Vijay Abraham I {
202ff764963SKishon Vijay Abraham I 	int ret;
203ff764963SKishon Vijay Abraham I 
20404c2facaSAndrew Lunn 	if (!phy)
20504c2facaSAndrew Lunn 		return 0;
20604c2facaSAndrew Lunn 
207ff764963SKishon Vijay Abraham I 	ret = phy_pm_runtime_get_sync(phy);
208ff764963SKishon Vijay Abraham I 	if (ret < 0 && ret != -ENOTSUPP)
209ff764963SKishon Vijay Abraham I 		return ret;
210ff764963SKishon Vijay Abraham I 
211ff764963SKishon Vijay Abraham I 	mutex_lock(&phy->mutex);
212637d378cSKishon Vijay Abraham I 	if (phy->init_count == 1 && phy->ops->exit) {
213ff764963SKishon Vijay Abraham I 		ret = phy->ops->exit(phy);
214ff764963SKishon Vijay Abraham I 		if (ret < 0) {
215ff764963SKishon Vijay Abraham I 			dev_err(&phy->dev, "phy exit failed --> %d\n", ret);
216ff764963SKishon Vijay Abraham I 			goto out;
217ff764963SKishon Vijay Abraham I 		}
218ff764963SKishon Vijay Abraham I 	}
219637d378cSKishon Vijay Abraham I 	--phy->init_count;
220ff764963SKishon Vijay Abraham I 
221ff764963SKishon Vijay Abraham I out:
222ff764963SKishon Vijay Abraham I 	mutex_unlock(&phy->mutex);
223ff764963SKishon Vijay Abraham I 	phy_pm_runtime_put(phy);
224ff764963SKishon Vijay Abraham I 	return ret;
225ff764963SKishon Vijay Abraham I }
226ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(phy_exit);
227ff764963SKishon Vijay Abraham I 
228ff764963SKishon Vijay Abraham I int phy_power_on(struct phy *phy)
229ff764963SKishon Vijay Abraham I {
230d18c9604SKishon Vijay Abraham I 	int ret;
231ff764963SKishon Vijay Abraham I 
23204c2facaSAndrew Lunn 	if (!phy)
23304c2facaSAndrew Lunn 		return 0;
23404c2facaSAndrew Lunn 
2353be88125SRoger Quadros 	if (phy->pwr) {
2363be88125SRoger Quadros 		ret = regulator_enable(phy->pwr);
2373be88125SRoger Quadros 		if (ret)
2383be88125SRoger Quadros 			return ret;
2393be88125SRoger Quadros 	}
2403be88125SRoger Quadros 
241ff764963SKishon Vijay Abraham I 	ret = phy_pm_runtime_get_sync(phy);
242ff764963SKishon Vijay Abraham I 	if (ret < 0 && ret != -ENOTSUPP)
243ff764963SKishon Vijay Abraham I 		return ret;
244ff764963SKishon Vijay Abraham I 
245ff764963SKishon Vijay Abraham I 	mutex_lock(&phy->mutex);
246637d378cSKishon Vijay Abraham I 	if (phy->power_count == 0 && phy->ops->power_on) {
247ff764963SKishon Vijay Abraham I 		ret = phy->ops->power_on(phy);
248ff764963SKishon Vijay Abraham I 		if (ret < 0) {
249ff764963SKishon Vijay Abraham I 			dev_err(&phy->dev, "phy poweron failed --> %d\n", ret);
250ff764963SKishon Vijay Abraham I 			goto out;
251ff764963SKishon Vijay Abraham I 		}
252767a1b5dSHans de Goede 	} else {
253767a1b5dSHans de Goede 		ret = 0; /* Override possible ret == -ENOTSUPP */
254ff764963SKishon Vijay Abraham I 	}
255637d378cSKishon Vijay Abraham I 	++phy->power_count;
256637d378cSKishon Vijay Abraham I 	mutex_unlock(&phy->mutex);
257637d378cSKishon Vijay Abraham I 	return 0;
258ff764963SKishon Vijay Abraham I 
259ff764963SKishon Vijay Abraham I out:
260ff764963SKishon Vijay Abraham I 	mutex_unlock(&phy->mutex);
261637d378cSKishon Vijay Abraham I 	phy_pm_runtime_put_sync(phy);
2623be88125SRoger Quadros 	if (phy->pwr)
2633be88125SRoger Quadros 		regulator_disable(phy->pwr);
264ff764963SKishon Vijay Abraham I 
265ff764963SKishon Vijay Abraham I 	return ret;
266ff764963SKishon Vijay Abraham I }
267ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(phy_power_on);
268ff764963SKishon Vijay Abraham I 
269ff764963SKishon Vijay Abraham I int phy_power_off(struct phy *phy)
270ff764963SKishon Vijay Abraham I {
271d18c9604SKishon Vijay Abraham I 	int ret;
272ff764963SKishon Vijay Abraham I 
27304c2facaSAndrew Lunn 	if (!phy)
27404c2facaSAndrew Lunn 		return 0;
27504c2facaSAndrew Lunn 
276ff764963SKishon Vijay Abraham I 	mutex_lock(&phy->mutex);
277637d378cSKishon Vijay Abraham I 	if (phy->power_count == 1 && phy->ops->power_off) {
278ff764963SKishon Vijay Abraham I 		ret =  phy->ops->power_off(phy);
279ff764963SKishon Vijay Abraham I 		if (ret < 0) {
280ff764963SKishon Vijay Abraham I 			dev_err(&phy->dev, "phy poweroff failed --> %d\n", ret);
281637d378cSKishon Vijay Abraham I 			mutex_unlock(&phy->mutex);
282637d378cSKishon Vijay Abraham I 			return ret;
283ff764963SKishon Vijay Abraham I 		}
284ff764963SKishon Vijay Abraham I 	}
285637d378cSKishon Vijay Abraham I 	--phy->power_count;
286ff764963SKishon Vijay Abraham I 	mutex_unlock(&phy->mutex);
287ff764963SKishon Vijay Abraham I 	phy_pm_runtime_put(phy);
288ff764963SKishon Vijay Abraham I 
2893be88125SRoger Quadros 	if (phy->pwr)
2903be88125SRoger Quadros 		regulator_disable(phy->pwr);
2913be88125SRoger Quadros 
292637d378cSKishon Vijay Abraham I 	return 0;
293ff764963SKishon Vijay Abraham I }
294ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(phy_power_off);
295ff764963SKishon Vijay Abraham I 
296ff764963SKishon Vijay Abraham I /**
2970b3f3b2cSKamil Debski  * _of_phy_get() - lookup and obtain a reference to a phy by phandle
2980b3f3b2cSKamil Debski  * @np: device_node for which to get the phy
299ff764963SKishon Vijay Abraham I  * @index: the index of the phy
300ff764963SKishon Vijay Abraham I  *
301ff764963SKishon Vijay Abraham I  * Returns the phy associated with the given phandle value,
302ff764963SKishon Vijay Abraham I  * after getting a refcount to it or -ENODEV if there is no such phy or
303ff764963SKishon Vijay Abraham I  * -EPROBE_DEFER if there is a phandle to the phy, but the device is
304ff764963SKishon Vijay Abraham I  * not yet loaded. This function uses of_xlate call back function provided
305ff764963SKishon Vijay Abraham I  * while registering the phy_provider to find the phy instance.
306ff764963SKishon Vijay Abraham I  */
3070b3f3b2cSKamil Debski static struct phy *_of_phy_get(struct device_node *np, int index)
308ff764963SKishon Vijay Abraham I {
309ff764963SKishon Vijay Abraham I 	int ret;
310ff764963SKishon Vijay Abraham I 	struct phy_provider *phy_provider;
311ff764963SKishon Vijay Abraham I 	struct phy *phy = NULL;
312ff764963SKishon Vijay Abraham I 	struct of_phandle_args args;
313ff764963SKishon Vijay Abraham I 
3140b3f3b2cSKamil Debski 	ret = of_parse_phandle_with_args(np, "phys", "#phy-cells",
315ff764963SKishon Vijay Abraham I 		index, &args);
3160b3f3b2cSKamil Debski 	if (ret)
317ff764963SKishon Vijay Abraham I 		return ERR_PTR(-ENODEV);
318ff764963SKishon Vijay Abraham I 
319ff764963SKishon Vijay Abraham I 	mutex_lock(&phy_provider_mutex);
320ff764963SKishon Vijay Abraham I 	phy_provider = of_phy_provider_lookup(args.np);
321ff764963SKishon Vijay Abraham I 	if (IS_ERR(phy_provider) || !try_module_get(phy_provider->owner)) {
322ff764963SKishon Vijay Abraham I 		phy = ERR_PTR(-EPROBE_DEFER);
323ff764963SKishon Vijay Abraham I 		goto err0;
324ff764963SKishon Vijay Abraham I 	}
325ff764963SKishon Vijay Abraham I 
326ff764963SKishon Vijay Abraham I 	phy = phy_provider->of_xlate(phy_provider->dev, &args);
327ff764963SKishon Vijay Abraham I 	module_put(phy_provider->owner);
328ff764963SKishon Vijay Abraham I 
329ff764963SKishon Vijay Abraham I err0:
330ff764963SKishon Vijay Abraham I 	mutex_unlock(&phy_provider_mutex);
331ff764963SKishon Vijay Abraham I 	of_node_put(args.np);
332ff764963SKishon Vijay Abraham I 
333ff764963SKishon Vijay Abraham I 	return phy;
334ff764963SKishon Vijay Abraham I }
335ff764963SKishon Vijay Abraham I 
336ff764963SKishon Vijay Abraham I /**
3370b3f3b2cSKamil Debski  * of_phy_get() - lookup and obtain a reference to a phy using a device_node.
3380b3f3b2cSKamil Debski  * @np: device_node for which to get the phy
3390b3f3b2cSKamil Debski  * @con_id: name of the phy from device's point of view
3400b3f3b2cSKamil Debski  *
3410b3f3b2cSKamil Debski  * Returns the phy driver, after getting a refcount to it; or
3420b3f3b2cSKamil Debski  * -ENODEV if there is no such phy. The caller is responsible for
3430b3f3b2cSKamil Debski  * calling phy_put() to release that count.
3440b3f3b2cSKamil Debski  */
3450b3f3b2cSKamil Debski struct phy *of_phy_get(struct device_node *np, const char *con_id)
3460b3f3b2cSKamil Debski {
3470b3f3b2cSKamil Debski 	struct phy *phy = NULL;
3480b3f3b2cSKamil Debski 	int index = 0;
3490b3f3b2cSKamil Debski 
3500b3f3b2cSKamil Debski 	if (con_id)
3510b3f3b2cSKamil Debski 		index = of_property_match_string(np, "phy-names", con_id);
3520b3f3b2cSKamil Debski 
3530b3f3b2cSKamil Debski 	phy = _of_phy_get(np, index);
3540b3f3b2cSKamil Debski 	if (IS_ERR(phy))
3550b3f3b2cSKamil Debski 		return phy;
3560b3f3b2cSKamil Debski 
3570b3f3b2cSKamil Debski 	if (!try_module_get(phy->ops->owner))
3580b3f3b2cSKamil Debski 		return ERR_PTR(-EPROBE_DEFER);
3590b3f3b2cSKamil Debski 
3600b3f3b2cSKamil Debski 	get_device(&phy->dev);
3610b3f3b2cSKamil Debski 
3620b3f3b2cSKamil Debski 	return phy;
3630b3f3b2cSKamil Debski }
3640b3f3b2cSKamil Debski EXPORT_SYMBOL_GPL(of_phy_get);
3650b3f3b2cSKamil Debski 
3660b3f3b2cSKamil Debski /**
367ff764963SKishon Vijay Abraham I  * phy_put() - release the PHY
368ff764963SKishon Vijay Abraham I  * @phy: the phy returned by phy_get()
369ff764963SKishon Vijay Abraham I  *
370ff764963SKishon Vijay Abraham I  * Releases a refcount the caller received from phy_get().
371ff764963SKishon Vijay Abraham I  */
372ff764963SKishon Vijay Abraham I void phy_put(struct phy *phy)
373ff764963SKishon Vijay Abraham I {
37404c2facaSAndrew Lunn 	if (!phy || IS_ERR(phy))
375ff764963SKishon Vijay Abraham I 		return;
376ff764963SKishon Vijay Abraham I 
377ff764963SKishon Vijay Abraham I 	module_put(phy->ops->owner);
378ff764963SKishon Vijay Abraham I 	put_device(&phy->dev);
379ff764963SKishon Vijay Abraham I }
380ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(phy_put);
381ff764963SKishon Vijay Abraham I 
382ff764963SKishon Vijay Abraham I /**
383ff764963SKishon Vijay Abraham I  * devm_phy_put() - release the PHY
384ff764963SKishon Vijay Abraham I  * @dev: device that wants to release this phy
385ff764963SKishon Vijay Abraham I  * @phy: the phy returned by devm_phy_get()
386ff764963SKishon Vijay Abraham I  *
387ff764963SKishon Vijay Abraham I  * destroys the devres associated with this phy and invokes phy_put
388ff764963SKishon Vijay Abraham I  * to release the phy.
389ff764963SKishon Vijay Abraham I  */
390ff764963SKishon Vijay Abraham I void devm_phy_put(struct device *dev, struct phy *phy)
391ff764963SKishon Vijay Abraham I {
392ff764963SKishon Vijay Abraham I 	int r;
393ff764963SKishon Vijay Abraham I 
39404c2facaSAndrew Lunn 	if (!phy)
39504c2facaSAndrew Lunn 		return;
39604c2facaSAndrew Lunn 
397ff764963SKishon Vijay Abraham I 	r = devres_destroy(dev, devm_phy_release, devm_phy_match, phy);
398ff764963SKishon Vijay Abraham I 	dev_WARN_ONCE(dev, r, "couldn't find PHY resource\n");
399ff764963SKishon Vijay Abraham I }
400ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(devm_phy_put);
401ff764963SKishon Vijay Abraham I 
402ff764963SKishon Vijay Abraham I /**
403ff764963SKishon Vijay Abraham I  * of_phy_simple_xlate() - returns the phy instance from phy provider
404ff764963SKishon Vijay Abraham I  * @dev: the PHY provider device
405ff764963SKishon Vijay Abraham I  * @args: of_phandle_args (not used here)
406ff764963SKishon Vijay Abraham I  *
407ff764963SKishon Vijay Abraham I  * Intended to be used by phy provider for the common case where #phy-cells is
408ff764963SKishon Vijay Abraham I  * 0. For other cases where #phy-cells is greater than '0', the phy provider
409ff764963SKishon Vijay Abraham I  * should provide a custom of_xlate function that reads the *args* and returns
410ff764963SKishon Vijay Abraham I  * the appropriate phy.
411ff764963SKishon Vijay Abraham I  */
412ff764963SKishon Vijay Abraham I struct phy *of_phy_simple_xlate(struct device *dev, struct of_phandle_args
413ff764963SKishon Vijay Abraham I 	*args)
414ff764963SKishon Vijay Abraham I {
415ff764963SKishon Vijay Abraham I 	struct phy *phy;
416ff764963SKishon Vijay Abraham I 	struct class_dev_iter iter;
417ff764963SKishon Vijay Abraham I 	struct device_node *node = dev->of_node;
418*f0ed8176SKishon Vijay Abraham I 	struct device_node *child;
419ff764963SKishon Vijay Abraham I 
420ff764963SKishon Vijay Abraham I 	class_dev_iter_init(&iter, phy_class, NULL, NULL);
421ff764963SKishon Vijay Abraham I 	while ((dev = class_dev_iter_next(&iter))) {
422ff764963SKishon Vijay Abraham I 		phy = to_phy(dev);
423*f0ed8176SKishon Vijay Abraham I 		if (node != phy->dev.of_node) {
424*f0ed8176SKishon Vijay Abraham I 			for_each_child_of_node(node, child) {
425*f0ed8176SKishon Vijay Abraham I 				if (child == phy->dev.of_node)
426*f0ed8176SKishon Vijay Abraham I 					goto phy_found;
427*f0ed8176SKishon Vijay Abraham I 			}
428ff764963SKishon Vijay Abraham I 			continue;
429*f0ed8176SKishon Vijay Abraham I 		}
430ff764963SKishon Vijay Abraham I 
431*f0ed8176SKishon Vijay Abraham I phy_found:
432ff764963SKishon Vijay Abraham I 		class_dev_iter_exit(&iter);
433ff764963SKishon Vijay Abraham I 		return phy;
434ff764963SKishon Vijay Abraham I 	}
435ff764963SKishon Vijay Abraham I 
436ff764963SKishon Vijay Abraham I 	class_dev_iter_exit(&iter);
437ff764963SKishon Vijay Abraham I 	return ERR_PTR(-ENODEV);
438ff764963SKishon Vijay Abraham I }
439ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(of_phy_simple_xlate);
440ff764963SKishon Vijay Abraham I 
441ff764963SKishon Vijay Abraham I /**
442ff764963SKishon Vijay Abraham I  * phy_get() - lookup and obtain a reference to a phy.
443ff764963SKishon Vijay Abraham I  * @dev: device that requests this phy
444ff764963SKishon Vijay Abraham I  * @string: the phy name as given in the dt data or the name of the controller
445ff764963SKishon Vijay Abraham I  * port for non-dt case
446ff764963SKishon Vijay Abraham I  *
447ff764963SKishon Vijay Abraham I  * Returns the phy driver, after getting a refcount to it; or
448ff764963SKishon Vijay Abraham I  * -ENODEV if there is no such phy.  The caller is responsible for
449ff764963SKishon Vijay Abraham I  * calling phy_put() to release that count.
450ff764963SKishon Vijay Abraham I  */
451ff764963SKishon Vijay Abraham I struct phy *phy_get(struct device *dev, const char *string)
452ff764963SKishon Vijay Abraham I {
453ff764963SKishon Vijay Abraham I 	int index = 0;
454d18c9604SKishon Vijay Abraham I 	struct phy *phy;
455ff764963SKishon Vijay Abraham I 
456ff764963SKishon Vijay Abraham I 	if (string == NULL) {
457ff764963SKishon Vijay Abraham I 		dev_WARN(dev, "missing string\n");
458ff764963SKishon Vijay Abraham I 		return ERR_PTR(-EINVAL);
459ff764963SKishon Vijay Abraham I 	}
460ff764963SKishon Vijay Abraham I 
461ff764963SKishon Vijay Abraham I 	if (dev->of_node) {
462ff764963SKishon Vijay Abraham I 		index = of_property_match_string(dev->of_node, "phy-names",
463ff764963SKishon Vijay Abraham I 			string);
4640b3f3b2cSKamil Debski 		phy = _of_phy_get(dev->of_node, index);
465ff764963SKishon Vijay Abraham I 	} else {
466ff764963SKishon Vijay Abraham I 		phy = phy_lookup(dev, string);
467f40037fdSHans de Goede 	}
468f40037fdSHans de Goede 	if (IS_ERR(phy))
469ff764963SKishon Vijay Abraham I 		return phy;
470ff764963SKishon Vijay Abraham I 
471ff764963SKishon Vijay Abraham I 	if (!try_module_get(phy->ops->owner))
472ff764963SKishon Vijay Abraham I 		return ERR_PTR(-EPROBE_DEFER);
473ff764963SKishon Vijay Abraham I 
474ff764963SKishon Vijay Abraham I 	get_device(&phy->dev);
475ff764963SKishon Vijay Abraham I 
476ff764963SKishon Vijay Abraham I 	return phy;
477ff764963SKishon Vijay Abraham I }
478ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(phy_get);
479ff764963SKishon Vijay Abraham I 
480ff764963SKishon Vijay Abraham I /**
481788a4d56SAndrew Lunn  * phy_optional_get() - lookup and obtain a reference to an optional phy.
482788a4d56SAndrew Lunn  * @dev: device that requests this phy
483788a4d56SAndrew Lunn  * @string: the phy name as given in the dt data or the name of the controller
484788a4d56SAndrew Lunn  * port for non-dt case
485788a4d56SAndrew Lunn  *
486788a4d56SAndrew Lunn  * Returns the phy driver, after getting a refcount to it; or
487788a4d56SAndrew Lunn  * NULL if there is no such phy.  The caller is responsible for
488788a4d56SAndrew Lunn  * calling phy_put() to release that count.
489788a4d56SAndrew Lunn  */
490788a4d56SAndrew Lunn struct phy *phy_optional_get(struct device *dev, const char *string)
491788a4d56SAndrew Lunn {
492788a4d56SAndrew Lunn 	struct phy *phy = phy_get(dev, string);
493788a4d56SAndrew Lunn 
494788a4d56SAndrew Lunn 	if (PTR_ERR(phy) == -ENODEV)
495788a4d56SAndrew Lunn 		phy = NULL;
496788a4d56SAndrew Lunn 
497788a4d56SAndrew Lunn 	return phy;
498788a4d56SAndrew Lunn }
499788a4d56SAndrew Lunn EXPORT_SYMBOL_GPL(phy_optional_get);
500788a4d56SAndrew Lunn 
501788a4d56SAndrew Lunn /**
502ff764963SKishon Vijay Abraham I  * devm_phy_get() - lookup and obtain a reference to a phy.
503ff764963SKishon Vijay Abraham I  * @dev: device that requests this phy
504ff764963SKishon Vijay Abraham I  * @string: the phy name as given in the dt data or phy device name
505ff764963SKishon Vijay Abraham I  * for non-dt case
506ff764963SKishon Vijay Abraham I  *
507ff764963SKishon Vijay Abraham I  * Gets the phy using phy_get(), and associates a device with it using
508ff764963SKishon Vijay Abraham I  * devres. On driver detach, release function is invoked on the devres data,
509ff764963SKishon Vijay Abraham I  * then, devres data is freed.
510ff764963SKishon Vijay Abraham I  */
511ff764963SKishon Vijay Abraham I struct phy *devm_phy_get(struct device *dev, const char *string)
512ff764963SKishon Vijay Abraham I {
513ff764963SKishon Vijay Abraham I 	struct phy **ptr, *phy;
514ff764963SKishon Vijay Abraham I 
515ff764963SKishon Vijay Abraham I 	ptr = devres_alloc(devm_phy_release, sizeof(*ptr), GFP_KERNEL);
516ff764963SKishon Vijay Abraham I 	if (!ptr)
517ff764963SKishon Vijay Abraham I 		return ERR_PTR(-ENOMEM);
518ff764963SKishon Vijay Abraham I 
519ff764963SKishon Vijay Abraham I 	phy = phy_get(dev, string);
520ff764963SKishon Vijay Abraham I 	if (!IS_ERR(phy)) {
521ff764963SKishon Vijay Abraham I 		*ptr = phy;
522ff764963SKishon Vijay Abraham I 		devres_add(dev, ptr);
523ff764963SKishon Vijay Abraham I 	} else {
524ff764963SKishon Vijay Abraham I 		devres_free(ptr);
525ff764963SKishon Vijay Abraham I 	}
526ff764963SKishon Vijay Abraham I 
527ff764963SKishon Vijay Abraham I 	return phy;
528ff764963SKishon Vijay Abraham I }
529ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(devm_phy_get);
530ff764963SKishon Vijay Abraham I 
531ff764963SKishon Vijay Abraham I /**
532788a4d56SAndrew Lunn  * devm_phy_optional_get() - lookup and obtain a reference to an optional phy.
533788a4d56SAndrew Lunn  * @dev: device that requests this phy
534788a4d56SAndrew Lunn  * @string: the phy name as given in the dt data or phy device name
535788a4d56SAndrew Lunn  * for non-dt case
536788a4d56SAndrew Lunn  *
537788a4d56SAndrew Lunn  * Gets the phy using phy_get(), and associates a device with it using
538788a4d56SAndrew Lunn  * devres. On driver detach, release function is invoked on the devres
539788a4d56SAndrew Lunn  * data, then, devres data is freed. This differs to devm_phy_get() in
540788a4d56SAndrew Lunn  * that if the phy does not exist, it is not considered an error and
541788a4d56SAndrew Lunn  * -ENODEV will not be returned. Instead the NULL phy is returned,
542788a4d56SAndrew Lunn  * which can be passed to all other phy consumer calls.
543788a4d56SAndrew Lunn  */
544788a4d56SAndrew Lunn struct phy *devm_phy_optional_get(struct device *dev, const char *string)
545788a4d56SAndrew Lunn {
546788a4d56SAndrew Lunn 	struct phy *phy = devm_phy_get(dev, string);
547788a4d56SAndrew Lunn 
548788a4d56SAndrew Lunn 	if (PTR_ERR(phy) == -ENODEV)
549788a4d56SAndrew Lunn 		phy = NULL;
550788a4d56SAndrew Lunn 
551788a4d56SAndrew Lunn 	return phy;
552788a4d56SAndrew Lunn }
553788a4d56SAndrew Lunn EXPORT_SYMBOL_GPL(devm_phy_optional_get);
554788a4d56SAndrew Lunn 
555788a4d56SAndrew Lunn /**
556b5d682f4SKamil Debski  * devm_of_phy_get() - lookup and obtain a reference to a phy.
557b5d682f4SKamil Debski  * @dev: device that requests this phy
558b5d682f4SKamil Debski  * @np: node containing the phy
559b5d682f4SKamil Debski  * @con_id: name of the phy from device's point of view
560b5d682f4SKamil Debski  *
561b5d682f4SKamil Debski  * Gets the phy using of_phy_get(), and associates a device with it using
562b5d682f4SKamil Debski  * devres. On driver detach, release function is invoked on the devres data,
563b5d682f4SKamil Debski  * then, devres data is freed.
564b5d682f4SKamil Debski  */
565b5d682f4SKamil Debski struct phy *devm_of_phy_get(struct device *dev, struct device_node *np,
566b5d682f4SKamil Debski 			    const char *con_id)
567b5d682f4SKamil Debski {
568b5d682f4SKamil Debski 	struct phy **ptr, *phy;
569b5d682f4SKamil Debski 
570b5d682f4SKamil Debski 	ptr = devres_alloc(devm_phy_release, sizeof(*ptr), GFP_KERNEL);
571b5d682f4SKamil Debski 	if (!ptr)
572b5d682f4SKamil Debski 		return ERR_PTR(-ENOMEM);
573b5d682f4SKamil Debski 
574b5d682f4SKamil Debski 	phy = of_phy_get(np, con_id);
575b5d682f4SKamil Debski 	if (!IS_ERR(phy)) {
576b5d682f4SKamil Debski 		*ptr = phy;
577b5d682f4SKamil Debski 		devres_add(dev, ptr);
578b5d682f4SKamil Debski 	} else {
579b5d682f4SKamil Debski 		devres_free(ptr);
580b5d682f4SKamil Debski 	}
581b5d682f4SKamil Debski 
582b5d682f4SKamil Debski 	return phy;
583b5d682f4SKamil Debski }
584b5d682f4SKamil Debski EXPORT_SYMBOL_GPL(devm_of_phy_get);
585b5d682f4SKamil Debski 
586b5d682f4SKamil Debski /**
587ff764963SKishon Vijay Abraham I  * phy_create() - create a new phy
588ff764963SKishon Vijay Abraham I  * @dev: device that is creating the new phy
589*f0ed8176SKishon Vijay Abraham I  * @node: device node of the phy
590ff764963SKishon Vijay Abraham I  * @ops: function pointers for performing phy operations
591ff764963SKishon Vijay Abraham I  * @init_data: contains the list of PHY consumers or NULL
592ff764963SKishon Vijay Abraham I  *
593ff764963SKishon Vijay Abraham I  * Called to create a phy using phy framework.
594ff764963SKishon Vijay Abraham I  */
595*f0ed8176SKishon Vijay Abraham I struct phy *phy_create(struct device *dev, struct device_node *node,
596*f0ed8176SKishon Vijay Abraham I 		       const struct phy_ops *ops,
597ff764963SKishon Vijay Abraham I 		       struct phy_init_data *init_data)
598ff764963SKishon Vijay Abraham I {
599ff764963SKishon Vijay Abraham I 	int ret;
600ff764963SKishon Vijay Abraham I 	int id;
601ff764963SKishon Vijay Abraham I 	struct phy *phy;
602ff764963SKishon Vijay Abraham I 
60352797d29SDan Carpenter 	if (WARN_ON(!dev))
60452797d29SDan Carpenter 		return ERR_PTR(-EINVAL);
605ff764963SKishon Vijay Abraham I 
606ff764963SKishon Vijay Abraham I 	phy = kzalloc(sizeof(*phy), GFP_KERNEL);
60752797d29SDan Carpenter 	if (!phy)
60852797d29SDan Carpenter 		return ERR_PTR(-ENOMEM);
609ff764963SKishon Vijay Abraham I 
610ff764963SKishon Vijay Abraham I 	id = ida_simple_get(&phy_ida, 0, 0, GFP_KERNEL);
611ff764963SKishon Vijay Abraham I 	if (id < 0) {
612ff764963SKishon Vijay Abraham I 		dev_err(dev, "unable to get id\n");
613ff764963SKishon Vijay Abraham I 		ret = id;
61452797d29SDan Carpenter 		goto free_phy;
615ff764963SKishon Vijay Abraham I 	}
616ff764963SKishon Vijay Abraham I 
6173be88125SRoger Quadros 	/* phy-supply */
6183be88125SRoger Quadros 	phy->pwr = regulator_get_optional(dev, "phy");
6193be88125SRoger Quadros 	if (IS_ERR(phy->pwr)) {
6203be88125SRoger Quadros 		if (PTR_ERR(phy->pwr) == -EPROBE_DEFER) {
6213be88125SRoger Quadros 			ret = -EPROBE_DEFER;
6223be88125SRoger Quadros 			goto free_ida;
6233be88125SRoger Quadros 		}
6243be88125SRoger Quadros 		phy->pwr = NULL;
6253be88125SRoger Quadros 	}
6263be88125SRoger Quadros 
627ff764963SKishon Vijay Abraham I 	device_initialize(&phy->dev);
628ff764963SKishon Vijay Abraham I 	mutex_init(&phy->mutex);
629ff764963SKishon Vijay Abraham I 
630ff764963SKishon Vijay Abraham I 	phy->dev.class = phy_class;
631ff764963SKishon Vijay Abraham I 	phy->dev.parent = dev;
632*f0ed8176SKishon Vijay Abraham I 	phy->dev.of_node = node ?: dev->of_node;
633ff764963SKishon Vijay Abraham I 	phy->id = id;
634ff764963SKishon Vijay Abraham I 	phy->ops = ops;
635ff764963SKishon Vijay Abraham I 	phy->init_data = init_data;
636ff764963SKishon Vijay Abraham I 
637ff764963SKishon Vijay Abraham I 	ret = dev_set_name(&phy->dev, "phy-%s.%d", dev_name(dev), id);
638ff764963SKishon Vijay Abraham I 	if (ret)
63952797d29SDan Carpenter 		goto put_dev;
640ff764963SKishon Vijay Abraham I 
641ff764963SKishon Vijay Abraham I 	ret = device_add(&phy->dev);
642ff764963SKishon Vijay Abraham I 	if (ret)
64352797d29SDan Carpenter 		goto put_dev;
644ff764963SKishon Vijay Abraham I 
645ff764963SKishon Vijay Abraham I 	if (pm_runtime_enabled(dev)) {
646ff764963SKishon Vijay Abraham I 		pm_runtime_enable(&phy->dev);
647ff764963SKishon Vijay Abraham I 		pm_runtime_no_callbacks(&phy->dev);
648ff764963SKishon Vijay Abraham I 	}
649ff764963SKishon Vijay Abraham I 
650ff764963SKishon Vijay Abraham I 	return phy;
651ff764963SKishon Vijay Abraham I 
65252797d29SDan Carpenter put_dev:
653e73b49f1SRoger Quadros 	put_device(&phy->dev);  /* calls phy_release() which frees resources */
654e73b49f1SRoger Quadros 	return ERR_PTR(ret);
655e73b49f1SRoger Quadros 
6563be88125SRoger Quadros free_ida:
6573be88125SRoger Quadros 	ida_simple_remove(&phy_ida, phy->id);
6583be88125SRoger Quadros 
65952797d29SDan Carpenter free_phy:
660ff764963SKishon Vijay Abraham I 	kfree(phy);
661ff764963SKishon Vijay Abraham I 	return ERR_PTR(ret);
662ff764963SKishon Vijay Abraham I }
663ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(phy_create);
664ff764963SKishon Vijay Abraham I 
665ff764963SKishon Vijay Abraham I /**
666ff764963SKishon Vijay Abraham I  * devm_phy_create() - create a new phy
667ff764963SKishon Vijay Abraham I  * @dev: device that is creating the new phy
668*f0ed8176SKishon Vijay Abraham I  * @node: device node of the phy
669ff764963SKishon Vijay Abraham I  * @ops: function pointers for performing phy operations
670ff764963SKishon Vijay Abraham I  * @init_data: contains the list of PHY consumers or NULL
671ff764963SKishon Vijay Abraham I  *
672ff764963SKishon Vijay Abraham I  * Creates a new PHY device adding it to the PHY class.
673ff764963SKishon Vijay Abraham I  * While at that, it also associates the device with the phy using devres.
674ff764963SKishon Vijay Abraham I  * On driver detach, release function is invoked on the devres data,
675ff764963SKishon Vijay Abraham I  * then, devres data is freed.
676ff764963SKishon Vijay Abraham I  */
677*f0ed8176SKishon Vijay Abraham I struct phy *devm_phy_create(struct device *dev, struct device_node *node,
678*f0ed8176SKishon Vijay Abraham I 			    const struct phy_ops *ops,
679ff764963SKishon Vijay Abraham I 			    struct phy_init_data *init_data)
680ff764963SKishon Vijay Abraham I {
681ff764963SKishon Vijay Abraham I 	struct phy **ptr, *phy;
682ff764963SKishon Vijay Abraham I 
683ff764963SKishon Vijay Abraham I 	ptr = devres_alloc(devm_phy_consume, sizeof(*ptr), GFP_KERNEL);
684ff764963SKishon Vijay Abraham I 	if (!ptr)
685ff764963SKishon Vijay Abraham I 		return ERR_PTR(-ENOMEM);
686ff764963SKishon Vijay Abraham I 
687*f0ed8176SKishon Vijay Abraham I 	phy = phy_create(dev, node, ops, init_data);
688ff764963SKishon Vijay Abraham I 	if (!IS_ERR(phy)) {
689ff764963SKishon Vijay Abraham I 		*ptr = phy;
690ff764963SKishon Vijay Abraham I 		devres_add(dev, ptr);
691ff764963SKishon Vijay Abraham I 	} else {
692ff764963SKishon Vijay Abraham I 		devres_free(ptr);
693ff764963SKishon Vijay Abraham I 	}
694ff764963SKishon Vijay Abraham I 
695ff764963SKishon Vijay Abraham I 	return phy;
696ff764963SKishon Vijay Abraham I }
697ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(devm_phy_create);
698ff764963SKishon Vijay Abraham I 
699ff764963SKishon Vijay Abraham I /**
700ff764963SKishon Vijay Abraham I  * phy_destroy() - destroy the phy
701ff764963SKishon Vijay Abraham I  * @phy: the phy to be destroyed
702ff764963SKishon Vijay Abraham I  *
703ff764963SKishon Vijay Abraham I  * Called to destroy the phy.
704ff764963SKishon Vijay Abraham I  */
705ff764963SKishon Vijay Abraham I void phy_destroy(struct phy *phy)
706ff764963SKishon Vijay Abraham I {
707ff764963SKishon Vijay Abraham I 	pm_runtime_disable(&phy->dev);
708ff764963SKishon Vijay Abraham I 	device_unregister(&phy->dev);
709ff764963SKishon Vijay Abraham I }
710ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(phy_destroy);
711ff764963SKishon Vijay Abraham I 
712ff764963SKishon Vijay Abraham I /**
713ff764963SKishon Vijay Abraham I  * devm_phy_destroy() - destroy the PHY
714ff764963SKishon Vijay Abraham I  * @dev: device that wants to release this phy
715ff764963SKishon Vijay Abraham I  * @phy: the phy returned by devm_phy_get()
716ff764963SKishon Vijay Abraham I  *
717ff764963SKishon Vijay Abraham I  * destroys the devres associated with this phy and invokes phy_destroy
718ff764963SKishon Vijay Abraham I  * to destroy the phy.
719ff764963SKishon Vijay Abraham I  */
720ff764963SKishon Vijay Abraham I void devm_phy_destroy(struct device *dev, struct phy *phy)
721ff764963SKishon Vijay Abraham I {
722ff764963SKishon Vijay Abraham I 	int r;
723ff764963SKishon Vijay Abraham I 
724ff764963SKishon Vijay Abraham I 	r = devres_destroy(dev, devm_phy_consume, devm_phy_match, phy);
725ff764963SKishon Vijay Abraham I 	dev_WARN_ONCE(dev, r, "couldn't find PHY resource\n");
726ff764963SKishon Vijay Abraham I }
727ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(devm_phy_destroy);
728ff764963SKishon Vijay Abraham I 
729ff764963SKishon Vijay Abraham I /**
730ff764963SKishon Vijay Abraham I  * __of_phy_provider_register() - create/register phy provider with the framework
731ff764963SKishon Vijay Abraham I  * @dev: struct device of the phy provider
732ff764963SKishon Vijay Abraham I  * @owner: the module owner containing of_xlate
733ff764963SKishon Vijay Abraham I  * @of_xlate: function pointer to obtain phy instance from phy provider
734ff764963SKishon Vijay Abraham I  *
735ff764963SKishon Vijay Abraham I  * Creates struct phy_provider from dev and of_xlate function pointer.
736ff764963SKishon Vijay Abraham I  * This is used in the case of dt boot for finding the phy instance from
737ff764963SKishon Vijay Abraham I  * phy provider.
738ff764963SKishon Vijay Abraham I  */
739ff764963SKishon Vijay Abraham I struct phy_provider *__of_phy_provider_register(struct device *dev,
740ff764963SKishon Vijay Abraham I 	struct module *owner, struct phy * (*of_xlate)(struct device *dev,
741ff764963SKishon Vijay Abraham I 	struct of_phandle_args *args))
742ff764963SKishon Vijay Abraham I {
743ff764963SKishon Vijay Abraham I 	struct phy_provider *phy_provider;
744ff764963SKishon Vijay Abraham I 
745ff764963SKishon Vijay Abraham I 	phy_provider = kzalloc(sizeof(*phy_provider), GFP_KERNEL);
746ff764963SKishon Vijay Abraham I 	if (!phy_provider)
747ff764963SKishon Vijay Abraham I 		return ERR_PTR(-ENOMEM);
748ff764963SKishon Vijay Abraham I 
749ff764963SKishon Vijay Abraham I 	phy_provider->dev = dev;
750ff764963SKishon Vijay Abraham I 	phy_provider->owner = owner;
751ff764963SKishon Vijay Abraham I 	phy_provider->of_xlate = of_xlate;
752ff764963SKishon Vijay Abraham I 
753ff764963SKishon Vijay Abraham I 	mutex_lock(&phy_provider_mutex);
754ff764963SKishon Vijay Abraham I 	list_add_tail(&phy_provider->list, &phy_provider_list);
755ff764963SKishon Vijay Abraham I 	mutex_unlock(&phy_provider_mutex);
756ff764963SKishon Vijay Abraham I 
757ff764963SKishon Vijay Abraham I 	return phy_provider;
758ff764963SKishon Vijay Abraham I }
759ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(__of_phy_provider_register);
760ff764963SKishon Vijay Abraham I 
761ff764963SKishon Vijay Abraham I /**
762ff764963SKishon Vijay Abraham I  * __devm_of_phy_provider_register() - create/register phy provider with the
763ff764963SKishon Vijay Abraham I  * framework
764ff764963SKishon Vijay Abraham I  * @dev: struct device of the phy provider
765ff764963SKishon Vijay Abraham I  * @owner: the module owner containing of_xlate
766ff764963SKishon Vijay Abraham I  * @of_xlate: function pointer to obtain phy instance from phy provider
767ff764963SKishon Vijay Abraham I  *
768ff764963SKishon Vijay Abraham I  * Creates struct phy_provider from dev and of_xlate function pointer.
769ff764963SKishon Vijay Abraham I  * This is used in the case of dt boot for finding the phy instance from
770ff764963SKishon Vijay Abraham I  * phy provider. While at that, it also associates the device with the
771ff764963SKishon Vijay Abraham I  * phy provider using devres. On driver detach, release function is invoked
772ff764963SKishon Vijay Abraham I  * on the devres data, then, devres data is freed.
773ff764963SKishon Vijay Abraham I  */
774ff764963SKishon Vijay Abraham I struct phy_provider *__devm_of_phy_provider_register(struct device *dev,
775ff764963SKishon Vijay Abraham I 	struct module *owner, struct phy * (*of_xlate)(struct device *dev,
776ff764963SKishon Vijay Abraham I 	struct of_phandle_args *args))
777ff764963SKishon Vijay Abraham I {
778ff764963SKishon Vijay Abraham I 	struct phy_provider **ptr, *phy_provider;
779ff764963SKishon Vijay Abraham I 
780ff764963SKishon Vijay Abraham I 	ptr = devres_alloc(devm_phy_provider_release, sizeof(*ptr), GFP_KERNEL);
781ff764963SKishon Vijay Abraham I 	if (!ptr)
782ff764963SKishon Vijay Abraham I 		return ERR_PTR(-ENOMEM);
783ff764963SKishon Vijay Abraham I 
784ff764963SKishon Vijay Abraham I 	phy_provider = __of_phy_provider_register(dev, owner, of_xlate);
785ff764963SKishon Vijay Abraham I 	if (!IS_ERR(phy_provider)) {
786ff764963SKishon Vijay Abraham I 		*ptr = phy_provider;
787ff764963SKishon Vijay Abraham I 		devres_add(dev, ptr);
788ff764963SKishon Vijay Abraham I 	} else {
789ff764963SKishon Vijay Abraham I 		devres_free(ptr);
790ff764963SKishon Vijay Abraham I 	}
791ff764963SKishon Vijay Abraham I 
792ff764963SKishon Vijay Abraham I 	return phy_provider;
793ff764963SKishon Vijay Abraham I }
794ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(__devm_of_phy_provider_register);
795ff764963SKishon Vijay Abraham I 
796ff764963SKishon Vijay Abraham I /**
797ff764963SKishon Vijay Abraham I  * of_phy_provider_unregister() - unregister phy provider from the framework
798ff764963SKishon Vijay Abraham I  * @phy_provider: phy provider returned by of_phy_provider_register()
799ff764963SKishon Vijay Abraham I  *
800ff764963SKishon Vijay Abraham I  * Removes the phy_provider created using of_phy_provider_register().
801ff764963SKishon Vijay Abraham I  */
802ff764963SKishon Vijay Abraham I void of_phy_provider_unregister(struct phy_provider *phy_provider)
803ff764963SKishon Vijay Abraham I {
804ff764963SKishon Vijay Abraham I 	if (IS_ERR(phy_provider))
805ff764963SKishon Vijay Abraham I 		return;
806ff764963SKishon Vijay Abraham I 
807ff764963SKishon Vijay Abraham I 	mutex_lock(&phy_provider_mutex);
808ff764963SKishon Vijay Abraham I 	list_del(&phy_provider->list);
809ff764963SKishon Vijay Abraham I 	kfree(phy_provider);
810ff764963SKishon Vijay Abraham I 	mutex_unlock(&phy_provider_mutex);
811ff764963SKishon Vijay Abraham I }
812ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(of_phy_provider_unregister);
813ff764963SKishon Vijay Abraham I 
814ff764963SKishon Vijay Abraham I /**
815ff764963SKishon Vijay Abraham I  * devm_of_phy_provider_unregister() - remove phy provider from the framework
816ff764963SKishon Vijay Abraham I  * @dev: struct device of the phy provider
817ff764963SKishon Vijay Abraham I  *
818ff764963SKishon Vijay Abraham I  * destroys the devres associated with this phy provider and invokes
819ff764963SKishon Vijay Abraham I  * of_phy_provider_unregister to unregister the phy provider.
820ff764963SKishon Vijay Abraham I  */
821ff764963SKishon Vijay Abraham I void devm_of_phy_provider_unregister(struct device *dev,
822ff764963SKishon Vijay Abraham I 	struct phy_provider *phy_provider) {
823ff764963SKishon Vijay Abraham I 	int r;
824ff764963SKishon Vijay Abraham I 
825ff764963SKishon Vijay Abraham I 	r = devres_destroy(dev, devm_phy_provider_release, devm_phy_match,
826ff764963SKishon Vijay Abraham I 		phy_provider);
827ff764963SKishon Vijay Abraham I 	dev_WARN_ONCE(dev, r, "couldn't find PHY provider device resource\n");
828ff764963SKishon Vijay Abraham I }
829ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(devm_of_phy_provider_unregister);
830ff764963SKishon Vijay Abraham I 
831ff764963SKishon Vijay Abraham I /**
832ff764963SKishon Vijay Abraham I  * phy_release() - release the phy
833ff764963SKishon Vijay Abraham I  * @dev: the dev member within phy
834ff764963SKishon Vijay Abraham I  *
835ff764963SKishon Vijay Abraham I  * When the last reference to the device is removed, it is called
836ff764963SKishon Vijay Abraham I  * from the embedded kobject as release method.
837ff764963SKishon Vijay Abraham I  */
838ff764963SKishon Vijay Abraham I static void phy_release(struct device *dev)
839ff764963SKishon Vijay Abraham I {
840ff764963SKishon Vijay Abraham I 	struct phy *phy;
841ff764963SKishon Vijay Abraham I 
842ff764963SKishon Vijay Abraham I 	phy = to_phy(dev);
843ff764963SKishon Vijay Abraham I 	dev_vdbg(dev, "releasing '%s'\n", dev_name(dev));
8443be88125SRoger Quadros 	regulator_put(phy->pwr);
845e73b49f1SRoger Quadros 	ida_simple_remove(&phy_ida, phy->id);
846ff764963SKishon Vijay Abraham I 	kfree(phy);
847ff764963SKishon Vijay Abraham I }
848ff764963SKishon Vijay Abraham I 
849ff764963SKishon Vijay Abraham I static int __init phy_core_init(void)
850ff764963SKishon Vijay Abraham I {
851ff764963SKishon Vijay Abraham I 	phy_class = class_create(THIS_MODULE, "phy");
852ff764963SKishon Vijay Abraham I 	if (IS_ERR(phy_class)) {
853ff764963SKishon Vijay Abraham I 		pr_err("failed to create phy class --> %ld\n",
854ff764963SKishon Vijay Abraham I 			PTR_ERR(phy_class));
855ff764963SKishon Vijay Abraham I 		return PTR_ERR(phy_class);
856ff764963SKishon Vijay Abraham I 	}
857ff764963SKishon Vijay Abraham I 
858ff764963SKishon Vijay Abraham I 	phy_class->dev_release = phy_release;
859ff764963SKishon Vijay Abraham I 
860ff764963SKishon Vijay Abraham I 	return 0;
861ff764963SKishon Vijay Abraham I }
862ff764963SKishon Vijay Abraham I module_init(phy_core_init);
863ff764963SKishon Vijay Abraham I 
864ff764963SKishon Vijay Abraham I static void __exit phy_core_exit(void)
865ff764963SKishon Vijay Abraham I {
866ff764963SKishon Vijay Abraham I 	class_destroy(phy_class);
867ff764963SKishon Vijay Abraham I }
868ff764963SKishon Vijay Abraham I module_exit(phy_core_exit);
869ff764963SKishon Vijay Abraham I 
870ff764963SKishon Vijay Abraham I MODULE_DESCRIPTION("Generic PHY Framework");
871ff764963SKishon Vijay Abraham I MODULE_AUTHOR("Kishon Vijay Abraham I <kishon@ti.com>");
872ff764963SKishon Vijay Abraham I MODULE_LICENSE("GPL v2");
873