2 * Copyright (C) 2012 Intel Corporation
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
10 * 2. Redistributions in binary form must reproduce the above copyright
11 * notice, this list of conditions and the following disclaimer in the
12 * documentation and/or other materials provided with the distribution.
14 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
27 __FBSDID("$FreeBSD$");
32 #include <sys/param.h>
33 #include <machine/bus.h>
36 * This file defines the public interface to the IOAT driver.
40 * Enables an interrupt for this operation. Typically, you would only enable
41 * this on the last operation in a group
43 #define DMA_INT_EN 0x1
45 * Like M_NOWAIT. Operations will return NULL if they cannot allocate a
46 * descriptor without blocking.
48 #define DMA_NO_WAIT 0x2
49 #define DMA_ALL_FLAGS (DMA_INT_EN | DMA_NO_WAIT)
51 typedef void *bus_dmaengine_t;
53 typedef void (*bus_dmaengine_callback_t)(void *arg, int error);
56 * Called first to acquire a reference to the DMA channel
58 bus_dmaengine_t ioat_get_dmaengine(uint32_t channel_index);
60 /* Release the DMA channel */
61 void ioat_put_dmaengine(bus_dmaengine_t dmaengine);
64 * Acquire must be called before issuing an operation to perform. Release is
65 * called after. Multiple operations can be issued within the context of one
68 void ioat_acquire(bus_dmaengine_t dmaengine);
69 void ioat_release(bus_dmaengine_t dmaengine);
72 * Issue a blockfill operation. The 64-bit pattern 'fillpattern' is written to
73 * 'len' physically contiguous bytes at 'dst'.
75 * Only supported on devices with the BFILL capability.
77 struct bus_dmadesc *ioat_blockfill(bus_dmaengine_t dmaengine, bus_addr_t dst,
78 uint64_t fillpattern, bus_size_t len, bus_dmaengine_callback_t callback_fn,
79 void *callback_arg, uint32_t flags);
81 /* Issues the copy data operation */
82 struct bus_dmadesc *ioat_copy(bus_dmaengine_t dmaengine, bus_addr_t dst,
83 bus_addr_t src, bus_size_t len, bus_dmaengine_callback_t callback_fn,
84 void *callback_arg, uint32_t flags);
87 * Issues a null operation. This issues the operation to the hardware, but the
88 * hardware doesn't do anything with it.
90 struct bus_dmadesc *ioat_null(bus_dmaengine_t dmaengine,
91 bus_dmaengine_callback_t callback_fn, void *callback_arg, uint32_t flags);
94 #endif /* __IOAT_H__ */