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. */
16struct 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. */
41struct 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 */
60struct 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/* CDNSP driver supports 0x000403xx Cadence USB controller family. */
83#define OTG_CDNSP_CHECK_DID(did) (((did) & GENMASK(31, 8)) == 0x00040300)
84
85/* CDNS3 driver supports 0x000402xx Cadence USB controller family. */
86#define OTG_CDNS3_CHECK_DID(did) (((did) & GENMASK(31, 8)) == 0x00040200)
87
88/*
89 * Common registers interface for both CDNS3 and CDNSP version of DRD.
90 */
91struct cdns_otg_common_regs {
92 __le32 cmd;
93 __le32 sts;
94 __le32 state;
95};
96
97/*
98 * Interrupt related registers. This registers are mapped in different
99 * location for CDNSP controller.
100 */
101struct cdns_otg_irq_regs {
102 __le32 ien;
103 __le32 ivect;
104};
105
106/* CDNS_RID - bitmasks */
107#define CDNS_RID(p) ((p) & GENMASK(15, 0))
108
109/* CDNS_VID - bitmasks */
110#define CDNS_DID(p) ((p) & GENMASK(31, 0))
111
112/* OTGCMD - bitmasks */
113/* "Request the bus for Device mode. */
114#define OTGCMD_DEV_BUS_REQ BIT(0)
115/* Request the bus for Host mode */
116#define OTGCMD_HOST_BUS_REQ BIT(1)
117/* Enable OTG mode. */
118#define OTGCMD_OTG_EN BIT(2)
119/* Disable OTG mode */
120#define OTGCMD_OTG_DIS BIT(3)
121/*"Configure OTG as A-Device. */
122#define OTGCMD_A_DEV_EN BIT(4)
123/*"Configure OTG as A-Device. */
124#define OTGCMD_A_DEV_DIS BIT(5)
125/* Drop the bus for Device mod e. */
126#define OTGCMD_DEV_BUS_DROP BIT(8)
127/* Drop the bus for Host mode*/
128#define OTGCMD_HOST_BUS_DROP BIT(9)
129/* Power Down USBSS-DEV - only for CDNS3.*/
130#define OTGCMD_DEV_POWER_OFF BIT(11)
131/* Power Down CDNSXHCI - only for CDNS3. */
132#define OTGCMD_HOST_POWER_OFF BIT(12)
133
134/* OTGIEN - bitmasks */
135/* ID change interrupt enable */
136#define OTGIEN_ID_CHANGE_INT BIT(0)
137/* Vbusvalid fall detected interrupt enable.*/
138#define OTGIEN_VBUSVALID_RISE_INT BIT(4)
139/* Vbusvalid fall detected interrupt enable */
140#define OTGIEN_VBUSVALID_FALL_INT BIT(5)
141
142/* OTGSTS - bitmasks */
143/*
144 * Current value of the ID pin. It is only valid when idpullup in
145 * OTGCTRL1_TYPE register is set to '1'.
146 */
147#define OTGSTS_ID_VALUE BIT(0)
148/* Current value of the vbus_valid */
149#define OTGSTS_VBUS_VALID BIT(1)
150/* Current value of the b_sess_vld */
151#define OTGSTS_SESSION_VALID BIT(2)
152/*Device mode is active*/
153#define OTGSTS_DEV_ACTIVE BIT(3)
154/* Host mode is active. */
155#define OTGSTS_HOST_ACTIVE BIT(4)
156/* OTG Controller not ready. */
157#define OTGSTS_OTG_NRDY_MASK BIT(11)
158#define OTGSTS_OTG_NRDY(p) ((p) & OTGSTS_OTG_NRDY_MASK)
159/*
160 * Value of the strap pins for:
161 * CDNS3:
162 * 000 - no default configuration
163 * 010 - Controller initiall configured as Host
164 * 100 - Controller initially configured as Device
165 * CDNSP:
166 * 000 - No default configuration.
167 * 010 - Controller initiall configured as Host.
168 * 100 - Controller initially configured as Device.
169 */
170#define OTGSTS_STRAP(p) (((p) & GENMASK(14, 12)) >> 12)
171#define OTGSTS_STRAP_NO_DEFAULT_CFG 0x00
172#define OTGSTS_STRAP_HOST_OTG 0x01
173#define OTGSTS_STRAP_HOST 0x02
174#define OTGSTS_STRAP_GADGET 0x04
175#define OTGSTS_CDNSP_STRAP_HOST 0x01
176#define OTGSTS_CDNSP_STRAP_GADGET 0x02
177
178/* Host mode is turned on. */
179#define OTGSTS_CDNS3_XHCI_READY BIT(26)
180#define OTGSTS_CDNSP_XHCI_READY BIT(27)
181
182/* "Device mode is turned on .*/
183#define OTGSTS_CDNS3_DEV_READY BIT(27)
184#define OTGSTS_CDNSP_DEV_READY BIT(26)
185
186/* OTGSTATE- bitmasks */
187#define OTGSTATE_DEV_STATE_MASK GENMASK(2, 0)
188#define OTGSTATE_HOST_STATE_MASK GENMASK(5, 3)
189#define OTGSTATE_HOST_STATE_IDLE 0x0
190#define OTGSTATE_HOST_STATE_VBUS_FALL 0x7
191#define OTGSTATE_HOST_STATE(p) (((p) & OTGSTATE_HOST_STATE_MASK) >> 3)
192
193/* OTGREFCLK - bitmasks */
194#define OTGREFCLK_STB_CLK_SWITCH_EN BIT(31)
195
196/* OVERRIDE - bitmasks */
197#define OVERRIDE_IDPULLUP BIT(0)
198/* Only for CDNS3_CONTROLLER_V0 version */
199#define OVERRIDE_IDPULLUP_V0 BIT(24)
200/* Vbusvalid/Sesvalid override select. */
201#define OVERRIDE_SESS_VLD_SEL BIT(10)
202
203/* PHYRST_CFG - bitmasks */
204#define PHYRST_CFG_PHYRST_A_ENABLE BIT(0)
205
206#define CDNS3_ID_PERIPHERAL 1
207#define CDNS3_ID_HOST 0
208
209bool cdns_is_host(struct cdns *cdns);
210bool cdns_is_device(struct cdns *cdns);
211int cdns_get_id(struct cdns *cdns);
212int cdns_get_vbus(struct cdns *cdns);
213void cdns_clear_vbus(struct cdns *cdns);
214void cdns_set_vbus(struct cdns *cdns);
215int cdns_drd_init(struct cdns *cdns);
216int cdns_drd_exit(struct cdns *cdns);
217int cdns_drd_update_mode(struct cdns *cdns);
218int cdns_drd_gadget_on(struct cdns *cdns);
219void cdns_drd_gadget_off(struct cdns *cdns);
220int cdns_drd_host_on(struct cdns *cdns);
221void cdns_drd_host_off(struct cdns *cdns);
222bool cdns_power_is_lost(struct cdns *cdns);
223#endif /* __LINUX_CDNS3_DRD */
224

source code of linux/drivers/usb/cdns3/drd.h