1 /* SPDX-License-Identifier: GPL-2.0 */
2 /* USB OTG (On The Go) defines */
5 * These APIs may be used between USB controllers. USB device drivers
6 * (for either host or peripheral roles) don't use these calls; they
7 * continue to use just usb_device and usb_gadget.
10 #ifndef __LINUX_USB_OTG_H
11 #define __LINUX_USB_OTG_H
13 #include <linux/phy/phy.h>
14 #include <linux/usb/phy.h>
20 /* old usb_phy interface */
21 struct usb_phy *usb_phy;
23 struct usb_gadget *gadget;
25 enum usb_otg_state state;
27 /* bind/unbind the host controller */
28 int (*set_host)(struct usb_otg *otg, struct usb_bus *host);
30 /* bind/unbind the peripheral controller */
31 int (*set_peripheral)(struct usb_otg *otg,
32 struct usb_gadget *gadget);
34 /* effective for A-peripheral, ignored for B devices */
35 int (*set_vbus)(struct usb_otg *otg, bool enabled);
37 /* for B devices only: start session with A-Host */
38 int (*start_srp)(struct usb_otg *otg);
40 /* start or continue HNP role switch */
41 int (*start_hnp)(struct usb_otg *otg);
46 * struct usb_otg_caps - describes the otg capabilities of the device
47 * @otg_rev: The OTG revision number the device is compliant with, it's
48 * in binary-coded decimal (i.e. 2.0 is 0200H).
49 * @hnp_support: Indicates if the device supports HNP.
50 * @srp_support: Indicates if the device supports SRP.
51 * @adp_support: Indicates if the device supports ADP.
60 extern const char *usb_otg_state_string(enum usb_otg_state state);
62 /* Context: can sleep */
64 otg_start_hnp(struct usb_otg *otg)
66 if (otg && otg->start_hnp)
67 return otg->start_hnp(otg);
72 /* Context: can sleep */
74 otg_set_vbus(struct usb_otg *otg, bool enabled)
76 if (otg && otg->set_vbus)
77 return otg->set_vbus(otg, enabled);
84 otg_set_host(struct usb_otg *otg, struct usb_bus *host)
86 if (otg && otg->set_host)
87 return otg->set_host(otg, host);
92 /* for usb peripheral controller drivers */
94 /* Context: can sleep */
96 otg_set_peripheral(struct usb_otg *otg, struct usb_gadget *periph)
98 if (otg && otg->set_peripheral)
99 return otg->set_peripheral(otg, periph);
105 otg_start_srp(struct usb_otg *otg)
107 if (otg && otg->start_srp)
108 return otg->start_srp(otg);
113 /* for OTG controller drivers (and maybe other stuff) */
114 extern int usb_bus_start_enum(struct usb_bus *bus, unsigned port_num);
119 USB_DR_MODE_PERIPHERAL,
124 * usb_get_dr_mode - Get dual role mode for given device
125 * @dev: Pointer to the given device
127 * The function gets phy interface string from property 'dr_mode',
128 * and returns the corresponding enum usb_dr_mode
130 extern enum usb_dr_mode usb_get_dr_mode(struct device *dev);
131 extern enum usb_dr_mode usb_get_role_switch_default_mode(struct device *dev);
133 #endif /* __LINUX_USB_OTG_H */