1/* SPDX-License-Identifier: GPL-2.0 */
2/*
3 * Platform data for the chipidea USB dual role controller
4 */
5
6#ifndef __LINUX_USB_CHIPIDEA_H
7#define __LINUX_USB_CHIPIDEA_H
8
9#include <linux/extcon.h>
10#include <linux/usb/otg.h>
11
12struct ci_hdrc;
13
14/**
15 * struct ci_hdrc_cable - structure for external connector cable state tracking
16 * @connected: true if cable is connected, false otherwise
17 * @changed: set to true when extcon event happen
18 * @enabled: set to true if we've enabled the vbus or id interrupt
19 * @edev: device which generate events
20 * @ci: driver state of the chipidea device
21 * @nb: hold event notification callback
22 * @conn: used for notification registration
23 */
24struct ci_hdrc_cable {
25 bool connected;
26 bool changed;
27 bool enabled;
28 struct extcon_dev *edev;
29 struct ci_hdrc *ci;
30 struct notifier_block nb;
31};
32
33struct ci_hdrc_platform_data {
34 const char *name;
35 /* offset of the capability registers */
36 uintptr_t capoffset;
37 unsigned power_budget;
38 struct phy *phy;
39 /* old usb_phy interface */
40 struct usb_phy *usb_phy;
41 enum usb_phy_interface phy_mode;
42 unsigned long flags;
43#define CI_HDRC_REGS_SHARED BIT(0)
44#define CI_HDRC_DISABLE_DEVICE_STREAMING BIT(1)
45#define CI_HDRC_SUPPORTS_RUNTIME_PM BIT(2)
46#define CI_HDRC_DISABLE_HOST_STREAMING BIT(3)
47#define CI_HDRC_DISABLE_STREAMING (CI_HDRC_DISABLE_DEVICE_STREAMING | \
48 CI_HDRC_DISABLE_HOST_STREAMING)
49 /*
50 * Only set it when DCCPARAMS.DC==1 and DCCPARAMS.HC==1,
51 * but otg is not supported (no register otgsc).
52 */
53#define CI_HDRC_DUAL_ROLE_NOT_OTG BIT(4)
54#define CI_HDRC_IMX28_WRITE_FIX BIT(5)
55#define CI_HDRC_FORCE_FULLSPEED BIT(6)
56#define CI_HDRC_TURN_VBUS_EARLY_ON BIT(7)
57#define CI_HDRC_SET_NON_ZERO_TTHA BIT(8)
58#define CI_HDRC_OVERRIDE_AHB_BURST BIT(9)
59#define CI_HDRC_OVERRIDE_TX_BURST BIT(10)
60#define CI_HDRC_OVERRIDE_RX_BURST BIT(11)
61#define CI_HDRC_OVERRIDE_PHY_CONTROL BIT(12) /* Glue layer manages phy */
62#define CI_HDRC_REQUIRES_ALIGNED_DMA BIT(13)
63#define CI_HDRC_IMX_IS_HSIC BIT(14)
64#define CI_HDRC_PMQOS BIT(15)
65#define CI_HDRC_PHY_VBUS_CONTROL BIT(16)
66#define CI_HDRC_HAS_PORTSC_PEC_MISSED BIT(17)
67#define CI_HDRC_FORCE_VBUS_ACTIVE_ALWAYS BIT(18)
68 enum usb_dr_mode dr_mode;
69#define CI_HDRC_CONTROLLER_RESET_EVENT 0
70#define CI_HDRC_CONTROLLER_STOPPED_EVENT 1
71#define CI_HDRC_IMX_HSIC_ACTIVE_EVENT 2
72#define CI_HDRC_IMX_HSIC_SUSPEND_EVENT 3
73#define CI_HDRC_CONTROLLER_VBUS_EVENT 4
74 int (*notify_event) (struct ci_hdrc *ci, unsigned event);
75 struct regulator *reg_vbus;
76 struct usb_otg_caps ci_otg_caps;
77 bool tpl_support;
78 /* interrupt threshold setting */
79 u32 itc_setting;
80 u32 ahb_burst_config;
81 u32 tx_burst_size;
82 u32 rx_burst_size;
83
84 /* VBUS and ID signal state tracking, using extcon framework */
85 struct ci_hdrc_cable vbus_extcon;
86 struct ci_hdrc_cable id_extcon;
87 u32 phy_clkgate_delay_us;
88
89 /* pins */
90 struct pinctrl *pctl;
91 struct pinctrl_state *pins_default;
92 struct pinctrl_state *pins_host;
93 struct pinctrl_state *pins_device;
94
95 /* platform-specific hooks */
96 int (*hub_control)(struct ci_hdrc *ci, u16 typeReq, u16 wValue,
97 u16 wIndex, char *buf, u16 wLength,
98 bool *done, unsigned long *flags);
99 void (*enter_lpm)(struct ci_hdrc *ci, bool enable);
100};
101
102/* Default offset of capability registers */
103#define DEF_CAPOFFSET 0x100
104
105/* Add ci hdrc device */
106struct platform_device *ci_hdrc_add_device(struct device *dev,
107 struct resource *res, int nres,
108 struct ci_hdrc_platform_data *platdata);
109/* Remove ci hdrc device */
110void ci_hdrc_remove_device(struct platform_device *pdev);
111/* Get current available role */
112enum usb_dr_mode ci_hdrc_query_available_role(struct platform_device *pdev);
113
114#endif
115

source code of linux/include/linux/usb/chipidea.h