2 * Copyright (C) 2004 Red Hat
3 * Copyright (C) 2007 Bartlomiej Zolnierkiewicz
5 * May be copied or modified under the terms of the GNU General Public License
6 * Based in part on the ITE vendor provided SCSI driver.
9 * Datasheet is freely available, some other documents under NDA.
11 * The ITE8212 isn't exactly a standard IDE controller. It has two
12 * modes. In pass through mode then it is an IDE controller. In its smart
13 * mode its actually quite a capable hardware raid controller disguised
14 * as an IDE controller. Smart mode only understands DMA read/write and
15 * identify, none of the fancier commands apply. The IT8211 is identical
16 * in other respects but lacks the raid mode.
19 * o Rev 0x10 also requires master/slave hold the same DMA timings and
20 * cannot do ATAPI MWDMA.
21 * o The identify data for raid volumes lacks CHS info (technically ok)
22 * but also fails to set the LBA28 and other bits. We fix these in
23 * the IDE probe quirk code.
24 * o If you write LBA48 sized I/O's (ie > 256 sector) in smart mode
25 * raid then the controller firmware dies
26 * o Smart mode without RAID doesn't clear all the necessary identify
27 * bits to reduce the command set to the one used
29 * This has a few impacts on the driver
30 * - In pass through mode we do all the work you would expect
31 * - In smart mode the clocking set up is done by the controller generally
32 * but we must watch the other limits and filter.
33 * - There are a few extra vendor commands that actually talk to the
34 * controller but only work PIO with no IRQ.
36 * Vendor areas of the identify block in smart mode are used for the
37 * timing and policy set up. Each HDD in raid mode also has a serial
38 * block on the disk. The hardware extra commands are get/set chip status,
39 * rebuild, get rebuild status.
41 * In Linux the driver supports pass through mode as if the device was
42 * just another IDE controller. If the smart mode is running then
43 * volumes are managed by the controller firmware and each IDE "disk"
44 * is a raid volume. Even more cute - the controller can do automated
45 * hotplug and rebuild.
47 * The pass through controller itself is a little demented. It has a
48 * flaw that it has a single set of PIO/MWDMA timings per channel so
49 * non UDMA devices restrict each others performance. It also has a
50 * single clock source per channel so mixed UDMA100/133 performance
51 * isn't perfect and we have to pick a clock. Thankfully none of this
52 * matters in smart mode. ATAPI DMA is not currently supported.
54 * It seems the smart mode is a win for RAID1/RAID10 but otherwise not.
57 * - ATAPI UDMA is ok but not MWDMA it seems
58 * - RAID configuration ioctls
59 * - Move to libata once it grows up
62 #include <linux/types.h>
63 #include <linux/module.h>
64 #include <linux/slab.h>
65 #include <linux/pci.h>
66 #include <linux/ide.h>
67 #include <linux/init.h>
69 #define DRV_NAME "it821x"
71 #define QUIRK_VORTEX86 1
75 unsigned int smart:1, /* Are we in smart raid mode */
76 timing10:1; /* Rev 0x10 */
77 u8 clock_mode; /* 0, ATA_50 or ATA_66 */
78 u8 want[2][2]; /* Mode/Pri log for master slave */
79 /* We need these for switching the clock when DMA goes on/off
80 The high byte is the 66Mhz timing */
81 u16 pio[2]; /* Cached PIO values */
82 u16 mwdma[2]; /* Cached MWDMA values */
83 u16 udma[2]; /* Cached UDMA values (per drive) */
95 * We allow users to force the card into non raid mode without
96 * flashing the alternative BIOS. This is also necessary right now
97 * for embedded platforms that cannot run a PC BIOS but are using this
101 static int it8212_noraid;
104 * it821x_program - program the PIO/MWDMA registers
105 * @drive: drive to tune
106 * @timing: timing info
108 * Program the PIO/MWDMA timing for this channel according to the
112 static void it821x_program(ide_drive_t *drive, u16 timing)
114 ide_hwif_t *hwif = drive->hwif;
115 struct pci_dev *dev = to_pci_dev(hwif->dev);
116 struct it821x_dev *itdev = ide_get_hwifdata(hwif);
117 int channel = hwif->channel;
120 /* Program PIO/MWDMA timing bits */
121 if(itdev->clock_mode == ATA_66)
124 conf = timing & 0xFF;
126 pci_write_config_byte(dev, 0x54 + 4 * channel, conf);
130 * it821x_program_udma - program the UDMA registers
131 * @drive: drive to tune
132 * @timing: timing info
134 * Program the UDMA timing for this drive according to the
138 static void it821x_program_udma(ide_drive_t *drive, u16 timing)
140 ide_hwif_t *hwif = drive->hwif;
141 struct pci_dev *dev = to_pci_dev(hwif->dev);
142 struct it821x_dev *itdev = ide_get_hwifdata(hwif);
143 int channel = hwif->channel;
144 u8 unit = drive->dn & 1, conf;
146 /* Program UDMA timing bits */
147 if(itdev->clock_mode == ATA_66)
150 conf = timing & 0xFF;
152 if (itdev->timing10 == 0)
153 pci_write_config_byte(dev, 0x56 + 4 * channel + unit, conf);
155 pci_write_config_byte(dev, 0x56 + 4 * channel, conf);
156 pci_write_config_byte(dev, 0x56 + 4 * channel + 1, conf);
161 * it821x_clock_strategy
162 * @drive: drive to set up
164 * Select between the 50 and 66Mhz base clocks to get the best
165 * results for this interface.
168 static void it821x_clock_strategy(ide_drive_t *drive)
170 ide_hwif_t *hwif = drive->hwif;
171 struct pci_dev *dev = to_pci_dev(hwif->dev);
172 struct it821x_dev *itdev = ide_get_hwifdata(hwif);
173 ide_drive_t *pair = ide_get_pair_dev(drive);
174 int clock, altclock, sel = 0;
175 u8 unit = drive->dn & 1, v;
177 if(itdev->want[0][0] > itdev->want[1][0]) {
178 clock = itdev->want[0][1];
179 altclock = itdev->want[1][1];
181 clock = itdev->want[1][1];
182 altclock = itdev->want[0][1];
186 * if both clocks can be used for the mode with the higher priority
187 * use the clock needed by the mode with the lower priority
189 if (clock == ATA_ANY)
192 /* Nobody cares - keep the same clock */
196 if(clock == itdev->clock_mode)
199 /* Load this into the controller ? */
201 itdev->clock_mode = ATA_66;
203 itdev->clock_mode = ATA_50;
207 pci_read_config_byte(dev, 0x50, &v);
208 v &= ~(1 << (1 + hwif->channel));
209 v |= sel << (1 + hwif->channel);
210 pci_write_config_byte(dev, 0x50, v);
213 * Reprogram the UDMA/PIO of the pair drive for the switch
214 * MWDMA will be dealt with by the dma switcher
216 if(pair && itdev->udma[1-unit] != UDMA_OFF) {
217 it821x_program_udma(pair, itdev->udma[1-unit]);
218 it821x_program(pair, itdev->pio[1-unit]);
221 * Reprogram the UDMA/PIO of our drive for the switch.
222 * MWDMA will be dealt with by the dma switcher
224 if(itdev->udma[unit] != UDMA_OFF) {
225 it821x_program_udma(drive, itdev->udma[unit]);
226 it821x_program(drive, itdev->pio[unit]);
231 * it821x_set_pio_mode - set host controller for PIO mode
235 * Tune the host to the desired PIO mode taking into the consideration
236 * the maximum PIO mode supported by the other device on the cable.
239 static void it821x_set_pio_mode(ide_hwif_t *hwif, ide_drive_t *drive)
241 struct it821x_dev *itdev = ide_get_hwifdata(hwif);
242 ide_drive_t *pair = ide_get_pair_dev(drive);
243 const u8 pio = drive->pio_mode - XFER_PIO_0;
244 u8 unit = drive->dn & 1, set_pio = pio;
246 /* Spec says 89 ref driver uses 88 */
247 static u16 pio_timings[]= { 0xAA88, 0xA382, 0xA181, 0x3332, 0x3121 };
248 static u8 pio_want[] = { ATA_66, ATA_66, ATA_66, ATA_66, ATA_ANY };
251 * Compute the best PIO mode we can for a given device. We must
252 * pick a speed that does not cause problems with the other device
256 u8 pair_pio = pair->pio_mode - XFER_PIO_0;
257 /* trim PIO to the slowest of the master/slave */
258 if (pair_pio < set_pio)
262 /* We prefer 66Mhz clock for PIO 0-3, don't care for PIO4 */
263 itdev->want[unit][1] = pio_want[set_pio];
264 itdev->want[unit][0] = 1; /* PIO is lowest priority */
265 itdev->pio[unit] = pio_timings[set_pio];
266 it821x_clock_strategy(drive);
267 it821x_program(drive, itdev->pio[unit]);
271 * it821x_tune_mwdma - tune a channel for MWDMA
272 * @drive: drive to set up
273 * @mode_wanted: the target operating mode
275 * Load the timing settings for this device mode into the
276 * controller when doing MWDMA in pass through mode. The caller
277 * must manage the whole lack of per device MWDMA/PIO timings and
278 * the shared MWDMA/PIO timing register.
281 static void it821x_tune_mwdma(ide_drive_t *drive, u8 mode_wanted)
283 ide_hwif_t *hwif = drive->hwif;
284 struct pci_dev *dev = to_pci_dev(hwif->dev);
285 struct it821x_dev *itdev = (void *)ide_get_hwifdata(hwif);
286 u8 unit = drive->dn & 1, channel = hwif->channel, conf;
288 static u16 dma[] = { 0x8866, 0x3222, 0x3121 };
289 static u8 mwdma_want[] = { ATA_ANY, ATA_66, ATA_ANY };
291 itdev->want[unit][1] = mwdma_want[mode_wanted];
292 itdev->want[unit][0] = 2; /* MWDMA is low priority */
293 itdev->mwdma[unit] = dma[mode_wanted];
294 itdev->udma[unit] = UDMA_OFF;
296 /* UDMA bits off - Revision 0x10 do them in pairs */
297 pci_read_config_byte(dev, 0x50, &conf);
299 conf |= channel ? 0x60: 0x18;
301 conf |= 1 << (3 + 2 * channel + unit);
302 pci_write_config_byte(dev, 0x50, conf);
304 it821x_clock_strategy(drive);
305 /* FIXME: do we need to program this ? */
306 /* it821x_program(drive, itdev->mwdma[unit]); */
310 * it821x_tune_udma - tune a channel for UDMA
311 * @drive: drive to set up
312 * @mode_wanted: the target operating mode
314 * Load the timing settings for this device mode into the
315 * controller when doing UDMA modes in pass through.
318 static void it821x_tune_udma(ide_drive_t *drive, u8 mode_wanted)
320 ide_hwif_t *hwif = drive->hwif;
321 struct pci_dev *dev = to_pci_dev(hwif->dev);
322 struct it821x_dev *itdev = ide_get_hwifdata(hwif);
323 u8 unit = drive->dn & 1, channel = hwif->channel, conf;
325 static u16 udma[] = { 0x4433, 0x4231, 0x3121, 0x2121, 0x1111, 0x2211, 0x1111 };
326 static u8 udma_want[] = { ATA_ANY, ATA_50, ATA_ANY, ATA_66, ATA_66, ATA_50, ATA_66 };
328 itdev->want[unit][1] = udma_want[mode_wanted];
329 itdev->want[unit][0] = 3; /* UDMA is high priority */
330 itdev->mwdma[unit] = MWDMA_OFF;
331 itdev->udma[unit] = udma[mode_wanted];
333 itdev->udma[unit] |= 0x8080; /* UDMA 5/6 select on */
335 /* UDMA on. Again revision 0x10 must do the pair */
336 pci_read_config_byte(dev, 0x50, &conf);
338 conf &= channel ? 0x9F: 0xE7;
340 conf &= ~ (1 << (3 + 2 * channel + unit));
341 pci_write_config_byte(dev, 0x50, conf);
343 it821x_clock_strategy(drive);
344 it821x_program_udma(drive, itdev->udma[unit]);
349 * it821x_dma_read - DMA hook
350 * @drive: drive for DMA
352 * The IT821x has a single timing register for MWDMA and for PIO
353 * operations. As we flip back and forth we have to reload the
354 * clock. In addition the rev 0x10 device only works if the same
355 * timing value is loaded into the master and slave UDMA clock
356 * so we must also reload that.
358 * FIXME: we could figure out in advance if we need to do reloads
361 static void it821x_dma_start(ide_drive_t *drive)
363 ide_hwif_t *hwif = drive->hwif;
364 struct it821x_dev *itdev = ide_get_hwifdata(hwif);
365 u8 unit = drive->dn & 1;
367 if(itdev->mwdma[unit] != MWDMA_OFF)
368 it821x_program(drive, itdev->mwdma[unit]);
369 else if(itdev->udma[unit] != UDMA_OFF && itdev->timing10)
370 it821x_program_udma(drive, itdev->udma[unit]);
371 ide_dma_start(drive);
375 * it821x_dma_write - DMA hook
376 * @drive: drive for DMA stop
378 * The IT821x has a single timing register for MWDMA and for PIO
379 * operations. As we flip back and forth we have to reload the
383 static int it821x_dma_end(ide_drive_t *drive)
385 ide_hwif_t *hwif = drive->hwif;
386 struct it821x_dev *itdev = ide_get_hwifdata(hwif);
387 int ret = ide_dma_end(drive);
388 u8 unit = drive->dn & 1;
390 if(itdev->mwdma[unit] != MWDMA_OFF)
391 it821x_program(drive, itdev->pio[unit]);
396 * it821x_set_dma_mode - set host controller for DMA mode
400 * Tune the ITE chipset for the desired DMA mode.
403 static void it821x_set_dma_mode(ide_hwif_t *hwif, ide_drive_t *drive)
405 const u8 speed = drive->dma_mode;
408 * MWDMA tuning is really hard because our MWDMA and PIO
409 * timings are kept in the same place. We can switch in the
410 * host dma on/off callbacks.
412 if (speed >= XFER_UDMA_0 && speed <= XFER_UDMA_6)
413 it821x_tune_udma(drive, speed - XFER_UDMA_0);
414 else if (speed >= XFER_MW_DMA_0 && speed <= XFER_MW_DMA_2)
415 it821x_tune_mwdma(drive, speed - XFER_MW_DMA_0);
419 * it821x_cable_detect - cable detection
420 * @hwif: interface to check
422 * Check for the presence of an ATA66 capable cable on the
423 * interface. Problematic as it seems some cards don't have
424 * the needed logic onboard.
427 static u8 it821x_cable_detect(ide_hwif_t *hwif)
429 /* The reference driver also only does disk side */
430 return ATA_CBL_PATA80;
434 * it821x_quirkproc - post init callback
437 * This callback is run after the drive has been probed but
438 * before anything gets attached. It allows drivers to do any
439 * final tuning that is needed, or fixups to work around bugs.
442 static void it821x_quirkproc(ide_drive_t *drive)
444 struct it821x_dev *itdev = ide_get_hwifdata(drive->hwif);
449 * If we are in pass through mode then not much
450 * needs to be done, but we do bother to clear the
451 * IRQ mask as we may well be in PIO (eg rev 0x10)
452 * for now and we know unmasking is safe on this chipset.
454 drive->dev_flags |= IDE_DFLAG_UNMASK;
457 * Perform fixups on smart mode. We need to "lose" some
458 * capabilities the firmware lacks but does not filter, and
459 * also patch up some capability bits that it forgets to set
463 /* Check for RAID v native */
464 if (strstr((char *)&id[ATA_ID_PROD],
465 "Integrated Technology Express")) {
466 /* In raid mode the ident block is slightly buggy
467 We need to set the bits so that the IDE layer knows
468 LBA28. LBA48 and DMA ar valid */
469 id[ATA_ID_CAPABILITY] |= (3 << 8); /* LBA28, DMA */
470 id[ATA_ID_COMMAND_SET_2] |= 0x0400; /* LBA48 valid */
471 id[ATA_ID_CFS_ENABLE_2] |= 0x0400; /* LBA48 on */
472 /* Reporting logic */
473 printk(KERN_INFO "%s: IT8212 %sRAID %d volume",
474 drive->name, id[147] ? "Bootable " : "",
476 if (id[ATA_ID_CSFO] != 1)
477 printk(KERN_CONT "(%dK stripe)", id[146]);
478 printk(KERN_CONT ".\n");
480 /* Non RAID volume. Fixups to stop the core code
481 doing unsupported things */
482 id[ATA_ID_FIELD_VALID] &= 3;
483 id[ATA_ID_QUEUE_DEPTH] = 0;
484 id[ATA_ID_COMMAND_SET_1] = 0;
485 id[ATA_ID_COMMAND_SET_2] &= 0xC400;
486 id[ATA_ID_CFSSE] &= 0xC000;
487 id[ATA_ID_CFS_ENABLE_1] = 0;
488 id[ATA_ID_CFS_ENABLE_2] &= 0xC400;
489 id[ATA_ID_CSF_DEFAULT] &= 0xC000;
493 id[ATA_ID_CFA_POWER] = 0;
494 printk(KERN_INFO "%s: Performing identify fixups.\n",
499 * Set MWDMA0 mode as enabled/support - just to tell
500 * IDE core that DMA is supported (it821x hardware
501 * takes care of DMA mode programming).
503 if (ata_id_has_dma(id)) {
504 id[ATA_ID_MWDMA_MODES] |= 0x0101;
505 drive->current_speed = XFER_MW_DMA_0;
511 static struct ide_dma_ops it821x_pass_through_dma_ops = {
512 .dma_host_set = ide_dma_host_set,
513 .dma_setup = ide_dma_setup,
514 .dma_start = it821x_dma_start,
515 .dma_end = it821x_dma_end,
516 .dma_test_irq = ide_dma_test_irq,
517 .dma_lost_irq = ide_dma_lost_irq,
518 .dma_timer_expiry = ide_dma_sff_timer_expiry,
519 .dma_sff_read_status = ide_dma_sff_read_status,
523 * init_hwif_it821x - set up hwif structs
524 * @hwif: interface to set up
526 * We do the basic set up of the interface structure. The IT8212
527 * requires several custom handlers so we override the default
528 * ide DMA handlers appropriately
531 static void init_hwif_it821x(ide_hwif_t *hwif)
533 struct pci_dev *dev = to_pci_dev(hwif->dev);
534 struct ide_host *host = pci_get_drvdata(dev);
535 struct it821x_dev *itdevs = host->host_priv;
536 struct it821x_dev *idev = itdevs + hwif->channel;
539 ide_set_hwifdata(hwif, idev);
541 pci_read_config_byte(dev, 0x50, &conf);
544 hwif->host_flags |= IDE_HFLAG_NO_ATAPI_DMA;
545 /* Long I/O's although allowed in LBA48 space cause the
546 onboard firmware to enter the twighlight zone */
550 /* Pull the current clocks from 0x50 also */
551 if (conf & (1 << (1 + hwif->channel)))
552 idev->clock_mode = ATA_50;
554 idev->clock_mode = ATA_66;
556 idev->want[0][1] = ATA_ANY;
557 idev->want[1][1] = ATA_ANY;
560 * Not in the docs but according to the reference driver
564 if (dev->revision == 0x10) {
566 hwif->host_flags |= IDE_HFLAG_NO_ATAPI_DMA;
567 if (idev->smart == 0)
568 printk(KERN_WARNING DRV_NAME " %s: revision 0x10, "
569 "workarounds activated\n", pci_name(dev));
572 if (idev->smart == 0) {
573 /* MWDMA/PIO clock switching for pass through mode */
574 hwif->dma_ops = &it821x_pass_through_dma_ops;
576 hwif->host_flags |= IDE_HFLAG_NO_SET_MODE;
578 if (hwif->dma_base == 0)
581 hwif->ultra_mask = ATA_UDMA6;
582 hwif->mwdma_mask = ATA_MWDMA2;
584 /* Vortex86SX quirk: prevent Ultra-DMA mode to fix BadCRC issue */
585 if (idev->quirks & QUIRK_VORTEX86) {
586 if (dev->revision == 0x11)
587 hwif->ultra_mask = 0;
591 static void it8212_disable_raid(struct pci_dev *dev)
593 /* Reset local CPU, and set BIOS not ready */
594 pci_write_config_byte(dev, 0x5E, 0x01);
596 /* Set to bypass mode, and reset PCI bus */
597 pci_write_config_byte(dev, 0x50, 0x00);
598 pci_write_config_word(dev, PCI_COMMAND,
599 PCI_COMMAND_PARITY | PCI_COMMAND_IO |
600 PCI_COMMAND_MEMORY | PCI_COMMAND_MASTER);
601 pci_write_config_word(dev, 0x40, 0xA0F3);
603 pci_write_config_dword(dev,0x4C, 0x02040204);
604 pci_write_config_byte(dev, 0x42, 0x36);
605 pci_write_config_byte(dev, PCI_LATENCY_TIMER, 0x20);
608 static int init_chipset_it821x(struct pci_dev *dev)
611 static char *mode[2] = { "pass through", "smart" };
613 /* Force the card into bypass mode if so requested */
615 printk(KERN_INFO DRV_NAME " %s: forcing bypass mode\n",
617 it8212_disable_raid(dev);
619 pci_read_config_byte(dev, 0x50, &conf);
620 printk(KERN_INFO DRV_NAME " %s: controller in %s mode\n",
621 pci_name(dev), mode[conf & 1]);
625 static const struct ide_port_ops it821x_port_ops = {
626 /* it821x_set_{pio,dma}_mode() are only used in pass-through mode */
627 .set_pio_mode = it821x_set_pio_mode,
628 .set_dma_mode = it821x_set_dma_mode,
629 .quirkproc = it821x_quirkproc,
630 .cable_detect = it821x_cable_detect,
633 static const struct ide_port_info it821x_chipset = {
635 .init_chipset = init_chipset_it821x,
636 .init_hwif = init_hwif_it821x,
637 .port_ops = &it821x_port_ops,
638 .pio_mask = ATA_PIO4,
642 * it821x_init_one - pci layer discovery entry
644 * @id: ident table entry
646 * Called by the PCI code when it finds an ITE821x controller.
647 * We then use the IDE PCI generic helper to do most of the work.
650 static int it821x_init_one(struct pci_dev *dev, const struct pci_device_id *id)
652 struct it821x_dev *itdevs;
655 itdevs = kzalloc(2 * sizeof(*itdevs), GFP_KERNEL);
656 if (itdevs == NULL) {
657 printk(KERN_ERR DRV_NAME " %s: out of memory\n", pci_name(dev));
661 itdevs->quirks = id->driver_data;
663 rc = ide_pci_init_one(dev, &it821x_chipset, itdevs);
670 static void it821x_remove(struct pci_dev *dev)
672 struct ide_host *host = pci_get_drvdata(dev);
673 struct it821x_dev *itdevs = host->host_priv;
679 static const struct pci_device_id it821x_pci_tbl[] = {
680 { PCI_VDEVICE(ITE, PCI_DEVICE_ID_ITE_8211), 0 },
681 { PCI_VDEVICE(ITE, PCI_DEVICE_ID_ITE_8212), 0 },
682 { PCI_VDEVICE(RDC, PCI_DEVICE_ID_RDC_D1010), QUIRK_VORTEX86 },
686 MODULE_DEVICE_TABLE(pci, it821x_pci_tbl);
688 static struct pci_driver it821x_pci_driver = {
689 .name = "ITE821x IDE",
690 .id_table = it821x_pci_tbl,
691 .probe = it821x_init_one,
692 .remove = it821x_remove,
693 .suspend = ide_pci_suspend,
694 .resume = ide_pci_resume,
697 static int __init it821x_ide_init(void)
699 return ide_pci_register_driver(&it821x_pci_driver);
702 static void __exit it821x_ide_exit(void)
704 pci_unregister_driver(&it821x_pci_driver);
707 module_init(it821x_ide_init);
708 module_exit(it821x_ide_exit);
710 module_param_named(noraid, it8212_noraid, int, S_IRUGO);
711 MODULE_PARM_DESC(noraid, "Force card into bypass mode");
713 MODULE_AUTHOR("Alan Cox");
714 MODULE_DESCRIPTION("PCI driver module for the ITE 821x");
715 MODULE_LICENSE("GPL");