uhci-hub.c 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414
  1. /*
  2. * Universal Host Controller Interface driver for USB.
  3. *
  4. * Maintainer: Alan Stern <stern@rowland.harvard.edu>
  5. *
  6. * (C) Copyright 1999 Linus Torvalds
  7. * (C) Copyright 1999-2002 Johannes Erdfelt, johannes@erdfelt.com
  8. * (C) Copyright 1999 Randy Dunlap
  9. * (C) Copyright 1999 Georg Acher, acher@in.tum.de
  10. * (C) Copyright 1999 Deti Fliegl, deti@fliegl.de
  11. * (C) Copyright 1999 Thomas Sailer, sailer@ife.ee.ethz.ch
  12. * (C) Copyright 2004 Alan Stern, stern@rowland.harvard.edu
  13. */
  14. static const __u8 root_hub_hub_des[] =
  15. {
  16. 0x09, /* __u8 bLength; */
  17. 0x29, /* __u8 bDescriptorType; Hub-descriptor */
  18. 0x02, /* __u8 bNbrPorts; */
  19. 0x0a, /* __u16 wHubCharacteristics; */
  20. 0x00, /* (per-port OC, no power switching) */
  21. 0x01, /* __u8 bPwrOn2pwrGood; 2ms */
  22. 0x00, /* __u8 bHubContrCurrent; 0 mA */
  23. 0x00, /* __u8 DeviceRemovable; *** 7 Ports max *** */
  24. 0xff /* __u8 PortPwrCtrlMask; *** 7 ports max *** */
  25. };
  26. #define UHCI_RH_MAXCHILD 7
  27. /* must write as zeroes */
  28. #define WZ_BITS (USBPORTSC_RES2 | USBPORTSC_RES3 | USBPORTSC_RES4)
  29. /* status change bits: nonzero writes will clear */
  30. #define RWC_BITS (USBPORTSC_OCC | USBPORTSC_PEC | USBPORTSC_CSC)
  31. /* suspend/resume bits: port suspended or port resuming */
  32. #define SUSPEND_BITS (USBPORTSC_SUSP | USBPORTSC_RD)
  33. /* A port that either is connected or has a changed-bit set will prevent
  34. * us from AUTO_STOPPING.
  35. */
  36. static int any_ports_active(struct uhci_hcd *uhci)
  37. {
  38. int port;
  39. for (port = 0; port < uhci->rh_numports; ++port) {
  40. if ((uhci_readw(uhci, USBPORTSC1 + port * 2) &
  41. (USBPORTSC_CCS | RWC_BITS)) ||
  42. test_bit(port, &uhci->port_c_suspend))
  43. return 1;
  44. }
  45. return 0;
  46. }
  47. static inline int get_hub_status_data(struct uhci_hcd *uhci, char *buf)
  48. {
  49. int port;
  50. int mask = RWC_BITS;
  51. /* Some boards (both VIA and Intel apparently) report bogus
  52. * overcurrent indications, causing massive log spam unless
  53. * we completely ignore them. This doesn't seem to be a problem
  54. * with the chipset so much as with the way it is connected on
  55. * the motherboard; if the overcurrent input is left to float
  56. * then it may constantly register false positives. */
  57. if (ignore_oc)
  58. mask &= ~USBPORTSC_OCC;
  59. *buf = 0;
  60. for (port = 0; port < uhci->rh_numports; ++port) {
  61. if ((uhci_readw(uhci, USBPORTSC1 + port * 2) & mask) ||
  62. test_bit(port, &uhci->port_c_suspend))
  63. *buf |= (1 << (port + 1));
  64. }
  65. return !!*buf;
  66. }
  67. #define OK(x) len = (x); break
  68. #define CLR_RH_PORTSTAT(x) \
  69. status = uhci_readw(uhci, port_addr); \
  70. status &= ~(RWC_BITS|WZ_BITS); \
  71. status &= ~(x); \
  72. status |= RWC_BITS & (x); \
  73. uhci_writew(uhci, status, port_addr)
  74. #define SET_RH_PORTSTAT(x) \
  75. status = uhci_readw(uhci, port_addr); \
  76. status |= (x); \
  77. status &= ~(RWC_BITS|WZ_BITS); \
  78. uhci_writew(uhci, status, port_addr)
  79. /* UHCI controllers don't automatically stop resume signalling after 20 msec,
  80. * so we have to poll and check timeouts in order to take care of it.
  81. */
  82. static void uhci_finish_suspend(struct uhci_hcd *uhci, int port,
  83. unsigned long port_addr)
  84. {
  85. int status;
  86. int i;
  87. if (uhci_readw(uhci, port_addr) & SUSPEND_BITS) {
  88. CLR_RH_PORTSTAT(SUSPEND_BITS);
  89. if (test_bit(port, &uhci->resuming_ports))
  90. set_bit(port, &uhci->port_c_suspend);
  91. /* The controller won't actually turn off the RD bit until
  92. * it has had a chance to send a low-speed EOP sequence,
  93. * which is supposed to take 3 bit times (= 2 microseconds).
  94. * Experiments show that some controllers take longer, so
  95. * we'll poll for completion. */
  96. for (i = 0; i < 10; ++i) {
  97. if (!(uhci_readw(uhci, port_addr) & SUSPEND_BITS))
  98. break;
  99. udelay(1);
  100. }
  101. }
  102. clear_bit(port, &uhci->resuming_ports);
  103. }
  104. /* Wait for the UHCI controller in HP's iLO2 server management chip.
  105. * It can take up to 250 us to finish a reset and set the CSC bit.
  106. */
  107. static void wait_for_HP(struct uhci_hcd *uhci, unsigned long port_addr)
  108. {
  109. int i;
  110. for (i = 10; i < 250; i += 10) {
  111. if (uhci_readw(uhci, port_addr) & USBPORTSC_CSC)
  112. return;
  113. udelay(10);
  114. }
  115. /* Log a warning? */
  116. }
  117. static void uhci_check_ports(struct uhci_hcd *uhci)
  118. {
  119. unsigned int port;
  120. unsigned long port_addr;
  121. int status;
  122. for (port = 0; port < uhci->rh_numports; ++port) {
  123. port_addr = USBPORTSC1 + 2 * port;
  124. status = uhci_readw(uhci, port_addr);
  125. if (unlikely(status & USBPORTSC_PR)) {
  126. if (time_after_eq(jiffies, uhci->ports_timeout)) {
  127. CLR_RH_PORTSTAT(USBPORTSC_PR);
  128. udelay(10);
  129. /* HP's server management chip requires
  130. * a longer delay. */
  131. if (uhci->wait_for_hp)
  132. wait_for_HP(uhci, port_addr);
  133. /* If the port was enabled before, turning
  134. * reset on caused a port enable change.
  135. * Turning reset off causes a port connect
  136. * status change. Clear these changes. */
  137. CLR_RH_PORTSTAT(USBPORTSC_CSC | USBPORTSC_PEC);
  138. SET_RH_PORTSTAT(USBPORTSC_PE);
  139. }
  140. }
  141. if (unlikely(status & USBPORTSC_RD)) {
  142. if (!test_bit(port, &uhci->resuming_ports)) {
  143. /* Port received a wakeup request */
  144. set_bit(port, &uhci->resuming_ports);
  145. uhci->ports_timeout = jiffies +
  146. msecs_to_jiffies(25);
  147. /* Make sure we see the port again
  148. * after the resuming period is over. */
  149. mod_timer(&uhci_to_hcd(uhci)->rh_timer,
  150. uhci->ports_timeout);
  151. } else if (time_after_eq(jiffies,
  152. uhci->ports_timeout)) {
  153. uhci_finish_suspend(uhci, port, port_addr);
  154. }
  155. }
  156. }
  157. }
  158. static int uhci_hub_status_data(struct usb_hcd *hcd, char *buf)
  159. {
  160. struct uhci_hcd *uhci = hcd_to_uhci(hcd);
  161. unsigned long flags;
  162. int status = 0;
  163. spin_lock_irqsave(&uhci->lock, flags);
  164. uhci_scan_schedule(uhci);
  165. if (!HCD_HW_ACCESSIBLE(hcd) || uhci->dead)
  166. goto done;
  167. uhci_check_ports(uhci);
  168. status = get_hub_status_data(uhci, buf);
  169. switch (uhci->rh_state) {
  170. case UHCI_RH_SUSPENDING:
  171. case UHCI_RH_SUSPENDED:
  172. /* if port change, ask to be resumed */
  173. if (status || uhci->resuming_ports)
  174. usb_hcd_resume_root_hub(hcd);
  175. break;
  176. case UHCI_RH_AUTO_STOPPED:
  177. /* if port change, auto start */
  178. if (status)
  179. wakeup_rh(uhci);
  180. break;
  181. case UHCI_RH_RUNNING:
  182. /* are any devices attached? */
  183. if (!any_ports_active(uhci)) {
  184. uhci->rh_state = UHCI_RH_RUNNING_NODEVS;
  185. uhci->auto_stop_time = jiffies + HZ;
  186. }
  187. break;
  188. case UHCI_RH_RUNNING_NODEVS:
  189. /* auto-stop if nothing connected for 1 second */
  190. if (any_ports_active(uhci))
  191. uhci->rh_state = UHCI_RH_RUNNING;
  192. else if (time_after_eq(jiffies, uhci->auto_stop_time))
  193. suspend_rh(uhci, UHCI_RH_AUTO_STOPPED);
  194. break;
  195. default:
  196. break;
  197. }
  198. done:
  199. spin_unlock_irqrestore(&uhci->lock, flags);
  200. return status;
  201. }
  202. /* size of returned buffer is part of USB spec */
  203. static int uhci_hub_control(struct usb_hcd *hcd, u16 typeReq, u16 wValue,
  204. u16 wIndex, char *buf, u16 wLength)
  205. {
  206. struct uhci_hcd *uhci = hcd_to_uhci(hcd);
  207. int status, lstatus, retval = 0, len = 0;
  208. unsigned int port = wIndex - 1;
  209. unsigned long port_addr = USBPORTSC1 + 2 * port;
  210. u16 wPortChange, wPortStatus;
  211. unsigned long flags;
  212. if (!HCD_HW_ACCESSIBLE(hcd) || uhci->dead)
  213. return -ETIMEDOUT;
  214. spin_lock_irqsave(&uhci->lock, flags);
  215. switch (typeReq) {
  216. case GetHubStatus:
  217. *(__le32 *)buf = cpu_to_le32(0);
  218. OK(4); /* hub power */
  219. case GetPortStatus:
  220. if (port >= uhci->rh_numports)
  221. goto err;
  222. uhci_check_ports(uhci);
  223. status = uhci_readw(uhci, port_addr);
  224. /* Intel controllers report the OverCurrent bit active on.
  225. * VIA controllers report it active off, so we'll adjust the
  226. * bit value. (It's not standardized in the UHCI spec.)
  227. */
  228. if (uhci->oc_low)
  229. status ^= USBPORTSC_OC;
  230. /* UHCI doesn't support C_RESET (always false) */
  231. wPortChange = lstatus = 0;
  232. if (status & USBPORTSC_CSC)
  233. wPortChange |= USB_PORT_STAT_C_CONNECTION;
  234. if (status & USBPORTSC_PEC)
  235. wPortChange |= USB_PORT_STAT_C_ENABLE;
  236. if ((status & USBPORTSC_OCC) && !ignore_oc)
  237. wPortChange |= USB_PORT_STAT_C_OVERCURRENT;
  238. if (test_bit(port, &uhci->port_c_suspend)) {
  239. wPortChange |= USB_PORT_STAT_C_SUSPEND;
  240. lstatus |= 1;
  241. }
  242. if (test_bit(port, &uhci->resuming_ports))
  243. lstatus |= 4;
  244. /* UHCI has no power switching (always on) */
  245. wPortStatus = USB_PORT_STAT_POWER;
  246. if (status & USBPORTSC_CCS)
  247. wPortStatus |= USB_PORT_STAT_CONNECTION;
  248. if (status & USBPORTSC_PE) {
  249. wPortStatus |= USB_PORT_STAT_ENABLE;
  250. if (status & SUSPEND_BITS)
  251. wPortStatus |= USB_PORT_STAT_SUSPEND;
  252. }
  253. if (status & USBPORTSC_OC)
  254. wPortStatus |= USB_PORT_STAT_OVERCURRENT;
  255. if (status & USBPORTSC_PR)
  256. wPortStatus |= USB_PORT_STAT_RESET;
  257. if (status & USBPORTSC_LSDA)
  258. wPortStatus |= USB_PORT_STAT_LOW_SPEED;
  259. if (wPortChange)
  260. dev_dbg(uhci_dev(uhci), "port %d portsc %04x,%02x\n",
  261. wIndex, status, lstatus);
  262. *(__le16 *)buf = cpu_to_le16(wPortStatus);
  263. *(__le16 *)(buf + 2) = cpu_to_le16(wPortChange);
  264. OK(4);
  265. case SetHubFeature: /* We don't implement these */
  266. case ClearHubFeature:
  267. switch (wValue) {
  268. case C_HUB_OVER_CURRENT:
  269. case C_HUB_LOCAL_POWER:
  270. OK(0);
  271. default:
  272. goto err;
  273. }
  274. break;
  275. case SetPortFeature:
  276. if (port >= uhci->rh_numports)
  277. goto err;
  278. switch (wValue) {
  279. case USB_PORT_FEAT_SUSPEND:
  280. SET_RH_PORTSTAT(USBPORTSC_SUSP);
  281. OK(0);
  282. case USB_PORT_FEAT_RESET:
  283. SET_RH_PORTSTAT(USBPORTSC_PR);
  284. /* Reset terminates Resume signalling */
  285. uhci_finish_suspend(uhci, port, port_addr);
  286. /* USB v2.0 7.1.7.5 */
  287. uhci->ports_timeout = jiffies + msecs_to_jiffies(50);
  288. OK(0);
  289. case USB_PORT_FEAT_POWER:
  290. /* UHCI has no power switching */
  291. OK(0);
  292. default:
  293. goto err;
  294. }
  295. break;
  296. case ClearPortFeature:
  297. if (port >= uhci->rh_numports)
  298. goto err;
  299. switch (wValue) {
  300. case USB_PORT_FEAT_ENABLE:
  301. CLR_RH_PORTSTAT(USBPORTSC_PE);
  302. /* Disable terminates Resume signalling */
  303. uhci_finish_suspend(uhci, port, port_addr);
  304. OK(0);
  305. case USB_PORT_FEAT_C_ENABLE:
  306. CLR_RH_PORTSTAT(USBPORTSC_PEC);
  307. OK(0);
  308. case USB_PORT_FEAT_SUSPEND:
  309. if (!(uhci_readw(uhci, port_addr) & USBPORTSC_SUSP)) {
  310. /* Make certain the port isn't suspended */
  311. uhci_finish_suspend(uhci, port, port_addr);
  312. } else if (!test_and_set_bit(port,
  313. &uhci->resuming_ports)) {
  314. SET_RH_PORTSTAT(USBPORTSC_RD);
  315. /* The controller won't allow RD to be set
  316. * if the port is disabled. When this happens
  317. * just skip the Resume signalling.
  318. */
  319. if (!(uhci_readw(uhci, port_addr) &
  320. USBPORTSC_RD))
  321. uhci_finish_suspend(uhci, port,
  322. port_addr);
  323. else
  324. /* USB v2.0 7.1.7.7 */
  325. uhci->ports_timeout = jiffies +
  326. msecs_to_jiffies(20);
  327. }
  328. OK(0);
  329. case USB_PORT_FEAT_C_SUSPEND:
  330. clear_bit(port, &uhci->port_c_suspend);
  331. OK(0);
  332. case USB_PORT_FEAT_POWER:
  333. /* UHCI has no power switching */
  334. goto err;
  335. case USB_PORT_FEAT_C_CONNECTION:
  336. CLR_RH_PORTSTAT(USBPORTSC_CSC);
  337. OK(0);
  338. case USB_PORT_FEAT_C_OVER_CURRENT:
  339. CLR_RH_PORTSTAT(USBPORTSC_OCC);
  340. OK(0);
  341. case USB_PORT_FEAT_C_RESET:
  342. /* this driver won't report these */
  343. OK(0);
  344. default:
  345. goto err;
  346. }
  347. break;
  348. case GetHubDescriptor:
  349. len = min_t(unsigned int, sizeof(root_hub_hub_des), wLength);
  350. memcpy(buf, root_hub_hub_des, len);
  351. if (len > 2)
  352. buf[2] = uhci->rh_numports;
  353. OK(len);
  354. default:
  355. err:
  356. retval = -EPIPE;
  357. }
  358. spin_unlock_irqrestore(&uhci->lock, flags);
  359. return retval;
  360. }