u-boot/include/generic-phy.h

2  * Copyright (C) 2017 Texas Instruments Incorporated - http://www.ti.com/
3  * Written by Jean-Jacques Hiblot  <jjhiblot@ti.com>
5  * SPDX-License-Identifier:	GPL-2.0+
11 #include <generic-phy-dp.h>
12 #include <generic-phy-mipi-dphy.h>
13 #include <generic-phy-pcie.h>
21  * union phy_configure_opts - Opaque generic phy configuration
23  * @mipi_dphy: Configuration set applicable for phys supporting
25  * @dp:	       Configuration set applicable for phys supporting
35  * struct phy_attrs - represents phy attributes
47  * struct phy - A handle to (allowing control of) a single phy port.
52  * other phy APIs to identify which PHY port to operate upon.
54  * @dev: The device which implements the PHY port.
65  * struct udevice_ops - set of function pointers for phy operations
75 	 * of_xlate - Translate a client's device-tree (OF) phy specifier.
81 	 * default implementation, which assumes #phy-cells = <0> or
82 	 * #phy-cells = <1>, and in the later case that the DT cell
83 	 * contains a simple integer PHY port ID.
92 	 * init - initialize the hardware.
97 	 * is typically called only once per PHY port.
100 	 * @phy:	the PHY port to initialize
106 	* exit - de-initialize the PHY device
108 	* Hardware de-intialization should be done here. Every step done in
115 	* @phy:	PHY port to be de-initialized
121 	* reset - resets a PHY device without shutting down
123 	* @phy:	PHY port to be reset
126 	* re-establish connection etc without being shut down or exit.
164 	* power_on - power on a PHY device
166 	* @phy:	PHY port to be powered on
178 	* power_off - power off a PHY device
180 	* @phy:	PHY port to be powered off
184 	* init()/deinit() are not implemented, it must not de-initialize
197  * generic_phy_init() - initialize the PHY port
199  * @phy:	the PHY port to initialize
205  * generic_phy_init() - de-initialize the PHY device
207  * @phy:	PHY port to be de-initialized
213  * generic_phy_reset() - resets a PHY device without shutting down
215  * @phy:	PHY port to be reset
221  * generic_phy_configure() - change the PHY parameters
223  * @phy:        PHY port to be configure
229  * generic_phy_validate() - validate the PHY parameters
231  * @phy:        PHY port to be validate
238  * generic_phy_power_on() - power on a PHY device
240  * @phy:	PHY port to be powered on
246  * generic_phy_power_off() - power off a PHY device
248  * @phy:	PHY port to be powered off
259 	return phy->attrs.mode;  in generic_phy_get_mode()
263  * generic_phy_get_by_index() - Get a PHY device by integer index.
266  * @index:	The index in the list of available PHYs
267  * @phy:	A pointer to the PHY port
270  * list of the possible PHYs.
278  *   phys = <&usb2_phy>, <&usb3_phy>;
291  * generic_phy_get_by_name() - Get a PHY device by its name.
294  * @phy_name:	The name of the PHY in the list of possible PHYs
295  * @phy:	A pointer to the PHY port
298  * list of the possible PHYs based on its name.
306  *   phys = <&usb2_phy>, <&usb3_phy>;
307  *   phy-names = "usb2phy", "usb3phy";
382  * generic_phy_valid() - check if PHY port is valid
384  * @phy:	the PHY port to check
389 	return phy && phy->dev;  in generic_phy_valid()