~ [ source navigation ] ~ [ diff markup ] ~ [ identifier search ] ~

TOMOYO Linux Cross Reference
Linux/Documentation/admin-guide/blockdev/paride.rst

Version: ~ [ linux-6.12-rc7 ] ~ [ linux-6.11.7 ] ~ [ linux-6.10.14 ] ~ [ linux-6.9.12 ] ~ [ linux-6.8.12 ] ~ [ linux-6.7.12 ] ~ [ linux-6.6.60 ] ~ [ linux-6.5.13 ] ~ [ linux-6.4.16 ] ~ [ linux-6.3.13 ] ~ [ linux-6.2.16 ] ~ [ linux-6.1.116 ] ~ [ linux-6.0.19 ] ~ [ linux-5.19.17 ] ~ [ linux-5.18.19 ] ~ [ linux-5.17.15 ] ~ [ linux-5.16.20 ] ~ [ linux-5.15.171 ] ~ [ linux-5.14.21 ] ~ [ linux-5.13.19 ] ~ [ linux-5.12.19 ] ~ [ linux-5.11.22 ] ~ [ linux-5.10.229 ] ~ [ linux-5.9.16 ] ~ [ linux-5.8.18 ] ~ [ linux-5.7.19 ] ~ [ linux-5.6.19 ] ~ [ linux-5.5.19 ] ~ [ linux-5.4.285 ] ~ [ linux-5.3.18 ] ~ [ linux-5.2.21 ] ~ [ linux-5.1.21 ] ~ [ linux-5.0.21 ] ~ [ linux-4.20.17 ] ~ [ linux-4.19.323 ] ~ [ linux-4.18.20 ] ~ [ linux-4.17.19 ] ~ [ linux-4.16.18 ] ~ [ linux-4.15.18 ] ~ [ linux-4.14.336 ] ~ [ linux-4.13.16 ] ~ [ linux-4.12.14 ] ~ [ linux-4.11.12 ] ~ [ linux-4.10.17 ] ~ [ linux-4.9.337 ] ~ [ linux-4.4.302 ] ~ [ linux-3.10.108 ] ~ [ linux-2.6.32.71 ] ~ [ linux-2.6.0 ] ~ [ linux-2.4.37.11 ] ~ [ unix-v6-master ] ~ [ ccs-tools-1.8.12 ] ~ [ policy-sample ] ~
Architecture: ~ [ i386 ] ~ [ alpha ] ~ [ m68k ] ~ [ mips ] ~ [ ppc ] ~ [ sparc ] ~ [ sparc64 ] ~

Diff markup

Differences between /Documentation/admin-guide/blockdev/paride.rst (Version linux-6.12-rc7) and /Documentation/admin-guide/blockdev/paride.rst (Version linux-6.5.13)


  1 ===================================                 1 ===================================
  2 Linux and parallel port IDE devices                 2 Linux and parallel port IDE devices
  3 ===================================                 3 ===================================
  4                                                     4 
  5 PARIDE v1.03   (c) 1997-8  Grant Guenther <gran      5 PARIDE v1.03   (c) 1997-8  Grant Guenther <grant@torque.net>
  6 PATA_PARPORT   (c) 2023 Ondrej Zary                 6 PATA_PARPORT   (c) 2023 Ondrej Zary
  7                                                     7 
  8 1. Introduction                                     8 1. Introduction
  9 ===============                                     9 ===============
 10                                                    10 
 11 Owing to the simplicity and near universality      11 Owing to the simplicity and near universality of the parallel port interface
 12 to personal computers, many external devices s     12 to personal computers, many external devices such as portable hard-disk,
 13 CD-ROM, LS-120 and tape drives use the paralle     13 CD-ROM, LS-120 and tape drives use the parallel port to connect to their
 14 host computer.  While some devices (notably sc     14 host computer.  While some devices (notably scanners) use ad-hoc methods
 15 to pass commands and data through the parallel     15 to pass commands and data through the parallel port interface, most
 16 external devices are actually identical to an      16 external devices are actually identical to an internal model, but with
 17 a parallel-port adapter chip added in.  Some o     17 a parallel-port adapter chip added in.  Some of the original parallel port
 18 adapters were little more than mechanisms for      18 adapters were little more than mechanisms for multiplexing a SCSI bus.
 19 (The Iomega PPA-3 adapter used in the ZIP driv     19 (The Iomega PPA-3 adapter used in the ZIP drives is an example of this
 20 approach).  Most current designs, however, tak     20 approach).  Most current designs, however, take a different approach.
 21 The adapter chip reproduces a small ISA or IDE     21 The adapter chip reproduces a small ISA or IDE bus in the external device
 22 and the communication protocol provides operat     22 and the communication protocol provides operations for reading and writing
 23 device registers, as well as data block transf     23 device registers, as well as data block transfer functions.  Sometimes,
 24 the device being addressed via the parallel ca     24 the device being addressed via the parallel cable is a standard SCSI
 25 controller like an NCR 5380.  The "ditto" fami     25 controller like an NCR 5380.  The "ditto" family of external tape
 26 drives use the ISA replicator to interface a f     26 drives use the ISA replicator to interface a floppy disk controller,
 27 which is then connected to a floppy-tape mecha     27 which is then connected to a floppy-tape mechanism.  The vast majority
 28 of external parallel port devices, however, ar     28 of external parallel port devices, however, are now based on standard
 29 IDE type devices, which require no intermediat     29 IDE type devices, which require no intermediate controller.  If one
 30 were to open up a parallel port CD-ROM drive,      30 were to open up a parallel port CD-ROM drive, for instance, one would
 31 find a standard ATAPI CD-ROM drive, a power su     31 find a standard ATAPI CD-ROM drive, a power supply, and a single adapter
 32 that interconnected a standard PC parallel por     32 that interconnected a standard PC parallel port cable and a standard
 33 IDE cable.  It is usually possible to exchange     33 IDE cable.  It is usually possible to exchange the CD-ROM device with
 34 any other device using the IDE interface.          34 any other device using the IDE interface.
 35                                                    35 
 36 The document describes the support in Linux fo     36 The document describes the support in Linux for parallel port IDE
 37 devices.  It does not cover parallel port SCSI     37 devices.  It does not cover parallel port SCSI devices, "ditto" tape
 38 drives or scanners.  Many different devices ar     38 drives or scanners.  Many different devices are supported by the
 39 parallel port IDE subsystem, including:            39 parallel port IDE subsystem, including:
 40                                                    40 
 41         - MicroSolutions backpack CD-ROM           41         - MicroSolutions backpack CD-ROM
 42         - MicroSolutions backpack PD/CD            42         - MicroSolutions backpack PD/CD
 43         - MicroSolutions backpack hard-drives      43         - MicroSolutions backpack hard-drives
 44         - MicroSolutions backpack 8000t tape d     44         - MicroSolutions backpack 8000t tape drive
 45         - SyQuest EZ-135, EZ-230 & SparQ drive     45         - SyQuest EZ-135, EZ-230 & SparQ drives
 46         - Avatar Shark                             46         - Avatar Shark
 47         - Imation Superdisk LS-120                 47         - Imation Superdisk LS-120
 48         - Maxell Superdisk LS-120                  48         - Maxell Superdisk LS-120
 49         - FreeCom Power CD                         49         - FreeCom Power CD
 50         - Hewlett-Packard 5GB and 8GB tape dri     50         - Hewlett-Packard 5GB and 8GB tape drives
 51         - Hewlett-Packard 7100 and 7200 CD-RW      51         - Hewlett-Packard 7100 and 7200 CD-RW drives
 52                                                    52 
 53 as well as most of the clone and no-name produ     53 as well as most of the clone and no-name products on the market.
 54                                                    54 
 55 To support such a wide range of devices, pata_     55 To support such a wide range of devices, pata_parport is actually structured
 56 in two parts. There is a base pata_parport mod     56 in two parts. There is a base pata_parport module which provides an interface
 57 to kernel libata subsystem, registry and some      57 to kernel libata subsystem, registry and some common methods for accessing
 58 the parallel ports.                                58 the parallel ports.
 59                                                    59 
 60 The second component is a set of low-level pro     60 The second component is a set of low-level protocol drivers for each of the
 61 parallel port IDE adapter chips.  Thanks to th     61 parallel port IDE adapter chips.  Thanks to the interest and encouragement of
 62 Linux users from many parts of the world, supp     62 Linux users from many parts of the world, support is available for almost all
 63 known adapter protocols:                           63 known adapter protocols:
 64                                                    64 
 65         ====    ==============================     65         ====    ====================================== ====
 66         aten    ATEN EH-100                        66         aten    ATEN EH-100                            (HK)
 67         bpck    Microsolutions backpack            67         bpck    Microsolutions backpack                (US)
 68         comm    DataStor (old-type) "commuter"     68         comm    DataStor (old-type) "commuter" adapter (TW)
 69         dstr    DataStor EP-2000                   69         dstr    DataStor EP-2000                       (TW)
 70         epat    Shuttle EPAT                       70         epat    Shuttle EPAT                           (UK)
 71         epia    Shuttle EPIA                       71         epia    Shuttle EPIA                           (UK)
 72         fit2    FIT TD-2000                        72         fit2    FIT TD-2000                            (US)
 73         fit3    FIT TD-3000                        73         fit3    FIT TD-3000                            (US)
 74         friq    Freecom IQ cable                   74         friq    Freecom IQ cable                       (DE)
 75         frpw    Freecom Power                      75         frpw    Freecom Power                          (DE)
 76         kbic    KingByte KBIC-951A and KBIC-97     76         kbic    KingByte KBIC-951A and KBIC-971A       (TW)
 77         ktti    KT Technology PHd adapter          77         ktti    KT Technology PHd adapter              (SG)
 78         on20    OnSpec 90c20                       78         on20    OnSpec 90c20                           (US)
 79         on26    OnSpec 90c26                       79         on26    OnSpec 90c26                           (US)
 80         ====    ==============================     80         ====    ====================================== ====
 81                                                    81 
 82                                                    82 
 83 2. Using pata_parport subsystem                    83 2. Using pata_parport subsystem
 84 ===============================                    84 ===============================
 85                                                    85 
 86 While configuring the Linux kernel, you may ch     86 While configuring the Linux kernel, you may choose either to build
 87 the pata_parport drivers into your kernel, or      87 the pata_parport drivers into your kernel, or to build them as modules.
 88                                                    88 
 89 In either case, you will need to select "Paral     89 In either case, you will need to select "Parallel port IDE device support"
 90 and at least one of the parallel port communic     90 and at least one of the parallel port communication protocols.
 91 If you do not know what kind of parallel port      91 If you do not know what kind of parallel port adapter is used in your drive,
 92 you could begin by checking the file names and     92 you could begin by checking the file names and any text files on your DOS
 93 installation floppy.  Alternatively, you can l     93 installation floppy.  Alternatively, you can look at the markings on
 94 the adapter chip itself.  That's usually suffi     94 the adapter chip itself.  That's usually sufficient to identify the
 95 correct device.                                    95 correct device.
 96                                                    96 
 97 You can actually select all the protocol modul     97 You can actually select all the protocol modules, and allow the pata_parport
 98 subsystem to try them all for you.                 98 subsystem to try them all for you.
 99                                                    99 
100 For the "brand-name" products listed above, he    100 For the "brand-name" products listed above, here are the protocol
101 and high-level drivers that you would use:        101 and high-level drivers that you would use:
102                                                   102 
103         ================        ============      103         ================        ============    ========
104         Manufacturer            Model             104         Manufacturer            Model           Protocol
105         ================        ============      105         ================        ============    ========
106         MicroSolutions          CD-ROM            106         MicroSolutions          CD-ROM          bpck
107         MicroSolutions          PD drive          107         MicroSolutions          PD drive        bpck
108         MicroSolutions          hard-drive        108         MicroSolutions          hard-drive      bpck
109         MicroSolutions          8000t tape        109         MicroSolutions          8000t tape      bpck
110         SyQuest                 EZ, SparQ         110         SyQuest                 EZ, SparQ       epat
111         Imation                 Superdisk         111         Imation                 Superdisk       epat
112         Maxell                  Superdisk         112         Maxell                  Superdisk       friq
113         Avatar                  Shark             113         Avatar                  Shark           epat
114         FreeCom                 CD-ROM            114         FreeCom                 CD-ROM          frpw
115         Hewlett-Packard         5GB Tape          115         Hewlett-Packard         5GB Tape        epat
116         Hewlett-Packard         7200e (CD)        116         Hewlett-Packard         7200e (CD)      epat
117         Hewlett-Packard         7200e (CD-R)      117         Hewlett-Packard         7200e (CD-R)    epat
118         ================        ============      118         ================        ============    ========
119                                                   119 
120 All parports and all protocol drivers are prob    120 All parports and all protocol drivers are probed automatically unless probe=0
121 parameter is used. So just "modprobe epat" is     121 parameter is used. So just "modprobe epat" is enough for a Imation SuperDisk
122 drive to work.                                    122 drive to work.
123                                                   123 
124 Manual device creation::                          124 Manual device creation::
125                                                   125 
126         # echo "port protocol mode unit delay"    126         # echo "port protocol mode unit delay" >/sys/bus/pata_parport/new_device
127                                                   127 
128 where:                                            128 where:
129                                                   129 
130         ======== =============================    130         ======== ================================================
131         port     parport name (or "auto" for a    131         port     parport name (or "auto" for all parports)
132         protocol protocol name (or "auto" for     132         protocol protocol name (or "auto" for all protocols)
133         mode     mode number (protocol-specifi    133         mode     mode number (protocol-specific) or -1 for probe
134         unit     unit number (for backpack onl    134         unit     unit number (for backpack only, see below)
135         delay    I/O delay (see troubleshootin    135         delay    I/O delay (see troubleshooting section below)
136         ======== =============================    136         ======== ================================================
137                                                   137 
138 If you happen to be using a MicroSolutions bac    138 If you happen to be using a MicroSolutions backpack device, you will
139 also need to know the unit ID number for each     139 also need to know the unit ID number for each drive.  This is usually
140 the last two digits of the drive's serial numb    140 the last two digits of the drive's serial number (but read MicroSolutions'
141 documentation about this).                        141 documentation about this).
142                                                   142 
143 If you omit the parameters from the end, defau    143 If you omit the parameters from the end, defaults will be used, e.g.:
144                                                   144 
145 Probe all parports with all protocols::           145 Probe all parports with all protocols::
146                                                   146 
147         # echo auto >/sys/bus/pata_parport/new    147         # echo auto >/sys/bus/pata_parport/new_device
148                                                   148 
149 Probe parport0 using protocol epat and mode 4     149 Probe parport0 using protocol epat and mode 4 (EPP-16)::
150                                                   150 
151         # echo "parport0 epat 4" >/sys/bus/pat    151         # echo "parport0 epat 4" >/sys/bus/pata_parport/new_device
152                                                   152 
153 Probe parport0 using all protocols::              153 Probe parport0 using all protocols::
154                                                   154 
155         # echo "parport0 auto" >/sys/bus/pata_    155         # echo "parport0 auto" >/sys/bus/pata_parport/new_device
156                                                   156 
157 Probe all parports using protoocol epat::         157 Probe all parports using protoocol epat::
158                                                   158 
159         # echo "auto epat" >/sys/bus/pata_parp    159         # echo "auto epat" >/sys/bus/pata_parport/new_device
160                                                   160 
161 Deleting devices::                                161 Deleting devices::
162                                                   162 
163         # echo pata_parport.0 >/sys/bus/pata_p    163         # echo pata_parport.0 >/sys/bus/pata_parport/delete_device
164                                                   164 
165                                                   165 
166 3. Troubleshooting                                166 3. Troubleshooting
167 ==================                                167 ==================
168                                                   168 
169 3.1  Use EPP mode if you can                      169 3.1  Use EPP mode if you can
170 ----------------------------                      170 ----------------------------
171                                                   171 
172 The most common problems that people report wi    172 The most common problems that people report with the pata_parport drivers
173 concern the parallel port CMOS settings.  At t    173 concern the parallel port CMOS settings.  At this time, none of the
174 protocol modules support ECP mode, or any ECP     174 protocol modules support ECP mode, or any ECP combination modes.
175 If you are able to do so, please set your para    175 If you are able to do so, please set your parallel port into EPP mode
176 using your CMOS setup procedure.                  176 using your CMOS setup procedure.
177                                                   177 
178 3.2  Check the port delay                         178 3.2  Check the port delay
179 -------------------------                         179 -------------------------
180                                                   180 
181 Some parallel ports cannot reliably transfer d    181 Some parallel ports cannot reliably transfer data at full speed.  To
182 offset the errors, the protocol modules introd    182 offset the errors, the protocol modules introduce a "port
183 delay" between each access to the i/o ports.      183 delay" between each access to the i/o ports.  Each protocol sets
184 a default value for this delay.  In most cases    184 a default value for this delay.  In most cases, the user can override
185 the default and set it to 0 - resulting in som    185 the default and set it to 0 - resulting in somewhat higher transfer
186 rates.  In some rare cases (especially with ol    186 rates.  In some rare cases (especially with older 486 systems) the
187 default delays are not long enough.  if you ex    187 default delays are not long enough.  if you experience corrupt data
188 transfers, or unexpected failures, you may wis    188 transfers, or unexpected failures, you may wish to increase the
189 port delay.                                       189 port delay.
190                                                   190 
191 3.3  Some drives need a printer reset             191 3.3  Some drives need a printer reset
192 -------------------------------------             192 -------------------------------------
193                                                   193 
194 There appear to be a number of "noname" extern    194 There appear to be a number of "noname" external drives on the market
195 that do not always power up correctly.  We hav    195 that do not always power up correctly.  We have noticed this with some
196 drives based on OnSpec and older Freecom adapt    196 drives based on OnSpec and older Freecom adapters.  In these rare cases,
197 the adapter can often be reinitialised by issu    197 the adapter can often be reinitialised by issuing a "printer reset" on
198 the parallel port.  As the reset operation is     198 the parallel port.  As the reset operation is potentially disruptive in
199 multiple device environments, the pata_parport    199 multiple device environments, the pata_parport drivers will not do it
200 automatically.  You can however, force a print    200 automatically.  You can however, force a printer reset by doing::
201                                                   201 
202         insmod lp reset=1                         202         insmod lp reset=1
203         rmmod lp                                  203         rmmod lp
204                                                   204 
205 If you have one of these marginal cases, you s    205 If you have one of these marginal cases, you should probably build
206 your pata_parport drivers as modules, and arra    206 your pata_parport drivers as modules, and arrange to do the printer reset
207 before loading the pata_parport drivers.          207 before loading the pata_parport drivers.
                                                      

~ [ source navigation ] ~ [ diff markup ] ~ [ identifier search ] ~

kernel.org | git.kernel.org | LWN.net | Project Home | SVN repository | Mail admin

Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.

sflogo.php