linux-vybrid_public/drivers/usb/gadget/f_uvc.h

/*
 *	f_uvc.h  --  USB Video Class Gadget driver
 *
 *	Copyright (C) 2009-2010
 *	    Laurent Pinchart (laurent.pinchart@ideasonboard.com)
 *
 *	This program is free software; you can redistribute it and/or modify
 *	it under the terms of the GNU General Public License as published by
 *	the Free Software Foundation; either version 2 of the License, or
 *	(at your option) any later version.
 *
 */

#ifndef _F_UVC_H_
#define _F_UVC_H_

#include <linux/usb/composite.h>

#define USB_CLASS_VIDEO_CONTROL		1
#define USB_CLASS_VIDEO_STREAMING	2

struct uvc_descriptor_header {
	__u8  bLength;
	__u8  bDescriptorType;
	__u8  bDescriptorSubType;
} __attribute__ ((packed));

struct uvc_header_descriptor {
	__u8  bLength;
	__u8  bDescriptorType;
	__u8  bDescriptorSubType;
	__u16 bcdUVC;
	__u16 wTotalLength;
	__u32 dwClockFrequency;
	__u8  bInCollection;
	__u8  baInterfaceNr[];
} __attribute__((__packed__));

#define UVC_HEADER_DESCRIPTOR(n)	uvc_header_descriptor_##n

#define DECLARE_UVC_HEADER_DESCRIPTOR(n) 			\
struct UVC_HEADER_DESCRIPTOR(n) {				\
	__u8  bLength;						\
	__u8  bDescriptorType;					\
	__u8  bDescriptorSubType;				\
	__u16 bcdUVC;						\
	__u16 wTotalLength;					\
	__u32 dwClockFrequency;					\
	__u8  bInCollection;					\
	__u8  baInterfaceNr[n];					\
} __attribute__ ((packed))

struct uvc_input_terminal_descriptor {
	__u8  bLength;
	__u8  bDescriptorType;
	__u8  bDescriptorSubType;
	__u8  bTerminalID;
	__u16 wTerminalType;
	__u8  bAssocTerminal;
	__u8  iTerminal;
} __attribute__((__packed__));

struct uvc_output_terminal_descriptor {
	__u8  bLength;
	__u8  bDescriptorType;
	__u8  bDescriptorSubType;
	__u8  bTerminalID;
	__u16 wTerminalType;
	__u8  bAssocTerminal;
	__u8  bSourceID;
	__u8  iTerminal;
} __attribute__((__packed__));

struct uvc_camera_terminal_descriptor {
	__u8  bLength;
	__u8  bDescriptorType;
	__u8  bDescriptorSubType;
	__u8  bTerminalID;
	__u16 wTerminalType;
	__u8  bAssocTerminal;
	__u8  iTerminal;
	__u16 wObjectiveFocalLengthMin;
	__u16 wObjectiveFocalLengthMax;
	__u16 wOcularFocalLength;
	__u8  bControlSize;
	__u8  bmControls[3];
} __attribute__((__packed__));

struct uvc_selector_unit_descriptor {
	__u8  bLength;
	__u8  bDescriptorType;
	__u8  bDescriptorSubType;
	__u8  bUnitID;
	__u8  bNrInPins;
	__u8  baSourceID[0];
	__u8  iSelector;
} __attribute__((__packed__));

#define UVC_SELECTOR_UNIT_DESCRIPTOR(n)	\
	uvc_selector_unit_descriptor_##n

#define DECLARE_UVC_SELECTOR_UNIT_DESCRIPTOR(n) 		\
struct UVC_SELECTOR_UNIT_DESCRIPTOR(n) {			\
	__u8  bLength;						\
	__u8  bDescriptorType;					\
	__u8  bDescriptorSubType;				\
	__u8  bUnitID;						\
	__u8  bNrInPins;					\
	__u8  baSourceID[n];					\
	__u8  iSelector;					\
} __attribute__ ((packed))

struct uvc_processing_unit_descriptor {
	__u8  bLength;
	__u8  bDescriptorType;
	__u8  bDescriptorSubType;
	__u8  bUnitID;
	__u8  bSourceID;
	__u16 wMaxMultiplier;
	__u8  bControlSize;
	__u8  bmControls[2];
	__u8  iProcessing;
} __attribute__((__packed__));

struct uvc_extension_unit_descriptor {
	__u8  bLength;
	__u8  bDescriptorType;
	__u8  bDescriptorSubType;
	__u8  bUnitID;
	__u8  guidExtensionCode[16];
	__u8  bNumControls;
	__u8  bNrInPins;
	__u8  baSourceID[0];
	__u8  bControlSize;
	__u8  bmControls[0];
	__u8  iExtension;
} __attribute__((__packed__));

#define UVC_EXTENSION_UNIT_DESCRIPTOR(p, n) \
	uvc_extension_unit_descriptor_##p_##n

#define DECLARE_UVC_EXTENSION_UNIT_DESCRIPTOR(p, n) 		\
struct UVC_EXTENSION_UNIT_DESCRIPTOR(p, n) {			\
	__u8  bLength;						\
	__u8  bDescriptorType;					\
	__u8  bDescriptorSubType;				\
	__u8  bUnitID;						\
	__u8  guidExtensionCode[16];				\
	__u8  bNumControls;					\
	__u8  bNrInPins;					\
	__u8  baSourceID[p];					\
	__u8  bControlSize;					\
	__u8  bmControls[n];					\
	__u8  iExtension;					\
} __attribute__ ((packed))

struct uvc_control_endpoint_descriptor {
	__u8  bLength;
	__u8  bDescriptorType;
	__u8  bDescriptorSubType;
	__u16 wMaxTransferSize;
} __attribute__((__packed__));

#define UVC_DT_HEADER				1
#define UVC_DT_INPUT_TERMINAL			2
#define UVC_DT_OUTPUT_TERMINAL			3
#define UVC_DT_SELECTOR_UNIT			4
#define UVC_DT_PROCESSING_UNIT			5
#define UVC_DT_EXTENSION_UNIT			6

#define UVC_DT_HEADER_SIZE(n)			(12+(n))
#define UVC_DT_INPUT_TERMINAL_SIZE		8
#define UVC_DT_OUTPUT_TERMINAL_SIZE		9
#define UVC_DT_CAMERA_TERMINAL_SIZE(n)		(15+(n))
#define UVC_DT_SELECTOR_UNIT_SIZE(n)		(6+(n))
#define UVC_DT_PROCESSING_UNIT_SIZE(n)		(9+(n))
#define UVC_DT_EXTENSION_UNIT_SIZE(p,n)		(24+(p)+(n))
#define UVC_DT_CONTROL_ENDPOINT_SIZE		5

struct uvc_input_header_descriptor {
	__u8  bLength;
	__u8  bDescriptorType;
	__u8  bDescriptorSubType;
	__u8  bNumFormats;
	__u16 wTotalLength;
	__u8  bEndpointAddress;
	__u8  bmInfo;
	__u8  bTerminalLink;
	__u8  bStillCaptureMethod;
	__u8  bTriggerSupport;
	__u8  bTriggerUsage;
	__u8  bControlSize;
	__u8  bmaControls[];
} __attribute__((__packed__));

#define UVC_INPUT_HEADER_DESCRIPTOR(n, p) \
	uvc_input_header_descriptor_##n_##p

#define DECLARE_UVC_INPUT_HEADER_DESCRIPTOR(n, p)		\
struct UVC_INPUT_HEADER_DESCRIPTOR(n, p) {			\
	__u8  bLength;						\
	__u8  bDescriptorType;					\
	__u8  bDescriptorSubType;				\
	__u8  bNumFormats;					\
	__u16 wTotalLength;					\
	__u8  bEndpointAddress;					\
	__u8  bmInfo;						\
	__u8  bTerminalLink;					\
	__u8  bStillCaptureMethod;				\
	__u8  bTriggerSupport;					\
	__u8  bTriggerUsage;					\
	__u8  bControlSize;					\
	__u8  bmaControls[p][n];				\
} __attribute__ ((packed))

struct uvc_output_header_descriptor {
	__u8  bLength;
	__u8  bDescriptorType;
	__u8  bDescriptorSubType;
	__u8  bNumFormats;
	__u16 wTotalLength;
	__u8  bEndpointAddress;
	__u8  bTerminalLink;
	__u8  bControlSize;
	__u8  bmaControls[];
} __attribute__((__packed__));

#define UVC_OUTPUT_HEADER_DESCRIPTOR(n, p) \
	uvc_output_header_descriptor_##n_##p

#define DECLARE_UVC_OUTPUT_HEADER_DESCRIPTOR(n, p)		\
struct UVC_OUTPUT_HEADER_DESCRIPTOR(n, p) {			\
	__u8  bLength;						\
	__u8  bDescriptorType;					\
	__u8  bDescriptorSubType;				\
	__u8  bNumFormats;					\
	__u16 wTotalLength;					\
	__u8  bEndpointAddress;					\
	__u8  bTerminalLink;					\
	__u8  bControlSize;					\
	__u8  bmaControls[p][n];				\
} __attribute__ ((packed))

struct uvc_format_uncompressed {
	__u8  bLength;
	__u8  bDescriptorType;
	__u8  bDescriptorSubType;
	__u8  bFormatIndex;
	__u8  bNumFrameDescriptors;
	__u8  guidFormat[16];
	__u8  bBitsPerPixel;
	__u8  bDefaultFrameIndex;
	__u8  bAspectRatioX;
	__u8  bAspectRatioY;
	__u8  bmInterfaceFlags;
	__u8  bCopyProtect;
} __attribute__((__packed__));

struct uvc_frame_uncompressed {
	__u8  bLength;
	__u8  bDescriptorType;
	__u8  bDescriptorSubType;
	__u8  bFrameIndex;
	__u8  bmCapabilities;
	__u16 wWidth;
	__u16 wHeight;
	__u32 dwMinBitRate;
	__u32 dwMaxBitRate;
	__u32 dwMaxVideoFrameBufferSize;
	__u32 dwDefaultFrameInterval;
	__u8  bFrameIntervalType;
	__u32 dwFrameInterval[];
} __attribute__((__packed__));

#define UVC_FRAME_UNCOMPRESSED(n) \
	uvc_frame_uncompressed_##n

#define DECLARE_UVC_FRAME_UNCOMPRESSED(n) 			\
struct UVC_FRAME_UNCOMPRESSED(n) {				\
	__u8  bLength;						\
	__u8  bDescriptorType;					\
	__u8  bDescriptorSubType;				\
	__u8  bFrameIndex;					\
	__u8  bmCapabilities;					\
	__u16 wWidth;						\
	__u16 wHeight;						\
	__u32 dwMinBitRate;					\
	__u32 dwMaxBitRate;					\
	__u32 dwMaxVideoFrameBufferSize;			\
	__u32 dwDefaultFrameInterval;				\
	__u8  bFrameIntervalType;				\
	__u32 dwFrameInterval[n];				\
} __attribute__ ((packed))

struct uvc_format_mjpeg {
	__u8  bLength;
	__u8  bDescriptorType;
	__u8  bDescriptorSubType;
	__u8  bFormatIndex;
	__u8  bNumFrameDescriptors;
	__u8  bmFlags;
	__u8  bDefaultFrameIndex;
	__u8  bAspectRatioX;
	__u8  bAspectRatioY;
	__u8  bmInterfaceFlags;
	__u8  bCopyProtect;
} __attribute__((__packed__));

struct uvc_frame_mjpeg {
	__u8  bLength;
	__u8  bDescriptorType;
	__u8  bDescriptorSubType;
	__u8  bFrameIndex;
	__u8  bmCapabilities;
	__u16 wWidth;
	__u16 wHeight;
	__u32 dwMinBitRate;
	__u32 dwMaxBitRate;
	__u32 dwMaxVideoFrameBufferSize;
	__u32 dwDefaultFrameInterval;
	__u8  bFrameIntervalType;
	__u32 dwFrameInterval[];
} __attribute__((__packed__));

#define UVC_FRAME_MJPEG(n) \
	uvc_frame_mjpeg_##n

#define DECLARE_UVC_FRAME_MJPEG(n) 				\
struct UVC_FRAME_MJPEG(n) {					\
	__u8  bLength;						\
	__u8  bDescriptorType;					\
	__u8  bDescriptorSubType;				\
	__u8  bFrameIndex;					\
	__u8  bmCapabilities;					\
	__u16 wWidth;						\
	__u16 wHeight;						\
	__u32 dwMinBitRate;					\
	__u32 dwMaxBitRate;					\
	__u32 dwMaxVideoFrameBufferSize;			\
	__u32 dwDefaultFrameInterval;				\
	__u8  bFrameIntervalType;				\
	__u32 dwFrameInterval[n];				\
} __attribute__ ((packed))

struct uvc_color_matching_descriptor {
	__u8  bLength;
	__u8  bDescriptorType;
	__u8  bDescriptorSubType;
	__u8  bColorPrimaries;
	__u8  bTransferCharacteristics;
	__u8  bMatrixCoefficients;
} __attribute__((__packed__));

#define UVC_DT_INPUT_HEADER			1
#define UVC_DT_OUTPUT_HEADER			2
#define UVC_DT_FORMAT_UNCOMPRESSED		4
#define UVC_DT_FRAME_UNCOMPRESSED		5
#define UVC_DT_FORMAT_MJPEG			6
#define UVC_DT_FRAME_MJPEG			7
#define UVC_DT_COLOR_MATCHING			13

#define UVC_DT_INPUT_HEADER_SIZE(n, p)		(13+(n*p))
#define UVC_DT_OUTPUT_HEADER_SIZE(n, p)		(9+(n*p))
#define UVC_DT_FORMAT_UNCOMPRESSED_SIZE		27
#define UVC_DT_FRAME_UNCOMPRESSED_SIZE(n)	(26+4*(n))
#define UVC_DT_FORMAT_MJPEG_SIZE		11
#define UVC_DT_FRAME_MJPEG_SIZE(n)		(26+4*(n))
#define UVC_DT_COLOR_MATCHING_SIZE		6

extern int uvc_bind_config(struct usb_configuration *c,
			   const struct uvc_descriptor_header * const *control,
			   const struct uvc_descriptor_header * const *fs_streaming,
			   const struct uvc_descriptor_header * const *hs_streaming);

#endif /* _F_UVC_H_ */