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
24  *	       the MIPI_DPHY phy mode.
35  * struct phy_attrs - represents phy attributes
38  * @mode: PHY mode
43 	enum phy_mode		mode;  member
47  * struct phy - A handle to (allowing control of) a single phy port.
65  * struct udevice_ops - set of function pointers for phy operations
71  * @set_mode: set the mode of the phy
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
92 	 * init - initialize the hardware.
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
126 	* re-establish connection etc without being shut down or exit.
160 	int	(*validate)(struct phy *phy, enum phy_mode mode, int submode,
164 	* power_on - power on a PHY device
178 	* power_off - power off a PHY device
184 	* init()/deinit() are not implemented, it must not de-initialize
191 	int     (*set_mode)(struct phy *phy, enum phy_mode mode, int submode);
197  * generic_phy_init() - initialize the PHY port
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
221  * generic_phy_configure() - change the PHY parameters
229  * generic_phy_validate() - validate the PHY parameters
234 int generic_phy_validate(struct phy *phy, enum phy_mode mode, int submode,
238  * generic_phy_power_on() - power on a PHY device
246  * generic_phy_power_off() - power off a PHY device
253 int generic_phy_set_mode_ext(struct phy *phy, enum phy_mode mode, int submode);
254 #define generic_phy_set_mode(phy, mode) \  argument
255 	generic_phy_set_mode_ext(phy, mode, 0)
259 	return phy->attrs.mode;  in generic_phy_get_mode()
263  * generic_phy_get_by_index() - Get a PHY device by integer index.
273  * usb1: usb_otg_ss@xxx {
274  *       compatible = "xxx";
275  *       reg = <xxx>;
291  * generic_phy_get_by_name() - Get a PHY device by its name.
301  * usb1: usb_otg_ss@xxx {
302  *       compatible = "xxx";
303  *       reg = <xxx>;
307  *   phy-names = "usb2phy", "usb3phy";
341 static inline int generic_phy_validate(struct phy *phy, enum phy_mode mode,  in generic_phy_validate()  argument
370 static inline int generic_phy_set_mode_ext(struct phy *phy, enum phy_mode mode,  in generic_phy_set_mode_ext()  argument
376 #define generic_phy_set_mode(phy, mode) \  argument
377 	generic_phy_set_mode_ext(phy, mode, 0)
382  * generic_phy_valid() - check if PHY port is valid
389 	return phy && phy->dev;  in generic_phy_valid()