diff options
| author | Mauro Carvalho Chehab <mchehab@infradead.org> | 2007-08-23 15:31:15 -0400 |
|---|---|---|
| committer | Mauro Carvalho Chehab <mchehab@infradead.org> | 2007-10-09 21:15:00 -0400 |
| commit | 79618cf41337ccedb9abeee059ce76aac7962739 (patch) | |
| tree | 9280d523f6efc5f5be787270075fe9e03f82ad92 /include/media | |
| parent | 5a0377060efcf844f4e359f3ab013de7f1b98da2 (diff) | |
V4L/DVB (6256): Remove the obsolete video-buf module
Signed-off-by: Mauro Carvalho Chehab <mchehab@infradead.org>
http://thread.gmane.org/gmane.comp.video.video4linux/34978/focus=34981
Reviewed-by: Ricardo Cerqueira <v4l@cerqueira.org>
Diffstat (limited to 'include/media')
| -rw-r--r-- | include/media/video-buf.h | 289 |
1 files changed, 0 insertions, 289 deletions
diff --git a/include/media/video-buf.h b/include/media/video-buf.h deleted file mode 100644 index d6f079476db3..000000000000 --- a/include/media/video-buf.h +++ /dev/null | |||
| @@ -1,289 +0,0 @@ | |||
| 1 | /* | ||
| 2 | * | ||
| 3 | * generic helper functions for video4linux capture buffers, to handle | ||
| 4 | * memory management and PCI DMA. | ||
| 5 | * Right now, bttv, saa7134, saa7146 and cx88 use it. | ||
| 6 | * | ||
| 7 | * The functions expect the hardware being able to scatter gatter | ||
| 8 | * (i.e. the buffers are not linear in physical memory, but fragmented | ||
| 9 | * into PAGE_SIZE chunks). They also assume the driver does not need | ||
| 10 | * to touch the video data. | ||
| 11 | * | ||
| 12 | * device specific map/unmap/sync stuff now are mapped as file operations | ||
| 13 | * to allow its usage by USB and virtual devices. | ||
| 14 | * | ||
| 15 | * (c) 2001,02 Gerd Knorr <kraxel@bytesex.org> | ||
| 16 | * (c) 2006 Mauro Carvalho Chehab, <mchehab@infradead.org> | ||
| 17 | * (c) 2006 Ted Walther and John Sokol | ||
| 18 | * | ||
| 19 | * This program is free software; you can redistribute it and/or modify | ||
| 20 | * it under the terms of the GNU General Public License as published by | ||
| 21 | * the Free Software Foundation; either version 2 of the License, or | ||
| 22 | * (at your option) any later version. | ||
| 23 | */ | ||
| 24 | |||
| 25 | #include <linux/videodev2.h> | ||
| 26 | #include <linux/poll.h> | ||
| 27 | |||
| 28 | #define UNSET (-1U) | ||
| 29 | |||
| 30 | /* --------------------------------------------------------------------- */ | ||
| 31 | |||
| 32 | /* | ||
| 33 | * Return a scatterlist for some page-aligned vmalloc()'ed memory | ||
| 34 | * block (NULL on errors). Memory for the scatterlist is allocated | ||
| 35 | * using kmalloc. The caller must free the memory. | ||
| 36 | */ | ||
| 37 | struct scatterlist* videobuf_vmalloc_to_sg(unsigned char *virt, int nr_pages); | ||
| 38 | |||
| 39 | /* | ||
| 40 | * Return a scatterlist for a an array of userpages (NULL on errors). | ||
| 41 | * Memory for the scatterlist is allocated using kmalloc. The caller | ||
| 42 | * must free the memory. | ||
| 43 | */ | ||
| 44 | struct scatterlist* videobuf_pages_to_sg(struct page **pages, int nr_pages, | ||
| 45 | int offset); | ||
| 46 | |||
| 47 | struct videobuf_buffer; | ||
| 48 | struct videobuf_queue; | ||
| 49 | |||
| 50 | /* --------------------------------------------------------------------- */ | ||
| 51 | |||
| 52 | /* | ||
| 53 | * A small set of helper functions to manage buffers (both userland | ||
| 54 | * and kernel) for DMA. | ||
| 55 | * | ||
| 56 | * videobuf_dma_init_*() | ||
| 57 | * creates a buffer. The userland version takes a userspace | ||
| 58 | * pointer + length. The kernel version just wants the size and | ||
| 59 | * does memory allocation too using vmalloc_32(). | ||
| 60 | * | ||
| 61 | * videobuf_dma_*() | ||
| 62 | * see Documentation/DMA-mapping.txt, these functions to | ||
| 63 | * basically the same. The map function does also build a | ||
| 64 | * scatterlist for the buffer (and unmap frees it ...) | ||
| 65 | * | ||
| 66 | * videobuf_dma_free() | ||
| 67 | * no comment ... | ||
| 68 | * | ||
| 69 | */ | ||
| 70 | |||
| 71 | struct videobuf_dmabuf { | ||
| 72 | u32 magic; | ||
| 73 | |||
| 74 | /* for userland buffer */ | ||
| 75 | int offset; | ||
| 76 | struct page **pages; | ||
| 77 | |||
| 78 | /* for kernel buffers */ | ||
| 79 | void *vmalloc; | ||
| 80 | |||
| 81 | /* Stores the userspace pointer to vmalloc area */ | ||
| 82 | void *varea; | ||
| 83 | |||
| 84 | /* for overlay buffers (pci-pci dma) */ | ||
| 85 | dma_addr_t bus_addr; | ||
| 86 | |||
| 87 | /* common */ | ||
| 88 | struct scatterlist *sglist; | ||
| 89 | int sglen; | ||
| 90 | int nr_pages; | ||
| 91 | int direction; | ||
| 92 | }; | ||
| 93 | |||
| 94 | void videobuf_dma_init(struct videobuf_dmabuf *dma); | ||
| 95 | int videobuf_dma_init_user(struct videobuf_dmabuf *dma, int direction, | ||
| 96 | unsigned long data, unsigned long size); | ||
| 97 | int videobuf_dma_init_kernel(struct videobuf_dmabuf *dma, int direction, | ||
| 98 | int nr_pages); | ||
| 99 | int videobuf_dma_init_overlay(struct videobuf_dmabuf *dma, int direction, | ||
| 100 | dma_addr_t addr, int nr_pages); | ||
| 101 | int videobuf_dma_free(struct videobuf_dmabuf *dma); | ||
| 102 | |||
| 103 | int videobuf_dma_map(struct videobuf_queue* q,struct videobuf_dmabuf *dma); | ||
| 104 | int videobuf_dma_sync(struct videobuf_queue* q,struct videobuf_dmabuf *dma); | ||
| 105 | int videobuf_dma_unmap(struct videobuf_queue* q,struct videobuf_dmabuf *dma); | ||
| 106 | |||
| 107 | /*FIXME: these variants are used only on *-alsa code, where videobuf is | ||
| 108 | * used without queue | ||
| 109 | */ | ||
| 110 | int videobuf_pci_dma_map(struct pci_dev *pci,struct videobuf_dmabuf *dma); | ||
| 111 | int videobuf_pci_dma_unmap(struct pci_dev *pci,struct videobuf_dmabuf *dma); | ||
| 112 | |||
| 113 | /* --------------------------------------------------------------------- */ | ||
| 114 | |||
| 115 | /* | ||
| 116 | * A small set of helper functions to manage video4linux buffers. | ||
| 117 | * | ||
| 118 | * struct videobuf_buffer holds the data structures used by the helper | ||
| 119 | * functions, additionally some commonly used fields for v4l buffers | ||
| 120 | * (width, height, lists, waitqueue) are in there. That struct should | ||
| 121 | * be used as first element in the drivers buffer struct. | ||
| 122 | * | ||
| 123 | * about the mmap helpers (videobuf_mmap_*): | ||
| 124 | * | ||
| 125 | * The mmaper function allows to map any subset of contingous buffers. | ||
| 126 | * This includes one mmap() call for all buffers (which the original | ||
| 127 | * video4linux API uses) as well as one mmap() for every single buffer | ||
| 128 | * (which v4l2 uses). | ||
| 129 | * | ||
| 130 | * If there is a valid mapping for a buffer, buffer->baddr/bsize holds | ||
| 131 | * userspace address + size which can be feeded into the | ||
| 132 | * videobuf_dma_init_user function listed above. | ||
| 133 | * | ||
| 134 | */ | ||
| 135 | |||
| 136 | struct videobuf_mapping { | ||
| 137 | unsigned int count; | ||
| 138 | unsigned long start; | ||
| 139 | unsigned long end; | ||
| 140 | struct videobuf_queue *q; | ||
| 141 | }; | ||
| 142 | |||
| 143 | enum videobuf_state { | ||
| 144 | STATE_NEEDS_INIT = 0, | ||
| 145 | STATE_PREPARED = 1, | ||
| 146 | STATE_QUEUED = 2, | ||
| 147 | STATE_ACTIVE = 3, | ||
| 148 | STATE_DONE = 4, | ||
| 149 | STATE_ERROR = 5, | ||
| 150 | STATE_IDLE = 6, | ||
| 151 | }; | ||
| 152 | |||
| 153 | struct videobuf_buffer { | ||
| 154 | unsigned int i; | ||
| 155 | u32 magic; | ||
| 156 | |||
| 157 | /* info about the buffer */ | ||
| 158 | unsigned int width; | ||
| 159 | unsigned int height; | ||
| 160 | unsigned int bytesperline; /* use only if != 0 */ | ||
| 161 | unsigned long size; | ||
| 162 | unsigned int input; | ||
| 163 | enum v4l2_field field; | ||
| 164 | enum videobuf_state state; | ||
| 165 | struct videobuf_dmabuf dma; | ||
| 166 | struct list_head stream; /* QBUF/DQBUF list */ | ||
| 167 | |||
| 168 | /* for mmap'ed buffers */ | ||
| 169 | enum v4l2_memory memory; | ||
| 170 | size_t boff; /* buffer offset (mmap + overlay) */ | ||
| 171 | size_t bsize; /* buffer size */ | ||
| 172 | unsigned long baddr; /* buffer addr (userland ptr!) */ | ||
| 173 | struct videobuf_mapping *map; | ||
| 174 | |||
| 175 | /* touched by irq handler */ | ||
| 176 | struct list_head queue; | ||
| 177 | wait_queue_head_t done; | ||
| 178 | unsigned int field_count; | ||
| 179 | struct timeval ts; | ||
| 180 | }; | ||
| 181 | |||
| 182 | typedef int (vb_map_sg_t)(void *dev,struct scatterlist *sglist,int nr_pages, | ||
| 183 | int direction); | ||
| 184 | |||
| 185 | |||
| 186 | struct videobuf_queue_ops { | ||
| 187 | int (*buf_setup)(struct videobuf_queue *q, | ||
| 188 | unsigned int *count, unsigned int *size); | ||
| 189 | int (*buf_prepare)(struct videobuf_queue *q, | ||
| 190 | struct videobuf_buffer *vb, | ||
| 191 | enum v4l2_field field); | ||
| 192 | void (*buf_queue)(struct videobuf_queue *q, | ||
| 193 | struct videobuf_buffer *vb); | ||
| 194 | void (*buf_release)(struct videobuf_queue *q, | ||
| 195 | struct videobuf_buffer *vb); | ||
| 196 | |||
| 197 | /* Helper operations - device dependent. | ||
| 198 | * If null, videobuf_init defaults all to PCI handling | ||
| 199 | */ | ||
| 200 | |||
| 201 | vb_map_sg_t *vb_map_sg; | ||
| 202 | vb_map_sg_t *vb_dma_sync_sg; | ||
| 203 | vb_map_sg_t *vb_unmap_sg; | ||
| 204 | }; | ||
| 205 | |||
| 206 | struct videobuf_queue { | ||
| 207 | struct mutex lock; | ||
| 208 | spinlock_t *irqlock; | ||
| 209 | void *dev; /* on pci, points to struct pci_dev */ | ||
| 210 | |||
| 211 | enum v4l2_buf_type type; | ||
| 212 | unsigned int inputs; /* for V4L2_BUF_FLAG_INPUT */ | ||
| 213 | unsigned int msize; | ||
| 214 | enum v4l2_field field; | ||
| 215 | enum v4l2_field last; /* for field=V4L2_FIELD_ALTERNATE */ | ||
| 216 | struct videobuf_buffer *bufs[VIDEO_MAX_FRAME]; | ||
| 217 | struct videobuf_queue_ops *ops; | ||
| 218 | |||
| 219 | /* capture via mmap() + ioctl(QBUF/DQBUF) */ | ||
| 220 | unsigned int streaming; | ||
| 221 | struct list_head stream; | ||
| 222 | |||
| 223 | /* capture via read() */ | ||
| 224 | unsigned int reading; | ||
| 225 | unsigned int read_off; | ||
| 226 | struct videobuf_buffer *read_buf; | ||
| 227 | |||
| 228 | /* driver private data */ | ||
| 229 | void *priv_data; | ||
| 230 | }; | ||
| 231 | |||
| 232 | void* videobuf_alloc(unsigned int size); | ||
| 233 | int videobuf_waiton(struct videobuf_buffer *vb, int non_blocking, int intr); | ||
| 234 | int videobuf_iolock(struct videobuf_queue* q, struct videobuf_buffer *vb, | ||
| 235 | struct v4l2_framebuffer *fbuf); | ||
| 236 | |||
| 237 | /* Maps fops to PCI stuff */ | ||
| 238 | void videobuf_queue_pci(struct videobuf_queue* q); | ||
| 239 | |||
| 240 | void videobuf_queue_init(struct videobuf_queue *q, | ||
| 241 | struct videobuf_queue_ops *ops, | ||
| 242 | void *dev, | ||
| 243 | spinlock_t *irqlock, | ||
| 244 | enum v4l2_buf_type type, | ||
| 245 | enum v4l2_field field, | ||
| 246 | unsigned int msize, | ||
| 247 | void *priv); | ||
| 248 | int videobuf_queue_is_busy(struct videobuf_queue *q); | ||
| 249 | void videobuf_queue_cancel(struct videobuf_queue *q); | ||
| 250 | |||
| 251 | enum v4l2_field videobuf_next_field(struct videobuf_queue *q); | ||
| 252 | void videobuf_status(struct v4l2_buffer *b, struct videobuf_buffer *vb, | ||
| 253 | enum v4l2_buf_type type); | ||
| 254 | int videobuf_reqbufs(struct videobuf_queue *q, | ||
| 255 | struct v4l2_requestbuffers *req); | ||
| 256 | int videobuf_querybuf(struct videobuf_queue *q, struct v4l2_buffer *b); | ||
| 257 | int videobuf_qbuf(struct videobuf_queue *q, | ||
| 258 | struct v4l2_buffer *b); | ||
| 259 | int videobuf_dqbuf(struct videobuf_queue *q, | ||
| 260 | struct v4l2_buffer *b, int nonblocking); | ||
| 261 | int videobuf_streamon(struct videobuf_queue *q); | ||
| 262 | int videobuf_streamoff(struct videobuf_queue *q); | ||
| 263 | |||
| 264 | int videobuf_read_start(struct videobuf_queue *q); | ||
| 265 | void videobuf_read_stop(struct videobuf_queue *q); | ||
| 266 | ssize_t videobuf_read_stream(struct videobuf_queue *q, | ||
| 267 | char __user *data, size_t count, loff_t *ppos, | ||
| 268 | int vbihack, int nonblocking); | ||
| 269 | ssize_t videobuf_read_one(struct videobuf_queue *q, | ||
| 270 | char __user *data, size_t count, loff_t *ppos, | ||
| 271 | int nonblocking); | ||
| 272 | unsigned int videobuf_poll_stream(struct file *file, | ||
| 273 | struct videobuf_queue *q, | ||
| 274 | poll_table *wait); | ||
| 275 | |||
| 276 | int videobuf_mmap_setup(struct videobuf_queue *q, | ||
| 277 | unsigned int bcount, unsigned int bsize, | ||
| 278 | enum v4l2_memory memory); | ||
| 279 | int videobuf_mmap_free(struct videobuf_queue *q); | ||
| 280 | int videobuf_mmap_mapper(struct videobuf_queue *q, | ||
| 281 | struct vm_area_struct *vma); | ||
| 282 | |||
| 283 | /* --------------------------------------------------------------------- */ | ||
| 284 | |||
| 285 | /* | ||
| 286 | * Local variables: | ||
| 287 | * c-basic-offset: 8 | ||
| 288 | * End: | ||
| 289 | */ | ||
