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 | char function_name[32]; |
31 | unsigned int last_unit_id; |
32 | |
33 | bool enable_interrupt_ep; |
34 | |
35 | /* |
36 | * Control descriptors array pointers for full-/high-speed and |
37 | * super-speed. They point by default to the uvc_fs_control_cls and |
38 | * uvc_ss_control_cls arrays respectively. Legacy gadgets must |
39 | * override them in their gadget bind callback. |
40 | */ |
41 | const struct uvc_descriptor_header * const *fs_control; |
42 | const struct uvc_descriptor_header * const *ss_control; |
43 | |
44 | /* |
45 | * Streaming descriptors array pointers for full-speed, high-speed and |
46 | * super-speed. They will point to the uvc_[fhs]s_streaming_cls arrays |
47 | * for configfs-based gadgets. Legacy gadgets must initialize them in |
48 | * their gadget bind callback. |
49 | */ |
50 | const struct uvc_descriptor_header * const *fs_streaming; |
51 | const struct uvc_descriptor_header * const *hs_streaming; |
52 | const struct uvc_descriptor_header * const *ss_streaming; |
53 | |
54 | /* Default control descriptors for configfs-based gadgets. */ |
55 | struct uvc_camera_terminal_descriptor uvc_camera_terminal; |
56 | struct uvc_processing_unit_descriptor uvc_processing; |
57 | struct uvc_output_terminal_descriptor uvc_output_terminal; |
58 | |
59 | /* |
60 | * Control descriptors pointers arrays for full-/high-speed and |
61 | * super-speed. The first element is a configurable control header |
62 | * descriptor, the other elements point to the fixed default control |
63 | * descriptors. Used by configfs only, must not be touched by legacy |
64 | * gadgets. |
65 | */ |
66 | struct uvc_descriptor_header *uvc_fs_control_cls[5]; |
67 | struct uvc_descriptor_header *uvc_ss_control_cls[5]; |
68 | |
69 | /* |
70 | * Control descriptors for extension units. There could be any number |
71 | * of these, including none at all. |
72 | */ |
73 | struct list_head extension_units; |
74 | |
75 | /* |
76 | * Streaming descriptors for full-speed, high-speed and super-speed. |
77 | * Used by configfs only, must not be touched by legacy gadgets. The |
78 | * arrays are allocated at runtime as the number of descriptors isn't |
79 | * known in advance. |
80 | */ |
81 | struct uvc_descriptor_header **uvc_fs_streaming_cls; |
82 | struct uvc_descriptor_header **uvc_hs_streaming_cls; |
83 | struct uvc_descriptor_header **uvc_ss_streaming_cls; |
84 | |
85 | /* |
86 | * Indexes into the function's string descriptors allowing users to set |
87 | * custom descriptions rather than the hard-coded defaults. |
88 | */ |
89 | u8 iad_index; |
90 | u8 vs0_index; |
91 | u8 vs1_index; |
92 | |
93 | /* |
94 | * Read/write access to configfs attributes is handled by configfs. |
95 | * |
96 | * This lock protects the descriptors from concurrent access by |
97 | * read/write and symlink creation/removal. |
98 | */ |
99 | struct mutex lock; |
100 | int refcnt; |
101 | |
102 | /* |
103 | * Only for legacy gadget. Shall be NULL for configfs-composed gadgets, |
104 | * which is guaranteed by alloc_inst implementation of f_uvc doing kzalloc. |
105 | */ |
106 | struct uvcg_streaming_header *; |
107 | }; |
108 | |
109 | #endif /* U_UVC_H */ |
110 | |