xref: /freebsd/sys/dev/ata/ata-all.h (revision 77a0943ded95b9e6438f7db70c4a28e4d93946d4)
1 /*-
2  * Copyright (c) 1998,1999,2000 S�ren Schmidt
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer,
10  *    without modification, immediately at the beginning of the file.
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  * 3. The name of the author may not be used to endorse or promote products
15  *    derived from this software without specific prior written permission.
16  *
17  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
18  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27  *
28  * $FreeBSD$
29  */
30 
31 /* ATA register defines */
32 #define ATA_DATA			0x00	/* data register */
33 #define ATA_ERROR			0x01	/* (R) error register */
34 #define		ATA_E_NM		0x02	/* no media */
35 #define		ATA_E_ABORT		0x04	/* command aborted */
36 #define		ATA_E_MCR		0x08	/* media change request */
37 #define		ATA_E_IDNF		0x10	/* ID not found */
38 #define		ATA_E_MC		0x20	/* media changed */
39 #define		ATA_E_UNC		0x40	/* uncorrectable data */
40 #define		ATA_E_ICRC		0x80	/* UDMA crc error */
41 
42 #define ATA_FEATURE			0x01	/* (W) feature register */
43 #define		ATA_F_DMA		0x01	/* enable DMA */
44 #define		ATA_F_OVL		0x02	/* enable overlap */
45 
46 #define ATA_COUNT			0x02	/* (W) sector count */
47 #define ATA_IREASON			0x02	/* (R) interrupt reason */
48 #define		ATA_I_CMD		0x01	/* cmd (1) | data (0) */
49 #define		ATA_I_IN		0x02	/* read (1) | write (0) */
50 #define		ATA_I_RELEASE		0x04	/* released bus (1) */
51 #define		ATA_I_TAGMASK		0xf8	/* tag mask */
52 
53 #define ATA_SECTOR			0x03	/* sector # */
54 #define ATA_CYL_LSB			0x04	/* cylinder# LSB */
55 #define ATA_CYL_MSB			0x05	/* cylinder# MSB */
56 #define ATA_DRIVE			0x06	/* Sector/Drive/Head register */
57 #define		ATA_D_LBA		0x40	/* use LBA adressing */
58 #define		ATA_D_IBM		0xa0	/* 512 byte sectors, ECC */
59 
60 #define ATA_CMD				0x07	/* command register */
61 #define		ATA_C_NOP		0x00	/* NOP command */
62 #define		    ATA_C_F_FLUSHQUEUE	0x00	/* flush queued cmd's */
63 #define		    ATA_C_F_AUTOPOLL	0x01	/* start autopoll function */
64 #define		ATA_C_ATAPI_RESET	0x08	/* reset ATAPI device */
65 #define		ATA_C_READ		0x20	/* read command */
66 #define		ATA_C_WRITE		0x30	/* write command */
67 #define		ATA_C_PACKET_CMD	0xa0	/* packet command */
68 #define		ATA_C_ATAPI_IDENTIFY	0xa1	/* get ATAPI params*/
69 #define		ATA_C_SERVICE		0xa2	/* service command */
70 #define		ATA_C_READ_MUL		0xc4	/* read multi command */
71 #define		ATA_C_WRITE_MUL		0xc5	/* write multi command */
72 #define		ATA_C_SET_MULTI		0xc6	/* set multi size command */
73 #define		ATA_C_READ_DMA_QUEUED	0xc7	/* read w/DMA QUEUED command */
74 #define		ATA_C_READ_DMA		0xc8	/* read w/DMA command */
75 #define		ATA_C_WRITE_DMA		0xca	/* write w/DMA command */
76 #define		ATA_C_WRITE_DMA_QUEUED	0xcc	/* write w/DMA QUEUED command */
77 #define		ATA_C_FLUSHCACHE	0xe7	/* flush cache to disk */
78 #define		ATA_C_ATA_IDENTIFY	0xec	/* get ATA params */
79 #define		ATA_C_SETFEATURES	0xef	/* features command */
80 #define		    ATA_C_F_SETXFER	0x03	/* set transfer mode */
81 #define		    ATA_C_F_ENAB_WCACHE	0x02	/* enable write cache */
82 #define		    ATA_C_F_DIS_WCACHE	0x82	/* disable write cache */
83 #define		    ATA_C_F_ENAB_RCACHE	0xaa	/* enable readahead cache */
84 #define		    ATA_C_F_DIS_RCACHE	0x55	/* disable readahead cache */
85 #define		    ATA_C_F_ENAB_RELIRQ	0x5d	/* enable release interrupt */
86 #define		    ATA_C_F_DIS_RELIRQ	0xdd	/* disable release interrupt */
87 #define		    ATA_C_F_ENAB_SRVIRQ	0x5e	/* enable service interrupt */
88 #define		    ATA_C_F_DIS_SRVIRQ	0xde	/* disable service interrupt */
89 
90 #define ATA_STATUS			0x07	/* status register */
91 #define		ATA_S_ERROR		0x01	/* error */
92 #define		ATA_S_INDEX		0x02	/* index */
93 #define		ATA_S_CORR		0x04	/* data corrected */
94 #define		ATA_S_DRQ		0x08	/* data request */
95 #define		ATA_S_DSC		0x10	/* drive seek completed */
96 #define		ATA_S_SERVICE		0x10	/* drive needs service */
97 #define		ATA_S_DWF		0x20	/* drive write fault */
98 #define		ATA_S_DMA		0x20	/* DMA ready */
99 #define		ATA_S_READY		0x40	/* drive ready */
100 #define		ATA_S_BUSY		0x80	/* busy */
101 
102 #define ATA_ALTOFFSET			0x206	/* alternate registers offset */
103 #define ATA_PCCARD_ALTOFFSET		0x0e	/* do for PCCARD devices */
104 #define ATA_ALTIOSIZE			0x01	/* alternate registers size */
105 #define		ATA_A_IDS		0x02	/* disable interrupts */
106 #define		ATA_A_RESET		0x04	/* RESET controller */
107 #define		ATA_A_4BIT		0x08	/* 4 head bits */
108 
109 /* misc defines */
110 #define ATA_MASTER			0x00
111 #define ATA_SLAVE			0x10
112 #define ATA_IOSIZE			0x08
113 #define ATA_OP_FINISHED			0x00
114 #define ATA_OP_CONTINUES		0x01
115 #define ATA_DEV(device)			((device == ATA_MASTER) ? 0 : 1)
116 #define ATA_PARAM(scp, device)		(scp->dev_param[ATA_DEV(device)])
117 
118 /* busmaster DMA related defines */
119 #define ATA_BM_OFFSET1			0x08
120 #define ATA_DMA_ENTRIES			256
121 #define ATA_DMA_EOT			0x80000000
122 
123 #define ATA_BMCMD_PORT			0x00
124 #define ATA_BMCMD_START_STOP		0x01
125 #define ATA_BMCMD_WRITE_READ		0x08
126 
127 #define ATA_BMSTAT_PORT			0x02
128 #define ATA_BMSTAT_ACTIVE		0x01
129 #define ATA_BMSTAT_ERROR		0x02
130 #define ATA_BMSTAT_INTERRUPT		0x04
131 #define ATA_BMSTAT_MASK			0x07
132 #define ATA_BMSTAT_DMA_MASTER		0x20
133 #define ATA_BMSTAT_DMA_SLAVE		0x40
134 #define ATA_BMSTAT_DMA_SIMPLEX		0x80
135 
136 #define ATA_BMDTP_PORT			0x04
137 
138 #define ATA_BMIOSIZE			0x20
139 
140 /* structure for holding DMA address data */
141 struct ata_dmaentry {
142 	u_int32_t base;
143 	u_int32_t count;
144 };
145 
146 /* ATA/ATAPI device parameter information */
147 struct ata_params {
148     u_int8_t    cmdsize         :2;             /* packet command size */
149 #define         ATAPI_PSIZE_12          0       /* 12 bytes */
150 #define         ATAPI_PSIZE_16          1       /* 16 bytes */
151 
152     u_int8_t                    :3;
153     u_int8_t    drqtype         :2;             /* DRQ type */
154 #define         ATAPI_DRQT_MPROC        0       /* cpu    3 ms delay */
155 #define         ATAPI_DRQT_INTR         1       /* intr  10 ms delay */
156 #define         ATAPI_DRQT_ACCEL        2       /* accel 50 us delay */
157 
158     u_int8_t    removable       :1;             /* device is removable */
159     u_int8_t    device_type     :5;             /* device type */
160 #define         ATAPI_TYPE_DIRECT       0       /* disk/floppy */
161 #define         ATAPI_TYPE_TAPE         1       /* streaming tape */
162 #define         ATAPI_TYPE_CDROM        5       /* CD-ROM device */
163 #define         ATAPI_TYPE_OPTICAL      7       /* optical disk */
164 
165     u_int8_t                    :1;
166     u_int8_t    proto           :2;             /* command protocol */
167 #define         ATAPI_PROTO_ATAPI       2
168 
169     u_int16_t	cylinders;			/* number of cylinders */
170     u_int16_t	reserved2;
171     u_int16_t	heads;				/* # heads */
172     u_int16_t	unfbytespertrk;			/* # unformatted bytes/track */
173     u_int16_t	unfbytes;			/* # unformatted bytes/sector */
174     u_int16_t	sectors;			/* # sectors/track */
175     u_int16_t	vendorunique0[3];
176     u_int8_t	serial[20];			/* serial number */
177     u_int16_t	buffertype;			/* buffer type */
178 #define ATA_BT_SINGLEPORTSECTOR		1	/* 1 port, 1 sector buffer */
179 #define ATA_BT_DUALPORTMULTI		2	/* 2 port, mult sector buffer */
180 #define ATA_BT_DUALPORTMULTICACHE	3	/* above plus track cache */
181 
182     u_int16_t	buffersize;			/* buf size, 512-byte units */
183     u_int16_t	necc;				/* ecc bytes appended */
184     u_int8_t	revision[8];			/* firmware revision */
185     u_int8_t	model[40];			/* model name */
186     u_int8_t	nsecperint;			/* sectors per interrupt */
187     u_int8_t	vendorunique1;
188     u_int16_t	usedmovsd;			/* double word read/write? */
189 
190     u_int8_t	vendorcap;			/* vendor capabilities */
191     u_int8_t	dmaflag		:1;		/* DMA supported - always 1 */
192     u_int8_t	lbaflag		:1;		/* LBA supported - always 1 */
193     u_int8_t	iordydis	:1;		/* IORDY may be disabled */
194     u_int8_t	iordyflag	:1;		/* IORDY supported */
195     u_int8_t	softreset	:1;		/* needs softreset when busy */
196     u_int8_t	stdby_ovlap	:1;		/* standby/overlap supported */
197     u_int8_t	queueing	:1;		/* supports queuing overlap */
198     u_int8_t	idmaflag	:1;		/* interleaved DMA supported */
199     u_int16_t	capvalidate;			/* validation for above */
200 
201     u_int8_t	vendorunique3;
202     u_int8_t	opiomode;			/* PIO modes 0-2 */
203     u_int8_t	vendorunique4;
204     u_int8_t	odmamode;			/* old DMA modes, not ATA-3 */
205 
206     u_int16_t	atavalid;			/* fields valid */
207 #define		ATA_FLAG_54_58	      1		/* words 54-58 valid */
208 #define		ATA_FLAG_64_70	      2		/* words 64-70 valid */
209 #define		ATA_FLAG_88	      4		/* word 88 valid */
210 
211     u_int16_t	currcyls;
212     u_int16_t	currheads;
213     u_int16_t	currsectors;
214     u_int16_t	currsize0;
215     u_int16_t	currsize1;
216     u_int8_t	currmultsect;
217     u_int8_t	multsectvalid;
218     u_int32_t	lbasize;
219 
220     u_int16_t	sdmamodes;			/* singleword DMA modes */
221     u_int16_t	wdmamodes;			/* multiword DMA modes */
222     u_int16_t	apiomodes;			/* advanced PIO modes */
223 
224     u_int16_t	mwdmamin;			/* min. M/W DMA time/word ns */
225     u_int16_t	mwdmarec;			/* rec. M/W DMA time ns */
226     u_int16_t	pioblind;			/* min. PIO cycle w/o flow */
227     u_int16_t	pioiordy;			/* min. PIO cycle IORDY flow */
228 
229     u_int16_t	reserved69;
230     u_int16_t	reserved70;
231     u_int16_t	rlsovlap;			/* rel time (us) for overlap */
232     u_int16_t	rlsservice;			/* rel time (us) for service */
233     u_int16_t	reserved73;
234     u_int16_t	reserved74;
235     u_int16_t	queuelen:5;
236     u_int16_t	:11;
237     u_int16_t	reserved76;
238     u_int16_t	reserved77;
239     u_int16_t	reserved78;
240     u_int16_t	reserved79;
241     u_int16_t	versmajor;
242     u_int16_t	versminor;
243     u_int16_t	featsupp1;	/* 82 */
244     u_int16_t	supmicrocode:1;
245     u_int16_t	supqueued:1;
246     u_int16_t	supcfa:1;
247     u_int16_t	supapm:1;
248     u_int16_t	suprmsn:1;
249     u_int16_t	:11;
250     u_int16_t	featsupp3;	/* 84 */
251     u_int16_t	featenab1;	/* 85 */
252     u_int16_t	enabmicrocode:1;
253     u_int16_t	enabqueued:1;
254     u_int16_t	enabcfa:1;
255     u_int16_t	enabapm:1;
256     u_int16_t	enabrmsn:1;
257     u_int16_t	:11;
258     u_int16_t	featenab3;	/* 87 */
259     u_int16_t	udmamodes;			/* UltraDMA modes */
260     u_int16_t	erasetime;
261     u_int16_t	enherasetime;
262     u_int16_t	apmlevel;
263     u_int16_t	masterpasswdrev;
264     u_int16_t	masterhwres	:8;
265     u_int16_t	slavehwres	:5;
266     u_int16_t	cblid		:1;
267     u_int16_t	reserved93_1415	:2;
268     u_int16_t	reserved94[32];
269     u_int16_t	rmvstat;
270     u_int16_t	securstat;
271     u_int16_t	reserved129[30];
272     u_int16_t	cfapwrmode;
273     u_int16_t	reserved161[84];
274     u_int16_t	integrity;
275 };
276 
277 /* structure describing an ATA device */
278 struct ata_softc {
279     struct device		*dev;		/* device handle */
280     int				channel;	/* channel on this controller */
281     struct resource		*r_io;		/* io addr resource handle */
282     struct resource		*r_altio;	/* altio addr resource handle */
283     struct resource		*r_bmio;	/* bmio addr resource handle */
284     struct resource		*r_irq;		/* interrupt of this channel */
285     void			*ih;		/* interrupt handle */
286     u_int32_t			ioaddr;		/* physical port addr */
287     u_int32_t			altioaddr;	/* physical alt port addr */
288     u_int32_t			bmaddr;		/* physical bus master port */
289     u_int32_t			chiptype;	/* pciid of controller chip */
290     u_int32_t			alignment;	/* dma engine min alignment */
291     struct ata_params		*dev_param[2];	/* ptr to devices params */
292     void			*dev_softc[2];	/* ptr to devices softc's */
293     int 			mode[2];	/* transfer mode for devices */
294 #define 	ATA_PIO			0x00
295 #define 	ATA_PIO0		0x08
296 #define		ATA_PIO1		0x09
297 #define		ATA_PIO2		0x0a
298 #define		ATA_PIO3		0x0b
299 #define		ATA_PIO4		0x0c
300 #define		ATA_DMA			0x10
301 #define		ATA_WDMA2		0x22
302 #define		ATA_UDMA2		0x42
303 #define		ATA_UDMA4		0x44
304 #define		ATA_UDMA5		0x45
305 
306     int				flags;		/* controller flags */
307 #define		ATA_DMA_ACTIVE		0x01
308 #define		ATA_ATAPI_DMA_RO	0x02
309 #define		ATA_USE_16BIT		0x04
310 #define		ATA_NO_SLAVE		0x08
311 #define		ATA_ATTACHED		0x10
312 #define		ATA_QUEUED		0x20
313 
314     int				devices;	/* what is present */
315 #define		ATA_ATA_MASTER		0x01
316 #define		ATA_ATA_SLAVE		0x02
317 #define		ATA_ATAPI_MASTER	0x04
318 #define		ATA_ATAPI_SLAVE		0x08
319 
320     u_int8_t			status;		/* last controller status */
321     u_int8_t			error;		/* last controller error */
322     int				active;		/* active processing request */
323 #define		ATA_IDLE		0x0
324 #define		ATA_IMMEDIATE		0x1
325 #define		ATA_WAIT_INTR		0x2
326 #define		ATA_WAIT_READY		0x3
327 #define		ATA_ACTIVE		0x4
328 #define		ATA_ACTIVE_ATA		0x5
329 #define		ATA_ACTIVE_ATAPI	0x6
330 #define		ATA_REINITING		0x7
331 
332     TAILQ_HEAD(, ad_request)	ata_queue;	/* head of ATA queue */
333     TAILQ_HEAD(, atapi_request) atapi_queue;	/* head of ATAPI queue */
334     void			*running;	/* currently running request */
335 };
336 
337 /* externs */
338 extern devclass_t ata_devclass;
339 
340 /* public prototypes */
341 void ata_start(struct ata_softc *);
342 void ata_reset(struct ata_softc *, int *);
343 int ata_reinit(struct ata_softc *);
344 int ata_wait(struct ata_softc *, int, u_int8_t);
345 int ata_command(struct ata_softc *, int, u_int8_t, u_int16_t, u_int8_t, u_int8_t, u_int8_t, u_int8_t, int);
346 int ata_printf(struct ata_softc *, int, const char *, ...) __printflike(3, 4);
347 int ata_get_lun(u_int32_t *);
348 void ata_free_lun(u_int32_t *, int);
349 char *ata_mode2str(int);
350 int ata_pio2mode(int);
351 int ata_pmode(struct ata_params *);
352 int ata_wmode(struct ata_params *);
353 int ata_umode(struct ata_params *);
354 #if NPCI > 0
355 int ata_find_dev(device_t, u_int32_t, u_int32_t);
356 #endif
357 
358 void *ata_dmaalloc(struct ata_softc *, int);
359 void ata_dmainit(struct ata_softc *, int, int, int, int);
360 int ata_dmasetup(struct ata_softc *, int, struct ata_dmaentry *, caddr_t, int);
361 void ata_dmastart(struct ata_softc *, int, struct ata_dmaentry *, int);
362 int ata_dmastatus(struct ata_softc *);
363 int ata_dmadone(struct ata_softc *);
364