VServer 1.9.2 (patch-2.6.8.1-vs1.9.2.diff)
[linux-2.6.git] / include / linux / ide.h
1 #ifndef _IDE_H
2 #define _IDE_H
3 /*
4  *  linux/include/linux/ide.h
5  *
6  *  Copyright (C) 1994-2002  Linus Torvalds & authors
7  */
8
9 #include <linux/config.h>
10 #include <linux/init.h>
11 #include <linux/ioport.h>
12 #include <linux/hdreg.h>
13 #include <linux/hdsmart.h>
14 #include <linux/blkdev.h>
15 #include <linux/proc_fs.h>
16 #include <linux/interrupt.h>
17 #include <linux/bitops.h>
18 #include <linux/bio.h>
19 #include <linux/device.h>
20 #include <linux/pci.h>
21 #include <asm/byteorder.h>
22 #include <asm/system.h>
23 #include <asm/io.h>
24 #include <asm/semaphore.h>
25
26 /*
27  * This is the multiple IDE interface driver, as evolved from hd.c.
28  * It supports up to four IDE interfaces, on one or more IRQs (usually 14 & 15).
29  * There can be up to two drives per interface, as per the ATA-2 spec.
30  *
31  * Primary i/f:    ide0: major=3;  (hda)         minor=0; (hdb)         minor=64
32  * Secondary i/f:  ide1: major=22; (hdc or hd1a) minor=0; (hdd or hd1b) minor=64
33  * Tertiary i/f:   ide2: major=33; (hde)         minor=0; (hdf)         minor=64
34  * Quaternary i/f: ide3: major=34; (hdg)         minor=0; (hdh)         minor=64
35  */
36
37 /******************************************************************************
38  * IDE driver configuration options (play with these as desired):
39  *
40  * REALLY_SLOW_IO can be defined in ide.c and ide-cd.c, if necessary
41  */
42 #define REALLY_FAST_IO                  /* define if ide ports are perfect */
43 #define INITIAL_MULT_COUNT      0       /* off=0; on=2,4,8,16,32, etc.. */
44
45 #ifndef SUPPORT_SLOW_DATA_PORTS         /* 1 to support slow data ports */
46 #define SUPPORT_SLOW_DATA_PORTS 1       /* 0 to reduce kernel size */
47 #endif
48 #ifndef SUPPORT_VLB_SYNC                /* 1 to support weird 32-bit chips */
49 #define SUPPORT_VLB_SYNC        1       /* 0 to reduce kernel size */
50 #endif
51 #ifndef OK_TO_RESET_CONTROLLER          /* 1 needed for good error recovery */
52 #define OK_TO_RESET_CONTROLLER  1       /* 0 for use with AH2372A/B interface */
53 #endif
54 #ifndef FANCY_STATUS_DUMPS              /* 1 for human-readable drive errors */
55 #define FANCY_STATUS_DUMPS      1       /* 0 to reduce kernel size */
56 #endif
57
58 #ifdef CONFIG_BLK_DEV_CMD640
59 #if 0   /* change to 1 when debugging cmd640 problems */
60 void cmd640_dump_regs (void);
61 #define CMD640_DUMP_REGS cmd640_dump_regs() /* for debugging cmd640 chipset */
62 #endif
63 #endif  /* CONFIG_BLK_DEV_CMD640 */
64
65 #ifndef DISABLE_IRQ_NOSYNC
66 #define DISABLE_IRQ_NOSYNC      0
67 #endif
68
69 /*
70  * Used to indicate "no IRQ", should be a value that cannot be an IRQ
71  * number.
72  */
73  
74 #define IDE_NO_IRQ              (-1)
75
76 /*
77  * IDE_DRIVE_CMD is used to implement many features of the hdparm utility
78  */
79 #define IDE_DRIVE_CMD                   99      /* (magic) undef to reduce kernel size*/
80
81 #define IDE_DRIVE_TASK                  98
82
83 /*
84  * IDE_DRIVE_TASKFILE is used to implement many features needed for raw tasks
85  */
86 #define IDE_DRIVE_TASKFILE              97
87
88 /*
89  *  "No user-serviceable parts" beyond this point  :)
90  *****************************************************************************/
91
92 typedef unsigned char   byte;   /* used everywhere */
93
94 /*
95  * Probably not wise to fiddle with these
96  */
97 #define ERROR_MAX       8       /* Max read/write errors per sector */
98 #define ERROR_RESET     3       /* Reset controller every 4th retry */
99 #define ERROR_RECAL     1       /* Recalibrate every 2nd retry */
100
101 /*
102  * Tune flags
103  */
104 #define IDE_TUNE_NOAUTO         2
105 #define IDE_TUNE_AUTO           1
106 #define IDE_TUNE_DEFAULT        0
107
108 /*
109  * state flags
110  */
111
112 #define DMA_PIO_RETRY   1       /* retrying in PIO */
113
114 /*
115  * Ensure that various configuration flags have compatible settings
116  */
117 #ifdef REALLY_SLOW_IO
118 #undef REALLY_FAST_IO
119 #endif
120
121 #define HWIF(drive)             ((ide_hwif_t *)((drive)->hwif))
122 #define HWGROUP(drive)          ((ide_hwgroup_t *)(HWIF(drive)->hwgroup))
123
124 /*
125  * Definitions for accessing IDE controller registers
126  */
127 #define IDE_NR_PORTS            (10)
128
129 #define IDE_DATA_OFFSET         (0)
130 #define IDE_ERROR_OFFSET        (1)
131 #define IDE_NSECTOR_OFFSET      (2)
132 #define IDE_SECTOR_OFFSET       (3)
133 #define IDE_LCYL_OFFSET         (4)
134 #define IDE_HCYL_OFFSET         (5)
135 #define IDE_SELECT_OFFSET       (6)
136 #define IDE_STATUS_OFFSET       (7)
137 #define IDE_CONTROL_OFFSET      (8)
138 #define IDE_IRQ_OFFSET          (9)
139
140 #define IDE_FEATURE_OFFSET      IDE_ERROR_OFFSET
141 #define IDE_COMMAND_OFFSET      IDE_STATUS_OFFSET
142
143 #define IDE_CONTROL_OFFSET_HOB  (7)
144
145 #define IDE_DATA_REG            (HWIF(drive)->io_ports[IDE_DATA_OFFSET])
146 #define IDE_ERROR_REG           (HWIF(drive)->io_ports[IDE_ERROR_OFFSET])
147 #define IDE_NSECTOR_REG         (HWIF(drive)->io_ports[IDE_NSECTOR_OFFSET])
148 #define IDE_SECTOR_REG          (HWIF(drive)->io_ports[IDE_SECTOR_OFFSET])
149 #define IDE_LCYL_REG            (HWIF(drive)->io_ports[IDE_LCYL_OFFSET])
150 #define IDE_HCYL_REG            (HWIF(drive)->io_ports[IDE_HCYL_OFFSET])
151 #define IDE_SELECT_REG          (HWIF(drive)->io_ports[IDE_SELECT_OFFSET])
152 #define IDE_STATUS_REG          (HWIF(drive)->io_ports[IDE_STATUS_OFFSET])
153 #define IDE_CONTROL_REG         (HWIF(drive)->io_ports[IDE_CONTROL_OFFSET])
154 #define IDE_IRQ_REG             (HWIF(drive)->io_ports[IDE_IRQ_OFFSET])
155
156 #define IDE_FEATURE_REG         IDE_ERROR_REG
157 #define IDE_COMMAND_REG         IDE_STATUS_REG
158 #define IDE_ALTSTATUS_REG       IDE_CONTROL_REG
159 #define IDE_IREASON_REG         IDE_NSECTOR_REG
160 #define IDE_BCOUNTL_REG         IDE_LCYL_REG
161 #define IDE_BCOUNTH_REG         IDE_HCYL_REG
162
163 #define OK_STAT(stat,good,bad)  (((stat)&((good)|(bad)))==(good))
164 #define BAD_R_STAT              (BUSY_STAT   | ERR_STAT)
165 #define BAD_W_STAT              (BAD_R_STAT  | WRERR_STAT)
166 #define BAD_STAT                (BAD_R_STAT  | DRQ_STAT)
167 #define DRIVE_READY             (READY_STAT  | SEEK_STAT)
168 #define DATA_READY              (DRQ_STAT)
169
170 #define BAD_CRC                 (ABRT_ERR    | ICRC_ERR)
171
172 #define SATA_NR_PORTS           (3)     /* 16 possible ?? */
173
174 #define SATA_STATUS_OFFSET      (0)
175 #define SATA_STATUS_REG         (HWIF(drive)->sata_scr[SATA_STATUS_OFFSET])
176 #define SATA_ERROR_OFFSET       (1)
177 #define SATA_ERROR_REG          (HWIF(drive)->sata_scr[SATA_ERROR_OFFSET])
178 #define SATA_CONTROL_OFFSET     (2)
179 #define SATA_CONTROL_REG        (HWIF(drive)->sata_scr[SATA_CONTROL_OFFSET])
180
181 #define SATA_MISC_OFFSET        (0)
182 #define SATA_MISC_REG           (HWIF(drive)->sata_misc[SATA_MISC_OFFSET])
183 #define SATA_PHY_OFFSET         (1)
184 #define SATA_PHY_REG            (HWIF(drive)->sata_misc[SATA_PHY_OFFSET])
185 #define SATA_IEN_OFFSET         (2)
186 #define SATA_IEN_REG            (HWIF(drive)->sata_misc[SATA_IEN_OFFSET])
187
188 /*
189  * Our Physical Region Descriptor (PRD) table should be large enough
190  * to handle the biggest I/O request we are likely to see.  Since requests
191  * can have no more than 256 sectors, and since the typical blocksize is
192  * two or more sectors, we could get by with a limit of 128 entries here for
193  * the usual worst case.  Most requests seem to include some contiguous blocks,
194  * further reducing the number of table entries required.
195  *
196  * The driver reverts to PIO mode for individual requests that exceed
197  * this limit (possible with 512 byte blocksizes, eg. MSDOS f/s), so handling
198  * 100% of all crazy scenarios here is not necessary.
199  *
200  * As it turns out though, we must allocate a full 4KB page for this,
201  * so the two PRD tables (ide0 & ide1) will each get half of that,
202  * allowing each to have about 256 entries (8 bytes each) from this.
203  */
204 #define PRD_BYTES       8
205 #define PRD_ENTRIES     256
206
207 /*
208  * Some more useful definitions
209  */
210 #define IDE_MAJOR_NAME  "hd"    /* the same for all i/f; see also genhd.c */
211 #define MAJOR_NAME      IDE_MAJOR_NAME
212 #define PARTN_BITS      6       /* number of minor dev bits for partitions */
213 #define PARTN_MASK      ((1<<PARTN_BITS)-1)     /* a useful bit mask */
214 #define MAX_DRIVES      2       /* per interface; 2 assumed by lots of code */
215 #define SECTOR_SIZE     512
216 #define SECTOR_WORDS    (SECTOR_SIZE / 4)       /* number of 32bit words per sector */
217 #define IDE_LARGE_SEEK(b1,b2,t) (((b1) > (b2) + (t)) || ((b2) > (b1) + (t)))
218
219 /*
220  * Timeouts for various operations:
221  */
222 #define WAIT_DRQ        (HZ/10)         /* 100msec - spec allows up to 20ms */
223 #if defined(CONFIG_APM) || defined(CONFIG_APM_MODULE)
224 #define WAIT_READY      (5*HZ)          /* 5sec - some laptops are very slow */
225 #else
226 #define WAIT_READY      (HZ/10)         /* 100msec - should be instantaneous */
227 #endif /* CONFIG_APM || CONFIG_APM_MODULE */
228 #define WAIT_PIDENTIFY  (10*HZ) /* 10sec  - should be less than 3ms (?), if all ATAPI CD is closed at boot */
229 #define WAIT_WORSTCASE  (30*HZ) /* 30sec  - worst case when spinning up */
230 #define WAIT_CMD        (10*HZ) /* 10sec  - maximum wait for an IRQ to happen */
231 #define WAIT_MIN_SLEEP  (2*HZ/100)      /* 20msec - minimum sleep time */
232
233 #define HOST(hwif,chipset)                                      \
234 {                                                               \
235         return ((hwif)->chipset == chipset) ? 1 : 0;            \
236 }
237
238 /*
239  * Check for an interrupt and acknowledge the interrupt status
240  */
241 struct hwif_s;
242 typedef int (ide_ack_intr_t)(struct hwif_s *);
243
244 #ifndef NO_DMA
245 #define NO_DMA  255
246 #endif
247
248 /*
249  * hwif_chipset_t is used to keep track of the specific hardware
250  * chipset used by each IDE interface, if known.
251  */
252 typedef enum {  ide_unknown,    ide_generic,    ide_pci,
253                 ide_cmd640,     ide_dtc2278,    ide_ali14xx,
254                 ide_qd65xx,     ide_umc8672,    ide_ht6560b,
255                 ide_pdc4030,    ide_rz1000,     ide_trm290,
256                 ide_cmd646,     ide_cy82c693,   ide_4drives,
257                 ide_pmac,       ide_etrax100,   ide_acorn,
258                 ide_forced
259 } hwif_chipset_t;
260
261 /*
262  * Structure to hold all information about the location of this port
263  */
264 typedef struct hw_regs_s {
265         unsigned long   io_ports[IDE_NR_PORTS]; /* task file registers */
266         int             irq;                    /* our irq number */
267         int             dma;                    /* our dma entry */
268         ide_ack_intr_t  *ack_intr;              /* acknowledge interrupt */
269         void            *priv;                  /* interface specific data */
270         hwif_chipset_t  chipset;
271         unsigned long   sata_scr[SATA_NR_PORTS];
272         unsigned long   sata_misc[SATA_NR_PORTS];
273 } hw_regs_t;
274
275 /*
276  * Register new hardware with ide
277  */
278 int ide_register_hw(hw_regs_t *hw, struct hwif_s **hwifp);
279
280 /*
281  * Set up hw_regs_t structure before calling ide_register_hw (optional)
282  */
283 void ide_setup_ports(   hw_regs_t *hw,
284                         unsigned long base,
285                         int *offsets,
286                         unsigned long ctrl,
287                         unsigned long intr,
288                         ide_ack_intr_t *ack_intr,
289 #if 0
290                         ide_io_ops_t *iops,
291 #endif
292                         int irq);
293
294 static inline void ide_std_init_ports(hw_regs_t *hw,
295                                       unsigned long io_addr,
296                                       unsigned long ctl_addr)
297 {
298         unsigned int i;
299
300         for (i = IDE_DATA_OFFSET; i <= IDE_STATUS_OFFSET; i++)
301                 hw->io_ports[i] = io_addr++;
302
303         hw->io_ports[IDE_CONTROL_OFFSET] = ctl_addr;
304 }
305
306 #include <asm/ide.h>
307
308 /* needed on alpha, x86/x86_64, ia64, mips, ppc32 and sh */
309 #ifndef IDE_ARCH_OBSOLETE_DEFAULTS
310 # define ide_default_io_base(index)     (0)
311 # define ide_default_irq(base)          (0)
312 # define ide_init_default_irq(base)     (0)
313 #endif
314
315 /*
316  * ide_init_hwif_ports() is OBSOLETE and will be removed in 2.7 series.
317  * New ports shouldn't define IDE_ARCH_OBSOLETE_INIT in <asm/ide.h>.
318  */
319 #ifdef IDE_ARCH_OBSOLETE_INIT
320 static inline void ide_init_hwif_ports(hw_regs_t *hw,
321                                        unsigned long io_addr,
322                                        unsigned long ctl_addr,
323                                        int *irq)
324 {
325         if (!ctl_addr)
326                 ide_std_init_ports(hw, io_addr, ide_default_io_ctl(io_addr));
327         else
328                 ide_std_init_ports(hw, io_addr, ctl_addr);
329
330         if (irq)
331                 *irq = 0;
332
333         hw->io_ports[IDE_IRQ_OFFSET] = 0;
334
335 #ifdef CONFIG_PPC32
336         if (ppc_ide_md.ide_init_hwif)
337                 ppc_ide_md.ide_init_hwif(hw, io_addr, ctl_addr, irq);
338 #endif
339 }
340 #else
341 static inline void ide_init_hwif_ports(hw_regs_t *hw,
342                                        unsigned long io_addr,
343                                        unsigned long ctl_addr,
344                                        int *irq)
345 {
346         if (io_addr || ctl_addr)
347                 printk(KERN_WARNING "%s: must not be called\n", __FUNCTION__);
348 }
349 #endif /* IDE_ARCH_OBSOLETE_INIT */
350
351 /* Currently only m68k, apus and m8xx need it */
352 #ifndef IDE_ARCH_ACK_INTR
353 # define ide_ack_intr(hwif) (1)
354 #endif
355
356 /* Currently only Atari needs it */
357 #ifndef IDE_ARCH_LOCK
358 # define ide_release_lock()                     do {} while (0)
359 # define ide_get_lock(hdlr, data)               do {} while (0)
360 #endif /* IDE_ARCH_LOCK */
361
362 /*
363  * Now for the data we need to maintain per-drive:  ide_drive_t
364  */
365
366 #define ide_scsi        0x21
367 #define ide_disk        0x20
368 #define ide_optical     0x7
369 #define ide_cdrom       0x5
370 #define ide_tape        0x1
371 #define ide_floppy      0x0
372
373 /*
374  * Special Driver Flags
375  *
376  * set_geometry : respecify drive geometry
377  * recalibrate  : seek to cyl 0
378  * set_multmode : set multmode count
379  * set_tune     : tune interface for drive
380  * serviced     : service command
381  * reserved     : unused
382  */
383 typedef union {
384         unsigned all                    : 8;
385         struct {
386 #if defined(__LITTLE_ENDIAN_BITFIELD)
387                 unsigned set_geometry   : 1;
388                 unsigned recalibrate    : 1;
389                 unsigned set_multmode   : 1;
390                 unsigned set_tune       : 1;
391                 unsigned serviced       : 1;
392                 unsigned reserved       : 3;
393 #elif defined(__BIG_ENDIAN_BITFIELD)
394                 unsigned reserved       : 3;
395                 unsigned serviced       : 1;
396                 unsigned set_tune       : 1;
397                 unsigned set_multmode   : 1;
398                 unsigned recalibrate    : 1;
399                 unsigned set_geometry   : 1;
400 #else
401 #error "Please fix <asm/byteorder.h>"
402 #endif
403         } b;
404 } special_t;
405
406 /*
407  * ATA DATA Register Special.
408  * ATA NSECTOR Count Register().
409  * ATAPI Byte Count Register.
410  * Channel index ordering pairs.
411  */
412 typedef union {
413         unsigned all                    :16;
414         struct {
415 #if defined(__LITTLE_ENDIAN_BITFIELD)
416                 unsigned low            :8;     /* LSB */
417                 unsigned high           :8;     /* MSB */
418 #elif defined(__BIG_ENDIAN_BITFIELD)
419                 unsigned high           :8;     /* MSB */
420                 unsigned low            :8;     /* LSB */
421 #else
422 #error "Please fix <asm/byteorder.h>"
423 #endif
424         } b;
425 } ata_nsector_t, ata_data_t, atapi_bcount_t, ata_index_t;
426
427 /*
428  * ATA-IDE Error Register
429  *
430  * mark         : Bad address mark
431  * tzero        : Couldn't find track 0
432  * abrt         : Aborted Command
433  * mcr          : Media Change Request
434  * id           : ID field not found
435  * mce          : Media Change Event
436  * ecc          : Uncorrectable ECC error
437  * bdd          : dual meaing
438  */
439 typedef union {
440         unsigned all                    :8;
441         struct {
442 #if defined(__LITTLE_ENDIAN_BITFIELD)
443                 unsigned mark           :1;
444                 unsigned tzero          :1;
445                 unsigned abrt           :1;
446                 unsigned mcr            :1;
447                 unsigned id             :1;
448                 unsigned mce            :1;
449                 unsigned ecc            :1;
450                 unsigned bdd            :1;
451 #elif defined(__BIG_ENDIAN_BITFIELD)
452                 unsigned bdd            :1;
453                 unsigned ecc            :1;
454                 unsigned mce            :1;
455                 unsigned id             :1;
456                 unsigned mcr            :1;
457                 unsigned abrt           :1;
458                 unsigned tzero          :1;
459                 unsigned mark           :1;
460 #else
461 #error "Please fix <asm/byteorder.h>"
462 #endif
463         } b;
464 } ata_error_t;
465
466 /*
467  * ATA-IDE Select Register, aka Device-Head
468  *
469  * head         : always zeros here
470  * unit         : drive select number: 0/1
471  * bit5         : always 1
472  * lba          : using LBA instead of CHS
473  * bit7         : always 1
474  */
475 typedef union {
476         unsigned all                    : 8;
477         struct {
478 #if defined(__LITTLE_ENDIAN_BITFIELD)
479                 unsigned head           : 4;
480                 unsigned unit           : 1;
481                 unsigned bit5           : 1;
482                 unsigned lba            : 1;
483                 unsigned bit7           : 1;
484 #elif defined(__BIG_ENDIAN_BITFIELD)
485                 unsigned bit7           : 1;
486                 unsigned lba            : 1;
487                 unsigned bit5           : 1;
488                 unsigned unit           : 1;
489                 unsigned head           : 4;
490 #else
491 #error "Please fix <asm/byteorder.h>"
492 #endif
493         } b;
494 } select_t, ata_select_t;
495
496 /*
497  * The ATA-IDE Status Register.
498  * The ATAPI Status Register.
499  *
500  * check        : Error occurred
501  * idx          : Index Error
502  * corr         : Correctable error occurred
503  * drq          : Data is request by the device
504  * dsc          : Disk Seek Complete                    : ata
505  *              : Media access command finished         : atapi
506  * df           : Device Fault                          : ata
507  *              : Reserved                              : atapi
508  * drdy         : Ready, Command Mode Capable           : ata
509  *              : Ignored for ATAPI commands            : atapi
510  * bsy          : Disk is Busy
511  *              : The device has access to the command block
512  */
513 typedef union {
514         unsigned all                    :8;
515         struct {
516 #if defined(__LITTLE_ENDIAN_BITFIELD)
517                 unsigned check          :1;
518                 unsigned idx            :1;
519                 unsigned corr           :1;
520                 unsigned drq            :1;
521                 unsigned dsc            :1;
522                 unsigned df             :1;
523                 unsigned drdy           :1;
524                 unsigned bsy            :1;
525 #elif defined(__BIG_ENDIAN_BITFIELD)
526                 unsigned bsy            :1;
527                 unsigned drdy           :1;
528                 unsigned df             :1;
529                 unsigned dsc            :1;
530                 unsigned drq            :1;
531                 unsigned corr           :1;
532                 unsigned idx            :1;
533                 unsigned check          :1;
534 #else
535 #error "Please fix <asm/byteorder.h>"
536 #endif
537         } b;
538 } ata_status_t, atapi_status_t;
539
540 /*
541  * ATA-IDE Control Register
542  *
543  * bit0         : Should be set to zero
544  * nIEN         : device INTRQ to host
545  * SRST         : host soft reset bit
546  * bit3         : ATA-2 thingy, Should be set to 1
547  * reserved456  : Reserved
548  * HOB          : 48-bit address ordering, High Ordered Bit
549  */
550 typedef union {
551         unsigned all                    : 8;
552         struct {
553 #if defined(__LITTLE_ENDIAN_BITFIELD)
554                 unsigned bit0           : 1;
555                 unsigned nIEN           : 1;
556                 unsigned SRST           : 1;
557                 unsigned bit3           : 1;
558                 unsigned reserved456    : 3;
559                 unsigned HOB            : 1;
560 #elif defined(__BIG_ENDIAN_BITFIELD)
561                 unsigned HOB            : 1;
562                 unsigned reserved456    : 3;
563                 unsigned bit3           : 1;
564                 unsigned SRST           : 1;
565                 unsigned nIEN           : 1;
566                 unsigned bit0           : 1;
567 #else
568 #error "Please fix <asm/byteorder.h>"
569 #endif
570         } b;
571 } ata_control_t;
572
573 /*
574  * ATAPI Feature Register
575  *
576  * dma          : Using DMA or PIO
577  * reserved321  : Reserved
578  * reserved654  : Reserved (Tag Type)
579  * reserved7    : Reserved
580  */
581 typedef union {
582         unsigned all                    :8;
583         struct {
584 #if defined(__LITTLE_ENDIAN_BITFIELD)
585                 unsigned dma            :1;
586                 unsigned reserved321    :3;
587                 unsigned reserved654    :3;
588                 unsigned reserved7      :1;
589 #elif defined(__BIG_ENDIAN_BITFIELD)
590                 unsigned reserved7      :1;
591                 unsigned reserved654    :3;
592                 unsigned reserved321    :3;
593                 unsigned dma            :1;
594 #else
595 #error "Please fix <asm/byteorder.h>"
596 #endif
597         } b;
598 } atapi_feature_t;
599
600 /*
601  * ATAPI Interrupt Reason Register.
602  *
603  * cod          : Information transferred is command (1) or data (0)
604  * io           : The device requests us to read (1) or write (0)
605  * reserved     : Reserved
606  */
607 typedef union {
608         unsigned all                    :8;
609         struct {
610 #if defined(__LITTLE_ENDIAN_BITFIELD)
611                 unsigned cod            :1;
612                 unsigned io             :1;
613                 unsigned reserved       :6;
614 #elif defined(__BIG_ENDIAN_BITFIELD)
615                 unsigned reserved       :6;
616                 unsigned io             :1;
617                 unsigned cod            :1;
618 #else
619 #error "Please fix <asm/byteorder.h>"
620 #endif
621         } b;
622 } atapi_ireason_t;
623
624 /*
625  * The ATAPI error register.
626  *
627  * ili          : Illegal Length Indication
628  * eom          : End Of Media Detected
629  * abrt         : Aborted command - As defined by ATA
630  * mcr          : Media Change Requested - As defined by ATA
631  * sense_key    : Sense key of the last failed packet command
632  */
633 typedef union {
634         unsigned all                    :8;
635         struct {
636 #if defined(__LITTLE_ENDIAN_BITFIELD)
637                 unsigned ili            :1;
638                 unsigned eom            :1;
639                 unsigned abrt           :1;
640                 unsigned mcr            :1;
641                 unsigned sense_key      :4;
642 #elif defined(__BIG_ENDIAN_BITFIELD)
643                 unsigned sense_key      :4;
644                 unsigned mcr            :1;
645                 unsigned abrt           :1;
646                 unsigned eom            :1;
647                 unsigned ili            :1;
648 #else
649 #error "Please fix <asm/byteorder.h>"
650 #endif
651         } b;
652 } atapi_error_t;
653
654 /*
655  * ATAPI floppy Drive Select Register
656  *
657  * sam_lun      : Logical unit number
658  * reserved3    : Reserved
659  * drv          : The responding drive will be drive 0 (0) or drive 1 (1)
660  * one5         : Should be set to 1
661  * reserved6    : Reserved
662  * one7         : Should be set to 1
663  */
664 typedef union {
665         unsigned all                    :8;
666         struct {
667 #if defined(__LITTLE_ENDIAN_BITFIELD)
668                 unsigned sam_lun        :3;
669                 unsigned reserved3      :1;
670                 unsigned drv            :1;
671                 unsigned one5           :1;
672                 unsigned reserved6      :1;
673                 unsigned one7           :1;
674 #elif defined(__BIG_ENDIAN_BITFIELD)
675                 unsigned one7           :1;
676                 unsigned reserved6      :1;
677                 unsigned one5           :1;
678                 unsigned drv            :1;
679                 unsigned reserved3      :1;
680                 unsigned sam_lun        :3;
681 #else
682 #error "Please fix <asm/byteorder.h>"
683 #endif
684         } b;
685 } atapi_select_t;
686
687 /*
688  * Status returned from various ide_ functions
689  */
690 typedef enum {
691         ide_stopped,    /* no drive operation was started */
692         ide_started,    /* a drive operation was started, handler was set */
693 } ide_startstop_t;
694
695 struct ide_driver_s;
696 struct ide_settings_s;
697
698 typedef struct ide_drive_s {
699         char            name[4];        /* drive name, such as "hda" */
700         char            driver_req[10]; /* requests specific driver */
701
702         request_queue_t         *queue; /* request queue */
703
704         struct request          *rq;    /* current request */
705         struct ide_drive_s      *next;  /* circular list of hwgroup drives */
706         struct ide_driver_s     *driver;/* (ide_driver_t *) */
707         void            *driver_data;   /* extra driver data */
708         struct hd_driveid       *id;    /* drive model identification info */
709         struct proc_dir_entry *proc;    /* /proc/ide/ directory entry */
710         struct ide_settings_s *settings;/* /proc/ide/ drive settings */
711         char            devfs_name[64]; /* devfs crap */
712
713         struct hwif_s           *hwif;  /* actually (ide_hwif_t *) */
714
715         unsigned long sleep;            /* sleep until this time */
716         unsigned long service_start;    /* time we started last request */
717         unsigned long service_time;     /* service time of last request */
718         unsigned long timeout;          /* max time to wait for irq */
719
720         special_t       special;        /* special action flags */
721         select_t        select;         /* basic drive/head select reg value */
722
723         u8      keep_settings;          /* restore settings after drive reset */
724         u8      autodma;                /* device can safely use dma on host */
725         u8      using_dma;              /* disk is using dma for read/write */
726         u8      retry_pio;              /* retrying dma capable host in pio */
727         u8      state;                  /* retry state */
728         u8      waiting_for_dma;        /* dma currently in progress */
729         u8      unmask;                 /* okay to unmask other irqs */
730         u8      bswap;                  /* byte swap data */
731         u8      dsc_overlap;            /* DSC overlap */
732         u8      nice1;                  /* give potential excess bandwidth */
733
734         unsigned present        : 1;    /* drive is physically present */
735         unsigned dead           : 1;    /* device ejected hint */
736         unsigned id_read        : 1;    /* 1=id read from disk 0 = synthetic */
737         unsigned noprobe        : 1;    /* from:  hdx=noprobe */
738         unsigned removable      : 1;    /* 1 if need to do check_media_change */
739         unsigned attach         : 1;    /* needed for removable devices */
740         unsigned is_flash       : 1;    /* 1 if probed as flash */
741         unsigned forced_geom    : 1;    /* 1 if hdx=c,h,s was given at boot */
742         unsigned no_unmask      : 1;    /* disallow setting unmask bit */
743         unsigned no_io_32bit    : 1;    /* disallow enabling 32bit I/O */
744         unsigned atapi_overlap  : 1;    /* ATAPI overlap (not supported) */
745         unsigned nice0          : 1;    /* give obvious excess bandwidth */
746         unsigned nice2          : 1;    /* give a share in our own bandwidth */
747         unsigned doorlocking    : 1;    /* for removable only: door lock/unlock works */
748         unsigned autotune       : 2;    /* 0=default, 1=autotune, 2=noautotune */
749         unsigned remap_0_to_1   : 1;    /* 0=noremap, 1=remap 0->1 (for EZDrive) */
750         unsigned blocked        : 1;    /* 1=powermanagment told us not to do anything, so sleep nicely */
751         unsigned vdma           : 1;    /* 1=doing PIO over DMA 0=doing normal DMA */
752         unsigned stroke         : 1;    /* from:  hdx=stroke */
753         unsigned addressing;            /*      : 3;
754                                          *  0=28-bit
755                                          *  1=48-bit
756                                          *  2=48-bit doing 28-bit
757                                          *  3=64-bit
758                                          */
759
760         u8      scsi;           /* 0=default, 1=skip current ide-subdriver for ide-scsi emulation */
761         u8      quirk_list;     /* considered quirky, set for a specific host */
762         u8      suspend_reset;  /* drive suspend mode flag, soft-reset recovers */
763         u8      init_speed;     /* transfer rate set at boot */
764         u8      pio_speed;      /* unused by core, used by some drivers for fallback from DMA */
765         u8      current_speed;  /* current transfer rate set */
766         u8      dn;             /* now wide spread use */
767         u8      wcache;         /* status of write cache */
768         u8      acoustic;       /* acoustic management */
769         u8      media;          /* disk, cdrom, tape, floppy, ... */
770         u8      ctl;            /* "normal" value for IDE_CONTROL_REG */
771         u8      ready_stat;     /* min status value for drive ready */
772         u8      mult_count;     /* current multiple sector setting */
773         u8      mult_req;       /* requested multiple sector setting */
774         u8      tune_req;       /* requested drive tuning setting */
775         u8      io_32bit;       /* 0=16-bit, 1=32-bit, 2/3=32bit+sync */
776         u8      bad_wstat;      /* used for ignoring WRERR_STAT */
777         u8      nowerr;         /* used for ignoring WRERR_STAT */
778         u8      sect0;          /* offset of first sector for DM6:DDO */
779         u8      head;           /* "real" number of heads */
780         u8      sect;           /* "real" sectors per track */
781         u8      bios_head;      /* BIOS/fdisk/LILO number of heads */
782         u8      bios_sect;      /* BIOS/fdisk/LILO sectors per track */
783
784         unsigned int    bios_cyl;       /* BIOS/fdisk/LILO number of cyls */
785         unsigned int    cyl;            /* "real" number of cyls */
786         unsigned int    drive_data;     /* use by tuneproc/selectproc */
787         unsigned int    usage;          /* current "open()" count for drive */
788         unsigned int    failures;       /* current failure count */
789         unsigned int    max_failures;   /* maximum allowed failure count */
790
791         u64             capacity64;     /* total number of sectors */
792
793         int             lun;            /* logical unit */
794         int             crc_count;      /* crc counter to reduce drive speed */
795         struct list_head list;
796         struct device   gendev;
797         struct semaphore gendev_rel_sem;        /* to deal with device release() */
798         struct gendisk *disk;
799 } ide_drive_t;
800
801 typedef struct ide_pio_ops_s {
802         void (*ata_input_data)(ide_drive_t *, void *, u32);
803         void (*ata_output_data)(ide_drive_t *, void *, u32);
804
805         void (*atapi_input_bytes)(ide_drive_t *, void *, u32);
806         void (*atapi_output_bytes)(ide_drive_t *, void *, u32);
807 } ide_pio_ops_t;
808
809 typedef struct ide_dma_ops_s {
810         /* insert dma operations here! */
811         int (*ide_dma_read)(ide_drive_t *drive);
812         int (*ide_dma_write)(ide_drive_t *drive);
813         int (*ide_dma_begin)(ide_drive_t *drive);
814         int (*ide_dma_end)(ide_drive_t *drive);
815         int (*ide_dma_check)(ide_drive_t *drive);
816         int (*ide_dma_on)(ide_drive_t *drive);
817         int (*ide_dma_off_quietly)(ide_drive_t *drive);
818         int (*ide_dma_test_irq)(ide_drive_t *drive);
819         int (*ide_dma_host_on)(ide_drive_t *drive);
820         int (*ide_dma_host_off)(ide_drive_t *drive);
821         int (*ide_dma_verbose)(ide_drive_t *drive);
822         int (*ide_dma_lostirq)(ide_drive_t *drive);
823         int (*ide_dma_timeout)(ide_drive_t *drive);
824 } ide_dma_ops_t;
825
826 /*
827  * mapping stuff, prepare for highmem...
828  * 
829  * temporarily mapping a (possible) highmem bio for PIO transfer
830  */
831 #ifndef CONFIG_IDE_TASKFILE_IO
832
833 #define ide_rq_offset(rq) \
834         (((rq)->hard_cur_sectors - (rq)->current_nr_sectors) << 9)
835
836 static inline void *ide_map_buffer(struct request *rq, unsigned long *flags)
837 {
838         return bio_kmap_irq(rq->bio, flags) + ide_rq_offset(rq);
839 }
840
841 static inline void ide_unmap_buffer(struct request *rq, char *buffer, unsigned long *flags)
842 {
843         bio_kunmap_irq(buffer, flags);
844 }
845 #endif /* !CONFIG_IDE_TASKFILE_IO */
846
847 #define IDE_CHIPSET_PCI_MASK    \
848     ((1<<ide_pci)|(1<<ide_cmd646)|(1<<ide_ali14xx))
849 #define IDE_CHIPSET_IS_PCI(c)   ((IDE_CHIPSET_PCI_MASK >> (c)) & 1)
850
851 struct ide_pci_device_s;
852
853 typedef struct hwif_s {
854         struct hwif_s *next;            /* for linked-list in ide_hwgroup_t */
855         struct hwif_s *mate;            /* other hwif from same PCI chip */
856         struct hwgroup_s *hwgroup;      /* actually (ide_hwgroup_t *) */
857         struct proc_dir_entry *proc;    /* /proc/ide/ directory entry */
858
859         char name[6];                   /* name of interface, eg. "ide0" */
860
861                 /* task file registers for pata and sata */
862         unsigned long   io_ports[IDE_NR_PORTS];
863         unsigned long   sata_scr[SATA_NR_PORTS];
864         unsigned long   sata_misc[SATA_NR_PORTS];
865
866         hw_regs_t       hw;             /* Hardware info */
867         ide_drive_t     drives[MAX_DRIVES];     /* drive info */
868
869         u8 major;       /* our major number */
870         u8 index;       /* 0 for ide0; 1 for ide1; ... */
871         u8 channel;     /* for dual-port chips: 0=primary, 1=secondary */
872         u8 straight8;   /* Alan's straight 8 check */
873         u8 bus_state;   /* power state of the IDE bus */
874
875         u8 atapi_dma;   /* host supports atapi_dma */
876         u8 ultra_mask;
877         u8 mwdma_mask;
878         u8 swdma_mask;
879
880         hwif_chipset_t chipset; /* sub-module for tuning.. */
881
882         struct pci_dev  *pci_dev;       /* for pci chipsets */
883         struct ide_pci_device_s *cds;   /* chipset device struct */
884
885         ide_startstop_t (*rw_disk)(ide_drive_t *, struct request *, sector_t);
886
887 #if 0
888         ide_hwif_ops_t  *hwifops;
889 #else
890         /* routine is for HBA specific IDENTITY operations */
891         int     (*identify)(ide_drive_t *);
892         /* routine to tune PIO mode for drives */
893         void    (*tuneproc)(ide_drive_t *, u8);
894         /* routine to retune DMA modes for drives */
895         int     (*speedproc)(ide_drive_t *, u8);
896         /* tweaks hardware to select drive */
897         void    (*selectproc)(ide_drive_t *);
898         /* chipset polling based on hba specifics */
899         int     (*reset_poll)(ide_drive_t *);
900         /* chipset specific changes to default for device-hba resets */
901         void    (*pre_reset)(ide_drive_t *);
902         /* routine to reset controller after a disk reset */
903         void    (*resetproc)(ide_drive_t *);
904         /* special interrupt handling for shared pci interrupts */
905         void    (*intrproc)(ide_drive_t *);
906         /* special host masking for drive selection */
907         void    (*maskproc)(ide_drive_t *, int);
908         /* check host's drive quirk list */
909         int     (*quirkproc)(ide_drive_t *);
910         /* driver soft-power interface */
911         int     (*busproc)(ide_drive_t *, int);
912 //      /* host rate limiter */
913 //      u8      (*ratemask)(ide_drive_t *);
914 //      /* device rate limiter */
915 //      u8      (*ratefilter)(ide_drive_t *, u8);
916 #endif
917
918 #if 0
919         ide_pio_ops_t   *pioops;
920 #else
921         void (*ata_input_data)(ide_drive_t *, void *, u32);
922         void (*ata_output_data)(ide_drive_t *, void *, u32);
923
924         void (*atapi_input_bytes)(ide_drive_t *, void *, u32);
925         void (*atapi_output_bytes)(ide_drive_t *, void *, u32);
926 #endif
927
928         int (*ide_dma_read)(ide_drive_t *drive);
929         int (*ide_dma_write)(ide_drive_t *drive);
930         int (*ide_dma_begin)(ide_drive_t *drive);
931         int (*ide_dma_end)(ide_drive_t *drive);
932         int (*ide_dma_check)(ide_drive_t *drive);
933         int (*ide_dma_on)(ide_drive_t *drive);
934         int (*ide_dma_off_quietly)(ide_drive_t *drive);
935         int (*ide_dma_test_irq)(ide_drive_t *drive);
936         int (*ide_dma_host_on)(ide_drive_t *drive);
937         int (*ide_dma_host_off)(ide_drive_t *drive);
938         int (*ide_dma_verbose)(ide_drive_t *drive);
939         int (*ide_dma_lostirq)(ide_drive_t *drive);
940         int (*ide_dma_timeout)(ide_drive_t *drive);
941
942         void (*OUTB)(u8 addr, unsigned long port);
943         void (*OUTBSYNC)(ide_drive_t *drive, u8 addr, unsigned long port);
944         void (*OUTW)(u16 addr, unsigned long port);
945         void (*OUTL)(u32 addr, unsigned long port);
946         void (*OUTSW)(unsigned long port, void *addr, u32 count);
947         void (*OUTSL)(unsigned long port, void *addr, u32 count);
948
949         u8  (*INB)(unsigned long port);
950         u16 (*INW)(unsigned long port);
951         u32 (*INL)(unsigned long port);
952         void (*INSW)(unsigned long port, void *addr, u32 count);
953         void (*INSL)(unsigned long port, void *addr, u32 count);
954
955         /* dma physical region descriptor table (cpu view) */
956         unsigned int    *dmatable_cpu;
957         /* dma physical region descriptor table (dma view) */
958         dma_addr_t      dmatable_dma;
959         /* Scatter-gather list used to build the above */
960         struct scatterlist *sg_table;
961         int sg_nents;                   /* Current number of entries in it */
962         int sg_dma_direction;           /* dma transfer direction */
963         int sg_dma_active;              /* is it in use */
964
965         int             mmio;           /* hosts iomio (0) or custom (2) select */
966         int             rqsize;         /* max sectors per request */
967         int             irq;            /* our irq number */
968
969         unsigned long   dma_master;     /* reference base addr dmabase */
970         unsigned long   dma_base;       /* base addr for dma ports */
971         unsigned long   dma_command;    /* dma command register */
972         unsigned long   dma_vendor1;    /* dma vendor 1 register */
973         unsigned long   dma_status;     /* dma status register */
974         unsigned long   dma_vendor3;    /* dma vendor 3 register */
975         unsigned long   dma_prdtable;   /* actual prd table address */
976         unsigned long   dma_base2;      /* extended base addr for dma ports */
977
978         unsigned        dma_extra;      /* extra addr for dma ports */
979         unsigned long   config_data;    /* for use by chipset-specific code */
980         unsigned long   select_data;    /* for use by chipset-specific code */
981
982         unsigned        noprobe    : 1; /* don't probe for this interface */
983         unsigned        present    : 1; /* this interface exists */
984         unsigned        hold       : 1; /* this interface is always present */
985         unsigned        serialized : 1; /* serialized all channel operation */
986         unsigned        sharing_irq: 1; /* 1 = sharing irq with another hwif */
987         unsigned        reset      : 1; /* reset after probe */
988         unsigned        autodma    : 1; /* auto-attempt using DMA at boot */
989         unsigned        udma_four  : 1; /* 1=ATA-66 capable, 0=default */
990         unsigned        no_lba48   : 1; /* 1 = cannot do LBA48 */
991         unsigned        no_dsc     : 1; /* 0 default, 1 dsc_overlap disabled */
992         unsigned        auto_poll  : 1; /* supports nop auto-poll */
993
994         struct device   gendev;
995         struct semaphore gendev_rel_sem; /* To deal with device release() */
996
997         void            *hwif_data;     /* extra hwif data */
998
999         unsigned dma;
1000
1001         void (*led_act)(void *data, int rw);
1002 } ide_hwif_t;
1003
1004 /*
1005  *  internal ide interrupt handler type
1006  */
1007 typedef ide_startstop_t (ide_pre_handler_t)(ide_drive_t *, struct request *);
1008 typedef ide_startstop_t (ide_handler_t)(ide_drive_t *);
1009 typedef int (ide_expiry_t)(ide_drive_t *);
1010
1011 typedef struct hwgroup_s {
1012                 /* irq handler, if active */
1013         ide_startstop_t (*handler)(ide_drive_t *);
1014                 /* irq handler, suspended if active */
1015         ide_startstop_t (*handler_save)(ide_drive_t *);
1016                 /* BOOL: protects all fields below */
1017         volatile int busy;
1018                 /* BOOL: wake us up on timer expiry */
1019         int sleeping;
1020                 /* current drive */
1021         ide_drive_t *drive;
1022                 /* ptr to current hwif in linked-list */
1023         ide_hwif_t *hwif;
1024
1025                 /* for pci chipsets */
1026         struct pci_dev *pci_dev;
1027                 /* chipset device struct */
1028         struct ide_pci_device_s *cds;
1029
1030                 /* current request */
1031         struct request *rq;
1032                 /* failsafe timer */
1033         struct timer_list timer;
1034                 /* local copy of current write rq */
1035         struct request wrq;
1036                 /* timeout value during long polls */
1037         unsigned long poll_timeout;
1038                 /* queried upon timeouts */
1039         int (*expiry)(ide_drive_t *);
1040                 /* ide_system_bus_speed */
1041         int pio_clock;
1042
1043         unsigned char cmd_buf[4];
1044 } ide_hwgroup_t;
1045
1046 /* structure attached to the request for IDE_TASK_CMDS */
1047
1048 /*
1049  * configurable drive settings
1050  */
1051
1052 #define TYPE_INT        0
1053 #define TYPE_INTA       1
1054 #define TYPE_BYTE       2
1055 #define TYPE_SHORT      3
1056
1057 #define SETTING_READ    (1 << 0)
1058 #define SETTING_WRITE   (1 << 1)
1059 #define SETTING_RW      (SETTING_READ | SETTING_WRITE)
1060
1061 typedef int (ide_procset_t)(ide_drive_t *, int);
1062 typedef struct ide_settings_s {
1063         char                    *name;
1064         int                     rw;
1065         int                     read_ioctl;
1066         int                     write_ioctl;
1067         int                     data_type;
1068         int                     min;
1069         int                     max;
1070         int                     mul_factor;
1071         int                     div_factor;
1072         void                    *data;
1073         ide_procset_t           *set;
1074         int                     auto_remove;
1075         struct ide_settings_s   *next;
1076 } ide_settings_t;
1077
1078 extern struct semaphore ide_setting_sem;
1079 extern int ide_add_setting(ide_drive_t *drive, const char *name, int rw, int read_ioctl, int write_ioctl, int data_type, int min, int max, int mul_factor, int div_factor, void *data, ide_procset_t *set);
1080 extern ide_settings_t *ide_find_setting_by_name(ide_drive_t *drive, char *name);
1081 extern int ide_read_setting(ide_drive_t *t, ide_settings_t *setting);
1082 extern int ide_write_setting(ide_drive_t *drive, ide_settings_t *setting, int val);
1083 extern void ide_add_generic_settings(ide_drive_t *drive);
1084
1085 /*
1086  * /proc/ide interface
1087  */
1088 typedef struct {
1089         const char      *name;
1090         mode_t          mode;
1091         read_proc_t     *read_proc;
1092         write_proc_t    *write_proc;
1093 } ide_proc_entry_t;
1094
1095 #ifdef CONFIG_PROC_FS
1096 extern struct proc_dir_entry *proc_ide_root;
1097
1098 extern void proc_ide_create(void);
1099 extern void proc_ide_destroy(void);
1100 extern void destroy_proc_ide_drives(ide_hwif_t *);
1101 extern void create_proc_ide_interfaces(void);
1102 extern void ide_add_proc_entries(struct proc_dir_entry *, ide_proc_entry_t *, void *);
1103 extern void ide_remove_proc_entries(struct proc_dir_entry *, ide_proc_entry_t *);
1104 read_proc_t proc_ide_read_capacity;
1105 read_proc_t proc_ide_read_geometry;
1106
1107 #ifdef CONFIG_BLK_DEV_IDEPCI
1108 void ide_pci_create_host_proc(const char *, get_info_t *);
1109 #endif
1110
1111 /*
1112  * Standard exit stuff:
1113  */
1114 #define PROC_IDE_READ_RETURN(page,start,off,count,eof,len) \
1115 {                                       \
1116         len -= off;                     \
1117         if (len < count) {              \
1118                 *eof = 1;               \
1119                 if (len <= 0)           \
1120                         return 0;       \
1121         } else                          \
1122                 len = count;            \
1123         *start = page + off;            \
1124         return len;                     \
1125 }
1126 #else
1127 static inline void create_proc_ide_interfaces(void) { ; }
1128 #define PROC_IDE_READ_RETURN(page,start,off,count,eof,len) return 0;
1129 #endif
1130
1131 /*
1132  * Power Management step value (rq->pm->pm_step).
1133  *
1134  * The step value starts at 0 (ide_pm_state_start_suspend) for a
1135  * suspend operation or 1000 (ide_pm_state_start_resume) for a
1136  * resume operation.
1137  *
1138  * For each step, the core calls the subdriver start_power_step() first.
1139  * This can return:
1140  *      - ide_stopped : In this case, the core calls us back again unless
1141  *                      step have been set to ide_power_state_completed.
1142  *      - ide_started : In this case, the channel is left busy until an
1143  *                      async event (interrupt) occurs.
1144  * Typically, start_power_step() will issue a taskfile request with
1145  * do_rw_taskfile().
1146  *
1147  * Upon reception of the interrupt, the core will call complete_power_step()
1148  * with the error code if any. This routine should update the step value
1149  * and return. It should not start a new request. The core will call
1150  * start_power_step for the new step value, unless step have been set to
1151  * ide_power_state_completed.
1152  *
1153  * Subdrivers are expected to define their own additional power
1154  * steps from 1..999 for suspend and from 1001..1999 for resume,
1155  * other values are reserved for future use.
1156  */
1157
1158 enum {
1159         ide_pm_state_completed          = -1,
1160         ide_pm_state_start_suspend      = 0,
1161         ide_pm_state_start_resume       = 1000,
1162 };
1163
1164 /*
1165  * Subdrivers support.
1166  */
1167 typedef struct ide_driver_s {
1168         struct module                   *owner;
1169         const char                      *name;
1170         const char                      *version;
1171         u8                              media;
1172         unsigned busy                   : 1;
1173         unsigned supports_dsc_overlap   : 1;
1174         int             (*cleanup)(ide_drive_t *);
1175         ide_startstop_t (*do_request)(ide_drive_t *, struct request *, sector_t);
1176         int             (*end_request)(ide_drive_t *, int, int);
1177         u8              (*sense)(ide_drive_t *, const char *, u8);
1178         ide_startstop_t (*error)(ide_drive_t *, const char *, u8);
1179         ide_startstop_t (*abort)(ide_drive_t *, const char *);
1180         int             (*ioctl)(ide_drive_t *, struct inode *, struct file *, unsigned int, unsigned long);
1181         void            (*pre_reset)(ide_drive_t *);
1182         sector_t        (*capacity)(ide_drive_t *);
1183         ide_startstop_t (*special)(ide_drive_t *);
1184         ide_proc_entry_t        *proc;
1185         int             (*attach)(ide_drive_t *);
1186         void            (*ata_prebuilder)(ide_drive_t *);
1187         void            (*atapi_prebuilder)(ide_drive_t *);
1188         ide_startstop_t (*start_power_step)(ide_drive_t *, struct request *);
1189         void            (*complete_power_step)(ide_drive_t *, struct request *, u8, u8);
1190         struct device_driver    gen_driver;
1191         struct list_head drives;
1192         struct list_head drivers;
1193 } ide_driver_t;
1194
1195 #define DRIVER(drive)           ((drive)->driver)
1196
1197 extern int generic_ide_ioctl(struct file *, struct block_device *, unsigned, unsigned long);
1198
1199 /*
1200  * ide_hwifs[] is the master data structure used to keep track
1201  * of just about everything in ide.c.  Whenever possible, routines
1202  * should be using pointers to a drive (ide_drive_t *) or
1203  * pointers to a hwif (ide_hwif_t *), rather than indexing this
1204  * structure directly (the allocation/layout may change!).
1205  *
1206  */
1207 #ifndef _IDE_C
1208 extern  ide_hwif_t      ide_hwifs[];            /* master data repository */
1209 #endif
1210 extern int noautodma;
1211
1212 extern int ide_end_request (ide_drive_t *drive, int uptodate, int nrsecs);
1213
1214 /*
1215  * This is used on exit from the driver to designate the next irq handler
1216  * and also to start the safety timer.
1217  */
1218 extern void ide_set_handler (ide_drive_t *drive, ide_handler_t *handler, unsigned int timeout, ide_expiry_t *expiry);
1219
1220 /*
1221  * This is used on exit from the driver to designate the next irq handler
1222  * and start the safety time safely and atomically from the IRQ handler
1223  * with respect to the command issue (which it also does)
1224  */
1225 extern void ide_execute_command(ide_drive_t *, task_ioreg_t cmd, ide_handler_t *, unsigned int, ide_expiry_t *);
1226
1227 /*
1228  * Error reporting, in human readable form (luxurious, but a memory hog).
1229  *
1230  * (drive, msg, status)
1231  */
1232 byte ide_dump_status (ide_drive_t *drive, const char *msg, byte stat);
1233
1234 /*
1235  * ide_error() takes action based on the error returned by the controller.
1236  * The caller should return immediately after invoking this.
1237  *
1238  * (drive, msg, status)
1239  */
1240 ide_startstop_t ide_error (ide_drive_t *drive, const char *msg, byte stat);
1241
1242 /*
1243  * Abort a running command on the controller triggering the abort
1244  * from a host side, non error situation
1245  * (drive, msg)
1246  */
1247 extern ide_startstop_t ide_abort(ide_drive_t *, const char *);
1248
1249 /*
1250  * Issue a simple drive command
1251  * The drive must be selected beforehand.
1252  *
1253  * (drive, command, nsector, handler)
1254  */
1255 extern void ide_cmd(ide_drive_t *, u8, u8, ide_handler_t *);
1256
1257 extern void ide_fix_driveid(struct hd_driveid *);
1258 /*
1259  * ide_fixstring() cleans up and (optionally) byte-swaps a text string,
1260  * removing leading/trailing blanks and compressing internal blanks.
1261  * It is primarily used to tidy up the model name/number fields as
1262  * returned by the WIN_[P]IDENTIFY commands.
1263  *
1264  * (s, bytecount, byteswap)
1265  */
1266 extern void ide_fixstring(u8 *, const int, const int);
1267
1268 /*
1269  * This routine busy-waits for the drive status to be not "busy".
1270  * It then checks the status for all of the "good" bits and none
1271  * of the "bad" bits, and if all is okay it returns 0.  All other
1272  * cases return 1 after doing "*startstop = ide_error()", and the
1273  * caller should return the updated value of "startstop" in this case.
1274  * "startstop" is unchanged when the function returns 0;
1275  * (startstop, drive, good, bad, timeout)
1276  */
1277 extern int ide_wait_stat(ide_startstop_t *, ide_drive_t *, u8, u8, unsigned long);
1278
1279 /*
1280  * Return the current idea about the total capacity of this drive.
1281  */
1282 extern sector_t current_capacity (ide_drive_t *drive);
1283
1284 /*
1285  * Start a reset operation for an IDE interface.
1286  * The caller should return immediately after invoking this.
1287  */
1288 extern ide_startstop_t ide_do_reset (ide_drive_t *);
1289
1290 /*
1291  * This function is intended to be used prior to invoking ide_do_drive_cmd().
1292  */
1293 extern void ide_init_drive_cmd (struct request *rq);
1294
1295 /*
1296  * "action" parameter type for ide_do_drive_cmd() below.
1297  */
1298 typedef enum {
1299         ide_wait,       /* insert rq at end of list, and wait for it */
1300         ide_next,       /* insert rq immediately after current request */
1301         ide_preempt,    /* insert rq in front of current request */
1302         ide_head_wait,  /* insert rq in front of current request and wait for it */
1303         ide_end         /* insert rq at end of list, but don't wait for it */
1304 } ide_action_t;
1305
1306 /*
1307  * This function issues a special IDE device request
1308  * onto the request queue.
1309  *
1310  * If action is ide_wait, then the rq is queued at the end of the
1311  * request queue, and the function sleeps until it has been processed.
1312  * This is for use when invoked from an ioctl handler.
1313  *
1314  * If action is ide_preempt, then the rq is queued at the head of
1315  * the request queue, displacing the currently-being-processed
1316  * request and this function returns immediately without waiting
1317  * for the new rq to be completed.  This is VERY DANGEROUS, and is
1318  * intended for careful use by the ATAPI tape/cdrom driver code.
1319  *
1320  * If action is ide_next, then the rq is queued immediately after
1321  * the currently-being-processed-request (if any), and the function
1322  * returns without waiting for the new rq to be completed.  As above,
1323  * This is VERY DANGEROUS, and is intended for careful use by the
1324  * ATAPI tape/cdrom driver code.
1325  *
1326  * If action is ide_end, then the rq is queued at the end of the
1327  * request queue, and the function returns immediately without waiting
1328  * for the new rq to be completed. This is again intended for careful
1329  * use by the ATAPI tape/cdrom driver code.
1330  */
1331 extern int ide_do_drive_cmd(ide_drive_t *, struct request *, ide_action_t);
1332
1333 /*
1334  * Clean up after success/failure of an explicit drive cmd.
1335  * stat/err are used only when (HWGROUP(drive)->rq->cmd == IDE_DRIVE_CMD).
1336  * stat/err are used only when (HWGROUP(drive)->rq->cmd == IDE_DRIVE_TASK_MASK).
1337  *
1338  * (ide_drive_t *drive, u8 stat, u8 err)
1339  */
1340 extern void ide_end_drive_cmd(ide_drive_t *, u8, u8);
1341
1342 extern void try_to_flush_leftover_data(ide_drive_t *);
1343
1344 /*
1345  * Issue ATA command and wait for completion.
1346  * Use for implementing commands in kernel
1347  *
1348  *  (ide_drive_t *drive, u8 cmd, u8 nsect, u8 feature, u8 sectors, u8 *buf)
1349  */
1350 extern int ide_wait_cmd(ide_drive_t *, u8, u8, u8, u8, u8 *);
1351
1352 /* (ide_drive_t *drive, u8 *buf) */
1353 extern int ide_wait_cmd_task(ide_drive_t *, u8 *);
1354
1355 typedef struct ide_task_s {
1356 /*
1357  *      struct hd_drive_task_hdr        tf;
1358  *      task_struct_t           tf;
1359  *      struct hd_drive_hob_hdr         hobf;
1360  *      hob_struct_t            hobf;
1361  */
1362         task_ioreg_t            tfRegister[8];
1363         task_ioreg_t            hobRegister[8];
1364         ide_reg_valid_t         tf_out_flags;
1365         ide_reg_valid_t         tf_in_flags;
1366         int                     data_phase;
1367         int                     command_type;
1368         ide_pre_handler_t       *prehandler;
1369         ide_handler_t           *handler;
1370         struct request          *rq;            /* copy of request */
1371         void                    *special;       /* valid_t generally */
1372 } ide_task_t;
1373
1374 typedef struct pkt_task_s {
1375 /*
1376  *      struct hd_drive_task_hdr        pktf;
1377  *      task_struct_t           pktf;
1378  *      u8                      pkcdb[12];
1379  */
1380         task_ioreg_t            tfRegister[8];
1381         int                     data_phase;
1382         int                     command_type;
1383         ide_handler_t           *handler;
1384         struct request          *rq;            /* copy of request */
1385         void                    *special;
1386 } pkt_task_t;
1387
1388 extern u32 ide_read_24(ide_drive_t *);
1389
1390 extern void SELECT_DRIVE(ide_drive_t *);
1391 extern void SELECT_INTERRUPT(ide_drive_t *);
1392 extern void SELECT_MASK(ide_drive_t *, int);
1393 extern void QUIRK_LIST(ide_drive_t *);
1394
1395 extern void ata_input_data(ide_drive_t *, void *, u32);
1396 extern void ata_output_data(ide_drive_t *, void *, u32);
1397 extern void atapi_input_bytes(ide_drive_t *, void *, u32);
1398 extern void atapi_output_bytes(ide_drive_t *, void *, u32);
1399 extern void taskfile_input_data(ide_drive_t *, void *, u32);
1400 extern void taskfile_output_data(ide_drive_t *, void *, u32);
1401
1402 #define IDE_PIO_IN      0
1403 #define IDE_PIO_OUT     1
1404
1405 static inline void __task_sectors(ide_drive_t *drive, char *buf,
1406                                   unsigned nsect, unsigned rw)
1407 {
1408         /*
1409          * IRQ can happen instantly after reading/writing
1410          * last sector of the datablock.
1411          */
1412         if (rw == IDE_PIO_OUT)
1413                 taskfile_output_data(drive, buf, nsect * SECTOR_WORDS);
1414         else
1415                 taskfile_input_data(drive, buf, nsect * SECTOR_WORDS);
1416 }
1417
1418 #ifdef CONFIG_IDE_TASKFILE_IO
1419 static inline void task_bio_sectors(ide_drive_t *drive, struct request *rq,
1420                                     unsigned nsect, unsigned rw)
1421 {
1422         unsigned long flags;
1423         char *buf = rq_map_buffer(rq, &flags);
1424
1425         process_that_request_first(rq, nsect);
1426         __task_sectors(drive, buf, nsect, rw);
1427         rq_unmap_buffer(buf, &flags);
1428 }
1429 #endif /* CONFIG_IDE_TASKFILE_IO */
1430
1431 extern int drive_is_ready(ide_drive_t *);
1432 extern int wait_for_ready(ide_drive_t *, int /* timeout */);
1433
1434 /*
1435  * taskfile io for disks for now...and builds request from ide_ioctl
1436  */
1437 extern ide_startstop_t do_rw_taskfile(ide_drive_t *, ide_task_t *);
1438
1439 /*
1440  * Special Flagged Register Validation Caller
1441  */
1442 extern ide_startstop_t flagged_taskfile(ide_drive_t *, ide_task_t *);
1443
1444 extern ide_startstop_t set_multmode_intr(ide_drive_t *);
1445 extern ide_startstop_t set_geometry_intr(ide_drive_t *);
1446 extern ide_startstop_t recal_intr(ide_drive_t *);
1447 extern ide_startstop_t task_no_data_intr(ide_drive_t *);
1448 extern ide_startstop_t task_in_intr(ide_drive_t *);
1449 extern ide_startstop_t task_mulin_intr(ide_drive_t *);
1450 extern ide_startstop_t pre_task_out_intr(ide_drive_t *, struct request *);
1451 extern ide_startstop_t task_out_intr(ide_drive_t *);
1452 extern ide_startstop_t pre_task_mulout_intr(ide_drive_t *, struct request *);
1453 extern ide_startstop_t task_mulout_intr(ide_drive_t *);
1454
1455 extern int ide_raw_taskfile(ide_drive_t *, ide_task_t *, u8 *);
1456
1457 int ide_taskfile_ioctl(ide_drive_t *, unsigned int, unsigned long);
1458 int ide_cmd_ioctl(ide_drive_t *, unsigned int, unsigned long);
1459 int ide_task_ioctl(ide_drive_t *, unsigned int, unsigned long);
1460
1461 extern int system_bus_clock(void);
1462
1463 extern u8 ide_auto_reduce_xfer(ide_drive_t *);
1464 extern int ide_driveid_update(ide_drive_t *);
1465 extern int ide_ata66_check(ide_drive_t *, ide_task_t *);
1466 extern int ide_config_drive_speed(ide_drive_t *, u8);
1467 extern u8 eighty_ninty_three (ide_drive_t *);
1468 extern int set_transfer(ide_drive_t *, ide_task_t *);
1469 extern int taskfile_lib_get_identify(ide_drive_t *drive, u8 *);
1470
1471 extern int ide_wait_not_busy(ide_hwif_t *hwif, unsigned long timeout);
1472 ide_startstop_t __ide_do_rw_disk(ide_drive_t *drive, struct request *rq, sector_t block);
1473
1474 /*
1475  * ide_system_bus_speed() returns what we think is the system VESA/PCI
1476  * bus speed (in MHz).  This is used for calculating interface PIO timings.
1477  * The default is 40 for known PCI systems, 50 otherwise.
1478  * The "idebus=xx" parameter can be used to override this value.
1479  */
1480 extern int ide_system_bus_speed(void);
1481
1482 /*
1483  * ide_stall_queue() can be used by a drive to give excess bandwidth back
1484  * to the hwgroup by sleeping for timeout jiffies.
1485  */
1486 extern void ide_stall_queue(ide_drive_t *drive, unsigned long timeout);
1487
1488 extern int ide_spin_wait_hwgroup(ide_drive_t *);
1489 extern void ide_timer_expiry(unsigned long);
1490 extern irqreturn_t ide_intr(int irq, void *dev_id, struct pt_regs *regs);
1491 extern void do_ide_request(request_queue_t *);
1492 extern void ide_init_subdrivers(void);
1493
1494 extern struct block_device_operations ide_fops[];
1495 extern ide_proc_entry_t generic_subdriver_entries[];
1496
1497 extern int ata_attach(ide_drive_t *);
1498
1499 extern int ideprobe_init(void);
1500
1501 extern void ide_scan_pcibus(int scan_direction) __init;
1502 extern int ide_pci_register_driver(struct pci_driver *driver);
1503 extern void ide_pci_unregister_driver(struct pci_driver *driver);
1504 extern void ide_pci_setup_ports(struct pci_dev *dev, struct ide_pci_device_s *d, int autodma, int pciirq, ata_index_t *index);
1505 extern void ide_setup_pci_noise (struct pci_dev *dev, struct ide_pci_device_s *d);
1506
1507 extern void default_hwif_iops(ide_hwif_t *);
1508 extern void default_hwif_mmiops(ide_hwif_t *);
1509 extern void default_hwif_transport(ide_hwif_t *);
1510
1511 int ide_register_driver(ide_driver_t *driver);
1512 void ide_unregister_driver(ide_driver_t *driver);
1513 int ide_register_subdriver(ide_drive_t *, ide_driver_t *);
1514 int ide_unregister_subdriver (ide_drive_t *drive);
1515 int ide_replace_subdriver(ide_drive_t *drive, const char *driver);
1516
1517 #define ON_BOARD                1
1518 #define NEVER_BOARD             0
1519
1520 #ifdef CONFIG_BLK_DEV_OFFBOARD
1521 #  define OFF_BOARD             ON_BOARD
1522 #else /* CONFIG_BLK_DEV_OFFBOARD */
1523 #  define OFF_BOARD             NEVER_BOARD
1524 #endif /* CONFIG_BLK_DEV_OFFBOARD */
1525
1526 #define NODMA 0
1527 #define NOAUTODMA 1
1528 #define AUTODMA 2
1529
1530 typedef struct ide_pci_enablebit_s {
1531         u8      reg;    /* byte pci reg holding the enable-bit */
1532         u8      mask;   /* mask to isolate the enable-bit */
1533         u8      val;    /* value of masked reg when "enabled" */
1534 } ide_pci_enablebit_t;
1535
1536 enum {
1537         /* Uses ISA control ports not PCI ones. */
1538         IDEPCI_FLAG_ISA_PORTS           = (1 << 0),
1539
1540         IDEPCI_FLAG_FORCE_MASTER        = (1 << 1),
1541         IDEPCI_FLAG_FORCE_PDC           = (1 << 2),
1542 };
1543
1544 typedef struct ide_pci_device_s {
1545         char                    *name;
1546         void                    (*init_setup)(struct pci_dev *, struct ide_pci_device_s *);
1547         void                    (*init_setup_dma)(struct pci_dev *, struct ide_pci_device_s *, ide_hwif_t *);
1548         unsigned int            (*init_chipset)(struct pci_dev *, const char *);
1549         void                    (*init_iops)(ide_hwif_t *);
1550         void                    (*init_hwif)(ide_hwif_t *);
1551         void                    (*init_dma)(ide_hwif_t *, unsigned long);
1552         u8                      channels;
1553         u8                      autodma;
1554         ide_pci_enablebit_t     enablebits[2];
1555         u8                      bootable;
1556         unsigned int            extra;
1557         struct ide_pci_device_s *next;
1558         u8                      flags;
1559 } ide_pci_device_t;
1560
1561 extern void ide_setup_pci_device(struct pci_dev *, ide_pci_device_t *);
1562 extern void ide_setup_pci_devices(struct pci_dev *, struct pci_dev *, ide_pci_device_t *);
1563
1564 #define BAD_DMA_DRIVE           0
1565 #define GOOD_DMA_DRIVE          1
1566
1567 #ifdef CONFIG_BLK_DEV_IDEDMA
1568 int __ide_dma_bad_drive(ide_drive_t *);
1569 int __ide_dma_good_drive(ide_drive_t *);
1570 int __ide_dma_off(ide_drive_t *);
1571
1572 #ifdef CONFIG_BLK_DEV_IDEDMA_PCI
1573 extern int ide_build_sglist(ide_drive_t *, struct request *);
1574 extern int ide_raw_build_sglist(ide_drive_t *, struct request *);
1575 extern int ide_build_dmatable(ide_drive_t *, struct request *);
1576 extern void ide_destroy_dmatable(ide_drive_t *);
1577 extern ide_startstop_t ide_dma_intr(ide_drive_t *);
1578 extern int ide_release_dma(ide_hwif_t *);
1579 extern void ide_setup_dma(ide_hwif_t *, unsigned long, unsigned int);
1580 extern int ide_start_dma(ide_hwif_t *, ide_drive_t *, int);
1581
1582 extern int __ide_dma_host_off(ide_drive_t *);
1583 extern int __ide_dma_off_quietly(ide_drive_t *);
1584 extern int __ide_dma_host_on(ide_drive_t *);
1585 extern int __ide_dma_on(ide_drive_t *);
1586 extern int __ide_dma_check(ide_drive_t *);
1587 extern int __ide_dma_read(ide_drive_t *);
1588 extern int __ide_dma_write(ide_drive_t *);
1589 extern int __ide_dma_begin(ide_drive_t *);
1590 extern int __ide_dma_end(ide_drive_t *);
1591 extern int __ide_dma_test_irq(ide_drive_t *);
1592 extern int __ide_dma_verbose(ide_drive_t *);
1593 extern int __ide_dma_lostirq(ide_drive_t *);
1594 extern int __ide_dma_timeout(ide_drive_t *);
1595 #endif /* CONFIG_BLK_DEV_IDEDMA_PCI */
1596
1597 #else
1598 static inline int __ide_dma_off(ide_drive_t *drive) { return 0; }
1599 #endif /* CONFIG_BLK_DEV_IDEDMA */
1600
1601 #ifndef CONFIG_BLK_DEV_IDEDMA_PCI
1602 static inline void ide_release_dma(ide_hwif_t *drive) {;}
1603 #endif
1604
1605 extern int ide_hwif_request_regions(ide_hwif_t *hwif);
1606 extern void ide_hwif_release_regions(ide_hwif_t* hwif);
1607 extern void ide_unregister (unsigned int index);
1608
1609 extern int probe_hwif_init(ide_hwif_t *);
1610
1611 static inline void *ide_get_hwifdata (ide_hwif_t * hwif)
1612 {
1613         return hwif->hwif_data;
1614 }
1615
1616 static inline void ide_set_hwifdata (ide_hwif_t * hwif, void *data)
1617 {
1618         hwif->hwif_data = data;
1619 }
1620
1621 /* ide-lib.c */
1622 extern u8 ide_dma_speed(ide_drive_t *drive, u8 mode);
1623 extern u8 ide_rate_filter(u8 mode, u8 speed); 
1624 extern int ide_dma_enable(ide_drive_t *drive);
1625 extern char *ide_xfer_verbose(u8 xfer_rate);
1626 extern void ide_toggle_bounce(ide_drive_t *drive, int on);
1627 extern int ide_set_xfer_rate(ide_drive_t *drive, u8 rate);
1628 extern byte ide_dump_atapi_status(ide_drive_t *drive, const char *msg, byte stat);
1629
1630 typedef struct ide_pio_timings_s {
1631         int     setup_time;     /* Address setup (ns) minimum */
1632         int     active_time;    /* Active pulse (ns) minimum */
1633         int     cycle_time;     /* Cycle time (ns) minimum = (setup + active + recovery) */
1634 } ide_pio_timings_t;
1635
1636 typedef struct ide_pio_data_s {
1637         u8 pio_mode;
1638         u8 use_iordy;
1639         u8 overridden;
1640         u8 blacklisted;
1641         unsigned int cycle_time;
1642 } ide_pio_data_t;
1643
1644 extern u8 ide_get_best_pio_mode (ide_drive_t *drive, u8 mode_wanted, u8 max_mode, ide_pio_data_t *d);
1645 extern const ide_pio_timings_t ide_pio_timings[6];
1646
1647
1648 extern spinlock_t ide_lock;
1649 extern struct semaphore ide_cfg_sem;
1650 /*
1651  * Structure locking:
1652  *
1653  * ide_cfg_sem and ide_lock together protect changes to
1654  * ide_hwif_t->{next,hwgroup}
1655  * ide_drive_t->next
1656  *
1657  * ide_hwgroup_t->busy: ide_lock
1658  * ide_hwgroup_t->hwif: ide_lock
1659  * ide_hwif_t->mate: constant, no locking
1660  * ide_drive_t->hwif: constant, no locking
1661  */
1662
1663 #define local_irq_set(flags)    do { local_save_flags((flags)); local_irq_enable(); } while (0)
1664
1665 extern struct bus_type ide_bus_type;
1666
1667 #endif /* _IDE_H */