1// SPDX-License-Identifier: GPL-2.0+
2/*
3 * Intel PXA25x on-chip full speed USB device controller
4 *
5 * Copyright (C) 2003 Robert Schwebel <r.schwebel@pengutronix.de>, Pengutronix
6 * Copyright (C) 2003 David Brownell
7 */
8
9#ifndef __LINUX_USB_GADGET_PXA25X_H
10#define __LINUX_USB_GADGET_PXA25X_H
11
12#include <linux/types.h>
13
14/*-------------------------------------------------------------------------*/
15
16/* pxa25x has this (move to include/asm-arm/arch-pxa/pxa-regs.h) */
17#define UFNRH_SIR	(1 << 7)	/* SOF interrupt request */
18#define UFNRH_SIM	(1 << 6)	/* SOF interrupt mask */
19#define UFNRH_IPE14	(1 << 5)	/* ISO packet error, ep14 */
20#define UFNRH_IPE9	(1 << 4)	/* ISO packet error, ep9 */
21#define UFNRH_IPE4	(1 << 3)	/* ISO packet error, ep4 */
22
23/* pxa255 has this (move to include/asm-arm/arch-pxa/pxa-regs.h) */
24#define	UDCCFR		UDC_RES2	/* UDC Control Function Register */
25#define UDCCFR_AREN	(1 << 7)	/* ACK response enable (now) */
26#define UDCCFR_ACM	(1 << 2)	/* ACK control mode (wait for AREN) */
27
28/* latest pxa255 errata define new "must be one" bits in UDCCFR */
29#define	UDCCFR_MB1	(0xff & ~(UDCCFR_AREN|UDCCFR_ACM))
30
31/*-------------------------------------------------------------------------*/
32
33struct pxa25x_udc;
34
35struct pxa25x_ep {
36	struct usb_ep				ep;
37	struct pxa25x_udc			*dev;
38
39	struct list_head			queue;
40	unsigned long				pio_irqs;
41
42	unsigned short				fifo_size;
43	u8					bEndpointAddress;
44	u8					bmAttributes;
45
46	unsigned				stopped : 1;
47	unsigned				dma_fixup : 1;
48
49	/* UDCCS = UDC Control/Status for this EP
50	 * UBCR = UDC Byte Count Remaining (contents of OUT fifo)
51	 * UDDR = UDC Endpoint Data Register (the fifo)
52	 * DRCM = DMA Request Channel Map
53	 */
54	u32					regoff_udccs;
55	u32					regoff_ubcr;
56	u32					regoff_uddr;
57};
58
59struct pxa25x_request {
60	struct usb_request			req;
61	struct list_head			queue;
62};
63
64enum ep0_state {
65	EP0_IDLE,
66	EP0_IN_DATA_PHASE,
67	EP0_OUT_DATA_PHASE,
68	EP0_END_XFER,
69	EP0_STALL,
70};
71
72#define EP0_FIFO_SIZE	((unsigned)16)
73#define BULK_FIFO_SIZE	((unsigned)64)
74#define ISO_FIFO_SIZE	((unsigned)256)
75#define INT_FIFO_SIZE	((unsigned)8)
76
77struct udc_stats {
78	struct ep0stats {
79		unsigned long		ops;
80		unsigned long		bytes;
81	} read, write;
82	unsigned long			irqs;
83};
84
85#ifdef CONFIG_USB_PXA25X_SMALL
86/* when memory's tight, SMALL config saves code+data.  */
87#define	PXA_UDC_NUM_ENDPOINTS	3
88#endif
89
90#ifndef	PXA_UDC_NUM_ENDPOINTS
91#define	PXA_UDC_NUM_ENDPOINTS	16
92#endif
93
94struct pxa25x_udc {
95	struct usb_gadget			gadget;
96	struct usb_gadget_driver		*driver;
97
98	enum ep0_state				ep0state;
99	struct udc_stats			stats;
100	unsigned				got_irq : 1,
101						vbus : 1,
102						pullup : 1,
103						has_cfr : 1,
104						req_pending : 1,
105						req_std : 1,
106						req_config : 1,
107						suspended : 1,
108						active : 1;
109
110#define start_watchdog(dev) mod_timer(&dev->timer, jiffies + (HZ/200))
111	struct timer_list			timer;
112
113	struct device				*dev;
114	struct clk				*clk;
115	struct pxa2xx_udc_mach_info		*mach;
116	struct usb_phy				*transceiver;
117	u64					dma_mask;
118	struct pxa25x_ep			ep [PXA_UDC_NUM_ENDPOINTS];
119
120#ifdef CONFIG_USB_GADGET_DEBUG_FS
121	struct dentry				*debugfs_udc;
122#endif
123	void __iomem				*regs;
124};
125#define to_pxa25x(g)	(container_of((g), struct pxa25x_udc, gadget))
126
127/*-------------------------------------------------------------------------*/
128
129#ifdef CONFIG_ARCH_LUBBOCK
130#include <mach/lubbock.h>
131/* lubbock can also report usb connect/disconnect irqs */
132#endif
133
134static struct pxa25x_udc *the_controller;
135
136/*-------------------------------------------------------------------------*/
137
138/*
139 * Debugging support vanishes in non-debug builds.  DBG_NORMAL should be
140 * mostly silent during normal use/testing, with no timing side-effects.
141 */
142#define DBG_NORMAL	1	/* error paths, device state transitions */
143#define DBG_VERBOSE	2	/* add some success path trace info */
144#define DBG_NOISY	3	/* ... even more: request level */
145#define DBG_VERY_NOISY	4	/* ... even more: packet level */
146
147#define DMSG(stuff...)	pr_debug("udc: " stuff)
148
149#ifdef DEBUG
150
151static const char *state_name[] = {
152	"EP0_IDLE",
153	"EP0_IN_DATA_PHASE", "EP0_OUT_DATA_PHASE",
154	"EP0_END_XFER", "EP0_STALL"
155};
156
157#ifdef VERBOSE_DEBUG
158#    define UDC_DEBUG DBG_VERBOSE
159#else
160#    define UDC_DEBUG DBG_NORMAL
161#endif
162
163static void __maybe_unused
164dump_udccr(const char *label)
165{
166	u32	udccr = UDCCR;
167	DMSG("%s %02X =%s%s%s%s%s%s%s%s\n",
168		label, udccr,
169		(udccr & UDCCR_REM) ? " rem" : "",
170		(udccr & UDCCR_RSTIR) ? " rstir" : "",
171		(udccr & UDCCR_SRM) ? " srm" : "",
172		(udccr & UDCCR_SUSIR) ? " susir" : "",
173		(udccr & UDCCR_RESIR) ? " resir" : "",
174		(udccr & UDCCR_RSM) ? " rsm" : "",
175		(udccr & UDCCR_UDA) ? " uda" : "",
176		(udccr & UDCCR_UDE) ? " ude" : "");
177}
178
179static void __maybe_unused
180dump_udccs0(const char *label)
181{
182	u32		udccs0 = UDCCS0;
183
184	DMSG("%s %s %02X =%s%s%s%s%s%s%s%s\n",
185		label, state_name[the_controller->ep0state], udccs0,
186		(udccs0 & UDCCS0_SA) ? " sa" : "",
187		(udccs0 & UDCCS0_RNE) ? " rne" : "",
188		(udccs0 & UDCCS0_FST) ? " fst" : "",
189		(udccs0 & UDCCS0_SST) ? " sst" : "",
190		(udccs0 & UDCCS0_DRWF) ? " dwrf" : "",
191		(udccs0 & UDCCS0_FTF) ? " ftf" : "",
192		(udccs0 & UDCCS0_IPR) ? " ipr" : "",
193		(udccs0 & UDCCS0_OPR) ? " opr" : "");
194}
195
196static inline u32 udc_ep_get_UDCCS(struct pxa25x_ep *);
197
198static void __maybe_unused
199dump_state(struct pxa25x_udc *dev)
200{
201	u32		tmp;
202	unsigned	i;
203
204	DMSG("%s, uicr %02X.%02X, usir %02X.%02x, ufnr %02X.%02X\n",
205		state_name[dev->ep0state],
206		UICR1, UICR0, USIR1, USIR0, UFNRH, UFNRL);
207	dump_udccr("udccr");
208	if (dev->has_cfr) {
209		tmp = UDCCFR;
210		DMSG("udccfr %02X =%s%s\n", tmp,
211			(tmp & UDCCFR_AREN) ? " aren" : "",
212			(tmp & UDCCFR_ACM) ? " acm" : "");
213	}
214
215	if (!dev->driver) {
216		DMSG("no gadget driver bound\n");
217		return;
218	} else
219		DMSG("ep0 driver '%s'\n", dev->driver->driver.name);
220
221	dump_udccs0 ("udccs0");
222	DMSG("ep0 IN %lu/%lu, OUT %lu/%lu\n",
223		dev->stats.write.bytes, dev->stats.write.ops,
224		dev->stats.read.bytes, dev->stats.read.ops);
225
226	for (i = 1; i < PXA_UDC_NUM_ENDPOINTS; i++) {
227		if (dev->ep[i].ep.desc == NULL)
228			continue;
229		DMSG ("udccs%d = %02x\n", i, udc_ep_get_UDCCS(&dev->ep[i]));
230	}
231}
232
233#else
234
235#define	dump_udccr(x)	do{}while(0)
236#define	dump_udccs0(x)	do{}while(0)
237#define	dump_state(x)	do{}while(0)
238
239#define UDC_DEBUG ((unsigned)0)
240
241#endif
242
243#define DBG(lvl, stuff...) do{if ((lvl) <= UDC_DEBUG) DMSG(stuff);}while(0)
244
245#define ERR(stuff...)		pr_err("udc: " stuff)
246#define WARNING(stuff...)	pr_warn("udc: " stuff)
247#define INFO(stuff...)		pr_info("udc: " stuff)
248
249
250#endif /* __LINUX_USB_GADGET_PXA25X_H */
251