xref: /openbmc/linux/drivers/ata/pata_pxa.c (revision 8bd1369b)
1 /*
2  * Generic PXA PATA driver
3  *
4  * Copyright (C) 2010 Marek Vasut <marek.vasut@gmail.com>
5  *
6  *  This program is free software; you can redistribute it and/or modify
7  *  it under the terms of the GNU General Public License as published by
8  *  the Free Software Foundation; either version 2, or (at your option)
9  *  any later version.
10  *
11  *  This program is distributed in the hope that it will be useful,
12  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
13  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  *  GNU General Public License for more details.
15  *
16  *  You should have received a copy of the GNU General Public License
17  *  along with this program; see the file COPYING.  If not, write to
18  *  the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
19  */
20 
21 #include <linux/kernel.h>
22 #include <linux/module.h>
23 #include <linux/blkdev.h>
24 #include <linux/ata.h>
25 #include <linux/libata.h>
26 #include <linux/platform_device.h>
27 #include <linux/dmaengine.h>
28 #include <linux/dma/pxa-dma.h>
29 #include <linux/gpio.h>
30 #include <linux/slab.h>
31 #include <linux/completion.h>
32 
33 #include <scsi/scsi_host.h>
34 
35 #include <linux/platform_data/ata-pxa.h>
36 
37 #define DRV_NAME	"pata_pxa"
38 #define DRV_VERSION	"0.1"
39 
40 struct pata_pxa_data {
41 	struct dma_chan		*dma_chan;
42 	dma_cookie_t		dma_cookie;
43 	struct completion	dma_done;
44 };
45 
46 /*
47  * DMA interrupt handler.
48  */
49 static void pxa_ata_dma_irq(void *d)
50 {
51 	struct pata_pxa_data *pd = d;
52 	enum dma_status status;
53 
54 	status = dmaengine_tx_status(pd->dma_chan, pd->dma_cookie, NULL);
55 	if (status == DMA_ERROR || status == DMA_COMPLETE)
56 		complete(&pd->dma_done);
57 }
58 
59 /*
60  * Prepare taskfile for submission.
61  */
62 static void pxa_qc_prep(struct ata_queued_cmd *qc)
63 {
64 	struct pata_pxa_data *pd = qc->ap->private_data;
65 	struct dma_async_tx_descriptor *tx;
66 	enum dma_transfer_direction dir;
67 
68 	if (!(qc->flags & ATA_QCFLAG_DMAMAP))
69 		return;
70 
71 	dir = (qc->dma_dir == DMA_TO_DEVICE ? DMA_MEM_TO_DEV : DMA_DEV_TO_MEM);
72 	tx = dmaengine_prep_slave_sg(pd->dma_chan, qc->sg, qc->n_elem, dir,
73 				     DMA_PREP_INTERRUPT);
74 	if (!tx) {
75 		ata_dev_err(qc->dev, "prep_slave_sg() failed\n");
76 		return;
77 	}
78 	tx->callback = pxa_ata_dma_irq;
79 	tx->callback_param = pd;
80 	pd->dma_cookie = dmaengine_submit(tx);
81 }
82 
83 /*
84  * Configure the DMA controller, load the DMA descriptors, but don't start the
85  * DMA controller yet. Only issue the ATA command.
86  */
87 static void pxa_bmdma_setup(struct ata_queued_cmd *qc)
88 {
89 	qc->ap->ops->sff_exec_command(qc->ap, &qc->tf);
90 }
91 
92 /*
93  * Execute the DMA transfer.
94  */
95 static void pxa_bmdma_start(struct ata_queued_cmd *qc)
96 {
97 	struct pata_pxa_data *pd = qc->ap->private_data;
98 	init_completion(&pd->dma_done);
99 	dma_async_issue_pending(pd->dma_chan);
100 }
101 
102 /*
103  * Wait until the DMA transfer completes, then stop the DMA controller.
104  */
105 static void pxa_bmdma_stop(struct ata_queued_cmd *qc)
106 {
107 	struct pata_pxa_data *pd = qc->ap->private_data;
108 	enum dma_status status;
109 
110 	status = dmaengine_tx_status(pd->dma_chan, pd->dma_cookie, NULL);
111 	if (status != DMA_ERROR && status != DMA_COMPLETE &&
112 	    wait_for_completion_timeout(&pd->dma_done, HZ))
113 		ata_dev_err(qc->dev, "Timeout waiting for DMA completion!");
114 
115 	dmaengine_terminate_all(pd->dma_chan);
116 }
117 
118 /*
119  * Read DMA status. The bmdma_stop() will take care of properly finishing the
120  * DMA transfer so we always have DMA-complete interrupt here.
121  */
122 static unsigned char pxa_bmdma_status(struct ata_port *ap)
123 {
124 	struct pata_pxa_data *pd = ap->private_data;
125 	unsigned char ret = ATA_DMA_INTR;
126 	struct dma_tx_state state;
127 	enum dma_status status;
128 
129 	status = dmaengine_tx_status(pd->dma_chan, pd->dma_cookie, &state);
130 	if (status != DMA_COMPLETE)
131 		ret |= ATA_DMA_ERR;
132 
133 	return ret;
134 }
135 
136 /*
137  * No IRQ register present so we do nothing.
138  */
139 static void pxa_irq_clear(struct ata_port *ap)
140 {
141 }
142 
143 /*
144  * Check for ATAPI DMA. ATAPI DMA is unsupported by this driver. It's still
145  * unclear why ATAPI has DMA issues.
146  */
147 static int pxa_check_atapi_dma(struct ata_queued_cmd *qc)
148 {
149 	return -EOPNOTSUPP;
150 }
151 
152 static struct scsi_host_template pxa_ata_sht = {
153 	ATA_BMDMA_SHT(DRV_NAME),
154 };
155 
156 static struct ata_port_operations pxa_ata_port_ops = {
157 	.inherits		= &ata_bmdma_port_ops,
158 	.cable_detect		= ata_cable_40wire,
159 
160 	.bmdma_setup		= pxa_bmdma_setup,
161 	.bmdma_start		= pxa_bmdma_start,
162 	.bmdma_stop		= pxa_bmdma_stop,
163 	.bmdma_status		= pxa_bmdma_status,
164 
165 	.check_atapi_dma	= pxa_check_atapi_dma,
166 
167 	.sff_irq_clear		= pxa_irq_clear,
168 
169 	.qc_prep		= pxa_qc_prep,
170 };
171 
172 static int pxa_ata_probe(struct platform_device *pdev)
173 {
174 	struct ata_host *host;
175 	struct ata_port *ap;
176 	struct pata_pxa_data *data;
177 	struct resource *cmd_res;
178 	struct resource *ctl_res;
179 	struct resource *dma_res;
180 	struct resource *irq_res;
181 	struct pata_pxa_pdata *pdata = dev_get_platdata(&pdev->dev);
182 	struct dma_slave_config	config;
183 	dma_cap_mask_t mask;
184 	struct pxad_param param;
185 	int ret = 0;
186 
187 	/*
188 	 * Resource validation, three resources are needed:
189 	 *  - CMD port base address
190 	 *  - CTL port base address
191 	 *  - DMA port base address
192 	 *  - IRQ pin
193 	 */
194 	if (pdev->num_resources != 4) {
195 		dev_err(&pdev->dev, "invalid number of resources\n");
196 		return -EINVAL;
197 	}
198 
199 	/*
200 	 * CMD port base address
201 	 */
202 	cmd_res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
203 	if (unlikely(cmd_res == NULL))
204 		return -EINVAL;
205 
206 	/*
207 	 * CTL port base address
208 	 */
209 	ctl_res = platform_get_resource(pdev, IORESOURCE_MEM, 1);
210 	if (unlikely(ctl_res == NULL))
211 		return -EINVAL;
212 
213 	/*
214 	 * DMA port base address
215 	 */
216 	dma_res = platform_get_resource(pdev, IORESOURCE_DMA, 0);
217 	if (unlikely(dma_res == NULL))
218 		return -EINVAL;
219 
220 	/*
221 	 * IRQ pin
222 	 */
223 	irq_res = platform_get_resource(pdev, IORESOURCE_IRQ, 0);
224 	if (unlikely(irq_res == NULL))
225 		return -EINVAL;
226 
227 	/*
228 	 * Allocate the host
229 	 */
230 	host = ata_host_alloc(&pdev->dev, 1);
231 	if (!host)
232 		return -ENOMEM;
233 
234 	ap		= host->ports[0];
235 	ap->ops		= &pxa_ata_port_ops;
236 	ap->pio_mask	= ATA_PIO4;
237 	ap->mwdma_mask	= ATA_MWDMA2;
238 
239 	ap->ioaddr.cmd_addr	= devm_ioremap(&pdev->dev, cmd_res->start,
240 						resource_size(cmd_res));
241 	ap->ioaddr.ctl_addr	= devm_ioremap(&pdev->dev, ctl_res->start,
242 						resource_size(ctl_res));
243 	ap->ioaddr.bmdma_addr	= devm_ioremap(&pdev->dev, dma_res->start,
244 						resource_size(dma_res));
245 
246 	/*
247 	 * Adjust register offsets
248 	 */
249 	ap->ioaddr.altstatus_addr = ap->ioaddr.ctl_addr;
250 	ap->ioaddr.data_addr	= ap->ioaddr.cmd_addr +
251 					(ATA_REG_DATA << pdata->reg_shift);
252 	ap->ioaddr.error_addr	= ap->ioaddr.cmd_addr +
253 					(ATA_REG_ERR << pdata->reg_shift);
254 	ap->ioaddr.feature_addr	= ap->ioaddr.cmd_addr +
255 					(ATA_REG_FEATURE << pdata->reg_shift);
256 	ap->ioaddr.nsect_addr	= ap->ioaddr.cmd_addr +
257 					(ATA_REG_NSECT << pdata->reg_shift);
258 	ap->ioaddr.lbal_addr	= ap->ioaddr.cmd_addr +
259 					(ATA_REG_LBAL << pdata->reg_shift);
260 	ap->ioaddr.lbam_addr	= ap->ioaddr.cmd_addr +
261 					(ATA_REG_LBAM << pdata->reg_shift);
262 	ap->ioaddr.lbah_addr	= ap->ioaddr.cmd_addr +
263 					(ATA_REG_LBAH << pdata->reg_shift);
264 	ap->ioaddr.device_addr	= ap->ioaddr.cmd_addr +
265 					(ATA_REG_DEVICE << pdata->reg_shift);
266 	ap->ioaddr.status_addr	= ap->ioaddr.cmd_addr +
267 					(ATA_REG_STATUS << pdata->reg_shift);
268 	ap->ioaddr.command_addr	= ap->ioaddr.cmd_addr +
269 					(ATA_REG_CMD << pdata->reg_shift);
270 
271 	/*
272 	 * Allocate and load driver's internal data structure
273 	 */
274 	data = devm_kzalloc(&pdev->dev, sizeof(struct pata_pxa_data),
275 								GFP_KERNEL);
276 	if (!data)
277 		return -ENOMEM;
278 
279 	ap->private_data = data;
280 
281 	dma_cap_zero(mask);
282 	dma_cap_set(DMA_SLAVE, mask);
283 	param.prio = PXAD_PRIO_LOWEST;
284 	param.drcmr = pdata->dma_dreq;
285 	memset(&config, 0, sizeof(config));
286 	config.src_addr_width = DMA_SLAVE_BUSWIDTH_2_BYTES;
287 	config.dst_addr_width = DMA_SLAVE_BUSWIDTH_2_BYTES;
288 	config.src_addr = dma_res->start;
289 	config.dst_addr = dma_res->start;
290 	config.src_maxburst = 32;
291 	config.dst_maxburst = 32;
292 
293 	/*
294 	 * Request the DMA channel
295 	 */
296 	data->dma_chan =
297 		dma_request_slave_channel_compat(mask, pxad_filter_fn,
298 						 &param, &pdev->dev, "data");
299 	if (!data->dma_chan)
300 		return -EBUSY;
301 	ret = dmaengine_slave_config(data->dma_chan, &config);
302 	if (ret < 0) {
303 		dev_err(&pdev->dev, "dma configuration failed: %d\n", ret);
304 		return ret;
305 	}
306 
307 	/*
308 	 * Activate the ATA host
309 	 */
310 	ret = ata_host_activate(host, irq_res->start, ata_sff_interrupt,
311 				pdata->irq_flags, &pxa_ata_sht);
312 	if (ret)
313 		dma_release_channel(data->dma_chan);
314 
315 	return ret;
316 }
317 
318 static int pxa_ata_remove(struct platform_device *pdev)
319 {
320 	struct ata_host *host = platform_get_drvdata(pdev);
321 	struct pata_pxa_data *data = host->ports[0]->private_data;
322 
323 	dma_release_channel(data->dma_chan);
324 
325 	ata_host_detach(host);
326 
327 	return 0;
328 }
329 
330 static struct platform_driver pxa_ata_driver = {
331 	.probe		= pxa_ata_probe,
332 	.remove		= pxa_ata_remove,
333 	.driver		= {
334 		.name		= DRV_NAME,
335 	},
336 };
337 
338 module_platform_driver(pxa_ata_driver);
339 
340 MODULE_AUTHOR("Marek Vasut <marek.vasut@gmail.com>");
341 MODULE_DESCRIPTION("DMA-capable driver for PATA on PXA CPU");
342 MODULE_LICENSE("GPL");
343 MODULE_VERSION(DRV_VERSION);
344 MODULE_ALIAS("platform:" DRV_NAME);
345