1 /* USB OTG (On The Go) defines */
2 /*
3 *
4 * These APIs may be used between USB controllers. USB device drivers
5 * (for either host or peripheral roles) don't use these calls; they
6 * continue to use just usb_device and usb_gadget.
7 */
8
9 #ifndef __LINUX_USB_OTG_H
10 #define __LINUX_USB_OTG_H
11
12 #include <linux/usb/phy.h>
13
14 struct usb_otg {
15 u8 default_a;
16
17 struct usb_phy *phy;
18 struct usb_bus *host;
19 struct usb_gadget *gadget;
20
21 /* bind/unbind the host controller */
22 int (*set_host)(struct usb_otg *otg, struct usb_bus *host);
23
24 /* bind/unbind the peripheral controller */
25 int (*set_peripheral)(struct usb_otg *otg,
26 struct usb_gadget *gadget);
27
28 /* effective for A-peripheral, ignored for B devices */
29 int (*set_vbus)(struct usb_otg *otg, bool enabled);
30
31 /* for B devices only: start session with A-Host */
32 int (*start_srp)(struct usb_otg *otg);
33
34 /* start or continue HNP role switch */
35 int (*start_hnp)(struct usb_otg *otg);
36
37 };
38
39 extern const char *usb_otg_state_string(enum usb_otg_state state);
40
41 /* Context: can sleep */
42 static inline int
otg_start_hnp(struct usb_otg * otg)43 otg_start_hnp(struct usb_otg *otg)
44 {
45 if (otg && otg->start_hnp)
46 return otg->start_hnp(otg);
47
48 return -ENOTSUPP;
49 }
50
51 /* Context: can sleep */
52 static inline int
otg_set_vbus(struct usb_otg * otg,bool enabled)53 otg_set_vbus(struct usb_otg *otg, bool enabled)
54 {
55 if (otg && otg->set_vbus)
56 return otg->set_vbus(otg, enabled);
57
58 return -ENOTSUPP;
59 }
60
61 /* for HCDs */
62 static inline int
otg_set_host(struct usb_otg * otg,struct usb_bus * host)63 otg_set_host(struct usb_otg *otg, struct usb_bus *host)
64 {
65 if (otg && otg->set_host)
66 return otg->set_host(otg, host);
67
68 return -ENOTSUPP;
69 }
70
71 /* for usb peripheral controller drivers */
72
73 /* Context: can sleep */
74 static inline int
otg_set_peripheral(struct usb_otg * otg,struct usb_gadget * periph)75 otg_set_peripheral(struct usb_otg *otg, struct usb_gadget *periph)
76 {
77 if (otg && otg->set_peripheral)
78 return otg->set_peripheral(otg, periph);
79
80 return -ENOTSUPP;
81 }
82
83 static inline int
otg_start_srp(struct usb_otg * otg)84 otg_start_srp(struct usb_otg *otg)
85 {
86 if (otg && otg->start_srp)
87 return otg->start_srp(otg);
88
89 return -ENOTSUPP;
90 }
91
92 /* for OTG controller drivers (and maybe other stuff) */
93 extern int usb_bus_start_enum(struct usb_bus *bus, unsigned port_num);
94
95 enum usb_dr_mode {
96 USB_DR_MODE_UNKNOWN,
97 USB_DR_MODE_HOST,
98 USB_DR_MODE_PERIPHERAL,
99 USB_DR_MODE_OTG,
100 };
101
102 #endif /* __LINUX_USB_OTG_H */
103