uhci-hub.c 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416
  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_SUSPENDED:
  171. /* if port change, ask to be resumed */
  172. if (status || uhci->resuming_ports) {
  173. status = 1;
  174. usb_hcd_resume_root_hub(hcd);
  175. }
  176. break;
  177. case UHCI_RH_AUTO_STOPPED:
  178. /* if port change, auto start */
  179. if (status)
  180. wakeup_rh(uhci);
  181. break;
  182. case UHCI_RH_RUNNING:
  183. /* are any devices attached? */
  184. if (!any_ports_active(uhci)) {
  185. uhci->rh_state = UHCI_RH_RUNNING_NODEVS;
  186. uhci->auto_stop_time = jiffies + HZ;
  187. }
  188. break;
  189. case UHCI_RH_RUNNING_NODEVS:
  190. /* auto-stop if nothing connected for 1 second */
  191. if (any_ports_active(uhci))
  192. uhci->rh_state = UHCI_RH_RUNNING;
  193. else if (time_after_eq(jiffies, uhci->auto_stop_time) &&
  194. !uhci->wait_for_hp)
  195. suspend_rh(uhci, UHCI_RH_AUTO_STOPPED);
  196. break;
  197. default:
  198. break;
  199. }
  200. done:
  201. spin_unlock_irqrestore(&uhci->lock, flags);
  202. return status;
  203. }
  204. /* size of returned buffer is part of USB spec */
  205. static int uhci_hub_control(struct usb_hcd *hcd, u16 typeReq, u16 wValue,
  206. u16 wIndex, char *buf, u16 wLength)
  207. {
  208. struct uhci_hcd *uhci = hcd_to_uhci(hcd);
  209. int status, lstatus, retval = 0, len = 0;
  210. unsigned int port = wIndex - 1;
  211. unsigned long port_addr = USBPORTSC1 + 2 * port;
  212. u16 wPortChange, wPortStatus;
  213. unsigned long flags;
  214. if (!HCD_HW_ACCESSIBLE(hcd) || uhci->dead)
  215. return -ETIMEDOUT;
  216. spin_lock_irqsave(&uhci->lock, flags);
  217. switch (typeReq) {
  218. case GetHubStatus:
  219. *(__le32 *)buf = cpu_to_le32(0);
  220. OK(4); /* hub power */
  221. case GetPortStatus:
  222. if (port >= uhci->rh_numports)
  223. goto err;
  224. uhci_check_ports(uhci);
  225. status = uhci_readw(uhci, port_addr);
  226. /* Intel controllers report the OverCurrent bit active on.
  227. * VIA controllers report it active off, so we'll adjust the
  228. * bit value. (It's not standardized in the UHCI spec.)
  229. */
  230. if (uhci->oc_low)
  231. status ^= USBPORTSC_OC;
  232. /* UHCI doesn't support C_RESET (always false) */
  233. wPortChange = lstatus = 0;
  234. if (status & USBPORTSC_CSC)
  235. wPortChange |= USB_PORT_STAT_C_CONNECTION;
  236. if (status & USBPORTSC_PEC)
  237. wPortChange |= USB_PORT_STAT_C_ENABLE;
  238. if ((status & USBPORTSC_OCC) && !ignore_oc)
  239. wPortChange |= USB_PORT_STAT_C_OVERCURRENT;
  240. if (test_bit(port, &uhci->port_c_suspend)) {
  241. wPortChange |= USB_PORT_STAT_C_SUSPEND;
  242. lstatus |= 1;
  243. }
  244. if (test_bit(port, &uhci->resuming_ports))
  245. lstatus |= 4;
  246. /* UHCI has no power switching (always on) */
  247. wPortStatus = USB_PORT_STAT_POWER;
  248. if (status & USBPORTSC_CCS)
  249. wPortStatus |= USB_PORT_STAT_CONNECTION;
  250. if (status & USBPORTSC_PE) {
  251. wPortStatus |= USB_PORT_STAT_ENABLE;
  252. if (status & SUSPEND_BITS)
  253. wPortStatus |= USB_PORT_STAT_SUSPEND;
  254. }
  255. if (status & USBPORTSC_OC)
  256. wPortStatus |= USB_PORT_STAT_OVERCURRENT;
  257. if (status & USBPORTSC_PR)
  258. wPortStatus |= USB_PORT_STAT_RESET;
  259. if (status & USBPORTSC_LSDA)
  260. wPortStatus |= USB_PORT_STAT_LOW_SPEED;
  261. if (wPortChange)
  262. dev_dbg(uhci_dev(uhci), "port %d portsc %04x,%02x\n",
  263. wIndex, status, lstatus);
  264. *(__le16 *)buf = cpu_to_le16(wPortStatus);
  265. *(__le16 *)(buf + 2) = cpu_to_le16(wPortChange);
  266. OK(4);
  267. case SetHubFeature: /* We don't implement these */
  268. case ClearHubFeature:
  269. switch (wValue) {
  270. case C_HUB_OVER_CURRENT:
  271. case C_HUB_LOCAL_POWER:
  272. OK(0);
  273. default:
  274. goto err;
  275. }
  276. break;
  277. case SetPortFeature:
  278. if (port >= uhci->rh_numports)
  279. goto err;
  280. switch (wValue) {
  281. case USB_PORT_FEAT_SUSPEND:
  282. SET_RH_PORTSTAT(USBPORTSC_SUSP);
  283. OK(0);
  284. case USB_PORT_FEAT_RESET:
  285. SET_RH_PORTSTAT(USBPORTSC_PR);
  286. /* Reset terminates Resume signalling */
  287. uhci_finish_suspend(uhci, port, port_addr);
  288. /* USB v2.0 7.1.7.5 */
  289. uhci->ports_timeout = jiffies + msecs_to_jiffies(50);
  290. OK(0);
  291. case USB_PORT_FEAT_POWER:
  292. /* UHCI has no power switching */
  293. OK(0);
  294. default:
  295. goto err;
  296. }
  297. break;
  298. case ClearPortFeature:
  299. if (port >= uhci->rh_numports)
  300. goto err;
  301. switch (wValue) {
  302. case USB_PORT_FEAT_ENABLE:
  303. CLR_RH_PORTSTAT(USBPORTSC_PE);
  304. /* Disable terminates Resume signalling */
  305. uhci_finish_suspend(uhci, port, port_addr);
  306. OK(0);
  307. case USB_PORT_FEAT_C_ENABLE:
  308. CLR_RH_PORTSTAT(USBPORTSC_PEC);
  309. OK(0);
  310. case USB_PORT_FEAT_SUSPEND:
  311. if (!(uhci_readw(uhci, port_addr) & USBPORTSC_SUSP)) {
  312. /* Make certain the port isn't suspended */
  313. uhci_finish_suspend(uhci, port, port_addr);
  314. } else if (!test_and_set_bit(port,
  315. &uhci->resuming_ports)) {
  316. SET_RH_PORTSTAT(USBPORTSC_RD);
  317. /* The controller won't allow RD to be set
  318. * if the port is disabled. When this happens
  319. * just skip the Resume signalling.
  320. */
  321. if (!(uhci_readw(uhci, port_addr) &
  322. USBPORTSC_RD))
  323. uhci_finish_suspend(uhci, port,
  324. port_addr);
  325. else
  326. /* USB v2.0 7.1.7.7 */
  327. uhci->ports_timeout = jiffies +
  328. msecs_to_jiffies(20);
  329. }
  330. OK(0);
  331. case USB_PORT_FEAT_C_SUSPEND:
  332. clear_bit(port, &uhci->port_c_suspend);
  333. OK(0);
  334. case USB_PORT_FEAT_POWER:
  335. /* UHCI has no power switching */
  336. goto err;
  337. case USB_PORT_FEAT_C_CONNECTION:
  338. CLR_RH_PORTSTAT(USBPORTSC_CSC);
  339. OK(0);
  340. case USB_PORT_FEAT_C_OVER_CURRENT:
  341. CLR_RH_PORTSTAT(USBPORTSC_OCC);
  342. OK(0);
  343. case USB_PORT_FEAT_C_RESET:
  344. /* this driver won't report these */
  345. OK(0);
  346. default:
  347. goto err;
  348. }
  349. break;
  350. case GetHubDescriptor:
  351. len = min_t(unsigned int, sizeof(root_hub_hub_des), wLength);
  352. memcpy(buf, root_hub_hub_des, len);
  353. if (len > 2)
  354. buf[2] = uhci->rh_numports;
  355. OK(len);
  356. default:
  357. err:
  358. retval = -EPIPE;
  359. }
  360. spin_unlock_irqrestore(&uhci->lock, flags);
  361. return retval;
  362. }