]> git.ipfire.org Git - thirdparty/u-boot.git/blame - drivers/usb/host/isp116x.h
Add GPL-2.0+ SPDX-License-Identifier to source files
[thirdparty/u-boot.git] / drivers / usb / host / isp116x.h
CommitLineData
822af351
RG
1/*
2 * ISP116x register declarations and HCD data structures
3 *
4 * Copyright (C) 2007 Rodolfo Giometti <giometti@linux.it>
5 * Copyright (C) 2007 Eurotech S.p.A. <info@eurotech.it>
6 * Copyright (C) 2005 Olav Kongas <ok@artecdesign.ee>
7 * Portions:
8 * Copyright (C) 2004 Lothar Wassmann
9 * Copyright (C) 2004 Psion Teklogix
10 * Copyright (C) 2004 David Brownell
11 *
1a459660 12 * SPDX-License-Identifier: GPL-2.0+
822af351
RG
13 */
14
15#ifdef DEBUG
16#define DBG(fmt, args...) \
17 printf("isp116x: %s: " fmt "\n" , __FUNCTION__ , ## args)
18#else
19#define DBG(fmt, args...) do {} while (0)
20#endif
21
22#ifdef VERBOSE
23# define VDBG DBG
24#else
25# define VDBG(fmt, args...) do {} while (0)
26#endif
27
28#define ERR(fmt, args...) \
29 printf("isp116x: %s: " fmt "\n" , __FUNCTION__ , ## args)
30#define WARN(fmt, args...) \
31 printf("isp116x: %s: " fmt "\n" , __FUNCTION__ , ## args)
32#define INFO(fmt, args...) \
33 printf("isp116x: " fmt "\n" , ## args)
34
35/* ------------------------------------------------------------------------- */
36
37/* us of 1ms frame */
38#define MAX_LOAD_LIMIT 850
39
40/* Full speed: max # of bytes to transfer for a single urb
41 at a time must be < 1024 && must be multiple of 64.
42 832 allows transfering 4kiB within 5 frames. */
43#define MAX_TRANSFER_SIZE_FULLSPEED 832
44
45/* Low speed: there is no reason to schedule in very big
46 chunks; often the requested long transfers are for
47 string descriptors containing short strings. */
48#define MAX_TRANSFER_SIZE_LOWSPEED 64
49
50/* Bytetime (us), a rough indication of how much time it
51 would take to transfer a byte of useful data over USB */
52#define BYTE_TIME_FULLSPEED 1
53#define BYTE_TIME_LOWSPEED 20
54
55/* Buffer sizes */
56#define ISP116x_BUF_SIZE 4096
57#define ISP116x_ITL_BUFSIZE 0
58#define ISP116x_ATL_BUFSIZE ((ISP116x_BUF_SIZE) - 2*(ISP116x_ITL_BUFSIZE))
59
60#define ISP116x_WRITE_OFFSET 0x80
61
62/* --- ISP116x registers/bits ---------------------------------------------- */
63
64#define HCREVISION 0x00
65#define HCCONTROL 0x01
66#define HCCONTROL_HCFS (3 << 6) /* host controller
67 functional state */
68#define HCCONTROL_USB_RESET (0 << 6)
69#define HCCONTROL_USB_RESUME (1 << 6)
70#define HCCONTROL_USB_OPER (2 << 6)
71#define HCCONTROL_USB_SUSPEND (3 << 6)
72#define HCCONTROL_RWC (1 << 9) /* remote wakeup connected */
73#define HCCONTROL_RWE (1 << 10) /* remote wakeup enable */
74#define HCCMDSTAT 0x02
75#define HCCMDSTAT_HCR (1 << 0) /* host controller reset */
76#define HCCMDSTAT_SOC (3 << 16) /* scheduling overrun count */
77#define HCINTSTAT 0x03
78#define HCINT_SO (1 << 0) /* scheduling overrun */
79#define HCINT_WDH (1 << 1) /* writeback of done_head */
80#define HCINT_SF (1 << 2) /* start frame */
81#define HCINT_RD (1 << 3) /* resume detect */
82#define HCINT_UE (1 << 4) /* unrecoverable error */
83#define HCINT_FNO (1 << 5) /* frame number overflow */
84#define HCINT_RHSC (1 << 6) /* root hub status change */
85#define HCINT_OC (1 << 30) /* ownership change */
86#define HCINT_MIE (1 << 31) /* master interrupt enable */
87#define HCINTENB 0x04
88#define HCINTDIS 0x05
89#define HCFMINTVL 0x0d
90#define HCFMREM 0x0e
91#define HCFMNUM 0x0f
92#define HCLSTHRESH 0x11
93#define HCRHDESCA 0x12
94#define RH_A_NDP (0x3 << 0) /* # downstream ports */
95#define RH_A_PSM (1 << 8) /* power switching mode */
96#define RH_A_NPS (1 << 9) /* no power switching */
97#define RH_A_DT (1 << 10) /* device type (mbz) */
98#define RH_A_OCPM (1 << 11) /* overcurrent protection
99 mode */
100#define RH_A_NOCP (1 << 12) /* no overcurrent protection */
101#define RH_A_POTPGT (0xff << 24) /* power on -> power good
102 time */
103#define HCRHDESCB 0x13
104#define RH_B_DR (0xffff << 0) /* device removable flags */
105#define RH_B_PPCM (0xffff << 16) /* port power control mask */
106#define HCRHSTATUS 0x14
107#define RH_HS_LPS (1 << 0) /* local power status */
108#define RH_HS_OCI (1 << 1) /* over current indicator */
109#define RH_HS_DRWE (1 << 15) /* device remote wakeup
110 enable */
111#define RH_HS_LPSC (1 << 16) /* local power status change */
112#define RH_HS_OCIC (1 << 17) /* over current indicator
113 change */
114#define RH_HS_CRWE (1 << 31) /* clear remote wakeup
115 enable */
116#define HCRHPORT1 0x15
117#define RH_PS_CCS (1 << 0) /* current connect status */
118#define RH_PS_PES (1 << 1) /* port enable status */
119#define RH_PS_PSS (1 << 2) /* port suspend status */
120#define RH_PS_POCI (1 << 3) /* port over current
121 indicator */
122#define RH_PS_PRS (1 << 4) /* port reset status */
123#define RH_PS_PPS (1 << 8) /* port power status */
124#define RH_PS_LSDA (1 << 9) /* low speed device attached */
125#define RH_PS_CSC (1 << 16) /* connect status change */
126#define RH_PS_PESC (1 << 17) /* port enable status change */
127#define RH_PS_PSSC (1 << 18) /* port suspend status
128 change */
129#define RH_PS_OCIC (1 << 19) /* over current indicator
130 change */
131#define RH_PS_PRSC (1 << 20) /* port reset status change */
132#define HCRHPORT_CLRMASK (0x1f << 16)
133#define HCRHPORT2 0x16
134#define HCHWCFG 0x20
135#define HCHWCFG_15KRSEL (1 << 12)
136#define HCHWCFG_CLKNOTSTOP (1 << 11)
137#define HCHWCFG_ANALOG_OC (1 << 10)
138#define HCHWCFG_DACK_MODE (1 << 8)
139#define HCHWCFG_EOT_POL (1 << 7)
140#define HCHWCFG_DACK_POL (1 << 6)
141#define HCHWCFG_DREQ_POL (1 << 5)
142#define HCHWCFG_DBWIDTH_MASK (0x03 << 3)
143#define HCHWCFG_DBWIDTH(n) (((n) << 3) & HCHWCFG_DBWIDTH_MASK)
144#define HCHWCFG_INT_POL (1 << 2)
145#define HCHWCFG_INT_TRIGGER (1 << 1)
146#define HCHWCFG_INT_ENABLE (1 << 0)
147#define HCDMACFG 0x21
148#define HCDMACFG_BURST_LEN_MASK (0x03 << 5)
149#define HCDMACFG_BURST_LEN(n) (((n) << 5) & HCDMACFG_BURST_LEN_MASK)
150#define HCDMACFG_BURST_LEN_1 HCDMACFG_BURST_LEN(0)
151#define HCDMACFG_BURST_LEN_4 HCDMACFG_BURST_LEN(1)
152#define HCDMACFG_BURST_LEN_8 HCDMACFG_BURST_LEN(2)
153#define HCDMACFG_DMA_ENABLE (1 << 4)
154#define HCDMACFG_BUF_TYPE_MASK (0x07 << 1)
155#define HCDMACFG_CTR_SEL (1 << 2)
156#define HCDMACFG_ITLATL_SEL (1 << 1)
157#define HCDMACFG_DMA_RW_SELECT (1 << 0)
158#define HCXFERCTR 0x22
159#define HCuPINT 0x24
160#define HCuPINT_SOF (1 << 0)
161#define HCuPINT_ATL (1 << 1)
162#define HCuPINT_AIIEOT (1 << 2)
163#define HCuPINT_OPR (1 << 4)
164#define HCuPINT_SUSP (1 << 5)
165#define HCuPINT_CLKRDY (1 << 6)
166#define HCuPINTENB 0x25
167#define HCCHIPID 0x27
168#define HCCHIPID_MASK 0xff00
169#define HCCHIPID_MAGIC 0x6100
170#define HCSCRATCH 0x28
171#define HCSWRES 0x29
172#define HCSWRES_MAGIC 0x00f6
173#define HCITLBUFLEN 0x2a
174#define HCATLBUFLEN 0x2b
175#define HCBUFSTAT 0x2c
176#define HCBUFSTAT_ITL0_FULL (1 << 0)
177#define HCBUFSTAT_ITL1_FULL (1 << 1)
178#define HCBUFSTAT_ATL_FULL (1 << 2)
179#define HCBUFSTAT_ITL0_DONE (1 << 3)
180#define HCBUFSTAT_ITL1_DONE (1 << 4)
181#define HCBUFSTAT_ATL_DONE (1 << 5)
182#define HCRDITL0LEN 0x2d
183#define HCRDITL1LEN 0x2e
184#define HCITLPORT 0x40
185#define HCATLPORT 0x41
186
187/* PTD accessor macros. */
188#define PTD_GET_COUNT(p) (((p)->count & PTD_COUNT_MSK) >> 0)
189#define PTD_COUNT(v) (((v) << 0) & PTD_COUNT_MSK)
190#define PTD_GET_TOGGLE(p) (((p)->count & PTD_TOGGLE_MSK) >> 10)
191#define PTD_TOGGLE(v) (((v) << 10) & PTD_TOGGLE_MSK)
192#define PTD_GET_ACTIVE(p) (((p)->count & PTD_ACTIVE_MSK) >> 11)
193#define PTD_ACTIVE(v) (((v) << 11) & PTD_ACTIVE_MSK)
194#define PTD_GET_CC(p) (((p)->count & PTD_CC_MSK) >> 12)
195#define PTD_CC(v) (((v) << 12) & PTD_CC_MSK)
196#define PTD_GET_MPS(p) (((p)->mps & PTD_MPS_MSK) >> 0)
197#define PTD_MPS(v) (((v) << 0) & PTD_MPS_MSK)
198#define PTD_GET_SPD(p) (((p)->mps & PTD_SPD_MSK) >> 10)
199#define PTD_SPD(v) (((v) << 10) & PTD_SPD_MSK)
200#define PTD_GET_LAST(p) (((p)->mps & PTD_LAST_MSK) >> 11)
201#define PTD_LAST(v) (((v) << 11) & PTD_LAST_MSK)
202#define PTD_GET_EP(p) (((p)->mps & PTD_EP_MSK) >> 12)
203#define PTD_EP(v) (((v) << 12) & PTD_EP_MSK)
204#define PTD_GET_LEN(p) (((p)->len & PTD_LEN_MSK) >> 0)
205#define PTD_LEN(v) (((v) << 0) & PTD_LEN_MSK)
206#define PTD_GET_DIR(p) (((p)->len & PTD_DIR_MSK) >> 10)
207#define PTD_DIR(v) (((v) << 10) & PTD_DIR_MSK)
208#define PTD_GET_B5_5(p) (((p)->len & PTD_B5_5_MSK) >> 13)
209#define PTD_B5_5(v) (((v) << 13) & PTD_B5_5_MSK)
210#define PTD_GET_FA(p) (((p)->faddr & PTD_FA_MSK) >> 0)
211#define PTD_FA(v) (((v) << 0) & PTD_FA_MSK)
212#define PTD_GET_FMT(p) (((p)->faddr & PTD_FMT_MSK) >> 7)
213#define PTD_FMT(v) (((v) << 7) & PTD_FMT_MSK)
214
215/* Hardware transfer status codes -- CC from ptd->count */
216#define TD_CC_NOERROR 0x00
217#define TD_CC_CRC 0x01
218#define TD_CC_BITSTUFFING 0x02
219#define TD_CC_DATATOGGLEM 0x03
220#define TD_CC_STALL 0x04
221#define TD_DEVNOTRESP 0x05
222#define TD_PIDCHECKFAIL 0x06
223#define TD_UNEXPECTEDPID 0x07
224#define TD_DATAOVERRUN 0x08
225#define TD_DATAUNDERRUN 0x09
226 /* 0x0A, 0x0B reserved for hardware */
227#define TD_BUFFEROVERRUN 0x0C
228#define TD_BUFFERUNDERRUN 0x0D
229 /* 0x0E, 0x0F reserved for HCD */
230#define TD_NOTACCESSED 0x0F
231
232/* ------------------------------------------------------------------------- */
233
234#define LOG2_PERIODIC_SIZE 5 /* arbitrary; this matches OHCI */
235#define PERIODIC_SIZE (1 << LOG2_PERIODIC_SIZE)
236
237/* Philips transfer descriptor */
238struct ptd {
239 u16 count;
240#define PTD_COUNT_MSK (0x3ff << 0)
241#define PTD_TOGGLE_MSK (1 << 10)
242#define PTD_ACTIVE_MSK (1 << 11)
243#define PTD_CC_MSK (0xf << 12)
244 u16 mps;
245#define PTD_MPS_MSK (0x3ff << 0)
246#define PTD_SPD_MSK (1 << 10)
247#define PTD_LAST_MSK (1 << 11)
248#define PTD_EP_MSK (0xf << 12)
249 u16 len;
250#define PTD_LEN_MSK (0x3ff << 0)
251#define PTD_DIR_MSK (3 << 10)
252#define PTD_DIR_SETUP (0)
253#define PTD_DIR_OUT (1)
254#define PTD_DIR_IN (2)
255#define PTD_B5_5_MSK (1 << 13)
256 u16 faddr;
257#define PTD_FA_MSK (0x7f << 0)
258#define PTD_FMT_MSK (1 << 7)
259} __attribute__ ((packed, aligned(2)));
260
261struct isp116x_ep {
262 struct usb_device *udev;
263 struct ptd ptd;
264
265 u8 maxpacket;
266 u8 epnum;
267 u8 nextpid;
268
269 u16 length; /* of current packet */
270 unsigned char *data; /* to databuf */
271
272 u16 error_count;
273};
274
275/* URB struct */
276#define N_URB_TD 48
277#define URB_DEL 1
278typedef struct {
279 struct isp116x_ep *ed;
280 void *transfer_buffer; /* (in) associated data buffer */
281 int actual_length; /* (return) actual transfer length */
282 unsigned long pipe; /* (in) pipe information */
283#if 0
284 int state;
285#endif
286} urb_priv_t;
287
288struct isp116x_platform_data {
289 /* Enable internal resistors on downstream ports */
290 unsigned sel15Kres:1;
291 /* On-chip overcurrent detection */
292 unsigned oc_enable:1;
293 /* Enable wakeup by devices on usb bus (e.g. wakeup
294 by attachment/detachment or by device activity
295 such as moving a mouse). When chosen, this option
296 prevents stopping internal clock, increasing
297 thereby power consumption in suspended state. */
298 unsigned remote_wakeup_enable:1;
299};
300
301struct isp116x {
302 u16 *addr_reg;
303 u16 *data_reg;
304
305 struct isp116x_platform_data *board;
306
307 struct dentry *dentry;
308 unsigned long stat1, stat2, stat4, stat8, stat16;
309
310 /* Status flags */
311 unsigned disabled:1;
312 unsigned sleeping:1;
313
314 /* Root hub registers */
315 u32 rhdesca;
316 u32 rhdescb;
317 u32 rhstatus;
318 u32 rhport[2];
319
320 /* Schedule for the current frame */
321 struct isp116x_ep *atl_active;
322 int atl_buflen;
323 int atl_bufshrt;
324 int atl_last_dir;
325 int atl_finishing;
326};
327
328/* ------------------------------------------------- */
329
330/* Inter-io delay (ns). The chip is picky about access timings; it
331 * expects at least:
332 * 150ns delay between consecutive accesses to DATA_REG,
333 * 300ns delay between access to ADDR_REG and DATA_REG
334 * OE, WE MUST NOT be changed during these intervals
335 */
336#if defined(UDELAY)
337#define isp116x_delay(h,d) udelay(d)
338#else
339#define isp116x_delay(h,d) do {} while (0)
340#endif
341
342static inline void isp116x_write_addr(struct isp116x *isp116x, unsigned reg)
343{
344 writew(reg & 0xff, isp116x->addr_reg);
345 isp116x_delay(isp116x, UDELAY);
346}
347
348static inline void isp116x_write_data16(struct isp116x *isp116x, u16 val)
349{
350 writew(val, isp116x->data_reg);
351 isp116x_delay(isp116x, UDELAY);
352}
353
354static inline void isp116x_raw_write_data16(struct isp116x *isp116x, u16 val)
355{
356 __raw_writew(val, isp116x->data_reg);
357 isp116x_delay(isp116x, UDELAY);
358}
359
360static inline u16 isp116x_read_data16(struct isp116x *isp116x)
361{
362 u16 val;
363
364 val = readw(isp116x->data_reg);
365 isp116x_delay(isp116x, UDELAY);
366 return val;
367}
368
369static inline u16 isp116x_raw_read_data16(struct isp116x *isp116x)
370{
371 u16 val;
372
373 val = __raw_readw(isp116x->data_reg);
374 isp116x_delay(isp116x, UDELAY);
375 return val;
376}
377
378static inline void isp116x_write_data32(struct isp116x *isp116x, u32 val)
379{
380 writew(val & 0xffff, isp116x->data_reg);
381 isp116x_delay(isp116x, UDELAY);
382 writew(val >> 16, isp116x->data_reg);
383 isp116x_delay(isp116x, UDELAY);
384}
385
386static inline u32 isp116x_read_data32(struct isp116x *isp116x)
387{
388 u32 val;
389
390 val = (u32) readw(isp116x->data_reg);
391 isp116x_delay(isp116x, UDELAY);
392 val |= ((u32) readw(isp116x->data_reg)) << 16;
393 isp116x_delay(isp116x, UDELAY);
394 return val;
395}
396
397/* Let's keep register access functions out of line. Hint:
398 we wait at least 150 ns at every access.
399*/
400static u16 isp116x_read_reg16(struct isp116x *isp116x, unsigned reg)
401{
402 isp116x_write_addr(isp116x, reg);
403 return isp116x_read_data16(isp116x);
404}
405
406static u32 isp116x_read_reg32(struct isp116x *isp116x, unsigned reg)
407{
408 isp116x_write_addr(isp116x, reg);
409 return isp116x_read_data32(isp116x);
410}
411
412static void isp116x_write_reg16(struct isp116x *isp116x, unsigned reg,
413 unsigned val)
414{
415 isp116x_write_addr(isp116x, reg | ISP116x_WRITE_OFFSET);
416 isp116x_write_data16(isp116x, (u16) (val & 0xffff));
417}
418
419static void isp116x_write_reg32(struct isp116x *isp116x, unsigned reg,
420 unsigned val)
421{
422 isp116x_write_addr(isp116x, reg | ISP116x_WRITE_OFFSET);
423 isp116x_write_data32(isp116x, (u32) val);
424}
425
426/* --- USB HUB constants (not OHCI-specific; see hub.h) -------------------- */
427
428/* destination of request */
429#define RH_INTERFACE 0x01
430#define RH_ENDPOINT 0x02
431#define RH_OTHER 0x03
432
433#define RH_CLASS 0x20
434#define RH_VENDOR 0x40
435
436/* Requests: bRequest << 8 | bmRequestType */
437#define RH_GET_STATUS 0x0080
438#define RH_CLEAR_FEATURE 0x0100
439#define RH_SET_FEATURE 0x0300
440#define RH_SET_ADDRESS 0x0500
441#define RH_GET_DESCRIPTOR 0x0680
442#define RH_SET_DESCRIPTOR 0x0700
443#define RH_GET_CONFIGURATION 0x0880
444#define RH_SET_CONFIGURATION 0x0900
445#define RH_GET_STATE 0x0280
446#define RH_GET_INTERFACE 0x0A80
447#define RH_SET_INTERFACE 0x0B00
448#define RH_SYNC_FRAME 0x0C80
449/* Our Vendor Specific Request */
450#define RH_SET_EP 0x2000
451
452/* Hub port features */
453#define RH_PORT_CONNECTION 0x00
454#define RH_PORT_ENABLE 0x01
455#define RH_PORT_SUSPEND 0x02
456#define RH_PORT_OVER_CURRENT 0x03
457#define RH_PORT_RESET 0x04
458#define RH_PORT_POWER 0x08
459#define RH_PORT_LOW_SPEED 0x09
460
461#define RH_C_PORT_CONNECTION 0x10
462#define RH_C_PORT_ENABLE 0x11
463#define RH_C_PORT_SUSPEND 0x12
464#define RH_C_PORT_OVER_CURRENT 0x13
465#define RH_C_PORT_RESET 0x14
466
467/* Hub features */
468#define RH_C_HUB_LOCAL_POWER 0x00
469#define RH_C_HUB_OVER_CURRENT 0x01
470
471#define RH_DEVICE_REMOTE_WAKEUP 0x00
472#define RH_ENDPOINT_STALL 0x01
473
474#define RH_ACK 0x01
475#define RH_REQ_ERR -1
476#define RH_NACK 0x00