OpenWrt – Blame information for rev 1
?pathlinks?
Rev | Author | Line No. | Line |
---|---|---|---|
1 | office | 1 | /* |
2 | * ADM5120 HCD (Host Controller Driver) for USB |
||
3 | * |
||
4 | * Copyright (C) 2007-2008 Gabor Juhos <juhosg@openwrt.org> |
||
5 | * |
||
6 | * This file was derived from: drivers/usb/host/ohci.h |
||
7 | * (C) Copyright 1999 Roman Weissgaerber <weissg@vienna.at> |
||
8 | * (C) Copyright 2000-2002 David Brownell <dbrownell@users.sourceforge.net> |
||
9 | * |
||
10 | * This program is free software; you can redistribute it and/or modify it |
||
11 | * under the terms of the GNU General Public License version 2 as published |
||
12 | * by the Free Software Foundation. |
||
13 | * |
||
14 | */ |
||
15 | |||
16 | /* |
||
17 | * __hc32 and __hc16 are "Host Controller" types, they may be equivalent to |
||
18 | * __leXX (normally) or __beXX (given OHCI_BIG_ENDIAN), depending on the |
||
19 | * host controller implementation. |
||
20 | */ |
||
21 | typedef __u32 __bitwise __hc32; |
||
22 | typedef __u16 __bitwise __hc16; |
||
23 | |||
24 | /* |
||
25 | * OHCI Endpoint Descriptor (ED) ... holds TD queue |
||
26 | * See OHCI spec, section 4.2 |
||
27 | * |
||
28 | * This is a "Queue Head" for those transfers, which is why |
||
29 | * both EHCI and UHCI call similar structures a "QH". |
||
30 | */ |
||
31 | |||
32 | #define TD_DATALEN_MAX 4096 |
||
33 | |||
34 | #define ED_ALIGN 16 |
||
35 | #define ED_MASK ((u32)~(ED_ALIGN-1)) /* strip hw status in low addr bits */ |
||
36 | |||
37 | struct ed { |
||
38 | /* first fields are hardware-specified */ |
||
39 | __hc32 hwINFO; /* endpoint config bitmap */ |
||
40 | /* info bits defined by hcd */ |
||
41 | #define ED_DEQUEUE (1 << 27) |
||
42 | /* info bits defined by the hardware */ |
||
43 | #define ED_MPS_SHIFT 16 |
||
44 | #define ED_MPS_MASK ((1 << 11)-1) |
||
45 | #define ED_MPS_GET(x) (((x) >> ED_MPS_SHIFT) & ED_MPS_MASK) |
||
46 | #define ED_ISO (1 << 15) /* isochronous endpoint */ |
||
47 | #define ED_SKIP (1 << 14) |
||
48 | #define ED_SPEED_FULL (1 << 13) /* fullspeed device */ |
||
49 | #define ED_INT (1 << 11) /* interrupt endpoint */ |
||
50 | #define ED_EN_SHIFT 7 /* endpoint shift */ |
||
51 | #define ED_EN_MASK ((1 << 4)-1) /* endpoint mask */ |
||
52 | #define ED_EN_GET(x) (((x) >> ED_EN_SHIFT) & ED_EN_MASK) |
||
53 | #define ED_FA_MASK ((1 << 7)-1) /* function address mask */ |
||
54 | #define ED_FA_GET(x) ((x) & ED_FA_MASK) |
||
55 | __hc32 hwTailP; /* tail of TD list */ |
||
56 | __hc32 hwHeadP; /* head of TD list (hc r/w) */ |
||
57 | #define ED_C (0x02) /* toggle carry */ |
||
58 | #define ED_H (0x01) /* halted */ |
||
59 | __hc32 hwNextED; /* next ED in list */ |
||
60 | |||
61 | /* rest are purely for the driver's use */ |
||
62 | dma_addr_t dma; /* addr of ED */ |
||
63 | struct td *dummy; /* next TD to activate */ |
||
64 | |||
65 | struct list_head urb_list; /* list of our URBs */ |
||
66 | |||
67 | /* host's view of schedule */ |
||
68 | struct ed *ed_next; /* on schedule list */ |
||
69 | struct ed *ed_prev; /* for non-interrupt EDs */ |
||
70 | struct ed *ed_rm_next; /* on rm list */ |
||
71 | struct list_head td_list; /* "shadow list" of our TDs */ |
||
72 | |||
73 | /* create --> IDLE --> OPER --> ... --> IDLE --> destroy |
||
74 | * usually: OPER --> UNLINK --> (IDLE | OPER) --> ... |
||
75 | */ |
||
76 | u8 state; /* ED_{IDLE,UNLINK,OPER} */ |
||
77 | #define ED_IDLE 0x00 /* NOT linked to HC */ |
||
78 | #define ED_UNLINK 0x01 /* being unlinked from hc */ |
||
79 | #define ED_OPER 0x02 /* IS linked to hc */ |
||
80 | |||
81 | u8 type; /* PIPE_{BULK,...} */ |
||
82 | |||
83 | /* periodic scheduling params (for intr and iso) */ |
||
84 | u8 branch; |
||
85 | u16 interval; |
||
86 | u16 load; |
||
87 | u16 last_iso; /* iso only */ |
||
88 | |||
89 | /* HC may see EDs on rm_list until next frame (frame_no == tick) */ |
||
90 | u16 tick; |
||
91 | } __attribute__ ((aligned(ED_ALIGN))); |
||
92 | |||
93 | /* |
||
94 | * OHCI Transfer Descriptor (TD) ... one per transfer segment |
||
95 | * See OHCI spec, sections 4.3.1 (general = control/bulk/interrupt) |
||
96 | * and 4.3.2 (iso) |
||
97 | */ |
||
98 | |||
99 | #define TD_ALIGN 32 |
||
100 | #define TD_MASK ((u32)~(TD_ALIGN-1)) /* strip hw status in low addr bits */ |
||
101 | |||
102 | struct td { |
||
103 | /* first fields are hardware-specified */ |
||
104 | __hc32 hwINFO; /* transfer info bitmask */ |
||
105 | |||
106 | /* hwINFO bits */ |
||
107 | #define TD_OWN (1 << 31) /* owner of the descriptor */ |
||
108 | #define TD_CC_SHIFT 27 /* condition code */ |
||
109 | #define TD_CC_MASK 0xf |
||
110 | #define TD_CC (TD_CC_MASK << TD_CC_SHIFT) |
||
111 | #define TD_CC_GET(x) (((x) >> TD_CC_SHIFT) & TD_CC_MASK) |
||
112 | |||
113 | #define TD_EC_SHIFT 25 /* error count */ |
||
114 | #define TD_EC_MASK 0x3 |
||
115 | #define TD_EC (TD_EC_MASK << TD_EC_SHIFT) |
||
116 | #define TD_EC_GET(x) ((x >> TD_EC_SHIFT) & TD_EC_MASK) |
||
117 | #define TD_T_SHIFT 23 /* data toggle state */ |
||
118 | #define TD_T_MASK 0x3 |
||
119 | #define TD_T (TD_T_MASK << TD_T_SHIFT) |
||
120 | #define TD_T_DATA0 (0x2 << TD_T_SHIFT) /* DATA0 */ |
||
121 | #define TD_T_DATA1 (0x3 << TD_T_SHIFT) /* DATA1 */ |
||
122 | #define TD_T_CARRY (0x0 << TD_T_SHIFT) /* uses ED_C */ |
||
123 | #define TD_T_GET(x) (((x) >> TD_T_SHIFT) & TD_T_MASK) |
||
124 | #define TD_DP_SHIFT 21 /* direction/pid */ |
||
125 | #define TD_DP_MASK 0x3 |
||
126 | #define TD_DP (TD_DP_MASK << TD_DP_SHIFT) |
||
127 | #define TD_DP_GET (((x) >> TD_DP_SHIFT) & TD_DP_MASK) |
||
128 | #define TD_DP_SETUP (0x0 << TD_DP_SHIFT) /* SETUP pid */ |
||
129 | #define TD_DP_OUT (0x1 << TD_DP_SHIFT) /* OUT pid */ |
||
130 | #define TD_DP_IN (0x2 << TD_DP_SHIFT) /* IN pid */ |
||
131 | #define TD_ISI_SHIFT 8 /* Interrupt Service Interval */ |
||
132 | #define TD_ISI_MASK 0x3f |
||
133 | #define TD_ISI_GET(x) (((x) >> TD_ISI_SHIFT) & TD_ISI_MASK) |
||
134 | #define TD_FN_MASK 0x3f /* frame number */ |
||
135 | #define TD_FN_GET(x) ((x) & TD_FN_MASK) |
||
136 | |||
137 | __hc32 hwDBP; /* Data Buffer Pointer (or 0) */ |
||
138 | __hc32 hwCBL; /* Controller/Buffer Length */ |
||
139 | |||
140 | /* hwCBL bits */ |
||
141 | #define TD_BL_MASK 0xffff /* buffer length */ |
||
142 | #define TD_BL_GET(x) ((x) & TD_BL_MASK) |
||
143 | #define TD_IE (1 << 16) /* interrupt enable */ |
||
144 | __hc32 hwNextTD; /* Next TD Pointer */ |
||
145 | |||
146 | /* rest are purely for the driver's use */ |
||
147 | __u8 index; |
||
148 | struct ed *ed; |
||
149 | struct td *td_hash; /* dma-->td hashtable */ |
||
150 | struct td *next_dl_td; |
||
151 | struct urb *urb; |
||
152 | |||
153 | dma_addr_t td_dma; /* addr of this TD */ |
||
154 | dma_addr_t data_dma; /* addr of data it points to */ |
||
155 | |||
156 | struct list_head td_list; /* "shadow list", TDs on same ED */ |
||
157 | |||
158 | u32 flags; |
||
159 | #define TD_FLAG_DONE (1 << 17) /* retired to done list */ |
||
160 | #define TD_FLAG_ISO (1 << 16) /* copy of ED_ISO */ |
||
161 | } __attribute__ ((aligned(TD_ALIGN))); /* c/b/i need 16; only iso needs 32 */ |
||
162 | |||
163 | /* |
||
164 | * Hardware transfer status codes -- CC from td->hwINFO |
||
165 | */ |
||
166 | #define TD_CC_NOERROR 0x00 |
||
167 | #define TD_CC_CRC 0x01 |
||
168 | #define TD_CC_BITSTUFFING 0x02 |
||
169 | #define TD_CC_DATATOGGLEM 0x03 |
||
170 | #define TD_CC_STALL 0x04 |
||
171 | #define TD_CC_DEVNOTRESP 0x05 |
||
172 | #define TD_CC_PIDCHECKFAIL 0x06 |
||
173 | #define TD_CC_UNEXPECTEDPID 0x07 |
||
174 | #define TD_CC_DATAOVERRUN 0x08 |
||
175 | #define TD_CC_DATAUNDERRUN 0x09 |
||
176 | /* 0x0A, 0x0B reserved for hardware */ |
||
177 | #define TD_CC_BUFFEROVERRUN 0x0C |
||
178 | #define TD_CC_BUFFERUNDERRUN 0x0D |
||
179 | /* 0x0E, 0x0F reserved for HCD */ |
||
180 | #define TD_CC_HCD0 0x0E |
||
181 | #define TD_CC_NOTACCESSED 0x0F |
||
182 | |||
183 | /* |
||
184 | * preshifted status codes |
||
185 | */ |
||
186 | #define TD_SCC_NOTACCESSED (TD_CC_NOTACCESSED << TD_CC_SHIFT) |
||
187 | |||
188 | |||
189 | /* map OHCI TD status codes (CC) to errno values */ |
||
190 | static const int cc_to_error[16] = { |
||
191 | /* No Error */ 0, |
||
192 | /* CRC Error */ -EILSEQ, |
||
193 | /* Bit Stuff */ -EPROTO, |
||
194 | /* Data Togg */ -EILSEQ, |
||
195 | /* Stall */ -EPIPE, |
||
196 | /* DevNotResp */ -ETIME, |
||
197 | /* PIDCheck */ -EPROTO, |
||
198 | /* UnExpPID */ -EPROTO, |
||
199 | /* DataOver */ -EOVERFLOW, |
||
200 | /* DataUnder */ -EREMOTEIO, |
||
201 | /* (for hw) */ -EIO, |
||
202 | /* (for hw) */ -EIO, |
||
203 | /* BufferOver */ -ECOMM, |
||
204 | /* BuffUnder */ -ENOSR, |
||
205 | /* (for HCD) */ -EALREADY, |
||
206 | /* (for HCD) */ -EALREADY |
||
207 | }; |
||
208 | |||
209 | #define NUM_INTS 32 |
||
210 | |||
211 | /* |
||
212 | * This is the structure of the OHCI controller's memory mapped I/O region. |
||
213 | * You must use readl() and writel() (in <asm/io.h>) to access these fields!! |
||
214 | * Layout is in section 7 (and appendix B) of the spec. |
||
215 | */ |
||
216 | struct admhcd_regs { |
||
217 | __hc32 gencontrol; /* General Control */ |
||
218 | __hc32 int_status; /* Interrupt Status */ |
||
219 | __hc32 int_enable; /* Interrupt Enable */ |
||
220 | __hc32 reserved00; |
||
221 | __hc32 host_control; /* Host General Control */ |
||
222 | __hc32 reserved01; |
||
223 | __hc32 fminterval; /* Frame Interval */ |
||
224 | __hc32 fmnumber; /* Frame Number */ |
||
225 | __hc32 reserved02; |
||
226 | __hc32 reserved03; |
||
227 | __hc32 reserved04; |
||
228 | __hc32 reserved05; |
||
229 | __hc32 reserved06; |
||
230 | __hc32 reserved07; |
||
231 | __hc32 reserved08; |
||
232 | __hc32 reserved09; |
||
233 | __hc32 reserved10; |
||
234 | __hc32 reserved11; |
||
235 | __hc32 reserved12; |
||
236 | __hc32 reserved13; |
||
237 | __hc32 reserved14; |
||
238 | __hc32 reserved15; |
||
239 | __hc32 reserved16; |
||
240 | __hc32 reserved17; |
||
241 | __hc32 reserved18; |
||
242 | __hc32 reserved19; |
||
243 | __hc32 reserved20; |
||
244 | __hc32 reserved21; |
||
245 | __hc32 lsthresh; /* Low Speed Threshold */ |
||
246 | __hc32 rhdesc; /* Root Hub Descriptor */ |
||
247 | #define MAX_ROOT_PORTS 2 |
||
248 | __hc32 portstatus[MAX_ROOT_PORTS]; /* Port Status */ |
||
249 | __hc32 hosthead; /* Host Descriptor Head */ |
||
250 | } __attribute__ ((aligned(32))); |
||
251 | |||
252 | /* |
||
253 | * General Control register bits |
||
254 | */ |
||
255 | #define ADMHC_CTRL_UHFE (1 << 0) /* USB Host Function Enable */ |
||
256 | #define ADMHC_CTRL_SIR (1 << 1) /* Software Interrupt request */ |
||
257 | #define ADMHC_CTRL_DMAA (1 << 2) /* DMA Arbitration Control */ |
||
258 | #define ADMHC_CTRL_SR (1 << 3) /* Software Reset */ |
||
259 | |||
260 | /* |
||
261 | * Host General Control register bits |
||
262 | */ |
||
263 | #define ADMHC_HC_BUSS 0x3 /* USB bus state */ |
||
264 | #define ADMHC_BUSS_RESET 0x0 |
||
265 | #define ADMHC_BUSS_RESUME 0x1 |
||
266 | #define ADMHC_BUSS_OPER 0x2 |
||
267 | #define ADMHC_BUSS_SUSPEND 0x3 |
||
268 | #define ADMHC_HC_DMAE (1 << 2) /* DMA enable */ |
||
269 | |||
270 | /* |
||
271 | * Interrupt Status/Enable register bits |
||
272 | */ |
||
273 | #define ADMHC_INTR_SOFI (1 << 4) /* start of frame */ |
||
274 | #define ADMHC_INTR_RESI (1 << 5) /* resume detected */ |
||
275 | #define ADMHC_INTR_6 (1 << 6) /* unknown */ |
||
276 | #define ADMHC_INTR_7 (1 << 7) /* unknown */ |
||
277 | #define ADMHC_INTR_BABI (1 << 8) /* babble detected */ |
||
278 | #define ADMHC_INTR_INSM (1 << 9) /* root hub status change */ |
||
279 | #define ADMHC_INTR_SO (1 << 10) /* scheduling overrun */ |
||
280 | #define ADMHC_INTR_FNO (1 << 11) /* frame number overflow */ |
||
281 | #define ADMHC_INTR_TDC (1 << 20) /* transfer descriptor completed */ |
||
282 | #define ADMHC_INTR_SWI (1 << 29) /* software interrupt */ |
||
283 | #define ADMHC_INTR_FATI (1 << 30) /* fatal error */ |
||
284 | #define ADMHC_INTR_INTA (1 << 31) /* interrupt active */ |
||
285 | |||
286 | #define ADMHC_INTR_MIE (1 << 31) /* master interrupt enable */ |
||
287 | |||
288 | /* |
||
289 | * SOF Frame Interval register bits |
||
290 | */ |
||
291 | #define ADMHC_SFI_FI_MASK ((1 << 14)-1) /* Frame Interval value */ |
||
292 | #define ADMHC_SFI_FSLDP_SHIFT 16 |
||
293 | #define ADMHC_SFI_FSLDP_MASK ((1 << 15)-1) |
||
294 | #define ADMHC_SFI_FIT (1 << 31) /* Frame Interval Toggle */ |
||
295 | |||
296 | /* |
||
297 | * SOF Frame Number register bits |
||
298 | */ |
||
299 | #define ADMHC_SFN_FN_MASK ((1 << 16)-1) /* Frame Number Mask */ |
||
300 | #define ADMHC_SFN_FR_SHIFT 16 /* Frame Remaining Shift */ |
||
301 | #define ADMHC_SFN_FR_MASK ((1 << 14)-1) /* Frame Remaining Mask */ |
||
302 | #define ADMHC_SFN_FRT (1 << 31) /* Frame Remaining Toggle */ |
||
303 | |||
304 | /* |
||
305 | * Root Hub Descriptor register bits |
||
306 | */ |
||
307 | #define ADMHC_RH_NUMP 0xff /* number of ports */ |
||
308 | #define ADMHC_RH_PSM (1 << 8) /* power switching mode */ |
||
309 | #define ADMHC_RH_NPS (1 << 9) /* no power switching */ |
||
310 | #define ADMHC_RH_OCPM (1 << 10) /* over current protection mode */ |
||
311 | #define ADMHC_RH_NOCP (1 << 11) /* no over current protection */ |
||
312 | #define ADMHC_RH_PPCM (0xff << 16) /* port power control */ |
||
313 | |||
314 | #define ADMHC_RH_LPS (1 << 24) /* local power switch */ |
||
315 | #define ADMHC_RH_OCI (1 << 25) /* over current indicator */ |
||
316 | |||
317 | /* status change bits */ |
||
318 | #define ADMHC_RH_LPSC (1 << 26) /* local power switch change */ |
||
319 | #define ADMHC_RH_OCIC (1 << 27) /* over current indicator change */ |
||
320 | |||
321 | #define ADMHC_RH_DRWE (1 << 28) /* device remote wakeup enable */ |
||
322 | #define ADMHC_RH_CRWE (1 << 29) /* clear remote wakeup enable */ |
||
323 | |||
324 | #define ADMHC_RH_CGP (1 << 24) /* clear global power */ |
||
325 | #define ADMHC_RH_SGP (1 << 26) /* set global power */ |
||
326 | |||
327 | /* |
||
328 | * Port Status register bits |
||
329 | */ |
||
330 | #define ADMHC_PS_CCS (1 << 0) /* current connect status */ |
||
331 | #define ADMHC_PS_PES (1 << 1) /* port enable status */ |
||
332 | #define ADMHC_PS_PSS (1 << 2) /* port suspend status */ |
||
333 | #define ADMHC_PS_POCI (1 << 3) /* port over current indicator */ |
||
334 | #define ADMHC_PS_PRS (1 << 4) /* port reset status */ |
||
335 | #define ADMHC_PS_PPS (1 << 8) /* port power status */ |
||
336 | #define ADMHC_PS_LSDA (1 << 9) /* low speed device attached */ |
||
337 | |||
338 | /* status change bits */ |
||
339 | #define ADMHC_PS_CSC (1 << 16) /* connect status change */ |
||
340 | #define ADMHC_PS_PESC (1 << 17) /* port enable status change */ |
||
341 | #define ADMHC_PS_PSSC (1 << 18) /* port suspend status change */ |
||
342 | #define ADMHC_PS_OCIC (1 << 19) /* over current indicator change */ |
||
343 | #define ADMHC_PS_PRSC (1 << 20) /* port reset status change */ |
||
344 | |||
345 | /* port feature bits */ |
||
346 | #define ADMHC_PS_CPE (1 << 0) /* clear port enable */ |
||
347 | #define ADMHC_PS_SPE (1 << 1) /* set port enable */ |
||
348 | #define ADMHC_PS_SPS (1 << 2) /* set port suspend */ |
||
349 | #define ADMHC_PS_CPS (1 << 3) /* clear suspend status */ |
||
350 | #define ADMHC_PS_SPR (1 << 4) /* set port reset */ |
||
351 | #define ADMHC_PS_SPP (1 << 8) /* set port power */ |
||
352 | #define ADMHC_PS_CPP (1 << 9) /* clear port power */ |
||
353 | |||
354 | /* |
||
355 | * the POTPGT value is not defined in the ADMHC, so define a dummy value |
||
356 | */ |
||
357 | #define ADMHC_POTPGT 2 /* in ms */ |
||
358 | |||
359 | /* hcd-private per-urb state */ |
||
360 | struct urb_priv { |
||
361 | struct ed *ed; |
||
362 | struct list_head pending; /* URBs on the same ED */ |
||
363 | |||
364 | u32 td_cnt; /* # tds in this request */ |
||
365 | u32 td_idx; /* index of the current td */ |
||
366 | struct td *td[0]; /* all TDs in this request */ |
||
367 | }; |
||
368 | |||
369 | #define TD_HASH_SIZE 64 /* power'o'two */ |
||
370 | /* sizeof (struct td) ~= 64 == 2^6 ... */ |
||
371 | #define TD_HASH_FUNC(td_dma) ((td_dma ^ (td_dma >> 6)) % TD_HASH_SIZE) |
||
372 | |||
373 | /* |
||
374 | * This is the full ADMHCD controller description |
||
375 | * |
||
376 | * Note how the "proper" USB information is just |
||
377 | * a subset of what the full implementation needs. (Linus) |
||
378 | */ |
||
379 | |||
380 | struct admhcd { |
||
381 | spinlock_t lock; |
||
382 | |||
383 | /* |
||
384 | * I/O memory used to communicate with the HC (dma-consistent) |
||
385 | */ |
||
386 | struct admhcd_regs __iomem *regs; |
||
387 | |||
388 | /* |
||
389 | * hcd adds to schedule for a live hc any time, but removals finish |
||
390 | * only at the start of the next frame. |
||
391 | */ |
||
392 | |||
393 | struct ed *ed_head; |
||
394 | struct ed *ed_tails[4]; |
||
395 | |||
396 | struct ed *ed_rm_list; /* to be removed */ |
||
397 | |||
398 | struct ed *periodic[NUM_INTS]; /* shadow int_table */ |
||
399 | |||
400 | #if 0 /* TODO: remove? */ |
||
401 | /* |
||
402 | * OTG controllers and transceivers need software interaction; |
||
403 | * other external transceivers should be software-transparent |
||
404 | */ |
||
405 | struct otg_transceiver *transceiver; |
||
406 | void (*start_hnp)(struct admhcd *ahcd); |
||
407 | #endif |
||
408 | |||
409 | /* |
||
410 | * memory management for queue data structures |
||
411 | */ |
||
412 | struct dma_pool *td_cache; |
||
413 | struct dma_pool *ed_cache; |
||
414 | struct td *td_hash[TD_HASH_SIZE]; |
||
415 | struct list_head pending; |
||
416 | |||
417 | /* |
||
418 | * driver state |
||
419 | */ |
||
420 | int num_ports; |
||
421 | int load[NUM_INTS]; |
||
422 | u32 host_control; /* copy of the host_control reg */ |
||
423 | unsigned long next_statechange; /* suspend/resume */ |
||
424 | u32 fminterval; /* saved register */ |
||
425 | unsigned autostop:1; /* rh auto stopping/stopped */ |
||
426 | |||
427 | unsigned long flags; /* for HC bugs */ |
||
428 | #define OHCI_QUIRK_AMD756 0x01 /* erratum #4 */ |
||
429 | #define OHCI_QUIRK_SUPERIO 0x02 /* natsemi */ |
||
430 | #define OHCI_QUIRK_INITRESET 0x04 /* SiS, OPTi, ... */ |
||
431 | #define OHCI_QUIRK_BE_DESC 0x08 /* BE descriptors */ |
||
432 | #define OHCI_QUIRK_BE_MMIO 0x10 /* BE registers */ |
||
433 | #define OHCI_QUIRK_ZFMICRO 0x20 /* Compaq ZFMicro chipset*/ |
||
434 | /* there are also chip quirks/bugs in init logic */ |
||
435 | |||
436 | #ifdef DEBUG |
||
437 | struct dentry *debug_dir; |
||
438 | struct dentry *debug_async; |
||
439 | struct dentry *debug_periodic; |
||
440 | struct dentry *debug_registers; |
||
441 | #endif |
||
442 | }; |
||
443 | |||
444 | /* convert between an hcd pointer and the corresponding ahcd_hcd */ |
||
445 | static inline struct admhcd *hcd_to_admhcd(struct usb_hcd *hcd) |
||
446 | { |
||
447 | return (struct admhcd *)(hcd->hcd_priv); |
||
448 | } |
||
449 | static inline struct usb_hcd *admhcd_to_hcd(const struct admhcd *ahcd) |
||
450 | { |
||
451 | return container_of((void *)ahcd, struct usb_hcd, hcd_priv); |
||
452 | } |
||
453 | |||
454 | /*-------------------------------------------------------------------------*/ |
||
455 | |||
456 | #ifndef DEBUG |
||
457 | #define STUB_DEBUG_FILES |
||
458 | #endif /* DEBUG */ |
||
459 | |||
460 | #ifdef DEBUG |
||
461 | # define admhc_dbg(ahcd, fmt, args...) \ |
||
462 | printk(KERN_DEBUG "adm5120-hcd: " fmt, ## args) |
||
463 | #else |
||
464 | # define admhc_dbg(ahcd, fmt, args...) do { } while (0) |
||
465 | #endif |
||
466 | |||
467 | #define admhc_err(ahcd, fmt, args...) \ |
||
468 | printk(KERN_ERR "adm5120-hcd: " fmt, ## args) |
||
469 | #define admhc_info(ahcd, fmt, args...) \ |
||
470 | printk(KERN_INFO "adm5120-hcd: " fmt, ## args) |
||
471 | #define admhc_warn(ahcd, fmt, args...) \ |
||
472 | printk(KERN_WARNING "adm5120-hcd: " fmt, ## args) |
||
473 | |||
474 | #ifdef ADMHC_VERBOSE_DEBUG |
||
475 | # define admhc_vdbg admhc_dbg |
||
476 | #else |
||
477 | # define admhc_vdbg(ahcd, fmt, args...) do { } while (0) |
||
478 | #endif |
||
479 | |||
480 | /*-------------------------------------------------------------------------*/ |
||
481 | |||
482 | /* |
||
483 | * While most USB host controllers implement their registers and |
||
484 | * in-memory communication descriptors in little-endian format, |
||
485 | * a minority (notably the IBM STB04XXX and the Motorola MPC5200 |
||
486 | * processors) implement them in big endian format. |
||
487 | * |
||
488 | * In addition some more exotic implementations like the Toshiba |
||
489 | * Spider (aka SCC) cell southbridge are "mixed" endian, that is, |
||
490 | * they have a different endianness for registers vs. in-memory |
||
491 | * descriptors. |
||
492 | * |
||
493 | * This attempts to support either format at compile time without a |
||
494 | * runtime penalty, or both formats with the additional overhead |
||
495 | * of checking a flag bit. |
||
496 | * |
||
497 | * That leads to some tricky Kconfig rules howevber. There are |
||
498 | * different defaults based on some arch/ppc platforms, though |
||
499 | * the basic rules are: |
||
500 | * |
||
501 | * Controller type Kconfig options needed |
||
502 | * --------------- ---------------------- |
||
503 | * little endian CONFIG_USB_ADMHC_LITTLE_ENDIAN |
||
504 | * |
||
505 | * fully big endian CONFIG_USB_ADMHC_BIG_ENDIAN_DESC _and_ |
||
506 | * CONFIG_USB_ADMHC_BIG_ENDIAN_MMIO |
||
507 | * |
||
508 | * mixed endian CONFIG_USB_ADMHC_LITTLE_ENDIAN _and_ |
||
509 | * CONFIG_USB_OHCI_BIG_ENDIAN_{MMIO,DESC} |
||
510 | * |
||
511 | * (If you have a mixed endian controller, you -must- also define |
||
512 | * CONFIG_USB_ADMHC_LITTLE_ENDIAN or things will not work when building |
||
513 | * both your mixed endian and a fully big endian controller support in |
||
514 | * the same kernel image). |
||
515 | */ |
||
516 | |||
517 | #ifdef CONFIG_USB_ADMHC_BIG_ENDIAN_DESC |
||
518 | #ifdef CONFIG_USB_ADMHC_LITTLE_ENDIAN |
||
519 | #define big_endian_desc(ahcd) (ahcd->flags & OHCI_QUIRK_BE_DESC) |
||
520 | #else |
||
521 | #define big_endian_desc(ahcd) 1 /* only big endian */ |
||
522 | #endif |
||
523 | #else |
||
524 | #define big_endian_desc(ahcd) 0 /* only little endian */ |
||
525 | #endif |
||
526 | |||
527 | #ifdef CONFIG_USB_ADMHC_BIG_ENDIAN_MMIO |
||
528 | #ifdef CONFIG_USB_ADMHC_LITTLE_ENDIAN |
||
529 | #define big_endian_mmio(ahcd) (ahcd->flags & OHCI_QUIRK_BE_MMIO) |
||
530 | #else |
||
531 | #define big_endian_mmio(ahcd) 1 /* only big endian */ |
||
532 | #endif |
||
533 | #else |
||
534 | #define big_endian_mmio(ahcd) 0 /* only little endian */ |
||
535 | #endif |
||
536 | |||
537 | /* |
||
538 | * Big-endian read/write functions are arch-specific. |
||
539 | * Other arches can be added if/when they're needed. |
||
540 | * |
||
541 | */ |
||
542 | static inline unsigned int admhc_readl(const struct admhcd *ahcd, |
||
543 | __hc32 __iomem *regs) |
||
544 | { |
||
545 | #ifdef CONFIG_USB_ADMHC_BIG_ENDIAN_MMIO |
||
546 | return big_endian_mmio(ahcd) ? |
||
547 | readl_be(regs) : |
||
548 | readl(regs); |
||
549 | #else |
||
550 | return readl(regs); |
||
551 | #endif |
||
552 | } |
||
553 | |||
554 | static inline void admhc_writel(const struct admhcd *ahcd, |
||
555 | const unsigned int val, __hc32 __iomem *regs) |
||
556 | { |
||
557 | #ifdef CONFIG_USB_ADMHC_BIG_ENDIAN_MMIO |
||
558 | big_endian_mmio(ahcd) ? |
||
559 | writel_be(val, regs) : |
||
560 | writel(val, regs); |
||
561 | #else |
||
562 | writel(val, regs); |
||
563 | #endif |
||
564 | } |
||
565 | |||
566 | static inline void admhc_writel_flush(const struct admhcd *ahcd) |
||
567 | { |
||
568 | #if 0 |
||
569 | /* TODO: remove? */ |
||
570 | (void) admhc_readl(ahcd, &ahcd->regs->gencontrol); |
||
571 | #endif |
||
572 | } |
||
573 | |||
574 | |||
575 | /*-------------------------------------------------------------------------*/ |
||
576 | |||
577 | /* cpu to ahcd */ |
||
578 | static inline __hc16 cpu_to_hc16(const struct admhcd *ahcd, const u16 x) |
||
579 | { |
||
580 | return big_endian_desc(ahcd) ? |
||
581 | (__force __hc16)cpu_to_be16(x) : |
||
582 | (__force __hc16)cpu_to_le16(x); |
||
583 | } |
||
584 | |||
585 | static inline __hc16 cpu_to_hc16p(const struct admhcd *ahcd, const u16 *x) |
||
586 | { |
||
587 | return big_endian_desc(ahcd) ? |
||
588 | cpu_to_be16p(x) : |
||
589 | cpu_to_le16p(x); |
||
590 | } |
||
591 | |||
592 | static inline __hc32 cpu_to_hc32(const struct admhcd *ahcd, const u32 x) |
||
593 | { |
||
594 | return big_endian_desc(ahcd) ? |
||
595 | (__force __hc32)cpu_to_be32(x) : |
||
596 | (__force __hc32)cpu_to_le32(x); |
||
597 | } |
||
598 | |||
599 | static inline __hc32 cpu_to_hc32p(const struct admhcd *ahcd, const u32 *x) |
||
600 | { |
||
601 | return big_endian_desc(ahcd) ? |
||
602 | cpu_to_be32p(x) : |
||
603 | cpu_to_le32p(x); |
||
604 | } |
||
605 | |||
606 | /* ahcd to cpu */ |
||
607 | static inline u16 hc16_to_cpu(const struct admhcd *ahcd, const __hc16 x) |
||
608 | { |
||
609 | return big_endian_desc(ahcd) ? |
||
610 | be16_to_cpu((__force __be16)x) : |
||
611 | le16_to_cpu((__force __le16)x); |
||
612 | } |
||
613 | |||
614 | static inline u16 hc16_to_cpup(const struct admhcd *ahcd, const __hc16 *x) |
||
615 | { |
||
616 | return big_endian_desc(ahcd) ? |
||
617 | be16_to_cpup((__force __be16 *)x) : |
||
618 | le16_to_cpup((__force __le16 *)x); |
||
619 | } |
||
620 | |||
621 | static inline u32 hc32_to_cpu(const struct admhcd *ahcd, const __hc32 x) |
||
622 | { |
||
623 | return big_endian_desc(ahcd) ? |
||
624 | be32_to_cpu((__force __be32)x) : |
||
625 | le32_to_cpu((__force __le32)x); |
||
626 | } |
||
627 | |||
628 | static inline u32 hc32_to_cpup(const struct admhcd *ahcd, const __hc32 *x) |
||
629 | { |
||
630 | return big_endian_desc(ahcd) ? |
||
631 | be32_to_cpup((__force __be32 *)x) : |
||
632 | le32_to_cpup((__force __le32 *)x); |
||
633 | } |
||
634 | |||
635 | /*-------------------------------------------------------------------------*/ |
||
636 | |||
637 | static inline u16 admhc_frame_no(const struct admhcd *ahcd) |
||
638 | { |
||
639 | u32 t; |
||
640 | |||
641 | t = admhc_readl(ahcd, &ahcd->regs->fmnumber) & ADMHC_SFN_FN_MASK; |
||
642 | return (u16)t; |
||
643 | } |
||
644 | |||
645 | static inline u16 admhc_frame_remain(const struct admhcd *ahcd) |
||
646 | { |
||
647 | u32 t; |
||
648 | |||
649 | t = admhc_readl(ahcd, &ahcd->regs->fmnumber) >> ADMHC_SFN_FR_SHIFT; |
||
650 | t &= ADMHC_SFN_FR_MASK; |
||
651 | return (u16)t; |
||
652 | } |
||
653 | |||
654 | /*-------------------------------------------------------------------------*/ |
||
655 | |||
656 | static inline void admhc_disable(struct admhcd *ahcd) |
||
657 | { |
||
658 | admhcd_to_hcd(ahcd)->state = HC_STATE_HALT; |
||
659 | } |
||
660 | |||
661 | #define FI 0x2edf /* 12000 bits per frame (-1) */ |
||
662 | #define FSLDP(fi) (0x7fff & ((6 * ((fi) - 1200)) / 7)) |
||
663 | #define FIT ADMHC_SFI_FIT |
||
664 | #define LSTHRESH 0x628 /* lowspeed bit threshold */ |
||
665 | |||
666 | static inline void periodic_reinit(struct admhcd *ahcd) |
||
667 | { |
||
668 | #if 0 |
||
669 | u32 fi = ahcd->fminterval & ADMHC_SFI_FI_MASK; |
||
670 | u32 fit = admhc_readl(ahcd, &ahcd->regs->fminterval) & FIT; |
||
671 | |||
672 | /* TODO: adjust FSLargestDataPacket value too? */ |
||
673 | admhc_writel(ahcd, (fit ^ FIT) | ahcd->fminterval, |
||
674 | &ahcd->regs->fminterval); |
||
675 | #else |
||
676 | u32 fit = admhc_readl(ahcd, &ahcd->regs->fminterval) & FIT; |
||
677 | |||
678 | /* TODO: adjust FSLargestDataPacket value too? */ |
||
679 | admhc_writel(ahcd, (fit ^ FIT) | ahcd->fminterval, |
||
680 | &ahcd->regs->fminterval); |
||
681 | #endif |
||
682 | } |
||
683 | |||
684 | static inline u32 admhc_read_rhdesc(struct admhcd *ahcd) |
||
685 | { |
||
686 | return admhc_readl(ahcd, &ahcd->regs->rhdesc); |
||
687 | } |
||
688 | |||
689 | static inline u32 admhc_read_portstatus(struct admhcd *ahcd, int port) |
||
690 | { |
||
691 | return admhc_readl(ahcd, &ahcd->regs->portstatus[port]); |
||
692 | } |
||
693 | |||
694 | static inline void admhc_write_portstatus(struct admhcd *ahcd, int port, |
||
695 | u32 value) |
||
696 | { |
||
697 | admhc_writel(ahcd, value, &ahcd->regs->portstatus[port]); |
||
698 | } |
||
699 | |||
700 | static inline void roothub_write_status(struct admhcd *ahcd, u32 value) |
||
701 | { |
||
702 | /* FIXME: read-only bits must be masked out */ |
||
703 | admhc_writel(ahcd, value, &ahcd->regs->rhdesc); |
||
704 | } |
||
705 | |||
706 | static inline void admhc_intr_disable(struct admhcd *ahcd, u32 ints) |
||
707 | { |
||
708 | u32 t; |
||
709 | |||
710 | t = admhc_readl(ahcd, &ahcd->regs->int_enable); |
||
711 | t &= ~(ints); |
||
712 | admhc_writel(ahcd, t, &ahcd->regs->int_enable); |
||
713 | /* TODO: flush writes ?*/ |
||
714 | } |
||
715 | |||
716 | static inline void admhc_intr_enable(struct admhcd *ahcd, u32 ints) |
||
717 | { |
||
718 | u32 t; |
||
719 | |||
720 | t = admhc_readl(ahcd, &ahcd->regs->int_enable); |
||
721 | t |= ints; |
||
722 | admhc_writel(ahcd, t, &ahcd->regs->int_enable); |
||
723 | /* TODO: flush writes ?*/ |
||
724 | } |
||
725 | |||
726 | static inline void admhc_intr_ack(struct admhcd *ahcd, u32 ints) |
||
727 | { |
||
728 | admhc_writel(ahcd, ints, &ahcd->regs->int_status); |
||
729 | } |
||
730 | |||
731 | static inline void admhc_dma_enable(struct admhcd *ahcd) |
||
732 | { |
||
733 | u32 t; |
||
734 | |||
735 | t = admhc_readl(ahcd, &ahcd->regs->host_control); |
||
736 | if (t & ADMHC_HC_DMAE) |
||
737 | return; |
||
738 | |||
739 | t |= ADMHC_HC_DMAE; |
||
740 | admhc_writel(ahcd, t, &ahcd->regs->host_control); |
||
741 | admhc_vdbg(ahcd, "DMA enabled\n"); |
||
742 | } |
||
743 | |||
744 | static inline void admhc_dma_disable(struct admhcd *ahcd) |
||
745 | { |
||
746 | u32 t; |
||
747 | |||
748 | t = admhc_readl(ahcd, &ahcd->regs->host_control); |
||
749 | if (!(t & ADMHC_HC_DMAE)) |
||
750 | return; |
||
751 | |||
752 | t &= ~ADMHC_HC_DMAE; |
||
753 | admhc_writel(ahcd, t, &ahcd->regs->host_control); |
||
754 | admhc_vdbg(ahcd, "DMA disabled\n"); |
||
755 | } |