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; 90*2a4c3701SKishon 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; 95*2a4c3701SKishon Vijay Abraham I 96*2a4c3701SKishon Vijay Abraham I for_each_child_of_node(phy_provider->dev->of_node, child) 97*2a4c3701SKishon Vijay Abraham I if (child == node) 98*2a4c3701SKishon 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; 418ff764963SKishon Vijay Abraham I 419ff764963SKishon Vijay Abraham I class_dev_iter_init(&iter, phy_class, NULL, NULL); 420ff764963SKishon Vijay Abraham I while ((dev = class_dev_iter_next(&iter))) { 421ff764963SKishon Vijay Abraham I phy = to_phy(dev); 422ff764963SKishon Vijay Abraham I if (node != phy->dev.of_node) 423ff764963SKishon Vijay Abraham I continue; 424ff764963SKishon Vijay Abraham I 425ff764963SKishon Vijay Abraham I class_dev_iter_exit(&iter); 426ff764963SKishon Vijay Abraham I return phy; 427ff764963SKishon Vijay Abraham I } 428ff764963SKishon Vijay Abraham I 429ff764963SKishon Vijay Abraham I class_dev_iter_exit(&iter); 430ff764963SKishon Vijay Abraham I return ERR_PTR(-ENODEV); 431ff764963SKishon Vijay Abraham I } 432ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(of_phy_simple_xlate); 433ff764963SKishon Vijay Abraham I 434ff764963SKishon Vijay Abraham I /** 435ff764963SKishon Vijay Abraham I * phy_get() - lookup and obtain a reference to a phy. 436ff764963SKishon Vijay Abraham I * @dev: device that requests this phy 437ff764963SKishon Vijay Abraham I * @string: the phy name as given in the dt data or the name of the controller 438ff764963SKishon Vijay Abraham I * port for non-dt case 439ff764963SKishon Vijay Abraham I * 440ff764963SKishon Vijay Abraham I * Returns the phy driver, after getting a refcount to it; or 441ff764963SKishon Vijay Abraham I * -ENODEV if there is no such phy. The caller is responsible for 442ff764963SKishon Vijay Abraham I * calling phy_put() to release that count. 443ff764963SKishon Vijay Abraham I */ 444ff764963SKishon Vijay Abraham I struct phy *phy_get(struct device *dev, const char *string) 445ff764963SKishon Vijay Abraham I { 446ff764963SKishon Vijay Abraham I int index = 0; 447d18c9604SKishon Vijay Abraham I struct phy *phy; 448ff764963SKishon Vijay Abraham I 449ff764963SKishon Vijay Abraham I if (string == NULL) { 450ff764963SKishon Vijay Abraham I dev_WARN(dev, "missing string\n"); 451ff764963SKishon Vijay Abraham I return ERR_PTR(-EINVAL); 452ff764963SKishon Vijay Abraham I } 453ff764963SKishon Vijay Abraham I 454ff764963SKishon Vijay Abraham I if (dev->of_node) { 455ff764963SKishon Vijay Abraham I index = of_property_match_string(dev->of_node, "phy-names", 456ff764963SKishon Vijay Abraham I string); 4570b3f3b2cSKamil Debski phy = _of_phy_get(dev->of_node, index); 458ff764963SKishon Vijay Abraham I } else { 459ff764963SKishon Vijay Abraham I phy = phy_lookup(dev, string); 460f40037fdSHans de Goede } 461f40037fdSHans de Goede if (IS_ERR(phy)) 462ff764963SKishon Vijay Abraham I return phy; 463ff764963SKishon Vijay Abraham I 464ff764963SKishon Vijay Abraham I if (!try_module_get(phy->ops->owner)) 465ff764963SKishon Vijay Abraham I return ERR_PTR(-EPROBE_DEFER); 466ff764963SKishon Vijay Abraham I 467ff764963SKishon Vijay Abraham I get_device(&phy->dev); 468ff764963SKishon Vijay Abraham I 469ff764963SKishon Vijay Abraham I return phy; 470ff764963SKishon Vijay Abraham I } 471ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(phy_get); 472ff764963SKishon Vijay Abraham I 473ff764963SKishon Vijay Abraham I /** 474788a4d56SAndrew Lunn * phy_optional_get() - lookup and obtain a reference to an optional phy. 475788a4d56SAndrew Lunn * @dev: device that requests this phy 476788a4d56SAndrew Lunn * @string: the phy name as given in the dt data or the name of the controller 477788a4d56SAndrew Lunn * port for non-dt case 478788a4d56SAndrew Lunn * 479788a4d56SAndrew Lunn * Returns the phy driver, after getting a refcount to it; or 480788a4d56SAndrew Lunn * NULL if there is no such phy. The caller is responsible for 481788a4d56SAndrew Lunn * calling phy_put() to release that count. 482788a4d56SAndrew Lunn */ 483788a4d56SAndrew Lunn struct phy *phy_optional_get(struct device *dev, const char *string) 484788a4d56SAndrew Lunn { 485788a4d56SAndrew Lunn struct phy *phy = phy_get(dev, string); 486788a4d56SAndrew Lunn 487788a4d56SAndrew Lunn if (PTR_ERR(phy) == -ENODEV) 488788a4d56SAndrew Lunn phy = NULL; 489788a4d56SAndrew Lunn 490788a4d56SAndrew Lunn return phy; 491788a4d56SAndrew Lunn } 492788a4d56SAndrew Lunn EXPORT_SYMBOL_GPL(phy_optional_get); 493788a4d56SAndrew Lunn 494788a4d56SAndrew Lunn /** 495ff764963SKishon Vijay Abraham I * devm_phy_get() - lookup and obtain a reference to a phy. 496ff764963SKishon Vijay Abraham I * @dev: device that requests this phy 497ff764963SKishon Vijay Abraham I * @string: the phy name as given in the dt data or phy device name 498ff764963SKishon Vijay Abraham I * for non-dt case 499ff764963SKishon Vijay Abraham I * 500ff764963SKishon Vijay Abraham I * Gets the phy using phy_get(), and associates a device with it using 501ff764963SKishon Vijay Abraham I * devres. On driver detach, release function is invoked on the devres data, 502ff764963SKishon Vijay Abraham I * then, devres data is freed. 503ff764963SKishon Vijay Abraham I */ 504ff764963SKishon Vijay Abraham I struct phy *devm_phy_get(struct device *dev, const char *string) 505ff764963SKishon Vijay Abraham I { 506ff764963SKishon Vijay Abraham I struct phy **ptr, *phy; 507ff764963SKishon Vijay Abraham I 508ff764963SKishon Vijay Abraham I ptr = devres_alloc(devm_phy_release, sizeof(*ptr), GFP_KERNEL); 509ff764963SKishon Vijay Abraham I if (!ptr) 510ff764963SKishon Vijay Abraham I return ERR_PTR(-ENOMEM); 511ff764963SKishon Vijay Abraham I 512ff764963SKishon Vijay Abraham I phy = phy_get(dev, string); 513ff764963SKishon Vijay Abraham I if (!IS_ERR(phy)) { 514ff764963SKishon Vijay Abraham I *ptr = phy; 515ff764963SKishon Vijay Abraham I devres_add(dev, ptr); 516ff764963SKishon Vijay Abraham I } else { 517ff764963SKishon Vijay Abraham I devres_free(ptr); 518ff764963SKishon Vijay Abraham I } 519ff764963SKishon Vijay Abraham I 520ff764963SKishon Vijay Abraham I return phy; 521ff764963SKishon Vijay Abraham I } 522ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(devm_phy_get); 523ff764963SKishon Vijay Abraham I 524ff764963SKishon Vijay Abraham I /** 525788a4d56SAndrew Lunn * devm_phy_optional_get() - lookup and obtain a reference to an optional phy. 526788a4d56SAndrew Lunn * @dev: device that requests this phy 527788a4d56SAndrew Lunn * @string: the phy name as given in the dt data or phy device name 528788a4d56SAndrew Lunn * for non-dt case 529788a4d56SAndrew Lunn * 530788a4d56SAndrew Lunn * Gets the phy using phy_get(), and associates a device with it using 531788a4d56SAndrew Lunn * devres. On driver detach, release function is invoked on the devres 532788a4d56SAndrew Lunn * data, then, devres data is freed. This differs to devm_phy_get() in 533788a4d56SAndrew Lunn * that if the phy does not exist, it is not considered an error and 534788a4d56SAndrew Lunn * -ENODEV will not be returned. Instead the NULL phy is returned, 535788a4d56SAndrew Lunn * which can be passed to all other phy consumer calls. 536788a4d56SAndrew Lunn */ 537788a4d56SAndrew Lunn struct phy *devm_phy_optional_get(struct device *dev, const char *string) 538788a4d56SAndrew Lunn { 539788a4d56SAndrew Lunn struct phy *phy = devm_phy_get(dev, string); 540788a4d56SAndrew Lunn 541788a4d56SAndrew Lunn if (PTR_ERR(phy) == -ENODEV) 542788a4d56SAndrew Lunn phy = NULL; 543788a4d56SAndrew Lunn 544788a4d56SAndrew Lunn return phy; 545788a4d56SAndrew Lunn } 546788a4d56SAndrew Lunn EXPORT_SYMBOL_GPL(devm_phy_optional_get); 547788a4d56SAndrew Lunn 548788a4d56SAndrew Lunn /** 549b5d682f4SKamil Debski * devm_of_phy_get() - lookup and obtain a reference to a phy. 550b5d682f4SKamil Debski * @dev: device that requests this phy 551b5d682f4SKamil Debski * @np: node containing the phy 552b5d682f4SKamil Debski * @con_id: name of the phy from device's point of view 553b5d682f4SKamil Debski * 554b5d682f4SKamil Debski * Gets the phy using of_phy_get(), and associates a device with it using 555b5d682f4SKamil Debski * devres. On driver detach, release function is invoked on the devres data, 556b5d682f4SKamil Debski * then, devres data is freed. 557b5d682f4SKamil Debski */ 558b5d682f4SKamil Debski struct phy *devm_of_phy_get(struct device *dev, struct device_node *np, 559b5d682f4SKamil Debski const char *con_id) 560b5d682f4SKamil Debski { 561b5d682f4SKamil Debski struct phy **ptr, *phy; 562b5d682f4SKamil Debski 563b5d682f4SKamil Debski ptr = devres_alloc(devm_phy_release, sizeof(*ptr), GFP_KERNEL); 564b5d682f4SKamil Debski if (!ptr) 565b5d682f4SKamil Debski return ERR_PTR(-ENOMEM); 566b5d682f4SKamil Debski 567b5d682f4SKamil Debski phy = of_phy_get(np, con_id); 568b5d682f4SKamil Debski if (!IS_ERR(phy)) { 569b5d682f4SKamil Debski *ptr = phy; 570b5d682f4SKamil Debski devres_add(dev, ptr); 571b5d682f4SKamil Debski } else { 572b5d682f4SKamil Debski devres_free(ptr); 573b5d682f4SKamil Debski } 574b5d682f4SKamil Debski 575b5d682f4SKamil Debski return phy; 576b5d682f4SKamil Debski } 577b5d682f4SKamil Debski EXPORT_SYMBOL_GPL(devm_of_phy_get); 578b5d682f4SKamil Debski 579b5d682f4SKamil Debski /** 580ff764963SKishon Vijay Abraham I * phy_create() - create a new phy 581ff764963SKishon Vijay Abraham I * @dev: device that is creating the new phy 582ff764963SKishon Vijay Abraham I * @ops: function pointers for performing phy operations 583ff764963SKishon Vijay Abraham I * @init_data: contains the list of PHY consumers or NULL 584ff764963SKishon Vijay Abraham I * 585ff764963SKishon Vijay Abraham I * Called to create a phy using phy framework. 586ff764963SKishon Vijay Abraham I */ 587ff764963SKishon Vijay Abraham I struct phy *phy_create(struct device *dev, const struct phy_ops *ops, 588ff764963SKishon Vijay Abraham I struct phy_init_data *init_data) 589ff764963SKishon Vijay Abraham I { 590ff764963SKishon Vijay Abraham I int ret; 591ff764963SKishon Vijay Abraham I int id; 592ff764963SKishon Vijay Abraham I struct phy *phy; 593ff764963SKishon Vijay Abraham I 59452797d29SDan Carpenter if (WARN_ON(!dev)) 59552797d29SDan Carpenter return ERR_PTR(-EINVAL); 596ff764963SKishon Vijay Abraham I 597ff764963SKishon Vijay Abraham I phy = kzalloc(sizeof(*phy), GFP_KERNEL); 59852797d29SDan Carpenter if (!phy) 59952797d29SDan Carpenter return ERR_PTR(-ENOMEM); 600ff764963SKishon Vijay Abraham I 601ff764963SKishon Vijay Abraham I id = ida_simple_get(&phy_ida, 0, 0, GFP_KERNEL); 602ff764963SKishon Vijay Abraham I if (id < 0) { 603ff764963SKishon Vijay Abraham I dev_err(dev, "unable to get id\n"); 604ff764963SKishon Vijay Abraham I ret = id; 60552797d29SDan Carpenter goto free_phy; 606ff764963SKishon Vijay Abraham I } 607ff764963SKishon Vijay Abraham I 6083be88125SRoger Quadros /* phy-supply */ 6093be88125SRoger Quadros phy->pwr = regulator_get_optional(dev, "phy"); 6103be88125SRoger Quadros if (IS_ERR(phy->pwr)) { 6113be88125SRoger Quadros if (PTR_ERR(phy->pwr) == -EPROBE_DEFER) { 6123be88125SRoger Quadros ret = -EPROBE_DEFER; 6133be88125SRoger Quadros goto free_ida; 6143be88125SRoger Quadros } 6153be88125SRoger Quadros phy->pwr = NULL; 6163be88125SRoger Quadros } 6173be88125SRoger Quadros 618ff764963SKishon Vijay Abraham I device_initialize(&phy->dev); 619ff764963SKishon Vijay Abraham I mutex_init(&phy->mutex); 620ff764963SKishon Vijay Abraham I 621ff764963SKishon Vijay Abraham I phy->dev.class = phy_class; 622ff764963SKishon Vijay Abraham I phy->dev.parent = dev; 623ff764963SKishon Vijay Abraham I phy->dev.of_node = dev->of_node; 624ff764963SKishon Vijay Abraham I phy->id = id; 625ff764963SKishon Vijay Abraham I phy->ops = ops; 626ff764963SKishon Vijay Abraham I phy->init_data = init_data; 627ff764963SKishon Vijay Abraham I 628ff764963SKishon Vijay Abraham I ret = dev_set_name(&phy->dev, "phy-%s.%d", dev_name(dev), id); 629ff764963SKishon Vijay Abraham I if (ret) 63052797d29SDan Carpenter goto put_dev; 631ff764963SKishon Vijay Abraham I 632ff764963SKishon Vijay Abraham I ret = device_add(&phy->dev); 633ff764963SKishon Vijay Abraham I if (ret) 63452797d29SDan Carpenter goto put_dev; 635ff764963SKishon Vijay Abraham I 636ff764963SKishon Vijay Abraham I if (pm_runtime_enabled(dev)) { 637ff764963SKishon Vijay Abraham I pm_runtime_enable(&phy->dev); 638ff764963SKishon Vijay Abraham I pm_runtime_no_callbacks(&phy->dev); 639ff764963SKishon Vijay Abraham I } 640ff764963SKishon Vijay Abraham I 641ff764963SKishon Vijay Abraham I return phy; 642ff764963SKishon Vijay Abraham I 64352797d29SDan Carpenter put_dev: 644e73b49f1SRoger Quadros put_device(&phy->dev); /* calls phy_release() which frees resources */ 645e73b49f1SRoger Quadros return ERR_PTR(ret); 646e73b49f1SRoger Quadros 6473be88125SRoger Quadros free_ida: 6483be88125SRoger Quadros ida_simple_remove(&phy_ida, phy->id); 6493be88125SRoger Quadros 65052797d29SDan Carpenter free_phy: 651ff764963SKishon Vijay Abraham I kfree(phy); 652ff764963SKishon Vijay Abraham I return ERR_PTR(ret); 653ff764963SKishon Vijay Abraham I } 654ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(phy_create); 655ff764963SKishon Vijay Abraham I 656ff764963SKishon Vijay Abraham I /** 657ff764963SKishon Vijay Abraham I * devm_phy_create() - create a new phy 658ff764963SKishon Vijay Abraham I * @dev: device that is creating the new phy 659ff764963SKishon Vijay Abraham I * @ops: function pointers for performing phy operations 660ff764963SKishon Vijay Abraham I * @init_data: contains the list of PHY consumers or NULL 661ff764963SKishon Vijay Abraham I * 662ff764963SKishon Vijay Abraham I * Creates a new PHY device adding it to the PHY class. 663ff764963SKishon Vijay Abraham I * While at that, it also associates the device with the phy using devres. 664ff764963SKishon Vijay Abraham I * On driver detach, release function is invoked on the devres data, 665ff764963SKishon Vijay Abraham I * then, devres data is freed. 666ff764963SKishon Vijay Abraham I */ 667ff764963SKishon Vijay Abraham I struct phy *devm_phy_create(struct device *dev, const struct phy_ops *ops, 668ff764963SKishon Vijay Abraham I struct phy_init_data *init_data) 669ff764963SKishon Vijay Abraham I { 670ff764963SKishon Vijay Abraham I struct phy **ptr, *phy; 671ff764963SKishon Vijay Abraham I 672ff764963SKishon Vijay Abraham I ptr = devres_alloc(devm_phy_consume, sizeof(*ptr), GFP_KERNEL); 673ff764963SKishon Vijay Abraham I if (!ptr) 674ff764963SKishon Vijay Abraham I return ERR_PTR(-ENOMEM); 675ff764963SKishon Vijay Abraham I 676ff764963SKishon Vijay Abraham I phy = phy_create(dev, ops, init_data); 677ff764963SKishon Vijay Abraham I if (!IS_ERR(phy)) { 678ff764963SKishon Vijay Abraham I *ptr = phy; 679ff764963SKishon Vijay Abraham I devres_add(dev, ptr); 680ff764963SKishon Vijay Abraham I } else { 681ff764963SKishon Vijay Abraham I devres_free(ptr); 682ff764963SKishon Vijay Abraham I } 683ff764963SKishon Vijay Abraham I 684ff764963SKishon Vijay Abraham I return phy; 685ff764963SKishon Vijay Abraham I } 686ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(devm_phy_create); 687ff764963SKishon Vijay Abraham I 688ff764963SKishon Vijay Abraham I /** 689ff764963SKishon Vijay Abraham I * phy_destroy() - destroy the phy 690ff764963SKishon Vijay Abraham I * @phy: the phy to be destroyed 691ff764963SKishon Vijay Abraham I * 692ff764963SKishon Vijay Abraham I * Called to destroy the phy. 693ff764963SKishon Vijay Abraham I */ 694ff764963SKishon Vijay Abraham I void phy_destroy(struct phy *phy) 695ff764963SKishon Vijay Abraham I { 696ff764963SKishon Vijay Abraham I pm_runtime_disable(&phy->dev); 697ff764963SKishon Vijay Abraham I device_unregister(&phy->dev); 698ff764963SKishon Vijay Abraham I } 699ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(phy_destroy); 700ff764963SKishon Vijay Abraham I 701ff764963SKishon Vijay Abraham I /** 702ff764963SKishon Vijay Abraham I * devm_phy_destroy() - destroy the PHY 703ff764963SKishon Vijay Abraham I * @dev: device that wants to release this phy 704ff764963SKishon Vijay Abraham I * @phy: the phy returned by devm_phy_get() 705ff764963SKishon Vijay Abraham I * 706ff764963SKishon Vijay Abraham I * destroys the devres associated with this phy and invokes phy_destroy 707ff764963SKishon Vijay Abraham I * to destroy the phy. 708ff764963SKishon Vijay Abraham I */ 709ff764963SKishon Vijay Abraham I void devm_phy_destroy(struct device *dev, struct phy *phy) 710ff764963SKishon Vijay Abraham I { 711ff764963SKishon Vijay Abraham I int r; 712ff764963SKishon Vijay Abraham I 713ff764963SKishon Vijay Abraham I r = devres_destroy(dev, devm_phy_consume, devm_phy_match, phy); 714ff764963SKishon Vijay Abraham I dev_WARN_ONCE(dev, r, "couldn't find PHY resource\n"); 715ff764963SKishon Vijay Abraham I } 716ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(devm_phy_destroy); 717ff764963SKishon Vijay Abraham I 718ff764963SKishon Vijay Abraham I /** 719ff764963SKishon Vijay Abraham I * __of_phy_provider_register() - create/register phy provider with the framework 720ff764963SKishon Vijay Abraham I * @dev: struct device of the phy provider 721ff764963SKishon Vijay Abraham I * @owner: the module owner containing of_xlate 722ff764963SKishon Vijay Abraham I * @of_xlate: function pointer to obtain phy instance from phy provider 723ff764963SKishon Vijay Abraham I * 724ff764963SKishon Vijay Abraham I * Creates struct phy_provider from dev and of_xlate function pointer. 725ff764963SKishon Vijay Abraham I * This is used in the case of dt boot for finding the phy instance from 726ff764963SKishon Vijay Abraham I * phy provider. 727ff764963SKishon Vijay Abraham I */ 728ff764963SKishon Vijay Abraham I struct phy_provider *__of_phy_provider_register(struct device *dev, 729ff764963SKishon Vijay Abraham I struct module *owner, struct phy * (*of_xlate)(struct device *dev, 730ff764963SKishon Vijay Abraham I struct of_phandle_args *args)) 731ff764963SKishon Vijay Abraham I { 732ff764963SKishon Vijay Abraham I struct phy_provider *phy_provider; 733ff764963SKishon Vijay Abraham I 734ff764963SKishon Vijay Abraham I phy_provider = kzalloc(sizeof(*phy_provider), GFP_KERNEL); 735ff764963SKishon Vijay Abraham I if (!phy_provider) 736ff764963SKishon Vijay Abraham I return ERR_PTR(-ENOMEM); 737ff764963SKishon Vijay Abraham I 738ff764963SKishon Vijay Abraham I phy_provider->dev = dev; 739ff764963SKishon Vijay Abraham I phy_provider->owner = owner; 740ff764963SKishon Vijay Abraham I phy_provider->of_xlate = of_xlate; 741ff764963SKishon Vijay Abraham I 742ff764963SKishon Vijay Abraham I mutex_lock(&phy_provider_mutex); 743ff764963SKishon Vijay Abraham I list_add_tail(&phy_provider->list, &phy_provider_list); 744ff764963SKishon Vijay Abraham I mutex_unlock(&phy_provider_mutex); 745ff764963SKishon Vijay Abraham I 746ff764963SKishon Vijay Abraham I return phy_provider; 747ff764963SKishon Vijay Abraham I } 748ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(__of_phy_provider_register); 749ff764963SKishon Vijay Abraham I 750ff764963SKishon Vijay Abraham I /** 751ff764963SKishon Vijay Abraham I * __devm_of_phy_provider_register() - create/register phy provider with the 752ff764963SKishon Vijay Abraham I * framework 753ff764963SKishon Vijay Abraham I * @dev: struct device of the phy provider 754ff764963SKishon Vijay Abraham I * @owner: the module owner containing of_xlate 755ff764963SKishon Vijay Abraham I * @of_xlate: function pointer to obtain phy instance from phy provider 756ff764963SKishon Vijay Abraham I * 757ff764963SKishon Vijay Abraham I * Creates struct phy_provider from dev and of_xlate function pointer. 758ff764963SKishon Vijay Abraham I * This is used in the case of dt boot for finding the phy instance from 759ff764963SKishon Vijay Abraham I * phy provider. While at that, it also associates the device with the 760ff764963SKishon Vijay Abraham I * phy provider using devres. On driver detach, release function is invoked 761ff764963SKishon Vijay Abraham I * on the devres data, then, devres data is freed. 762ff764963SKishon Vijay Abraham I */ 763ff764963SKishon Vijay Abraham I struct phy_provider *__devm_of_phy_provider_register(struct device *dev, 764ff764963SKishon Vijay Abraham I struct module *owner, struct phy * (*of_xlate)(struct device *dev, 765ff764963SKishon Vijay Abraham I struct of_phandle_args *args)) 766ff764963SKishon Vijay Abraham I { 767ff764963SKishon Vijay Abraham I struct phy_provider **ptr, *phy_provider; 768ff764963SKishon Vijay Abraham I 769ff764963SKishon Vijay Abraham I ptr = devres_alloc(devm_phy_provider_release, sizeof(*ptr), GFP_KERNEL); 770ff764963SKishon Vijay Abraham I if (!ptr) 771ff764963SKishon Vijay Abraham I return ERR_PTR(-ENOMEM); 772ff764963SKishon Vijay Abraham I 773ff764963SKishon Vijay Abraham I phy_provider = __of_phy_provider_register(dev, owner, of_xlate); 774ff764963SKishon Vijay Abraham I if (!IS_ERR(phy_provider)) { 775ff764963SKishon Vijay Abraham I *ptr = phy_provider; 776ff764963SKishon Vijay Abraham I devres_add(dev, ptr); 777ff764963SKishon Vijay Abraham I } else { 778ff764963SKishon Vijay Abraham I devres_free(ptr); 779ff764963SKishon Vijay Abraham I } 780ff764963SKishon Vijay Abraham I 781ff764963SKishon Vijay Abraham I return phy_provider; 782ff764963SKishon Vijay Abraham I } 783ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(__devm_of_phy_provider_register); 784ff764963SKishon Vijay Abraham I 785ff764963SKishon Vijay Abraham I /** 786ff764963SKishon Vijay Abraham I * of_phy_provider_unregister() - unregister phy provider from the framework 787ff764963SKishon Vijay Abraham I * @phy_provider: phy provider returned by of_phy_provider_register() 788ff764963SKishon Vijay Abraham I * 789ff764963SKishon Vijay Abraham I * Removes the phy_provider created using of_phy_provider_register(). 790ff764963SKishon Vijay Abraham I */ 791ff764963SKishon Vijay Abraham I void of_phy_provider_unregister(struct phy_provider *phy_provider) 792ff764963SKishon Vijay Abraham I { 793ff764963SKishon Vijay Abraham I if (IS_ERR(phy_provider)) 794ff764963SKishon Vijay Abraham I return; 795ff764963SKishon Vijay Abraham I 796ff764963SKishon Vijay Abraham I mutex_lock(&phy_provider_mutex); 797ff764963SKishon Vijay Abraham I list_del(&phy_provider->list); 798ff764963SKishon Vijay Abraham I kfree(phy_provider); 799ff764963SKishon Vijay Abraham I mutex_unlock(&phy_provider_mutex); 800ff764963SKishon Vijay Abraham I } 801ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(of_phy_provider_unregister); 802ff764963SKishon Vijay Abraham I 803ff764963SKishon Vijay Abraham I /** 804ff764963SKishon Vijay Abraham I * devm_of_phy_provider_unregister() - remove phy provider from the framework 805ff764963SKishon Vijay Abraham I * @dev: struct device of the phy provider 806ff764963SKishon Vijay Abraham I * 807ff764963SKishon Vijay Abraham I * destroys the devres associated with this phy provider and invokes 808ff764963SKishon Vijay Abraham I * of_phy_provider_unregister to unregister the phy provider. 809ff764963SKishon Vijay Abraham I */ 810ff764963SKishon Vijay Abraham I void devm_of_phy_provider_unregister(struct device *dev, 811ff764963SKishon Vijay Abraham I struct phy_provider *phy_provider) { 812ff764963SKishon Vijay Abraham I int r; 813ff764963SKishon Vijay Abraham I 814ff764963SKishon Vijay Abraham I r = devres_destroy(dev, devm_phy_provider_release, devm_phy_match, 815ff764963SKishon Vijay Abraham I phy_provider); 816ff764963SKishon Vijay Abraham I dev_WARN_ONCE(dev, r, "couldn't find PHY provider device resource\n"); 817ff764963SKishon Vijay Abraham I } 818ff764963SKishon Vijay Abraham I EXPORT_SYMBOL_GPL(devm_of_phy_provider_unregister); 819ff764963SKishon Vijay Abraham I 820ff764963SKishon Vijay Abraham I /** 821ff764963SKishon Vijay Abraham I * phy_release() - release the phy 822ff764963SKishon Vijay Abraham I * @dev: the dev member within phy 823ff764963SKishon Vijay Abraham I * 824ff764963SKishon Vijay Abraham I * When the last reference to the device is removed, it is called 825ff764963SKishon Vijay Abraham I * from the embedded kobject as release method. 826ff764963SKishon Vijay Abraham I */ 827ff764963SKishon Vijay Abraham I static void phy_release(struct device *dev) 828ff764963SKishon Vijay Abraham I { 829ff764963SKishon Vijay Abraham I struct phy *phy; 830ff764963SKishon Vijay Abraham I 831ff764963SKishon Vijay Abraham I phy = to_phy(dev); 832ff764963SKishon Vijay Abraham I dev_vdbg(dev, "releasing '%s'\n", dev_name(dev)); 8333be88125SRoger Quadros regulator_put(phy->pwr); 834e73b49f1SRoger Quadros ida_simple_remove(&phy_ida, phy->id); 835ff764963SKishon Vijay Abraham I kfree(phy); 836ff764963SKishon Vijay Abraham I } 837ff764963SKishon Vijay Abraham I 838ff764963SKishon Vijay Abraham I static int __init phy_core_init(void) 839ff764963SKishon Vijay Abraham I { 840ff764963SKishon Vijay Abraham I phy_class = class_create(THIS_MODULE, "phy"); 841ff764963SKishon Vijay Abraham I if (IS_ERR(phy_class)) { 842ff764963SKishon Vijay Abraham I pr_err("failed to create phy class --> %ld\n", 843ff764963SKishon Vijay Abraham I PTR_ERR(phy_class)); 844ff764963SKishon Vijay Abraham I return PTR_ERR(phy_class); 845ff764963SKishon Vijay Abraham I } 846ff764963SKishon Vijay Abraham I 847ff764963SKishon Vijay Abraham I phy_class->dev_release = phy_release; 848ff764963SKishon Vijay Abraham I 849ff764963SKishon Vijay Abraham I return 0; 850ff764963SKishon Vijay Abraham I } 851ff764963SKishon Vijay Abraham I module_init(phy_core_init); 852ff764963SKishon Vijay Abraham I 853ff764963SKishon Vijay Abraham I static void __exit phy_core_exit(void) 854ff764963SKishon Vijay Abraham I { 855ff764963SKishon Vijay Abraham I class_destroy(phy_class); 856ff764963SKishon Vijay Abraham I } 857ff764963SKishon Vijay Abraham I module_exit(phy_core_exit); 858ff764963SKishon Vijay Abraham I 859ff764963SKishon Vijay Abraham I MODULE_DESCRIPTION("Generic PHY Framework"); 860ff764963SKishon Vijay Abraham I MODULE_AUTHOR("Kishon Vijay Abraham I <kishon@ti.com>"); 861ff764963SKishon Vijay Abraham I MODULE_LICENSE("GPL v2"); 862