1 /* SPDX-License-Identifier: GPL-2.0 */ 1
2 /* USB OTG (On The Go) defines */
3 /*
4 *
5 * These APIs may be used between USB controll
6 * (for either host or peripheral roles) don't
7 * continue to use just usb_device and usb_gad
8 */
9
10 #ifndef __LINUX_USB_OTG_H
11 #define __LINUX_USB_OTG_H
12
13 #include <linux/phy/phy.h>
14 #include <linux/usb/phy.h>
15
16 struct usb_otg {
17 u8 default_a;
18
19 struct phy *phy;
20 /* old usb_phy interface */
21 struct usb_phy *usb_phy;
22 struct usb_bus *host;
23 struct usb_gadget *gadget;
24
25 enum usb_otg_state state;
26
27 /* bind/unbind the host controller */
28 int (*set_host)(struct usb_otg *ot
29
30 /* bind/unbind the peripheral controll
31 int (*set_peripheral)(struct usb_o
32 struct
33
34 /* effective for A-peripheral, ignored
35 int (*set_vbus)(struct usb_otg *ot
36
37 /* for B devices only: start session
38 int (*start_srp)(struct usb_otg *o
39
40 /* start or continue HNP role switch *
41 int (*start_hnp)(struct usb_otg *o
42
43 };
44
45 /**
46 * struct usb_otg_caps - describes the otg cap
47 * @otg_rev: The OTG revision number the devic
48 * in binary-coded decimal (i.e.
49 * @hnp_support: Indicates if the device suppo
50 * @srp_support: Indicates if the device suppo
51 * @adp_support: Indicates if the device suppo
52 */
53 struct usb_otg_caps {
54 u16 otg_rev;
55 bool hnp_support;
56 bool srp_support;
57 bool adp_support;
58 };
59
60 extern const char *usb_otg_state_string(enum u
61
62 /* Context: can sleep */
63 static inline int
64 otg_start_hnp(struct usb_otg *otg)
65 {
66 if (otg && otg->start_hnp)
67 return otg->start_hnp(otg);
68
69 return -ENOTSUPP;
70 }
71
72 /* Context: can sleep */
73 static inline int
74 otg_set_vbus(struct usb_otg *otg, bool enabled
75 {
76 if (otg && otg->set_vbus)
77 return otg->set_vbus(otg, enab
78
79 return -ENOTSUPP;
80 }
81
82 /* for HCDs */
83 static inline int
84 otg_set_host(struct usb_otg *otg, struct usb_b
85 {
86 if (otg && otg->set_host)
87 return otg->set_host(otg, host
88
89 return -ENOTSUPP;
90 }
91
92 /* for usb peripheral controller drivers */
93
94 /* Context: can sleep */
95 static inline int
96 otg_set_peripheral(struct usb_otg *otg, struct
97 {
98 if (otg && otg->set_peripheral)
99 return otg->set_peripheral(otg
100
101 return -ENOTSUPP;
102 }
103
104 static inline int
105 otg_start_srp(struct usb_otg *otg)
106 {
107 if (otg && otg->start_srp)
108 return otg->start_srp(otg);
109
110 return -ENOTSUPP;
111 }
112
113 /* for OTG controller drivers (and maybe other
114 extern int usb_bus_start_enum(struct usb_bus *
115
116 enum usb_dr_mode {
117 USB_DR_MODE_UNKNOWN,
118 USB_DR_MODE_HOST,
119 USB_DR_MODE_PERIPHERAL,
120 USB_DR_MODE_OTG,
121 };
122
123 /**
124 * usb_get_dr_mode - Get dual role mode for gi
125 * @dev: Pointer to the given device
126 *
127 * The function gets phy interface string from
128 * and returns the corresponding enum usb_dr_m
129 */
130 extern enum usb_dr_mode usb_get_dr_mode(struct
131 extern enum usb_dr_mode usb_get_role_switch_de
132
133 #endif /* __LINUX_USB_OTG_H */
134
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.