1 // SPDX-License-Identifier: GPL-2.0
2 /*
3 * u_uvc.h
4 *
5 * Utility definitions for the uvc function
6 *
7 * Copyright (c) 2013-2014 Samsung Electronics Co., Ltd.
8 * http://www.samsung.com
9 *
10 * Author: Andrzej Pietrasiewicz <andrzejtp2010@gmail.com>
11 */
12
13 #ifndef U_UVC_H
14 #define U_UVC_H
15
16 #include <linux/mutex.h>
17 #include <linux/usb/composite.h>
18 #include <linux/usb/video.h>
19
20 #define fi_to_f_uvc_opts(f) container_of(f, struct f_uvc_opts, func_inst)
21
22 struct f_uvc_opts {
23 struct usb_function_instance func_inst;
24 unsigned int streaming_interval;
25 unsigned int streaming_maxpacket;
26 unsigned int streaming_maxburst;
27
28 unsigned int control_interface;
29 unsigned int streaming_interface;
30
31 /*
32 * Control descriptors array pointers for full-/high-speed and
33 * super-speed. They point by default to the uvc_fs_control_cls and
34 * uvc_ss_control_cls arrays respectively. Legacy gadgets must
35 * override them in their gadget bind callback.
36 */
37 const struct uvc_descriptor_header * const *fs_control;
38 const struct uvc_descriptor_header * const *ss_control;
39
40 /*
41 * Streaming descriptors array pointers for full-speed, high-speed and
42 * super-speed. They will point to the uvc_[fhs]s_streaming_cls arrays
43 * for configfs-based gadgets. Legacy gadgets must initialize them in
44 * their gadget bind callback.
45 */
46 const struct uvc_descriptor_header * const *fs_streaming;
47 const struct uvc_descriptor_header * const *hs_streaming;
48 const struct uvc_descriptor_header * const *ss_streaming;
49
50 /* Default control descriptors for configfs-based gadgets. */
51 struct uvc_camera_terminal_descriptor uvc_camera_terminal;
52 struct uvc_processing_unit_descriptor uvc_processing;
53 struct uvc_output_terminal_descriptor uvc_output_terminal;
54 struct uvc_color_matching_descriptor uvc_color_matching;
55
56 /*
57 * Control descriptors pointers arrays for full-/high-speed and
58 * super-speed. The first element is a configurable control header
59 * descriptor, the other elements point to the fixed default control
60 * descriptors. Used by configfs only, must not be touched by legacy
61 * gadgets.
62 */
63 struct uvc_descriptor_header *uvc_fs_control_cls[5];
64 struct uvc_descriptor_header *uvc_ss_control_cls[5];
65
66 /*
67 * Streaming descriptors for full-speed, high-speed and super-speed.
68 * Used by configfs only, must not be touched by legacy gadgets. The
69 * arrays are allocated at runtime as the number of descriptors isn't
70 * known in advance.
71 */
72 struct uvc_descriptor_header **uvc_fs_streaming_cls;
73 struct uvc_descriptor_header **uvc_hs_streaming_cls;
74 struct uvc_descriptor_header **uvc_ss_streaming_cls;
75
76 /*
77 * Read/write access to configfs attributes is handled by configfs.
78 *
79 * This lock protects the descriptors from concurrent access by
80 * read/write and symlink creation/removal.
81 */
82 struct mutex lock;
83 int refcnt;
84 };
85
86 #endif /* U_UVC_H */