iwl3945: add debugfs support
[linux-2.6] / drivers / parport / ieee1284.c
1 /*
2  * IEEE-1284 implementation for parport.
3  *
4  * Authors: Phil Blundell <philb@gnu.org>
5  *          Carsten Gross <carsten@sol.wohnheim.uni-ulm.de>
6  *          Jose Renau <renau@acm.org>
7  *          Tim Waugh <tim@cyberelk.demon.co.uk> (largely rewritten)
8  *
9  * This file is responsible for IEEE 1284 negotiation, and for handing
10  * read/write requests to low-level drivers.
11  *
12  * Any part of this program may be used in documents licensed under
13  * the GNU Free Documentation License, Version 1.1 or any later version
14  * published by the Free Software Foundation.
15  *
16  * Various hacks, Fred Barnes <frmb2@ukc.ac.uk>, 04/2000
17  */
18
19 #include <linux/module.h>
20 #include <linux/threads.h>
21 #include <linux/parport.h>
22 #include <linux/delay.h>
23 #include <linux/kernel.h>
24 #include <linux/interrupt.h>
25 #include <linux/timer.h>
26 #include <linux/sched.h>
27
28 #undef DEBUG /* undef me for production */
29
30 #ifdef CONFIG_LP_CONSOLE
31 #undef DEBUG /* Don't want a garbled console */
32 #endif
33
34 #ifdef DEBUG
35 #define DPRINTK(stuff...) printk (stuff)
36 #else
37 #define DPRINTK(stuff...)
38 #endif
39
40 /* Make parport_wait_peripheral wake up.
41  * It will be useful to call this from an interrupt handler. */
42 static void parport_ieee1284_wakeup (struct parport *port)
43 {
44         up (&port->physport->ieee1284.irq);
45 }
46
47 static struct parport *port_from_cookie[PARPORT_MAX];
48 static void timeout_waiting_on_port (unsigned long cookie)
49 {
50         parport_ieee1284_wakeup (port_from_cookie[cookie % PARPORT_MAX]);
51 }
52
53 /**
54  *      parport_wait_event - wait for an event on a parallel port
55  *      @port: port to wait on
56  *      @timeout: time to wait (in jiffies)
57  *
58  *      This function waits for up to @timeout jiffies for an
59  *      interrupt to occur on a parallel port.  If the port timeout is
60  *      set to zero, it returns immediately.
61  *
62  *      If an interrupt occurs before the timeout period elapses, this
63  *      function returns zero immediately.  If it times out, it returns
64  *      one.  An error code less than zero indicates an error (most
65  *      likely a pending signal), and the calling code should finish
66  *      what it's doing as soon as it can.
67  */
68
69 int parport_wait_event (struct parport *port, signed long timeout)
70 {
71         int ret;
72         struct timer_list timer;
73
74         if (!port->physport->cad->timeout)
75                 /* Zero timeout is special, and we can't down() the
76                    semaphore. */
77                 return 1;
78
79         init_timer_on_stack(&timer);
80         timer.expires = jiffies + timeout;
81         timer.function = timeout_waiting_on_port;
82         port_from_cookie[port->number % PARPORT_MAX] = port;
83         timer.data = port->number;
84
85         add_timer (&timer);
86         ret = down_interruptible (&port->physport->ieee1284.irq);
87         if (!del_timer (&timer) && !ret)
88                 /* Timed out. */
89                 ret = 1;
90
91         destroy_timer_on_stack(&timer);
92
93         return ret;
94 }
95
96 /**
97  *      parport_poll_peripheral - poll status lines
98  *      @port: port to watch
99  *      @mask: status lines to watch
100  *      @result: desired values of chosen status lines
101  *      @usec: timeout
102  *
103  *      This function busy-waits until the masked status lines have
104  *      the desired values, or until the timeout period elapses.  The
105  *      @mask and @result parameters are bitmasks, with the bits
106  *      defined by the constants in parport.h: %PARPORT_STATUS_BUSY,
107  *      and so on.
108  *
109  *      This function does not call schedule(); instead it busy-waits
110  *      using udelay().  It currently has a resolution of 5usec.
111  *
112  *      If the status lines take on the desired values before the
113  *      timeout period elapses, parport_poll_peripheral() returns zero
114  *      immediately.  A return value greater than zero indicates
115  *      a timeout.  An error code (less than zero) indicates an error,
116  *      most likely a signal that arrived, and the caller should
117  *      finish what it is doing as soon as possible.
118 */
119
120 int parport_poll_peripheral(struct parport *port,
121                             unsigned char mask,
122                             unsigned char result,
123                             int usec)
124 {
125         /* Zero return code is success, >0 is timeout. */
126         int count = usec / 5 + 2;
127         int i;
128         unsigned char status;
129         for (i = 0; i < count; i++) {
130                 status = parport_read_status (port);
131                 if ((status & mask) == result)
132                         return 0;
133                 if (signal_pending (current))
134                         return -EINTR;
135                 if (need_resched())
136                         break;
137                 if (i >= 2)
138                         udelay (5);
139         }
140
141         return 1;
142 }
143
144 /**
145  *      parport_wait_peripheral - wait for status lines to change in 35ms
146  *      @port: port to watch
147  *      @mask: status lines to watch
148  *      @result: desired values of chosen status lines
149  *
150  *      This function waits until the masked status lines have the
151  *      desired values, or until 35ms have elapsed (see IEEE 1284-1994
152  *      page 24 to 25 for why this value in particular is hardcoded).
153  *      The @mask and @result parameters are bitmasks, with the bits
154  *      defined by the constants in parport.h: %PARPORT_STATUS_BUSY,
155  *      and so on.
156  *
157  *      The port is polled quickly to start off with, in anticipation
158  *      of a fast response from the peripheral.  This fast polling
159  *      time is configurable (using /proc), and defaults to 500usec.
160  *      If the timeout for this port (see parport_set_timeout()) is
161  *      zero, the fast polling time is 35ms, and this function does
162  *      not call schedule().
163  *
164  *      If the timeout for this port is non-zero, after the fast
165  *      polling fails it uses parport_wait_event() to wait for up to
166  *      10ms, waking up if an interrupt occurs.
167  */
168
169 int parport_wait_peripheral(struct parport *port,
170                             unsigned char mask, 
171                             unsigned char result)
172 {
173         int ret;
174         int usec;
175         unsigned long deadline;
176         unsigned char status;
177
178         usec = port->physport->spintime; /* usecs of fast polling */
179         if (!port->physport->cad->timeout)
180                 /* A zero timeout is "special": busy wait for the
181                    entire 35ms. */
182                 usec = 35000;
183
184         /* Fast polling.
185          *
186          * This should be adjustable.
187          * How about making a note (in the device structure) of how long
188          * it takes, so we know for next time?
189          */
190         ret = parport_poll_peripheral (port, mask, result, usec);
191         if (ret != 1)
192                 return ret;
193
194         if (!port->physport->cad->timeout)
195                 /* We may be in an interrupt handler, so we can't poll
196                  * slowly anyway. */
197                 return 1;
198
199         /* 40ms of slow polling. */
200         deadline = jiffies + msecs_to_jiffies(40);
201         while (time_before (jiffies, deadline)) {
202                 if (signal_pending (current))
203                         return -EINTR;
204
205                 /* Wait for 10ms (or until an interrupt occurs if
206                  * the handler is set) */
207                 if ((ret = parport_wait_event (port, msecs_to_jiffies(10))) < 0)
208                         return ret;
209
210                 status = parport_read_status (port);
211                 if ((status & mask) == result)
212                         return 0;
213
214                 if (!ret) {
215                         /* parport_wait_event didn't time out, but the
216                          * peripheral wasn't actually ready either.
217                          * Wait for another 10ms. */
218                         schedule_timeout_interruptible(msecs_to_jiffies(10));
219                 }
220         }
221
222         return 1;
223 }
224
225 #ifdef CONFIG_PARPORT_1284
226 /* Terminate a negotiated mode. */
227 static void parport_ieee1284_terminate (struct parport *port)
228 {
229         int r;
230         port = port->physport;
231
232         /* EPP terminates differently. */
233         switch (port->ieee1284.mode) {
234         case IEEE1284_MODE_EPP:
235         case IEEE1284_MODE_EPPSL:
236         case IEEE1284_MODE_EPPSWE:
237                 /* Terminate from EPP mode. */
238
239                 /* Event 68: Set nInit low */
240                 parport_frob_control (port, PARPORT_CONTROL_INIT, 0);
241                 udelay (50);
242
243                 /* Event 69: Set nInit high, nSelectIn low */
244                 parport_frob_control (port,
245                                       PARPORT_CONTROL_SELECT
246                                       | PARPORT_CONTROL_INIT,
247                                       PARPORT_CONTROL_SELECT
248                                       | PARPORT_CONTROL_INIT);
249                 break;
250
251         case IEEE1284_MODE_ECP:
252         case IEEE1284_MODE_ECPRLE:
253         case IEEE1284_MODE_ECPSWE:
254                 /* In ECP we can only terminate from fwd idle phase. */
255                 if (port->ieee1284.phase != IEEE1284_PH_FWD_IDLE) {
256                         /* Event 47: Set nInit high */
257                         parport_frob_control (port,
258                                               PARPORT_CONTROL_INIT
259                                               | PARPORT_CONTROL_AUTOFD,
260                                               PARPORT_CONTROL_INIT
261                                               | PARPORT_CONTROL_AUTOFD);
262
263                         /* Event 49: PError goes high */
264                         r = parport_wait_peripheral (port,
265                                                      PARPORT_STATUS_PAPEROUT,
266                                                      PARPORT_STATUS_PAPEROUT);
267                         if (r)
268                                 DPRINTK (KERN_INFO "%s: Timeout at event 49\n",
269                                          port->name);
270
271                         parport_data_forward (port);
272                         DPRINTK (KERN_DEBUG "%s: ECP direction: forward\n",
273                                  port->name);
274                         port->ieee1284.phase = IEEE1284_PH_FWD_IDLE;
275                 }
276
277                 /* fall-though.. */
278
279         default:
280                 /* Terminate from all other modes. */
281
282                 /* Event 22: Set nSelectIn low, nAutoFd high */
283                 parport_frob_control (port,
284                                       PARPORT_CONTROL_SELECT
285                                       | PARPORT_CONTROL_AUTOFD,
286                                       PARPORT_CONTROL_SELECT);
287
288                 /* Event 24: nAck goes low */
289                 r = parport_wait_peripheral (port, PARPORT_STATUS_ACK, 0);
290                 if (r)
291                         DPRINTK (KERN_INFO "%s: Timeout at event 24\n",
292                                  port->name);
293
294                 /* Event 25: Set nAutoFd low */
295                 parport_frob_control (port,
296                                       PARPORT_CONTROL_AUTOFD,
297                                       PARPORT_CONTROL_AUTOFD);
298
299                 /* Event 27: nAck goes high */
300                 r = parport_wait_peripheral (port,
301                                              PARPORT_STATUS_ACK, 
302                                              PARPORT_STATUS_ACK);
303                 if (r)
304                         DPRINTK (KERN_INFO "%s: Timeout at event 27\n",
305                                  port->name);
306
307                 /* Event 29: Set nAutoFd high */
308                 parport_frob_control (port, PARPORT_CONTROL_AUTOFD, 0);
309         }
310
311         port->ieee1284.mode = IEEE1284_MODE_COMPAT;
312         port->ieee1284.phase = IEEE1284_PH_FWD_IDLE;
313
314         DPRINTK (KERN_DEBUG "%s: In compatibility (forward idle) mode\n",
315                  port->name);
316 }               
317 #endif /* IEEE1284 support */
318
319 /**
320  *      parport_negotiate - negotiate an IEEE 1284 mode
321  *      @port: port to use
322  *      @mode: mode to negotiate to
323  *
324  *      Use this to negotiate to a particular IEEE 1284 transfer mode.
325  *      The @mode parameter should be one of the constants in
326  *      parport.h starting %IEEE1284_MODE_xxx.
327  *
328  *      The return value is 0 if the peripheral has accepted the
329  *      negotiation to the mode specified, -1 if the peripheral is not
330  *      IEEE 1284 compliant (or not present), or 1 if the peripheral
331  *      has rejected the negotiation.
332  */
333
334 int parport_negotiate (struct parport *port, int mode)
335 {
336 #ifndef CONFIG_PARPORT_1284
337         if (mode == IEEE1284_MODE_COMPAT)
338                 return 0;
339         printk (KERN_ERR "parport: IEEE1284 not supported in this kernel\n");
340         return -1;
341 #else
342         int m = mode & ~IEEE1284_ADDR;
343         int r;
344         unsigned char xflag;
345
346         port = port->physport;
347
348         /* Is there anything to do? */
349         if (port->ieee1284.mode == mode)
350                 return 0;
351
352         /* Is the difference just an address-or-not bit? */
353         if ((port->ieee1284.mode & ~IEEE1284_ADDR) == (mode & ~IEEE1284_ADDR)){
354                 port->ieee1284.mode = mode;
355                 return 0;
356         }
357
358         /* Go to compability forward idle mode */
359         if (port->ieee1284.mode != IEEE1284_MODE_COMPAT)
360                 parport_ieee1284_terminate (port);
361
362         if (mode == IEEE1284_MODE_COMPAT)
363                 /* Compatibility mode: no negotiation. */
364                 return 0; 
365
366         switch (mode) {
367         case IEEE1284_MODE_ECPSWE:
368                 m = IEEE1284_MODE_ECP;
369                 break;
370         case IEEE1284_MODE_EPPSL:
371         case IEEE1284_MODE_EPPSWE:
372                 m = IEEE1284_MODE_EPP;
373                 break;
374         case IEEE1284_MODE_BECP:
375                 return -ENOSYS; /* FIXME (implement BECP) */
376         }
377
378         if (mode & IEEE1284_EXT_LINK)
379                 m = 1<<7; /* request extensibility link */
380
381         port->ieee1284.phase = IEEE1284_PH_NEGOTIATION;
382
383         /* Start off with nStrobe and nAutoFd high, and nSelectIn low */
384         parport_frob_control (port,
385                               PARPORT_CONTROL_STROBE
386                               | PARPORT_CONTROL_AUTOFD
387                               | PARPORT_CONTROL_SELECT,
388                               PARPORT_CONTROL_SELECT);
389         udelay(1);
390
391         /* Event 0: Set data */
392         parport_data_forward (port);
393         parport_write_data (port, m);
394         udelay (400); /* Shouldn't need to wait this long. */
395
396         /* Event 1: Set nSelectIn high, nAutoFd low */
397         parport_frob_control (port,
398                               PARPORT_CONTROL_SELECT
399                               | PARPORT_CONTROL_AUTOFD,
400                               PARPORT_CONTROL_AUTOFD);
401
402         /* Event 2: PError, Select, nFault go high, nAck goes low */
403         if (parport_wait_peripheral (port,
404                                      PARPORT_STATUS_ERROR
405                                      | PARPORT_STATUS_SELECT
406                                      | PARPORT_STATUS_PAPEROUT
407                                      | PARPORT_STATUS_ACK,
408                                      PARPORT_STATUS_ERROR
409                                      | PARPORT_STATUS_SELECT
410                                      | PARPORT_STATUS_PAPEROUT)) {
411                 /* Timeout */
412                 parport_frob_control (port,
413                                       PARPORT_CONTROL_SELECT
414                                       | PARPORT_CONTROL_AUTOFD,
415                                       PARPORT_CONTROL_SELECT);
416                 DPRINTK (KERN_DEBUG
417                          "%s: Peripheral not IEEE1284 compliant (0x%02X)\n",
418                          port->name, parport_read_status (port));
419                 port->ieee1284.phase = IEEE1284_PH_FWD_IDLE;
420                 return -1; /* Not IEEE1284 compliant */
421         }
422
423         /* Event 3: Set nStrobe low */
424         parport_frob_control (port,
425                               PARPORT_CONTROL_STROBE,
426                               PARPORT_CONTROL_STROBE);
427
428         /* Event 4: Set nStrobe and nAutoFd high */
429         udelay (5);
430         parport_frob_control (port,
431                               PARPORT_CONTROL_STROBE
432                               | PARPORT_CONTROL_AUTOFD,
433                               0);
434
435         /* Event 6: nAck goes high */
436         if (parport_wait_peripheral (port,
437                                      PARPORT_STATUS_ACK,
438                                      PARPORT_STATUS_ACK)) {
439                 /* This shouldn't really happen with a compliant device. */
440                 DPRINTK (KERN_DEBUG
441                          "%s: Mode 0x%02x not supported? (0x%02x)\n",
442                          port->name, mode, port->ops->read_status (port));
443                 parport_ieee1284_terminate (port);
444                 return 1;
445         }
446
447         xflag = parport_read_status (port) & PARPORT_STATUS_SELECT;
448
449         /* xflag should be high for all modes other than nibble (0). */
450         if (mode && !xflag) {
451                 /* Mode not supported. */
452                 DPRINTK (KERN_DEBUG "%s: Mode 0x%02x rejected by peripheral\n",
453                          port->name, mode);
454                 parport_ieee1284_terminate (port);
455                 return 1;
456         }
457
458         /* More to do if we've requested extensibility link. */
459         if (mode & IEEE1284_EXT_LINK) {
460                 m = mode & 0x7f;
461                 udelay (1);
462                 parport_write_data (port, m);
463                 udelay (1);
464
465                 /* Event 51: Set nStrobe low */
466                 parport_frob_control (port,
467                                       PARPORT_CONTROL_STROBE,
468                                       PARPORT_CONTROL_STROBE);
469
470                 /* Event 52: nAck goes low */
471                 if (parport_wait_peripheral (port, PARPORT_STATUS_ACK, 0)) {
472                         /* This peripheral is _very_ slow. */
473                         DPRINTK (KERN_DEBUG
474                                  "%s: Event 52 didn't happen\n",
475                                  port->name);
476                         parport_ieee1284_terminate (port);
477                         return 1;
478                 }
479
480                 /* Event 53: Set nStrobe high */
481                 parport_frob_control (port,
482                                       PARPORT_CONTROL_STROBE,
483                                       0);
484
485                 /* Event 55: nAck goes high */
486                 if (parport_wait_peripheral (port,
487                                              PARPORT_STATUS_ACK,
488                                              PARPORT_STATUS_ACK)) {
489                         /* This shouldn't really happen with a compliant
490                          * device. */
491                         DPRINTK (KERN_DEBUG
492                                  "%s: Mode 0x%02x not supported? (0x%02x)\n",
493                                  port->name, mode,
494                                  port->ops->read_status (port));
495                         parport_ieee1284_terminate (port);
496                         return 1;
497                 }
498
499                 /* Event 54: Peripheral sets XFlag to reflect support */
500                 xflag = parport_read_status (port) & PARPORT_STATUS_SELECT;
501
502                 /* xflag should be high. */
503                 if (!xflag) {
504                         /* Extended mode not supported. */
505                         DPRINTK (KERN_DEBUG "%s: Extended mode 0x%02x not "
506                                  "supported\n", port->name, mode);
507                         parport_ieee1284_terminate (port);
508                         return 1;
509                 }
510
511                 /* Any further setup is left to the caller. */
512         }
513
514         /* Mode is supported */
515         DPRINTK (KERN_DEBUG "%s: In mode 0x%02x\n", port->name, mode);
516         port->ieee1284.mode = mode;
517
518         /* But ECP is special */
519         if (!(mode & IEEE1284_EXT_LINK) && (m & IEEE1284_MODE_ECP)) {
520                 port->ieee1284.phase = IEEE1284_PH_ECP_SETUP;
521
522                 /* Event 30: Set nAutoFd low */
523                 parport_frob_control (port,
524                                       PARPORT_CONTROL_AUTOFD,
525                                       PARPORT_CONTROL_AUTOFD);
526
527                 /* Event 31: PError goes high. */
528                 r = parport_wait_peripheral (port,
529                                              PARPORT_STATUS_PAPEROUT,
530                                              PARPORT_STATUS_PAPEROUT);
531                 if (r) {
532                         DPRINTK (KERN_INFO "%s: Timeout at event 31\n",
533                                 port->name);
534                 }
535
536                 port->ieee1284.phase = IEEE1284_PH_FWD_IDLE;
537                 DPRINTK (KERN_DEBUG "%s: ECP direction: forward\n",
538                          port->name);
539         } else switch (mode) {
540         case IEEE1284_MODE_NIBBLE:
541         case IEEE1284_MODE_BYTE:
542                 port->ieee1284.phase = IEEE1284_PH_REV_IDLE;
543                 break;
544         default:
545                 port->ieee1284.phase = IEEE1284_PH_FWD_IDLE;
546         }
547
548
549         return 0;
550 #endif /* IEEE1284 support */
551 }
552
553 /* Acknowledge that the peripheral has data available.
554  * Events 18-20, in order to get from Reverse Idle phase
555  * to Host Busy Data Available.
556  * This will most likely be called from an interrupt.
557  * Returns zero if data was available.
558  */
559 #ifdef CONFIG_PARPORT_1284
560 static int parport_ieee1284_ack_data_avail (struct parport *port)
561 {
562         if (parport_read_status (port) & PARPORT_STATUS_ERROR)
563                 /* Event 18 didn't happen. */
564                 return -1;
565
566         /* Event 20: nAutoFd goes high. */
567         port->ops->frob_control (port, PARPORT_CONTROL_AUTOFD, 0);
568         port->ieee1284.phase = IEEE1284_PH_HBUSY_DAVAIL;
569         return 0;
570 }
571 #endif /* IEEE1284 support */
572
573 /* Handle an interrupt. */
574 void parport_ieee1284_interrupt (void *handle)
575 {
576         struct parport *port = handle;
577         parport_ieee1284_wakeup (port);
578
579 #ifdef CONFIG_PARPORT_1284
580         if (port->ieee1284.phase == IEEE1284_PH_REV_IDLE) {
581                 /* An interrupt in this phase means that data
582                  * is now available. */
583                 DPRINTK (KERN_DEBUG "%s: Data available\n", port->name);
584                 parport_ieee1284_ack_data_avail (port);
585         }
586 #endif /* IEEE1284 support */
587 }
588
589 /**
590  *      parport_write - write a block of data to a parallel port
591  *      @port: port to write to
592  *      @buffer: data buffer (in kernel space)
593  *      @len: number of bytes of data to transfer
594  *
595  *      This will write up to @len bytes of @buffer to the port
596  *      specified, using the IEEE 1284 transfer mode most recently
597  *      negotiated to (using parport_negotiate()), as long as that
598  *      mode supports forward transfers (host to peripheral).
599  *
600  *      It is the caller's responsibility to ensure that the first
601  *      @len bytes of @buffer are valid.
602  *
603  *      This function returns the number of bytes transferred (if zero
604  *      or positive), or else an error code.
605  */
606
607 ssize_t parport_write (struct parport *port, const void *buffer, size_t len)
608 {
609 #ifndef CONFIG_PARPORT_1284
610         return port->ops->compat_write_data (port, buffer, len, 0);
611 #else
612         ssize_t retval;
613         int mode = port->ieee1284.mode;
614         int addr = mode & IEEE1284_ADDR;
615         size_t (*fn) (struct parport *, const void *, size_t, int);
616
617         /* Ignore the device-ID-request bit and the address bit. */
618         mode &= ~(IEEE1284_DEVICEID | IEEE1284_ADDR);
619
620         /* Use the mode we're in. */
621         switch (mode) {
622         case IEEE1284_MODE_NIBBLE:
623         case IEEE1284_MODE_BYTE:
624                 parport_negotiate (port, IEEE1284_MODE_COMPAT);
625         case IEEE1284_MODE_COMPAT:
626                 DPRINTK (KERN_DEBUG "%s: Using compatibility mode\n",
627                          port->name);
628                 fn = port->ops->compat_write_data;
629                 break;
630
631         case IEEE1284_MODE_EPP:
632                 DPRINTK (KERN_DEBUG "%s: Using EPP mode\n", port->name);
633                 if (addr) {
634                         fn = port->ops->epp_write_addr;
635                 } else {
636                         fn = port->ops->epp_write_data;
637                 }
638                 break;
639         case IEEE1284_MODE_EPPSWE:
640                 DPRINTK (KERN_DEBUG "%s: Using software-emulated EPP mode\n",
641                         port->name);
642                 if (addr) {
643                         fn = parport_ieee1284_epp_write_addr;
644                 } else {
645                         fn = parport_ieee1284_epp_write_data;
646                 }
647                 break;
648         case IEEE1284_MODE_ECP:
649         case IEEE1284_MODE_ECPRLE:
650                 DPRINTK (KERN_DEBUG "%s: Using ECP mode\n", port->name);
651                 if (addr) {
652                         fn = port->ops->ecp_write_addr;
653                 } else {
654                         fn = port->ops->ecp_write_data;
655                 }
656                 break;
657
658         case IEEE1284_MODE_ECPSWE:
659                 DPRINTK (KERN_DEBUG "%s: Using software-emulated ECP mode\n",
660                          port->name);
661                 /* The caller has specified that it must be emulated,
662                  * even if we have ECP hardware! */
663                 if (addr) {
664                         fn = parport_ieee1284_ecp_write_addr;
665                 } else {
666                         fn = parport_ieee1284_ecp_write_data;
667                 }
668                 break;
669
670         default:
671                 DPRINTK (KERN_DEBUG "%s: Unknown mode 0x%02x\n", port->name,
672                         port->ieee1284.mode);
673                 return -ENOSYS;
674         }
675
676         retval = (*fn) (port, buffer, len, 0);
677         DPRINTK (KERN_DEBUG "%s: wrote %d/%d bytes\n", port->name, retval, len);
678         return retval;
679 #endif /* IEEE1284 support */
680 }
681
682 /**
683  *      parport_read - read a block of data from a parallel port
684  *      @port: port to read from
685  *      @buffer: data buffer (in kernel space)
686  *      @len: number of bytes of data to transfer
687  *
688  *      This will read up to @len bytes of @buffer to the port
689  *      specified, using the IEEE 1284 transfer mode most recently
690  *      negotiated to (using parport_negotiate()), as long as that
691  *      mode supports reverse transfers (peripheral to host).
692  *
693  *      It is the caller's responsibility to ensure that the first
694  *      @len bytes of @buffer are available to write to.
695  *
696  *      This function returns the number of bytes transferred (if zero
697  *      or positive), or else an error code.
698  */
699
700 ssize_t parport_read (struct parport *port, void *buffer, size_t len)
701 {
702 #ifndef CONFIG_PARPORT_1284
703         printk (KERN_ERR "parport: IEEE1284 not supported in this kernel\n");
704         return -ENODEV;
705 #else
706         int mode = port->physport->ieee1284.mode;
707         int addr = mode & IEEE1284_ADDR;
708         size_t (*fn) (struct parport *, void *, size_t, int);
709
710         /* Ignore the device-ID-request bit and the address bit. */
711         mode &= ~(IEEE1284_DEVICEID | IEEE1284_ADDR);
712
713         /* Use the mode we're in. */
714         switch (mode) {
715         case IEEE1284_MODE_COMPAT:
716                 /* if we can tri-state use BYTE mode instead of NIBBLE mode,
717                  * if that fails, revert to NIBBLE mode -- ought to store somewhere
718                  * the device's ability to do BYTE mode reverse transfers, so we don't
719                  * end up needlessly calling negotiate(BYTE) repeately..  (fb)
720                  */
721                 if ((port->physport->modes & PARPORT_MODE_TRISTATE) &&
722                     !parport_negotiate (port, IEEE1284_MODE_BYTE)) {
723                         /* got into BYTE mode OK */
724                         DPRINTK (KERN_DEBUG "%s: Using byte mode\n", port->name);
725                         fn = port->ops->byte_read_data;
726                         break;
727                 }
728                 if (parport_negotiate (port, IEEE1284_MODE_NIBBLE)) {
729                         return -EIO;
730                 }
731                 /* fall through to NIBBLE */
732         case IEEE1284_MODE_NIBBLE:
733                 DPRINTK (KERN_DEBUG "%s: Using nibble mode\n", port->name);
734                 fn = port->ops->nibble_read_data;
735                 break;
736
737         case IEEE1284_MODE_BYTE:
738                 DPRINTK (KERN_DEBUG "%s: Using byte mode\n", port->name);
739                 fn = port->ops->byte_read_data;
740                 break;
741
742         case IEEE1284_MODE_EPP:
743                 DPRINTK (KERN_DEBUG "%s: Using EPP mode\n", port->name);
744                 if (addr) {
745                         fn = port->ops->epp_read_addr;
746                 } else {
747                         fn = port->ops->epp_read_data;
748                 }
749                 break;
750         case IEEE1284_MODE_EPPSWE:
751                 DPRINTK (KERN_DEBUG "%s: Using software-emulated EPP mode\n",
752                         port->name);
753                 if (addr) {
754                         fn = parport_ieee1284_epp_read_addr;
755                 } else {
756                         fn = parport_ieee1284_epp_read_data;
757                 }
758                 break;
759         case IEEE1284_MODE_ECP:
760         case IEEE1284_MODE_ECPRLE:
761                 DPRINTK (KERN_DEBUG "%s: Using ECP mode\n", port->name);
762                 fn = port->ops->ecp_read_data;
763                 break;
764
765         case IEEE1284_MODE_ECPSWE:
766                 DPRINTK (KERN_DEBUG "%s: Using software-emulated ECP mode\n",
767                          port->name);
768                 fn = parport_ieee1284_ecp_read_data;
769                 break;
770
771         default:
772                 DPRINTK (KERN_DEBUG "%s: Unknown mode 0x%02x\n", port->name,
773                          port->physport->ieee1284.mode);
774                 return -ENOSYS;
775         }
776
777         return (*fn) (port, buffer, len, 0);
778 #endif /* IEEE1284 support */
779 }
780
781 /**
782  *      parport_set_timeout - set the inactivity timeout for a device
783  *      @dev: device on a port
784  *      @inactivity: inactivity timeout (in jiffies)
785  *
786  *      This sets the inactivity timeout for a particular device on a
787  *      port.  This affects functions like parport_wait_peripheral().
788  *      The special value 0 means not to call schedule() while dealing
789  *      with this device.
790  *
791  *      The return value is the previous inactivity timeout.
792  *
793  *      Any callers of parport_wait_event() for this device are woken
794  *      up.
795  */
796
797 long parport_set_timeout (struct pardevice *dev, long inactivity)
798 {
799         long int old = dev->timeout;
800
801         dev->timeout = inactivity;
802
803         if (dev->port->physport->cad == dev)
804                 parport_ieee1284_wakeup (dev->port);
805
806         return old;
807 }
808
809 /* Exported symbols for modules. */
810
811 EXPORT_SYMBOL(parport_negotiate);
812 EXPORT_SYMBOL(parport_write);
813 EXPORT_SYMBOL(parport_read);
814 EXPORT_SYMBOL(parport_wait_peripheral);
815 EXPORT_SYMBOL(parport_wait_event);
816 EXPORT_SYMBOL(parport_set_timeout);
817 EXPORT_SYMBOL(parport_ieee1284_interrupt);