| blob | bc4024041ef2669db01dc24634624202e4a7d46a |
1 /* SPDX-License-Identifier: GPL-2.0 */
2 /*
3 * USBSS device controller driver header file
4 *
5 * Copyright (C) 2018-2019 Cadence.
6 * Copyright (C) 2017-2018 NXP
7 *
8 * Author: Pawel Laszczak <pawell@cadence.com>
9 * Pawel Jez <pjez@cadence.com>
10 * Peter Chen <peter.chen@nxp.com>
11 */
12 #ifndef __LINUX_CDNS3_GADGET
13 #define __LINUX_CDNS3_GADGET
14 #include <linux/usb/gadget.h>
16 /*
17 * USBSS-DEV register interface.
18 * This corresponds to the USBSS Device Controller Interface
19 */
21 /**
22 * struct cdns3_usb_regs - device controller registers.
23 * @usb_conf: Global Configuration.
24 * @usb_sts: Global Status.
25 * @usb_cmd: Global Command.
26 * @usb_itpn: ITP/SOF number.
27 * @usb_lpm: Global Command.
28 * @usb_ien: USB Interrupt Enable.
29 * @usb_ists: USB Interrupt Status.
30 * @ep_sel: Endpoint Select.
31 * @ep_traddr: Endpoint Transfer Ring Address.
32 * @ep_cfg: Endpoint Configuration.
33 * @ep_cmd: Endpoint Command.
34 * @ep_sts: Endpoint Status.
35 * @ep_sts_sid: Endpoint Status.
36 * @ep_sts_en: Endpoint Status Enable.
37 * @drbl: Doorbell.
38 * @ep_ien: EP Interrupt Enable.
39 * @ep_ists: EP Interrupt Status.
40 * @usb_pwr: Global Power Configuration.
41 * @usb_conf2: Global Configuration 2.
42 * @usb_cap1: Capability 1.
43 * @usb_cap2: Capability 2.
44 * @usb_cap3: Capability 3.
45 * @usb_cap4: Capability 4.
46 * @usb_cap5: Capability 5.
47 * @usb_cap6: Capability 6.
48 * @usb_cpkt1: Custom Packet 1.
49 * @usb_cpkt2: Custom Packet 2.
50 * @usb_cpkt3: Custom Packet 3.
51 * @ep_dma_ext_addr: Upper address for DMA operations.
52 * @buf_addr: Address for On-chip Buffer operations.
53 * @buf_data: Data for On-chip Buffer operations.
54 * @buf_ctrl: On-chip Buffer Access Control.
55 * @dtrans: DMA Transfer Mode.
56 * @tdl_from_trb: Source of TD Configuration.
57 * @tdl_beh: TDL Behavior Configuration.
58 * @ep_tdl: Endpoint TDL.
59 * @tdl_beh2: TDL Behavior 2 Configuration.
60 * @dma_adv_td: DMA Advance TD Configuration.
61 * @reserved1: Reserved.
62 * @cfg_regs: Configuration.
63 * @reserved2: Reserved.
64 * @dma_axi_ctrl: AXI Control.
65 * @dma_axi_id: AXI ID register.
66 * @dma_axi_cap: AXI Capability.
67 * @dma_axi_ctrl0: AXI Control 0.
68 * @dma_axi_ctrl1: AXI Control 1.
69 */
71 __le32 usb_conf;
72 __le32 usb_sts;
73 __le32 usb_cmd;
74 __le32 usb_itpn;
75 __le32 usb_lpm;
76 __le32 usb_ien;
77 __le32 usb_ists;
78 __le32 ep_sel;
79 __le32 ep_traddr;
80 __le32 ep_cfg;
81 __le32 ep_cmd;
82 __le32 ep_sts;
83 __le32 ep_sts_sid;
84 __le32 ep_sts_en;
85 __le32 drbl;
86 __le32 ep_ien;
87 __le32 ep_ists;
88 __le32 usb_pwr;
89 __le32 usb_conf2;
90 __le32 usb_cap1;
91 __le32 usb_cap2;
92 __le32 usb_cap3;
93 __le32 usb_cap4;
94 __le32 usb_cap5;
95 __le32 usb_cap6;
96 __le32 usb_cpkt1;
97 __le32 usb_cpkt2;
98 __le32 usb_cpkt3;
99 __le32 ep_dma_ext_addr;
100 __le32 buf_addr;
101 __le32 buf_data;
102 __le32 buf_ctrl;
103 __le32 dtrans;
104 __le32 tdl_from_trb;
105 __le32 tdl_beh;
106 __le32 ep_tdl;
107 __le32 tdl_beh2;
108 __le32 dma_adv_td;
110 __le32 cfg_reg1;
111 __le32 dbg_link1;
112 __le32 dbg_link2;
115 __le32 dma_axi_ctrl;
116 __le32 dma_axi_id;
117 __le32 dma_axi_cap;
118 __le32 dma_axi_ctrl0;
119 __le32 dma_axi_ctrl1;
120 };
122 /* USB_CONF - bitmasks */
123 /* Reset USB device configuration. */
124 #define USB_CONF_CFGRST BIT(0)
125 /* Set Configuration. */
126 #define USB_CONF_CFGSET BIT(1)
127 /* Disconnect USB device in SuperSpeed. */
128 #define USB_CONF_USB3DIS BIT(3)
129 /* Disconnect USB device in HS/FS */
130 #define USB_CONF_USB2DIS BIT(4)
131 /* Little Endian access - default */
132 #define USB_CONF_LENDIAN BIT(5)
133 /*
134 * Big Endian access. Driver assume that byte order for
135 * SFRs access always is as Little Endian so this bit
136 * is not used.
137 */
138 #define USB_CONF_BENDIAN BIT(6)
139 /* Device software reset. */
140 #define USB_CONF_SWRST BIT(7)
141 /* Singular DMA transfer mode. Only for VER < DEV_VER_V3*/
142 #define USB_CONF_DSING BIT(8)
143 /* Multiple DMA transfers mode. Only for VER < DEV_VER_V3 */
144 #define USB_CONF_DMULT BIT(9)
145 /* DMA clock turn-off enable. */
146 #define USB_CONF_DMAOFFEN BIT(10)
147 /* DMA clock turn-off disable. */
148 #define USB_CONF_DMAOFFDS BIT(11)
149 /* Clear Force Full Speed. */
150 #define USB_CONF_CFORCE_FS BIT(12)
151 /* Set Force Full Speed. */
152 #define USB_CONF_SFORCE_FS BIT(13)
153 /* Device enable. */
154 #define USB_CONF_DEVEN BIT(14)
155 /* Device disable. */
156 #define USB_CONF_DEVDS BIT(15)
157 /* L1 LPM state entry enable (used in HS/FS mode). */
158 #define USB_CONF_L1EN BIT(16)
159 /* L1 LPM state entry disable (used in HS/FS mode). */
160 #define USB_CONF_L1DS BIT(17)
161 /* USB 2.0 clock gate disable. */
162 #define USB_CONF_CLK2OFFEN BIT(18)
163 /* USB 2.0 clock gate enable. */
164 #define USB_CONF_CLK2OFFDS BIT(19)
165 /* L0 LPM state entry request (used in HS/FS mode). */
166 #define USB_CONF_LGO_L0 BIT(20)
167 /* USB 3.0 clock gate disable. */
168 #define USB_CONF_CLK3OFFEN BIT(21)
169 /* USB 3.0 clock gate enable. */
170 #define USB_CONF_CLK3OFFDS BIT(22)
171 /* Bit 23 is reserved*/
172 /* U1 state entry enable (used in SS mode). */
173 #define USB_CONF_U1EN BIT(24)
174 /* U1 state entry disable (used in SS mode). */
175 #define USB_CONF_U1DS BIT(25)
176 /* U2 state entry enable (used in SS mode). */
177 #define USB_CONF_U2EN BIT(26)
178 /* U2 state entry disable (used in SS mode). */
179 #define USB_CONF_U2DS BIT(27)
180 /* U0 state entry request (used in SS mode). */
181 #define USB_CONF_LGO_U0 BIT(28)
182 /* U1 state entry request (used in SS mode). */
183 #define USB_CONF_LGO_U1 BIT(29)
184 /* U2 state entry request (used in SS mode). */
185 #define USB_CONF_LGO_U2 BIT(30)
186 /* SS.Inactive state entry request (used in SS mode) */
187 #define USB_CONF_LGO_SSINACT BIT(31)
189 /* USB_STS - bitmasks */
190 /*
191 * Configuration status.
192 * 1 - device is in the configured state.
193 * 0 - device is not configured.
194 */
195 #define USB_STS_CFGSTS_MASK BIT(0)
196 #define USB_STS_CFGSTS(p) ((p) & USB_STS_CFGSTS_MASK)
197 /*
198 * On-chip memory overflow.
199 * 0 - On-chip memory status OK.
200 * 1 - On-chip memory overflow.
201 */
202 #define USB_STS_OV_MASK BIT(1)
203 #define USB_STS_OV(p) ((p) & USB_STS_OV_MASK)
204 /*
205 * SuperSpeed connection status.
206 * 0 - USB in SuperSpeed mode disconnected.
207 * 1 - USB in SuperSpeed mode connected.
208 */
209 #define USB_STS_USB3CONS_MASK BIT(2)
210 #define USB_STS_USB3CONS(p) ((p) & USB_STS_USB3CONS_MASK)
211 /*
212 * DMA transfer configuration status.
213 * 0 - single request.
214 * 1 - multiple TRB chain
215 * Supported only for controller version < DEV_VER_V3
216 */
217 #define USB_STS_DTRANS_MASK BIT(3)
218 #define USB_STS_DTRANS(p) ((p) & USB_STS_DTRANS_MASK)
219 /*
220 * Device speed.
221 * 0 - Undefined (value after reset).
222 * 1 - Low speed
223 * 2 - Full speed
224 * 3 - High speed
225 * 4 - Super speed
226 */
227 #define USB_STS_USBSPEED_MASK GENMASK(6, 4)
228 #define USB_STS_USBSPEED(p) (((p) & USB_STS_USBSPEED_MASK) >> 4)
229 #define USB_STS_LS (0x1 << 4)
230 #define USB_STS_FS (0x2 << 4)
231 #define USB_STS_HS (0x3 << 4)
232 #define USB_STS_SS (0x4 << 4)
233 #define DEV_UNDEFSPEED(p) (((p) & USB_STS_USBSPEED_MASK) == (0x0 << 4))
234 #define DEV_LOWSPEED(p) (((p) & USB_STS_USBSPEED_MASK) == USB_STS_LS)
235 #define DEV_FULLSPEED(p) (((p) & USB_STS_USBSPEED_MASK) == USB_STS_FS)
236 #define DEV_HIGHSPEED(p) (((p) & USB_STS_USBSPEED_MASK) == USB_STS_HS)
237 #define DEV_SUPERSPEED(p) (((p) & USB_STS_USBSPEED_MASK) == USB_STS_SS)
238 /*
239 * Endianness for SFR access.
240 * 0 - Little Endian order (default after hardware reset).
241 * 1 - Big Endian order
242 */
243 #define USB_STS_ENDIAN_MASK BIT(7)
244 #define USB_STS_ENDIAN(p) ((p) & USB_STS_ENDIAN_MASK)
245 /*
246 * HS/FS clock turn-off status.
247 * 0 - hsfs clock is always on.
248 * 1 - hsfs clock turn-off in L2 (HS/FS mode) is enabled
249 * (default after hardware reset).
250 */
251 #define USB_STS_CLK2OFF_MASK BIT(8)
252 #define USB_STS_CLK2OFF(p) ((p) & USB_STS_CLK2OFF_MASK)
253 /*
254 * PCLK clock turn-off status.
255 * 0 - pclk clock is always on.
256 * 1 - pclk clock turn-off in U3 (SS mode) is enabled
257 * (default after hardware reset).
258 */
259 #define USB_STS_CLK3OFF_MASK BIT(9)
260 #define USB_STS_CLK3OFF(p) ((p) & USB_STS_CLK3OFF_MASK)
261 /*
262 * Controller in reset state.
263 * 0 - Internal reset is active.
264 * 1 - Internal reset is not active and controller is fully operational.
265 */
266 #define USB_STS_IN_RST_MASK BIT(10)
267 #define USB_STS_IN_RST(p) ((p) & USB_STS_IN_RST_MASK)
268 /*
269 * Status of the "TDL calculation basing on TRB" feature.
270 * 0 - disabled
271 * 1 - enabled
272 * Supported only for DEV_VER_V2 controller version.
273 */
274 #define USB_STS_TDL_TRB_ENABLED BIT(11)
275 /*
276 * Device enable Status.
277 * 0 - USB device is disabled (VBUS input is disconnected from internal logic).
278 * 1 - USB device is enabled (VBUS input is connected to the internal logic).
279 */
280 #define USB_STS_DEVS_MASK BIT(14)
281 #define USB_STS_DEVS(p) ((p) & USB_STS_DEVS_MASK)
282 /*
283 * Address status.
284 * 0 - USB device is default state.
285 * 1 - USB device is at least in address state.
286 */
287 #define USB_STS_ADDRESSED_MASK BIT(15)
288 #define USB_STS_ADDRESSED(p) ((p) & USB_STS_ADDRESSED_MASK)
289 /*
290 * L1 LPM state enable status (used in HS/FS mode).
291 * 0 - Entering to L1 LPM state disabled.
292 * 1 - Entering to L1 LPM state enabled.
293 */
294 #define USB_STS_L1ENS_MASK BIT(16)
295 #define USB_STS_L1ENS(p) ((p) & USB_STS_L1ENS_MASK)
296 /*
297 * Internal VBUS connection status (used both in HS/FS and SS mode).
298 * 0 - internal VBUS is not detected.
299 * 1 - internal VBUS is detected.
300 */
301 #define USB_STS_VBUSS_MASK BIT(17)
302 #define USB_STS_VBUSS(p) ((p) & USB_STS_VBUSS_MASK)
303 /*
304 * HS/FS LPM state (used in FS/HS mode).
305 * 0 - L0 State
306 * 1 - L1 State
307 * 2 - L2 State
308 * 3 - L3 State
309 */
310 #define USB_STS_LPMST_MASK GENMASK(19, 18)
311 #define DEV_L0_STATE(p) (((p) & USB_STS_LPMST_MASK) == (0x0 << 18))
312 #define DEV_L1_STATE(p) (((p) & USB_STS_LPMST_MASK) == (0x1 << 18))
313 #define DEV_L2_STATE(p) (((p) & USB_STS_LPMST_MASK) == (0x2 << 18))
314 #define DEV_L3_STATE(p) (((p) & USB_STS_LPMST_MASK) == (0x3 << 18))
315 /*
316 * Disable HS status (used in FS/HS mode).
317 * 0 - the disconnect bit for HS/FS mode is set .
318 * 1 - the disconnect bit for HS/FS mode is not set.
319 */
320 #define USB_STS_USB2CONS_MASK BIT(20)
321 #define USB_STS_USB2CONS(p) ((p) & USB_STS_USB2CONS_MASK)
322 /*
323 * HS/FS mode connection status (used in FS/HS mode).
324 * 0 - High Speed operations in USB2.0 (FS/HS) mode not disabled.
325 * 1 - High Speed operations in USB2.0 (FS/HS).
326 */
327 #define USB_STS_DISABLE_HS_MASK BIT(21)
328 #define USB_STS_DISABLE_HS(p) ((p) & USB_STS_DISABLE_HS_MASK)
329 /*
330 * U1 state enable status (used in SS mode).
331 * 0 - Entering to U1 state disabled.
332 * 1 - Entering to U1 state enabled.
333 */
334 #define USB_STS_U1ENS_MASK BIT(24)
335 #define USB_STS_U1ENS(p) ((p) & USB_STS_U1ENS_MASK)
336 /*
337 * U2 state enable status (used in SS mode).
338 * 0 - Entering to U2 state disabled.
339 * 1 - Entering to U2 state enabled.
340 */
341 #define USB_STS_U2ENS_MASK BIT(25)
342 #define USB_STS_U2ENS(p) ((p) & USB_STS_U2ENS_MASK)
343 /*
344 * SuperSpeed Link LTSSM state. This field reflects USBSS-DEV current
345 * SuperSpeed link state
346 */
347 #define USB_STS_LST_MASK GENMASK(29, 26)
348 #define DEV_LST_U0 (((p) & USB_STS_LST_MASK) == (0x0 << 26))
349 #define DEV_LST_U1 (((p) & USB_STS_LST_MASK) == (0x1 << 26))
350 #define DEV_LST_U2 (((p) & USB_STS_LST_MASK) == (0x2 << 26))
351 #define DEV_LST_U3 (((p) & USB_STS_LST_MASK) == (0x3 << 26))
352 #define DEV_LST_DISABLED (((p) & USB_STS_LST_MASK) == (0x4 << 26))
353 #define DEV_LST_RXDETECT (((p) & USB_STS_LST_MASK) == (0x5 << 26))
354 #define DEV_LST_INACTIVE (((p) & USB_STS_LST_MASK) == (0x6 << 26))
355 #define DEV_LST_POLLING (((p) & USB_STS_LST_MASK) == (0x7 << 26))
356 #define DEV_LST_RECOVERY (((p) & USB_STS_LST_MASK) == (0x8 << 26))
357 #define DEV_LST_HOT_RESET (((p) & USB_STS_LST_MASK) == (0x9 << 26))
358 #define DEV_LST_COMP_MODE (((p) & USB_STS_LST_MASK) == (0xa << 26))
359 #define DEV_LST_LB_STATE (((p) & USB_STS_LST_MASK) == (0xb << 26))
360 /*
361 * DMA clock turn-off status.
362 * 0 - DMA clock is always on (default after hardware reset).
363 * 1 - DMA clock turn-off in U1, U2 and U3 (SS mode) is enabled.
364 */
365 #define USB_STS_DMAOFF_MASK BIT(30)
366 #define USB_STS_DMAOFF(p) ((p) & USB_STS_DMAOFF_MASK)
367 /*
368 * SFR Endian status.
369 * 0 - Little Endian order (default after hardware reset).
370 * 1 - Big Endian order.
371 */
372 #define USB_STS_ENDIAN2_MASK BIT(31)
373 #define USB_STS_ENDIAN2(p) ((p) & USB_STS_ENDIAN2_MASK)
375 /* USB_CMD - bitmasks */
376 /* Set Function Address */
377 #define USB_CMD_SET_ADDR BIT(0)
378 /*
379 * Function Address This field is saved to the device only when the field
380 * SET_ADDR is set '1 ' during write to USB_CMD register.
381 * Software is responsible for entering the address of the device during
382 * SET_ADDRESS request service. This field should be set immediately after
383 * the SETUP packet is decoded, and prior to confirmation of the status phase
384 */
385 #define USB_CMD_FADDR_MASK GENMASK(7, 1)
386 #define USB_CMD_FADDR(p) (((p) << 1) & USB_CMD_FADDR_MASK)
387 /* Send Function Wake Device Notification TP (used only in SS mode). */
388 #define USB_CMD_SDNFW BIT(8)
389 /* Set Test Mode (used only in HS/FS mode). */
390 #define USB_CMD_STMODE BIT(9)
391 /* Test mode selector (used only in HS/FS mode) */
392 #define USB_STS_TMODE_SEL_MASK GENMASK(11, 10)
393 #define USB_STS_TMODE_SEL(p) (((p) << 10) & USB_STS_TMODE_SEL_MASK)
394 /*
395 * Send Latency Tolerance Message Device Notification TP (used only
396 * in SS mode).
397 */
398 #define USB_CMD_SDNLTM BIT(12)
399 /* Send Custom Transaction Packet (used only in SS mode) */
400 #define USB_CMD_SPKT BIT(13)
401 /*Device Notification 'Function Wake' - Interface value (only in SS mode. */
402 #define USB_CMD_DNFW_INT_MASK GENMASK(23, 16)
403 #define USB_STS_DNFW_INT(p) (((p) << 16) & USB_CMD_DNFW_INT_MASK)
404 /*
405 * Device Notification 'Latency Tolerance Message' -373 BELT value [7:0]
406 * (used only in SS mode).
407 */
408 #define USB_CMD_DNLTM_BELT_MASK GENMASK(27, 16)
409 #define USB_STS_DNLTM_BELT(p) (((p) << 16) & USB_CMD_DNLTM_BELT_MASK)
411 /* USB_ITPN - bitmasks */
412 /*
413 * ITP(SS) / SOF (HS/FS) number
414 * In SS mode this field represent number of last ITP received from host.
415 * In HS/FS mode this field represent number of last SOF received from host.
416 */
417 #define USB_ITPN_MASK GENMASK(13, 0)
418 #define USB_ITPN(p) ((p) & USB_ITPN_MASK)
420 /* USB_LPM - bitmasks */
421 /* Host Initiated Resume Duration. */
422 #define USB_LPM_HIRD_MASK GENMASK(3, 0)
423 #define USB_LPM_HIRD(p) ((p) & USB_LPM_HIRD_MASK)
424 /* Remote Wakeup Enable (bRemoteWake). */
425 #define USB_LPM_BRW BIT(4)
427 /* USB_IEN - bitmasks */
428 /* SS connection interrupt enable */
429 #define USB_IEN_CONIEN BIT(0)
430 /* SS disconnection interrupt enable. */
431 #define USB_IEN_DISIEN BIT(1)
432 /* USB SS warm reset interrupt enable. */
433 #define USB_IEN_UWRESIEN BIT(2)
434 /* USB SS hot reset interrupt enable */
435 #define USB_IEN_UHRESIEN BIT(3)
436 /* SS link U3 state enter interrupt enable (suspend).*/
437 #define USB_IEN_U3ENTIEN BIT(4)
438 /* SS link U3 state exit interrupt enable (wakeup). */
439 #define USB_IEN_U3EXTIEN BIT(5)
440 /* SS link U2 state enter interrupt enable.*/
441 #define USB_IEN_U2ENTIEN BIT(6)
442 /* SS link U2 state exit interrupt enable.*/
443 #define USB_IEN_U2EXTIEN BIT(7)
444 /* SS link U1 state enter interrupt enable.*/
445 #define USB_IEN_U1ENTIEN BIT(8)
446 /* SS link U1 state exit interrupt enable.*/
447 #define USB_IEN_U1EXTIEN BIT(9)
448 /* ITP/SOF packet detected interrupt enable.*/
449 #define USB_IEN_ITPIEN BIT(10)
450 /* Wakeup interrupt enable.*/
451 #define USB_IEN_WAKEIEN BIT(11)
452 /* Send Custom Packet interrupt enable.*/
453 #define USB_IEN_SPKTIEN BIT(12)
454 /* HS/FS mode connection interrupt enable.*/
455 #define USB_IEN_CON2IEN BIT(16)
456 /* HS/FS mode disconnection interrupt enable.*/
457 #define USB_IEN_DIS2IEN BIT(17)
458 /* USB reset (HS/FS mode) interrupt enable.*/
459 #define USB_IEN_U2RESIEN BIT(18)
460 /* LPM L2 state enter interrupt enable.*/
461 #define USB_IEN_L2ENTIEN BIT(20)
462 /* LPM L2 state exit interrupt enable.*/
463 #define USB_IEN_L2EXTIEN BIT(21)
464 /* LPM L1 state enter interrupt enable.*/
465 #define USB_IEN_L1ENTIEN BIT(24)
466 /* LPM L1 state exit interrupt enable.*/
467 #define USB_IEN_L1EXTIEN BIT(25)
468 /* Configuration reset interrupt enable.*/
469 #define USB_IEN_CFGRESIEN BIT(26)
470 /* Start of the USB SS warm reset interrupt enable.*/
471 #define USB_IEN_UWRESSIEN BIT(28)
472 /* End of the USB SS warm reset interrupt enable.*/
473 #define USB_IEN_UWRESEIEN BIT(29)
475 #define USB_IEN_INIT (USB_IEN_U2RESIEN | USB_ISTS_DIS2I | USB_IEN_CON2IEN \
476 | USB_IEN_UHRESIEN | USB_IEN_UWRESIEN | USB_IEN_DISIEN \
477 | USB_IEN_CONIEN | USB_IEN_U3EXTIEN | USB_IEN_L2ENTIEN \
478 | USB_IEN_L2EXTIEN | USB_IEN_L1ENTIEN | USB_IEN_U3ENTIEN)
480 /* USB_ISTS - bitmasks */
481 /* SS Connection detected. */
482 #define USB_ISTS_CONI BIT(0)
483 /* SS Disconnection detected. */
484 #define USB_ISTS_DISI BIT(1)
485 /* UUSB warm reset detectede. */
486 #define USB_ISTS_UWRESI BIT(2)
487 /* USB hot reset detected. */
488 #define USB_ISTS_UHRESI BIT(3)
489 /* U3 link state enter detected (suspend).*/
490 #define USB_ISTS_U3ENTI BIT(4)
491 /* U3 link state exit detected (wakeup). */
492 #define USB_ISTS_U3EXTI BIT(5)
493 /* U2 link state enter detected.*/
494 #define USB_ISTS_U2ENTI BIT(6)
495 /* U2 link state exit detected.*/
496 #define USB_ISTS_U2EXTI BIT(7)
497 /* U1 link state enter detected.*/
498 #define USB_ISTS_U1ENTI BIT(8)
499 /* U1 link state exit detected.*/
500 #define USB_ISTS_U1EXTI BIT(9)
501 /* ITP/SOF packet detected.*/
502 #define USB_ISTS_ITPI BIT(10)
503 /* Wakeup detected.*/
504 #define USB_ISTS_WAKEI BIT(11)
505 /* Send Custom Packet detected.*/
506 #define USB_ISTS_SPKTI BIT(12)
507 /* HS/FS mode connection detected.*/
508 #define USB_ISTS_CON2I BIT(16)
509 /* HS/FS mode disconnection detected.*/
510 #define USB_ISTS_DIS2I BIT(17)
511 /* USB reset (HS/FS mode) detected.*/
512 #define USB_ISTS_U2RESI BIT(18)
513 /* LPM L2 state enter detected.*/
514 #define USB_ISTS_L2ENTI BIT(20)
515 /* LPM L2 state exit detected.*/
516 #define USB_ISTS_L2EXTI BIT(21)
517 /* LPM L1 state enter detected.*/
518 #define USB_ISTS_L1ENTI BIT(24)
519 /* LPM L1 state exit detected.*/
520 #define USB_ISTS_L1EXTI BIT(25)
521 /* USB configuration reset detected.*/
522 #define USB_ISTS_CFGRESI BIT(26)
523 /* Start of the USB warm reset detected.*/
524 #define USB_ISTS_UWRESSI BIT(28)
525 /* End of the USB warm reset detected.*/
526 #define USB_ISTS_UWRESEI BIT(29)
528 /* USB_SEL - bitmasks */
529 #define EP_SEL_EPNO_MASK GENMASK(3, 0)
530 /* Endpoint number. */
531 #define EP_SEL_EPNO(p) ((p) & EP_SEL_EPNO_MASK)
532 /* Endpoint direction bit - 0 - OUT, 1 - IN. */
533 #define EP_SEL_DIR BIT(7)
535 #define select_ep_in(nr) (EP_SEL_EPNO(p) | EP_SEL_DIR)
536 #define select_ep_out (EP_SEL_EPNO(p))
538 /* EP_TRADDR - bitmasks */
539 /* Transfer Ring address. */
540 #define EP_TRADDR_TRADDR(p) ((p))
542 /* EP_CFG - bitmasks */
543 /* Endpoint enable */
544 #define EP_CFG_ENABLE BIT(0)
545 /*
546 * Endpoint type.
547 * 1 - isochronous
548 * 2 - bulk
549 * 3 - interrupt
550 */
551 #define EP_CFG_EPTYPE_MASK GENMASK(2, 1)
552 #define EP_CFG_EPTYPE(p) (((p) << 1) & EP_CFG_EPTYPE_MASK)
553 /* Stream support enable (only in SS mode). */
554 #define EP_CFG_STREAM_EN BIT(3)
555 /* TDL check (only in SS mode for BULK EP). */
556 #define EP_CFG_TDL_CHK BIT(4)
557 /* SID check (only in SS mode for BULK OUT EP). */
558 #define EP_CFG_SID_CHK BIT(5)
559 /* DMA transfer endianness. */
560 #define EP_CFG_EPENDIAN BIT(7)
561 /* Max burst size (used only in SS mode). */
562 #define EP_CFG_MAXBURST_MASK GENMASK(11, 8)
563 #define EP_CFG_MAXBURST(p) (((p) << 8) & EP_CFG_MAXBURST_MASK)
564 /* ISO max burst. */
565 #define EP_CFG_MULT_MASK GENMASK(15, 14)
566 #define EP_CFG_MULT(p) (((p) << 14) & EP_CFG_MULT_MASK)
567 /* ISO max burst. */
568 #define EP_CFG_MAXPKTSIZE_MASK GENMASK(26, 16)
569 #define EP_CFG_MAXPKTSIZE(p) (((p) << 16) & EP_CFG_MAXPKTSIZE_MASK)
570 /* Max number of buffered packets. */
571 #define EP_CFG_BUFFERING_MASK GENMASK(31, 27)
572 #define EP_CFG_BUFFERING(p) (((p) << 27) & EP_CFG_BUFFERING_MASK)
574 /* EP_CMD - bitmasks */
575 /* Endpoint reset. */
576 #define EP_CMD_EPRST BIT(0)
577 /* Endpoint STALL set. */
578 #define EP_CMD_SSTALL BIT(1)
579 /* Endpoint STALL clear. */
580 #define EP_CMD_CSTALL BIT(2)
581 /* Send ERDY TP. */
582 #define EP_CMD_ERDY BIT(3)
583 /* Request complete. */
584 #define EP_CMD_REQ_CMPL BIT(5)
585 /* Transfer descriptor ready. */
586 #define EP_CMD_DRDY BIT(6)
587 /* Data flush. */
588 #define EP_CMD_DFLUSH BIT(7)
589 /*
590 * Transfer Descriptor Length write (used only for Bulk Stream capable
591 * endpoints in SS mode).
592 * Bit Removed from DEV_VER_V3 controller version.
593 */
594 #define EP_CMD_STDL BIT(8)
595 /*
596 * Transfer Descriptor Length (used only in SS mode for bulk endpoints).
597 * Bits Removed from DEV_VER_V3 controller version.
598 */
599 #define EP_CMD_TDL_MASK GENMASK(15, 9)
600 #define EP_CMD_TDL_SET(p) (((p) << 9) & EP_CMD_TDL_MASK)
601 #define EP_CMD_TDL_GET(p) (((p) & EP_CMD_TDL_MASK) >> 9)
603 /* ERDY Stream ID value (used in SS mode). */
604 #define EP_CMD_ERDY_SID_MASK GENMASK(31, 16)
605 #define EP_CMD_ERDY_SID(p) (((p) << 16) & EP_CMD_ERDY_SID_MASK)
607 /* EP_STS - bitmasks */
608 /* Setup transfer complete. */
609 #define EP_STS_SETUP BIT(0)
610 /* Endpoint STALL status. */
611 #define EP_STS_STALL(p) ((p) & BIT(1))
612 /* Interrupt On Complete. */
613 #define EP_STS_IOC BIT(2)
614 /* Interrupt on Short Packet. */
615 #define EP_STS_ISP BIT(3)
616 /* Transfer descriptor missing. */
617 #define EP_STS_DESCMIS BIT(4)
618 /* Stream Rejected (used only in SS mode) */
619 #define EP_STS_STREAMR BIT(5)
620 /* EXIT from MOVE DATA State (used only for stream transfers in SS mode). */
621 #define EP_STS_MD_EXIT BIT(6)
622 /* TRB error. */
623 #define EP_STS_TRBERR BIT(7)
624 /* Not ready (used only in SS mode). */
625 #define EP_STS_NRDY BIT(8)
626 /* DMA busy bit. */
627 #define EP_STS_DBUSY BIT(9)
628 /* Endpoint Buffer Empty */
629 #define EP_STS_BUFFEMPTY(p) ((p) & BIT(10))
630 /* Current Cycle Status */
631 #define EP_STS_CCS(p) ((p) & BIT(11))
632 /* Prime (used only in SS mode. */
633 #define EP_STS_PRIME BIT(12)
634 /* Stream error (used only in SS mode). */
635 #define EP_STS_SIDERR BIT(13)
636 /* OUT size mismatch. */
637 #define EP_STS_OUTSMM BIT(14)
638 /* ISO transmission error. */
639 #define EP_STS_ISOERR BIT(15)
640 /* Host Packet Pending (only for SS mode). */
641 #define EP_STS_HOSTPP(p) ((p) & BIT(16))
642 /* Stream Protocol State Machine State (only for Bulk stream endpoints). */
643 #define EP_STS_SPSMST_MASK GENMASK(18, 17)
644 #define EP_STS_SPSMST_DISABLED(p) (((p) & EP_STS_SPSMST_MASK) >> 17)
645 #define EP_STS_SPSMST_IDLE(p) (((p) & EP_STS_SPSMST_MASK) >> 17)
646 #define EP_STS_SPSMST_START_STREAM(p) (((p) & EP_STS_SPSMST_MASK) >> 17)
647 #define EP_STS_SPSMST_MOVE_DATA(p) (((p) & EP_STS_SPSMST_MASK) >> 17)
648 /* Interrupt On Transfer complete. */
649 #define EP_STS_IOT BIT(19)
650 /* OUT queue endpoint number. */
651 #define EP_STS_OUTQ_NO_MASK GENMASK(27, 24)
652 #define EP_STS_OUTQ_NO(p) (((p) & EP_STS_OUTQ_NO_MASK) >> 24)
653 /* OUT queue valid flag. */
654 #define EP_STS_OUTQ_VAL_MASK BIT(28)
655 #define EP_STS_OUTQ_VAL(p) ((p) & EP_STS_OUTQ_VAL_MASK)
656 /* SETUP WAIT. */
657 #define EP_STS_STPWAIT BIT(31)
659 /* EP_STS_SID - bitmasks */
660 /* Stream ID (used only in SS mode). */
661 #define EP_STS_SID_MASK GENMASK(15, 0)
662 #define EP_STS_SID(p) ((p) & EP_STS_SID_MASK)
664 /* EP_STS_EN - bitmasks */
665 /* SETUP interrupt enable. */
666 #define EP_STS_EN_SETUPEN BIT(0)
667 /* OUT transfer missing descriptor enable. */
668 #define EP_STS_EN_DESCMISEN BIT(4)
669 /* Stream Rejected enable. */
670 #define EP_STS_EN_STREAMREN BIT(5)
671 /* Move Data Exit enable.*/
672 #define EP_STS_EN_MD_EXITEN BIT(6)
673 /* TRB enable. */
674 #define EP_STS_EN_TRBERREN BIT(7)
675 /* NRDY enable. */
676 #define EP_STS_EN_NRDYEN BIT(8)
677 /* Prime enable. */
678 #define EP_STS_EN_PRIMEEEN BIT(12)
679 /* Stream error enable. */
680 #define EP_STS_EN_SIDERREN BIT(13)
681 /* OUT size mismatch enable. */
682 #define EP_STS_EN_OUTSMMEN BIT(14)
683 /* ISO transmission error enable. */
684 #define EP_STS_EN_ISOERREN BIT(15)
685 /* Interrupt on Transmission complete enable. */
686 #define EP_STS_EN_IOTEN BIT(19)
687 /* Setup Wait interrupt enable. */
688 #define EP_STS_EN_STPWAITEN BIT(31)
690 /* DRBL- bitmasks */
691 #define DB_VALUE_BY_INDEX(index) (1 << (index))
692 #define DB_VALUE_EP0_OUT BIT(0)
693 #define DB_VALUE_EP0_IN BIT(16)
695 /* EP_IEN - bitmasks */
696 #define EP_IEN(index) (1 << (index))
697 #define EP_IEN_EP_OUT0 BIT(0)
698 #define EP_IEN_EP_IN0 BIT(16)
700 /* EP_ISTS - bitmasks */
701 #define EP_ISTS(index) (1 << (index))
702 #define EP_ISTS_EP_OUT0 BIT(0)
703 #define EP_ISTS_EP_IN0 BIT(16)
705 /* USB_PWR- bitmasks */
706 /*Power Shut Off capability enable*/
707 #define PUSB_PWR_PSO_EN BIT(0)
708 /*Power Shut Off capability disable*/
709 #define PUSB_PWR_PSO_DS BIT(1)
710 /*
711 * Enables turning-off Reference Clock.
712 * This bit is optional and implemented only when support for OTG is
713 * implemented (indicated by OTG_READY bit set to '1').
714 */
715 #define PUSB_PWR_STB_CLK_SWITCH_EN BIT(8)
716 /*
717 * Status bit indicating that operation required by STB_CLK_SWITCH_EN write
718 * is completed
719 */
720 #define PUSB_PWR_STB_CLK_SWITCH_DONE BIT(9)
721 /* This bit informs if Fast Registers Access is enabled. */
722 #define PUSB_PWR_FST_REG_ACCESS_STAT BIT(30)
723 /* Fast Registers Access Enable. */
724 #define PUSB_PWR_FST_REG_ACCESS BIT(31)
726 /* USB_CONF2- bitmasks */
727 /*
728 * Writing 1 disables TDL calculation basing on TRB feature in controller
729 * for DMULT mode.
730 * Bit supported only for DEV_VER_V2 version.
731 */
732 #define USB_CONF2_DIS_TDL_TRB BIT(1)
733 /*
734 * Writing 1 enables TDL calculation basing on TRB feature in controller
735 * for DMULT mode.
736 * Bit supported only for DEV_VER_V2 version.
737 */
738 #define USB_CONF2_EN_TDL_TRB BIT(2)
740 /* USB_CAP1- bitmasks */
741 /*
742 * SFR Interface type
743 * These field reflects type of SFR interface implemented:
744 * 0x0 - OCP
745 * 0x1 - AHB,
746 * 0x2 - PLB
747 * 0x3 - AXI
748 * 0x4-0xF - reserved
749 */
750 #define USB_CAP1_SFR_TYPE_MASK GENMASK(3, 0)
751 #define DEV_SFR_TYPE_OCP(p) (((p) & USB_CAP1_SFR_TYPE_MASK) == 0x0)
752 #define DEV_SFR_TYPE_AHB(p) (((p) & USB_CAP1_SFR_TYPE_MASK) == 0x1)
753 #define DEV_SFR_TYPE_PLB(p) (((p) & USB_CAP1_SFR_TYPE_MASK) == 0x2)
754 #define DEV_SFR_TYPE_AXI(p) (((p) & USB_CAP1_SFR_TYPE_MASK) == 0x3)
755 /*
756 * SFR Interface width
757 * These field reflects width of SFR interface implemented:
758 * 0x0 - 8 bit interface,
759 * 0x1 - 16 bit interface,
760 * 0x2 - 32 bit interface
761 * 0x3 - 64 bit interface
762 * 0x4-0xF - reserved
763 */
764 #define USB_CAP1_SFR_WIDTH_MASK GENMASK(7, 4)
765 #define DEV_SFR_WIDTH_8(p) (((p) & USB_CAP1_SFR_WIDTH_MASK) == (0x0 << 4))
766 #define DEV_SFR_WIDTH_16(p) (((p) & USB_CAP1_SFR_WIDTH_MASK) == (0x1 << 4))
767 #define DEV_SFR_WIDTH_32(p) (((p) & USB_CAP1_SFR_WIDTH_MASK) == (0x2 << 4))
768 #define DEV_SFR_WIDTH_64(p) (((p) & USB_CAP1_SFR_WIDTH_MASK) == (0x3 << 4))
769 /*
770 * DMA Interface type
771 * These field reflects type of DMA interface implemented:
772 * 0x0 - OCP
773 * 0x1 - AHB,
774 * 0x2 - PLB
775 * 0x3 - AXI
776 * 0x4-0xF - reserved
777 */
778 #define USB_CAP1_DMA_TYPE_MASK GENMASK(11, 8)
779 #define DEV_DMA_TYPE_OCP(p) (((p) & USB_CAP1_DMA_TYPE_MASK) == (0x0 << 8))
780 #define DEV_DMA_TYPE_AHB(p) (((p) & USB_CAP1_DMA_TYPE_MASK) == (0x1 << 8))
781 #define DEV_DMA_TYPE_PLB(p) (((p) & USB_CAP1_DMA_TYPE_MASK) == (0x2 << 8))
782 #define DEV_DMA_TYPE_AXI(p) (((p) & USB_CAP1_DMA_TYPE_MASK) == (0x3 << 8))
783 /*
784 * DMA Interface width
785 * These field reflects width of DMA interface implemented:
786 * 0x0 - reserved,
787 * 0x1 - reserved,
788 * 0x2 - 32 bit interface
789 * 0x3 - 64 bit interface
790 * 0x4-0xF - reserved
791 */
792 #define USB_CAP1_DMA_WIDTH_MASK GENMASK(15, 12)
793 #define DEV_DMA_WIDTH_32(p) (((p) & USB_CAP1_DMA_WIDTH_MASK) == (0x2 << 12))
794 #define DEV_DMA_WIDTH_64(p) (((p) & USB_CAP1_DMA_WIDTH_MASK) == (0x3 << 12))
795 /*
796 * USB3 PHY Interface type
797 * These field reflects type of USB3 PHY interface implemented:
798 * 0x0 - USB PIPE,
799 * 0x1 - RMMI,
800 * 0x2-0xF - reserved
801 */
802 #define USB_CAP1_U3PHY_TYPE_MASK GENMASK(19, 16)
803 #define DEV_U3PHY_PIPE(p) (((p) & USB_CAP1_U3PHY_TYPE_MASK) == (0x0 << 16))
804 #define DEV_U3PHY_RMMI(p) (((p) & USB_CAP1_U3PHY_TYPE_MASK) == (0x1 << 16))
805 /*
806 * USB3 PHY Interface width
807 * These field reflects width of USB3 PHY interface implemented:
808 * 0x0 - 8 bit PIPE interface,
809 * 0x1 - 16 bit PIPE interface,
810 * 0x2 - 32 bit PIPE interface,
811 * 0x3 - 64 bit PIPE interface
812 * 0x4-0xF - reserved
813 * Note: When SSIC interface is implemented this field shows the width of
814 * internal PIPE interface. The RMMI interface is always 20bit wide.
815 */
816 #define USB_CAP1_U3PHY_WIDTH_MASK GENMASK(23, 20)
817 #define DEV_U3PHY_WIDTH_8(p) \
818 (((p) & USB_CAP1_U3PHY_WIDTH_MASK) == (0x0 << 20))
819 #define DEV_U3PHY_WIDTH_16(p) \
820 (((p) & USB_CAP1_U3PHY_WIDTH_MASK) == (0x1 << 16))
821 #define DEV_U3PHY_WIDTH_32(p) \
822 (((p) & USB_CAP1_U3PHY_WIDTH_MASK) == (0x2 << 20))
823 #define DEV_U3PHY_WIDTH_64(p) \
824 (((p) & USB_CAP1_U3PHY_WIDTH_MASK) == (0x3 << 16))
826 /*
827 * USB2 PHY Interface enable
828 * These field informs if USB2 PHY interface is implemented:
829 * 0x0 - interface NOT implemented,
830 * 0x1 - interface implemented
831 */
832 #define USB_CAP1_U2PHY_EN(p) ((p) & BIT(24))
833 /*
834 * USB2 PHY Interface type
835 * These field reflects type of USB2 PHY interface implemented:
836 * 0x0 - UTMI,
837 * 0x1 - ULPI
838 */
839 #define DEV_U2PHY_ULPI(p) ((p) & BIT(25))
840 /*
841 * USB2 PHY Interface width
842 * These field reflects width of USB2 PHY interface implemented:
843 * 0x0 - 8 bit interface,
844 * 0x1 - 16 bit interface,
845 * Note: The ULPI interface is always 8bit wide.
846 */
847 #define DEV_U2PHY_WIDTH_16(p) ((p) & BIT(26))
848 /*
849 * OTG Ready
850 * 0x0 - pure device mode
851 * 0x1 - some features and ports for CDNS USB OTG controller are implemented.
852 */
853 #define USB_CAP1_OTG_READY(p) ((p) & BIT(27))
855 /*
856 * When set, indicates that controller supports automatic internal TDL
857 * calculation basing on the size provided in TRB (TRB[22:17]) for DMULT mode
858 * Supported only for DEV_VER_V2 controller version.
859 */
860 #define USB_CAP1_TDL_FROM_TRB(p) ((p) & BIT(28))
862 /* USB_CAP2- bitmasks */
863 /*
864 * The actual size of the connected On-chip RAM memory in kB:
865 * - 0 means 256 kB (max supported mem size)
866 * - value other than 0 reflects the mem size in kB
867 */
868 #define USB_CAP2_ACTUAL_MEM_SIZE(p) ((p) & GENMASK(7, 0))
869 /*
870 * Max supported mem size
871 * These field reflects width of on-chip RAM address bus width,
872 * which determines max supported mem size:
873 * 0x0-0x7 - reserved,
874 * 0x8 - support for 4kB mem,
875 * 0x9 - support for 8kB mem,
876 * 0xA - support for 16kB mem,
877 * 0xB - support for 32kB mem,
878 * 0xC - support for 64kB mem,
879 * 0xD - support for 128kB mem,
880 * 0xE - support for 256kB mem,
881 * 0xF - reserved
882 */
883 #define USB_CAP2_MAX_MEM_SIZE(p) ((p) & GENMASK(11, 8))
885 /* USB_CAP3- bitmasks */
886 #define EP_IS_IMPLEMENTED(reg, index) ((reg) & (1 << (index)))
888 /* USB_CAP4- bitmasks */
889 #define EP_SUPPORT_ISO(reg, index) ((reg) & (1 << (index)))
891 /* USB_CAP5- bitmasks */
892 #define EP_SUPPORT_STREAM(reg, index) ((reg) & (1 << (index)))
894 /* USB_CAP6- bitmasks */
895 /* The USBSS-DEV Controller Internal build number. */
896 #define GET_DEV_BASE_VERSION(p) ((p) & GENMASK(23, 0))
897 /* The USBSS-DEV Controller version number. */
898 #define GET_DEV_CUSTOM_VERSION(p) ((p) & GENMASK(31, 24))
900 #define DEV_VER_NXP_V1 0x00024502
901 #define DEV_VER_TI_V1 0x00024509
902 #define DEV_VER_V2 0x0002450C
903 #define DEV_VER_V3 0x0002450d
905 /* DBG_LINK1- bitmasks */
906 /*
907 * LFPS_MIN_DET_U1_EXIT value This parameter configures the minimum
908 * time required for decoding the received LFPS as an LFPS.U1_Exit.
909 */
910 #define DBG_LINK1_LFPS_MIN_DET_U1_EXIT(p) ((p) & GENMASK(7, 0))
911 /*
912 * LFPS_MIN_GEN_U1_EXIT value This parameter configures the minimum time for
913 * phytxelecidle deassertion when LFPS.U1_Exit
914 */
915 #define DBG_LINK1_LFPS_MIN_GEN_U1_EXIT_MASK GENMASK(15, 8)
916 #define DBG_LINK1_LFPS_MIN_GEN_U1_EXIT(p) (((p) << 8) & GENMASK(15, 8))
917 /*
918 * RXDET_BREAK_DIS value This parameter configures terminating the Far-end
919 * Receiver termination detection sequence:
920 * 0: it is possible that USBSS_DEV will terminate Farend receiver
921 * termination detection sequence
922 * 1: USBSS_DEV will not terminate Far-end receiver termination
923 * detection sequence
924 */
925 #define DBG_LINK1_RXDET_BREAK_DIS BIT(16)
926 /* LFPS_GEN_PING value This parameter configures the LFPS.Ping generation */
927 #define DBG_LINK1_LFPS_GEN_PING(p) (((p) << 17) & GENMASK(21, 17))
928 /*
929 * Set the LFPS_MIN_DET_U1_EXIT value Writing '1' to this bit writes the
930 * LFPS_MIN_DET_U1_EXIT field value to the device. This bit is automatically
931 * cleared. Writing '0' has no effect
932 */
933 #define DBG_LINK1_LFPS_MIN_DET_U1_EXIT_SET BIT(24)
934 /*
935 * Set the LFPS_MIN_GEN_U1_EXIT value. Writing '1' to this bit writes the
936 * LFPS_MIN_GEN_U1_EXIT field value to the device. This bit is automatically
937 * cleared. Writing '0' has no effect
938 */
939 #define DBG_LINK1_LFPS_MIN_GEN_U1_EXIT_SET BIT(25)
940 /*
941 * Set the RXDET_BREAK_DIS value Writing '1' to this bit writes
942 * the RXDET_BREAK_DIS field value to the device. This bit is automatically
943 * cleared. Writing '0' has no effect
944 */
945 #define DBG_LINK1_RXDET_BREAK_DIS_SET BIT(26)
946 /*
947 * Set the LFPS_GEN_PING_SET value Writing '1' to this bit writes
948 * the LFPS_GEN_PING field value to the device. This bit is automatically
949 * cleared. Writing '0' has no effect."
950 */
951 #define DBG_LINK1_LFPS_GEN_PING_SET BIT(27)
953 /* DMA_AXI_CTRL- bitmasks */
954 /* The mawprot pin configuration. */
955 #define DMA_AXI_CTRL_MARPROT(p) ((p) & GENMASK(2, 0))
956 /* The marprot pin configuration. */
957 #define DMA_AXI_CTRL_MAWPROT(p) (((p) & GENMASK(2, 0)) << 16)
958 #define DMA_AXI_CTRL_NON_SECURE 0x02
960 #define gadget_to_cdns3_device(g) (container_of(g, struct cdns3_device, gadget))
962 #define ep_to_cdns3_ep(ep) (container_of(ep, struct cdns3_endpoint, endpoint))
964 /*-------------------------------------------------------------------------*/
965 /*
966 * USBSS-DEV DMA interface.
967 */
968 #define TRBS_PER_SEGMENT 40
970 #define ISO_MAX_INTERVAL 10
972 #if TRBS_PER_SEGMENT < 2
974 #endif
976 /*
977 *Only for ISOC endpoints - maximum number of TRBs is calculated as
978 * pow(2, bInterval-1) * number of usb requests. It is limitation made by
979 * driver to save memory. Controller must prepare TRB for each ITP even
980 * if bInterval > 1. It's the reason why driver needs so many TRBs for
981 * isochronous endpoints.
982 */
983 #define TRBS_PER_ISOC_SEGMENT (ISO_MAX_INTERVAL * 8)
985 #define GET_TRBS_PER_SEGMENT(ep_type) ((ep_type) == USB_ENDPOINT_XFER_ISOC ? \
986 TRBS_PER_ISOC_SEGMENT : TRBS_PER_SEGMENT)
987 /**
988 * struct cdns3_trb - represent Transfer Descriptor block.
989 * @buffer: pointer to buffer data
990 * @length: length of data
991 * @control: control flags.
992 *
993 * This structure describes transfer block serviced by DMA module.
994 */
996 __le32 buffer;
997 __le32 length;
998 __le32 control;
999 };
1001 #define TRB_SIZE (sizeof(struct cdns3_trb))
1002 #define TRB_RING_SIZE (TRB_SIZE * TRBS_PER_SEGMENT)
1003 #define TRB_ISO_RING_SIZE (TRB_SIZE * TRBS_PER_ISOC_SEGMENT)
1004 #define TRB_CTRL_RING_SIZE (TRB_SIZE * 2)
1006 /* TRB bit mask */
1007 #define TRB_TYPE_BITMASK GENMASK(15, 10)
1008 #define TRB_TYPE(p) ((p) << 10)
1009 #define TRB_FIELD_TO_TYPE(p) (((p) & TRB_TYPE_BITMASK) >> 10)
1011 /* TRB type IDs */
1012 /* bulk, interrupt, isoc , and control data stage */
1013 #define TRB_NORMAL 1
1014 /* TRB for linking ring segments */
1015 #define TRB_LINK 6
1017 /* Cycle bit - indicates TRB ownership by driver or hw*/
1018 #define TRB_CYCLE BIT(0)
1019 /*
1020 * When set to '1', the device will toggle its interpretation of the Cycle bit
1021 */
1022 #define TRB_TOGGLE BIT(1)
1024 /*
1025 * Short Packet (SP). OUT EPs at DMULT=1 only. Indicates if the TRB was
1026 * processed while USB short packet was received. No more buffers defined by
1027 * the TD will be used. DMA will automatically advance to next TD.
1028 * - Shall be set to 0 by Software when putting TRB on the Transfer Ring
1029 * - Shall be set to 1 by Controller when Short Packet condition for this TRB
1030 * is detected independent if ISP is set or not.
1031 */
1032 #define TRB_SP BIT(1)
1034 /* Interrupt on short packet*/
1035 #define TRB_ISP BIT(2)
1036 /*Setting this bit enables FIFO DMA operation mode*/
1037 #define TRB_FIFO_MODE BIT(3)
1038 /* Set PCIe no snoop attribute */
1039 #define TRB_CHAIN BIT(4)
1040 /* Interrupt on completion */
1041 #define TRB_IOC BIT(5)
1043 /* stream ID bitmasks. */
1044 #define TRB_STREAM_ID_BITMASK GENMASK(31, 16)
1045 #define TRB_STREAM_ID(p) ((p) << 16)
1046 #define TRB_FIELD_TO_STREAMID(p) (((p) & TRB_STREAM_ID_BITMASK) >> 16)
1048 /* Size of TD expressed in USB packets for HS/FS mode. */
1049 #define TRB_TDL_HS_SIZE(p) (((p) << 16) & GENMASK(31, 16))
1050 #define TRB_TDL_HS_SIZE_GET(p) (((p) & GENMASK(31, 16)) >> 16)
1052 /* transfer_len bitmasks. */
1053 #define TRB_LEN(p) ((p) & GENMASK(16, 0))
1055 /* Size of TD expressed in USB packets for SS mode. */
1056 #define TRB_TDL_SS_SIZE(p) (((p) << 17) & GENMASK(23, 17))
1057 #define TRB_TDL_SS_SIZE_GET(p) (((p) & GENMASK(23, 17)) >> 17)
1059 /* transfer_len bitmasks - bits 31:24 */
1060 #define TRB_BURST_LEN(p) (((p) << 24) & GENMASK(31, 24))
1061 #define TRB_BURST_LEN_GET(p) (((p) & GENMASK(31, 24)) >> 24)
1063 /* Data buffer pointer bitmasks*/
1064 #define TRB_BUFFER(p) ((p) & GENMASK(31, 0))
1066 /*-------------------------------------------------------------------------*/
1067 /* Driver numeric constants */
1069 /* Such declaration should be added to ch9.h */
1070 #define USB_DEVICE_MAX_ADDRESS 127
1072 /* Endpoint init values */
1073 #define CDNS3_EP_MAX_PACKET_LIMIT 1024
1074 #define CDNS3_EP_MAX_STREAMS 15
1075 #define CDNS3_EP0_MAX_PACKET_LIMIT 512
1077 /* All endpoints including EP0 */
1078 #define CDNS3_ENDPOINTS_MAX_COUNT 32
1079 #define CDNS3_EP_ZLP_BUF_SIZE 1024
1082 #define CDNS3_EP_ISO_HS_MULT 3
1083 #define CDNS3_EP_ISO_SS_BURST 3
1084 #define CDNS3_MAX_NUM_DESCMISS_BUF 32
1086 #define CDNS3_WA2_NUM_BUFFERS 128
1087 /*-------------------------------------------------------------------------*/
1088 /* Used structs */
1092 /**
1093 * struct cdns3_endpoint - extended device side representation of USB endpoint.
1094 * @endpoint: usb endpoint
1095 * @pending_req_list: list of requests queuing on transfer ring.
1096 * @deferred_req_list: list of requests waiting for queuing on transfer ring.
1097 * @wa2_descmiss_req_list: list of requests internally allocated by driver.
1098 * @trb_pool: transfer ring - array of transaction buffers
1099 * @trb_pool_dma: dma address of transfer ring
1100 * @cdns3_dev: device associated with this endpoint
1101 * @name: a human readable name e.g. ep1out
1102 * @flags: specify the current state of endpoint
1103 * @descmis_req: internal transfer object used for getting data from on-chip
1104 * buffer. It can happen only if function driver doesn't send usb_request
1105 * object on time.
1106 * @dir: endpoint direction
1107 * @num: endpoint number (1 - 15)
1108 * @type: set to bmAttributes & USB_ENDPOINT_XFERTYPE_MASK
1109 * @interval: interval between packets used for ISOC endpoint.
1110 * @free_trbs: number of free TRBs in transfer ring
1111 * @num_trbs: number of all TRBs in transfer ring
1112 * @pcs: producer cycle state
1113 * @ccs: consumer cycle state
1114 * @enqueue: enqueue index in transfer ring
1115 * @dequeue: dequeue index in transfer ring
1116 * @trb_burst_size: number of burst used in trb.
1117 */
1126 dma_addr_t trb_pool_dma;
1131 #define EP_ENABLED BIT(0)
1132 #define EP_STALLED BIT(1)
1133 #define EP_STALL_PENDING BIT(2)
1134 #define EP_WEDGE BIT(3)
1135 #define EP_TRANSFER_STARTED BIT(4)
1136 #define EP_UPDATE_EP_TRBADDR BIT(5)
1137 #define EP_PENDING_REQUEST BIT(6)
1138 #define EP_RING_FULL BIT(7)
1139 #define EP_CLAIMED BIT(8)
1140 #define EP_DEFERRED_DRDY BIT(9)
1141 #define EP_QUIRK_ISO_OUT_EN BIT(10)
1142 #define EP_QUIRK_END_TRANSFER BIT(11)
1143 #define EP_QUIRK_EXTRA_BUF_DET BIT(12)
1144 #define EP_QUIRK_EXTRA_BUF_EN BIT(13)
1145 u32 flags;
1149 u8 dir;
1150 u8 num;
1151 u8 type;
1156 u8 pcs;
1157 u8 ccs;
1160 u8 trb_burst_size;
1166 };
1168 /**
1169 * struct cdns3_aligned_buf - represent aligned buffer used for DMA transfer
1170 * @buf: aligned to 8 bytes data buffer. Buffer address used in
1171 * TRB shall be aligned to 8.
1172 * @dma: dma address
1173 * @size: size of buffer
1174 * @in_use: inform if this buffer is associated with usb_request
1175 * @list: used to adding instance of this object to list
1176 */
1179 dma_addr_t dma;
1180 u32 size;
1183 };
1185 /**
1186 * struct cdns3_request - extended device side representation of usb_request
1187 * object .
1188 * @request: generic usb_request object describing single I/O request.
1189 * @priv_ep: extended representation of usb_ep object
1190 * @trb: the first TRB association with this request
1191 * @start_trb: number of the first TRB in transfer ring
1192 * @end_trb: number of the last TRB in transfer ring
1193 * @aligned_buf: object holds information about aligned buffer associated whit
1194 * this endpoint
1195 * @flags: flag specifying special usage of request
1196 * @list: used by internally allocated request to add to wa2_descmiss_req_list.
1197 */
1205 #define REQUEST_PENDING BIT(0)
1206 #define REQUEST_INTERNAL BIT(1)
1207 #define REQUEST_INTERNAL_CH BIT(2)
1208 #define REQUEST_ZLP BIT(3)
1209 #define REQUEST_UNALIGNED BIT(4)
1210 u32 flags;
1212 };
1214 #define to_cdns3_request(r) (container_of(r, struct cdns3_request, request))
1216 /*Stages used during enumeration process.*/
1217 #define CDNS3_SETUP_STAGE 0x0
1218 #define CDNS3_DATA_STAGE 0x1
1219 #define CDNS3_STATUS_STAGE 0x2
1221 /**
1222 * struct cdns3_device - represent USB device.
1223 * @dev: pointer to device structure associated whit this controller
1224 * @sysdev: pointer to the DMA capable device
1225 * @gadget: device side representation of the peripheral controller
1226 * @gadget_driver: pointer to the gadget driver
1227 * @dev_ver: device controller version.
1228 * @lock: for synchronizing
1229 * @regs: base address for device side registers
1230 * @setup_buf: used while processing usb control requests
1231 * @setup_dma: dma address for setup_buf
1232 * @zlp_buf - zlp buffer
1233 * @ep0_stage: ep0 stage during enumeration process.
1234 * @ep0_data_dir: direction for control transfer
1235 * @eps: array of pointers to all endpoints with exclusion ep0
1236 * @aligned_buf_list: list of aligned buffers internally allocated by driver
1237 * @aligned_buf_wq: workqueue freeing no longer used aligned buf.
1238 * @selected_ep: actually selected endpoint. It's used only to improve
1239 * performance.
1240 * @isoch_delay: value from Set Isoch Delay request. Only valid on SS/SSP.
1241 * @u1_allowed: allow device transition to u1 state
1242 * @u2_allowed: allow device transition to u2 state
1243 * @is_selfpowered: device is self powered
1244 * @setup_pending: setup packet is processing by gadget driver
1245 * @hw_configured_flag: hardware endpoint configuration was set.
1246 * @wake_up_flag: allow device to remote up the host
1247 * @status_completion_no_call: indicate that driver is waiting for status s
1248 * stage completion. It's used in deferred SET_CONFIGURATION request.
1249 * @onchip_buffers: number of available on-chip buffers.
1250 * @onchip_used_size: actual size of on-chip memory assigned to endpoints.
1251 * @pending_status_wq: workqueue handling status stage for deferred requests.
1252 * @pending_status_request: request for which status stage was deferred
1253 */
1261 #define CDNS_REVISION_V0 0x00024501
1262 #define CDNS_REVISION_V1 0x00024509
1263 u32 dev_ver;
1265 /* generic spin-lock for drivers */
1266 spinlock_t lock;
1271 dma_addr_t setup_dma;
1274 u8 ep0_stage;
1282 u32 selected_ep;
1283 u16 isoch_delay;
1298 /*in KB */
1299 u16 onchip_buffers;
1300 u16 onchip_used_size;
1301 };
1323 gfp_t gfp_flags);