blob: 9e5db2949c588c551fa608d801e7cc627bb39844 [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001/*
Jeff Garzikaf36d7f2005-08-28 20:18:39 -04002 * Copyright 2003-2005 Red Hat, Inc. All rights reserved.
3 * Copyright 2003-2005 Jeff Garzik
4 *
5 *
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 2, or (at your option)
9 * any later version.
10 *
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
15 *
16 * You should have received a copy of the GNU General Public License
17 * along with this program; see the file COPYING. If not, write to
18 * the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
19 *
20 *
21 * libata documentation is available via 'make {ps|pdf}docs',
22 * as Documentation/DocBook/libata.*
23 *
Linus Torvalds1da177e2005-04-16 15:20:36 -070024 */
25
26#ifndef __LINUX_LIBATA_H__
27#define __LINUX_LIBATA_H__
28
29#include <linux/delay.h>
30#include <linux/interrupt.h>
31#include <linux/pci.h>
Andrew Morton1c72d8d2005-11-10 16:21:38 -080032#include <linux/dma-mapping.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070033#include <asm/io.h>
34#include <linux/ata.h>
35#include <linux/workqueue.h>
36
37/*
38 * compile-time options
39 */
40#undef ATA_DEBUG /* debugging output */
41#undef ATA_VERBOSE_DEBUG /* yet more debugging output */
42#undef ATA_IRQ_TRAP /* define to ack screaming irqs */
43#undef ATA_NDEBUG /* define to disable quick runtime checks */
Linus Torvalds1da177e2005-04-16 15:20:36 -070044#undef ATA_ENABLE_PATA /* define to enable PATA support in some
45 * low-level drivers */
46#undef ATAPI_ENABLE_DMADIR /* enables ATAPI DMADIR bridge support */
47
48
49/* note: prints function name for you */
50#ifdef ATA_DEBUG
51#define DPRINTK(fmt, args...) printk(KERN_ERR "%s: " fmt, __FUNCTION__, ## args)
52#ifdef ATA_VERBOSE_DEBUG
53#define VPRINTK(fmt, args...) printk(KERN_ERR "%s: " fmt, __FUNCTION__, ## args)
54#else
55#define VPRINTK(fmt, args...)
56#endif /* ATA_VERBOSE_DEBUG */
57#else
58#define DPRINTK(fmt, args...)
59#define VPRINTK(fmt, args...)
60#endif /* ATA_DEBUG */
61
Jeff Garzik2c13b7c2005-11-14 14:14:16 -050062#define BPRINTK(fmt, args...) if (ap->flags & ATA_FLAG_DEBUGMSG) printk(KERN_ERR "%s: " fmt, __FUNCTION__, ## args)
63
Linus Torvalds1da177e2005-04-16 15:20:36 -070064#ifdef ATA_NDEBUG
65#define assert(expr)
66#else
67#define assert(expr) \
68 if(unlikely(!(expr))) { \
69 printk(KERN_ERR "Assertion failed! %s,%s,%s,line=%d\n", \
70 #expr,__FILE__,__FUNCTION__,__LINE__); \
71 }
72#endif
73
74/* defines only for the constants which don't work well as enums */
75#define ATA_TAG_POISON 0xfafbfcfdU
76
77/* move to PCI layer? */
78static inline struct device *pci_dev_to_dev(struct pci_dev *pdev)
79{
80 return &pdev->dev;
81}
82
83enum {
84 /* various global constants */
85 LIBATA_MAX_PRD = ATA_MAX_PRD / 2,
86 ATA_MAX_PORTS = 8,
87 ATA_DEF_QUEUE = 1,
88 ATA_MAX_QUEUE = 1,
89 ATA_MAX_SECTORS = 200, /* FIXME */
90 ATA_MAX_BUS = 2,
91 ATA_DEF_BUSY_WAIT = 10000,
92 ATA_SHORT_PAUSE = (HZ >> 6) + 1,
93
94 ATA_SHT_EMULATED = 1,
95 ATA_SHT_CMD_PER_LUN = 1,
96 ATA_SHT_THIS_ID = -1,
Jeff Garzikcf482932005-10-22 00:19:33 -040097 ATA_SHT_USE_CLUSTERING = 1,
Linus Torvalds1da177e2005-04-16 15:20:36 -070098
99 /* struct ata_device stuff */
100 ATA_DFLAG_LBA48 = (1 << 0), /* device supports LBA48 */
101 ATA_DFLAG_PIO = (1 << 1), /* device currently in PIO mode */
102 ATA_DFLAG_LOCK_SECTORS = (1 << 2), /* don't adjust max_sectors */
Albert Lee8bf62ece2005-05-12 15:29:42 -0400103 ATA_DFLAG_LBA = (1 << 3), /* device supports LBA */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700104
105 ATA_DEV_UNKNOWN = 0, /* unknown device */
106 ATA_DEV_ATA = 1, /* ATA device */
107 ATA_DEV_ATA_UNSUP = 2, /* ATA device (unsupported) */
108 ATA_DEV_ATAPI = 3, /* ATAPI device */
109 ATA_DEV_ATAPI_UNSUP = 4, /* ATAPI device (unsupported) */
110 ATA_DEV_NONE = 5, /* no device */
111
112 /* struct ata_port flags */
113 ATA_FLAG_SLAVE_POSS = (1 << 1), /* host supports slave dev */
114 /* (doesn't imply presence) */
115 ATA_FLAG_PORT_DISABLED = (1 << 2), /* port is disabled, ignore it */
116 ATA_FLAG_SATA = (1 << 3),
117 ATA_FLAG_NO_LEGACY = (1 << 4), /* no legacy mode check */
118 ATA_FLAG_SRST = (1 << 5), /* use ATA SRST, not E.D.D. */
119 ATA_FLAG_MMIO = (1 << 6), /* use MMIO, not PIO */
120 ATA_FLAG_SATA_RESET = (1 << 7), /* use COMRESET */
121 ATA_FLAG_PIO_DMA = (1 << 8), /* PIO cmds via DMA */
Tejun Heoc1389502005-08-22 14:59:24 +0900122 ATA_FLAG_NOINTR = (1 << 9), /* FIXME: Remove this once
123 * proper HSM is in place. */
Jeff Garzik2c13b7c2005-11-14 14:14:16 -0500124 ATA_FLAG_DEBUGMSG = (1 << 10),
Jeff Garzik50630192005-12-13 02:29:45 -0500125 ATA_FLAG_NO_ATAPI = (1 << 11), /* No ATAPI support */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700126
Jens Axboe9b847542006-01-06 09:28:07 +0100127 ATA_FLAG_SUSPENDED = (1 << 12), /* port is suspended */
128
Alan Cox8d238e02006-01-17 20:50:31 +0000129 ATA_FLAG_PIO_LBA48 = (1 << 13), /* Host DMA engine is LBA28 only */
130 ATA_FLAG_IRQ_MASK = (1 << 14), /* Mask IRQ in PIO xfers */
131
Linus Torvalds1da177e2005-04-16 15:20:36 -0700132 ATA_QCFLAG_ACTIVE = (1 << 1), /* cmd not yet ack'd to scsi lyer */
133 ATA_QCFLAG_SG = (1 << 3), /* have s/g table? */
134 ATA_QCFLAG_SINGLE = (1 << 4), /* no s/g, just a single buffer */
135 ATA_QCFLAG_DMAMAP = ATA_QCFLAG_SG | ATA_QCFLAG_SINGLE,
136
137 /* various lengths of time */
Alan Cox8d238e02006-01-17 20:50:31 +0000138 ATA_TMOUT_EDD = 5 * HZ, /* heuristic */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700139 ATA_TMOUT_PIO = 30 * HZ,
Alan Cox8d238e02006-01-17 20:50:31 +0000140 ATA_TMOUT_BOOT = 30 * HZ, /* heuristic */
141 ATA_TMOUT_BOOT_QUICK = 7 * HZ, /* heuristic */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700142 ATA_TMOUT_CDB = 30 * HZ,
143 ATA_TMOUT_CDB_QUICK = 5 * HZ,
Tejun Heoa2a7a662005-12-13 14:48:31 +0900144 ATA_TMOUT_INTERNAL = 30 * HZ,
145 ATA_TMOUT_INTERNAL_QUICK = 5 * HZ,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700146
147 /* ATA bus states */
148 BUS_UNKNOWN = 0,
149 BUS_DMA = 1,
150 BUS_IDLE = 2,
151 BUS_NOINTR = 3,
152 BUS_NODATA = 4,
153 BUS_TIMER = 5,
154 BUS_PIO = 6,
155 BUS_EDD = 7,
156 BUS_IDENTIFY = 8,
157 BUS_PACKET = 9,
158
159 /* SATA port states */
160 PORT_UNKNOWN = 0,
161 PORT_ENABLED = 1,
162 PORT_DISABLED = 2,
163
164 /* encoding various smaller bitmaps into a single
165 * unsigned long bitmap
166 */
167 ATA_SHIFT_UDMA = 0,
168 ATA_SHIFT_MWDMA = 8,
169 ATA_SHIFT_PIO = 11,
Jeff Garzikcedc9a42005-10-05 07:13:30 -0400170
171 /* size of buffer to pad xfers ending on unaligned boundaries */
172 ATA_DMA_PAD_SZ = 4,
173 ATA_DMA_PAD_BUF_SZ = ATA_DMA_PAD_SZ * ATA_MAX_QUEUE,
Alan Cox47a86592005-10-04 08:09:19 -0400174
175 /* Masks for port functions */
176 ATA_PORT_PRIMARY = (1 << 0),
177 ATA_PORT_SECONDARY = (1 << 1),
Linus Torvalds1da177e2005-04-16 15:20:36 -0700178};
179
Albert Lee14be71f2005-09-27 17:36:35 +0800180enum hsm_task_states {
181 HSM_ST_UNKNOWN,
182 HSM_ST_IDLE,
183 HSM_ST_POLL,
184 HSM_ST_TMOUT,
185 HSM_ST,
186 HSM_ST_LAST,
187 HSM_ST_LAST_POLL,
188 HSM_ST_ERR,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700189};
190
Jeff Garzika7dac442005-10-30 04:44:42 -0500191enum ata_completion_errors {
192 AC_ERR_OTHER = (1 << 0),
193 AC_ERR_DEV = (1 << 1),
194 AC_ERR_ATA_BUS = (1 << 2),
195 AC_ERR_HOST_BUS = (1 << 3),
196};
197
Linus Torvalds1da177e2005-04-16 15:20:36 -0700198/* forward declarations */
199struct scsi_device;
200struct ata_port_operations;
201struct ata_port;
202struct ata_queued_cmd;
203
204/* typedefs */
Albert Leea22e2eb2005-12-05 15:38:02 +0800205typedef int (*ata_qc_cb_t) (struct ata_queued_cmd *qc);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700206
207struct ata_ioports {
208 unsigned long cmd_addr;
209 unsigned long data_addr;
210 unsigned long error_addr;
211 unsigned long feature_addr;
212 unsigned long nsect_addr;
213 unsigned long lbal_addr;
214 unsigned long lbam_addr;
215 unsigned long lbah_addr;
216 unsigned long device_addr;
217 unsigned long status_addr;
218 unsigned long command_addr;
219 unsigned long altstatus_addr;
220 unsigned long ctl_addr;
221 unsigned long bmdma_addr;
222 unsigned long scr_addr;
223};
224
225struct ata_probe_ent {
226 struct list_head node;
227 struct device *dev;
Jeff Garzik057ace52005-10-22 14:27:05 -0400228 const struct ata_port_operations *port_ops;
Jeff Garzik193515d2005-11-07 00:59:37 -0500229 struct scsi_host_template *sht;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700230 struct ata_ioports port[ATA_MAX_PORTS];
231 unsigned int n_ports;
232 unsigned int hard_port_no;
233 unsigned int pio_mask;
234 unsigned int mwdma_mask;
235 unsigned int udma_mask;
236 unsigned int legacy_mode;
237 unsigned long irq;
238 unsigned int irq_flags;
239 unsigned long host_flags;
240 void __iomem *mmio_base;
241 void *private_data;
242};
243
244struct ata_host_set {
245 spinlock_t lock;
246 struct device *dev;
247 unsigned long irq;
248 void __iomem *mmio_base;
249 unsigned int n_ports;
250 void *private_data;
Jeff Garzik057ace52005-10-22 14:27:05 -0400251 const struct ata_port_operations *ops;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700252 struct ata_port * ports[0];
253};
254
255struct ata_queued_cmd {
256 struct ata_port *ap;
257 struct ata_device *dev;
258
259 struct scsi_cmnd *scsicmd;
260 void (*scsidone)(struct scsi_cmnd *);
261
262 struct ata_taskfile tf;
263 u8 cdb[ATAPI_CDB_LEN];
264
265 unsigned long flags; /* ATA_QCFLAG_xxx */
266 unsigned int tag;
267 unsigned int n_elem;
Jeff Garzikcedc9a42005-10-05 07:13:30 -0400268 unsigned int orig_n_elem;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700269
270 int dma_dir;
271
Jeff Garzikcedc9a42005-10-05 07:13:30 -0400272 unsigned int pad_len;
273
Linus Torvalds1da177e2005-04-16 15:20:36 -0700274 unsigned int nsect;
275 unsigned int cursect;
276
277 unsigned int nbytes;
278 unsigned int curbytes;
279
280 unsigned int cursg;
281 unsigned int cursg_ofs;
282
283 struct scatterlist sgent;
Jeff Garzikcedc9a42005-10-05 07:13:30 -0400284 struct scatterlist pad_sgent;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700285 void *buf_virt;
286
Jeff Garzikcedc9a42005-10-05 07:13:30 -0400287 /* DO NOT iterate over __sg manually, use ata_for_each_sg() */
288 struct scatterlist *__sg;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700289
Albert Leea22e2eb2005-12-05 15:38:02 +0800290 unsigned int err_mask;
291
Linus Torvalds1da177e2005-04-16 15:20:36 -0700292 ata_qc_cb_t complete_fn;
293
Linus Torvalds1da177e2005-04-16 15:20:36 -0700294 void *private_data;
295};
296
297struct ata_host_stats {
298 unsigned long unhandled_irq;
299 unsigned long idle_irq;
300 unsigned long rw_reqbuf;
301};
302
303struct ata_device {
304 u64 n_sectors; /* size of device, if ATA */
305 unsigned long flags; /* ATA_DFLAG_xxx */
306 unsigned int class; /* ATA_DEV_xxx */
307 unsigned int devno; /* 0 or 1 */
308 u16 id[ATA_ID_WORDS]; /* IDENTIFY xxx DEVICE data */
309 u8 pio_mode;
310 u8 dma_mode;
311 u8 xfer_mode;
312 unsigned int xfer_shift; /* ATA_SHIFT_xxx */
313
Albert Lee8cbd6df2005-10-12 15:06:27 +0800314 unsigned int multi_count; /* sectors count for
315 READ/WRITE MULTIPLE */
Albert Lee8bf62ece2005-05-12 15:29:42 -0400316
317 /* for CHS addressing */
318 u16 cylinders; /* Number of cylinders */
319 u16 heads; /* Number of heads */
320 u16 sectors; /* Number of sectors per track */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700321};
322
323struct ata_port {
324 struct Scsi_Host *host; /* our co-allocated scsi host */
Jeff Garzik057ace52005-10-22 14:27:05 -0400325 const struct ata_port_operations *ops;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700326 unsigned long flags; /* ATA_FLAG_xxx */
327 unsigned int id; /* unique id req'd by scsi midlyr */
328 unsigned int port_no; /* unique port #; from zero */
329 unsigned int hard_port_no; /* hardware port #; from zero */
330
331 struct ata_prd *prd; /* our SG list */
332 dma_addr_t prd_dma; /* and its DMA mapping */
333
Jeff Garzikcedc9a42005-10-05 07:13:30 -0400334 void *pad; /* array of DMA pad buffers */
335 dma_addr_t pad_dma;
336
Linus Torvalds1da177e2005-04-16 15:20:36 -0700337 struct ata_ioports ioaddr; /* ATA cmd/ctl/dma register blocks */
338
339 u8 ctl; /* cache of ATA control register */
340 u8 last_ctl; /* Cache last written value */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700341 unsigned int pio_mask;
342 unsigned int mwdma_mask;
343 unsigned int udma_mask;
344 unsigned int cbl; /* cable type; ATA_CBL_xxx */
345 unsigned int cdb_len;
346
347 struct ata_device device[ATA_MAX_DEVICES];
348
349 struct ata_queued_cmd qcmd[ATA_MAX_QUEUE];
350 unsigned long qactive;
351 unsigned int active_tag;
352
353 struct ata_host_stats stats;
354 struct ata_host_set *host_set;
355
356 struct work_struct packet_task;
357
358 struct work_struct pio_task;
Albert Lee14be71f2005-09-27 17:36:35 +0800359 unsigned int hsm_task_state;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700360 unsigned long pio_task_timeout;
361
362 void *private_data;
363};
364
365struct ata_port_operations {
366 void (*port_disable) (struct ata_port *);
367
368 void (*dev_config) (struct ata_port *, struct ata_device *);
369
370 void (*set_piomode) (struct ata_port *, struct ata_device *);
371 void (*set_dmamode) (struct ata_port *, struct ata_device *);
372
Jeff Garzik057ace52005-10-22 14:27:05 -0400373 void (*tf_load) (struct ata_port *ap, const struct ata_taskfile *tf);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700374 void (*tf_read) (struct ata_port *ap, struct ata_taskfile *tf);
375
Jeff Garzik057ace52005-10-22 14:27:05 -0400376 void (*exec_command)(struct ata_port *ap, const struct ata_taskfile *tf);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700377 u8 (*check_status)(struct ata_port *ap);
378 u8 (*check_altstatus)(struct ata_port *ap);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700379 void (*dev_select)(struct ata_port *ap, unsigned int device);
380
381 void (*phy_reset) (struct ata_port *ap);
382 void (*post_set_mode) (struct ata_port *ap);
383
384 int (*check_atapi_dma) (struct ata_queued_cmd *qc);
385
386 void (*bmdma_setup) (struct ata_queued_cmd *qc);
387 void (*bmdma_start) (struct ata_queued_cmd *qc);
388
389 void (*qc_prep) (struct ata_queued_cmd *qc);
390 int (*qc_issue) (struct ata_queued_cmd *qc);
391
392 void (*eng_timeout) (struct ata_port *ap);
393
394 irqreturn_t (*irq_handler)(int, void *, struct pt_regs *);
395 void (*irq_clear) (struct ata_port *);
396
397 u32 (*scr_read) (struct ata_port *ap, unsigned int sc_reg);
398 void (*scr_write) (struct ata_port *ap, unsigned int sc_reg,
399 u32 val);
400
401 int (*port_start) (struct ata_port *ap);
402 void (*port_stop) (struct ata_port *ap);
403
404 void (*host_stop) (struct ata_host_set *host_set);
405
Alan Coxb73fc892005-08-26 16:03:19 +0100406 void (*bmdma_stop) (struct ata_queued_cmd *qc);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700407 u8 (*bmdma_status) (struct ata_port *ap);
408};
409
410struct ata_port_info {
Christoph Hellwigd0be4a7d2005-10-31 18:31:40 +0100411 struct scsi_host_template *sht;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700412 unsigned long host_flags;
413 unsigned long pio_mask;
414 unsigned long mwdma_mask;
415 unsigned long udma_mask;
Jeff Garzik057ace52005-10-22 14:27:05 -0400416 const struct ata_port_operations *port_ops;
Alan Coxe99f8b52005-11-08 14:09:44 +0000417 void *private_data;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700418};
419
Alan Cox452503f2005-10-21 19:01:32 -0400420struct ata_timing {
421 unsigned short mode; /* ATA mode */
422 unsigned short setup; /* t1 */
423 unsigned short act8b; /* t2 for 8-bit I/O */
424 unsigned short rec8b; /* t2i for 8-bit I/O */
425 unsigned short cyc8b; /* t0 for 8-bit I/O */
426 unsigned short active; /* t2 or tD */
427 unsigned short recover; /* t2i or tK */
428 unsigned short cycle; /* t0 */
429 unsigned short udma; /* t2CYCTYP/2 */
430};
431
432#define FIT(v,vmin,vmax) max_t(short,min_t(short,v,vmax),vmin)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700433
434extern void ata_port_probe(struct ata_port *);
435extern void __sata_phy_reset(struct ata_port *ap);
436extern void sata_phy_reset(struct ata_port *ap);
437extern void ata_bus_reset(struct ata_port *ap);
438extern void ata_port_disable(struct ata_port *);
439extern void ata_std_ports(struct ata_ioports *ioaddr);
440#ifdef CONFIG_PCI
441extern int ata_pci_init_one (struct pci_dev *pdev, struct ata_port_info **port_info,
442 unsigned int n_ports);
443extern void ata_pci_remove_one (struct pci_dev *pdev);
Jens Axboe9b847542006-01-06 09:28:07 +0100444extern int ata_pci_device_suspend(struct pci_dev *pdev, pm_message_t state);
445extern int ata_pci_device_resume(struct pci_dev *pdev);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700446#endif /* CONFIG_PCI */
Jeff Garzik057ace52005-10-22 14:27:05 -0400447extern int ata_device_add(const struct ata_probe_ent *ent);
Alan Cox17b14452005-09-15 15:44:00 +0100448extern void ata_host_set_remove(struct ata_host_set *host_set);
Jeff Garzik193515d2005-11-07 00:59:37 -0500449extern int ata_scsi_detect(struct scsi_host_template *sht);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700450extern int ata_scsi_ioctl(struct scsi_device *dev, int cmd, void __user *arg);
451extern int ata_scsi_queuecmd(struct scsi_cmnd *cmd, void (*done)(struct scsi_cmnd *));
452extern int ata_scsi_error(struct Scsi_Host *host);
453extern int ata_scsi_release(struct Scsi_Host *host);
454extern unsigned int ata_host_intr(struct ata_port *ap, struct ata_queued_cmd *qc);
Jens Axboe9b847542006-01-06 09:28:07 +0100455extern int ata_scsi_device_resume(struct scsi_device *);
456extern int ata_scsi_device_suspend(struct scsi_device *);
457extern int ata_device_resume(struct ata_port *, struct ata_device *);
458extern int ata_device_suspend(struct ata_port *, struct ata_device *);
Jeff Garzik67846b32005-10-05 02:58:32 -0400459extern int ata_ratelimit(void);
460
Linus Torvalds1da177e2005-04-16 15:20:36 -0700461/*
462 * Default driver ops implementations
463 */
Jeff Garzik057ace52005-10-22 14:27:05 -0400464extern void ata_tf_load(struct ata_port *ap, const struct ata_taskfile *tf);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700465extern void ata_tf_read(struct ata_port *ap, struct ata_taskfile *tf);
Jeff Garzik057ace52005-10-22 14:27:05 -0400466extern void ata_tf_to_fis(const struct ata_taskfile *tf, u8 *fis, u8 pmp);
467extern void ata_tf_from_fis(const u8 *fis, struct ata_taskfile *tf);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700468extern void ata_noop_dev_select (struct ata_port *ap, unsigned int device);
469extern void ata_std_dev_select (struct ata_port *ap, unsigned int device);
470extern u8 ata_check_status(struct ata_port *ap);
471extern u8 ata_altstatus(struct ata_port *ap);
Jeff Garzik057ace52005-10-22 14:27:05 -0400472extern void ata_exec_command(struct ata_port *ap, const struct ata_taskfile *tf);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700473extern int ata_port_start (struct ata_port *ap);
474extern void ata_port_stop (struct ata_port *ap);
Jeff Garzikaa8f0dc2005-05-26 21:54:27 -0400475extern void ata_host_stop (struct ata_host_set *host_set);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700476extern irqreturn_t ata_interrupt (int irq, void *dev_instance, struct pt_regs *regs);
477extern void ata_qc_prep(struct ata_queued_cmd *qc);
478extern int ata_qc_issue_prot(struct ata_queued_cmd *qc);
479extern void ata_sg_init_one(struct ata_queued_cmd *qc, void *buf,
480 unsigned int buflen);
481extern void ata_sg_init(struct ata_queued_cmd *qc, struct scatterlist *sg,
482 unsigned int n_elem);
Jeff Garzik057ace52005-10-22 14:27:05 -0400483extern unsigned int ata_dev_classify(const struct ata_taskfile *tf);
484extern void ata_dev_id_string(const u16 *id, unsigned char *s,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700485 unsigned int ofs, unsigned int len);
Brad Campbell6f2f3812005-05-12 15:07:47 -0400486extern void ata_dev_config(struct ata_port *ap, unsigned int i);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700487extern void ata_bmdma_setup (struct ata_queued_cmd *qc);
488extern void ata_bmdma_start (struct ata_queued_cmd *qc);
Alan Coxb73fc892005-08-26 16:03:19 +0100489extern void ata_bmdma_stop(struct ata_queued_cmd *qc);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700490extern u8 ata_bmdma_status(struct ata_port *ap);
491extern void ata_bmdma_irq_clear(struct ata_port *ap);
Albert Leea22e2eb2005-12-05 15:38:02 +0800492extern void ata_qc_complete(struct ata_queued_cmd *qc);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700493extern void ata_eng_timeout(struct ata_port *ap);
Tejun Heo9a3dccc2006-01-06 09:56:18 +0100494extern void ata_scsi_simulate(struct ata_port *ap, struct ata_device *dev,
495 struct scsi_cmnd *cmd,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700496 void (*done)(struct scsi_cmnd *));
497extern int ata_std_bios_param(struct scsi_device *sdev,
498 struct block_device *bdev,
499 sector_t capacity, int geom[]);
500extern int ata_scsi_slave_config(struct scsi_device *sdev);
501
Alan Cox452503f2005-10-21 19:01:32 -0400502/*
503 * Timing helpers
504 */
Alan Cox1bc4ccf2006-01-09 17:18:14 +0000505
506extern unsigned int ata_pio_need_iordy(const struct ata_device *);
Alan Cox452503f2005-10-21 19:01:32 -0400507extern int ata_timing_compute(struct ata_device *, unsigned short,
508 struct ata_timing *, int, int);
509extern void ata_timing_merge(const struct ata_timing *,
510 const struct ata_timing *, struct ata_timing *,
511 unsigned int);
512
513enum {
514 ATA_TIMING_SETUP = (1 << 0),
515 ATA_TIMING_ACT8B = (1 << 1),
516 ATA_TIMING_REC8B = (1 << 2),
517 ATA_TIMING_CYC8B = (1 << 3),
518 ATA_TIMING_8BIT = ATA_TIMING_ACT8B | ATA_TIMING_REC8B |
519 ATA_TIMING_CYC8B,
520 ATA_TIMING_ACTIVE = (1 << 4),
521 ATA_TIMING_RECOVER = (1 << 5),
522 ATA_TIMING_CYCLE = (1 << 6),
523 ATA_TIMING_UDMA = (1 << 7),
524 ATA_TIMING_ALL = ATA_TIMING_SETUP | ATA_TIMING_ACT8B |
525 ATA_TIMING_REC8B | ATA_TIMING_CYC8B |
526 ATA_TIMING_ACTIVE | ATA_TIMING_RECOVER |
527 ATA_TIMING_CYCLE | ATA_TIMING_UDMA,
528};
529
Linus Torvalds1da177e2005-04-16 15:20:36 -0700530
531#ifdef CONFIG_PCI
532struct pci_bits {
533 unsigned int reg; /* PCI config register to read */
534 unsigned int width; /* 1 (8 bit), 2 (16 bit), 4 (32 bit) */
535 unsigned long mask;
536 unsigned long val;
537};
538
Jeff Garzik374b1872005-08-30 05:42:52 -0400539extern void ata_pci_host_stop (struct ata_host_set *host_set);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700540extern struct ata_probe_ent *
Alan Cox47a86592005-10-04 08:09:19 -0400541ata_pci_init_native_mode(struct pci_dev *pdev, struct ata_port_info **port, int portmask);
Jeff Garzik057ace52005-10-22 14:27:05 -0400542extern int pci_test_config_bits(struct pci_dev *pdev, const struct pci_bits *bits);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700543
544#endif /* CONFIG_PCI */
545
546
Jeff Garzik972c26b2005-10-18 22:14:54 -0400547static inline int
548ata_sg_is_last(struct scatterlist *sg, struct ata_queued_cmd *qc)
549{
550 if (sg == &qc->pad_sgent)
551 return 1;
552 if (qc->pad_len)
553 return 0;
554 if (((sg - qc->__sg) + 1) == qc->n_elem)
555 return 1;
556 return 0;
557}
558
Jeff Garzikcedc9a42005-10-05 07:13:30 -0400559static inline struct scatterlist *
560ata_qc_next_sg(struct scatterlist *sg, struct ata_queued_cmd *qc)
561{
562 if (sg == &qc->pad_sgent)
563 return NULL;
564 if (++sg - qc->__sg < qc->n_elem)
565 return sg;
566 return qc->pad_len ? &qc->pad_sgent : NULL;
567}
568
569#define ata_for_each_sg(sg, qc) \
570 for (sg = qc->__sg; sg; sg = ata_qc_next_sg(sg, qc))
571
Linus Torvalds1da177e2005-04-16 15:20:36 -0700572static inline unsigned int ata_tag_valid(unsigned int tag)
573{
574 return (tag < ATA_MAX_QUEUE) ? 1 : 0;
575}
576
Jeff Garzik057ace52005-10-22 14:27:05 -0400577static inline unsigned int ata_dev_present(const struct ata_device *dev)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700578{
579 return ((dev->class == ATA_DEV_ATA) ||
580 (dev->class == ATA_DEV_ATAPI));
581}
582
583static inline u8 ata_chk_status(struct ata_port *ap)
584{
585 return ap->ops->check_status(ap);
586}
587
Edward Falk0baab862005-06-02 18:17:13 -0400588
589/**
590 * ata_pause - Flush writes and pause 400 nanoseconds.
591 * @ap: Port to wait for.
592 *
593 * LOCKING:
594 * Inherited from caller.
595 */
596
Linus Torvalds1da177e2005-04-16 15:20:36 -0700597static inline void ata_pause(struct ata_port *ap)
598{
599 ata_altstatus(ap);
600 ndelay(400);
601}
602
Edward Falk0baab862005-06-02 18:17:13 -0400603
604/**
605 * ata_busy_wait - Wait for a port status register
606 * @ap: Port to wait for.
607 *
608 * Waits up to max*10 microseconds for the selected bits in the port's
609 * status register to be cleared.
610 * Returns final value of status register.
611 *
612 * LOCKING:
613 * Inherited from caller.
614 */
615
Linus Torvalds1da177e2005-04-16 15:20:36 -0700616static inline u8 ata_busy_wait(struct ata_port *ap, unsigned int bits,
617 unsigned int max)
618{
619 u8 status;
620
621 do {
622 udelay(10);
623 status = ata_chk_status(ap);
624 max--;
625 } while ((status & bits) && (max > 0));
626
627 return status;
628}
629
Edward Falk0baab862005-06-02 18:17:13 -0400630
631/**
632 * ata_wait_idle - Wait for a port to be idle.
633 * @ap: Port to wait for.
634 *
635 * Waits up to 10ms for port's BUSY and DRQ signals to clear.
636 * Returns final value of status register.
637 *
638 * LOCKING:
639 * Inherited from caller.
640 */
641
Linus Torvalds1da177e2005-04-16 15:20:36 -0700642static inline u8 ata_wait_idle(struct ata_port *ap)
643{
644 u8 status = ata_busy_wait(ap, ATA_BUSY | ATA_DRQ, 1000);
645
646 if (status & (ATA_BUSY | ATA_DRQ)) {
647 unsigned long l = ap->ioaddr.status_addr;
648 printk(KERN_WARNING
649 "ATA: abnormal status 0x%X on port 0x%lX\n",
650 status, l);
651 }
652
653 return status;
654}
655
656static inline void ata_qc_set_polling(struct ata_queued_cmd *qc)
657{
658 qc->tf.ctl |= ATA_NIEN;
659}
660
661static inline struct ata_queued_cmd *ata_qc_from_tag (struct ata_port *ap,
662 unsigned int tag)
663{
664 if (likely(ata_tag_valid(tag)))
665 return &ap->qcmd[tag];
666 return NULL;
667}
668
669static inline void ata_tf_init(struct ata_port *ap, struct ata_taskfile *tf, unsigned int device)
670{
671 memset(tf, 0, sizeof(*tf));
672
673 tf->ctl = ap->ctl;
674 if (device == 0)
675 tf->device = ATA_DEVICE_OBS;
676 else
677 tf->device = ATA_DEVICE_OBS | ATA_DEV1;
678}
679
Jeff Garzik2c13b7c2005-11-14 14:14:16 -0500680static inline void ata_qc_reinit(struct ata_queued_cmd *qc)
681{
682 qc->__sg = NULL;
683 qc->flags = 0;
684 qc->cursect = qc->cursg = qc->cursg_ofs = 0;
685 qc->nsect = 0;
686 qc->nbytes = qc->curbytes = 0;
Albert Leea22e2eb2005-12-05 15:38:02 +0800687 qc->err_mask = 0;
Jeff Garzik2c13b7c2005-11-14 14:14:16 -0500688
689 ata_tf_init(qc->ap, &qc->tf, qc->dev->devno);
690}
691
Edward Falk0baab862005-06-02 18:17:13 -0400692
693/**
694 * ata_irq_on - Enable interrupts on a port.
695 * @ap: Port on which interrupts are enabled.
696 *
697 * Enable interrupts on a legacy IDE device using MMIO or PIO,
698 * wait for idle, clear any pending interrupts.
699 *
700 * LOCKING:
701 * Inherited from caller.
702 */
703
Linus Torvalds1da177e2005-04-16 15:20:36 -0700704static inline u8 ata_irq_on(struct ata_port *ap)
705{
706 struct ata_ioports *ioaddr = &ap->ioaddr;
707 u8 tmp;
708
709 ap->ctl &= ~ATA_NIEN;
710 ap->last_ctl = ap->ctl;
711
712 if (ap->flags & ATA_FLAG_MMIO)
713 writeb(ap->ctl, (void __iomem *) ioaddr->ctl_addr);
714 else
715 outb(ap->ctl, ioaddr->ctl_addr);
716 tmp = ata_wait_idle(ap);
717
718 ap->ops->irq_clear(ap);
719
720 return tmp;
721}
722
Edward Falk0baab862005-06-02 18:17:13 -0400723
724/**
725 * ata_irq_ack - Acknowledge a device interrupt.
726 * @ap: Port on which interrupts are enabled.
727 *
728 * Wait up to 10 ms for legacy IDE device to become idle (BUSY
729 * or BUSY+DRQ clear). Obtain dma status and port status from
730 * device. Clear the interrupt. Return port status.
731 *
732 * LOCKING:
733 */
734
Linus Torvalds1da177e2005-04-16 15:20:36 -0700735static inline u8 ata_irq_ack(struct ata_port *ap, unsigned int chk_drq)
736{
737 unsigned int bits = chk_drq ? ATA_BUSY | ATA_DRQ : ATA_BUSY;
738 u8 host_stat, post_stat, status;
739
740 status = ata_busy_wait(ap, bits, 1000);
741 if (status & bits)
742 DPRINTK("abnormal status 0x%X\n", status);
743
744 /* get controller status; clear intr, err bits */
745 if (ap->flags & ATA_FLAG_MMIO) {
746 void __iomem *mmio = (void __iomem *) ap->ioaddr.bmdma_addr;
747 host_stat = readb(mmio + ATA_DMA_STATUS);
748 writeb(host_stat | ATA_DMA_INTR | ATA_DMA_ERR,
749 mmio + ATA_DMA_STATUS);
750
751 post_stat = readb(mmio + ATA_DMA_STATUS);
752 } else {
753 host_stat = inb(ap->ioaddr.bmdma_addr + ATA_DMA_STATUS);
754 outb(host_stat | ATA_DMA_INTR | ATA_DMA_ERR,
755 ap->ioaddr.bmdma_addr + ATA_DMA_STATUS);
756
757 post_stat = inb(ap->ioaddr.bmdma_addr + ATA_DMA_STATUS);
758 }
759
760 VPRINTK("irq ack: host_stat 0x%X, new host_stat 0x%X, drv_stat 0x%X\n",
761 host_stat, post_stat, status);
762
763 return status;
764}
765
766static inline u32 scr_read(struct ata_port *ap, unsigned int reg)
767{
768 return ap->ops->scr_read(ap, reg);
769}
770
771static inline void scr_write(struct ata_port *ap, unsigned int reg, u32 val)
772{
773 ap->ops->scr_write(ap, reg, val);
774}
775
Jeff Garzik8a60a072005-07-31 13:13:24 -0400776static inline void scr_write_flush(struct ata_port *ap, unsigned int reg,
Brett Russcdcca89e2005-03-28 15:10:27 -0500777 u32 val)
778{
779 ap->ops->scr_write(ap, reg, val);
780 (void) ap->ops->scr_read(ap, reg);
781}
782
Linus Torvalds1da177e2005-04-16 15:20:36 -0700783static inline unsigned int sata_dev_present(struct ata_port *ap)
784{
785 return ((scr_read(ap, SCR_STATUS) & 0xf) == 0x3) ? 1 : 0;
786}
787
Jeff Garzik057ace52005-10-22 14:27:05 -0400788static inline int ata_try_flush_cache(const struct ata_device *dev)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700789{
790 return ata_id_wcache_enabled(dev->id) ||
791 ata_id_has_flush(dev->id) ||
792 ata_id_has_flush_ext(dev->id);
793}
794
Jeff Garzika7dac442005-10-30 04:44:42 -0500795static inline unsigned int ac_err_mask(u8 status)
796{
797 if (status & ATA_BUSY)
798 return AC_ERR_ATA_BUS;
799 if (status & (ATA_ERR | ATA_DF))
800 return AC_ERR_DEV;
801 return 0;
802}
803
804static inline unsigned int __ac_err_mask(u8 status)
805{
806 unsigned int mask = ac_err_mask(status);
807 if (mask == 0)
808 return AC_ERR_OTHER;
809 return mask;
810}
811
Jeff Garzik6037d6b2005-11-04 22:08:00 -0500812static inline int ata_pad_alloc(struct ata_port *ap, struct device *dev)
813{
814 ap->pad_dma = 0;
815 ap->pad = dma_alloc_coherent(dev, ATA_DMA_PAD_BUF_SZ,
816 &ap->pad_dma, GFP_KERNEL);
817 return (ap->pad == NULL) ? -ENOMEM : 0;
818}
819
820static inline void ata_pad_free(struct ata_port *ap, struct device *dev)
821{
822 dma_free_coherent(dev, ATA_DMA_PAD_BUF_SZ, ap->pad, ap->pad_dma);
823}
824
Linus Torvalds1da177e2005-04-16 15:20:36 -0700825#endif /* __LINUX_LIBATA_H__ */