u-boot/include/generic-phy.h

1 /* SPDX-License-Identifier: GPL-2.0+ */
3  * Copyright (C) 2017 Texas Instruments Incorporated - http://www.ti.com/
4  * Written by Jean-Jacques Hiblot  <jjhiblot@ti.com>
13  * struct phy - A handle to (allowing control of) a single phy port.
30  * struct udevice_ops - set of function pointers for phy operations
34  * @power_on: powering on the phy (optional)
39 	 * of_xlate - Translate a client's device-tree (OF) phy specifier.
45 	 * default implementation, which assumes #phy-cells = <0> or
46 	 * #phy-cells = <1>, and in the later case that the DT cell
56 	 * init - initialize the hardware.
70 	* exit - de-initialize the PHY device
72 	* Hardware de-intialization should be done here. Every step done in
79 	* @phy:	PHY port to be de-initialized
85 	* reset - resets a PHY device without shutting down
90 	* re-establish connection etc without being shut down or exit.
97 	* power_on - power on a PHY device
99 	* @phy:	PHY port to be powered on
101 	* During runtime, the PHY may need to be powered on or off several
102 	* times. This function is used to power on the PHY. It relies on the
111 	* power_off - power off a PHY device
113 	* @phy:	PHY port to be powered off
115 	* During runtime, the PHY may need to be powered on or off several
117 	* init()/deinit() are not implemented, it must not de-initialize
128  * generic_phy_init() - initialize the PHY port
136  * generic_phy_init() - de-initialize the PHY device
138  * @phy:	PHY port to be de-initialized
144  * generic_phy_reset() - resets a PHY device without shutting down
152  * generic_phy_power_on() - power on a PHY device
154  * @phy:	PHY port to be powered on
160  * generic_phy_power_off() - power off a PHY device
162  * @phy:	PHY port to be powered off
169  * generic_phy_get_by_index() - Get a PHY device by integer index.
175  * This looks up a PHY device for a client device based on its position in the
197  * generic_phy_get_by_name() - Get a PHY device by its name.
204  * list of the possible PHYs based on its name.
213  *   phy-names = "usb2phy", "usb3phy";
266  * generic_phy_valid() - check if PHY port is valid
273 	return phy->dev != NULL;  in generic_phy_valid()