xref: /openbmc/linux/drivers/usb/cdns3/drd.h (revision b868a02e)
1 /* SPDX-License-Identifier: GPL-2.0 */
2 /*
3  * Cadence USB3 and USBSSP DRD header file.
4  *
5  * Copyright (C) 2018-2020 Cadence.
6  *
7  * Author: Pawel Laszczak <pawell@cadence.com>
8  */
9 #ifndef __LINUX_CDNS3_DRD
10 #define __LINUX_CDNS3_DRD
11 
12 #include <linux/usb/otg.h>
13 #include "core.h"
14 
15 /*  DRD register interface for version v1 of cdns3 driver. */
16 struct cdns3_otg_regs {
17 	__le32 did;
18 	__le32 rid;
19 	__le32 capabilities;
20 	__le32 reserved1;
21 	__le32 cmd;
22 	__le32 sts;
23 	__le32 state;
24 	__le32 reserved2;
25 	__le32 ien;
26 	__le32 ivect;
27 	__le32 refclk;
28 	__le32 tmr;
29 	__le32 reserved3[4];
30 	__le32 simulate;
31 	__le32 override;
32 	__le32 susp_ctrl;
33 	__le32 phyrst_cfg;
34 	__le32 anasts;
35 	__le32 adp_ramp_time;
36 	__le32 ctrl1;
37 	__le32 ctrl2;
38 };
39 
40 /*  DRD register interface for version v0 of cdns3 driver. */
41 struct cdns3_otg_legacy_regs {
42 	__le32 cmd;
43 	__le32 sts;
44 	__le32 state;
45 	__le32 refclk;
46 	__le32 ien;
47 	__le32 ivect;
48 	__le32 reserved1[3];
49 	__le32 tmr;
50 	__le32 reserved2[2];
51 	__le32 version;
52 	__le32 capabilities;
53 	__le32 reserved3[2];
54 	__le32 simulate;
55 	__le32 reserved4[5];
56 	__le32 ctrl1;
57 };
58 
59 /* DRD register interface for cdnsp driver */
60 struct cdnsp_otg_regs {
61 	__le32 did;
62 	__le32 rid;
63 	__le32 cfgs1;
64 	__le32 cfgs2;
65 	__le32 cmd;
66 	__le32 sts;
67 	__le32 state;
68 	__le32 ien;
69 	__le32 ivect;
70 	__le32 tmr;
71 	__le32 simulate;
72 	__le32 adpbc_sts;
73 	__le32 adp_ramp_time;
74 	__le32 adpbc_ctrl1;
75 	__le32 adpbc_ctrl2;
76 	__le32 override;
77 	__le32 vbusvalid_dbnc_cfg;
78 	__le32 sessvalid_dbnc_cfg;
79 	__le32 susp_timing_ctrl;
80 };
81 
82 #define OTG_CDNSP_DID	0x0004034E
83 
84 /*
85  * Common registers interface for both CDNS3 and CDNSP version of DRD.
86  */
87 struct cdns_otg_common_regs {
88 	__le32 cmd;
89 	__le32 sts;
90 	__le32 state;
91 };
92 
93 /*
94  * Interrupt related registers. This registers are mapped in different
95  * location for CDNSP controller.
96  */
97 struct cdns_otg_irq_regs {
98 	__le32 ien;
99 	__le32 ivect;
100 };
101 
102 /* CDNS_RID - bitmasks */
103 #define CDNS_RID(p)			((p) & GENMASK(15, 0))
104 
105 /* CDNS_VID - bitmasks */
106 #define CDNS_DID(p)			((p) & GENMASK(31, 0))
107 
108 /* OTGCMD - bitmasks */
109 /* "Request the bus for Device mode. */
110 #define OTGCMD_DEV_BUS_REQ		BIT(0)
111 /* Request the bus for Host mode */
112 #define OTGCMD_HOST_BUS_REQ		BIT(1)
113 /* Enable OTG mode. */
114 #define OTGCMD_OTG_EN			BIT(2)
115 /* Disable OTG mode */
116 #define OTGCMD_OTG_DIS			BIT(3)
117 /*"Configure OTG as A-Device. */
118 #define OTGCMD_A_DEV_EN			BIT(4)
119 /*"Configure OTG as A-Device. */
120 #define OTGCMD_A_DEV_DIS		BIT(5)
121 /* Drop the bus for Device mod	e. */
122 #define OTGCMD_DEV_BUS_DROP		BIT(8)
123 /* Drop the bus for Host mode*/
124 #define OTGCMD_HOST_BUS_DROP		BIT(9)
125 /* Power Down USBSS-DEV - only for CDNS3.*/
126 #define OTGCMD_DEV_POWER_OFF		BIT(11)
127 /* Power Down CDNSXHCI - only for CDNS3. */
128 #define OTGCMD_HOST_POWER_OFF		BIT(12)
129 
130 /* OTGIEN - bitmasks */
131 /* ID change interrupt enable */
132 #define OTGIEN_ID_CHANGE_INT		BIT(0)
133 /* Vbusvalid fall detected interrupt enable.*/
134 #define OTGIEN_VBUSVALID_RISE_INT	BIT(4)
135 /* Vbusvalid fall detected interrupt enable */
136 #define OTGIEN_VBUSVALID_FALL_INT	BIT(5)
137 
138 /* OTGSTS - bitmasks */
139 /*
140  * Current value of the ID pin. It is only valid when idpullup in
141  *  OTGCTRL1_TYPE register is set to '1'.
142  */
143 #define OTGSTS_ID_VALUE			BIT(0)
144 /* Current value of the vbus_valid */
145 #define OTGSTS_VBUS_VALID		BIT(1)
146 /* Current value of the b_sess_vld */
147 #define OTGSTS_SESSION_VALID		BIT(2)
148 /*Device mode is active*/
149 #define OTGSTS_DEV_ACTIVE		BIT(3)
150 /* Host mode is active. */
151 #define OTGSTS_HOST_ACTIVE		BIT(4)
152 /* OTG Controller not ready. */
153 #define OTGSTS_OTG_NRDY_MASK		BIT(11)
154 #define OTGSTS_OTG_NRDY(p)		((p) & OTGSTS_OTG_NRDY_MASK)
155 /*
156  * Value of the strap pins for:
157  * CDNS3:
158  * 000 - no default configuration
159  * 010 - Controller initiall configured as Host
160  * 100 - Controller initially configured as Device
161  * CDNSP:
162  * 000 - No default configuration.
163  * 010 - Controller initiall configured as Host.
164  * 100 - Controller initially configured as Device.
165  */
166 #define OTGSTS_STRAP(p)			(((p) & GENMASK(14, 12)) >> 12)
167 #define OTGSTS_STRAP_NO_DEFAULT_CFG	0x00
168 #define OTGSTS_STRAP_HOST_OTG		0x01
169 #define OTGSTS_STRAP_HOST		0x02
170 #define OTGSTS_STRAP_GADGET		0x04
171 #define OTGSTS_CDNSP_STRAP_HOST		0x01
172 #define OTGSTS_CDNSP_STRAP_GADGET	0x02
173 
174 /* Host mode is turned on. */
175 #define OTGSTS_CDNS3_XHCI_READY		BIT(26)
176 #define OTGSTS_CDNSP_XHCI_READY		BIT(27)
177 
178 /* "Device mode is turned on .*/
179 #define OTGSTS_CDNS3_DEV_READY		BIT(27)
180 #define OTGSTS_CDNSP_DEV_READY		BIT(26)
181 
182 /* OTGSTATE- bitmasks */
183 #define OTGSTATE_DEV_STATE_MASK		GENMASK(2, 0)
184 #define OTGSTATE_HOST_STATE_MASK	GENMASK(5, 3)
185 #define OTGSTATE_HOST_STATE_IDLE	0x0
186 #define OTGSTATE_HOST_STATE_VBUS_FALL	0x7
187 #define OTGSTATE_HOST_STATE(p)		(((p) & OTGSTATE_HOST_STATE_MASK) >> 3)
188 
189 /* OTGREFCLK - bitmasks */
190 #define OTGREFCLK_STB_CLK_SWITCH_EN	BIT(31)
191 
192 /* OVERRIDE - bitmasks */
193 #define OVERRIDE_IDPULLUP		BIT(0)
194 /* Only for CDNS3_CONTROLLER_V0 version */
195 #define OVERRIDE_IDPULLUP_V0		BIT(24)
196 /* Vbusvalid/Sesvalid override select. */
197 #define OVERRIDE_SESS_VLD_SEL		BIT(10)
198 
199 /* PHYRST_CFG - bitmasks */
200 #define PHYRST_CFG_PHYRST_A_ENABLE     BIT(0)
201 
202 #define CDNS3_ID_PERIPHERAL		1
203 #define CDNS3_ID_HOST			0
204 
205 bool cdns_is_host(struct cdns *cdns);
206 bool cdns_is_device(struct cdns *cdns);
207 int cdns_get_id(struct cdns *cdns);
208 int cdns_get_vbus(struct cdns *cdns);
209 void cdns_clear_vbus(struct cdns *cdns);
210 void cdns_set_vbus(struct cdns *cdns);
211 int cdns_drd_init(struct cdns *cdns);
212 int cdns_drd_exit(struct cdns *cdns);
213 int cdns_drd_update_mode(struct cdns *cdns);
214 int cdns_drd_gadget_on(struct cdns *cdns);
215 void cdns_drd_gadget_off(struct cdns *cdns);
216 int cdns_drd_host_on(struct cdns *cdns);
217 void cdns_drd_host_off(struct cdns *cdns);
218 bool cdns_power_is_lost(struct cdns *cdns);
219 #endif /* __LINUX_CDNS3_DRD */
220