ide-lib.c revision 7f8f48af0861c38c28d4abd550102643e0ea9e6a
1#include <linux/module.h>
2#include <linux/types.h>
3#include <linux/string.h>
4#include <linux/kernel.h>
5#include <linux/timer.h>
6#include <linux/mm.h>
7#include <linux/interrupt.h>
8#include <linux/major.h>
9#include <linux/errno.h>
10#include <linux/genhd.h>
11#include <linux/blkpg.h>
12#include <linux/slab.h>
13#include <linux/pci.h>
14#include <linux/delay.h>
15#include <linux/hdreg.h>
16#include <linux/ide.h>
17#include <linux/bitops.h>
18
19#include <asm/byteorder.h>
20#include <asm/irq.h>
21#include <asm/uaccess.h>
22#include <asm/io.h>
23
24/*
25 *	IDE library routines. These are plug in code that most
26 *	drivers can use but occasionally may be weird enough
27 *	to want to do their own thing with
28 *
29 *	Add common non I/O op stuff here. Make sure it has proper
30 *	kernel-doc function headers or your patch will be rejected
31 */
32
33
34/**
35 *	ide_xfer_verbose	-	return IDE mode names
36 *	@xfer_rate: rate to name
37 *
38 *	Returns a constant string giving the name of the mode
39 *	requested.
40 */
41
42char *ide_xfer_verbose (u8 xfer_rate)
43{
44        switch(xfer_rate) {
45                case XFER_UDMA_7:	return("UDMA 7");
46                case XFER_UDMA_6:	return("UDMA 6");
47                case XFER_UDMA_5:	return("UDMA 5");
48                case XFER_UDMA_4:	return("UDMA 4");
49                case XFER_UDMA_3:	return("UDMA 3");
50                case XFER_UDMA_2:	return("UDMA 2");
51                case XFER_UDMA_1:	return("UDMA 1");
52                case XFER_UDMA_0:	return("UDMA 0");
53                case XFER_MW_DMA_2:	return("MW DMA 2");
54                case XFER_MW_DMA_1:	return("MW DMA 1");
55                case XFER_MW_DMA_0:	return("MW DMA 0");
56                case XFER_SW_DMA_2:	return("SW DMA 2");
57                case XFER_SW_DMA_1:	return("SW DMA 1");
58                case XFER_SW_DMA_0:	return("SW DMA 0");
59                case XFER_PIO_4:	return("PIO 4");
60                case XFER_PIO_3:	return("PIO 3");
61                case XFER_PIO_2:	return("PIO 2");
62                case XFER_PIO_1:	return("PIO 1");
63                case XFER_PIO_0:	return("PIO 0");
64                case XFER_PIO_SLOW:	return("PIO SLOW");
65                default:		return("XFER ERROR");
66        }
67}
68
69EXPORT_SYMBOL(ide_xfer_verbose);
70
71/**
72 *	ide_rate_filter		-	filter transfer mode
73 *	@drive: IDE device
74 *	@speed: desired speed
75 *
76 *	Given the available transfer modes this function returns
77 *	the best available speed at or below the speed requested.
78 *
79 *	FIXME: filter also PIO/SWDMA/MWDMA modes
80 */
81
82u8 ide_rate_filter(ide_drive_t *drive, u8 speed)
83{
84#ifdef CONFIG_BLK_DEV_IDEDMA
85	ide_hwif_t *hwif = drive->hwif;
86	u8 mask = hwif->ultra_mask, mode = XFER_MW_DMA_2;
87
88	if (hwif->udma_filter)
89		mask = hwif->udma_filter(drive);
90
91	/*
92	 * TODO: speed > XFER_UDMA_2 extra check is needed to avoid false
93	 * cable warning from eighty_ninty_three(), moving ide_rate_filter()
94	 * calls from ->speedproc to core code will make this hack go away
95	 */
96	if (speed > XFER_UDMA_2) {
97		if ((mask & 0x78) && (eighty_ninty_three(drive) == 0))
98			mask &= 0x07;
99	}
100
101	if (mask)
102		mode = fls(mask) - 1 + XFER_UDMA_0;
103
104//	printk("%s: mode 0x%02x, speed 0x%02x\n", __FUNCTION__, mode, speed);
105
106	return min(speed, mode);
107#else /* !CONFIG_BLK_DEV_IDEDMA */
108	return min(speed, (u8)XFER_PIO_4);
109#endif /* CONFIG_BLK_DEV_IDEDMA */
110}
111
112EXPORT_SYMBOL(ide_rate_filter);
113
114int ide_dma_enable (ide_drive_t *drive)
115{
116	ide_hwif_t *hwif	= HWIF(drive);
117	struct hd_driveid *id	= drive->id;
118
119	return ((int)	((((id->dma_ultra >> 8) & hwif->ultra_mask) ||
120			  ((id->dma_mword >> 8) & hwif->mwdma_mask) ||
121			  ((id->dma_1word >> 8) & hwif->swdma_mask)) ? 1 : 0));
122}
123
124EXPORT_SYMBOL(ide_dma_enable);
125
126int ide_use_fast_pio(ide_drive_t *drive)
127{
128	struct hd_driveid *id = drive->id;
129
130	if ((id->capability & 1) && drive->autodma)
131		return 1;
132
133	if ((id->capability & 8) || (id->field_valid & 2))
134		return 1;
135
136	return 0;
137}
138
139EXPORT_SYMBOL_GPL(ide_use_fast_pio);
140
141/*
142 * Standard (generic) timings for PIO modes, from ATA2 specification.
143 * These timings are for access to the IDE data port register *only*.
144 * Some drives may specify a mode, while also specifying a different
145 * value for cycle_time (from drive identification data).
146 */
147const ide_pio_timings_t ide_pio_timings[6] = {
148	{ 70,	165,	600 },	/* PIO Mode 0 */
149	{ 50,	125,	383 },	/* PIO Mode 1 */
150	{ 30,	100,	240 },	/* PIO Mode 2 */
151	{ 30,	80,	180 },	/* PIO Mode 3 with IORDY */
152	{ 25,	70,	120 },	/* PIO Mode 4 with IORDY */
153	{ 20,	50,	100 }	/* PIO Mode 5 with IORDY (nonstandard) */
154};
155
156EXPORT_SYMBOL_GPL(ide_pio_timings);
157
158/*
159 * Shared data/functions for determining best PIO mode for an IDE drive.
160 * Most of this stuff originally lived in cmd640.c, and changes to the
161 * ide_pio_blacklist[] table should be made with EXTREME CAUTION to avoid
162 * breaking the fragile cmd640.c support.
163 */
164
165/*
166 * Black list. Some drives incorrectly report their maximal PIO mode,
167 * at least in respect to CMD640. Here we keep info on some known drives.
168 */
169static struct ide_pio_info {
170	const char	*name;
171	int		pio;
172} ide_pio_blacklist [] = {
173/*	{ "Conner Peripherals 1275MB - CFS1275A", 4 }, */
174	{ "Conner Peripherals 540MB - CFS540A", 3 },
175
176	{ "WDC AC2700",  3 },
177	{ "WDC AC2540",  3 },
178	{ "WDC AC2420",  3 },
179	{ "WDC AC2340",  3 },
180	{ "WDC AC2250",  0 },
181	{ "WDC AC2200",  0 },
182	{ "WDC AC21200", 4 },
183	{ "WDC AC2120",  0 },
184	{ "WDC AC2850",  3 },
185	{ "WDC AC1270",  3 },
186	{ "WDC AC1170",  1 },
187	{ "WDC AC1210",  1 },
188	{ "WDC AC280",   0 },
189/*	{ "WDC AC21000", 4 }, */
190	{ "WDC AC31000", 3 },
191	{ "WDC AC31200", 3 },
192/*	{ "WDC AC31600", 4 }, */
193
194	{ "Maxtor 7131 AT", 1 },
195	{ "Maxtor 7171 AT", 1 },
196	{ "Maxtor 7213 AT", 1 },
197	{ "Maxtor 7245 AT", 1 },
198	{ "Maxtor 7345 AT", 1 },
199	{ "Maxtor 7546 AT", 3 },
200	{ "Maxtor 7540 AV", 3 },
201
202	{ "SAMSUNG SHD-3121A", 1 },
203	{ "SAMSUNG SHD-3122A", 1 },
204	{ "SAMSUNG SHD-3172A", 1 },
205
206/*	{ "ST51080A", 4 },
207 *	{ "ST51270A", 4 },
208 *	{ "ST31220A", 4 },
209 *	{ "ST31640A", 4 },
210 *	{ "ST32140A", 4 },
211 *	{ "ST3780A",  4 },
212 */
213	{ "ST5660A",  3 },
214	{ "ST3660A",  3 },
215	{ "ST3630A",  3 },
216	{ "ST3655A",  3 },
217	{ "ST3391A",  3 },
218	{ "ST3390A",  1 },
219	{ "ST3600A",  1 },
220	{ "ST3290A",  0 },
221	{ "ST3144A",  0 },
222	{ "ST3491A",  1 },	/* reports 3, should be 1 or 2 (depending on */
223				/* drive) according to Seagates FIND-ATA program */
224
225	{ "QUANTUM ELS127A", 0 },
226	{ "QUANTUM ELS170A", 0 },
227	{ "QUANTUM LPS240A", 0 },
228	{ "QUANTUM LPS210A", 3 },
229	{ "QUANTUM LPS270A", 3 },
230	{ "QUANTUM LPS365A", 3 },
231	{ "QUANTUM LPS540A", 3 },
232	{ "QUANTUM LIGHTNING 540A", 3 },
233	{ "QUANTUM LIGHTNING 730A", 3 },
234
235        { "QUANTUM FIREBALL_540", 3 }, /* Older Quantum Fireballs don't work */
236        { "QUANTUM FIREBALL_640", 3 },
237        { "QUANTUM FIREBALL_1080", 3 },
238        { "QUANTUM FIREBALL_1280", 3 },
239	{ NULL,	0 }
240};
241
242/**
243 *	ide_scan_pio_blacklist 	-	check for a blacklisted drive
244 *	@model: Drive model string
245 *
246 *	This routine searches the ide_pio_blacklist for an entry
247 *	matching the start/whole of the supplied model name.
248 *
249 *	Returns -1 if no match found.
250 *	Otherwise returns the recommended PIO mode from ide_pio_blacklist[].
251 */
252
253static int ide_scan_pio_blacklist (char *model)
254{
255	struct ide_pio_info *p;
256
257	for (p = ide_pio_blacklist; p->name != NULL; p++) {
258		if (strncmp(p->name, model, strlen(p->name)) == 0)
259			return p->pio;
260	}
261	return -1;
262}
263
264/**
265 *	ide_get_best_pio_mode	-	get PIO mode from drive
266 *	@drive: drive to consider
267 *	@mode_wanted: preferred mode
268 *	@max_mode: highest allowed mode
269 *	@d: PIO data
270 *
271 *	This routine returns the recommended PIO settings for a given drive,
272 *	based on the drive->id information and the ide_pio_blacklist[].
273 *
274 *	Drive PIO mode is auto-selected if 255 is passed as mode_wanted.
275 *	This is used by most chipset support modules when "auto-tuning".
276 */
277
278u8 ide_get_best_pio_mode (ide_drive_t *drive, u8 mode_wanted, u8 max_mode, ide_pio_data_t *d)
279{
280	int pio_mode;
281	int cycle_time = 0;
282	int use_iordy = 0;
283	struct hd_driveid* id = drive->id;
284	int overridden  = 0;
285
286	if (mode_wanted != 255) {
287		pio_mode = mode_wanted;
288		use_iordy = (pio_mode > 2);
289	} else if (!drive->id) {
290		pio_mode = 0;
291	} else if ((pio_mode = ide_scan_pio_blacklist(id->model)) != -1) {
292		overridden = 1;
293		use_iordy = (pio_mode > 2);
294	} else {
295		pio_mode = id->tPIO;
296		if (pio_mode > 2) {	/* 2 is maximum allowed tPIO value */
297			pio_mode = 2;
298			overridden = 1;
299		}
300		if (id->field_valid & 2) {	  /* drive implements ATA2? */
301			if (id->capability & 8) { /* drive supports use_iordy? */
302				use_iordy = 1;
303				cycle_time = id->eide_pio_iordy;
304				if (id->eide_pio_modes & 7) {
305					overridden = 0;
306					if (id->eide_pio_modes & 4)
307						pio_mode = 5;
308					else if (id->eide_pio_modes & 2)
309						pio_mode = 4;
310					else
311						pio_mode = 3;
312				}
313			} else {
314				cycle_time = id->eide_pio;
315			}
316		}
317
318		/*
319		 * Conservative "downgrade" for all pre-ATA2 drives
320		 */
321		if (pio_mode && pio_mode < 4) {
322			pio_mode--;
323			overridden = 1;
324			if (cycle_time && cycle_time < ide_pio_timings[pio_mode].cycle_time)
325				cycle_time = 0; /* use standard timing */
326		}
327	}
328	if (pio_mode > max_mode) {
329		pio_mode = max_mode;
330		cycle_time = 0;
331	}
332	if (d) {
333		d->pio_mode = pio_mode;
334		d->cycle_time = cycle_time ? cycle_time : ide_pio_timings[pio_mode].cycle_time;
335		d->use_iordy = use_iordy;
336		d->overridden = overridden;
337	}
338	return pio_mode;
339}
340
341EXPORT_SYMBOL_GPL(ide_get_best_pio_mode);
342
343/**
344 *	ide_toggle_bounce	-	handle bounce buffering
345 *	@drive: drive to update
346 *	@on: on/off boolean
347 *
348 *	Enable or disable bounce buffering for the device. Drives move
349 *	between PIO and DMA and that changes the rules we need.
350 */
351
352void ide_toggle_bounce(ide_drive_t *drive, int on)
353{
354	u64 addr = BLK_BOUNCE_HIGH;	/* dma64_addr_t */
355
356	if (!PCI_DMA_BUS_IS_PHYS) {
357		addr = BLK_BOUNCE_ANY;
358	} else if (on && drive->media == ide_disk) {
359		if (HWIF(drive)->pci_dev)
360			addr = HWIF(drive)->pci_dev->dma_mask;
361	}
362
363	if (drive->queue)
364		blk_queue_bounce_limit(drive->queue, addr);
365}
366
367/**
368 *	ide_set_xfer_rate	-	set transfer rate
369 *	@drive: drive to set
370 *	@speed: speed to attempt to set
371 *
372 *	General helper for setting the speed of an IDE device. This
373 *	function knows about user enforced limits from the configuration
374 *	which speedproc() does not.  High level drivers should never
375 *	invoke speedproc() directly.
376 */
377
378int ide_set_xfer_rate(ide_drive_t *drive, u8 rate)
379{
380#ifndef CONFIG_BLK_DEV_IDEDMA
381	rate = min(rate, (u8) XFER_PIO_4);
382#endif
383	if(HWIF(drive)->speedproc)
384		return HWIF(drive)->speedproc(drive, rate);
385	else
386		return -1;
387}
388
389static void ide_dump_opcode(ide_drive_t *drive)
390{
391	struct request *rq;
392	u8 opcode = 0;
393	int found = 0;
394
395	spin_lock(&ide_lock);
396	rq = NULL;
397	if (HWGROUP(drive))
398		rq = HWGROUP(drive)->rq;
399	spin_unlock(&ide_lock);
400	if (!rq)
401		return;
402	if (rq->cmd_type == REQ_TYPE_ATA_CMD ||
403	    rq->cmd_type == REQ_TYPE_ATA_TASK) {
404		char *args = rq->buffer;
405		if (args) {
406			opcode = args[0];
407			found = 1;
408		}
409	} else if (rq->cmd_type == REQ_TYPE_ATA_TASKFILE) {
410		ide_task_t *args = rq->special;
411		if (args) {
412			task_struct_t *tf = (task_struct_t *) args->tfRegister;
413			opcode = tf->command;
414			found = 1;
415		}
416	}
417
418	printk("ide: failed opcode was: ");
419	if (!found)
420		printk("unknown\n");
421	else
422		printk("0x%02x\n", opcode);
423}
424
425static u8 ide_dump_ata_status(ide_drive_t *drive, const char *msg, u8 stat)
426{
427	ide_hwif_t *hwif = HWIF(drive);
428	unsigned long flags;
429	u8 err = 0;
430
431	local_irq_save(flags);
432	printk("%s: %s: status=0x%02x { ", drive->name, msg, stat);
433	if (stat & BUSY_STAT)
434		printk("Busy ");
435	else {
436		if (stat & READY_STAT)	printk("DriveReady ");
437		if (stat & WRERR_STAT)	printk("DeviceFault ");
438		if (stat & SEEK_STAT)	printk("SeekComplete ");
439		if (stat & DRQ_STAT)	printk("DataRequest ");
440		if (stat & ECC_STAT)	printk("CorrectedError ");
441		if (stat & INDEX_STAT)	printk("Index ");
442		if (stat & ERR_STAT)	printk("Error ");
443	}
444	printk("}\n");
445	if ((stat & (BUSY_STAT|ERR_STAT)) == ERR_STAT) {
446		err = hwif->INB(IDE_ERROR_REG);
447		printk("%s: %s: error=0x%02x { ", drive->name, msg, err);
448		if (err & ABRT_ERR)	printk("DriveStatusError ");
449		if (err & ICRC_ERR)
450			printk((err & ABRT_ERR) ? "BadCRC " : "BadSector ");
451		if (err & ECC_ERR)	printk("UncorrectableError ");
452		if (err & ID_ERR)	printk("SectorIdNotFound ");
453		if (err & TRK0_ERR)	printk("TrackZeroNotFound ");
454		if (err & MARK_ERR)	printk("AddrMarkNotFound ");
455		printk("}");
456		if ((err & (BBD_ERR | ABRT_ERR)) == BBD_ERR ||
457		    (err & (ECC_ERR|ID_ERR|MARK_ERR))) {
458			if (drive->addressing == 1) {
459				__u64 sectors = 0;
460				u32 low = 0, high = 0;
461				low = ide_read_24(drive);
462				hwif->OUTB(drive->ctl|0x80, IDE_CONTROL_REG);
463				high = ide_read_24(drive);
464				sectors = ((__u64)high << 24) | low;
465				printk(", LBAsect=%llu, high=%d, low=%d",
466				       (unsigned long long) sectors,
467				       high, low);
468			} else {
469				u8 cur = hwif->INB(IDE_SELECT_REG);
470				if (cur & 0x40) {	/* using LBA? */
471					printk(", LBAsect=%ld", (unsigned long)
472					 ((cur&0xf)<<24)
473					 |(hwif->INB(IDE_HCYL_REG)<<16)
474					 |(hwif->INB(IDE_LCYL_REG)<<8)
475					 | hwif->INB(IDE_SECTOR_REG));
476				} else {
477					printk(", CHS=%d/%d/%d",
478					 (hwif->INB(IDE_HCYL_REG)<<8) +
479					  hwif->INB(IDE_LCYL_REG),
480					  cur & 0xf,
481					  hwif->INB(IDE_SECTOR_REG));
482				}
483			}
484			if (HWGROUP(drive) && HWGROUP(drive)->rq)
485				printk(", sector=%llu",
486					(unsigned long long)HWGROUP(drive)->rq->sector);
487		}
488		printk("\n");
489	}
490	ide_dump_opcode(drive);
491	local_irq_restore(flags);
492	return err;
493}
494
495/**
496 *	ide_dump_atapi_status       -       print human readable atapi status
497 *	@drive: drive that status applies to
498 *	@msg: text message to print
499 *	@stat: status byte to decode
500 *
501 *	Error reporting, in human readable form (luxurious, but a memory hog).
502 */
503
504static u8 ide_dump_atapi_status(ide_drive_t *drive, const char *msg, u8 stat)
505{
506	unsigned long flags;
507
508	atapi_status_t status;
509	atapi_error_t error;
510
511	status.all = stat;
512	error.all = 0;
513	local_irq_save(flags);
514	printk("%s: %s: status=0x%02x { ", drive->name, msg, stat);
515	if (status.b.bsy)
516		printk("Busy ");
517	else {
518		if (status.b.drdy)	printk("DriveReady ");
519		if (status.b.df)	printk("DeviceFault ");
520		if (status.b.dsc)	printk("SeekComplete ");
521		if (status.b.drq)	printk("DataRequest ");
522		if (status.b.corr)	printk("CorrectedError ");
523		if (status.b.idx)	printk("Index ");
524		if (status.b.check)	printk("Error ");
525	}
526	printk("}\n");
527	if (status.b.check && !status.b.bsy) {
528		error.all = HWIF(drive)->INB(IDE_ERROR_REG);
529		printk("%s: %s: error=0x%02x { ", drive->name, msg, error.all);
530		if (error.b.ili)	printk("IllegalLengthIndication ");
531		if (error.b.eom)	printk("EndOfMedia ");
532		if (error.b.abrt)	printk("AbortedCommand ");
533		if (error.b.mcr)	printk("MediaChangeRequested ");
534		if (error.b.sense_key)	printk("LastFailedSense=0x%02x ",
535						error.b.sense_key);
536		printk("}\n");
537	}
538	ide_dump_opcode(drive);
539	local_irq_restore(flags);
540	return error.all;
541}
542
543/**
544 *	ide_dump_status		-	translate ATA/ATAPI error
545 *	@drive: drive the error occured on
546 *	@msg: information string
547 *	@stat: status byte
548 *
549 *	Error reporting, in human readable form (luxurious, but a memory hog).
550 *	Combines the drive name, message and status byte to provide a
551 *	user understandable explanation of the device error.
552 */
553
554u8 ide_dump_status(ide_drive_t *drive, const char *msg, u8 stat)
555{
556	if (drive->media == ide_disk)
557		return ide_dump_ata_status(drive, msg, stat);
558	return ide_dump_atapi_status(drive, msg, stat);
559}
560
561EXPORT_SYMBOL(ide_dump_status);
562