Lines Matching refs:phy
3 * phy-core.c -- Generic Phy framework.
18 #include <linux/phy/phy.h>
32 struct phy *phy = *(struct phy **)res;
34 phy_put(dev, phy);
46 struct phy *phy = *(struct phy **)res;
48 phy_destroy(phy);
53 struct phy **phy = res;
55 return *phy == match_data;
60 * @phy: the phy of the association
66 int phy_create_lookup(struct phy *phy, const char *con_id, const char *dev_id)
70 if (!phy || !dev_id || !con_id)
79 pl->phy = phy;
91 * @phy: the phy of the association
98 void phy_remove_lookup(struct phy *phy, const char *con_id, const char *dev_id)
102 if (!phy || !dev_id || !con_id)
107 if (pl->phy == phy && !strcmp(pl->dev_id, dev_id) &&
117 static struct phy *phy_find(struct device *dev, const char *con_id)
130 return pl ? pl->phy : ERR_PTR(-ENODEV);
150 int phy_pm_runtime_get(struct phy *phy)
154 if (!phy)
157 if (!pm_runtime_enabled(&phy->dev))
160 ret = pm_runtime_get(&phy->dev);
162 pm_runtime_put_noidle(&phy->dev);
168 int phy_pm_runtime_get_sync(struct phy *phy)
172 if (!phy)
175 if (!pm_runtime_enabled(&phy->dev))
178 ret = pm_runtime_get_sync(&phy->dev);
180 pm_runtime_put_sync(&phy->dev);
186 int phy_pm_runtime_put(struct phy *phy)
188 if (!phy)
191 if (!pm_runtime_enabled(&phy->dev))
194 return pm_runtime_put(&phy->dev);
198 int phy_pm_runtime_put_sync(struct phy *phy)
200 if (!phy)
203 if (!pm_runtime_enabled(&phy->dev))
206 return pm_runtime_put_sync(&phy->dev);
210 void phy_pm_runtime_allow(struct phy *phy)
212 if (!phy)
215 if (!pm_runtime_enabled(&phy->dev))
218 pm_runtime_allow(&phy->dev);
222 void phy_pm_runtime_forbid(struct phy *phy)
224 if (!phy)
227 if (!pm_runtime_enabled(&phy->dev))
230 pm_runtime_forbid(&phy->dev);
235 * phy_init - phy internal initialization before phy operation
236 * @phy: the phy returned by phy_get()
238 * Used to allow phy's driver to perform phy internal initialization,
240 * is required by the phy to perform the start of operation.
245 int phy_init(struct phy *phy)
249 if (!phy)
252 ret = phy_pm_runtime_get_sync(phy);
257 mutex_lock(&phy->mutex);
258 if (phy->power_count > phy->init_count)
259 dev_warn(&phy->dev, "phy_power_on was called before phy_init\n");
261 if (phy->init_count == 0 && phy->ops->init) {
262 ret = phy->ops->init(phy);
264 dev_err(&phy->dev, "phy init failed --> %d\n", ret);
268 ++phy->init_count;
271 mutex_unlock(&phy->mutex);
272 phy_pm_runtime_put(phy);
279 * @phy: the phy returned by phy_get()
285 int phy_exit(struct phy *phy)
289 if (!phy)
292 ret = phy_pm_runtime_get_sync(phy);
297 mutex_lock(&phy->mutex);
298 if (phy->init_count == 1 && phy->ops->exit) {
299 ret = phy->ops->exit(phy);
301 dev_err(&phy->dev, "phy exit failed --> %d\n", ret);
305 --phy->init_count;
308 mutex_unlock(&phy->mutex);
309 phy_pm_runtime_put(phy);
315 * phy_power_on - Enable the phy and enter proper operation
316 * @phy: the phy returned by phy_get()
322 int phy_power_on(struct phy *phy)
326 if (!phy)
329 if (phy->pwr) {
330 ret = regulator_enable(phy->pwr);
335 ret = phy_pm_runtime_get_sync(phy);
341 mutex_lock(&phy->mutex);
342 if (phy->power_count == 0 && phy->ops->power_on) {
343 ret = phy->ops->power_on(phy);
345 dev_err(&phy->dev, "phy poweron failed --> %d\n", ret);
349 ++phy->power_count;
350 mutex_unlock(&phy->mutex);
354 mutex_unlock(&phy->mutex);
355 phy_pm_runtime_put_sync(phy);
357 if (phy->pwr)
358 regulator_disable(phy->pwr);
365 * phy_power_off - Disable the phy.
366 * @phy: the phy returned by phy_get()
372 int phy_power_off(struct phy *phy)
376 if (!phy)
379 mutex_lock(&phy->mutex);
380 if (phy->power_count == 1 && phy->ops->power_off) {
381 ret = phy->ops->power_off(phy);
383 dev_err(&phy->dev, "phy poweroff failed --> %d\n", ret);
384 mutex_unlock(&phy->mutex);
388 --phy->power_count;
389 mutex_unlock(&phy->mutex);
390 phy_pm_runtime_put(phy);
392 if (phy->pwr)
393 regulator_disable(phy->pwr);
399 int phy_set_mode_ext(struct phy *phy, enum phy_mode mode, int submode)
403 if (!phy || !phy->ops->set_mode)
406 mutex_lock(&phy->mutex);
407 ret = phy->ops->set_mode(phy, mode, submode);
409 phy->attrs.mode = mode;
410 mutex_unlock(&phy->mutex);
416 int phy_set_media(struct phy *phy, enum phy_media media)
420 if (!phy || !phy->ops->set_media)
423 mutex_lock(&phy->mutex);
424 ret = phy->ops->set_media(phy, media);
425 mutex_unlock(&phy->mutex);
431 int phy_set_speed(struct phy *phy, int speed)
435 if (!phy || !phy->ops->set_speed)
438 mutex_lock(&phy->mutex);
439 ret = phy->ops->set_speed(phy, speed);
440 mutex_unlock(&phy->mutex);
446 int phy_reset(struct phy *phy)
450 if (!phy || !phy->ops->reset)
453 ret = phy_pm_runtime_get_sync(phy);
457 mutex_lock(&phy->mutex);
458 ret = phy->ops->reset(phy);
459 mutex_unlock(&phy->mutex);
461 phy_pm_runtime_put(phy);
468 * phy_calibrate() - Tunes the phy hw parameters for current configuration
469 * @phy: the phy returned by phy_get()
471 * Used to calibrate phy hardware, typically by adjusting some parameters in
477 int phy_calibrate(struct phy *phy)
481 if (!phy || !phy->ops->calibrate)
484 mutex_lock(&phy->mutex);
485 ret = phy->ops->calibrate(phy);
486 mutex_unlock(&phy->mutex);
493 * phy_configure() - Changes the phy parameters
494 * @phy: the phy returned by phy_get()
498 * on the phy. The configuration will be applied on the current phy
503 int phy_configure(struct phy *phy, union phy_configure_opts *opts)
507 if (!phy)
510 if (!phy->ops->configure)
513 mutex_lock(&phy->mutex);
514 ret = phy->ops->configure(phy, opts);
515 mutex_unlock(&phy->mutex);
522 * phy_validate() - Checks the phy parameters
523 * @phy: the phy returned by phy_get()
529 * the phy. Implementations are free to tune the parameters passed as
537 int phy_validate(struct phy *phy, enum phy_mode mode, int submode,
542 if (!phy)
545 if (!phy->ops->validate)
548 mutex_lock(&phy->mutex);
549 ret = phy->ops->validate(phy, mode, submode, opts);
550 mutex_unlock(&phy->mutex);
557 * _of_phy_get() - lookup and obtain a reference to a phy by phandle
558 * @np: device_node for which to get the phy
559 * @index: the index of the phy
561 * Returns the phy associated with the given phandle value,
562 * after getting a refcount to it or -ENODEV if there is no such phy or
563 * -EPROBE_DEFER if there is a phandle to the phy, but the device is
565 * while registering the phy_provider to find the phy instance.
567 static struct phy *_of_phy_get(struct device_node *np, int index)
571 struct phy *phy = NULL;
574 ret = of_parse_phandle_with_args(np, "phys", "#phy-cells",
579 /* This phy type handled by the usb-phy subsystem for now */
586 phy = ERR_PTR(-EPROBE_DEFER);
592 phy = ERR_PTR(-ENODEV);
596 phy = phy_provider->of_xlate(phy_provider->dev, &args);
605 return phy;
609 * of_phy_get() - lookup and obtain a reference to a phy using a device_node.
610 * @np: device_node for which to get the phy
611 * @con_id: name of the phy from device's point of view
613 * Returns the phy driver, after getting a refcount to it; or
614 * -ENODEV if there is no such phy. The caller is responsible for
617 struct phy *of_phy_get(struct device_node *np, const char *con_id)
619 struct phy *phy = NULL;
623 index = of_property_match_string(np, "phy-names", con_id);
625 phy = _of_phy_get(np, index);
626 if (IS_ERR(phy))
627 return phy;
629 if (!try_module_get(phy->ops->owner))
632 get_device(&phy->dev);
634 return phy;
640 * @phy: the phy returned by of_phy_get()
644 void of_phy_put(struct phy *phy)
646 if (!phy || IS_ERR(phy))
649 mutex_lock(&phy->mutex);
650 if (phy->ops->release)
651 phy->ops->release(phy);
652 mutex_unlock(&phy->mutex);
654 module_put(phy->ops->owner);
655 put_device(&phy->dev);
661 * @dev: device that wants to release this phy
662 * @phy: the phy returned by phy_get()
666 void phy_put(struct device *dev, struct phy *phy)
668 device_link_remove(dev, &phy->dev);
669 of_phy_put(phy);
675 * @dev: device that wants to release this phy
676 * @phy: the phy returned by devm_phy_get()
678 * destroys the devres associated with this phy and invokes phy_put
679 * to release the phy.
681 void devm_phy_put(struct device *dev, struct phy *phy)
685 if (!phy)
688 r = devres_destroy(dev, devm_phy_release, devm_phy_match, phy);
694 * of_phy_simple_xlate() - returns the phy instance from phy provider
698 * Intended to be used by phy provider for the common case where #phy-cells is
699 * 0. For other cases where #phy-cells is greater than '0', the phy provider
701 * the appropriate phy.
703 struct phy *of_phy_simple_xlate(struct device *dev, struct of_phandle_args
706 struct phy *phy;
711 phy = to_phy(dev);
712 if (args->np != phy->dev.of_node)
716 return phy;
725 * phy_get() - lookup and obtain a reference to a phy.
726 * @dev: device that requests this phy
727 * @string: the phy name as given in the dt data or the name of the controller
730 * Returns the phy driver, after getting a refcount to it; or
731 * -ENODEV if there is no such phy. The caller is responsible for
734 struct phy *phy_get(struct device *dev, const char *string)
737 struct phy *phy;
742 index = of_property_match_string(dev->of_node, "phy-names",
746 phy = _of_phy_get(dev->of_node, index);
752 phy = phy_find(dev, string);
754 if (IS_ERR(phy))
755 return phy;
757 if (!try_module_get(phy->ops->owner))
760 get_device(&phy->dev);
762 link = device_link_add(dev, &phy->dev, DL_FLAG_STATELESS);
765 dev_name(phy->dev.parent));
767 return phy;
772 * devm_phy_get() - lookup and obtain a reference to a phy.
773 * @dev: device that requests this phy
774 * @string: the phy name as given in the dt data or phy device name
777 * Gets the phy using phy_get(), and associates a device with it using
781 struct phy *devm_phy_get(struct device *dev, const char *string)
783 struct phy **ptr, *phy;
789 phy = phy_get(dev, string);
790 if (!IS_ERR(phy)) {
791 *ptr = phy;
797 return phy;
802 * devm_phy_optional_get() - lookup and obtain a reference to an optional phy.
803 * @dev: device that requests this phy
804 * @string: the phy name as given in the dt data or phy device name
807 * Gets the phy using phy_get(), and associates a device with it using
810 * that if the phy does not exist, it is not considered an error and
811 * -ENODEV will not be returned. Instead the NULL phy is returned,
812 * which can be passed to all other phy consumer calls.
814 struct phy *devm_phy_optional_get(struct device *dev, const char *string)
816 struct phy *phy = devm_phy_get(dev, string);
818 if (PTR_ERR(phy) == -ENODEV)
819 phy = NULL;
821 return phy;
826 * devm_of_phy_get() - lookup and obtain a reference to a phy.
827 * @dev: device that requests this phy
828 * @np: node containing the phy
829 * @con_id: name of the phy from device's point of view
831 * Gets the phy using of_phy_get(), and associates a device with it using
835 struct phy *devm_of_phy_get(struct device *dev, struct device_node *np,
838 struct phy **ptr, *phy;
845 phy = of_phy_get(np, con_id);
846 if (!IS_ERR(phy)) {
847 *ptr = phy;
851 return phy;
854 link = device_link_add(dev, &phy->dev, DL_FLAG_STATELESS);
857 dev_name(phy->dev.parent));
859 return phy;
865 * phy.
866 * @dev: device that requests this phy
867 * @np: node containing the phy
868 * @con_id: name of the phy from device's point of view
870 * Gets the phy using of_phy_get(), and associates a device with it using
873 * that if the phy does not exist, it is not considered an error and
874 * -ENODEV will not be returned. Instead the NULL phy is returned,
875 * which can be passed to all other phy consumer calls.
877 struct phy *devm_of_phy_optional_get(struct device *dev, struct device_node *np,
880 struct phy *phy = devm_of_phy_get(dev, np, con_id);
882 if (PTR_ERR(phy) == -ENODEV)
883 phy = NULL;
885 if (IS_ERR(phy))
886 dev_err_probe(dev, PTR_ERR(phy), "failed to get PHY %pOF:%s",
889 return phy;
894 * devm_of_phy_get_by_index() - lookup and obtain a reference to a phy by index.
895 * @dev: device that requests this phy
896 * @np: node containing the phy
897 * @index: index of the phy
899 * Gets the phy using _of_phy_get(), then gets a refcount to it,
905 struct phy *devm_of_phy_get_by_index(struct device *dev, struct device_node *np,
908 struct phy **ptr, *phy;
915 phy = _of_phy_get(np, index);
916 if (IS_ERR(phy)) {
918 return phy;
921 if (!try_module_get(phy->ops->owner)) {
926 get_device(&phy->dev);
928 *ptr = phy;
931 link = device_link_add(dev, &phy->dev, DL_FLAG_STATELESS);
934 dev_name(phy->dev.parent));
936 return phy;
941 * phy_create() - create a new phy
942 * @dev: device that is creating the new phy
943 * @node: device node of the phy
944 * @ops: function pointers for performing phy operations
946 * Called to create a phy using phy framework.
948 struct phy *phy_create(struct device *dev, struct device_node *node,
953 struct phy *phy;
958 phy = kzalloc(sizeof(*phy), GFP_KERNEL);
959 if (!phy)
969 device_initialize(&phy->dev);
970 mutex_init(&phy->mutex);
972 phy->dev.class = phy_class;
973 phy->dev.parent = dev;
974 phy->dev.of_node = node ?: dev->of_node;
975 phy->id = id;
976 phy->ops = ops;
978 ret = dev_set_name(&phy->dev, "phy-%s.%d", dev_name(dev), id);
982 /* phy-supply */
983 phy->pwr = regulator_get_optional(&phy->dev, "phy");
984 if (IS_ERR(phy->pwr)) {
985 ret = PTR_ERR(phy->pwr);
989 phy->pwr = NULL;
992 ret = device_add(&phy->dev);
997 pm_runtime_enable(&phy->dev);
998 pm_runtime_no_callbacks(&phy->dev);
1001 phy->debugfs = debugfs_create_dir(dev_name(&phy->dev), phy_debugfs_root);
1003 return phy;
1006 put_device(&phy->dev); /* calls phy_release() which frees resources */
1010 kfree(phy);
1016 * devm_phy_create() - create a new phy
1017 * @dev: device that is creating the new phy
1018 * @node: device node of the phy
1019 * @ops: function pointers for performing phy operations
1022 * While at that, it also associates the device with the phy using devres.
1026 struct phy *devm_phy_create(struct device *dev, struct device_node *node,
1029 struct phy **ptr, *phy;
1035 phy = phy_create(dev, node, ops);
1036 if (!IS_ERR(phy)) {
1037 *ptr = phy;
1043 return phy;
1048 * phy_destroy() - destroy the phy
1049 * @phy: the phy to be destroyed
1051 * Called to destroy the phy.
1053 void phy_destroy(struct phy *phy)
1055 pm_runtime_disable(&phy->dev);
1056 device_unregister(&phy->dev);
1062 * @dev: device that wants to release this phy
1063 * @phy: the phy returned by devm_phy_get()
1065 * destroys the devres associated with this phy and invokes phy_destroy
1066 * to destroy the phy.
1068 void devm_phy_destroy(struct device *dev, struct phy *phy)
1072 r = devres_destroy(dev, devm_phy_consume, devm_phy_match, phy);
1078 * __of_phy_provider_register() - create/register phy provider with the framework
1079 * @dev: struct device of the phy provider
1082 * @of_xlate: function pointer to obtain phy instance from phy provider
1085 * This is used in the case of dt boot for finding the phy instance from
1086 * phy provider.
1097 struct phy * (*of_xlate)(struct device *dev,
1145 * __devm_of_phy_provider_register() - create/register phy provider with the
1147 * @dev: struct device of the phy provider
1150 * @of_xlate: function pointer to obtain phy instance from phy provider
1153 * This is used in the case of dt boot for finding the phy instance from
1154 * phy provider. While at that, it also associates the device with the
1155 * phy provider using devres. On driver detach, release function is invoked
1160 struct phy * (*of_xlate)(struct device *dev,
1183 * of_phy_provider_unregister() - unregister phy provider from the framework
1184 * @phy_provider: phy provider returned by of_phy_provider_register()
1202 * devm_of_phy_provider_unregister() - remove phy provider from the framework
1203 * @dev: struct device of the phy provider
1204 * @phy_provider: phy provider returned by of_phy_provider_register()
1206 * destroys the devres associated with this phy provider and invokes
1207 * of_phy_provider_unregister to unregister the phy provider.
1221 * phy_release() - release the phy
1222 * @dev: the dev member within phy
1229 struct phy *phy;
1231 phy = to_phy(dev);
1233 debugfs_remove_recursive(phy->debugfs);
1234 regulator_put(phy->pwr);
1235 ida_simple_remove(&phy_ida, phy->id);
1236 kfree(phy);
1241 phy_class = class_create("phy");
1243 pr_err("failed to create phy class --> %ld\n",
1250 phy_debugfs_root = debugfs_create_dir("phy", NULL);