kfifo: fix Error/broken kernel-doc notation
[linux-2.6/linux-acpi-2.6/ibm-acpi-2.6.git] / drivers / ata / pata_cmd640.c
blob5acf9fa9b39f04a69c5552ef56d397e8bc7eefaa
1 /*
2 * pata_cmd640.c - CMD640 PCI PATA for new ATA layer
3 * (C) 2007 Red Hat Inc
5 * Based upon
6 * linux/drivers/ide/pci/cmd640.c Version 1.02 Sep 01, 1996
8 * Copyright (C) 1995-1996 Linus Torvalds & authors (see driver)
10 * This drives only the PCI version of the controller. If you have a
11 * VLB one then we have enough docs to support it but you can write
12 * your own code.
15 #include <linux/kernel.h>
16 #include <linux/module.h>
17 #include <linux/pci.h>
18 #include <linux/init.h>
19 #include <linux/blkdev.h>
20 #include <linux/delay.h>
21 #include <scsi/scsi_host.h>
22 #include <linux/libata.h>
24 #define DRV_NAME "pata_cmd640"
25 #define DRV_VERSION "0.0.5"
27 struct cmd640_reg {
28 int last;
29 u8 reg58[ATA_MAX_DEVICES];
32 enum {
33 CFR = 0x50,
34 CNTRL = 0x51,
35 CMDTIM = 0x52,
36 ARTIM0 = 0x53,
37 DRWTIM0 = 0x54,
38 ARTIM23 = 0x57,
39 DRWTIM23 = 0x58,
40 BRST = 0x59
43 /**
44 * cmd640_set_piomode - set initial PIO mode data
45 * @ap: ATA port
46 * @adev: ATA device
48 * Called to do the PIO mode setup.
51 static void cmd640_set_piomode(struct ata_port *ap, struct ata_device *adev)
53 struct cmd640_reg *timing = ap->private_data;
54 struct pci_dev *pdev = to_pci_dev(ap->host->dev);
55 struct ata_timing t;
56 const unsigned long T = 1000000 / 33;
57 const u8 setup_data[] = { 0x40, 0x40, 0x40, 0x80, 0x00 };
58 u8 reg;
59 int arttim = ARTIM0 + 2 * adev->devno;
60 struct ata_device *pair = ata_dev_pair(adev);
62 if (ata_timing_compute(adev, adev->pio_mode, &t, T, 0) < 0) {
63 printk(KERN_ERR DRV_NAME ": mode computation failed.\n");
64 return;
67 /* The second channel has shared timings and the setup timing is
68 messy to switch to merge it for worst case */
69 if (ap->port_no && pair) {
70 struct ata_timing p;
71 ata_timing_compute(pair, pair->pio_mode, &p, T, 1);
72 ata_timing_merge(&p, &t, &t, ATA_TIMING_SETUP);
75 /* Make the timings fit */
76 if (t.recover > 16) {
77 t.active += t.recover - 16;
78 t.recover = 16;
80 if (t.active > 16)
81 t.active = 16;
83 /* Now convert the clocks into values we can actually stuff into
84 the chip */
86 if (t.recover > 1)
87 t.recover--; /* 640B only */
88 else
89 t.recover = 15;
91 if (t.setup > 4)
92 t.setup = 0xC0;
93 else
94 t.setup = setup_data[t.setup];
96 if (ap->port_no == 0) {
97 t.active &= 0x0F; /* 0 = 16 */
99 /* Load setup timing */
100 pci_read_config_byte(pdev, arttim, &reg);
101 reg &= 0x3F;
102 reg |= t.setup;
103 pci_write_config_byte(pdev, arttim, reg);
105 /* Load active/recovery */
106 pci_write_config_byte(pdev, arttim + 1, (t.active << 4) | t.recover);
107 } else {
108 /* Save the shared timings for channel, they will be loaded
109 by qc_issue. Reloading the setup time is expensive so we
110 keep a merged one loaded */
111 pci_read_config_byte(pdev, ARTIM23, &reg);
112 reg &= 0x3F;
113 reg |= t.setup;
114 pci_write_config_byte(pdev, ARTIM23, reg);
115 timing->reg58[adev->devno] = (t.active << 4) | t.recover;
121 * cmd640_qc_issue - command preparation hook
122 * @qc: Command to be issued
124 * Channel 1 has shared timings. We must reprogram the
125 * clock each drive 2/3 switch we do.
128 static unsigned int cmd640_qc_issue(struct ata_queued_cmd *qc)
130 struct ata_port *ap = qc->ap;
131 struct ata_device *adev = qc->dev;
132 struct pci_dev *pdev = to_pci_dev(ap->host->dev);
133 struct cmd640_reg *timing = ap->private_data;
135 if (ap->port_no != 0 && adev->devno != timing->last) {
136 pci_write_config_byte(pdev, DRWTIM23, timing->reg58[adev->devno]);
137 timing->last = adev->devno;
139 return ata_sff_qc_issue(qc);
143 * cmd640_port_start - port setup
144 * @ap: ATA port being set up
146 * The CMD640 needs to maintain private data structures so we
147 * allocate space here.
150 static int cmd640_port_start(struct ata_port *ap)
152 struct pci_dev *pdev = to_pci_dev(ap->host->dev);
153 struct cmd640_reg *timing;
155 int ret = ata_sff_port_start(ap);
156 if (ret < 0)
157 return ret;
159 timing = devm_kzalloc(&pdev->dev, sizeof(struct cmd640_reg), GFP_KERNEL);
160 if (timing == NULL)
161 return -ENOMEM;
162 timing->last = -1; /* Force a load */
163 ap->private_data = timing;
164 return ret;
167 static struct scsi_host_template cmd640_sht = {
168 ATA_BMDMA_SHT(DRV_NAME),
171 static struct ata_port_operations cmd640_port_ops = {
172 .inherits = &ata_bmdma_port_ops,
173 /* In theory xfer_noirq is not needed once we kill the prefetcher */
174 .sff_data_xfer = ata_sff_data_xfer_noirq,
175 .qc_issue = cmd640_qc_issue,
176 .cable_detect = ata_cable_40wire,
177 .set_piomode = cmd640_set_piomode,
178 .port_start = cmd640_port_start,
181 static void cmd640_hardware_init(struct pci_dev *pdev)
183 u8 r;
184 u8 ctrl;
186 /* CMD640 detected, commiserations */
187 pci_write_config_byte(pdev, 0x5B, 0x00);
188 /* Get version info */
189 pci_read_config_byte(pdev, CFR, &r);
190 /* PIO0 command cycles */
191 pci_write_config_byte(pdev, CMDTIM, 0);
192 /* 512 byte bursts (sector) */
193 pci_write_config_byte(pdev, BRST, 0x40);
195 * A reporter a long time ago
196 * Had problems with the data fifo
197 * So don't run the risk
198 * Of putting crap on the disk
199 * For its better just to go slow
201 /* Do channel 0 */
202 pci_read_config_byte(pdev, CNTRL, &ctrl);
203 pci_write_config_byte(pdev, CNTRL, ctrl | 0xC0);
204 /* Ditto for channel 1 */
205 pci_read_config_byte(pdev, ARTIM23, &ctrl);
206 ctrl |= 0x0C;
207 pci_write_config_byte(pdev, ARTIM23, ctrl);
210 static int cmd640_init_one(struct pci_dev *pdev, const struct pci_device_id *id)
212 static const struct ata_port_info info = {
213 .flags = ATA_FLAG_SLAVE_POSS,
214 .pio_mask = ATA_PIO4,
215 .port_ops = &cmd640_port_ops
217 const struct ata_port_info *ppi[] = { &info, NULL };
218 int rc;
220 rc = pcim_enable_device(pdev);
221 if (rc)
222 return rc;
224 cmd640_hardware_init(pdev);
226 return ata_pci_sff_init_one(pdev, ppi, &cmd640_sht, NULL);
229 #ifdef CONFIG_PM
230 static int cmd640_reinit_one(struct pci_dev *pdev)
232 struct ata_host *host = dev_get_drvdata(&pdev->dev);
233 int rc;
235 rc = ata_pci_device_do_resume(pdev);
236 if (rc)
237 return rc;
238 cmd640_hardware_init(pdev);
239 ata_host_resume(host);
240 return 0;
242 #endif
244 static const struct pci_device_id cmd640[] = {
245 { PCI_VDEVICE(CMD, 0x640), 0 },
246 { },
249 static struct pci_driver cmd640_pci_driver = {
250 .name = DRV_NAME,
251 .id_table = cmd640,
252 .probe = cmd640_init_one,
253 .remove = ata_pci_remove_one,
254 #ifdef CONFIG_PM
255 .suspend = ata_pci_device_suspend,
256 .resume = cmd640_reinit_one,
257 #endif
260 static int __init cmd640_init(void)
262 return pci_register_driver(&cmd640_pci_driver);
265 static void __exit cmd640_exit(void)
267 pci_unregister_driver(&cmd640_pci_driver);
270 MODULE_AUTHOR("Alan Cox");
271 MODULE_DESCRIPTION("low-level driver for CMD640 PATA controllers");
272 MODULE_LICENSE("GPL");
273 MODULE_DEVICE_TABLE(pci, cmd640);
274 MODULE_VERSION(DRV_VERSION);
276 module_init(cmd640_init);
277 module_exit(cmd640_exit);