1 // SPDX-License-Identifier: GPL-2.0+
3 * uvc_v4l2.c -- USB Video Class Gadget driver
5 * Copyright (C) 2009-2010
6 * Laurent Pinchart (laurent.pinchart@ideasonboard.com)
9 #include <linux/device.h>
10 #include <linux/errno.h>
11 #include <linux/kernel.h>
12 #include <linux/list.h>
13 #include <linux/usb/g_uvc.h>
14 #include <linux/videodev2.h>
15 #include <linux/vmalloc.h>
16 #include <linux/wait.h>
18 #include <media/v4l2-dev.h>
19 #include <media/v4l2-event.h>
20 #include <media/v4l2-ioctl.h>
24 #include "uvc_queue.h"
25 #include "uvc_video.h"
28 /* --------------------------------------------------------------------------
33 uvc_send_response(struct uvc_device
*uvc
, struct uvc_request_data
*data
)
35 struct usb_composite_dev
*cdev
= uvc
->func
.config
->cdev
;
36 struct usb_request
*req
= uvc
->control_req
;
39 return usb_ep_set_halt(cdev
->gadget
->ep0
);
41 req
->length
= min_t(unsigned int, uvc
->event_length
, data
->length
);
42 req
->zero
= data
->length
< uvc
->event_length
;
44 memcpy(req
->buf
, data
->data
, req
->length
);
46 return usb_ep_queue(cdev
->gadget
->ep0
, req
, GFP_KERNEL
);
49 /* --------------------------------------------------------------------------
58 static struct uvc_format uvc_formats
[] = {
59 { 16, V4L2_PIX_FMT_YUYV
},
60 { 0, V4L2_PIX_FMT_MJPEG
},
64 uvc_v4l2_querycap(struct file
*file
, void *fh
, struct v4l2_capability
*cap
)
66 struct video_device
*vdev
= video_devdata(file
);
67 struct uvc_device
*uvc
= video_get_drvdata(vdev
);
68 struct usb_composite_dev
*cdev
= uvc
->func
.config
->cdev
;
70 strlcpy(cap
->driver
, "g_uvc", sizeof(cap
->driver
));
71 strlcpy(cap
->card
, cdev
->gadget
->name
, sizeof(cap
->card
));
72 strlcpy(cap
->bus_info
, dev_name(&cdev
->gadget
->dev
),
73 sizeof(cap
->bus_info
));
78 uvc_v4l2_get_format(struct file
*file
, void *fh
, struct v4l2_format
*fmt
)
80 struct video_device
*vdev
= video_devdata(file
);
81 struct uvc_device
*uvc
= video_get_drvdata(vdev
);
82 struct uvc_video
*video
= &uvc
->video
;
84 fmt
->fmt
.pix
.pixelformat
= video
->fcc
;
85 fmt
->fmt
.pix
.width
= video
->width
;
86 fmt
->fmt
.pix
.height
= video
->height
;
87 fmt
->fmt
.pix
.field
= V4L2_FIELD_NONE
;
88 fmt
->fmt
.pix
.bytesperline
= video
->bpp
* video
->width
/ 8;
89 fmt
->fmt
.pix
.sizeimage
= video
->imagesize
;
90 fmt
->fmt
.pix
.colorspace
= V4L2_COLORSPACE_SRGB
;
91 fmt
->fmt
.pix
.priv
= 0;
97 uvc_v4l2_set_format(struct file
*file
, void *fh
, struct v4l2_format
*fmt
)
99 struct video_device
*vdev
= video_devdata(file
);
100 struct uvc_device
*uvc
= video_get_drvdata(vdev
);
101 struct uvc_video
*video
= &uvc
->video
;
102 struct uvc_format
*format
;
103 unsigned int imagesize
;
107 for (i
= 0; i
< ARRAY_SIZE(uvc_formats
); ++i
) {
108 format
= &uvc_formats
[i
];
109 if (format
->fcc
== fmt
->fmt
.pix
.pixelformat
)
113 if (i
== ARRAY_SIZE(uvc_formats
)) {
114 uvcg_info(&uvc
->func
, "Unsupported format 0x%08x.\n",
115 fmt
->fmt
.pix
.pixelformat
);
119 bpl
= format
->bpp
* fmt
->fmt
.pix
.width
/ 8;
120 imagesize
= bpl
? bpl
* fmt
->fmt
.pix
.height
: fmt
->fmt
.pix
.sizeimage
;
122 video
->fcc
= format
->fcc
;
123 video
->bpp
= format
->bpp
;
124 video
->width
= fmt
->fmt
.pix
.width
;
125 video
->height
= fmt
->fmt
.pix
.height
;
126 video
->imagesize
= imagesize
;
128 fmt
->fmt
.pix
.field
= V4L2_FIELD_NONE
;
129 fmt
->fmt
.pix
.bytesperline
= bpl
;
130 fmt
->fmt
.pix
.sizeimage
= imagesize
;
131 fmt
->fmt
.pix
.colorspace
= V4L2_COLORSPACE_SRGB
;
132 fmt
->fmt
.pix
.priv
= 0;
138 uvc_v4l2_reqbufs(struct file
*file
, void *fh
, struct v4l2_requestbuffers
*b
)
140 struct video_device
*vdev
= video_devdata(file
);
141 struct uvc_device
*uvc
= video_get_drvdata(vdev
);
142 struct uvc_video
*video
= &uvc
->video
;
144 if (b
->type
!= video
->queue
.queue
.type
)
147 return uvcg_alloc_buffers(&video
->queue
, b
);
151 uvc_v4l2_querybuf(struct file
*file
, void *fh
, struct v4l2_buffer
*b
)
153 struct video_device
*vdev
= video_devdata(file
);
154 struct uvc_device
*uvc
= video_get_drvdata(vdev
);
155 struct uvc_video
*video
= &uvc
->video
;
157 return uvcg_query_buffer(&video
->queue
, b
);
161 uvc_v4l2_qbuf(struct file
*file
, void *fh
, struct v4l2_buffer
*b
)
163 struct video_device
*vdev
= video_devdata(file
);
164 struct uvc_device
*uvc
= video_get_drvdata(vdev
);
165 struct uvc_video
*video
= &uvc
->video
;
168 ret
= uvcg_queue_buffer(&video
->queue
, b
);
172 schedule_work(&video
->pump
);
178 uvc_v4l2_dqbuf(struct file
*file
, void *fh
, struct v4l2_buffer
*b
)
180 struct video_device
*vdev
= video_devdata(file
);
181 struct uvc_device
*uvc
= video_get_drvdata(vdev
);
182 struct uvc_video
*video
= &uvc
->video
;
184 return uvcg_dequeue_buffer(&video
->queue
, b
, file
->f_flags
& O_NONBLOCK
);
188 uvc_v4l2_streamon(struct file
*file
, void *fh
, enum v4l2_buf_type type
)
190 struct video_device
*vdev
= video_devdata(file
);
191 struct uvc_device
*uvc
= video_get_drvdata(vdev
);
192 struct uvc_video
*video
= &uvc
->video
;
195 if (type
!= video
->queue
.queue
.type
)
198 /* Enable UVC video. */
199 ret
= uvcg_video_enable(video
, 1);
204 * Complete the alternate setting selection setup phase now that
205 * userspace is ready to provide video frames.
207 uvc_function_setup_continue(uvc
);
208 uvc
->state
= UVC_STATE_STREAMING
;
214 uvc_v4l2_streamoff(struct file
*file
, void *fh
, enum v4l2_buf_type type
)
216 struct video_device
*vdev
= video_devdata(file
);
217 struct uvc_device
*uvc
= video_get_drvdata(vdev
);
218 struct uvc_video
*video
= &uvc
->video
;
220 if (type
!= video
->queue
.queue
.type
)
223 return uvcg_video_enable(video
, 0);
227 uvc_v4l2_subscribe_event(struct v4l2_fh
*fh
,
228 const struct v4l2_event_subscription
*sub
)
230 if (sub
->type
< UVC_EVENT_FIRST
|| sub
->type
> UVC_EVENT_LAST
)
233 return v4l2_event_subscribe(fh
, sub
, 2, NULL
);
237 uvc_v4l2_unsubscribe_event(struct v4l2_fh
*fh
,
238 const struct v4l2_event_subscription
*sub
)
240 return v4l2_event_unsubscribe(fh
, sub
);
244 uvc_v4l2_ioctl_default(struct file
*file
, void *fh
, bool valid_prio
,
245 unsigned int cmd
, void *arg
)
247 struct video_device
*vdev
= video_devdata(file
);
248 struct uvc_device
*uvc
= video_get_drvdata(vdev
);
251 case UVCIOC_SEND_RESPONSE
:
252 return uvc_send_response(uvc
, arg
);
259 const struct v4l2_ioctl_ops uvc_v4l2_ioctl_ops
= {
260 .vidioc_querycap
= uvc_v4l2_querycap
,
261 .vidioc_g_fmt_vid_out
= uvc_v4l2_get_format
,
262 .vidioc_s_fmt_vid_out
= uvc_v4l2_set_format
,
263 .vidioc_reqbufs
= uvc_v4l2_reqbufs
,
264 .vidioc_querybuf
= uvc_v4l2_querybuf
,
265 .vidioc_qbuf
= uvc_v4l2_qbuf
,
266 .vidioc_dqbuf
= uvc_v4l2_dqbuf
,
267 .vidioc_streamon
= uvc_v4l2_streamon
,
268 .vidioc_streamoff
= uvc_v4l2_streamoff
,
269 .vidioc_subscribe_event
= uvc_v4l2_subscribe_event
,
270 .vidioc_unsubscribe_event
= uvc_v4l2_unsubscribe_event
,
271 .vidioc_default
= uvc_v4l2_ioctl_default
,
274 /* --------------------------------------------------------------------------
279 uvc_v4l2_open(struct file
*file
)
281 struct video_device
*vdev
= video_devdata(file
);
282 struct uvc_device
*uvc
= video_get_drvdata(vdev
);
283 struct uvc_file_handle
*handle
;
285 handle
= kzalloc(sizeof(*handle
), GFP_KERNEL
);
289 v4l2_fh_init(&handle
->vfh
, vdev
);
290 v4l2_fh_add(&handle
->vfh
);
292 handle
->device
= &uvc
->video
;
293 file
->private_data
= &handle
->vfh
;
295 uvc_function_connect(uvc
);
300 uvc_v4l2_release(struct file
*file
)
302 struct video_device
*vdev
= video_devdata(file
);
303 struct uvc_device
*uvc
= video_get_drvdata(vdev
);
304 struct uvc_file_handle
*handle
= to_uvc_file_handle(file
->private_data
);
305 struct uvc_video
*video
= handle
->device
;
307 uvc_function_disconnect(uvc
);
309 mutex_lock(&video
->mutex
);
310 uvcg_video_enable(video
, 0);
311 uvcg_free_buffers(&video
->queue
);
312 mutex_unlock(&video
->mutex
);
314 file
->private_data
= NULL
;
315 v4l2_fh_del(&handle
->vfh
);
316 v4l2_fh_exit(&handle
->vfh
);
323 uvc_v4l2_mmap(struct file
*file
, struct vm_area_struct
*vma
)
325 struct video_device
*vdev
= video_devdata(file
);
326 struct uvc_device
*uvc
= video_get_drvdata(vdev
);
328 return uvcg_queue_mmap(&uvc
->video
.queue
, vma
);
332 uvc_v4l2_poll(struct file
*file
, poll_table
*wait
)
334 struct video_device
*vdev
= video_devdata(file
);
335 struct uvc_device
*uvc
= video_get_drvdata(vdev
);
337 return uvcg_queue_poll(&uvc
->video
.queue
, file
, wait
);
341 static unsigned long uvcg_v4l2_get_unmapped_area(struct file
*file
,
342 unsigned long addr
, unsigned long len
, unsigned long pgoff
,
345 struct video_device
*vdev
= video_devdata(file
);
346 struct uvc_device
*uvc
= video_get_drvdata(vdev
);
348 return uvcg_queue_get_unmapped_area(&uvc
->video
.queue
, pgoff
);
352 const struct v4l2_file_operations uvc_v4l2_fops
= {
353 .owner
= THIS_MODULE
,
354 .open
= uvc_v4l2_open
,
355 .release
= uvc_v4l2_release
,
356 .unlocked_ioctl
= video_ioctl2
,
357 .mmap
= uvc_v4l2_mmap
,
358 .poll
= uvc_v4l2_poll
,
360 .get_unmapped_area
= uvcg_v4l2_get_unmapped_area
,