SWAMPy

✎ CARVE FLESH

EDITING: otg.h

/* SPDX-License-Identifier: GPL-2.0 */
/* USB OTG (On The Go) defines */
/*
 *
 * These APIs may be used between USB controllers.  USB device drivers
 * (for either host or peripheral roles) don't use these calls; they
 * continue to use just usb_device and usb_gadget.
 */

#ifndef __LINUX_USB_OTG_H
#define __LINUX_USB_OTG_H

#include <linux/phy/phy.h>
#include <linux/usb/phy.h>

struct usb_otg {
	u8			default_a;

struct phy		*phy;
	/* old usb_phy interface */
	struct usb_phy		*usb_phy;
	struct usb_bus		*host;
	struct usb_gadget	*gadget;

enum usb_otg_state	state;

/* bind/unbind the host controller */
	int	(*set_host)(struct usb_otg *otg, struct usb_bus *host);

/* bind/unbind the peripheral controller */
	int	(*set_peripheral)(struct usb_otg *otg,
					struct usb_gadget *gadget);

/* effective for A-peripheral, ignored for B devices */
	int	(*set_vbus)(struct usb_otg *otg, bool enabled);

/* for B devices only:  start session with A-Host */
	int	(*start_srp)(struct usb_otg *otg);

/* start or continue HNP role switch */
	int	(*start_hnp)(struct usb_otg *otg);

};

/**
 * struct usb_otg_caps - describes the otg capabilities of the device
 * @otg_rev: The OTG revision number the device is compliant with, it's
 *		in binary-coded decimal (i.e. 2.0 is 0200H).
 * @hnp_support: Indicates if the device supports HNP.
 * @srp_support: Indicates if the device supports SRP.
 * @adp_support: Indicates if the device supports ADP.
 */
struct usb_otg_caps {
	u16 otg_rev;
	bool hnp_support;
	bool srp_support;
	bool adp_support;
};

extern const char *usb_otg_state_string(enum usb_otg_state state);

/* Context: can sleep */
static inline int
otg_start_hnp(struct usb_otg *otg)
{
	if (otg && otg->start_hnp)
		return otg->start_hnp(otg);

return -ENOTSUPP;
}

/* Context: can sleep */
static inline int
otg_set_vbus(struct usb_otg *otg, bool enabled)
{
	if (otg && otg->set_vbus)
		return otg->set_vbus(otg, enabled);

return -ENOTSUPP;
}

/* for HCDs */
static inline int
otg_set_host(struct usb_otg *otg, struct usb_bus *host)
{
	if (otg && otg->set_host)
		return otg->set_host(otg, host);

return -ENOTSUPP;
}

/* for usb peripheral controller drivers */

/* Context: can sleep */
static inline int
otg_set_peripheral(struct usb_otg *otg, struct usb_gadget *periph)
{
	if (otg && otg->set_peripheral)
		return otg->set_peripheral(otg, periph);

return -ENOTSUPP;
}

static inline int
otg_start_srp(struct usb_otg *otg)
{
	if (otg && otg->start_srp)
		return otg->start_srp(otg);

return -ENOTSUPP;
}

/* for OTG controller drivers (and maybe other stuff) */
extern int usb_bus_start_enum(struct usb_bus *bus, unsigned port_num);

enum usb_dr_mode {
	USB_DR_MODE_UNKNOWN,
	USB_DR_MODE_HOST,
	USB_DR_MODE_PERIPHERAL,
	USB_DR_MODE_OTG,
};

/**
 * usb_get_dr_mode - Get dual role mode for given device
 * @dev: Pointer to the given device
 *
 * The function gets phy interface string from property 'dr_mode',
 * and returns the corresponding enum usb_dr_mode
 */
extern enum usb_dr_mode usb_get_dr_mode(struct device *dev);
extern enum usb_dr_mode usb_get_role_switch_default_mode(struct device *dev);

#endif /* __LINUX_USB_OTG_H */

CANCEL

Name	Type	Size	Modified	Actions
↩ ..	DIR	—	—
📄 audio-v2.h	H	13.9 KB	2025-09-28 21:39	EDIT
📄 audio-v3.h	H	13.9 KB	2025-09-28 21:39	EDIT
📄 audio.h	H	1.1 KB	2025-09-28 21:39	EDIT
📄 c67x00.h	H	1.1 KB	2025-09-28 21:39	EDIT
📄 ccid.h	H	787 B	2025-09-28 21:39	EDIT
📄 cdc-wdm.h	H	511 B	2025-09-28 21:39	EDIT
📄 cdc.h	H	1.3 KB	2025-09-28 21:39	EDIT
📄 cdc_ncm.h	H	5.9 KB	2025-09-28 21:39	EDIT
📄 ch9.h	H	2.1 KB	2025-09-28 21:39	EDIT
📄 chipidea.h	H	3.6 KB	2025-09-28 21:39	EDIT
📄 composite.h	H	24.5 KB	2025-09-28 21:39	EDIT
📄 ehci-dbgp.h	H	2 KB	2025-09-28 21:39	EDIT
📄 ehci_def.h	H	7.4 KB	2025-09-28 21:39	EDIT
📄 ehci_pdriver.h	H	1.7 KB	2025-09-28 21:39	EDIT
📄 ezusb.h	H	286 B	2025-09-28 21:39	EDIT
📄 func_utils.h	H	2.7 KB	2025-09-28 21:39	EDIT
📄 functionfs.h	H	151 B	2025-09-28 21:39	EDIT
📄 g_hid.h	H	442 B	2025-09-28 21:39	EDIT
📄 gadget.h	H	37.6 KB	2026-07-01 20:12	EDIT
📄 gadget_configfs.h	H	2.9 KB	2025-09-28 21:39	EDIT
📄 hcd.h	H	27.4 KB	2025-09-28 21:39	EDIT
📄 input.h	H	526 B	2025-09-28 21:39	EDIT
📄 iowarrior.h	H	1.3 KB	2025-09-28 21:39	EDIT
📄 irda.h	H	3.8 KB	2025-09-28 21:39	EDIT
📄 isp116x.h	H	1.1 KB	2025-09-28 21:39	EDIT
📄 isp1301.h	H	1.9 KB	2025-09-28 21:39	EDIT
📄 isp1362.h	H	1.6 KB	2025-09-28 21:39	EDIT
📄 ljca.h	H	4.2 KB	2025-09-28 21:39	EDIT
📄 m66592.h	H	773 B	2025-09-28 21:39	EDIT
📄 mctp-usb.h	H	764 B	2025-09-28 21:39	EDIT
📄 midi-v2.h	H	3.5 KB	2025-09-28 21:39	EDIT
📄 musb-ux500.h	H	395 B	2025-09-28 21:39	EDIT
📄 musb.h	H	3.2 KB	2025-09-28 21:39	EDIT
📄 net2280.h	H	22.9 KB	2025-09-28 21:39	EDIT
📄 of.h	H	2 KB	2025-09-28 21:39	EDIT
📄 ohci_pdriver.h	H	1 KB	2025-09-28 21:39	EDIT
📄 onboard_dev.h	H	584 B	2025-09-28 21:39	EDIT
📄 otg-fsm.h	H	7.9 KB	2025-09-28 21:39	EDIT
📄 otg.h	H	3.1 KB	2025-09-28 21:39	EDIT
📄 pd.h	H	16.7 KB	2025-09-28 21:39	EDIT
📄 pd_ado.h	H	1.2 KB	2025-09-28 21:39	EDIT
📄 pd_bdo.h	H	556 B	2025-09-28 21:39	EDIT
📄 pd_ext_sdb.h	H	698 B	2025-09-28 21:39	EDIT
📄 pd_vdo.h	H	16.5 KB	2025-09-28 21:39	EDIT
📄 phy.h	H	8.1 KB	2025-09-28 21:39	EDIT
📄 phy_companion.h	H	693 B	2025-09-28 21:39	EDIT
📄 quirks.h	H	2.5 KB	2026-07-01 20:12	EDIT
📄 r8152.h	H	1 KB	2025-09-28 21:39	EDIT
📄 r8a66597.h	H	17 KB	2025-09-28 21:39	EDIT
📄 renesas_usbhs.h	H	3.6 KB	2025-09-28 21:39	EDIT
📄 rndis_host.h	H	5.3 KB	2025-09-28 21:39	EDIT
📄 role.h	H	3.6 KB	2025-09-28 21:39	EDIT
📄 rzv2m_usb3drd.h	H	450 B	2025-09-28 21:39	EDIT
📄 serial.h	H	17.2 KB	2025-09-28 21:39	EDIT
📄 sl811.h	H	838 B	2025-09-28 21:39	EDIT
📄 storage.h	H	2.8 KB	2025-09-28 21:39	EDIT
📄 tcpci.h	H	8.5 KB	2025-09-28 21:39	EDIT
📄 tcpm.h	H	7.7 KB	2025-09-28 21:39	EDIT
📄 tegra_usb_phy.h	H	2 KB	2025-09-28 21:39	EDIT
📄 typec.h	H	12.6 KB	2025-09-28 21:39	EDIT
📄 typec_altmode.h	H	7.7 KB	2025-09-28 21:39	EDIT
📄 typec_dp.h	H	4.7 KB	2025-09-28 21:39	EDIT
📄 typec_mux.h	H	2.8 KB	2025-09-28 21:39	EDIT
📄 typec_retimer.h	H	1.2 KB	2025-09-28 21:39	EDIT
📄 typec_tbt.h	H	1.8 KB	2025-09-28 21:39	EDIT
📄 uas.h	H	2.1 KB	2025-09-28 21:39	EDIT
📄 ulpi.h	H	1.9 KB	2025-09-28 21:39	EDIT
📄 usb338x.h	H	7.3 KB	2025-09-28 21:39	EDIT
📄 usb_phy_generic.h	H	582 B	2025-09-28 21:39	EDIT
📄 usbnet.h	H	10.1 KB	2025-09-28 21:39	EDIT
📄 uvc.h	H	6.6 KB	2025-09-28 21:39	EDIT
📄 webusb.h	H	2.4 KB	2025-09-28 21:39	EDIT
📄 xhci-dbgp.h	H	651 B	2025-09-28 21:39	EDIT
📄 xhci-sideband.h	H	3.1 KB	2025-09-28 21:39	EDIT