2 Copyright 2003-2004 Red Hat, Inc. All rights reserved.
3 Copyright 2003-2004 Jeff Garzik
5 The contents of this file are subject to the Open
6 Software License version 1.1 that can be found at
7 http://www.opensource.org/licenses/osl-1.1.txt and is included herein
10 Alternatively, the contents of this file may be used under the terms
11 of the GNU General Public License version 2 (the "GPL") as distributed
12 in the kernel source COPYING file, in which case the provisions of
13 the GPL are applicable instead of the above. If you wish to allow
14 the use of your version of this file only under the terms of the
15 GPL and not to allow others to use your version of this file under
16 the OSL, indicate your decision by deleting the provisions above and
17 replace them with the notice and other provisions required by the GPL.
18 If you do not delete the provisions above, a recipient may use your
19 version of this file under either the OSL or the GPL.
23 #ifndef __LINUX_LIBATA_H__
24 #define __LINUX_LIBATA_H__
26 #include <linux/delay.h>
27 #include <linux/interrupt.h>
28 #include <linux/pci.h>
30 #include <linux/ata.h>
31 #include <linux/workqueue.h>
34 * compile-time options
36 #undef ATA_DEBUG /* debugging output */
37 #undef ATA_VERBOSE_DEBUG /* yet more debugging output */
38 #undef ATA_IRQ_TRAP /* define to ack screaming irqs */
39 #undef ATA_NDEBUG /* define to disable quick runtime checks */
40 #undef ATA_ENABLE_ATAPI /* define to enable ATAPI support */
41 #undef ATA_ENABLE_PATA /* define to enable PATA support in some
42 * low-level drivers */
43 #undef ATAPI_ENABLE_DMADIR /* enables ATAPI DMADIR bridge support */
46 /* note: prints function name for you */
48 #define DPRINTK(fmt, args...) printk(KERN_ERR "%s: " fmt, __FUNCTION__, ## args)
49 #ifdef ATA_VERBOSE_DEBUG
50 #define VPRINTK(fmt, args...) printk(KERN_ERR "%s: " fmt, __FUNCTION__, ## args)
52 #define VPRINTK(fmt, args...)
53 #endif /* ATA_VERBOSE_DEBUG */
55 #define DPRINTK(fmt, args...)
56 #define VPRINTK(fmt, args...)
57 #endif /* ATA_DEBUG */
62 #define assert(expr) \
63 if(unlikely(!(expr))) { \
64 printk(KERN_ERR "Assertion failed! %s,%s,%s,line=%d\n", \
65 #expr,__FILE__,__FUNCTION__,__LINE__); \
69 /* defines only for the constants which don't work well as enums */
70 #define ATA_TAG_POISON 0xfafbfcfdU
72 /* move to PCI layer? */
73 static inline struct device *pci_dev_to_dev(struct pci_dev *pdev)
79 /* various global constants */
80 LIBATA_MAX_PRD = ATA_MAX_PRD / 2,
84 ATA_MAX_SECTORS = 200, /* FIXME */
86 ATA_DEF_BUSY_WAIT = 10000,
87 ATA_SHORT_PAUSE = (HZ >> 6) + 1,
90 ATA_SHT_CMD_PER_LUN = 1,
92 ATA_SHT_USE_CLUSTERING = 0,
94 /* struct ata_device stuff */
95 ATA_DFLAG_LBA48 = (1 << 0), /* device supports LBA48 */
96 ATA_DFLAG_PIO = (1 << 1), /* device currently in PIO mode */
97 ATA_DFLAG_LOCK_SECTORS = (1 << 2), /* don't adjust max_sectors */
99 ATA_DEV_UNKNOWN = 0, /* unknown device */
100 ATA_DEV_ATA = 1, /* ATA device */
101 ATA_DEV_ATA_UNSUP = 2, /* ATA device (unsupported) */
102 ATA_DEV_ATAPI = 3, /* ATAPI device */
103 ATA_DEV_ATAPI_UNSUP = 4, /* ATAPI device (unsupported) */
104 ATA_DEV_NONE = 5, /* no device */
106 /* struct ata_port flags */
107 ATA_FLAG_SLAVE_POSS = (1 << 1), /* host supports slave dev */
108 /* (doesn't imply presence) */
109 ATA_FLAG_PORT_DISABLED = (1 << 2), /* port is disabled, ignore it */
110 ATA_FLAG_SATA = (1 << 3),
111 ATA_FLAG_NO_LEGACY = (1 << 4), /* no legacy mode check */
112 ATA_FLAG_SRST = (1 << 5), /* use ATA SRST, not E.D.D. */
113 ATA_FLAG_MMIO = (1 << 6), /* use MMIO, not PIO */
114 ATA_FLAG_SATA_RESET = (1 << 7), /* use COMRESET */
115 ATA_FLAG_PIO_DMA = (1 << 8), /* PIO cmds via DMA */
117 ATA_QCFLAG_ACTIVE = (1 << 1), /* cmd not yet ack'd to scsi lyer */
118 ATA_QCFLAG_SG = (1 << 3), /* have s/g table? */
119 ATA_QCFLAG_SINGLE = (1 << 4), /* no s/g, just a single buffer */
120 ATA_QCFLAG_DMAMAP = ATA_QCFLAG_SG | ATA_QCFLAG_SINGLE,
122 /* various lengths of time */
123 ATA_TMOUT_EDD = 5 * HZ, /* hueristic */
124 ATA_TMOUT_PIO = 30 * HZ,
125 ATA_TMOUT_BOOT = 30 * HZ, /* hueristic */
126 ATA_TMOUT_BOOT_QUICK = 7 * HZ, /* hueristic */
127 ATA_TMOUT_CDB = 30 * HZ,
128 ATA_TMOUT_CDB_QUICK = 5 * HZ,
142 /* SATA port states */
147 /* encoding various smaller bitmaps into a single
148 * unsigned long bitmap
155 enum pio_task_states {
166 /* forward declarations */
168 struct ata_port_operations;
170 struct ata_queued_cmd;
173 typedef int (*ata_qc_cb_t) (struct ata_queued_cmd *qc, u8 drv_stat);
176 unsigned long cmd_addr;
177 unsigned long data_addr;
178 unsigned long error_addr;
179 unsigned long feature_addr;
180 unsigned long nsect_addr;
181 unsigned long lbal_addr;
182 unsigned long lbam_addr;
183 unsigned long lbah_addr;
184 unsigned long device_addr;
185 unsigned long status_addr;
186 unsigned long command_addr;
187 unsigned long altstatus_addr;
188 unsigned long ctl_addr;
189 unsigned long bmdma_addr;
190 unsigned long scr_addr;
193 struct ata_probe_ent {
194 struct list_head node;
196 struct ata_port_operations *port_ops;
197 Scsi_Host_Template *sht;
198 struct ata_ioports port[ATA_MAX_PORTS];
199 unsigned int n_ports;
200 unsigned int hard_port_no;
201 unsigned int pio_mask;
202 unsigned int mwdma_mask;
203 unsigned int udma_mask;
204 unsigned int legacy_mode;
206 unsigned int irq_flags;
207 unsigned long host_flags;
208 void __iomem *mmio_base;
212 struct ata_host_set {
216 void __iomem *mmio_base;
217 unsigned int n_ports;
219 struct ata_port_operations *ops;
220 struct ata_port * ports[0];
223 struct ata_queued_cmd {
225 struct ata_device *dev;
227 struct scsi_cmnd *scsicmd;
228 void (*scsidone)(struct scsi_cmnd *);
230 struct ata_taskfile tf;
231 u8 cdb[ATAPI_CDB_LEN];
233 unsigned long flags; /* ATA_QCFLAG_xxx */
240 unsigned int cursect;
243 unsigned int curbytes;
246 unsigned int cursg_ofs;
248 struct scatterlist sgent;
251 struct scatterlist *sg;
253 ata_qc_cb_t complete_fn;
255 struct completion *waiting;
260 struct ata_host_stats {
261 unsigned long unhandled_irq;
262 unsigned long idle_irq;
263 unsigned long rw_reqbuf;
267 u64 n_sectors; /* size of device, if ATA */
268 unsigned long flags; /* ATA_DFLAG_xxx */
269 unsigned int class; /* ATA_DEV_xxx */
270 unsigned int devno; /* 0 or 1 */
271 u16 id[ATA_ID_WORDS]; /* IDENTIFY xxx DEVICE data */
275 unsigned int xfer_shift; /* ATA_SHIFT_xxx */
277 /* cache info about current transfer mode */
278 u8 xfer_protocol; /* taskfile xfer protocol */
279 u8 read_cmd; /* opcode to use on read */
280 u8 write_cmd; /* opcode to use on write */
284 struct Scsi_Host *host; /* our co-allocated scsi host */
285 struct ata_port_operations *ops;
286 unsigned long flags; /* ATA_FLAG_xxx */
287 unsigned int id; /* unique id req'd by scsi midlyr */
288 unsigned int port_no; /* unique port #; from zero */
289 unsigned int hard_port_no; /* hardware port #; from zero */
291 struct ata_prd *prd; /* our SG list */
292 dma_addr_t prd_dma; /* and its DMA mapping */
294 struct ata_ioports ioaddr; /* ATA cmd/ctl/dma register blocks */
296 u8 ctl; /* cache of ATA control register */
297 u8 last_ctl; /* Cache last written value */
298 unsigned int bus_state;
299 unsigned int port_state;
300 unsigned int pio_mask;
301 unsigned int mwdma_mask;
302 unsigned int udma_mask;
303 unsigned int cbl; /* cable type; ATA_CBL_xxx */
304 unsigned int cdb_len;
306 struct ata_device device[ATA_MAX_DEVICES];
308 struct ata_queued_cmd qcmd[ATA_MAX_QUEUE];
309 unsigned long qactive;
310 unsigned int active_tag;
312 struct ata_host_stats stats;
313 struct ata_host_set *host_set;
315 struct work_struct packet_task;
317 struct work_struct pio_task;
318 unsigned int pio_task_state;
319 unsigned long pio_task_timeout;
324 struct ata_port_operations {
325 void (*port_disable) (struct ata_port *);
327 void (*dev_config) (struct ata_port *, struct ata_device *);
329 void (*set_piomode) (struct ata_port *, struct ata_device *);
330 void (*set_dmamode) (struct ata_port *, struct ata_device *);
332 void (*tf_load) (struct ata_port *ap, struct ata_taskfile *tf);
333 void (*tf_read) (struct ata_port *ap, struct ata_taskfile *tf);
335 void (*exec_command)(struct ata_port *ap, struct ata_taskfile *tf);
336 u8 (*check_status)(struct ata_port *ap);
337 u8 (*check_altstatus)(struct ata_port *ap);
338 u8 (*check_err)(struct ata_port *ap);
339 void (*dev_select)(struct ata_port *ap, unsigned int device);
341 void (*phy_reset) (struct ata_port *ap);
342 void (*post_set_mode) (struct ata_port *ap);
344 int (*check_atapi_dma) (struct ata_queued_cmd *qc);
346 void (*bmdma_setup) (struct ata_queued_cmd *qc);
347 void (*bmdma_start) (struct ata_queued_cmd *qc);
349 void (*qc_prep) (struct ata_queued_cmd *qc);
350 int (*qc_issue) (struct ata_queued_cmd *qc);
352 void (*eng_timeout) (struct ata_port *ap);
354 irqreturn_t (*irq_handler)(int, void *, struct pt_regs *);
355 void (*irq_clear) (struct ata_port *);
357 u32 (*scr_read) (struct ata_port *ap, unsigned int sc_reg);
358 void (*scr_write) (struct ata_port *ap, unsigned int sc_reg,
361 int (*port_start) (struct ata_port *ap);
362 void (*port_stop) (struct ata_port *ap);
364 void (*host_stop) (struct ata_host_set *host_set);
366 void (*bmdma_stop) (struct ata_port *ap);
367 u8 (*bmdma_status) (struct ata_port *ap);
370 struct ata_port_info {
371 Scsi_Host_Template *sht;
372 unsigned long host_flags;
373 unsigned long pio_mask;
374 unsigned long mwdma_mask;
375 unsigned long udma_mask;
376 struct ata_port_operations *port_ops;
380 extern void ata_port_probe(struct ata_port *);
381 extern void __sata_phy_reset(struct ata_port *ap);
382 extern void sata_phy_reset(struct ata_port *ap);
383 extern void ata_bus_reset(struct ata_port *ap);
384 extern void ata_port_disable(struct ata_port *);
385 extern void ata_std_ports(struct ata_ioports *ioaddr);
387 extern int ata_pci_init_one (struct pci_dev *pdev, struct ata_port_info **port_info,
388 unsigned int n_ports);
389 extern void ata_pci_remove_one (struct pci_dev *pdev);
390 #endif /* CONFIG_PCI */
391 extern int ata_device_add(struct ata_probe_ent *ent);
392 extern int ata_scsi_detect(Scsi_Host_Template *sht);
393 extern int ata_scsi_ioctl(struct scsi_device *dev, int cmd, void __user *arg);
394 extern int ata_scsi_queuecmd(struct scsi_cmnd *cmd, void (*done)(struct scsi_cmnd *));
395 extern int ata_scsi_error(struct Scsi_Host *host);
396 extern int ata_scsi_release(struct Scsi_Host *host);
397 extern unsigned int ata_host_intr(struct ata_port *ap, struct ata_queued_cmd *qc);
399 * Default driver ops implementations
401 extern void ata_tf_load(struct ata_port *ap, struct ata_taskfile *tf);
402 extern void ata_tf_read(struct ata_port *ap, struct ata_taskfile *tf);
403 extern void ata_tf_to_fis(struct ata_taskfile *tf, u8 *fis, u8 pmp);
404 extern void ata_tf_from_fis(u8 *fis, struct ata_taskfile *tf);
405 extern void ata_noop_dev_select (struct ata_port *ap, unsigned int device);
406 extern void ata_std_dev_select (struct ata_port *ap, unsigned int device);
407 extern u8 ata_check_status(struct ata_port *ap);
408 extern u8 ata_altstatus(struct ata_port *ap);
409 extern u8 ata_chk_err(struct ata_port *ap);
410 extern void ata_exec_command(struct ata_port *ap, struct ata_taskfile *tf);
411 extern int ata_port_start (struct ata_port *ap);
412 extern void ata_port_stop (struct ata_port *ap);
413 extern void ata_host_stop (struct ata_host_set *host_set);
414 extern irqreturn_t ata_interrupt (int irq, void *dev_instance, struct pt_regs *regs);
415 extern void ata_qc_prep(struct ata_queued_cmd *qc);
416 extern int ata_qc_issue_prot(struct ata_queued_cmd *qc);
417 extern void ata_sg_init_one(struct ata_queued_cmd *qc, void *buf,
418 unsigned int buflen);
419 extern void ata_sg_init(struct ata_queued_cmd *qc, struct scatterlist *sg,
420 unsigned int n_elem);
421 extern unsigned int ata_dev_classify(struct ata_taskfile *tf);
422 extern void ata_dev_id_string(u16 *id, unsigned char *s,
423 unsigned int ofs, unsigned int len);
424 extern void ata_bmdma_setup (struct ata_queued_cmd *qc);
425 extern void ata_bmdma_start (struct ata_queued_cmd *qc);
426 extern void ata_bmdma_stop(struct ata_port *ap);
427 extern u8 ata_bmdma_status(struct ata_port *ap);
428 extern void ata_bmdma_irq_clear(struct ata_port *ap);
429 extern void ata_qc_complete(struct ata_queued_cmd *qc, u8 drv_stat);
430 extern void ata_eng_timeout(struct ata_port *ap);
431 extern void ata_scsi_simulate(u16 *id, struct scsi_cmnd *cmd,
432 void (*done)(struct scsi_cmnd *));
433 extern int ata_std_bios_param(struct scsi_device *sdev,
434 struct block_device *bdev,
435 sector_t capacity, int geom[]);
436 extern int ata_scsi_slave_config(struct scsi_device *sdev);
441 unsigned int reg; /* PCI config register to read */
442 unsigned int width; /* 1 (8 bit), 2 (16 bit), 4 (32 bit) */
447 extern struct ata_probe_ent *
448 ata_pci_init_native_mode(struct pci_dev *pdev, struct ata_port_info **port);
449 extern int pci_test_config_bits(struct pci_dev *pdev, struct pci_bits *bits);
451 #endif /* CONFIG_PCI */
454 static inline unsigned int ata_tag_valid(unsigned int tag)
456 return (tag < ATA_MAX_QUEUE) ? 1 : 0;
459 static inline unsigned int ata_dev_present(struct ata_device *dev)
461 return ((dev->class == ATA_DEV_ATA) ||
462 (dev->class == ATA_DEV_ATAPI));
465 static inline u8 ata_chk_status(struct ata_port *ap)
467 return ap->ops->check_status(ap);
472 * ata_pause - Flush writes and pause 400 nanoseconds.
473 * @ap: Port to wait for.
476 * Inherited from caller.
479 static inline void ata_pause(struct ata_port *ap)
487 * ata_busy_wait - Wait for a port status register
488 * @ap: Port to wait for.
490 * Waits up to max*10 microseconds for the selected bits in the port's
491 * status register to be cleared.
492 * Returns final value of status register.
495 * Inherited from caller.
498 static inline u8 ata_busy_wait(struct ata_port *ap, unsigned int bits,
505 status = ata_chk_status(ap);
507 } while ((status & bits) && (max > 0));
514 * ata_wait_idle - Wait for a port to be idle.
515 * @ap: Port to wait for.
517 * Waits up to 10ms for port's BUSY and DRQ signals to clear.
518 * Returns final value of status register.
521 * Inherited from caller.
524 static inline u8 ata_wait_idle(struct ata_port *ap)
526 u8 status = ata_busy_wait(ap, ATA_BUSY | ATA_DRQ, 1000);
528 if (status & (ATA_BUSY | ATA_DRQ)) {
529 unsigned long l = ap->ioaddr.status_addr;
531 "ATA: abnormal status 0x%X on port 0x%lX\n",
538 static inline void ata_qc_set_polling(struct ata_queued_cmd *qc)
540 qc->tf.ctl |= ATA_NIEN;
543 static inline struct ata_queued_cmd *ata_qc_from_tag (struct ata_port *ap,
546 if (likely(ata_tag_valid(tag)))
547 return &ap->qcmd[tag];
551 static inline void ata_tf_init(struct ata_port *ap, struct ata_taskfile *tf, unsigned int device)
553 memset(tf, 0, sizeof(*tf));
557 tf->device = ATA_DEVICE_OBS;
559 tf->device = ATA_DEVICE_OBS | ATA_DEV1;
564 * ata_irq_on - Enable interrupts on a port.
565 * @ap: Port on which interrupts are enabled.
567 * Enable interrupts on a legacy IDE device using MMIO or PIO,
568 * wait for idle, clear any pending interrupts.
571 * Inherited from caller.
574 static inline u8 ata_irq_on(struct ata_port *ap)
576 struct ata_ioports *ioaddr = &ap->ioaddr;
579 ap->ctl &= ~ATA_NIEN;
580 ap->last_ctl = ap->ctl;
582 if (ap->flags & ATA_FLAG_MMIO)
583 writeb(ap->ctl, (void __iomem *) ioaddr->ctl_addr);
585 outb(ap->ctl, ioaddr->ctl_addr);
586 tmp = ata_wait_idle(ap);
588 ap->ops->irq_clear(ap);
595 * ata_irq_ack - Acknowledge a device interrupt.
596 * @ap: Port on which interrupts are enabled.
598 * Wait up to 10 ms for legacy IDE device to become idle (BUSY
599 * or BUSY+DRQ clear). Obtain dma status and port status from
600 * device. Clear the interrupt. Return port status.
605 static inline u8 ata_irq_ack(struct ata_port *ap, unsigned int chk_drq)
607 unsigned int bits = chk_drq ? ATA_BUSY | ATA_DRQ : ATA_BUSY;
608 u8 host_stat, post_stat, status;
610 status = ata_busy_wait(ap, bits, 1000);
612 DPRINTK("abnormal status 0x%X\n", status);
614 /* get controller status; clear intr, err bits */
615 if (ap->flags & ATA_FLAG_MMIO) {
616 void __iomem *mmio = (void __iomem *) ap->ioaddr.bmdma_addr;
617 host_stat = readb(mmio + ATA_DMA_STATUS);
618 writeb(host_stat | ATA_DMA_INTR | ATA_DMA_ERR,
619 mmio + ATA_DMA_STATUS);
621 post_stat = readb(mmio + ATA_DMA_STATUS);
623 host_stat = inb(ap->ioaddr.bmdma_addr + ATA_DMA_STATUS);
624 outb(host_stat | ATA_DMA_INTR | ATA_DMA_ERR,
625 ap->ioaddr.bmdma_addr + ATA_DMA_STATUS);
627 post_stat = inb(ap->ioaddr.bmdma_addr + ATA_DMA_STATUS);
630 VPRINTK("irq ack: host_stat 0x%X, new host_stat 0x%X, drv_stat 0x%X\n",
631 host_stat, post_stat, status);
636 static inline u32 scr_read(struct ata_port *ap, unsigned int reg)
638 return ap->ops->scr_read(ap, reg);
641 static inline void scr_write(struct ata_port *ap, unsigned int reg, u32 val)
643 ap->ops->scr_write(ap, reg, val);
646 static inline void scr_write_flush(struct ata_port *ap, unsigned int reg,
649 ap->ops->scr_write(ap, reg, val);
650 (void) ap->ops->scr_read(ap, reg);
653 static inline unsigned int sata_dev_present(struct ata_port *ap)
655 return ((scr_read(ap, SCR_STATUS) & 0xf) == 0x3) ? 1 : 0;
658 static inline int ata_try_flush_cache(struct ata_device *dev)
660 return ata_id_wcache_enabled(dev->id) ||
661 ata_id_has_flush(dev->id) ||
662 ata_id_has_flush_ext(dev->id);
665 #endif /* __LINUX_LIBATA_H__ */