110 lines
3.4 KiB
C
110 lines
3.4 KiB
C
/* SPDX-License-Identifier: GPL-2.0 */
|
|
/*
|
|
* u_uvc.h
|
|
*
|
|
* Utility definitions for the uvc function
|
|
*
|
|
* Copyright (c) 2013-2014 Samsung Electronics Co., Ltd.
|
|
* http://www.samsung.com
|
|
*
|
|
* Author: Andrzej Pietrasiewicz <andrzejtp2010@gmail.com>
|
|
*/
|
|
|
|
#ifndef U_UVC_H
|
|
#define U_UVC_H
|
|
|
|
#include <linux/mutex.h>
|
|
#include <linux/usb/composite.h>
|
|
#include <linux/usb/video.h>
|
|
|
|
#define fi_to_f_uvc_opts(f) container_of(f, struct f_uvc_opts, func_inst)
|
|
|
|
struct f_uvc_opts {
|
|
struct usb_function_instance func_inst;
|
|
unsigned int streaming_interval;
|
|
unsigned int streaming_maxpacket;
|
|
unsigned int streaming_maxburst;
|
|
|
|
unsigned int control_interface;
|
|
unsigned int streaming_interface;
|
|
char function_name[32];
|
|
unsigned int last_unit_id;
|
|
|
|
bool enable_interrupt_ep;
|
|
|
|
/*
|
|
* Control descriptors array pointers for full-/high-speed and
|
|
* super-speed. They point by default to the uvc_fs_control_cls and
|
|
* uvc_ss_control_cls arrays respectively. Legacy gadgets must
|
|
* override them in their gadget bind callback.
|
|
*/
|
|
const struct uvc_descriptor_header * const *fs_control;
|
|
const struct uvc_descriptor_header * const *ss_control;
|
|
|
|
/*
|
|
* Streaming descriptors array pointers for full-speed, high-speed and
|
|
* super-speed. They will point to the uvc_[fhs]s_streaming_cls arrays
|
|
* for configfs-based gadgets. Legacy gadgets must initialize them in
|
|
* their gadget bind callback.
|
|
*/
|
|
const struct uvc_descriptor_header * const *fs_streaming;
|
|
const struct uvc_descriptor_header * const *hs_streaming;
|
|
const struct uvc_descriptor_header * const *ss_streaming;
|
|
|
|
/* Default control descriptors for configfs-based gadgets. */
|
|
struct uvc_camera_terminal_descriptor uvc_camera_terminal;
|
|
struct uvc_processing_unit_descriptor uvc_processing;
|
|
struct uvc_output_terminal_descriptor uvc_output_terminal;
|
|
|
|
/*
|
|
* Control descriptors pointers arrays for full-/high-speed and
|
|
* super-speed. The first element is a configurable control header
|
|
* descriptor, the other elements point to the fixed default control
|
|
* descriptors. Used by configfs only, must not be touched by legacy
|
|
* gadgets.
|
|
*/
|
|
struct uvc_descriptor_header *uvc_fs_control_cls[5];
|
|
struct uvc_descriptor_header *uvc_ss_control_cls[5];
|
|
|
|
/*
|
|
* Control descriptors for extension units. There could be any number
|
|
* of these, including none at all.
|
|
*/
|
|
struct list_head extension_units;
|
|
|
|
/*
|
|
* Streaming descriptors for full-speed, high-speed and super-speed.
|
|
* Used by configfs only, must not be touched by legacy gadgets. The
|
|
* arrays are allocated at runtime as the number of descriptors isn't
|
|
* known in advance.
|
|
*/
|
|
struct uvc_descriptor_header **uvc_fs_streaming_cls;
|
|
struct uvc_descriptor_header **uvc_hs_streaming_cls;
|
|
struct uvc_descriptor_header **uvc_ss_streaming_cls;
|
|
|
|
/*
|
|
* Indexes into the function's string descriptors allowing users to set
|
|
* custom descriptions rather than the hard-coded defaults.
|
|
*/
|
|
u8 iad_index;
|
|
u8 vs0_index;
|
|
u8 vs1_index;
|
|
|
|
/*
|
|
* Read/write access to configfs attributes is handled by configfs.
|
|
*
|
|
* This lock protects the descriptors from concurrent access by
|
|
* read/write and symlink creation/removal.
|
|
*/
|
|
struct mutex lock;
|
|
int refcnt;
|
|
|
|
/*
|
|
* Only for legacy gadget. Shall be NULL for configfs-composed gadgets,
|
|
* which is guaranteed by alloc_inst implementation of f_uvc doing kzalloc.
|
|
*/
|
|
struct uvcg_streaming_header *header;
|
|
};
|
|
|
|
#endif /* U_UVC_H */
|