xref: /freebsd/sys/dev/ata/ata-dma.c (revision db612abe8df3355d1eb23bb3b50fdd97bc21e979)
1 /*-
2  * Copyright (c) 1998 - 2008 S�ren Schmidt <sos@FreeBSD.org>
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer,
10  *    without modification, immediately at the beginning of the file.
11  * 2. Redistributions in binary form must reproduce the above copyright
12  *    notice, this list of conditions and the following disclaimer in the
13  *    documentation and/or other materials provided with the distribution.
14  *
15  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
16  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
17  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
18  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
19  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
20  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
21  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
22  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
23  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
24  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
25  */
26 
27 #include <sys/cdefs.h>
28 __FBSDID("$FreeBSD$");
29 
30 #include <sys/param.h>
31 #include <sys/systm.h>
32 #include <sys/ata.h>
33 #include <sys/kernel.h>
34 #include <sys/endian.h>
35 #include <sys/malloc.h>
36 #include <sys/lock.h>
37 #include <sys/sema.h>
38 #include <sys/taskqueue.h>
39 #include <vm/uma.h>
40 #include <sys/bus.h>
41 #include <machine/bus.h>
42 #include <sys/rman.h>
43 #include <dev/pci/pcivar.h>
44 #include <dev/ata/ata-all.h>
45 #include <dev/ata/ata-pci.h>
46 
47 /* prototypes */
48 static void ata_dmafini(device_t dev);
49 static void ata_dmasetupc_cb(void *xsc, bus_dma_segment_t *segs, int nsegs, int error);
50 static void ata_dmaalloc(device_t dev);
51 static void ata_dmafree(device_t dev);
52 static void ata_dmasetprd(void *xsc, bus_dma_segment_t *segs, int nsegs, int error);
53 static int ata_dmaload(struct ata_request *request, void *addr, int *nsegs);
54 static int ata_dmaunload(struct ata_request *request);
55 
56 /* local vars */
57 static MALLOC_DEFINE(M_ATADMA, "ata_dma", "ATA driver DMA");
58 
59 /* misc defines */
60 #define MAXTABSZ        PAGE_SIZE
61 #define MAXWSPCSZ       PAGE_SIZE*2
62 
63 struct ata_dc_cb_args {
64     bus_addr_t maddr;
65     int error;
66 };
67 
68 void
69 ata_dmainit(device_t dev)
70 {
71     struct ata_channel *ch = device_get_softc(dev);
72     struct ata_dc_cb_args dcba;
73 
74     ch->dma.alloc = ata_dmaalloc;
75     ch->dma.free = ata_dmafree;
76     ch->dma.setprd = ata_dmasetprd;
77     ch->dma.load = ata_dmaload;
78     ch->dma.unload = ata_dmaunload;
79     ch->dma.alignment = 2;
80     ch->dma.boundary = 65536;
81     ch->dma.segsize = 63536;
82     ch->dma.max_iosize = 128 * DEV_BSIZE;
83     ch->dma.max_address = BUS_SPACE_MAXADDR_32BIT;
84     ch->dma.dma_slots = 2;
85 
86     if (bus_dma_tag_create(bus_get_dma_tag(dev), ch->dma.alignment, 0,
87 			   ch->dma.max_address, BUS_SPACE_MAXADDR,
88 			   NULL, NULL, ch->dma.max_iosize,
89 			   ATA_DMA_ENTRIES, ch->dma.segsize,
90 			   0, NULL, NULL, &ch->dma.dmatag))
91 	goto error;
92 
93     if (bus_dma_tag_create(ch->dma.dmatag, PAGE_SIZE, 64 * 1024,
94 			   ch->dma.max_address, BUS_SPACE_MAXADDR,
95 			   NULL, NULL, MAXWSPCSZ, 1, MAXWSPCSZ,
96 			   0, NULL, NULL, &ch->dma.work_tag))
97 	goto error;
98 
99     if (bus_dmamem_alloc(ch->dma.work_tag, (void **)&ch->dma.work, 0,
100 			 &ch->dma.work_map))
101 	goto error;
102 
103     if (bus_dmamap_load(ch->dma.work_tag, ch->dma.work_map, ch->dma.work,
104 			MAXWSPCSZ, ata_dmasetupc_cb, &dcba, 0) ||
105 			dcba.error) {
106 	bus_dmamem_free(ch->dma.work_tag, ch->dma.work, ch->dma.work_map);
107 	goto error;
108     }
109     ch->dma.work_bus = dcba.maddr;
110     return;
111 
112 error:
113     device_printf(dev, "WARNING - DMA initialization failed, disabling DMA\n");
114     ata_dmafini(dev);
115 }
116 
117 void
118 ata_dmafini(device_t dev)
119 {
120     struct ata_channel *ch = device_get_softc(dev);
121 
122     if (ch->dma.work_bus) {
123 	bus_dmamap_unload(ch->dma.work_tag, ch->dma.work_map);
124 	bus_dmamem_free(ch->dma.work_tag, ch->dma.work, ch->dma.work_map);
125 	ch->dma.work_bus = 0;
126 	ch->dma.work_map = NULL;
127 	ch->dma.work = NULL;
128     }
129     if (ch->dma.work_tag) {
130 	bus_dma_tag_destroy(ch->dma.work_tag);
131 	ch->dma.work_tag = NULL;
132     }
133     if (ch->dma.dmatag) {
134 	bus_dma_tag_destroy(ch->dma.dmatag);
135 	ch->dma.dmatag = NULL;
136     }
137 }
138 
139 static void
140 ata_dmasetupc_cb(void *xsc, bus_dma_segment_t *segs, int nsegs, int error)
141 {
142     struct ata_dc_cb_args *dcba = (struct ata_dc_cb_args *)xsc;
143 
144     if (!(dcba->error = error))
145 	dcba->maddr = segs[0].ds_addr;
146 }
147 
148 static void
149 ata_dmaalloc(device_t dev)
150 {
151     struct ata_channel *ch = device_get_softc(dev);
152     struct ata_dc_cb_args dcba;
153     int i;
154 
155     /* alloc and setup needed dma slots */
156     bzero(ch->dma.slot, sizeof(struct ata_dmaslot) * ATA_DMA_SLOTS);
157     for (i = 0; i < ch->dma.dma_slots; i++) {
158 	struct ata_dmaslot *slot = &ch->dma.slot[i];
159 
160 	if (bus_dma_tag_create(ch->dma.dmatag, PAGE_SIZE, PAGE_SIZE,
161 			       ch->dma.max_address, BUS_SPACE_MAXADDR,
162 			       NULL, NULL, PAGE_SIZE, 1, PAGE_SIZE,
163 			       0, NULL, NULL, &slot->sg_tag)) {
164             device_printf(ch->dev, "FAILURE - create sg_tag\n");
165             goto error;
166 	}
167 
168 	if (bus_dmamem_alloc(slot->sg_tag, (void **)&slot->sg,
169 			     0, &slot->sg_map)) {
170 	    device_printf(ch->dev, "FAILURE - alloc sg_map\n");
171 	    goto error;
172         }
173 
174 	if (bus_dmamap_load(slot->sg_tag, slot->sg_map, slot->sg, MAXTABSZ,
175 			    ata_dmasetupc_cb, &dcba, 0) || dcba.error) {
176 	    device_printf(ch->dev, "FAILURE - load sg\n");
177 	    goto error;
178 	}
179 	slot->sg_bus = dcba.maddr;
180 
181 	if (bus_dma_tag_create(ch->dma.dmatag,
182 			       ch->dma.alignment, ch->dma.boundary,
183                                ch->dma.max_address, BUS_SPACE_MAXADDR,
184                                NULL, NULL, ch->dma.max_iosize,
185                                ATA_DMA_ENTRIES, ch->dma.segsize,
186                                BUS_DMA_ALLOCNOW, NULL, NULL, &slot->data_tag)) {
187 	    device_printf(ch->dev, "FAILURE - create data_tag\n");
188 	    goto error;
189 	}
190 
191 	if (bus_dmamap_create(slot->data_tag, 0, &slot->data_map)) {
192 	    device_printf(ch->dev, "FAILURE - create data_map\n");
193 	    goto error;
194         }
195     }
196 
197     return;
198 
199 error:
200     device_printf(dev, "WARNING - DMA allocation failed, disabling DMA\n");
201     ata_dmafree(dev);
202 }
203 
204 static void
205 ata_dmafree(device_t dev)
206 {
207     struct ata_channel *ch = device_get_softc(dev);
208     int i;
209 
210     /* free all dma slots */
211     for (i = 0; i < ATA_DMA_SLOTS; i++) {
212 	struct ata_dmaslot *slot = &ch->dma.slot[i];
213 
214 	if (slot->sg_bus) {
215             bus_dmamap_unload(slot->sg_tag, slot->sg_map);
216             slot->sg_bus = 0;
217 	}
218 	if (slot->sg_map) {
219             bus_dmamem_free(slot->sg_tag, slot->sg, slot->sg_map);
220             bus_dmamap_destroy(slot->sg_tag, slot->sg_map);
221             slot->sg = NULL;
222             slot->sg_map = NULL;
223 	}
224 	if (slot->data_map) {
225             bus_dmamap_destroy(slot->data_tag, slot->data_map);
226             slot->data_map = NULL;
227 	}
228 	if (slot->sg_tag) {
229             bus_dma_tag_destroy(slot->sg_tag);
230             slot->sg_tag = NULL;
231 	}
232 	if (slot->data_tag) {
233             bus_dma_tag_destroy(slot->data_tag);
234             slot->data_tag = NULL;
235 	}
236     }
237 }
238 
239 static void
240 ata_dmasetprd(void *xsc, bus_dma_segment_t *segs, int nsegs, int error)
241 {
242     struct ata_dmasetprd_args *args = xsc;
243     struct ata_dma_prdentry *prd = args->dmatab;
244     int i;
245 
246     if ((args->error = error))
247 	return;
248 
249     for (i = 0; i < nsegs; i++) {
250 	prd[i].addr = htole32(segs[i].ds_addr);
251 	prd[i].count = htole32(segs[i].ds_len);
252     }
253     prd[i - 1].count |= htole32(ATA_DMA_EOT);
254     KASSERT(nsegs <= ATA_DMA_ENTRIES, ("too many DMA segment entries\n"));
255     args->nsegs = nsegs;
256 }
257 
258 static int
259 ata_dmaload(struct ata_request *request, void *addr, int *entries)
260 {
261     struct ata_channel *ch = device_get_softc(request->parent);
262     struct ata_device *atadev = device_get_softc(request->dev);
263     struct ata_dmasetprd_args dspa;
264     int error;
265 
266     ATA_DEBUG_RQ(request, "dmaload");
267 
268     if (request->dma) {
269 	device_printf(request->dev,
270 		      "FAILURE - already active DMA on this device\n");
271 	return EIO;
272     }
273     if (!request->bytecount) {
274 	device_printf(request->dev,
275 		      "FAILURE - zero length DMA transfer attempted\n");
276 	return EIO;
277     }
278     if (((uintptr_t)(request->data) & (ch->dma.alignment - 1)) ||
279 	(request->bytecount & (ch->dma.alignment - 1))) {
280 	device_printf(request->dev,
281 		      "FAILURE - non aligned DMA transfer attempted\n");
282 	return EIO;
283     }
284     if (request->bytecount > ch->dma.max_iosize) {
285 	device_printf(request->dev,
286 		      "FAILURE - oversized DMA transfer attempt %d > %d\n",
287 		      request->bytecount, ch->dma.max_iosize);
288 	return EIO;
289     }
290 
291     /* set our slot, unit for simplicity XXX SOS NCQ will change that */
292     request->dma = &ch->dma.slot[atadev->unit];
293 
294     if (addr)
295 	dspa.dmatab = addr;
296     else
297 	dspa.dmatab = request->dma->sg;
298 
299     if ((error = bus_dmamap_load(request->dma->data_tag, request->dma->data_map,
300 				 request->data, request->bytecount,
301 				 ch->dma.setprd, &dspa, BUS_DMA_NOWAIT)) ||
302 				 (error = dspa.error)) {
303 	device_printf(request->dev, "FAILURE - load data\n");
304 	goto error;
305     }
306 
307     if (entries)
308 	*entries = dspa.nsegs;
309 
310     bus_dmamap_sync(request->dma->sg_tag, request->dma->sg_map,
311 		    BUS_DMASYNC_PREWRITE);
312     bus_dmamap_sync(request->dma->data_tag, request->dma->data_map,
313 		    (request->flags & ATA_R_READ) ?
314 		    BUS_DMASYNC_PREREAD : BUS_DMASYNC_PREWRITE);
315     return 0;
316 
317 error:
318     ata_dmaunload(request);
319     return EIO;
320 }
321 
322 int
323 ata_dmaunload(struct ata_request *request)
324 {
325     ATA_DEBUG_RQ(request, "dmaunload");
326 
327     if (request->dma) {
328 	bus_dmamap_sync(request->dma->sg_tag, request->dma->sg_map,
329 			BUS_DMASYNC_POSTWRITE);
330 	bus_dmamap_sync(request->dma->data_tag, request->dma->data_map,
331 			(request->flags & ATA_R_READ) ?
332 			BUS_DMASYNC_POSTREAD : BUS_DMASYNC_POSTWRITE);
333 
334 	bus_dmamap_unload(request->dma->data_tag, request->dma->data_map);
335         request->dma = NULL;
336     }
337     return 0;
338 }
339