Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1 | /* |
| 2 | * sata_sil.c - Silicon Image SATA |
| 3 | * |
Tejun Heo | 8c3d3d4 | 2013-05-14 11:09:50 -0700 | [diff] [blame] | 4 | * Maintained by: Tejun Heo <tj@kernel.org> |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 5 | * Please ALWAYS copy linux-ide@vger.kernel.org |
| 6 | * on emails. |
| 7 | * |
Jeff Garzik | af36d7f | 2005-08-28 20:18:39 -0400 | [diff] [blame] | 8 | * Copyright 2003-2005 Red Hat, Inc. |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 9 | * Copyright 2003 Benjamin Herrenschmidt |
| 10 | * |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 11 | * |
Jeff Garzik | af36d7f | 2005-08-28 20:18:39 -0400 | [diff] [blame] | 12 | * This program is free software; you can redistribute it and/or modify |
| 13 | * it under the terms of the GNU General Public License as published by |
| 14 | * the Free Software Foundation; either version 2, or (at your option) |
| 15 | * any later version. |
| 16 | * |
| 17 | * This program is distributed in the hope that it will be useful, |
| 18 | * but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 19 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| 20 | * GNU General Public License for more details. |
| 21 | * |
| 22 | * You should have received a copy of the GNU General Public License |
| 23 | * along with this program; see the file COPYING. If not, write to |
| 24 | * the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. |
| 25 | * |
| 26 | * |
| 27 | * libata documentation is available via 'make {ps|pdf}docs', |
| 28 | * as Documentation/DocBook/libata.* |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 29 | * |
Jeff Garzik | 953d113 | 2005-08-26 19:46:24 -0400 | [diff] [blame] | 30 | * Documentation for SiI 3112: |
| 31 | * http://gkernel.sourceforge.net/specs/sii/3112A_SiI-DS-0095-B2.pdf.bz2 |
| 32 | * |
| 33 | * Other errata and documentation available under NDA. |
| 34 | * |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 35 | */ |
| 36 | |
| 37 | #include <linux/kernel.h> |
| 38 | #include <linux/module.h> |
| 39 | #include <linux/pci.h> |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 40 | #include <linux/blkdev.h> |
| 41 | #include <linux/delay.h> |
| 42 | #include <linux/interrupt.h> |
Jeff Garzik | a9524a7 | 2005-10-30 14:39:11 -0500 | [diff] [blame] | 43 | #include <linux/device.h> |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 44 | #include <scsi/scsi_host.h> |
| 45 | #include <linux/libata.h> |
Alexander Beregalov | 1737ef7 | 2009-01-29 02:30:56 +0300 | [diff] [blame] | 46 | #include <linux/dmi.h> |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 47 | |
| 48 | #define DRV_NAME "sata_sil" |
Robert Hancock | c7e324f | 2008-12-24 19:06:06 -0600 | [diff] [blame] | 49 | #define DRV_VERSION "2.4" |
| 50 | |
| 51 | #define SIL_DMA_BOUNDARY 0x7fffffffUL |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 52 | |
| 53 | enum { |
Tejun Heo | 0d5ff56 | 2007-02-01 15:06:36 +0900 | [diff] [blame] | 54 | SIL_MMIO_BAR = 5, |
| 55 | |
Tejun Heo | e653a1e | 2006-03-05 16:03:52 +0900 | [diff] [blame] | 56 | /* |
| 57 | * host flags |
| 58 | */ |
Tejun Heo | 201ce85 | 2006-06-26 21:23:52 +0900 | [diff] [blame] | 59 | SIL_FLAG_NO_SATA_IRQ = (1 << 28), |
Tejun Heo | e4e10e3 | 2006-02-25 13:52:30 +0900 | [diff] [blame] | 60 | SIL_FLAG_RERR_ON_DMA_ACT = (1 << 29), |
Tejun Heo | e4deec6 | 2005-08-23 07:27:25 +0900 | [diff] [blame] | 61 | SIL_FLAG_MOD15WRITE = (1 << 30), |
Tejun Heo | 20888d8 | 2006-05-31 18:27:53 +0900 | [diff] [blame] | 62 | |
Sergei Shtylyov | 9cbe056 | 2011-02-04 22:05:48 +0300 | [diff] [blame] | 63 | SIL_DFL_PORT_FLAGS = ATA_FLAG_SATA, |
Tejun Heo | e4deec6 | 2005-08-23 07:27:25 +0900 | [diff] [blame] | 64 | |
Tejun Heo | e653a1e | 2006-03-05 16:03:52 +0900 | [diff] [blame] | 65 | /* |
| 66 | * Controller IDs |
| 67 | */ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 68 | sil_3112 = 0, |
Tejun Heo | 201ce85 | 2006-06-26 21:23:52 +0900 | [diff] [blame] | 69 | sil_3112_no_sata_irq = 1, |
| 70 | sil_3512 = 2, |
| 71 | sil_3114 = 3, |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 72 | |
Tejun Heo | e653a1e | 2006-03-05 16:03:52 +0900 | [diff] [blame] | 73 | /* |
| 74 | * Register offsets |
| 75 | */ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 76 | SIL_SYSCFG = 0x48, |
Tejun Heo | e653a1e | 2006-03-05 16:03:52 +0900 | [diff] [blame] | 77 | |
| 78 | /* |
| 79 | * Register bits |
| 80 | */ |
| 81 | /* SYSCFG */ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 82 | SIL_MASK_IDE0_INT = (1 << 22), |
| 83 | SIL_MASK_IDE1_INT = (1 << 23), |
| 84 | SIL_MASK_IDE2_INT = (1 << 24), |
| 85 | SIL_MASK_IDE3_INT = (1 << 25), |
| 86 | SIL_MASK_2PORT = SIL_MASK_IDE0_INT | SIL_MASK_IDE1_INT, |
| 87 | SIL_MASK_4PORT = SIL_MASK_2PORT | |
| 88 | SIL_MASK_IDE2_INT | SIL_MASK_IDE3_INT, |
| 89 | |
Tejun Heo | e653a1e | 2006-03-05 16:03:52 +0900 | [diff] [blame] | 90 | /* BMDMA/BMDMA2 */ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 91 | SIL_INTR_STEERING = (1 << 1), |
Tejun Heo | e653a1e | 2006-03-05 16:03:52 +0900 | [diff] [blame] | 92 | |
Tejun Heo | 20888d8 | 2006-05-31 18:27:53 +0900 | [diff] [blame] | 93 | SIL_DMA_ENABLE = (1 << 0), /* DMA run switch */ |
| 94 | SIL_DMA_RDWR = (1 << 3), /* DMA Rd-Wr */ |
| 95 | SIL_DMA_SATA_IRQ = (1 << 4), /* OR of all SATA IRQs */ |
| 96 | SIL_DMA_ACTIVE = (1 << 16), /* DMA running */ |
| 97 | SIL_DMA_ERROR = (1 << 17), /* PCI bus error */ |
| 98 | SIL_DMA_COMPLETE = (1 << 18), /* cmd complete / IRQ pending */ |
| 99 | SIL_DMA_N_SATA_IRQ = (1 << 6), /* SATA_IRQ for the next channel */ |
| 100 | SIL_DMA_N_ACTIVE = (1 << 24), /* ACTIVE for the next channel */ |
| 101 | SIL_DMA_N_ERROR = (1 << 25), /* ERROR for the next channel */ |
| 102 | SIL_DMA_N_COMPLETE = (1 << 26), /* COMPLETE for the next channel */ |
| 103 | |
| 104 | /* SIEN */ |
| 105 | SIL_SIEN_N = (1 << 16), /* triggered by SError.N */ |
| 106 | |
Tejun Heo | e653a1e | 2006-03-05 16:03:52 +0900 | [diff] [blame] | 107 | /* |
| 108 | * Others |
| 109 | */ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 110 | SIL_QUIRK_MOD15WRITE = (1 << 0), |
| 111 | SIL_QUIRK_UDMA5MAX = (1 << 1), |
| 112 | }; |
| 113 | |
Jeff Garzik | 5796d1c | 2007-10-26 00:03:37 -0400 | [diff] [blame] | 114 | static int sil_init_one(struct pci_dev *pdev, const struct pci_device_id *ent); |
Bartlomiej Zolnierkiewicz | 58eb8cd | 2014-05-07 17:17:44 +0200 | [diff] [blame] | 115 | #ifdef CONFIG_PM_SLEEP |
Tejun Heo | afb5a7c | 2006-07-03 16:07:27 +0900 | [diff] [blame] | 116 | static int sil_pci_device_resume(struct pci_dev *pdev); |
Alexey Dobriyan | 281d426 | 2006-08-14 22:49:30 -0700 | [diff] [blame] | 117 | #endif |
Alan | cd0d3bb | 2007-03-02 00:56:15 +0000 | [diff] [blame] | 118 | static void sil_dev_config(struct ata_device *dev); |
Tejun Heo | 82ef04f | 2008-07-31 17:02:40 +0900 | [diff] [blame] | 119 | static int sil_scr_read(struct ata_link *link, unsigned int sc_reg, u32 *val); |
| 120 | static int sil_scr_write(struct ata_link *link, unsigned int sc_reg, u32 val); |
Tejun Heo | 0260731 | 2007-08-06 18:36:23 +0900 | [diff] [blame] | 121 | static int sil_set_mode(struct ata_link *link, struct ata_device **r_failed); |
Robert Hancock | c7e324f | 2008-12-24 19:06:06 -0600 | [diff] [blame] | 122 | static void sil_qc_prep(struct ata_queued_cmd *qc); |
| 123 | static void sil_bmdma_setup(struct ata_queued_cmd *qc); |
| 124 | static void sil_bmdma_start(struct ata_queued_cmd *qc); |
| 125 | static void sil_bmdma_stop(struct ata_queued_cmd *qc); |
Tejun Heo | f6aae27 | 2006-05-15 20:58:27 +0900 | [diff] [blame] | 126 | static void sil_freeze(struct ata_port *ap); |
| 127 | static void sil_thaw(struct ata_port *ap); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 128 | |
Jeff Garzik | 374b187 | 2005-08-30 05:42:52 -0400 | [diff] [blame] | 129 | |
Jeff Garzik | 3b7d697 | 2005-11-10 11:04:11 -0500 | [diff] [blame] | 130 | static const struct pci_device_id sil_pci_tbl[] = { |
Jeff Garzik | 54bb3a94 | 2006-09-27 22:20:11 -0400 | [diff] [blame] | 131 | { PCI_VDEVICE(CMD, 0x3112), sil_3112 }, |
| 132 | { PCI_VDEVICE(CMD, 0x0240), sil_3112 }, |
| 133 | { PCI_VDEVICE(CMD, 0x3512), sil_3512 }, |
| 134 | { PCI_VDEVICE(CMD, 0x3114), sil_3114 }, |
| 135 | { PCI_VDEVICE(ATI, 0x436e), sil_3112 }, |
| 136 | { PCI_VDEVICE(ATI, 0x4379), sil_3112_no_sata_irq }, |
| 137 | { PCI_VDEVICE(ATI, 0x437a), sil_3112_no_sata_irq }, |
| 138 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 139 | { } /* terminate list */ |
| 140 | }; |
| 141 | |
| 142 | |
| 143 | /* TODO firmware versions should be added - eric */ |
| 144 | static const struct sil_drivelist { |
Jeff Garzik | 5796d1c | 2007-10-26 00:03:37 -0400 | [diff] [blame] | 145 | const char *product; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 146 | unsigned int quirk; |
| 147 | } sil_blacklist [] = { |
| 148 | { "ST320012AS", SIL_QUIRK_MOD15WRITE }, |
| 149 | { "ST330013AS", SIL_QUIRK_MOD15WRITE }, |
| 150 | { "ST340017AS", SIL_QUIRK_MOD15WRITE }, |
| 151 | { "ST360015AS", SIL_QUIRK_MOD15WRITE }, |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 152 | { "ST380023AS", SIL_QUIRK_MOD15WRITE }, |
| 153 | { "ST3120023AS", SIL_QUIRK_MOD15WRITE }, |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 154 | { "ST340014ASL", SIL_QUIRK_MOD15WRITE }, |
| 155 | { "ST360014ASL", SIL_QUIRK_MOD15WRITE }, |
| 156 | { "ST380011ASL", SIL_QUIRK_MOD15WRITE }, |
| 157 | { "ST3120022ASL", SIL_QUIRK_MOD15WRITE }, |
| 158 | { "ST3160021ASL", SIL_QUIRK_MOD15WRITE }, |
Tejun Heo | 9f9c47f | 2014-02-03 10:42:07 -0500 | [diff] [blame] | 159 | { "TOSHIBA MK2561GSYN", SIL_QUIRK_MOD15WRITE }, |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 160 | { "Maxtor 4D060H3", SIL_QUIRK_UDMA5MAX }, |
| 161 | { } |
| 162 | }; |
| 163 | |
| 164 | static struct pci_driver sil_pci_driver = { |
| 165 | .name = DRV_NAME, |
| 166 | .id_table = sil_pci_tbl, |
| 167 | .probe = sil_init_one, |
| 168 | .remove = ata_pci_remove_one, |
Bartlomiej Zolnierkiewicz | 58eb8cd | 2014-05-07 17:17:44 +0200 | [diff] [blame] | 169 | #ifdef CONFIG_PM_SLEEP |
Tejun Heo | afb5a7c | 2006-07-03 16:07:27 +0900 | [diff] [blame] | 170 | .suspend = ata_pci_device_suspend, |
| 171 | .resume = sil_pci_device_resume, |
Alexey Dobriyan | 281d426 | 2006-08-14 22:49:30 -0700 | [diff] [blame] | 172 | #endif |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 173 | }; |
| 174 | |
Jeff Garzik | 193515d | 2005-11-07 00:59:37 -0500 | [diff] [blame] | 175 | static struct scsi_host_template sil_sht = { |
Robert Hancock | c7e324f | 2008-12-24 19:06:06 -0600 | [diff] [blame] | 176 | ATA_BASE_SHT(DRV_NAME), |
| 177 | /** These controllers support Large Block Transfer which allows |
| 178 | transfer chunks up to 2GB and which cross 64KB boundaries, |
| 179 | therefore the DMA limits are more relaxed than standard ATA SFF. */ |
| 180 | .dma_boundary = SIL_DMA_BOUNDARY, |
| 181 | .sg_tablesize = ATA_MAX_PRD |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 182 | }; |
| 183 | |
Tejun Heo | 029cfd6 | 2008-03-25 12:22:49 +0900 | [diff] [blame] | 184 | static struct ata_port_operations sil_ops = { |
Robert Hancock | 31f8011 | 2009-04-13 22:57:28 -0600 | [diff] [blame] | 185 | .inherits = &ata_bmdma32_port_ops, |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 186 | .dev_config = sil_dev_config, |
Alan Cox | 9d2c7c7 | 2007-03-08 23:09:12 +0000 | [diff] [blame] | 187 | .set_mode = sil_set_mode, |
Robert Hancock | c7e324f | 2008-12-24 19:06:06 -0600 | [diff] [blame] | 188 | .bmdma_setup = sil_bmdma_setup, |
| 189 | .bmdma_start = sil_bmdma_start, |
| 190 | .bmdma_stop = sil_bmdma_stop, |
| 191 | .qc_prep = sil_qc_prep, |
Tejun Heo | f6aae27 | 2006-05-15 20:58:27 +0900 | [diff] [blame] | 192 | .freeze = sil_freeze, |
| 193 | .thaw = sil_thaw, |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 194 | .scr_read = sil_scr_read, |
| 195 | .scr_write = sil_scr_write, |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 196 | }; |
| 197 | |
Arjan van de Ven | 98ac62d | 2005-11-28 10:06:23 +0100 | [diff] [blame] | 198 | static const struct ata_port_info sil_port_info[] = { |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 199 | /* sil_3112 */ |
| 200 | { |
Jeff Garzik | cca3974 | 2006-08-24 03:19:22 -0400 | [diff] [blame] | 201 | .flags = SIL_DFL_PORT_FLAGS | SIL_FLAG_MOD15WRITE, |
Erik Inge Bolsø | 14bdef9 | 2009-03-14 21:38:24 +0100 | [diff] [blame] | 202 | .pio_mask = ATA_PIO4, |
| 203 | .mwdma_mask = ATA_MWDMA2, |
Jeff Garzik | bf6263a | 2007-07-09 12:16:50 -0400 | [diff] [blame] | 204 | .udma_mask = ATA_UDMA5, |
Tejun Heo | e4deec6 | 2005-08-23 07:27:25 +0900 | [diff] [blame] | 205 | .port_ops = &sil_ops, |
Tejun Heo | 0ee304d | 2006-02-25 13:52:30 +0900 | [diff] [blame] | 206 | }, |
Tejun Heo | 201ce85 | 2006-06-26 21:23:52 +0900 | [diff] [blame] | 207 | /* sil_3112_no_sata_irq */ |
| 208 | { |
Jeff Garzik | cca3974 | 2006-08-24 03:19:22 -0400 | [diff] [blame] | 209 | .flags = SIL_DFL_PORT_FLAGS | SIL_FLAG_MOD15WRITE | |
Tejun Heo | 201ce85 | 2006-06-26 21:23:52 +0900 | [diff] [blame] | 210 | SIL_FLAG_NO_SATA_IRQ, |
Erik Inge Bolsø | 14bdef9 | 2009-03-14 21:38:24 +0100 | [diff] [blame] | 211 | .pio_mask = ATA_PIO4, |
| 212 | .mwdma_mask = ATA_MWDMA2, |
Jeff Garzik | bf6263a | 2007-07-09 12:16:50 -0400 | [diff] [blame] | 213 | .udma_mask = ATA_UDMA5, |
Tejun Heo | 201ce85 | 2006-06-26 21:23:52 +0900 | [diff] [blame] | 214 | .port_ops = &sil_ops, |
| 215 | }, |
Tejun Heo | 0ee304d | 2006-02-25 13:52:30 +0900 | [diff] [blame] | 216 | /* sil_3512 */ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 217 | { |
Jeff Garzik | cca3974 | 2006-08-24 03:19:22 -0400 | [diff] [blame] | 218 | .flags = SIL_DFL_PORT_FLAGS | SIL_FLAG_RERR_ON_DMA_ACT, |
Erik Inge Bolsø | 14bdef9 | 2009-03-14 21:38:24 +0100 | [diff] [blame] | 219 | .pio_mask = ATA_PIO4, |
| 220 | .mwdma_mask = ATA_MWDMA2, |
Jeff Garzik | bf6263a | 2007-07-09 12:16:50 -0400 | [diff] [blame] | 221 | .udma_mask = ATA_UDMA5, |
Tejun Heo | 0ee304d | 2006-02-25 13:52:30 +0900 | [diff] [blame] | 222 | .port_ops = &sil_ops, |
| 223 | }, |
| 224 | /* sil_3114 */ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 225 | { |
Jeff Garzik | cca3974 | 2006-08-24 03:19:22 -0400 | [diff] [blame] | 226 | .flags = SIL_DFL_PORT_FLAGS | SIL_FLAG_RERR_ON_DMA_ACT, |
Erik Inge Bolsø | 14bdef9 | 2009-03-14 21:38:24 +0100 | [diff] [blame] | 227 | .pio_mask = ATA_PIO4, |
| 228 | .mwdma_mask = ATA_MWDMA2, |
Jeff Garzik | bf6263a | 2007-07-09 12:16:50 -0400 | [diff] [blame] | 229 | .udma_mask = ATA_UDMA5, |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 230 | .port_ops = &sil_ops, |
| 231 | }, |
| 232 | }; |
| 233 | |
| 234 | /* per-port register offsets */ |
| 235 | /* TODO: we can probably calculate rather than use a table */ |
| 236 | static const struct { |
| 237 | unsigned long tf; /* ATA taskfile register block */ |
| 238 | unsigned long ctl; /* ATA control/altstatus register block */ |
| 239 | unsigned long bmdma; /* DMA register block */ |
Tejun Heo | 20888d8 | 2006-05-31 18:27:53 +0900 | [diff] [blame] | 240 | unsigned long bmdma2; /* DMA register block #2 */ |
Tejun Heo | 48d4ef2 | 2006-03-05 16:03:52 +0900 | [diff] [blame] | 241 | unsigned long fifo_cfg; /* FIFO Valid Byte Count and Control */ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 242 | unsigned long scr; /* SATA control register block */ |
| 243 | unsigned long sien; /* SATA Interrupt Enable register */ |
| 244 | unsigned long xfer_mode;/* data transfer mode register */ |
Tejun Heo | e4e10e3 | 2006-02-25 13:52:30 +0900 | [diff] [blame] | 245 | unsigned long sfis_cfg; /* SATA FIS reception config register */ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 246 | } sil_port[] = { |
| 247 | /* port 0 ... */ |
Jeff Garzik | 5bcd7a00 | 2007-05-26 16:35:42 -0400 | [diff] [blame] | 248 | /* tf ctl bmdma bmdma2 fifo scr sien mode sfis */ |
| 249 | { 0x80, 0x8A, 0x0, 0x10, 0x40, 0x100, 0x148, 0xb4, 0x14c }, |
| 250 | { 0xC0, 0xCA, 0x8, 0x18, 0x44, 0x180, 0x1c8, 0xf4, 0x1cc }, |
Tejun Heo | 20888d8 | 2006-05-31 18:27:53 +0900 | [diff] [blame] | 251 | { 0x280, 0x28A, 0x200, 0x210, 0x240, 0x300, 0x348, 0x2b4, 0x34c }, |
| 252 | { 0x2C0, 0x2CA, 0x208, 0x218, 0x244, 0x380, 0x3c8, 0x2f4, 0x3cc }, |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 253 | /* ... port 3 */ |
| 254 | }; |
| 255 | |
| 256 | MODULE_AUTHOR("Jeff Garzik"); |
| 257 | MODULE_DESCRIPTION("low-level driver for Silicon Image SATA controller"); |
| 258 | MODULE_LICENSE("GPL"); |
| 259 | MODULE_DEVICE_TABLE(pci, sil_pci_tbl); |
| 260 | MODULE_VERSION(DRV_VERSION); |
| 261 | |
Jeff Garzik | 5796d1c | 2007-10-26 00:03:37 -0400 | [diff] [blame] | 262 | static int slow_down; |
Jeff Garzik | 51e9f2f | 2006-01-27 16:50:27 -0500 | [diff] [blame] | 263 | module_param(slow_down, int, 0444); |
| 264 | MODULE_PARM_DESC(slow_down, "Sledgehammer used to work around random problems, by limiting commands to 15 sectors (0=off, 1=on)"); |
| 265 | |
Jeff Garzik | 374b187 | 2005-08-30 05:42:52 -0400 | [diff] [blame] | 266 | |
Robert Hancock | c7e324f | 2008-12-24 19:06:06 -0600 | [diff] [blame] | 267 | static void sil_bmdma_stop(struct ata_queued_cmd *qc) |
| 268 | { |
| 269 | struct ata_port *ap = qc->ap; |
| 270 | void __iomem *mmio_base = ap->host->iomap[SIL_MMIO_BAR]; |
| 271 | void __iomem *bmdma2 = mmio_base + sil_port[ap->port_no].bmdma2; |
| 272 | |
| 273 | /* clear start/stop bit - can safely always write 0 */ |
| 274 | iowrite8(0, bmdma2); |
| 275 | |
| 276 | /* one-PIO-cycle guaranteed wait, per spec, for HDMA1:0 transition */ |
| 277 | ata_sff_dma_pause(ap); |
| 278 | } |
| 279 | |
| 280 | static void sil_bmdma_setup(struct ata_queued_cmd *qc) |
| 281 | { |
| 282 | struct ata_port *ap = qc->ap; |
| 283 | void __iomem *bmdma = ap->ioaddr.bmdma_addr; |
| 284 | |
| 285 | /* load PRD table addr. */ |
Tejun Heo | f60d701 | 2010-05-10 21:41:41 +0200 | [diff] [blame] | 286 | iowrite32(ap->bmdma_prd_dma, bmdma + ATA_DMA_TABLE_OFS); |
Robert Hancock | c7e324f | 2008-12-24 19:06:06 -0600 | [diff] [blame] | 287 | |
| 288 | /* issue r/w command */ |
| 289 | ap->ops->sff_exec_command(ap, &qc->tf); |
| 290 | } |
| 291 | |
| 292 | static void sil_bmdma_start(struct ata_queued_cmd *qc) |
| 293 | { |
| 294 | unsigned int rw = (qc->tf.flags & ATA_TFLAG_WRITE); |
| 295 | struct ata_port *ap = qc->ap; |
| 296 | void __iomem *mmio_base = ap->host->iomap[SIL_MMIO_BAR]; |
| 297 | void __iomem *bmdma2 = mmio_base + sil_port[ap->port_no].bmdma2; |
| 298 | u8 dmactl = ATA_DMA_START; |
| 299 | |
| 300 | /* set transfer direction, start host DMA transaction |
| 301 | Note: For Large Block Transfer to work, the DMA must be started |
| 302 | using the bmdma2 register. */ |
| 303 | if (!rw) |
| 304 | dmactl |= ATA_DMA_WR; |
| 305 | iowrite8(dmactl, bmdma2); |
| 306 | } |
| 307 | |
| 308 | /* The way God intended PCI IDE scatter/gather lists to look and behave... */ |
| 309 | static void sil_fill_sg(struct ata_queued_cmd *qc) |
| 310 | { |
| 311 | struct scatterlist *sg; |
| 312 | struct ata_port *ap = qc->ap; |
Tejun Heo | f60d701 | 2010-05-10 21:41:41 +0200 | [diff] [blame] | 313 | struct ata_bmdma_prd *prd, *last_prd = NULL; |
Robert Hancock | c7e324f | 2008-12-24 19:06:06 -0600 | [diff] [blame] | 314 | unsigned int si; |
| 315 | |
Tejun Heo | f60d701 | 2010-05-10 21:41:41 +0200 | [diff] [blame] | 316 | prd = &ap->bmdma_prd[0]; |
Robert Hancock | c7e324f | 2008-12-24 19:06:06 -0600 | [diff] [blame] | 317 | for_each_sg(qc->sg, sg, qc->n_elem, si) { |
| 318 | /* Note h/w doesn't support 64-bit, so we unconditionally |
| 319 | * truncate dma_addr_t to u32. |
| 320 | */ |
| 321 | u32 addr = (u32) sg_dma_address(sg); |
| 322 | u32 sg_len = sg_dma_len(sg); |
| 323 | |
| 324 | prd->addr = cpu_to_le32(addr); |
| 325 | prd->flags_len = cpu_to_le32(sg_len); |
Pasi Kärkkäinen | 41137aa | 2009-02-02 21:47:14 +0200 | [diff] [blame] | 326 | VPRINTK("PRD[%u] = (0x%X, 0x%X)\n", si, addr, sg_len); |
Robert Hancock | c7e324f | 2008-12-24 19:06:06 -0600 | [diff] [blame] | 327 | |
| 328 | last_prd = prd; |
| 329 | prd++; |
| 330 | } |
| 331 | |
| 332 | if (likely(last_prd)) |
| 333 | last_prd->flags_len |= cpu_to_le32(ATA_PRD_EOT); |
| 334 | } |
| 335 | |
| 336 | static void sil_qc_prep(struct ata_queued_cmd *qc) |
| 337 | { |
| 338 | if (!(qc->flags & ATA_QCFLAG_DMAMAP)) |
| 339 | return; |
| 340 | |
| 341 | sil_fill_sg(qc); |
| 342 | } |
| 343 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 344 | static unsigned char sil_get_device_cache_line(struct pci_dev *pdev) |
| 345 | { |
| 346 | u8 cache_line = 0; |
| 347 | pci_read_config_byte(pdev, PCI_CACHE_LINE_SIZE, &cache_line); |
| 348 | return cache_line; |
| 349 | } |
| 350 | |
Alan Cox | 9d2c7c7 | 2007-03-08 23:09:12 +0000 | [diff] [blame] | 351 | /** |
| 352 | * sil_set_mode - wrap set_mode functions |
Tejun Heo | 0260731 | 2007-08-06 18:36:23 +0900 | [diff] [blame] | 353 | * @link: link to set up |
Alan Cox | 9d2c7c7 | 2007-03-08 23:09:12 +0000 | [diff] [blame] | 354 | * @r_failed: returned device when we fail |
| 355 | * |
| 356 | * Wrap the libata method for device setup as after the setup we need |
| 357 | * to inspect the results and do some configuration work |
| 358 | */ |
| 359 | |
Tejun Heo | 0260731 | 2007-08-06 18:36:23 +0900 | [diff] [blame] | 360 | static int sil_set_mode(struct ata_link *link, struct ata_device **r_failed) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 361 | { |
Tejun Heo | 0260731 | 2007-08-06 18:36:23 +0900 | [diff] [blame] | 362 | struct ata_port *ap = link->ap; |
| 363 | void __iomem *mmio_base = ap->host->iomap[SIL_MMIO_BAR]; |
Tejun Heo | 0d5ff56 | 2007-02-01 15:06:36 +0900 | [diff] [blame] | 364 | void __iomem *addr = mmio_base + sil_port[ap->port_no].xfer_mode; |
Tejun Heo | 0260731 | 2007-08-06 18:36:23 +0900 | [diff] [blame] | 365 | struct ata_device *dev; |
Tejun Heo | f58229f | 2007-08-06 18:36:23 +0900 | [diff] [blame] | 366 | u32 tmp, dev_mode[2] = { }; |
Alan Cox | 9d2c7c7 | 2007-03-08 23:09:12 +0000 | [diff] [blame] | 367 | int rc; |
Jeff Garzik | a617c09 | 2007-05-21 20:14:23 -0400 | [diff] [blame] | 368 | |
Tejun Heo | 0260731 | 2007-08-06 18:36:23 +0900 | [diff] [blame] | 369 | rc = ata_do_set_mode(link, r_failed); |
Alan Cox | 9d2c7c7 | 2007-03-08 23:09:12 +0000 | [diff] [blame] | 370 | if (rc) |
| 371 | return rc; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 372 | |
Tejun Heo | 1eca436 | 2008-11-03 20:03:17 +0900 | [diff] [blame] | 373 | ata_for_each_dev(dev, link, ALL) { |
Tejun Heo | e1211e3 | 2006-04-01 01:38:18 +0900 | [diff] [blame] | 374 | if (!ata_dev_enabled(dev)) |
Tejun Heo | f58229f | 2007-08-06 18:36:23 +0900 | [diff] [blame] | 375 | dev_mode[dev->devno] = 0; /* PIO0/1/2 */ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 376 | else if (dev->flags & ATA_DFLAG_PIO) |
Tejun Heo | f58229f | 2007-08-06 18:36:23 +0900 | [diff] [blame] | 377 | dev_mode[dev->devno] = 1; /* PIO3/4 */ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 378 | else |
Tejun Heo | f58229f | 2007-08-06 18:36:23 +0900 | [diff] [blame] | 379 | dev_mode[dev->devno] = 3; /* UDMA */ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 380 | /* value 2 indicates MDMA */ |
| 381 | } |
| 382 | |
| 383 | tmp = readl(addr); |
| 384 | tmp &= ~((1<<5) | (1<<4) | (1<<1) | (1<<0)); |
| 385 | tmp |= dev_mode[0]; |
| 386 | tmp |= (dev_mode[1] << 4); |
| 387 | writel(tmp, addr); |
| 388 | readl(addr); /* flush */ |
Alan Cox | 9d2c7c7 | 2007-03-08 23:09:12 +0000 | [diff] [blame] | 389 | return 0; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 390 | } |
| 391 | |
Jeff Garzik | 5796d1c | 2007-10-26 00:03:37 -0400 | [diff] [blame] | 392 | static inline void __iomem *sil_scr_addr(struct ata_port *ap, |
| 393 | unsigned int sc_reg) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 394 | { |
Tejun Heo | 0d5ff56 | 2007-02-01 15:06:36 +0900 | [diff] [blame] | 395 | void __iomem *offset = ap->ioaddr.scr_addr; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 396 | |
| 397 | switch (sc_reg) { |
| 398 | case SCR_STATUS: |
| 399 | return offset + 4; |
| 400 | case SCR_ERROR: |
| 401 | return offset + 8; |
| 402 | case SCR_CONTROL: |
| 403 | return offset; |
| 404 | default: |
| 405 | /* do nothing */ |
| 406 | break; |
| 407 | } |
| 408 | |
Randy Dunlap | 8d9db2d | 2007-02-16 01:40:06 -0800 | [diff] [blame] | 409 | return NULL; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 410 | } |
| 411 | |
Tejun Heo | 82ef04f | 2008-07-31 17:02:40 +0900 | [diff] [blame] | 412 | static int sil_scr_read(struct ata_link *link, unsigned int sc_reg, u32 *val) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 413 | { |
Tejun Heo | 82ef04f | 2008-07-31 17:02:40 +0900 | [diff] [blame] | 414 | void __iomem *mmio = sil_scr_addr(link->ap, sc_reg); |
Tejun Heo | da3dbb1 | 2007-07-16 14:29:40 +0900 | [diff] [blame] | 415 | |
| 416 | if (mmio) { |
| 417 | *val = readl(mmio); |
| 418 | return 0; |
| 419 | } |
| 420 | return -EINVAL; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 421 | } |
| 422 | |
Tejun Heo | 82ef04f | 2008-07-31 17:02:40 +0900 | [diff] [blame] | 423 | static int sil_scr_write(struct ata_link *link, unsigned int sc_reg, u32 val) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 424 | { |
Tejun Heo | 82ef04f | 2008-07-31 17:02:40 +0900 | [diff] [blame] | 425 | void __iomem *mmio = sil_scr_addr(link->ap, sc_reg); |
Tejun Heo | da3dbb1 | 2007-07-16 14:29:40 +0900 | [diff] [blame] | 426 | |
| 427 | if (mmio) { |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 428 | writel(val, mmio); |
Tejun Heo | da3dbb1 | 2007-07-16 14:29:40 +0900 | [diff] [blame] | 429 | return 0; |
| 430 | } |
| 431 | return -EINVAL; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 432 | } |
| 433 | |
Tejun Heo | cbe88fb | 2006-05-31 18:27:55 +0900 | [diff] [blame] | 434 | static void sil_host_intr(struct ata_port *ap, u32 bmdma2) |
| 435 | { |
Tejun Heo | 9af5c9c | 2007-08-06 18:36:22 +0900 | [diff] [blame] | 436 | struct ata_eh_info *ehi = &ap->link.eh_info; |
| 437 | struct ata_queued_cmd *qc = ata_qc_from_tag(ap, ap->link.active_tag); |
Tejun Heo | cbe88fb | 2006-05-31 18:27:55 +0900 | [diff] [blame] | 438 | u8 status; |
| 439 | |
Tejun Heo | e573890 | 2006-05-31 18:28:16 +0900 | [diff] [blame] | 440 | if (unlikely(bmdma2 & SIL_DMA_SATA_IRQ)) { |
Jeff Garzik | ebd1699 | 2011-08-18 23:52:36 -0400 | [diff] [blame] | 441 | u32 serror = 0xffffffff; |
Tejun Heo | d4c8532 | 2006-06-12 18:45:55 +0900 | [diff] [blame] | 442 | |
| 443 | /* SIEN doesn't mask SATA IRQs on some 3112s. Those |
| 444 | * controllers continue to assert IRQ as long as |
| 445 | * SError bits are pending. Clear SError immediately. |
| 446 | */ |
Tejun Heo | 82ef04f | 2008-07-31 17:02:40 +0900 | [diff] [blame] | 447 | sil_scr_read(&ap->link, SCR_ERROR, &serror); |
| 448 | sil_scr_write(&ap->link, SCR_ERROR, serror); |
Tejun Heo | d4c8532 | 2006-06-12 18:45:55 +0900 | [diff] [blame] | 449 | |
Tejun Heo | 8cf32ac | 2007-12-08 08:45:27 +0900 | [diff] [blame] | 450 | /* Sometimes spurious interrupts occur, double check |
| 451 | * it's PHYRDY CHG. |
Tejun Heo | d4c8532 | 2006-06-12 18:45:55 +0900 | [diff] [blame] | 452 | */ |
Tejun Heo | 8cf32ac | 2007-12-08 08:45:27 +0900 | [diff] [blame] | 453 | if (serror & SERR_PHYRDY_CHG) { |
Tejun Heo | f7fe7ad | 2007-12-08 08:47:01 +0900 | [diff] [blame] | 454 | ap->link.eh_info.serror |= serror; |
Tejun Heo | 8cf32ac | 2007-12-08 08:45:27 +0900 | [diff] [blame] | 455 | goto freeze; |
Tejun Heo | d4c8532 | 2006-06-12 18:45:55 +0900 | [diff] [blame] | 456 | } |
| 457 | |
Tejun Heo | 8cf32ac | 2007-12-08 08:45:27 +0900 | [diff] [blame] | 458 | if (!(bmdma2 & SIL_DMA_COMPLETE)) |
| 459 | return; |
Tejun Heo | e573890 | 2006-05-31 18:28:16 +0900 | [diff] [blame] | 460 | } |
| 461 | |
Tejun Heo | 8cf32ac | 2007-12-08 08:45:27 +0900 | [diff] [blame] | 462 | if (unlikely(!qc || (qc->tf.flags & ATA_TFLAG_POLLING))) { |
Tejun Heo | e2f8fb7 | 2007-02-24 22:30:36 +0900 | [diff] [blame] | 463 | /* this sometimes happens, just clear IRQ */ |
Tejun Heo | 5682ed3 | 2008-04-07 22:47:16 +0900 | [diff] [blame] | 464 | ap->ops->sff_check_status(ap); |
Tejun Heo | e2f8fb7 | 2007-02-24 22:30:36 +0900 | [diff] [blame] | 465 | return; |
| 466 | } |
| 467 | |
Tejun Heo | cbe88fb | 2006-05-31 18:27:55 +0900 | [diff] [blame] | 468 | /* Check whether we are expecting interrupt in this state */ |
| 469 | switch (ap->hsm_task_state) { |
| 470 | case HSM_ST_FIRST: |
| 471 | /* Some pre-ATAPI-4 devices assert INTRQ |
| 472 | * at this state when ready to receive CDB. |
| 473 | */ |
| 474 | |
| 475 | /* Check the ATA_DFLAG_CDB_INTR flag is enough here. |
Tejun Heo | 405e66b | 2007-11-27 19:28:53 +0900 | [diff] [blame] | 476 | * The flag was turned on only for atapi devices. No |
| 477 | * need to check ata_is_atapi(qc->tf.protocol) again. |
Tejun Heo | cbe88fb | 2006-05-31 18:27:55 +0900 | [diff] [blame] | 478 | */ |
| 479 | if (!(qc->dev->flags & ATA_DFLAG_CDB_INTR)) |
| 480 | goto err_hsm; |
| 481 | break; |
| 482 | case HSM_ST_LAST: |
Tejun Heo | 405e66b | 2007-11-27 19:28:53 +0900 | [diff] [blame] | 483 | if (ata_is_dma(qc->tf.protocol)) { |
Tejun Heo | cbe88fb | 2006-05-31 18:27:55 +0900 | [diff] [blame] | 484 | /* clear DMA-Start bit */ |
| 485 | ap->ops->bmdma_stop(qc); |
| 486 | |
| 487 | if (bmdma2 & SIL_DMA_ERROR) { |
| 488 | qc->err_mask |= AC_ERR_HOST_BUS; |
| 489 | ap->hsm_task_state = HSM_ST_ERR; |
| 490 | } |
| 491 | } |
| 492 | break; |
| 493 | case HSM_ST: |
| 494 | break; |
| 495 | default: |
| 496 | goto err_hsm; |
| 497 | } |
| 498 | |
| 499 | /* check main status, clearing INTRQ */ |
Tejun Heo | 5682ed3 | 2008-04-07 22:47:16 +0900 | [diff] [blame] | 500 | status = ap->ops->sff_check_status(ap); |
Tejun Heo | cbe88fb | 2006-05-31 18:27:55 +0900 | [diff] [blame] | 501 | if (unlikely(status & ATA_BUSY)) |
| 502 | goto err_hsm; |
| 503 | |
| 504 | /* ack bmdma irq events */ |
Tejun Heo | 37f65b8 | 2010-05-19 22:10:20 +0200 | [diff] [blame] | 505 | ata_bmdma_irq_clear(ap); |
Tejun Heo | cbe88fb | 2006-05-31 18:27:55 +0900 | [diff] [blame] | 506 | |
| 507 | /* kick HSM in the ass */ |
Tejun Heo | 9363c38 | 2008-04-07 22:47:16 +0900 | [diff] [blame] | 508 | ata_sff_hsm_move(ap, qc, status, 0); |
Tejun Heo | cbe88fb | 2006-05-31 18:27:55 +0900 | [diff] [blame] | 509 | |
Tejun Heo | 405e66b | 2007-11-27 19:28:53 +0900 | [diff] [blame] | 510 | if (unlikely(qc->err_mask) && ata_is_dma(qc->tf.protocol)) |
Tejun Heo | ea54763 | 2006-11-17 12:06:21 +0900 | [diff] [blame] | 511 | ata_ehi_push_desc(ehi, "BMDMA2 stat 0x%x", bmdma2); |
| 512 | |
Tejun Heo | cbe88fb | 2006-05-31 18:27:55 +0900 | [diff] [blame] | 513 | return; |
| 514 | |
| 515 | err_hsm: |
| 516 | qc->err_mask |= AC_ERR_HSM; |
| 517 | freeze: |
| 518 | ata_port_freeze(ap); |
| 519 | } |
| 520 | |
David Howells | 7d12e78 | 2006-10-05 14:55:46 +0100 | [diff] [blame] | 521 | static irqreturn_t sil_interrupt(int irq, void *dev_instance) |
Tejun Heo | cbe88fb | 2006-05-31 18:27:55 +0900 | [diff] [blame] | 522 | { |
Jeff Garzik | cca3974 | 2006-08-24 03:19:22 -0400 | [diff] [blame] | 523 | struct ata_host *host = dev_instance; |
Tejun Heo | 0d5ff56 | 2007-02-01 15:06:36 +0900 | [diff] [blame] | 524 | void __iomem *mmio_base = host->iomap[SIL_MMIO_BAR]; |
Tejun Heo | cbe88fb | 2006-05-31 18:27:55 +0900 | [diff] [blame] | 525 | int handled = 0; |
| 526 | int i; |
| 527 | |
Jeff Garzik | cca3974 | 2006-08-24 03:19:22 -0400 | [diff] [blame] | 528 | spin_lock(&host->lock); |
Tejun Heo | cbe88fb | 2006-05-31 18:27:55 +0900 | [diff] [blame] | 529 | |
Jeff Garzik | cca3974 | 2006-08-24 03:19:22 -0400 | [diff] [blame] | 530 | for (i = 0; i < host->n_ports; i++) { |
| 531 | struct ata_port *ap = host->ports[i]; |
Tejun Heo | cbe88fb | 2006-05-31 18:27:55 +0900 | [diff] [blame] | 532 | u32 bmdma2 = readl(mmio_base + sil_port[ap->port_no].bmdma2); |
| 533 | |
Tejun Heo | 201ce85 | 2006-06-26 21:23:52 +0900 | [diff] [blame] | 534 | /* turn off SATA_IRQ if not supported */ |
| 535 | if (ap->flags & SIL_FLAG_NO_SATA_IRQ) |
| 536 | bmdma2 &= ~SIL_DMA_SATA_IRQ; |
| 537 | |
Tejun Heo | 23fa961 | 2006-06-12 14:18:51 +0900 | [diff] [blame] | 538 | if (bmdma2 == 0xffffffff || |
| 539 | !(bmdma2 & (SIL_DMA_COMPLETE | SIL_DMA_SATA_IRQ))) |
Tejun Heo | cbe88fb | 2006-05-31 18:27:55 +0900 | [diff] [blame] | 540 | continue; |
| 541 | |
| 542 | sil_host_intr(ap, bmdma2); |
| 543 | handled = 1; |
| 544 | } |
| 545 | |
Jeff Garzik | cca3974 | 2006-08-24 03:19:22 -0400 | [diff] [blame] | 546 | spin_unlock(&host->lock); |
Tejun Heo | cbe88fb | 2006-05-31 18:27:55 +0900 | [diff] [blame] | 547 | |
| 548 | return IRQ_RETVAL(handled); |
| 549 | } |
| 550 | |
Tejun Heo | f6aae27 | 2006-05-15 20:58:27 +0900 | [diff] [blame] | 551 | static void sil_freeze(struct ata_port *ap) |
| 552 | { |
Tejun Heo | 0d5ff56 | 2007-02-01 15:06:36 +0900 | [diff] [blame] | 553 | void __iomem *mmio_base = ap->host->iomap[SIL_MMIO_BAR]; |
Tejun Heo | f6aae27 | 2006-05-15 20:58:27 +0900 | [diff] [blame] | 554 | u32 tmp; |
| 555 | |
Tejun Heo | e573890 | 2006-05-31 18:28:16 +0900 | [diff] [blame] | 556 | /* global IRQ mask doesn't block SATA IRQ, turn off explicitly */ |
| 557 | writel(0, mmio_base + sil_port[ap->port_no].sien); |
| 558 | |
Tejun Heo | f6aae27 | 2006-05-15 20:58:27 +0900 | [diff] [blame] | 559 | /* plug IRQ */ |
| 560 | tmp = readl(mmio_base + SIL_SYSCFG); |
| 561 | tmp |= SIL_MASK_IDE0_INT << ap->port_no; |
| 562 | writel(tmp, mmio_base + SIL_SYSCFG); |
| 563 | readl(mmio_base + SIL_SYSCFG); /* flush */ |
Jeff Garzik | 2fc37ad | 2009-04-07 19:18:32 -0400 | [diff] [blame] | 564 | |
| 565 | /* Ensure DMA_ENABLE is off. |
| 566 | * |
| 567 | * This is because the controller will not give us access to the |
| 568 | * taskfile registers while a DMA is in progress |
| 569 | */ |
| 570 | iowrite8(ioread8(ap->ioaddr.bmdma_addr) & ~SIL_DMA_ENABLE, |
| 571 | ap->ioaddr.bmdma_addr); |
| 572 | |
| 573 | /* According to ata_bmdma_stop, an HDMA transition requires |
| 574 | * on PIO cycle. But we can't read a taskfile register. |
| 575 | */ |
| 576 | ioread8(ap->ioaddr.bmdma_addr); |
Tejun Heo | f6aae27 | 2006-05-15 20:58:27 +0900 | [diff] [blame] | 577 | } |
| 578 | |
| 579 | static void sil_thaw(struct ata_port *ap) |
| 580 | { |
Tejun Heo | 0d5ff56 | 2007-02-01 15:06:36 +0900 | [diff] [blame] | 581 | void __iomem *mmio_base = ap->host->iomap[SIL_MMIO_BAR]; |
Tejun Heo | f6aae27 | 2006-05-15 20:58:27 +0900 | [diff] [blame] | 582 | u32 tmp; |
| 583 | |
| 584 | /* clear IRQ */ |
Tejun Heo | 5682ed3 | 2008-04-07 22:47:16 +0900 | [diff] [blame] | 585 | ap->ops->sff_check_status(ap); |
Tejun Heo | 37f65b8 | 2010-05-19 22:10:20 +0200 | [diff] [blame] | 586 | ata_bmdma_irq_clear(ap); |
Tejun Heo | f6aae27 | 2006-05-15 20:58:27 +0900 | [diff] [blame] | 587 | |
Tejun Heo | 201ce85 | 2006-06-26 21:23:52 +0900 | [diff] [blame] | 588 | /* turn on SATA IRQ if supported */ |
| 589 | if (!(ap->flags & SIL_FLAG_NO_SATA_IRQ)) |
| 590 | writel(SIL_SIEN_N, mmio_base + sil_port[ap->port_no].sien); |
Tejun Heo | e573890 | 2006-05-31 18:28:16 +0900 | [diff] [blame] | 591 | |
Tejun Heo | f6aae27 | 2006-05-15 20:58:27 +0900 | [diff] [blame] | 592 | /* turn on IRQ */ |
| 593 | tmp = readl(mmio_base + SIL_SYSCFG); |
| 594 | tmp &= ~(SIL_MASK_IDE0_INT << ap->port_no); |
| 595 | writel(tmp, mmio_base + SIL_SYSCFG); |
| 596 | } |
| 597 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 598 | /** |
| 599 | * sil_dev_config - Apply device/host-specific errata fixups |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 600 | * @dev: Device to be examined |
| 601 | * |
| 602 | * After the IDENTIFY [PACKET] DEVICE step is complete, and a |
| 603 | * device is known to be present, this function is called. |
| 604 | * We apply two errata fixups which are specific to Silicon Image, |
| 605 | * a Seagate and a Maxtor fixup. |
| 606 | * |
| 607 | * For certain Seagate devices, we must limit the maximum sectors |
| 608 | * to under 8K. |
| 609 | * |
| 610 | * For certain Maxtor devices, we must not program the drive |
| 611 | * beyond udma5. |
| 612 | * |
| 613 | * Both fixups are unfairly pessimistic. As soon as I get more |
| 614 | * information on these errata, I will create a more exhaustive |
| 615 | * list, and apply the fixups to only the specific |
| 616 | * devices/hosts/firmwares that need it. |
| 617 | * |
| 618 | * 20040111 - Seagate drives affected by the Mod15Write bug are blacklisted |
| 619 | * The Maxtor quirk is in the blacklist, but I'm keeping the original |
| 620 | * pessimistic fix for the following reasons... |
| 621 | * - There seems to be less info on it, only one device gleaned off the |
| 622 | * Windows driver, maybe only one is affected. More info would be greatly |
| 623 | * appreciated. |
| 624 | * - But then again UDMA5 is hardly anything to complain about |
| 625 | */ |
Alan | cd0d3bb | 2007-03-02 00:56:15 +0000 | [diff] [blame] | 626 | static void sil_dev_config(struct ata_device *dev) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 627 | { |
Tejun Heo | 9af5c9c | 2007-08-06 18:36:22 +0900 | [diff] [blame] | 628 | struct ata_port *ap = dev->link->ap; |
| 629 | int print_info = ap->link.eh_context.i.flags & ATA_EHI_PRINTINFO; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 630 | unsigned int n, quirks = 0; |
Tejun Heo | a0cf733 | 2007-01-02 20:18:49 +0900 | [diff] [blame] | 631 | unsigned char model_num[ATA_ID_PROD_LEN + 1]; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 632 | |
Tejun Heo | a0cf733 | 2007-01-02 20:18:49 +0900 | [diff] [blame] | 633 | ata_id_c_string(dev->id, model_num, ATA_ID_PROD, sizeof(model_num)); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 634 | |
Jeff Garzik | 8a60a07 | 2005-07-31 13:13:24 -0400 | [diff] [blame] | 635 | for (n = 0; sil_blacklist[n].product; n++) |
Tejun Heo | 2e02671 | 2006-02-12 22:47:04 +0900 | [diff] [blame] | 636 | if (!strcmp(sil_blacklist[n].product, model_num)) { |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 637 | quirks = sil_blacklist[n].quirk; |
| 638 | break; |
| 639 | } |
Jeff Garzik | 8a60a07 | 2005-07-31 13:13:24 -0400 | [diff] [blame] | 640 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 641 | /* limit requests to 15 sectors */ |
Jeff Garzik | 51e9f2f | 2006-01-27 16:50:27 -0500 | [diff] [blame] | 642 | if (slow_down || |
| 643 | ((ap->flags & SIL_FLAG_MOD15WRITE) && |
| 644 | (quirks & SIL_QUIRK_MOD15WRITE))) { |
Tejun Heo | efdaedc | 2006-11-01 18:38:52 +0900 | [diff] [blame] | 645 | if (print_info) |
Joe Perches | a9a79df | 2011-04-15 15:51:59 -0700 | [diff] [blame] | 646 | ata_dev_info(dev, |
| 647 | "applying Seagate errata fix (mod15write workaround)\n"); |
Tejun Heo | b00eec1 | 2006-02-12 23:32:59 +0900 | [diff] [blame] | 648 | dev->max_sectors = 15; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 649 | return; |
| 650 | } |
| 651 | |
| 652 | /* limit to udma5 */ |
| 653 | if (quirks & SIL_QUIRK_UDMA5MAX) { |
Tejun Heo | efdaedc | 2006-11-01 18:38:52 +0900 | [diff] [blame] | 654 | if (print_info) |
Joe Perches | a9a79df | 2011-04-15 15:51:59 -0700 | [diff] [blame] | 655 | ata_dev_info(dev, "applying Maxtor errata fix %s\n", |
| 656 | model_num); |
Tejun Heo | 5a52913 | 2006-03-24 14:07:50 +0900 | [diff] [blame] | 657 | dev->udma_mask &= ATA_UDMA5; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 658 | return; |
| 659 | } |
| 660 | } |
| 661 | |
Tejun Heo | 4447d35 | 2007-04-17 23:44:08 +0900 | [diff] [blame] | 662 | static void sil_init_controller(struct ata_host *host) |
Tejun Heo | 3d8ec91 | 2006-07-03 16:07:27 +0900 | [diff] [blame] | 663 | { |
Tejun Heo | 4447d35 | 2007-04-17 23:44:08 +0900 | [diff] [blame] | 664 | struct pci_dev *pdev = to_pci_dev(host->dev); |
| 665 | void __iomem *mmio_base = host->iomap[SIL_MMIO_BAR]; |
Tejun Heo | 3d8ec91 | 2006-07-03 16:07:27 +0900 | [diff] [blame] | 666 | u8 cls; |
| 667 | u32 tmp; |
| 668 | int i; |
| 669 | |
| 670 | /* Initialize FIFO PCI bus arbitration */ |
| 671 | cls = sil_get_device_cache_line(pdev); |
| 672 | if (cls) { |
| 673 | cls >>= 3; |
| 674 | cls++; /* cls = (line_size/8)+1 */ |
Tejun Heo | 4447d35 | 2007-04-17 23:44:08 +0900 | [diff] [blame] | 675 | for (i = 0; i < host->n_ports; i++) |
Tejun Heo | 3d8ec91 | 2006-07-03 16:07:27 +0900 | [diff] [blame] | 676 | writew(cls << 8 | cls, |
| 677 | mmio_base + sil_port[i].fifo_cfg); |
| 678 | } else |
Joe Perches | a44fec1 | 2011-04-15 15:51:58 -0700 | [diff] [blame] | 679 | dev_warn(&pdev->dev, |
| 680 | "cache line size not set. Driver may not function\n"); |
Tejun Heo | 3d8ec91 | 2006-07-03 16:07:27 +0900 | [diff] [blame] | 681 | |
| 682 | /* Apply R_ERR on DMA activate FIS errata workaround */ |
Tejun Heo | 4447d35 | 2007-04-17 23:44:08 +0900 | [diff] [blame] | 683 | if (host->ports[0]->flags & SIL_FLAG_RERR_ON_DMA_ACT) { |
Tejun Heo | 3d8ec91 | 2006-07-03 16:07:27 +0900 | [diff] [blame] | 684 | int cnt; |
| 685 | |
Tejun Heo | 4447d35 | 2007-04-17 23:44:08 +0900 | [diff] [blame] | 686 | for (i = 0, cnt = 0; i < host->n_ports; i++) { |
Tejun Heo | 3d8ec91 | 2006-07-03 16:07:27 +0900 | [diff] [blame] | 687 | tmp = readl(mmio_base + sil_port[i].sfis_cfg); |
| 688 | if ((tmp & 0x3) != 0x01) |
| 689 | continue; |
| 690 | if (!cnt) |
Joe Perches | a44fec1 | 2011-04-15 15:51:58 -0700 | [diff] [blame] | 691 | dev_info(&pdev->dev, |
| 692 | "Applying R_ERR on DMA activate FIS errata fix\n"); |
Tejun Heo | 3d8ec91 | 2006-07-03 16:07:27 +0900 | [diff] [blame] | 693 | writel(tmp & ~0x3, mmio_base + sil_port[i].sfis_cfg); |
| 694 | cnt++; |
| 695 | } |
| 696 | } |
| 697 | |
Tejun Heo | 4447d35 | 2007-04-17 23:44:08 +0900 | [diff] [blame] | 698 | if (host->n_ports == 4) { |
Tejun Heo | 3d8ec91 | 2006-07-03 16:07:27 +0900 | [diff] [blame] | 699 | /* flip the magic "make 4 ports work" bit */ |
| 700 | tmp = readl(mmio_base + sil_port[2].bmdma); |
| 701 | if ((tmp & SIL_INTR_STEERING) == 0) |
| 702 | writel(tmp | SIL_INTR_STEERING, |
| 703 | mmio_base + sil_port[2].bmdma); |
| 704 | } |
| 705 | } |
| 706 | |
Rafael J. Wysocki | e57db7b | 2009-01-19 20:58:29 +0100 | [diff] [blame] | 707 | static bool sil_broken_system_poweroff(struct pci_dev *pdev) |
| 708 | { |
| 709 | static const struct dmi_system_id broken_systems[] = { |
| 710 | { |
| 711 | .ident = "HP Compaq nx6325", |
| 712 | .matches = { |
| 713 | DMI_MATCH(DMI_SYS_VENDOR, "Hewlett-Packard"), |
| 714 | DMI_MATCH(DMI_PRODUCT_NAME, "HP Compaq nx6325"), |
| 715 | }, |
| 716 | /* PCI slot number of the controller */ |
| 717 | .driver_data = (void *)0x12UL, |
| 718 | }, |
| 719 | |
| 720 | { } /* terminate list */ |
| 721 | }; |
| 722 | const struct dmi_system_id *dmi = dmi_first_match(broken_systems); |
| 723 | |
| 724 | if (dmi) { |
| 725 | unsigned long slot = (unsigned long)dmi->driver_data; |
| 726 | /* apply the quirk only to on-board controllers */ |
| 727 | return slot == PCI_SLOT(pdev->devfn); |
| 728 | } |
| 729 | |
| 730 | return false; |
| 731 | } |
| 732 | |
Jeff Garzik | 5796d1c | 2007-10-26 00:03:37 -0400 | [diff] [blame] | 733 | static int sil_init_one(struct pci_dev *pdev, const struct pci_device_id *ent) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 734 | { |
Tejun Heo | 4447d35 | 2007-04-17 23:44:08 +0900 | [diff] [blame] | 735 | int board_id = ent->driver_data; |
Rafael J. Wysocki | e57db7b | 2009-01-19 20:58:29 +0100 | [diff] [blame] | 736 | struct ata_port_info pi = sil_port_info[board_id]; |
| 737 | const struct ata_port_info *ppi[] = { &pi, NULL }; |
Tejun Heo | 4447d35 | 2007-04-17 23:44:08 +0900 | [diff] [blame] | 738 | struct ata_host *host; |
Jeff Garzik | ea6ba10 | 2005-08-30 05:18:18 -0400 | [diff] [blame] | 739 | void __iomem *mmio_base; |
Tejun Heo | 4447d35 | 2007-04-17 23:44:08 +0900 | [diff] [blame] | 740 | int n_ports, rc; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 741 | unsigned int i; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 742 | |
Joe Perches | 06296a1 | 2011-04-15 15:52:00 -0700 | [diff] [blame] | 743 | ata_print_version_once(&pdev->dev, DRV_VERSION); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 744 | |
Tejun Heo | 4447d35 | 2007-04-17 23:44:08 +0900 | [diff] [blame] | 745 | /* allocate host */ |
| 746 | n_ports = 2; |
| 747 | if (board_id == sil_3114) |
| 748 | n_ports = 4; |
| 749 | |
Rafael J. Wysocki | e57db7b | 2009-01-19 20:58:29 +0100 | [diff] [blame] | 750 | if (sil_broken_system_poweroff(pdev)) { |
| 751 | pi.flags |= ATA_FLAG_NO_POWEROFF_SPINDOWN | |
| 752 | ATA_FLAG_NO_HIBERNATE_SPINDOWN; |
| 753 | dev_info(&pdev->dev, "quirky BIOS, skipping spindown " |
| 754 | "on poweroff and hibernation\n"); |
| 755 | } |
| 756 | |
Tejun Heo | 4447d35 | 2007-04-17 23:44:08 +0900 | [diff] [blame] | 757 | host = ata_host_alloc_pinfo(&pdev->dev, ppi, n_ports); |
| 758 | if (!host) |
| 759 | return -ENOMEM; |
| 760 | |
| 761 | /* acquire resources and fill host */ |
Tejun Heo | 24dc5f3 | 2007-01-20 16:00:28 +0900 | [diff] [blame] | 762 | rc = pcim_enable_device(pdev); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 763 | if (rc) |
| 764 | return rc; |
| 765 | |
Tejun Heo | 0d5ff56 | 2007-02-01 15:06:36 +0900 | [diff] [blame] | 766 | rc = pcim_iomap_regions(pdev, 1 << SIL_MMIO_BAR, DRV_NAME); |
| 767 | if (rc == -EBUSY) |
Tejun Heo | 24dc5f3 | 2007-01-20 16:00:28 +0900 | [diff] [blame] | 768 | pcim_pin_device(pdev); |
Tejun Heo | 0d5ff56 | 2007-02-01 15:06:36 +0900 | [diff] [blame] | 769 | if (rc) |
Tejun Heo | 24dc5f3 | 2007-01-20 16:00:28 +0900 | [diff] [blame] | 770 | return rc; |
Tejun Heo | 4447d35 | 2007-04-17 23:44:08 +0900 | [diff] [blame] | 771 | host->iomap = pcim_iomap_table(pdev); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 772 | |
Quentin Lambert | c54c719 | 2015-04-08 14:34:10 +0200 | [diff] [blame] | 773 | rc = dma_set_mask(&pdev->dev, ATA_DMA_MASK); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 774 | if (rc) |
Tejun Heo | 24dc5f3 | 2007-01-20 16:00:28 +0900 | [diff] [blame] | 775 | return rc; |
Quentin Lambert | c54c719 | 2015-04-08 14:34:10 +0200 | [diff] [blame] | 776 | rc = dma_set_coherent_mask(&pdev->dev, ATA_DMA_MASK); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 777 | if (rc) |
Tejun Heo | 24dc5f3 | 2007-01-20 16:00:28 +0900 | [diff] [blame] | 778 | return rc; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 779 | |
Tejun Heo | 4447d35 | 2007-04-17 23:44:08 +0900 | [diff] [blame] | 780 | mmio_base = host->iomap[SIL_MMIO_BAR]; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 781 | |
Tejun Heo | 4447d35 | 2007-04-17 23:44:08 +0900 | [diff] [blame] | 782 | for (i = 0; i < host->n_ports; i++) { |
Tejun Heo | cbcdd87 | 2007-08-18 13:14:55 +0900 | [diff] [blame] | 783 | struct ata_port *ap = host->ports[i]; |
| 784 | struct ata_ioports *ioaddr = &ap->ioaddr; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 785 | |
Tejun Heo | 4447d35 | 2007-04-17 23:44:08 +0900 | [diff] [blame] | 786 | ioaddr->cmd_addr = mmio_base + sil_port[i].tf; |
| 787 | ioaddr->altstatus_addr = |
| 788 | ioaddr->ctl_addr = mmio_base + sil_port[i].ctl; |
| 789 | ioaddr->bmdma_addr = mmio_base + sil_port[i].bmdma; |
| 790 | ioaddr->scr_addr = mmio_base + sil_port[i].scr; |
Tejun Heo | 9363c38 | 2008-04-07 22:47:16 +0900 | [diff] [blame] | 791 | ata_sff_std_ports(ioaddr); |
Tejun Heo | cbcdd87 | 2007-08-18 13:14:55 +0900 | [diff] [blame] | 792 | |
| 793 | ata_port_pbar_desc(ap, SIL_MMIO_BAR, -1, "mmio"); |
| 794 | ata_port_pbar_desc(ap, SIL_MMIO_BAR, sil_port[i].tf, "tf"); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 795 | } |
| 796 | |
Tejun Heo | 4447d35 | 2007-04-17 23:44:08 +0900 | [diff] [blame] | 797 | /* initialize and activate */ |
| 798 | sil_init_controller(host); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 799 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 800 | pci_set_master(pdev); |
Tejun Heo | 4447d35 | 2007-04-17 23:44:08 +0900 | [diff] [blame] | 801 | return ata_host_activate(host, pdev->irq, sil_interrupt, IRQF_SHARED, |
| 802 | &sil_sht); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 803 | } |
| 804 | |
Bartlomiej Zolnierkiewicz | 58eb8cd | 2014-05-07 17:17:44 +0200 | [diff] [blame] | 805 | #ifdef CONFIG_PM_SLEEP |
Tejun Heo | afb5a7c | 2006-07-03 16:07:27 +0900 | [diff] [blame] | 806 | static int sil_pci_device_resume(struct pci_dev *pdev) |
| 807 | { |
Jingoo Han | 0a86e1c | 2013-06-03 14:05:36 +0900 | [diff] [blame] | 808 | struct ata_host *host = pci_get_drvdata(pdev); |
Tejun Heo | 553c4aa | 2006-12-26 19:39:50 +0900 | [diff] [blame] | 809 | int rc; |
Tejun Heo | afb5a7c | 2006-07-03 16:07:27 +0900 | [diff] [blame] | 810 | |
Tejun Heo | 553c4aa | 2006-12-26 19:39:50 +0900 | [diff] [blame] | 811 | rc = ata_pci_device_do_resume(pdev); |
| 812 | if (rc) |
| 813 | return rc; |
| 814 | |
Tejun Heo | 4447d35 | 2007-04-17 23:44:08 +0900 | [diff] [blame] | 815 | sil_init_controller(host); |
Jeff Garzik | cca3974 | 2006-08-24 03:19:22 -0400 | [diff] [blame] | 816 | ata_host_resume(host); |
Tejun Heo | afb5a7c | 2006-07-03 16:07:27 +0900 | [diff] [blame] | 817 | |
| 818 | return 0; |
| 819 | } |
Alexey Dobriyan | 281d426 | 2006-08-14 22:49:30 -0700 | [diff] [blame] | 820 | #endif |
Tejun Heo | afb5a7c | 2006-07-03 16:07:27 +0900 | [diff] [blame] | 821 | |
Axel Lin | 2fc75da | 2012-04-19 13:43:05 +0800 | [diff] [blame] | 822 | module_pci_driver(sil_pci_driver); |