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 *header; 107 }; 108 109 #endif /* U_UVC_H */ 110