1 /* SPDX-License-Identifier: GPL-1.0+ */ 2 /* 3 * OHCI HCD (Host Controller Driver) for USB. 4 * 5 * (C) Copyright 1999 Roman Weissgaerber <weissg@vienna.at> 6 * (C) Copyright 2000-2002 David Brownell <dbrownell@users.sourceforge.net> 7 * 8 * This file is licenced under the GPL. 9 */ 10 11 /* 12 * __hc32 and __hc16 are "Host Controller" types, they may be equivalent to 13 * __leXX (normally) or __beXX (given OHCI_BIG_ENDIAN), depending on the 14 * host controller implementation. 15 */ 16 typedef __u32 __bitwise __hc32; 17 typedef __u16 __bitwise __hc16; 18 19 /* 20 * OHCI Endpoint Descriptor (ED) ... holds TD queue 21 * See OHCI spec, section 4.2 22 * 23 * This is a "Queue Head" for those transfers, which is why 24 * both EHCI and UHCI call similar structures a "QH". 25 */ 26 struct ed { 27 /* first fields are hardware-specified */ 28 __hc32 hwINFO; /* endpoint config bitmap */ 29 /* info bits defined by hcd */ 30 #define ED_DEQUEUE (1 << 27) 31 /* info bits defined by the hardware */ 32 #define ED_ISO (1 << 15) 33 #define ED_SKIP (1 << 14) 34 #define ED_LOWSPEED (1 << 13) 35 #define ED_OUT (0x01 << 11) 36 #define ED_IN (0x02 << 11) 37 __hc32 hwTailP; /* tail of TD list */ 38 __hc32 hwHeadP; /* head of TD list (hc r/w) */ 39 #define ED_C (0x02) /* toggle carry */ 40 #define ED_H (0x01) /* halted */ 41 __hc32 hwNextED; /* next ED in list */ 42 43 /* rest are purely for the driver's use */ 44 dma_addr_t dma; /* addr of ED */ 45 struct td *dummy; /* next TD to activate */ 46 47 /* host's view of schedule */ 48 struct ed *ed_next; /* on schedule or rm_list */ 49 struct ed *ed_prev; /* for non-interrupt EDs */ 50 struct list_head td_list; /* "shadow list" of our TDs */ 51 struct list_head in_use_list; 52 53 /* create --> IDLE --> OPER --> ... --> IDLE --> destroy 54 * usually: OPER --> UNLINK --> (IDLE | OPER) --> ... 55 */ 56 u8 state; /* ED_{IDLE,UNLINK,OPER} */ 57 #define ED_IDLE 0x00 /* NOT linked to HC */ 58 #define ED_UNLINK 0x01 /* being unlinked from hc */ 59 #define ED_OPER 0x02 /* IS linked to hc */ 60 61 u8 type; /* PIPE_{BULK,...} */ 62 63 /* periodic scheduling params (for intr and iso) */ 64 u8 branch; 65 u16 interval; 66 u16 load; 67 u16 last_iso; /* iso only */ 68 69 /* HC may see EDs on rm_list until next frame (frame_no == tick) */ 70 u16 tick; 71 72 /* Detect TDs not added to the done queue */ 73 unsigned takeback_wdh_cnt; 74 struct td *pending_td; 75 #define OKAY_TO_TAKEBACK(ohci, ed) \ 76 ((int) (ohci->wdh_cnt - ed->takeback_wdh_cnt) >= 0) 77 78 } __attribute__ ((aligned(16))); 79 80 #define ED_MASK ((u32)~0x0f) /* strip hw status in low addr bits */ 81 82 83 /* 84 * OHCI Transfer Descriptor (TD) ... one per transfer segment 85 * See OHCI spec, sections 4.3.1 (general = control/bulk/interrupt) 86 * and 4.3.2 (iso) 87 */ 88 struct td { 89 /* first fields are hardware-specified */ 90 __hc32 hwINFO; /* transfer info bitmask */ 91 92 /* hwINFO bits for both general and iso tds: */ 93 #define TD_CC 0xf0000000 /* condition code */ 94 #define TD_CC_GET(td_p) ((td_p >>28) & 0x0f) 95 //#define TD_CC_SET(td_p, cc) (td_p) = ((td_p) & 0x0fffffff) | (((cc) & 0x0f) << 28) 96 #define TD_DI 0x00E00000 /* frames before interrupt */ 97 #define TD_DI_SET(X) (((X) & 0x07)<< 21) 98 /* these two bits are available for definition/use by HCDs in both 99 * general and iso tds ... others are available for only one type 100 */ 101 #define TD_DONE 0x00020000 /* retired to donelist */ 102 #define TD_ISO 0x00010000 /* copy of ED_ISO */ 103 104 /* hwINFO bits for general tds: */ 105 #define TD_EC 0x0C000000 /* error count */ 106 #define TD_T 0x03000000 /* data toggle state */ 107 #define TD_T_DATA0 0x02000000 /* DATA0 */ 108 #define TD_T_DATA1 0x03000000 /* DATA1 */ 109 #define TD_T_TOGGLE 0x00000000 /* uses ED_C */ 110 #define TD_DP 0x00180000 /* direction/pid */ 111 #define TD_DP_SETUP 0x00000000 /* SETUP pid */ 112 #define TD_DP_IN 0x00100000 /* IN pid */ 113 #define TD_DP_OUT 0x00080000 /* OUT pid */ 114 /* 0x00180000 rsvd */ 115 #define TD_R 0x00040000 /* round: short packets OK? */ 116 117 /* (no hwINFO #defines yet for iso tds) */ 118 119 __hc32 hwCBP; /* Current Buffer Pointer (or 0) */ 120 __hc32 hwNextTD; /* Next TD Pointer */ 121 __hc32 hwBE; /* Memory Buffer End Pointer */ 122 123 /* PSW is only for ISO. Only 1 PSW entry is used, but on 124 * big-endian PPC hardware that's the second entry. 125 */ 126 #define MAXPSW 2 127 __hc16 hwPSW [MAXPSW]; 128 129 /* rest are purely for the driver's use */ 130 __u8 index; 131 struct ed *ed; 132 struct td *td_hash; /* dma-->td hashtable */ 133 struct td *next_dl_td; 134 struct urb *urb; 135 136 dma_addr_t td_dma; /* addr of this TD */ 137 dma_addr_t data_dma; /* addr of data it points to */ 138 139 struct list_head td_list; /* "shadow list", TDs on same ED */ 140 } __attribute__ ((aligned(32))); /* c/b/i need 16; only iso needs 32 */ 141 142 #define TD_MASK ((u32)~0x1f) /* strip hw status in low addr bits */ 143 144 /* 145 * Hardware transfer status codes -- CC from td->hwINFO or td->hwPSW 146 */ 147 #define TD_CC_NOERROR 0x00 148 #define TD_CC_CRC 0x01 149 #define TD_CC_BITSTUFFING 0x02 150 #define TD_CC_DATATOGGLEM 0x03 151 #define TD_CC_STALL 0x04 152 #define TD_DEVNOTRESP 0x05 153 #define TD_PIDCHECKFAIL 0x06 154 #define TD_UNEXPECTEDPID 0x07 155 #define TD_DATAOVERRUN 0x08 156 #define TD_DATAUNDERRUN 0x09 157 /* 0x0A, 0x0B reserved for hardware */ 158 #define TD_BUFFEROVERRUN 0x0C 159 #define TD_BUFFERUNDERRUN 0x0D 160 /* 0x0E, 0x0F reserved for HCD */ 161 #define TD_NOTACCESSED 0x0F 162 163 164 /* map OHCI TD status codes (CC) to errno values */ 165 static const int __maybe_unused cc_to_error [16] = { 166 /* No Error */ 0, 167 /* CRC Error */ -EILSEQ, 168 /* Bit Stuff */ -EPROTO, 169 /* Data Togg */ -EILSEQ, 170 /* Stall */ -EPIPE, 171 /* DevNotResp */ -ETIME, 172 /* PIDCheck */ -EPROTO, 173 /* UnExpPID */ -EPROTO, 174 /* DataOver */ -EOVERFLOW, 175 /* DataUnder */ -EREMOTEIO, 176 /* (for hw) */ -EIO, 177 /* (for hw) */ -EIO, 178 /* BufferOver */ -ECOMM, 179 /* BuffUnder */ -ENOSR, 180 /* (for HCD) */ -EALREADY, 181 /* (for HCD) */ -EALREADY 182 }; 183 184 185 /* 186 * The HCCA (Host Controller Communications Area) is a 256 byte 187 * structure defined section 4.4.1 of the OHCI spec. The HC is 188 * told the base address of it. It must be 256-byte aligned. 189 */ 190 struct ohci_hcca { 191 #define NUM_INTS 32 192 __hc32 int_table [NUM_INTS]; /* periodic schedule */ 193 194 /* 195 * OHCI defines u16 frame_no, followed by u16 zero pad. 196 * Since some processors can't do 16 bit bus accesses, 197 * portable access must be a 32 bits wide. 198 */ 199 __hc32 frame_no; /* current frame number */ 200 __hc32 done_head; /* info returned for an interrupt */ 201 u8 reserved_for_hc [116]; 202 u8 what [4]; /* spec only identifies 252 bytes :) */ 203 } __attribute__ ((aligned(256))); 204 205 /* 206 * This is the structure of the OHCI controller's memory mapped I/O region. 207 * You must use readl() and writel() (in <asm/io.h>) to access these fields!! 208 * Layout is in section 7 (and appendix B) of the spec. 209 */ 210 struct ohci_regs { 211 /* control and status registers (section 7.1) */ 212 __hc32 revision; 213 __hc32 control; 214 __hc32 cmdstatus; 215 __hc32 intrstatus; 216 __hc32 intrenable; 217 __hc32 intrdisable; 218 219 /* memory pointers (section 7.2) */ 220 __hc32 hcca; 221 __hc32 ed_periodcurrent; 222 __hc32 ed_controlhead; 223 __hc32 ed_controlcurrent; 224 __hc32 ed_bulkhead; 225 __hc32 ed_bulkcurrent; 226 __hc32 donehead; 227 228 /* frame counters (section 7.3) */ 229 __hc32 fminterval; 230 __hc32 fmremaining; 231 __hc32 fmnumber; 232 __hc32 periodicstart; 233 __hc32 lsthresh; 234 235 /* Root hub ports (section 7.4) */ 236 struct ohci_roothub_regs { 237 __hc32 a; 238 __hc32 b; 239 __hc32 status; 240 #define MAX_ROOT_PORTS 15 /* maximum OHCI root hub ports (RH_A_NDP) */ 241 __hc32 portstatus [MAX_ROOT_PORTS]; 242 } roothub; 243 244 /* and optional "legacy support" registers (appendix B) at 0x0100 */ 245 246 } __attribute__ ((aligned(32))); 247 248 249 /* OHCI CONTROL AND STATUS REGISTER MASKS */ 250 251 /* 252 * HcControl (control) register masks 253 */ 254 #define OHCI_CTRL_CBSR (3 << 0) /* control/bulk service ratio */ 255 #define OHCI_CTRL_PLE (1 << 2) /* periodic list enable */ 256 #define OHCI_CTRL_IE (1 << 3) /* isochronous enable */ 257 #define OHCI_CTRL_CLE (1 << 4) /* control list enable */ 258 #define OHCI_CTRL_BLE (1 << 5) /* bulk list enable */ 259 #define OHCI_CTRL_HCFS (3 << 6) /* host controller functional state */ 260 #define OHCI_CTRL_IR (1 << 8) /* interrupt routing */ 261 #define OHCI_CTRL_RWC (1 << 9) /* remote wakeup connected */ 262 #define OHCI_CTRL_RWE (1 << 10) /* remote wakeup enable */ 263 264 /* pre-shifted values for HCFS */ 265 # define OHCI_USB_RESET (0 << 6) 266 # define OHCI_USB_RESUME (1 << 6) 267 # define OHCI_USB_OPER (2 << 6) 268 # define OHCI_USB_SUSPEND (3 << 6) 269 270 /* 271 * HcCommandStatus (cmdstatus) register masks 272 */ 273 #define OHCI_HCR (1 << 0) /* host controller reset */ 274 #define OHCI_CLF (1 << 1) /* control list filled */ 275 #define OHCI_BLF (1 << 2) /* bulk list filled */ 276 #define OHCI_OCR (1 << 3) /* ownership change request */ 277 #define OHCI_SOC (3 << 16) /* scheduling overrun count */ 278 279 /* 280 * masks used with interrupt registers: 281 * HcInterruptStatus (intrstatus) 282 * HcInterruptEnable (intrenable) 283 * HcInterruptDisable (intrdisable) 284 */ 285 #define OHCI_INTR_SO (1 << 0) /* scheduling overrun */ 286 #define OHCI_INTR_WDH (1 << 1) /* writeback of done_head */ 287 #define OHCI_INTR_SF (1 << 2) /* start frame */ 288 #define OHCI_INTR_RD (1 << 3) /* resume detect */ 289 #define OHCI_INTR_UE (1 << 4) /* unrecoverable error */ 290 #define OHCI_INTR_FNO (1 << 5) /* frame number overflow */ 291 #define OHCI_INTR_RHSC (1 << 6) /* root hub status change */ 292 #define OHCI_INTR_OC (1 << 30) /* ownership change */ 293 #define OHCI_INTR_MIE (1 << 31) /* master interrupt enable */ 294 295 296 /* OHCI ROOT HUB REGISTER MASKS */ 297 298 /* roothub.portstatus [i] bits */ 299 #define RH_PS_CCS 0x00000001 /* current connect status */ 300 #define RH_PS_PES 0x00000002 /* port enable status*/ 301 #define RH_PS_PSS 0x00000004 /* port suspend status */ 302 #define RH_PS_POCI 0x00000008 /* port over current indicator */ 303 #define RH_PS_PRS 0x00000010 /* port reset status */ 304 #define RH_PS_PPS 0x00000100 /* port power status */ 305 #define RH_PS_LSDA 0x00000200 /* low speed device attached */ 306 #define RH_PS_CSC 0x00010000 /* connect status change */ 307 #define RH_PS_PESC 0x00020000 /* port enable status change */ 308 #define RH_PS_PSSC 0x00040000 /* port suspend status change */ 309 #define RH_PS_OCIC 0x00080000 /* over current indicator change */ 310 #define RH_PS_PRSC 0x00100000 /* port reset status change */ 311 312 /* roothub.status bits */ 313 #define RH_HS_LPS 0x00000001 /* local power status */ 314 #define RH_HS_OCI 0x00000002 /* over current indicator */ 315 #define RH_HS_DRWE 0x00008000 /* device remote wakeup enable */ 316 #define RH_HS_LPSC 0x00010000 /* local power status change */ 317 #define RH_HS_OCIC 0x00020000 /* over current indicator change */ 318 #define RH_HS_CRWE 0x80000000 /* clear remote wakeup enable */ 319 320 /* roothub.b masks */ 321 #define RH_B_DR 0x0000ffff /* device removable flags */ 322 #define RH_B_PPCM 0xffff0000 /* port power control mask */ 323 324 /* roothub.a masks */ 325 #define RH_A_NDP (0xff << 0) /* number of downstream ports */ 326 #define RH_A_PSM (1 << 8) /* power switching mode */ 327 #define RH_A_NPS (1 << 9) /* no power switching */ 328 #define RH_A_DT (1 << 10) /* device type (mbz) */ 329 #define RH_A_OCPM (1 << 11) /* over current protection mode */ 330 #define RH_A_NOCP (1 << 12) /* no over current protection */ 331 #define RH_A_POTPGT (0xff << 24) /* power on to power good time */ 332 333 334 /* hcd-private per-urb state */ 335 typedef struct urb_priv { 336 struct ed *ed; 337 u16 length; // # tds in this request 338 u16 td_cnt; // tds already serviced 339 struct list_head pending; 340 struct td *td[] __counted_by(length); // all TDs in this request 341 342 } urb_priv_t; 343 344 #define TD_HASH_SIZE 64 /* power'o'two */ 345 // sizeof (struct td) ~= 64 == 2^6 ... 346 #define TD_HASH_FUNC(td_dma) ((td_dma ^ (td_dma >> 6)) % TD_HASH_SIZE) 347 348 349 /* 350 * This is the full ohci controller description 351 * 352 * Note how the "proper" USB information is just 353 * a subset of what the full implementation needs. (Linus) 354 */ 355 356 enum ohci_rh_state { 357 OHCI_RH_HALTED, 358 OHCI_RH_SUSPENDED, 359 OHCI_RH_RUNNING 360 }; 361 362 struct ohci_hcd { 363 spinlock_t lock; 364 365 /* 366 * I/O memory used to communicate with the HC (dma-consistent) 367 */ 368 struct ohci_regs __iomem *regs; 369 370 /* 371 * main memory used to communicate with the HC (dma-consistent). 372 * hcd adds to schedule for a live hc any time, but removals finish 373 * only at the start of the next frame. 374 */ 375 struct ohci_hcca *hcca; 376 dma_addr_t hcca_dma; 377 378 struct ed *ed_rm_list; /* to be removed */ 379 380 struct ed *ed_bulktail; /* last in bulk list */ 381 struct ed *ed_controltail; /* last in ctrl list */ 382 struct ed *periodic [NUM_INTS]; /* shadow int_table */ 383 384 void (*start_hnp)(struct ohci_hcd *ohci); 385 386 /* 387 * memory management for queue data structures 388 * 389 * @td_cache and @ed_cache are %NULL if &usb_hcd.localmem_pool is used. 390 */ 391 struct dma_pool *td_cache; 392 struct dma_pool *ed_cache; 393 struct td *td_hash [TD_HASH_SIZE]; 394 struct td *dl_start, *dl_end; /* the done list */ 395 struct list_head pending; 396 struct list_head eds_in_use; /* all EDs with at least 1 TD */ 397 398 /* 399 * driver state 400 */ 401 enum ohci_rh_state rh_state; 402 int num_ports; 403 int load [NUM_INTS]; 404 u32 hc_control; /* copy of hc control reg */ 405 unsigned long next_statechange; /* suspend/resume */ 406 u32 fminterval; /* saved register */ 407 unsigned autostop:1; /* rh auto stopping/stopped */ 408 unsigned working:1; 409 unsigned restart_work:1; 410 411 unsigned long flags; /* for HC bugs */ 412 #define OHCI_QUIRK_AMD756 0x01 /* erratum #4 */ 413 #define OHCI_QUIRK_SUPERIO 0x02 /* natsemi */ 414 #define OHCI_QUIRK_INITRESET 0x04 /* SiS, OPTi, ... */ 415 #define OHCI_QUIRK_BE_DESC 0x08 /* BE descriptors */ 416 #define OHCI_QUIRK_BE_MMIO 0x10 /* BE registers */ 417 #define OHCI_QUIRK_ZFMICRO 0x20 /* Compaq ZFMicro chipset*/ 418 #define OHCI_QUIRK_NEC 0x40 /* lost interrupts */ 419 #define OHCI_QUIRK_FRAME_NO 0x80 /* no big endian frame_no shift */ 420 #define OHCI_QUIRK_HUB_POWER 0x100 /* distrust firmware power/oc setup */ 421 #define OHCI_QUIRK_AMD_PLL 0x200 /* AMD PLL quirk*/ 422 #define OHCI_QUIRK_AMD_PREFETCH 0x400 /* pre-fetch for ISO transfer */ 423 #define OHCI_QUIRK_GLOBAL_SUSPEND 0x800 /* must suspend ports */ 424 #define OHCI_QUIRK_QEMU 0x1000 /* relax timing expectations */ 425 426 // there are also chip quirks/bugs in init logic 427 428 unsigned prev_frame_no; 429 unsigned wdh_cnt, prev_wdh_cnt; 430 u32 prev_donehead; 431 struct timer_list io_watchdog; 432 433 struct work_struct nec_work; /* Worker for NEC quirk */ 434 435 struct dentry *debug_dir; 436 437 /* platform-specific data -- must come last */ 438 unsigned long priv[] __aligned(sizeof(s64)); 439 440 }; 441 442 #ifdef CONFIG_USB_PCI 443 static inline int quirk_nec(struct ohci_hcd *ohci) 444 { 445 return ohci->flags & OHCI_QUIRK_NEC; 446 } 447 static inline int quirk_zfmicro(struct ohci_hcd *ohci) 448 { 449 return ohci->flags & OHCI_QUIRK_ZFMICRO; 450 } 451 static inline int quirk_amdiso(struct ohci_hcd *ohci) 452 { 453 return ohci->flags & OHCI_QUIRK_AMD_PLL; 454 } 455 static inline int quirk_amdprefetch(struct ohci_hcd *ohci) 456 { 457 return ohci->flags & OHCI_QUIRK_AMD_PREFETCH; 458 } 459 #else 460 static inline int quirk_nec(struct ohci_hcd *ohci) 461 { 462 return 0; 463 } 464 static inline int quirk_zfmicro(struct ohci_hcd *ohci) 465 { 466 return 0; 467 } 468 static inline int quirk_amdiso(struct ohci_hcd *ohci) 469 { 470 return 0; 471 } 472 static inline int quirk_amdprefetch(struct ohci_hcd *ohci) 473 { 474 return 0; 475 } 476 #endif 477 478 /* convert between an hcd pointer and the corresponding ohci_hcd */ 479 static inline struct ohci_hcd *hcd_to_ohci (struct usb_hcd *hcd) 480 { 481 return (struct ohci_hcd *) (hcd->hcd_priv); 482 } 483 static inline struct usb_hcd *ohci_to_hcd (const struct ohci_hcd *ohci) 484 { 485 return container_of ((void *) ohci, struct usb_hcd, hcd_priv); 486 } 487 488 /*-------------------------------------------------------------------------*/ 489 490 #define ohci_dbg(ohci, fmt, args...) \ 491 dev_dbg (ohci_to_hcd(ohci)->self.controller , fmt , ## args ) 492 #define ohci_err(ohci, fmt, args...) \ 493 dev_err (ohci_to_hcd(ohci)->self.controller , fmt , ## args ) 494 #define ohci_info(ohci, fmt, args...) \ 495 dev_info (ohci_to_hcd(ohci)->self.controller , fmt , ## args ) 496 #define ohci_warn(ohci, fmt, args...) \ 497 dev_warn (ohci_to_hcd(ohci)->self.controller , fmt , ## args ) 498 499 /*-------------------------------------------------------------------------*/ 500 501 /* 502 * While most USB host controllers implement their registers and 503 * in-memory communication descriptors in little-endian format, 504 * a minority (notably the IBM STB04XXX and the Motorola MPC5200 505 * processors) implement them in big endian format. 506 * 507 * In addition some more exotic implementations like the Toshiba 508 * Spider (aka SCC) cell southbridge are "mixed" endian, that is, 509 * they have a different endianness for registers vs. in-memory 510 * descriptors. 511 * 512 * This attempts to support either format at compile time without a 513 * runtime penalty, or both formats with the additional overhead 514 * of checking a flag bit. 515 * 516 * That leads to some tricky Kconfig rules howevber. There are 517 * different defaults based on some arch/ppc platforms, though 518 * the basic rules are: 519 * 520 * Controller type Kconfig options needed 521 * --------------- ---------------------- 522 * little endian CONFIG_USB_OHCI_LITTLE_ENDIAN 523 * 524 * fully big endian CONFIG_USB_OHCI_BIG_ENDIAN_DESC _and_ 525 * CONFIG_USB_OHCI_BIG_ENDIAN_MMIO 526 * 527 * mixed endian CONFIG_USB_OHCI_LITTLE_ENDIAN _and_ 528 * CONFIG_USB_OHCI_BIG_ENDIAN_{MMIO,DESC} 529 * 530 * (If you have a mixed endian controller, you -must- also define 531 * CONFIG_USB_OHCI_LITTLE_ENDIAN or things will not work when building 532 * both your mixed endian and a fully big endian controller support in 533 * the same kernel image). 534 */ 535 536 #ifdef CONFIG_USB_OHCI_BIG_ENDIAN_DESC 537 #ifdef CONFIG_USB_OHCI_LITTLE_ENDIAN 538 #define big_endian_desc(ohci) (ohci->flags & OHCI_QUIRK_BE_DESC) 539 #else 540 #define big_endian_desc(ohci) 1 /* only big endian */ 541 #endif 542 #else 543 #define big_endian_desc(ohci) 0 /* only little endian */ 544 #endif 545 546 #ifdef CONFIG_USB_OHCI_BIG_ENDIAN_MMIO 547 #ifdef CONFIG_USB_OHCI_LITTLE_ENDIAN 548 #define big_endian_mmio(ohci) (ohci->flags & OHCI_QUIRK_BE_MMIO) 549 #else 550 #define big_endian_mmio(ohci) 1 /* only big endian */ 551 #endif 552 #else 553 #define big_endian_mmio(ohci) 0 /* only little endian */ 554 #endif 555 556 /* 557 * Big-endian read/write functions are arch-specific. 558 * Other arches can be added if/when they're needed. 559 * 560 */ 561 static inline unsigned int _ohci_readl (const struct ohci_hcd *ohci, 562 __hc32 __iomem * regs) 563 { 564 #ifdef CONFIG_USB_OHCI_BIG_ENDIAN_MMIO 565 return big_endian_mmio(ohci) ? 566 readl_be (regs) : 567 readl (regs); 568 #else 569 return readl (regs); 570 #endif 571 } 572 573 static inline void _ohci_writel (const struct ohci_hcd *ohci, 574 const unsigned int val, __hc32 __iomem *regs) 575 { 576 #ifdef CONFIG_USB_OHCI_BIG_ENDIAN_MMIO 577 big_endian_mmio(ohci) ? 578 writel_be (val, regs) : 579 writel (val, regs); 580 #else 581 writel (val, regs); 582 #endif 583 } 584 585 #define ohci_readl(o,r) _ohci_readl(o,r) 586 #define ohci_writel(o,v,r) _ohci_writel(o,v,r) 587 588 589 /*-------------------------------------------------------------------------*/ 590 591 /* cpu to ohci */ 592 static inline __hc16 cpu_to_hc16 (const struct ohci_hcd *ohci, const u16 x) 593 { 594 return big_endian_desc(ohci) ? 595 (__force __hc16)cpu_to_be16(x) : 596 (__force __hc16)cpu_to_le16(x); 597 } 598 599 static inline __hc16 cpu_to_hc16p (const struct ohci_hcd *ohci, const u16 *x) 600 { 601 return big_endian_desc(ohci) ? 602 cpu_to_be16p(x) : 603 cpu_to_le16p(x); 604 } 605 606 static inline __hc32 cpu_to_hc32 (const struct ohci_hcd *ohci, const u32 x) 607 { 608 return big_endian_desc(ohci) ? 609 (__force __hc32)cpu_to_be32(x) : 610 (__force __hc32)cpu_to_le32(x); 611 } 612 613 static inline __hc32 cpu_to_hc32p (const struct ohci_hcd *ohci, const u32 *x) 614 { 615 return big_endian_desc(ohci) ? 616 cpu_to_be32p(x) : 617 cpu_to_le32p(x); 618 } 619 620 /* ohci to cpu */ 621 static inline u16 hc16_to_cpu (const struct ohci_hcd *ohci, const __hc16 x) 622 { 623 return big_endian_desc(ohci) ? 624 be16_to_cpu((__force __be16)x) : 625 le16_to_cpu((__force __le16)x); 626 } 627 628 static inline u16 hc16_to_cpup (const struct ohci_hcd *ohci, const __hc16 *x) 629 { 630 return big_endian_desc(ohci) ? 631 be16_to_cpup((__force __be16 *)x) : 632 le16_to_cpup((__force __le16 *)x); 633 } 634 635 static inline u32 hc32_to_cpu (const struct ohci_hcd *ohci, const __hc32 x) 636 { 637 return big_endian_desc(ohci) ? 638 be32_to_cpu((__force __be32)x) : 639 le32_to_cpu((__force __le32)x); 640 } 641 642 static inline u32 hc32_to_cpup (const struct ohci_hcd *ohci, const __hc32 *x) 643 { 644 return big_endian_desc(ohci) ? 645 be32_to_cpup((__force __be32 *)x) : 646 le32_to_cpup((__force __le32 *)x); 647 } 648 649 /*-------------------------------------------------------------------------*/ 650 651 /* 652 * The HCCA frame number is 16 bits, but is accessed as 32 bits since not all 653 * hardware handles 16 bit reads. Depending on the SoC implementation, the 654 * frame number can wind up in either bits [31:16] (default) or 655 * [15:0] (OHCI_QUIRK_FRAME_NO) on big endian hosts. 656 * 657 * Somewhat similarly, the 16-bit PSW fields in a transfer descriptor are 658 * reordered on BE. 659 */ 660 661 static inline u16 ohci_frame_no(const struct ohci_hcd *ohci) 662 { 663 u32 tmp; 664 if (big_endian_desc(ohci)) { 665 tmp = be32_to_cpup((__force __be32 *)&ohci->hcca->frame_no); 666 if (!(ohci->flags & OHCI_QUIRK_FRAME_NO)) 667 tmp >>= 16; 668 } else 669 tmp = le32_to_cpup((__force __le32 *)&ohci->hcca->frame_no); 670 671 return (u16)tmp; 672 } 673 674 static inline __hc16 *ohci_hwPSWp(const struct ohci_hcd *ohci, 675 const struct td *td, int index) 676 { 677 return (__hc16 *)(big_endian_desc(ohci) ? 678 &td->hwPSW[index ^ 1] : &td->hwPSW[index]); 679 } 680 681 static inline u16 ohci_hwPSW(const struct ohci_hcd *ohci, 682 const struct td *td, int index) 683 { 684 return hc16_to_cpup(ohci, ohci_hwPSWp(ohci, td, index)); 685 } 686 687 /*-------------------------------------------------------------------------*/ 688 689 #define FI 0x2edf /* 12000 bits per frame (-1) */ 690 #define FSMP(fi) (0x7fff & ((6 * ((fi) - 210)) / 7)) 691 #define FIT (1 << 31) 692 #define LSTHRESH 0x628 /* lowspeed bit threshold */ 693 694 static inline void periodic_reinit (struct ohci_hcd *ohci) 695 { 696 u32 fi = ohci->fminterval & 0x03fff; 697 u32 fit = ohci_readl(ohci, &ohci->regs->fminterval) & FIT; 698 699 ohci_writel (ohci, (fit ^ FIT) | ohci->fminterval, 700 &ohci->regs->fminterval); 701 ohci_writel (ohci, ((9 * fi) / 10) & 0x3fff, 702 &ohci->regs->periodicstart); 703 } 704 705 /* AMD-756 (D2 rev) reports corrupt register contents in some cases. 706 * The erratum (#4) description is incorrect. AMD's workaround waits 707 * till some bits (mostly reserved) are clear; ok for all revs. 708 */ 709 #define read_roothub(hc, register, mask) ({ \ 710 u32 temp = ohci_readl (hc, &hc->regs->roothub.register); \ 711 if (temp == -1) \ 712 hc->rh_state = OHCI_RH_HALTED; \ 713 else if (hc->flags & OHCI_QUIRK_AMD756) \ 714 while (temp & mask) \ 715 temp = ohci_readl (hc, &hc->regs->roothub.register); \ 716 temp; }) 717 718 static inline u32 roothub_a (struct ohci_hcd *hc) 719 { return read_roothub (hc, a, 0xfc0fe000); } 720 static inline u32 roothub_b (struct ohci_hcd *hc) 721 { return ohci_readl (hc, &hc->regs->roothub.b); } 722 static inline u32 roothub_status (struct ohci_hcd *hc) 723 { return ohci_readl (hc, &hc->regs->roothub.status); } 724 static inline u32 roothub_portstatus (struct ohci_hcd *hc, int i) 725 { return read_roothub (hc, portstatus [i], 0xffe0fce0); } 726 727 /* Declarations of things exported for use by ohci platform drivers */ 728 729 struct ohci_driver_overrides { 730 const char *product_desc; 731 size_t extra_priv_size; 732 int (*reset)(struct usb_hcd *hcd); 733 }; 734 735 extern void ohci_init_driver(struct hc_driver *drv, 736 const struct ohci_driver_overrides *over); 737 extern int ohci_restart(struct ohci_hcd *ohci); 738 extern int ohci_setup(struct usb_hcd *hcd); 739 extern int ohci_suspend(struct usb_hcd *hcd, bool do_wakeup); 740 extern int ohci_resume(struct usb_hcd *hcd, bool hibernated); 741 extern int ohci_hub_control(struct usb_hcd *hcd, u16 typeReq, u16 wValue, 742 u16 wIndex, char *buf, u16 wLength); 743 extern int ohci_hub_status_data(struct usb_hcd *hcd, char *buf); 744