c227ba46d6f38608dc107f650a825437fef824ea
[safe/jmp/linux-2.6] / drivers / usb / host / ehci-hcd.c
1 /*
2  * Copyright (c) 2000-2004 by David Brownell
3  *
4  * This program is free software; you can redistribute it and/or modify it
5  * under the terms of the GNU General Public License as published by the
6  * Free Software Foundation; either version 2 of the License, or (at your
7  * option) any later version.
8  *
9  * This program is distributed in the hope that it will be useful, but
10  * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
11  * or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
12  * for more details.
13  *
14  * You should have received a copy of the GNU General Public License
15  * along with this program; if not, write to the Free Software Foundation,
16  * Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
17  */
18
19 #include <linux/module.h>
20 #include <linux/pci.h>
21 #include <linux/dmapool.h>
22 #include <linux/kernel.h>
23 #include <linux/delay.h>
24 #include <linux/ioport.h>
25 #include <linux/sched.h>
26 #include <linux/slab.h>
27 #include <linux/vmalloc.h>
28 #include <linux/errno.h>
29 #include <linux/init.h>
30 #include <linux/timer.h>
31 #include <linux/list.h>
32 #include <linux/interrupt.h>
33 #include <linux/reboot.h>
34 #include <linux/usb.h>
35 #include <linux/moduleparam.h>
36 #include <linux/dma-mapping.h>
37 #include <linux/debugfs.h>
38
39 #include "../core/hcd.h"
40
41 #include <asm/byteorder.h>
42 #include <asm/io.h>
43 #include <asm/irq.h>
44 #include <asm/system.h>
45 #include <asm/unaligned.h>
46
47 /*-------------------------------------------------------------------------*/
48
49 /*
50  * EHCI hc_driver implementation ... experimental, incomplete.
51  * Based on the final 1.0 register interface specification.
52  *
53  * USB 2.0 shows up in upcoming www.pcmcia.org technology.
54  * First was PCMCIA, like ISA; then CardBus, which is PCI.
55  * Next comes "CardBay", using USB 2.0 signals.
56  *
57  * Contains additional contributions by Brad Hards, Rory Bolt, and others.
58  * Special thanks to Intel and VIA for providing host controllers to
59  * test this driver on, and Cypress (including In-System Design) for
60  * providing early devices for those host controllers to talk to!
61  */
62
63 #define DRIVER_AUTHOR "David Brownell"
64 #define DRIVER_DESC "USB 2.0 'Enhanced' Host Controller (EHCI) Driver"
65
66 static const char       hcd_name [] = "ehci_hcd";
67
68
69 #undef VERBOSE_DEBUG
70 #undef EHCI_URB_TRACE
71
72 #ifdef DEBUG
73 #define EHCI_STATS
74 #endif
75
76 /* magic numbers that can affect system performance */
77 #define EHCI_TUNE_CERR          3       /* 0-3 qtd retries; 0 == don't stop */
78 #define EHCI_TUNE_RL_HS         4       /* nak throttle; see 4.9 */
79 #define EHCI_TUNE_RL_TT         0
80 #define EHCI_TUNE_MULT_HS       1       /* 1-3 transactions/uframe; 4.10.3 */
81 #define EHCI_TUNE_MULT_TT       1
82 #define EHCI_TUNE_FLS           2       /* (small) 256 frame schedule */
83
84 #define EHCI_IAA_MSECS          10              /* arbitrary */
85 #define EHCI_IO_JIFFIES         (HZ/10)         /* io watchdog > irq_thresh */
86 #define EHCI_ASYNC_JIFFIES      (HZ/20)         /* async idle timeout */
87 #define EHCI_SHRINK_FRAMES      5               /* async qh unlink delay */
88
89 /* Initial IRQ latency:  faster than hw default */
90 static int log2_irq_thresh = 0;         // 0 to 6
91 module_param (log2_irq_thresh, int, S_IRUGO);
92 MODULE_PARM_DESC (log2_irq_thresh, "log2 IRQ latency, 1-64 microframes");
93
94 /* initial park setting:  slower than hw default */
95 static unsigned park = 0;
96 module_param (park, uint, S_IRUGO);
97 MODULE_PARM_DESC (park, "park setting; 1-3 back-to-back async packets");
98
99 /* for flakey hardware, ignore overcurrent indicators */
100 static int ignore_oc = 0;
101 module_param (ignore_oc, bool, S_IRUGO);
102 MODULE_PARM_DESC (ignore_oc, "ignore bogus hardware overcurrent indications");
103
104 #define INTR_MASK (STS_IAA | STS_FATAL | STS_PCD | STS_ERR | STS_INT)
105
106 /*-------------------------------------------------------------------------*/
107
108 #include "ehci.h"
109 #include "ehci-dbg.c"
110
111 /*-------------------------------------------------------------------------*/
112
113 static void
114 timer_action(struct ehci_hcd *ehci, enum ehci_timer_action action)
115 {
116         /* Don't override timeouts which shrink or (later) disable
117          * the async ring; just the I/O watchdog.  Note that if a
118          * SHRINK were pending, OFF would never be requested.
119          */
120         if (timer_pending(&ehci->watchdog)
121                         && ((BIT(TIMER_ASYNC_SHRINK) | BIT(TIMER_ASYNC_OFF))
122                                 & ehci->actions))
123                 return;
124
125         if (!test_and_set_bit(action, &ehci->actions)) {
126                 unsigned long t;
127
128                 switch (action) {
129                 case TIMER_IO_WATCHDOG:
130                         if (!ehci->need_io_watchdog)
131                                 return;
132                         t = EHCI_IO_JIFFIES;
133                         break;
134                 case TIMER_ASYNC_OFF:
135                         t = EHCI_ASYNC_JIFFIES;
136                         break;
137                 /* case TIMER_ASYNC_SHRINK: */
138                 default:
139                         /* add a jiffie since we synch against the
140                          * 8 KHz uframe counter.
141                          */
142                         t = DIV_ROUND_UP(EHCI_SHRINK_FRAMES * HZ, 1000) + 1;
143                         break;
144                 }
145                 mod_timer(&ehci->watchdog, t + jiffies);
146         }
147 }
148
149 /*-------------------------------------------------------------------------*/
150
151 /*
152  * handshake - spin reading hc until handshake completes or fails
153  * @ptr: address of hc register to be read
154  * @mask: bits to look at in result of read
155  * @done: value of those bits when handshake succeeds
156  * @usec: timeout in microseconds
157  *
158  * Returns negative errno, or zero on success
159  *
160  * Success happens when the "mask" bits have the specified value (hardware
161  * handshake done).  There are two failure modes:  "usec" have passed (major
162  * hardware flakeout), or the register reads as all-ones (hardware removed).
163  *
164  * That last failure should_only happen in cases like physical cardbus eject
165  * before driver shutdown. But it also seems to be caused by bugs in cardbus
166  * bridge shutdown:  shutting down the bridge before the devices using it.
167  */
168 static int handshake (struct ehci_hcd *ehci, void __iomem *ptr,
169                       u32 mask, u32 done, int usec)
170 {
171         u32     result;
172
173         do {
174                 result = ehci_readl(ehci, ptr);
175                 if (result == ~(u32)0)          /* card removed */
176                         return -ENODEV;
177                 result &= mask;
178                 if (result == done)
179                         return 0;
180                 udelay (1);
181                 usec--;
182         } while (usec > 0);
183         return -ETIMEDOUT;
184 }
185
186 /* force HC to halt state from unknown (EHCI spec section 2.3) */
187 static int ehci_halt (struct ehci_hcd *ehci)
188 {
189         u32     temp = ehci_readl(ehci, &ehci->regs->status);
190
191         /* disable any irqs left enabled by previous code */
192         ehci_writel(ehci, 0, &ehci->regs->intr_enable);
193
194         if ((temp & STS_HALT) != 0)
195                 return 0;
196
197         temp = ehci_readl(ehci, &ehci->regs->command);
198         temp &= ~CMD_RUN;
199         ehci_writel(ehci, temp, &ehci->regs->command);
200         return handshake (ehci, &ehci->regs->status,
201                           STS_HALT, STS_HALT, 16 * 125);
202 }
203
204 static int handshake_on_error_set_halt(struct ehci_hcd *ehci, void __iomem *ptr,
205                                        u32 mask, u32 done, int usec)
206 {
207         int error;
208
209         error = handshake(ehci, ptr, mask, done, usec);
210         if (error) {
211                 ehci_halt(ehci);
212                 ehci_to_hcd(ehci)->state = HC_STATE_HALT;
213                 ehci_err(ehci, "force halt; handhake %p %08x %08x -> %d\n",
214                         ptr, mask, done, error);
215         }
216
217         return error;
218 }
219
220 /* put TDI/ARC silicon into EHCI mode */
221 static void tdi_reset (struct ehci_hcd *ehci)
222 {
223         u32 __iomem     *reg_ptr;
224         u32             tmp;
225
226         reg_ptr = (u32 __iomem *)(((u8 __iomem *)ehci->regs) + USBMODE);
227         tmp = ehci_readl(ehci, reg_ptr);
228         tmp |= USBMODE_CM_HC;
229         /* The default byte access to MMR space is LE after
230          * controller reset. Set the required endian mode
231          * for transfer buffers to match the host microprocessor
232          */
233         if (ehci_big_endian_mmio(ehci))
234                 tmp |= USBMODE_BE;
235         ehci_writel(ehci, tmp, reg_ptr);
236 }
237
238 /* reset a non-running (STS_HALT == 1) controller */
239 static int ehci_reset (struct ehci_hcd *ehci)
240 {
241         int     retval;
242         u32     command = ehci_readl(ehci, &ehci->regs->command);
243
244         command |= CMD_RESET;
245         dbg_cmd (ehci, "reset", command);
246         ehci_writel(ehci, command, &ehci->regs->command);
247         ehci_to_hcd(ehci)->state = HC_STATE_HALT;
248         ehci->next_statechange = jiffies;
249         retval = handshake (ehci, &ehci->regs->command,
250                             CMD_RESET, 0, 250 * 1000);
251
252         if (ehci->has_hostpc) {
253                 ehci_writel(ehci, USBMODE_EX_HC | USBMODE_EX_VBPS,
254                         (u32 __iomem *)(((u8 *)ehci->regs) + USBMODE_EX));
255                 ehci_writel(ehci, TXFIFO_DEFAULT,
256                         (u32 __iomem *)(((u8 *)ehci->regs) + TXFILLTUNING));
257         }
258         if (retval)
259                 return retval;
260
261         if (ehci_is_TDI(ehci))
262                 tdi_reset (ehci);
263
264         return retval;
265 }
266
267 /* idle the controller (from running) */
268 static void ehci_quiesce (struct ehci_hcd *ehci)
269 {
270         u32     temp;
271
272 #ifdef DEBUG
273         if (!HC_IS_RUNNING (ehci_to_hcd(ehci)->state))
274                 BUG ();
275 #endif
276
277         /* wait for any schedule enables/disables to take effect */
278         temp = ehci_readl(ehci, &ehci->regs->command) << 10;
279         temp &= STS_ASS | STS_PSS;
280         if (handshake_on_error_set_halt(ehci, &ehci->regs->status,
281                                         STS_ASS | STS_PSS, temp, 16 * 125))
282                 return;
283
284         /* then disable anything that's still active */
285         temp = ehci_readl(ehci, &ehci->regs->command);
286         temp &= ~(CMD_ASE | CMD_IAAD | CMD_PSE);
287         ehci_writel(ehci, temp, &ehci->regs->command);
288
289         /* hardware can take 16 microframes to turn off ... */
290         handshake_on_error_set_halt(ehci, &ehci->regs->status,
291                                     STS_ASS | STS_PSS, 0, 16 * 125);
292 }
293
294 /*-------------------------------------------------------------------------*/
295
296 static void end_unlink_async(struct ehci_hcd *ehci);
297 static void ehci_work(struct ehci_hcd *ehci);
298
299 #include "ehci-hub.c"
300 #include "ehci-mem.c"
301 #include "ehci-q.c"
302 #include "ehci-sched.c"
303
304 /*-------------------------------------------------------------------------*/
305
306 static void ehci_iaa_watchdog(unsigned long param)
307 {
308         struct ehci_hcd         *ehci = (struct ehci_hcd *) param;
309         unsigned long           flags;
310
311         spin_lock_irqsave (&ehci->lock, flags);
312
313         /* Lost IAA irqs wedge things badly; seen first with a vt8235.
314          * So we need this watchdog, but must protect it against both
315          * (a) SMP races against real IAA firing and retriggering, and
316          * (b) clean HC shutdown, when IAA watchdog was pending.
317          */
318         if (ehci->reclaim
319                         && !timer_pending(&ehci->iaa_watchdog)
320                         && HC_IS_RUNNING(ehci_to_hcd(ehci)->state)) {
321                 u32 cmd, status;
322
323                 /* If we get here, IAA is *REALLY* late.  It's barely
324                  * conceivable that the system is so busy that CMD_IAAD
325                  * is still legitimately set, so let's be sure it's
326                  * clear before we read STS_IAA.  (The HC should clear
327                  * CMD_IAAD when it sets STS_IAA.)
328                  */
329                 cmd = ehci_readl(ehci, &ehci->regs->command);
330                 if (cmd & CMD_IAAD)
331                         ehci_writel(ehci, cmd & ~CMD_IAAD,
332                                         &ehci->regs->command);
333
334                 /* If IAA is set here it either legitimately triggered
335                  * before we cleared IAAD above (but _way_ late, so we'll
336                  * still count it as lost) ... or a silicon erratum:
337                  * - VIA seems to set IAA without triggering the IRQ;
338                  * - IAAD potentially cleared without setting IAA.
339                  */
340                 status = ehci_readl(ehci, &ehci->regs->status);
341                 if ((status & STS_IAA) || !(cmd & CMD_IAAD)) {
342                         COUNT (ehci->stats.lost_iaa);
343                         ehci_writel(ehci, STS_IAA, &ehci->regs->status);
344                 }
345
346                 ehci_vdbg(ehci, "IAA watchdog: status %x cmd %x\n",
347                                 status, cmd);
348                 end_unlink_async(ehci);
349         }
350
351         spin_unlock_irqrestore(&ehci->lock, flags);
352 }
353
354 static void ehci_watchdog(unsigned long param)
355 {
356         struct ehci_hcd         *ehci = (struct ehci_hcd *) param;
357         unsigned long           flags;
358
359         spin_lock_irqsave(&ehci->lock, flags);
360
361         /* stop async processing after it's idled a bit */
362         if (test_bit (TIMER_ASYNC_OFF, &ehci->actions))
363                 start_unlink_async (ehci, ehci->async);
364
365         /* ehci could run by timer, without IRQs ... */
366         ehci_work (ehci);
367
368         spin_unlock_irqrestore (&ehci->lock, flags);
369 }
370
371 /* On some systems, leaving remote wakeup enabled prevents system shutdown.
372  * The firmware seems to think that powering off is a wakeup event!
373  * This routine turns off remote wakeup and everything else, on all ports.
374  */
375 static void ehci_turn_off_all_ports(struct ehci_hcd *ehci)
376 {
377         int     port = HCS_N_PORTS(ehci->hcs_params);
378
379         while (port--)
380                 ehci_writel(ehci, PORT_RWC_BITS,
381                                 &ehci->regs->port_status[port]);
382 }
383
384 /*
385  * Halt HC, turn off all ports, and let the BIOS use the companion controllers.
386  * Should be called with ehci->lock held.
387  */
388 static void ehci_silence_controller(struct ehci_hcd *ehci)
389 {
390         ehci_halt(ehci);
391         ehci_turn_off_all_ports(ehci);
392
393         /* make BIOS/etc use companion controller during reboot */
394         ehci_writel(ehci, 0, &ehci->regs->configured_flag);
395
396         /* unblock posted writes */
397         ehci_readl(ehci, &ehci->regs->configured_flag);
398 }
399
400 /* ehci_shutdown kick in for silicon on any bus (not just pci, etc).
401  * This forcibly disables dma and IRQs, helping kexec and other cases
402  * where the next system software may expect clean state.
403  */
404 static void ehci_shutdown(struct usb_hcd *hcd)
405 {
406         struct ehci_hcd *ehci = hcd_to_ehci(hcd);
407
408         del_timer_sync(&ehci->watchdog);
409         del_timer_sync(&ehci->iaa_watchdog);
410
411         spin_lock_irq(&ehci->lock);
412         ehci_silence_controller(ehci);
413         spin_unlock_irq(&ehci->lock);
414 }
415
416 static void ehci_port_power (struct ehci_hcd *ehci, int is_on)
417 {
418         unsigned port;
419
420         if (!HCS_PPC (ehci->hcs_params))
421                 return;
422
423         ehci_dbg (ehci, "...power%s ports...\n", is_on ? "up" : "down");
424         for (port = HCS_N_PORTS (ehci->hcs_params); port > 0; )
425                 (void) ehci_hub_control(ehci_to_hcd(ehci),
426                                 is_on ? SetPortFeature : ClearPortFeature,
427                                 USB_PORT_FEAT_POWER,
428                                 port--, NULL, 0);
429         /* Flush those writes */
430         ehci_readl(ehci, &ehci->regs->command);
431         msleep(20);
432 }
433
434 /*-------------------------------------------------------------------------*/
435
436 /*
437  * ehci_work is called from some interrupts, timers, and so on.
438  * it calls driver completion functions, after dropping ehci->lock.
439  */
440 static void ehci_work (struct ehci_hcd *ehci)
441 {
442         timer_action_done (ehci, TIMER_IO_WATCHDOG);
443
444         /* another CPU may drop ehci->lock during a schedule scan while
445          * it reports urb completions.  this flag guards against bogus
446          * attempts at re-entrant schedule scanning.
447          */
448         if (ehci->scanning)
449                 return;
450         ehci->scanning = 1;
451         scan_async (ehci);
452         if (ehci->next_uframe != -1)
453                 scan_periodic (ehci);
454         ehci->scanning = 0;
455
456         /* the IO watchdog guards against hardware or driver bugs that
457          * misplace IRQs, and should let us run completely without IRQs.
458          * such lossage has been observed on both VT6202 and VT8235.
459          */
460         if (HC_IS_RUNNING (ehci_to_hcd(ehci)->state) &&
461                         (ehci->async->qh_next.ptr != NULL ||
462                          ehci->periodic_sched != 0))
463                 timer_action (ehci, TIMER_IO_WATCHDOG);
464 }
465
466 /*
467  * Called when the ehci_hcd module is removed.
468  */
469 static void ehci_stop (struct usb_hcd *hcd)
470 {
471         struct ehci_hcd         *ehci = hcd_to_ehci (hcd);
472
473         ehci_dbg (ehci, "stop\n");
474
475         /* no more interrupts ... */
476         del_timer_sync (&ehci->watchdog);
477         del_timer_sync(&ehci->iaa_watchdog);
478
479         spin_lock_irq(&ehci->lock);
480         if (HC_IS_RUNNING (hcd->state))
481                 ehci_quiesce (ehci);
482
483         ehci_silence_controller(ehci);
484         ehci_reset (ehci);
485         spin_unlock_irq(&ehci->lock);
486
487         remove_companion_file(ehci);
488         remove_debug_files (ehci);
489
490         /* root hub is shut down separately (first, when possible) */
491         spin_lock_irq (&ehci->lock);
492         if (ehci->async)
493                 ehci_work (ehci);
494         spin_unlock_irq (&ehci->lock);
495         ehci_mem_cleanup (ehci);
496
497 #ifdef  EHCI_STATS
498         ehci_dbg (ehci, "irq normal %ld err %ld reclaim %ld (lost %ld)\n",
499                 ehci->stats.normal, ehci->stats.error, ehci->stats.reclaim,
500                 ehci->stats.lost_iaa);
501         ehci_dbg (ehci, "complete %ld unlink %ld\n",
502                 ehci->stats.complete, ehci->stats.unlink);
503 #endif
504
505         dbg_status (ehci, "ehci_stop completed",
506                     ehci_readl(ehci, &ehci->regs->status));
507 }
508
509 /* one-time init, only for memory state */
510 static int ehci_init(struct usb_hcd *hcd)
511 {
512         struct ehci_hcd         *ehci = hcd_to_ehci(hcd);
513         u32                     temp;
514         int                     retval;
515         u32                     hcc_params;
516         struct ehci_qh_hw       *hw;
517
518         spin_lock_init(&ehci->lock);
519
520         /*
521          * keep io watchdog by default, those good HCDs could turn off it later
522          */
523         ehci->need_io_watchdog = 1;
524         init_timer(&ehci->watchdog);
525         ehci->watchdog.function = ehci_watchdog;
526         ehci->watchdog.data = (unsigned long) ehci;
527
528         init_timer(&ehci->iaa_watchdog);
529         ehci->iaa_watchdog.function = ehci_iaa_watchdog;
530         ehci->iaa_watchdog.data = (unsigned long) ehci;
531
532         /*
533          * hw default: 1K periodic list heads, one per frame.
534          * periodic_size can shrink by USBCMD update if hcc_params allows.
535          */
536         ehci->periodic_size = DEFAULT_I_TDPS;
537         INIT_LIST_HEAD(&ehci->cached_itd_list);
538         if ((retval = ehci_mem_init(ehci, GFP_KERNEL)) < 0)
539                 return retval;
540
541         /* controllers may cache some of the periodic schedule ... */
542         hcc_params = ehci_readl(ehci, &ehci->caps->hcc_params);
543         if (HCC_ISOC_CACHE(hcc_params))         // full frame cache
544                 ehci->i_thresh = 8;
545         else                                    // N microframes cached
546                 ehci->i_thresh = 2 + HCC_ISOC_THRES(hcc_params);
547
548         ehci->reclaim = NULL;
549         ehci->next_uframe = -1;
550         ehci->clock_frame = -1;
551
552         /*
553          * dedicate a qh for the async ring head, since we couldn't unlink
554          * a 'real' qh without stopping the async schedule [4.8].  use it
555          * as the 'reclamation list head' too.
556          * its dummy is used in hw_alt_next of many tds, to prevent the qh
557          * from automatically advancing to the next td after short reads.
558          */
559         ehci->async->qh_next.qh = NULL;
560         hw = ehci->async->hw;
561         hw->hw_next = QH_NEXT(ehci, ehci->async->qh_dma);
562         hw->hw_info1 = cpu_to_hc32(ehci, QH_HEAD);
563         hw->hw_token = cpu_to_hc32(ehci, QTD_STS_HALT);
564         hw->hw_qtd_next = EHCI_LIST_END(ehci);
565         ehci->async->qh_state = QH_STATE_LINKED;
566         hw->hw_alt_next = QTD_NEXT(ehci, ehci->async->dummy->qtd_dma);
567
568         /* clear interrupt enables, set irq latency */
569         if (log2_irq_thresh < 0 || log2_irq_thresh > 6)
570                 log2_irq_thresh = 0;
571         temp = 1 << (16 + log2_irq_thresh);
572         if (HCC_CANPARK(hcc_params)) {
573                 /* HW default park == 3, on hardware that supports it (like
574                  * NVidia and ALI silicon), maximizes throughput on the async
575                  * schedule by avoiding QH fetches between transfers.
576                  *
577                  * With fast usb storage devices and NForce2, "park" seems to
578                  * make problems:  throughput reduction (!), data errors...
579                  */
580                 if (park) {
581                         park = min(park, (unsigned) 3);
582                         temp |= CMD_PARK;
583                         temp |= park << 8;
584                 }
585                 ehci_dbg(ehci, "park %d\n", park);
586         }
587         if (HCC_PGM_FRAMELISTLEN(hcc_params)) {
588                 /* periodic schedule size can be smaller than default */
589                 temp &= ~(3 << 2);
590                 temp |= (EHCI_TUNE_FLS << 2);
591                 switch (EHCI_TUNE_FLS) {
592                 case 0: ehci->periodic_size = 1024; break;
593                 case 1: ehci->periodic_size = 512; break;
594                 case 2: ehci->periodic_size = 256; break;
595                 default:        BUG();
596                 }
597         }
598         ehci->command = temp;
599
600         return 0;
601 }
602
603 /* start HC running; it's halted, ehci_init() has been run (once) */
604 static int ehci_run (struct usb_hcd *hcd)
605 {
606         struct ehci_hcd         *ehci = hcd_to_ehci (hcd);
607         int                     retval;
608         u32                     temp;
609         u32                     hcc_params;
610
611         hcd->uses_new_polling = 1;
612         hcd->poll_rh = 0;
613
614         /* EHCI spec section 4.1 */
615         if ((retval = ehci_reset(ehci)) != 0) {
616                 ehci_mem_cleanup(ehci);
617                 return retval;
618         }
619         ehci_writel(ehci, ehci->periodic_dma, &ehci->regs->frame_list);
620         ehci_writel(ehci, (u32)ehci->async->qh_dma, &ehci->regs->async_next);
621
622         /*
623          * hcc_params controls whether ehci->regs->segment must (!!!)
624          * be used; it constrains QH/ITD/SITD and QTD locations.
625          * pci_pool consistent memory always uses segment zero.
626          * streaming mappings for I/O buffers, like pci_map_single(),
627          * can return segments above 4GB, if the device allows.
628          *
629          * NOTE:  the dma mask is visible through dma_supported(), so
630          * drivers can pass this info along ... like NETIF_F_HIGHDMA,
631          * Scsi_Host.highmem_io, and so forth.  It's readonly to all
632          * host side drivers though.
633          */
634         hcc_params = ehci_readl(ehci, &ehci->caps->hcc_params);
635         if (HCC_64BIT_ADDR(hcc_params)) {
636                 ehci_writel(ehci, 0, &ehci->regs->segment);
637 #if 0
638 // this is deeply broken on almost all architectures
639                 if (!dma_set_mask(hcd->self.controller, DMA_BIT_MASK(64)))
640                         ehci_info(ehci, "enabled 64bit DMA\n");
641 #endif
642         }
643
644
645         // Philips, Intel, and maybe others need CMD_RUN before the
646         // root hub will detect new devices (why?); NEC doesn't
647         ehci->command &= ~(CMD_LRESET|CMD_IAAD|CMD_PSE|CMD_ASE|CMD_RESET);
648         ehci->command |= CMD_RUN;
649         ehci_writel(ehci, ehci->command, &ehci->regs->command);
650         dbg_cmd (ehci, "init", ehci->command);
651
652         /*
653          * Start, enabling full USB 2.0 functionality ... usb 1.1 devices
654          * are explicitly handed to companion controller(s), so no TT is
655          * involved with the root hub.  (Except where one is integrated,
656          * and there's no companion controller unless maybe for USB OTG.)
657          *
658          * Turning on the CF flag will transfer ownership of all ports
659          * from the companions to the EHCI controller.  If any of the
660          * companions are in the middle of a port reset at the time, it
661          * could cause trouble.  Write-locking ehci_cf_port_reset_rwsem
662          * guarantees that no resets are in progress.  After we set CF,
663          * a short delay lets the hardware catch up; new resets shouldn't
664          * be started before the port switching actions could complete.
665          */
666         down_write(&ehci_cf_port_reset_rwsem);
667         hcd->state = HC_STATE_RUNNING;
668         ehci_writel(ehci, FLAG_CF, &ehci->regs->configured_flag);
669         ehci_readl(ehci, &ehci->regs->command); /* unblock posted writes */
670         msleep(5);
671         up_write(&ehci_cf_port_reset_rwsem);
672
673         temp = HC_VERSION(ehci_readl(ehci, &ehci->caps->hc_capbase));
674         ehci_info (ehci,
675                 "USB %x.%x started, EHCI %x.%02x%s\n",
676                 ((ehci->sbrn & 0xf0)>>4), (ehci->sbrn & 0x0f),
677                 temp >> 8, temp & 0xff,
678                 ignore_oc ? ", overcurrent ignored" : "");
679
680         ehci_writel(ehci, INTR_MASK,
681                     &ehci->regs->intr_enable); /* Turn On Interrupts */
682
683         /* GRR this is run-once init(), being done every time the HC starts.
684          * So long as they're part of class devices, we can't do it init()
685          * since the class device isn't created that early.
686          */
687         create_debug_files(ehci);
688         create_companion_file(ehci);
689
690         return 0;
691 }
692
693 /*-------------------------------------------------------------------------*/
694
695 static irqreturn_t ehci_irq (struct usb_hcd *hcd)
696 {
697         struct ehci_hcd         *ehci = hcd_to_ehci (hcd);
698         u32                     status, masked_status, pcd_status = 0, cmd;
699         int                     bh;
700
701         spin_lock (&ehci->lock);
702
703         status = ehci_readl(ehci, &ehci->regs->status);
704
705         /* e.g. cardbus physical eject */
706         if (status == ~(u32) 0) {
707                 ehci_dbg (ehci, "device removed\n");
708                 goto dead;
709         }
710
711         masked_status = status & INTR_MASK;
712         if (!masked_status) {           /* irq sharing? */
713                 spin_unlock(&ehci->lock);
714                 return IRQ_NONE;
715         }
716
717         /* clear (just) interrupts */
718         ehci_writel(ehci, masked_status, &ehci->regs->status);
719         cmd = ehci_readl(ehci, &ehci->regs->command);
720         bh = 0;
721
722 #ifdef  VERBOSE_DEBUG
723         /* unrequested/ignored: Frame List Rollover */
724         dbg_status (ehci, "irq", status);
725 #endif
726
727         /* INT, ERR, and IAA interrupt rates can be throttled */
728
729         /* normal [4.15.1.2] or error [4.15.1.1] completion */
730         if (likely ((status & (STS_INT|STS_ERR)) != 0)) {
731                 if (likely ((status & STS_ERR) == 0))
732                         COUNT (ehci->stats.normal);
733                 else
734                         COUNT (ehci->stats.error);
735                 bh = 1;
736         }
737
738         /* complete the unlinking of some qh [4.15.2.3] */
739         if (status & STS_IAA) {
740                 /* guard against (alleged) silicon errata */
741                 if (cmd & CMD_IAAD) {
742                         ehci_writel(ehci, cmd & ~CMD_IAAD,
743                                         &ehci->regs->command);
744                         ehci_dbg(ehci, "IAA with IAAD still set?\n");
745                 }
746                 if (ehci->reclaim) {
747                         COUNT(ehci->stats.reclaim);
748                         end_unlink_async(ehci);
749                 } else
750                         ehci_dbg(ehci, "IAA with nothing to reclaim?\n");
751         }
752
753         /* remote wakeup [4.3.1] */
754         if (status & STS_PCD) {
755                 unsigned        i = HCS_N_PORTS (ehci->hcs_params);
756
757                 /* kick root hub later */
758                 pcd_status = status;
759
760                 /* resume root hub? */
761                 if (!(cmd & CMD_RUN))
762                         usb_hcd_resume_root_hub(hcd);
763
764                 while (i--) {
765                         int pstatus = ehci_readl(ehci,
766                                                  &ehci->regs->port_status [i]);
767
768                         if (pstatus & PORT_OWNER)
769                                 continue;
770                         if (!(test_bit(i, &ehci->suspended_ports) &&
771                                         ((pstatus & PORT_RESUME) ||
772                                                 !(pstatus & PORT_SUSPEND)) &&
773                                         (pstatus & PORT_PE) &&
774                                         ehci->reset_done[i] == 0))
775                                 continue;
776
777                         /* start 20 msec resume signaling from this port,
778                          * and make khubd collect PORT_STAT_C_SUSPEND to
779                          * stop that signaling.
780                          */
781                         ehci->reset_done [i] = jiffies + msecs_to_jiffies (20);
782                         ehci_dbg (ehci, "port %d remote wakeup\n", i + 1);
783                         mod_timer(&hcd->rh_timer, ehci->reset_done[i]);
784                 }
785         }
786
787         /* PCI errors [4.15.2.4] */
788         if (unlikely ((status & STS_FATAL) != 0)) {
789                 ehci_err(ehci, "fatal error\n");
790                 dbg_cmd(ehci, "fatal", cmd);
791                 dbg_status(ehci, "fatal", status);
792                 ehci_halt(ehci);
793 dead:
794                 ehci_reset(ehci);
795                 ehci_writel(ehci, 0, &ehci->regs->configured_flag);
796                 /* generic layer kills/unlinks all urbs, then
797                  * uses ehci_stop to clean up the rest
798                  */
799                 bh = 1;
800         }
801
802         if (bh)
803                 ehci_work (ehci);
804         spin_unlock (&ehci->lock);
805         if (pcd_status)
806                 usb_hcd_poll_rh_status(hcd);
807         return IRQ_HANDLED;
808 }
809
810 /*-------------------------------------------------------------------------*/
811
812 /*
813  * non-error returns are a promise to giveback() the urb later
814  * we drop ownership so next owner (or urb unlink) can get it
815  *
816  * urb + dev is in hcd.self.controller.urb_list
817  * we're queueing TDs onto software and hardware lists
818  *
819  * hcd-specific init for hcpriv hasn't been done yet
820  *
821  * NOTE:  control, bulk, and interrupt share the same code to append TDs
822  * to a (possibly active) QH, and the same QH scanning code.
823  */
824 static int ehci_urb_enqueue (
825         struct usb_hcd  *hcd,
826         struct urb      *urb,
827         gfp_t           mem_flags
828 ) {
829         struct ehci_hcd         *ehci = hcd_to_ehci (hcd);
830         struct list_head        qtd_list;
831
832         INIT_LIST_HEAD (&qtd_list);
833
834         switch (usb_pipetype (urb->pipe)) {
835         case PIPE_CONTROL:
836                 /* qh_completions() code doesn't handle all the fault cases
837                  * in multi-TD control transfers.  Even 1KB is rare anyway.
838                  */
839                 if (urb->transfer_buffer_length > (16 * 1024))
840                         return -EMSGSIZE;
841                 /* FALLTHROUGH */
842         /* case PIPE_BULK: */
843         default:
844                 if (!qh_urb_transaction (ehci, urb, &qtd_list, mem_flags))
845                         return -ENOMEM;
846                 return submit_async(ehci, urb, &qtd_list, mem_flags);
847
848         case PIPE_INTERRUPT:
849                 if (!qh_urb_transaction (ehci, urb, &qtd_list, mem_flags))
850                         return -ENOMEM;
851                 return intr_submit(ehci, urb, &qtd_list, mem_flags);
852
853         case PIPE_ISOCHRONOUS:
854                 if (urb->dev->speed == USB_SPEED_HIGH)
855                         return itd_submit (ehci, urb, mem_flags);
856                 else
857                         return sitd_submit (ehci, urb, mem_flags);
858         }
859 }
860
861 static void unlink_async (struct ehci_hcd *ehci, struct ehci_qh *qh)
862 {
863         /* failfast */
864         if (!HC_IS_RUNNING(ehci_to_hcd(ehci)->state) && ehci->reclaim)
865                 end_unlink_async(ehci);
866
867         /* if it's not linked then there's nothing to do */
868         if (qh->qh_state != QH_STATE_LINKED)
869                 ;
870
871         /* defer till later if busy */
872         else if (ehci->reclaim) {
873                 struct ehci_qh          *last;
874
875                 for (last = ehci->reclaim;
876                                 last->reclaim;
877                                 last = last->reclaim)
878                         continue;
879                 qh->qh_state = QH_STATE_UNLINK_WAIT;
880                 last->reclaim = qh;
881
882         /* start IAA cycle */
883         } else
884                 start_unlink_async (ehci, qh);
885 }
886
887 /* remove from hardware lists
888  * completions normally happen asynchronously
889  */
890
891 static int ehci_urb_dequeue(struct usb_hcd *hcd, struct urb *urb, int status)
892 {
893         struct ehci_hcd         *ehci = hcd_to_ehci (hcd);
894         struct ehci_qh          *qh;
895         unsigned long           flags;
896         int                     rc;
897
898         spin_lock_irqsave (&ehci->lock, flags);
899         rc = usb_hcd_check_unlink_urb(hcd, urb, status);
900         if (rc)
901                 goto done;
902
903         switch (usb_pipetype (urb->pipe)) {
904         // case PIPE_CONTROL:
905         // case PIPE_BULK:
906         default:
907                 qh = (struct ehci_qh *) urb->hcpriv;
908                 if (!qh)
909                         break;
910                 switch (qh->qh_state) {
911                 case QH_STATE_LINKED:
912                 case QH_STATE_COMPLETING:
913                         unlink_async(ehci, qh);
914                         break;
915                 case QH_STATE_UNLINK:
916                 case QH_STATE_UNLINK_WAIT:
917                         /* already started */
918                         break;
919                 case QH_STATE_IDLE:
920                         /* QH might be waiting for a Clear-TT-Buffer */
921                         qh_completions(ehci, qh);
922                         break;
923                 }
924                 break;
925
926         case PIPE_INTERRUPT:
927                 qh = (struct ehci_qh *) urb->hcpriv;
928                 if (!qh)
929                         break;
930                 switch (qh->qh_state) {
931                 case QH_STATE_LINKED:
932                         intr_deschedule (ehci, qh);
933                         /* FALL THROUGH */
934                 case QH_STATE_IDLE:
935                         qh_completions (ehci, qh);
936                         break;
937                 default:
938                         ehci_dbg (ehci, "bogus qh %p state %d\n",
939                                         qh, qh->qh_state);
940                         goto done;
941                 }
942
943                 /* reschedule QH iff another request is queued */
944                 if (!list_empty (&qh->qtd_list)
945                                 && HC_IS_RUNNING (hcd->state)) {
946                         rc = qh_schedule(ehci, qh);
947
948                         /* An error here likely indicates handshake failure
949                          * or no space left in the schedule.  Neither fault
950                          * should happen often ...
951                          *
952                          * FIXME kill the now-dysfunctional queued urbs
953                          */
954                         if (rc != 0)
955                                 ehci_err(ehci,
956                                         "can't reschedule qh %p, err %d",
957                                         qh, rc);
958                 }
959                 break;
960
961         case PIPE_ISOCHRONOUS:
962                 // itd or sitd ...
963
964                 // wait till next completion, do it then.
965                 // completion irqs can wait up to 1024 msec,
966                 break;
967         }
968 done:
969         spin_unlock_irqrestore (&ehci->lock, flags);
970         return rc;
971 }
972
973 /*-------------------------------------------------------------------------*/
974
975 // bulk qh holds the data toggle
976
977 static void
978 ehci_endpoint_disable (struct usb_hcd *hcd, struct usb_host_endpoint *ep)
979 {
980         struct ehci_hcd         *ehci = hcd_to_ehci (hcd);
981         unsigned long           flags;
982         struct ehci_qh          *qh, *tmp;
983
984         /* ASSERT:  any requests/urbs are being unlinked */
985         /* ASSERT:  nobody can be submitting urbs for this any more */
986
987 rescan:
988         spin_lock_irqsave (&ehci->lock, flags);
989         qh = ep->hcpriv;
990         if (!qh)
991                 goto done;
992
993         /* endpoints can be iso streams.  for now, we don't
994          * accelerate iso completions ... so spin a while.
995          */
996         if (qh->hw->hw_info1 == 0) {
997                 ehci_vdbg (ehci, "iso delay\n");
998                 goto idle_timeout;
999         }
1000
1001         if (!HC_IS_RUNNING (hcd->state))
1002                 qh->qh_state = QH_STATE_IDLE;
1003         switch (qh->qh_state) {
1004         case QH_STATE_LINKED:
1005                 for (tmp = ehci->async->qh_next.qh;
1006                                 tmp && tmp != qh;
1007                                 tmp = tmp->qh_next.qh)
1008                         continue;
1009                 /* periodic qh self-unlinks on empty */
1010                 if (!tmp)
1011                         goto nogood;
1012                 unlink_async (ehci, qh);
1013                 /* FALL THROUGH */
1014         case QH_STATE_UNLINK:           /* wait for hw to finish? */
1015         case QH_STATE_UNLINK_WAIT:
1016 idle_timeout:
1017                 spin_unlock_irqrestore (&ehci->lock, flags);
1018                 schedule_timeout_uninterruptible(1);
1019                 goto rescan;
1020         case QH_STATE_IDLE:             /* fully unlinked */
1021                 if (qh->clearing_tt)
1022                         goto idle_timeout;
1023                 if (list_empty (&qh->qtd_list)) {
1024                         qh_put (qh);
1025                         break;
1026                 }
1027                 /* else FALL THROUGH */
1028         default:
1029 nogood:
1030                 /* caller was supposed to have unlinked any requests;
1031                  * that's not our job.  just leak this memory.
1032                  */
1033                 ehci_err (ehci, "qh %p (#%02x) state %d%s\n",
1034                         qh, ep->desc.bEndpointAddress, qh->qh_state,
1035                         list_empty (&qh->qtd_list) ? "" : "(has tds)");
1036                 break;
1037         }
1038         ep->hcpriv = NULL;
1039 done:
1040         spin_unlock_irqrestore (&ehci->lock, flags);
1041         return;
1042 }
1043
1044 static void
1045 ehci_endpoint_reset(struct usb_hcd *hcd, struct usb_host_endpoint *ep)
1046 {
1047         struct ehci_hcd         *ehci = hcd_to_ehci(hcd);
1048         struct ehci_qh          *qh;
1049         int                     eptype = usb_endpoint_type(&ep->desc);
1050         int                     epnum = usb_endpoint_num(&ep->desc);
1051         int                     is_out = usb_endpoint_dir_out(&ep->desc);
1052         unsigned long           flags;
1053
1054         if (eptype != USB_ENDPOINT_XFER_BULK && eptype != USB_ENDPOINT_XFER_INT)
1055                 return;
1056
1057         spin_lock_irqsave(&ehci->lock, flags);
1058         qh = ep->hcpriv;
1059
1060         /* For Bulk and Interrupt endpoints we maintain the toggle state
1061          * in the hardware; the toggle bits in udev aren't used at all.
1062          * When an endpoint is reset by usb_clear_halt() we must reset
1063          * the toggle bit in the QH.
1064          */
1065         if (qh) {
1066                 usb_settoggle(qh->dev, epnum, is_out, 0);
1067                 if (!list_empty(&qh->qtd_list)) {
1068                         WARN_ONCE(1, "clear_halt for a busy endpoint\n");
1069                 } else if (qh->qh_state == QH_STATE_LINKED) {
1070
1071                         /* The toggle value in the QH can't be updated
1072                          * while the QH is active.  Unlink it now;
1073                          * re-linking will call qh_refresh().
1074                          */
1075                         if (eptype == USB_ENDPOINT_XFER_BULK) {
1076                                 unlink_async(ehci, qh);
1077                         } else {
1078                                 intr_deschedule(ehci, qh);
1079                                 (void) qh_schedule(ehci, qh);
1080                         }
1081                 }
1082         }
1083         spin_unlock_irqrestore(&ehci->lock, flags);
1084 }
1085
1086 static int ehci_get_frame (struct usb_hcd *hcd)
1087 {
1088         struct ehci_hcd         *ehci = hcd_to_ehci (hcd);
1089         return (ehci_readl(ehci, &ehci->regs->frame_index) >> 3) %
1090                 ehci->periodic_size;
1091 }
1092
1093 /*-------------------------------------------------------------------------*/
1094
1095 MODULE_DESCRIPTION(DRIVER_DESC);
1096 MODULE_AUTHOR (DRIVER_AUTHOR);
1097 MODULE_LICENSE ("GPL");
1098
1099 #ifdef CONFIG_PCI
1100 #include "ehci-pci.c"
1101 #define PCI_DRIVER              ehci_pci_driver
1102 #endif
1103
1104 #ifdef CONFIG_USB_EHCI_FSL
1105 #include "ehci-fsl.c"
1106 #define PLATFORM_DRIVER         ehci_fsl_driver
1107 #endif
1108
1109 #ifdef CONFIG_SOC_AU1200
1110 #include "ehci-au1xxx.c"
1111 #define PLATFORM_DRIVER         ehci_hcd_au1xxx_driver
1112 #endif
1113
1114 #ifdef CONFIG_PPC_PS3
1115 #include "ehci-ps3.c"
1116 #define PS3_SYSTEM_BUS_DRIVER   ps3_ehci_driver
1117 #endif
1118
1119 #ifdef CONFIG_USB_EHCI_HCD_PPC_OF
1120 #include "ehci-ppc-of.c"
1121 #define OF_PLATFORM_DRIVER      ehci_hcd_ppc_of_driver
1122 #endif
1123
1124 #ifdef CONFIG_PLAT_ORION
1125 #include "ehci-orion.c"
1126 #define PLATFORM_DRIVER         ehci_orion_driver
1127 #endif
1128
1129 #ifdef CONFIG_ARCH_IXP4XX
1130 #include "ehci-ixp4xx.c"
1131 #define PLATFORM_DRIVER         ixp4xx_ehci_driver
1132 #endif
1133
1134 #ifdef CONFIG_USB_W90X900_EHCI
1135 #include "ehci-w90x900.c"
1136 #define PLATFORM_DRIVER         ehci_hcd_w90x900_driver
1137 #endif
1138
1139 #ifdef CONFIG_ARCH_AT91
1140 #include "ehci-atmel.c"
1141 #define PLATFORM_DRIVER         ehci_atmel_driver
1142 #endif
1143
1144 #if !defined(PCI_DRIVER) && !defined(PLATFORM_DRIVER) && \
1145     !defined(PS3_SYSTEM_BUS_DRIVER) && !defined(OF_PLATFORM_DRIVER)
1146 #error "missing bus glue for ehci-hcd"
1147 #endif
1148
1149 static int __init ehci_hcd_init(void)
1150 {
1151         int retval = 0;
1152
1153         if (usb_disabled())
1154                 return -ENODEV;
1155
1156         printk(KERN_INFO "%s: " DRIVER_DESC "\n", hcd_name);
1157         set_bit(USB_EHCI_LOADED, &usb_hcds_loaded);
1158         if (test_bit(USB_UHCI_LOADED, &usb_hcds_loaded) ||
1159                         test_bit(USB_OHCI_LOADED, &usb_hcds_loaded))
1160                 printk(KERN_WARNING "Warning! ehci_hcd should always be loaded"
1161                                 " before uhci_hcd and ohci_hcd, not after\n");
1162
1163         pr_debug("%s: block sizes: qh %Zd qtd %Zd itd %Zd sitd %Zd\n",
1164                  hcd_name,
1165                  sizeof(struct ehci_qh), sizeof(struct ehci_qtd),
1166                  sizeof(struct ehci_itd), sizeof(struct ehci_sitd));
1167
1168 #ifdef DEBUG
1169         ehci_debug_root = debugfs_create_dir("ehci", usb_debug_root);
1170         if (!ehci_debug_root) {
1171                 retval = -ENOENT;
1172                 goto err_debug;
1173         }
1174 #endif
1175
1176 #ifdef PLATFORM_DRIVER
1177         retval = platform_driver_register(&PLATFORM_DRIVER);
1178         if (retval < 0)
1179                 goto clean0;
1180 #endif
1181
1182 #ifdef PCI_DRIVER
1183         retval = pci_register_driver(&PCI_DRIVER);
1184         if (retval < 0)
1185                 goto clean1;
1186 #endif
1187
1188 #ifdef PS3_SYSTEM_BUS_DRIVER
1189         retval = ps3_ehci_driver_register(&PS3_SYSTEM_BUS_DRIVER);
1190         if (retval < 0)
1191                 goto clean2;
1192 #endif
1193
1194 #ifdef OF_PLATFORM_DRIVER
1195         retval = of_register_platform_driver(&OF_PLATFORM_DRIVER);
1196         if (retval < 0)
1197                 goto clean3;
1198 #endif
1199         return retval;
1200
1201 #ifdef OF_PLATFORM_DRIVER
1202         /* of_unregister_platform_driver(&OF_PLATFORM_DRIVER); */
1203 clean3:
1204 #endif
1205 #ifdef PS3_SYSTEM_BUS_DRIVER
1206         ps3_ehci_driver_unregister(&PS3_SYSTEM_BUS_DRIVER);
1207 clean2:
1208 #endif
1209 #ifdef PCI_DRIVER
1210         pci_unregister_driver(&PCI_DRIVER);
1211 clean1:
1212 #endif
1213 #ifdef PLATFORM_DRIVER
1214         platform_driver_unregister(&PLATFORM_DRIVER);
1215 clean0:
1216 #endif
1217 #ifdef DEBUG
1218         debugfs_remove(ehci_debug_root);
1219         ehci_debug_root = NULL;
1220 err_debug:
1221 #endif
1222         clear_bit(USB_EHCI_LOADED, &usb_hcds_loaded);
1223         return retval;
1224 }
1225 module_init(ehci_hcd_init);
1226
1227 static void __exit ehci_hcd_cleanup(void)
1228 {
1229 #ifdef OF_PLATFORM_DRIVER
1230         of_unregister_platform_driver(&OF_PLATFORM_DRIVER);
1231 #endif
1232 #ifdef PLATFORM_DRIVER
1233         platform_driver_unregister(&PLATFORM_DRIVER);
1234 #endif
1235 #ifdef PCI_DRIVER
1236         pci_unregister_driver(&PCI_DRIVER);
1237 #endif
1238 #ifdef PS3_SYSTEM_BUS_DRIVER
1239         ps3_ehci_driver_unregister(&PS3_SYSTEM_BUS_DRIVER);
1240 #endif
1241 #ifdef DEBUG
1242         debugfs_remove(ehci_debug_root);
1243 #endif
1244         clear_bit(USB_EHCI_LOADED, &usb_hcds_loaded);
1245 }
1246 module_exit(ehci_hcd_cleanup);
1247