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