Blame view
include/bouncebuf.h
2.43 KB
83d290c56 SPDX: Convert all... |
1 |
/* SPDX-License-Identifier: GPL-2.0+ */ |
b660df3c9 COMMON: Implement... |
2 3 4 5 |
/* * Generic bounce buffer implementation * * Copyright (C) 2012 Marek Vasut <marex@denx.de> |
b660df3c9 COMMON: Implement... |
6 7 8 9 |
*/ #ifndef __INCLUDE_BOUNCEBUF_H__ #define __INCLUDE_BOUNCEBUF_H__ |
84d35b286 common: rework bo... |
10 |
#include <linux/types.h> |
b660df3c9 COMMON: Implement... |
11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 |
/* * GEN_BB_READ -- Data are read from the buffer eg. by DMA hardware. * The source buffer is copied into the bounce buffer (if unaligned, otherwise * the source buffer is used directly) upon start() call, then the operation * requiring the aligned transfer happens, then the bounce buffer is lost upon * stop() call. */ #define GEN_BB_READ (1 << 0) /* * GEN_BB_WRITE -- Data are written into the buffer eg. by DMA hardware. * The source buffer starts in an undefined state upon start() call, then the * operation requiring the aligned transfer happens, then the bounce buffer is * copied into the destination buffer (if unaligned, otherwise destination * buffer is used directly) upon stop() call. */ #define GEN_BB_WRITE (1 << 1) /* * GEN_BB_RW -- Data are read and written into the buffer eg. by DMA hardware. * The source buffer is copied into the bounce buffer (if unaligned, otherwise * the source buffer is used directly) upon start() call, then the operation * requiring the aligned transfer happens, then the bounce buffer is copied * into the destination buffer (if unaligned, otherwise destination buffer is * used directly) upon stop() call. */ #define GEN_BB_RW (GEN_BB_READ | GEN_BB_WRITE) |
84d35b286 common: rework bo... |
36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 |
struct bounce_buffer { /* Copy of data parameter passed to start() */ void *user_buffer; /* * DMA-aligned buffer. This field is always set to the value that * should be used for DMA; either equal to .user_buffer, or to a * freshly allocated aligned buffer. */ void *bounce_buffer; /* Copy of len parameter passed to start() */ size_t len; /* DMA-aligned buffer length */ size_t len_aligned; /* Copy of flags parameter passed to start() */ unsigned int flags; }; |
b660df3c9 COMMON: Implement... |
52 53 |
/** * bounce_buffer_start() -- Start the bounce buffer session |
84d35b286 common: rework bo... |
54 |
* state: stores state passed between bounce_buffer_{start,stop} |
b660df3c9 COMMON: Implement... |
55 56 |
* data: pointer to buffer to be aligned * len: length of the buffer |
b660df3c9 COMMON: Implement... |
57 58 |
* flags: flags describing the transaction, see above. */ |
84d35b286 common: rework bo... |
59 60 |
int bounce_buffer_start(struct bounce_buffer *state, void *data, size_t len, unsigned int flags); |
b660df3c9 COMMON: Implement... |
61 62 |
/** * bounce_buffer_stop() -- Finish the bounce buffer session |
84d35b286 common: rework bo... |
63 |
* state: stores state passed between bounce_buffer_{start,stop} |
b660df3c9 COMMON: Implement... |
64 |
*/ |
84d35b286 common: rework bo... |
65 |
int bounce_buffer_stop(struct bounce_buffer *state); |
b660df3c9 COMMON: Implement... |
66 67 |
#endif |