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