home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 29 Fixes_o / 29-Fixes_o.zip / print01.zip / readme.txt < prev   
Text File  |  2002-05-03  |  8KB  |  183 lines
  1. Parallel Port Device Driver with PCI support README
  2. Version 1.23
  3. March 19, 2002
  4.  
  5.     Contents
  6.     ========
  7. 1.0 Introduction
  8. 2.0 Installation Instructions
  9. 3.0 The PCIDEV.TBL file
  10. 4.0 Copyright and Trademark Information
  11.  
  12. 1.0 Introduction
  13.     ============
  14. The OS/2 Parallel Port Device Driver (PP DD) is a base DD that supports
  15. the PP interface for OS/2. There are two distinct versions of the PP DD:
  16. - PRINT01.SYS supporting PPs on (Extended) Industry Standard Architecture
  17.               (ISA/EISA) and Peripheral Component Interconnect (PCI) PCs,
  18. - PRINT02.SYS supporting PPs on Micro Channel Architecture (MCA) PCs.
  19. Only one of these PP DDs will be resident for each PC running in OS/2.
  20.  
  21. The PRINT01.SYS DD is modified to support PCI PPs. The PP DD supports
  22. up to three PCI PPs in the Standard Parallel Port (SPP) mode.
  23.  
  24. By default the OS/2 PP DD uses the polling transmission method. If the
  25. transmission protocol is changed to the interrupt method by specifying
  26. the /IRQ parameter in the BASEDEV= command, then the PP DD supports PCI
  27. PPs in an interrupt-driven manner.
  28.  
  29. In this case the PP DD attempts to set interrupt service routine (ISR)
  30. for PCI IRQ to be not-shared at task time. If this attempt fails then
  31. the PP DD sets ISR for PCI IRQ to be shared.
  32.  
  33. If the /SHR parameter is specified then the PP DD sets ISRs for PCI IRQs
  34. to be shared at initialization time.
  35.  
  36. Interrupt sharing at the PP DD interrupt time is handled using interrupt
  37. pending (occured) bit in the PCI PP status register.
  38.  
  39. 2.0 Installation Instructions
  40.     =========================
  41. The OS/2 PP DD with PCI support software consists of the following files:
  42. - PRINT01.SYS           the PP DD with PCI support,
  43. - PRTPCI.DDP            the PP DD Profile,
  44. - PCIDEV.TBL            the PCI Device configuration file (see 3.0),
  45. - README.TXT            this file that you are reading.
  46.  
  47. Because the PP DD is a base DD, OS/2 determines the system's hardware
  48. configuration and automatically installs and initializes the appropriate
  49. PP DD. OS/2 adds a BASEDEV= command without parameters for the PP DD to
  50. the CONFIG.SYS file.
  51.  
  52. The installation of the PP DD with PCI support is performed by replacing
  53. the old PRINT01.SYS file in the directory \OS2\BOOT with the new file and
  54. by copying the PCIDEV.TBL file in the directory \OS2\BOOT. System has to
  55. be rebooted for changes to take effect.
  56.  
  57. To perform the above operations the OS/2 DD Installation command (DDINSTAL)
  58. can be used:
  59. - Copy the OS/2 PP DD with PCI support files (see above) to the Device
  60.   Support diskette or directory.
  61. - Open an OS/2 window and enter DDINSTAL command to display the DD
  62.   Installation window.
  63. - Set in the Source directory field the Device Support diskette or
  64.   directory.
  65. - Select Install if the Source directory and Destination directory are
  66.   correct and you are ready to install the PP DD with PCI support.
  67. - Verify BASEDEV=PRINT01.SYS command in the CONFIG.SYS file and add/change
  68.   its parameters if necessary. We recommend that you set the /F parameter
  69.   because not all PCI cards with PPs are described the PCIDEV.TBL file,
  70.   and the driver will probably do a better job of automatically self
  71.   configuring than you can do using the PCIDEV.TBL file.
  72. - Reboot the oprating system.
  73.  
  74. The PP DD with PCI support accepts seven BASEDEV= command parameters: three
  75. legacy parameters (/IRQ, /MPL, and /TOU:xxx) and four additional parameters:
  76. /SHR    SHaRed interrupt-driven mode to service IRQs as shared.
  77. /V    Verbose mode
  78.         to display driver information about all accepted for service PPs.
  79. /W    Wait verbose mode.
  80.         Displaying pauses  with a "Press Enter to continue..." message.
  81. /F    Find PPs on PCI combo (serial/parallel) cards automatically.
  82.  
  83. /TOU:xxx       set initial device time-out value in seconds (default - 120s),
  84.         this value can be changed from printer port settings dialogue
  85.         if port driver is installed.
  86. /MPC        modifies polling procedure - makes it less processor resource
  87.         consuming by scheduling other systems tasks at certain print
  88.         points, may decrease print speed.
  89. /IRQ        enables interrupt driven printing, if not specified driver uses
  90.         register polling - fast, but more processor power consuming
  91.         method.
  92.  
  93. The /SHR parameter in conjunction with /IRQ parameter directs the PP DD
  94. to service PCI IRQs as shared.
  95.  
  96. NOTE: If your printer (for example, old dot matrix printer) generates
  97. IRQs without setting interrupt pending (occured) bit in PCI PP status
  98. register correctly then you cannot use PCI IRQ sharing and must not use
  99. /SHR parameter.
  100.  
  101. Not all of the installed PPs are sometimes accepted for service. For example,
  102. if the total number of installed PPs exceeds 3, then only 3 PPs are accepted
  103. for service. Also, if a PCI PP is not working properly, or if a PP on PCI
  104. combo card is not described in the PCIDEV.TBL file and the parameter /F is
  105. not set, then such PCI PP would not be accepted for service as well.
  106.  
  107. This version of the PP DD supports PPs on PCI Parallel and PCI combo cards
  108. that are described in the PCIDEV.TBL file and/or identified by PCI device class
  109. code: Base Class = 0x07 - simple communications controllers, Sub-Class = 0x01 -
  110. PPs, and, if the parameter /F is set, Sub-Class = 0x80 - other communications
  111. device (Encodings for class codes are provided in the PCI Local Bus
  112. Specification, Revision 2.2, Appendix D).
  113.  
  114. 3.0 The PCIDEV.TBL file
  115.     ===================
  116. The PCIDEV.TBL file is a text file that describes PPs on PCI cards,
  117. including PCI combo cards, on Vendor ID / Device ID basis and  must be in
  118. the directory D:\OS2\BOOT, where D: is the drive where OS/2 is installed.
  119.  
  120. The documentation for the PCI Device configuration file is located in the
  121. PCIDEV.TBL file comments:
  122. ;
  123. ; this file identifies serial, parallel and combo PCI devices
  124. ; and defines the usage of the particular pci registers
  125. ; this data is not available in the system without
  126. ; external help
  127. ;
  128. ; the syntax of this file is as follow
  129. ;
  130. ; a line starting with ';' or '#' is considered a comment
  131. # 
  132. ;
  133. # each line represents a PCI adapter
  134. ; by vendor number and adapter number
  135. ; the vendor name is NOT stored on the card anywhere
  136. ; 
  137. ; each record contains   (leading 0's are never required)
  138. ; mixed case allowed, prefered
  139. ;
  140. ; vendor number (in hex)
  141. ; ','
  142. ; adapter number (in hex)
  143. ; ','
  144. ; 6 comma separated fields that contain
  145. ;
  146. ; the appropriate value for each register
  147. ; these are known to the vendor
  148. ; 
  149. ; S = serial port
  150. ; P = parallel port
  151. ; Pn (n=1 to 6) Enhanced parallel port
  152. ; En (n=1 to 6) matching ECP ports for the Pn port
  153. ; U = USB port
  154. ; 0 = not used
  155. ; empty = ',,' not used
  156. ; Sx(y) = single address represents multiple (x) serial ports
  157. ;              some offset (y) from the base address
  158. ;  s8(4) means 8 ports, calculate I/O address by adding 4 to base
  159. ;      for each port
  160. ; x = 1-255
  161. ; y = 1-4096
  162. ;
  163.  
  164. 4.0 Copyright and Trademark Information
  165.     ===================================
  166. The following terms are trademarks of International Business Machines
  167. Corporation in the United States and/or other countries:
  168.         IBM
  169.         OS/2
  170. Other company, product, and service names may be trademarks or service
  171. marks of others.
  172.  
  173. THE INFORMATION PROVIDED IN THIS README IS PROVIDED "AS IS" WITHOUT 
  174. WARRANTY OF ANY KIND.  IBM DISCLAIMS ALL WARRANTIES, WHETHER 
  175. EXPRESSED OR IMPLIED, INCLUDING WITHOUT LIMITATION, THE IMPLIED 
  176. WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE AND MERCHANTABILITY 
  177. WITH RESPECT TO THE INFORMATION IN THIS DOCUMENT. BY FURNISHING
  178. THIS DOCUMENT, IBM GRANTS NO LICENSES TO ANY PATENTS OR COPYRIGHTS.
  179.  
  180. (C) Copyright IBM Corporation, 2002. All rights reserved.
  181. U.S. Government Users Restricted Rights -- Use, duplication or 
  182. disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
  183.