Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
tjh.dev
kernel
os
linux
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/phy/phy.h>
13#include <linux/usb/phy.h>
14
15struct usb_otg {
16 u8 default_a;
17
18 struct phy *phy;
19 /* old usb_phy interface */
20 struct usb_phy *usb_phy;
21 struct usb_bus *host;
22 struct usb_gadget *gadget;
23
24 enum usb_otg_state state;
25
26 /* bind/unbind the host controller */
27 int (*set_host)(struct usb_otg *otg, struct usb_bus *host);
28
29 /* bind/unbind the peripheral controller */
30 int (*set_peripheral)(struct usb_otg *otg,
31 struct usb_gadget *gadget);
32
33 /* effective for A-peripheral, ignored for B devices */
34 int (*set_vbus)(struct usb_otg *otg, bool enabled);
35
36 /* for B devices only: start session with A-Host */
37 int (*start_srp)(struct usb_otg *otg);
38
39 /* start or continue HNP role switch */
40 int (*start_hnp)(struct usb_otg *otg);
41
42};
43
44extern const char *usb_otg_state_string(enum usb_otg_state state);
45
46/* Context: can sleep */
47static inline int
48otg_start_hnp(struct usb_otg *otg)
49{
50 if (otg && otg->start_hnp)
51 return otg->start_hnp(otg);
52
53 return -ENOTSUPP;
54}
55
56/* Context: can sleep */
57static inline int
58otg_set_vbus(struct usb_otg *otg, bool enabled)
59{
60 if (otg && otg->set_vbus)
61 return otg->set_vbus(otg, enabled);
62
63 return -ENOTSUPP;
64}
65
66/* for HCDs */
67static inline int
68otg_set_host(struct usb_otg *otg, struct usb_bus *host)
69{
70 if (otg && otg->set_host)
71 return otg->set_host(otg, host);
72
73 return -ENOTSUPP;
74}
75
76/* for usb peripheral controller drivers */
77
78/* Context: can sleep */
79static inline int
80otg_set_peripheral(struct usb_otg *otg, struct usb_gadget *periph)
81{
82 if (otg && otg->set_peripheral)
83 return otg->set_peripheral(otg, periph);
84
85 return -ENOTSUPP;
86}
87
88static inline int
89otg_start_srp(struct usb_otg *otg)
90{
91 if (otg && otg->start_srp)
92 return otg->start_srp(otg);
93
94 return -ENOTSUPP;
95}
96
97/* for OTG controller drivers (and maybe other stuff) */
98extern int usb_bus_start_enum(struct usb_bus *bus, unsigned port_num);
99
100enum usb_dr_mode {
101 USB_DR_MODE_UNKNOWN,
102 USB_DR_MODE_HOST,
103 USB_DR_MODE_PERIPHERAL,
104 USB_DR_MODE_OTG,
105};
106
107#endif /* __LINUX_USB_OTG_H */