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