xref: /freebsd/share/man/man4/ata.4 (revision 41466b50c1d5bfd1cf6adaae547a579a75d7c04e)
1.\"
2.\" Copyright (c) 2000 Jeroen Ruigrok van der Werven
3.\" Copyright (c) 2000,2001 S�ren Schmidt
4.\" All rights reserved.
5.\"
6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions
8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright
10.\"    notice, this list of conditions and the following disclaimer.
11.\" 2. Redistributions in binary form must reproduce the above copyright
12.\"    notice, this list of conditions and the following disclaimer in the
13.\"    documentation and/or other materials provided with the distribution.
14.\"
15.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
16.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
17.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
18.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
19.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
20.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
21.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
22.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
23.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
24.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
25.\" SUCH DAMAGE.
26.\"
27.\" $FreeBSD$
28.\"
29.Dd January 27, 2000
30.Dt ATA 4
31.Os
32.Sh NAME
33.Nm ata ,
34.Nm acd ,
35.Nm ad ,
36.Nm afd ,
37.Nm ast
38.Nd generic ATA/ATAPI disk controller driver
39.Sh SYNOPSIS
40For ISA based ATA/ATAPI support:
41.Cd device isa
42.Cd device ata
43.Pp
44In
45.Pa /boot/device.hints :
46.Cd hint.ata.0.at="isa"
47.Cd hint.ata.0.port="0x1f0"
48.Cd hint.ata.0.irq="14"
49.Cd hint.ata.1.at="isa"
50.Cd hint.ata.1.port="0x170"
51.Cd hint.ata.1.irq="15"
52.Pp
53For PCI based ATA/ATAPI support:
54.Cd device pci
55.Cd device ata
56.Pp
57To support ATA compliant disk drives:
58.Cd device atadisk
59.Pp
60To support ATAPI CD-ROM, CDR, CDRW, DVD-ROM and DVD-RAM drives:
61.Cd device atapicd
62.Pp
63To support ATAPI floppy drives,
64such as the ZIP and LS120:
65.Cd device atapifd
66.Pp
67To support ATAPI tape drives:
68.Cd device atapist
69.Pp
70The following tunables are setable from the loader:
71.Bl -ohang
72.It Va hw.ata.ata_dma
73set to 1 for DMA access, 0 for PIO (default is DMA).
74.It Va hw.ata.atapi_dma
75set to 1 for DMA access, 0 for PIO (default is PIO).
76.It Va hw.ata.wc
77set to 1 to enable Write Caching, 0 to disable (default is disabled).
78(WARNING: might cause data loss on power failures.)
79.It Va hw.ata.tags
80set to 1 to enable Tagged Queuing support, 0 to disable (default is disabled).
81(Only IBM DPTA and DTLA drives support that.)
82.El
83.Sh DESCRIPTION
84This driver provides access to disk drives, ATAPI CD-ROM and DVD drives,
85ZIP drives and tape streamers connected to controllers
86according to the ATA and ATAPI standards.
87These devices are also commonly known as IDE or EIDE devices.
88.Pp
89The currently supported controllers with their maximum speed include:
90.Pp
91.Bl -tag -width "xxxxxxxxxxxxxxxxxxxxxxxxxxxxx" -compact
92.It Acerlabs Aladdin
93Ultra DMA 100 (UDMA5), 100 MB/sec (depending on model, max stated at boot)
94.It AMD 756
95Ultra DMA 66 (UDMA4), 66 MB/sec
96.It AMD 766
97Ultra DMA 100 (UDMA5), 100 MB/sec
98.It CMD 646
99DMA 2 (WDMA2), 16 MB/sec
100.It CMD 648
101Ultra DMA 66 (UDMA4), 66 MB/sec
102.It CMD 649
103Ultra DMA 100 (UDMA5), 100 MB/sec
104.It Cypress 82C693
105DMA 2 (WDMA2), 16 MB/sec
106.It Cyrix 5530
107Ultra DMA 33 (UDMA2), 33 MB/sec
108.It HighPoint HPT366
109Ultra DMA 66 (UDMA4), 66 MB/sec
110.It HighPoint HPT370
111Ultra DMA 100 (UDMA5), 100 MB/sec
112.It HighPoint HPT372
113Ultra DMA 133 (UDMA6), 133 MB/sec
114.It Intel PIIX
115DMA 2 (WDMA2), 16 MB/sec
116.It Intel PIIX3
117DMA 2 (WDMA2), 16 MB/sec
118.It Intel PIIX4
119Ultra DMA 33 (UDMA2), 33 MB/sec
120.It Intel ICH0
121Ultra DMA 33 (UDMA2), 33 MB/sec
122.It Intel ICH
123Ultra DMA 66 (UDMA4), 66 MB/sec
124.It Intel ICH2
125Ultra DMA 100 (UDMA5), 100 MB/sec
126.It Intel ICH3
127Ultra DMA 100 (UDMA5), 100 MB/sec
128.It Promise Ultra/Fasttrak-33
129Ultra DMA 33 (UDMA2), 33 MB/sec
130.It Promise Ultra/Fasttrak-66
131Ultra DMA 66 (UDMA4), 66 MB/sec
132.It Promise Ultra/Fasttrak-100
133Ultra DMA 100 (UDMA5), 100 MB/sec
134.It Promise Ultra/Fasttrak-100 TX2/TX4
135Ultra DMA 100 (UDMA5), 100 MB/sec
136.It ServerWorks ROSB4
137Ultra DMA 33 (UDMA2), 33 MB/sec
138.It SiS 5591
139Ultra DMA 33 (UDMA2), 33 MB/sec
140.It VIA 82C586
141Ultra DMA 33 (UDMA2), 33 MB/sec
142.It VIA 82C686a
143Ultra DMA 66 (UDMA4), 66 MB/sec
144.It VIA 82C686b
145Ultra DMA 100 (UDMA5), 100 MB/sec
146.El
147.Pp
148All unknown chipsets are supported at the maximum speed of 16 MB/sec.
149.Pp
150The
151.Nm
152driver also allows for changes to the transfer mode of the devices
153at a later time when the system is up and running, see
154.Xr atacontrol 8 .
155.Pp
156The driver attempts to set the maximum performance transfer mode on your disk
157drives by selecting the highest possible DMA mode.
158ATAPI devices are left in PIO mode because DMA problems are common despite the
159device specifications.
160You can always try to set DMA mode on an ATAPI device using
161.Xr atacontrol 8 ,
162but be aware that your hardware might
163.Em not
164support it and can
165.Em hang
166the system.
167.Sh FILES
168.Bl -tag -width "/sys/i386/conf/GENERIC " -compact
169.It Pa /dev/ad*
170ATA disk device nodes
171.It Pa /dev/acd*
172ATAPI CD-ROM device nodes
173.It Pa /dev/afd*
174ATAPI floppy drive device nodes
175.It Pa /dev/ast*
176ATAPI tape drive device nodes
177.It Pa /sys/i386/conf/GENERIC
178sample generic kernel config file for
179.Nm
180based systems
181.El
182.Sh NOTES
183Static numbering
184(enabled with the
185.Dv ATA_STATIC_ID
186kernel option)
187reserves a number for each possibly connected disk,
188even when not present.
189This may result in odd situations where,
190for example,
191ad0 and ad2 exist in the absence of ad1.
192The advantage is that the addition of the formerly absent drive
193does not cause the numbers of the other drives to change.
194.Pp
195The
196.Nm
197driver does not support MFM/RLL/ESDI (ST-506) style disks.
198.Pp
199Remember that in order to use UDMA4 (and above) mode you
200.Em have
201to use a special 80 conductor cable,
202and the driver tries to determine if you have such a cable
203attached before setting UDMA4 mode.
204.Pp
205The use of UDMA4(66MHz) and higher together with non-UDMA4 devices on
206the same ATA channel is not recommended,
207unless they are run at the non-UDMA4 device's lower speed.
208The driver has been designed to handle that kind of setup but lots of
209older devices do not like this.
210.Sh SEE ALSO
211.Xr atacontrol 8 ,
212.Xr burncd 8
213.Sh HISTORY
214The
215.Nm
216driver first appeared in
217.Fx 4.0 .
218.Sh AUTHORS
219.An -nosplit
220The
221.Nm
222driver was written by
223.An S\(/oren Schmidt
224.Aq sos@FreeBSD.org .
225.Pp
226This manual page was written by
227.An Jeroen Ruigrok van der Werven
228.Aq asmodai@FreeBSD.org
229and
230.An S\(/oren Schmidt
231.Aq sos@FreeBSD.org .
232