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 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 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 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 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 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