123 lines
7.3 KiB
C
123 lines
7.3 KiB
C
|
/*
|
||
|
|
* The MIT License (MIT)
|
||
|
|
*
|
||
|
|
* Copyright (c) 2020 Jerzy Kasenbreg
|
||
|
|
* Copyright (c) 2021 Koji KITAYAMA
|
||
|
|
* Copyright (c) 2022 Charles Kralapp (alfrescocavern.com)
|
||
|
|
*
|
||
|
|
* Permission is hereby granted, free of charge, to any person obtaining a copy
|
||
|
|
* of this software and associated documentation files (the "Software"), to deal
|
||
|
|
* in the Software without restriction, including without limitation the rights
|
||
|
|
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||
|
|
* copies of the Software, and to permit persons to whom the Software is
|
||
|
|
* furnished to do so, subject to the following conditions:
|
||
|
|
*
|
||
|
|
* The above copyright notice and this permission notice shall be included in
|
||
|
|
* all copies or substantial portions of the Software.
|
||
|
|
*
|
||
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||
|
|
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||
|
|
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||
|
|
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||
|
|
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||
|
|
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
||
|
|
* THE SOFTWARE.
|
||
|
|
*
|
||
|
|
*/
|
||
|
|
|
||
|
|
#ifndef _USB_DESCRIPTORS_H_
|
||
|
|
#define _USB_DESCRIPTORS_H_
|
||
|
|
|
||
|
|
/* Time stamp base clock. It is a deprecated parameter. */
|
||
|
|
#define UVC_CLOCK_FREQUENCY 27000000
|
||
|
|
/* video capture path */
|
||
|
|
#define UVC_ENTITY_CAP_INPUT_TERMINAL 0x01
|
||
|
|
#define UVC_ENTITY_CAP_OUTPUT_TERMINAL 0x02
|
||
|
|
|
||
|
|
#define FRAME_WIDTH 96
|
||
|
|
#define FRAME_HEIGHT 96
|
||
|
|
#define FRAME_RATE 30
|
||
|
|
|
||
|
|
enum { ITF_NUM_VIDEO_CONTROL = 0, ITF_NUM_VIDEO_STREAMING, ITF_NUM_TOTAL };
|
||
|
|
|
||
|
|
#define TUD_VIDEO_CAPTURE_DESC_LEN \
|
||
|
|
(TUD_VIDEO_DESC_IAD_LEN /* control */ \
|
||
|
|
+ TUD_VIDEO_DESC_STD_VC_LEN + \
|
||
|
|
(TUD_VIDEO_DESC_CS_VC_LEN + 1 /*bInCollection*/) + \
|
||
|
|
TUD_VIDEO_DESC_CAMERA_TERM_LEN + \
|
||
|
|
TUD_VIDEO_DESC_OUTPUT_TERM_LEN /* Interface 1, Alternate 0 */ \
|
||
|
|
+ TUD_VIDEO_DESC_STD_VS_LEN + \
|
||
|
|
(TUD_VIDEO_DESC_CS_VS_IN_LEN + 1 /*bNumFormats x bControlSize*/) + \
|
||
|
|
TUD_VIDEO_DESC_CS_VS_FMT_UNCOMPR_LEN + \
|
||
|
|
TUD_VIDEO_DESC_CS_VS_FRM_UNCOMPR_CONT_LEN + \
|
||
|
|
TUD_VIDEO_DESC_CS_VS_COLOR_MATCHING_LEN /* Interface 1, Alternate 1 */ \
|
||
|
|
+ TUD_VIDEO_DESC_STD_VS_LEN + 7 /* Endpoint */ \
|
||
|
|
)
|
||
|
|
|
||
|
|
/* Windows support YUY2 and NV12
|
||
|
|
* https://docs.microsoft.com/en-us/windows-hardware/drivers/stream/usb-video-class-driver-overview
|
||
|
|
*/
|
||
|
|
|
||
|
|
#define TUD_VIDEO_DESC_CS_VS_FMT_YUY2(_fmtidx, _numfmtdesc, _frmidx, _asrx, \
|
||
|
|
_asry, _interlace, _cp) \
|
||
|
|
TUD_VIDEO_DESC_CS_VS_FMT_UNCOMPR(_fmtidx, _numfmtdesc, TUD_VIDEO_GUID_YUY2, \
|
||
|
|
16, _frmidx, _asrx, _asry, _interlace, _cp)
|
||
|
|
#define TUD_VIDEO_DESC_CS_VS_FMT_NV12(_fmtidx, _numfmtdesc, _frmidx, _asrx, \
|
||
|
|
_asry, _interlace, _cp) \
|
||
|
|
TUD_VIDEO_DESC_CS_VS_FMT_UNCOMPR(_fmtidx, _numfmtdesc, TUD_VIDEO_GUID_NV12, \
|
||
|
|
12, _frmidx, _asrx, _asry, _interlace, _cp)
|
||
|
|
#define TUD_VIDEO_DESC_CS_VS_FMT_M420(_fmtidx, _numfmtdesc, _frmidx, _asrx, \
|
||
|
|
_asry, _interlace, _cp) \
|
||
|
|
TUD_VIDEO_DESC_CS_VS_FMT_UNCOMPR(_fmtidx, _numfmtdesc, TUD_VIDEO_GUID_M420, \
|
||
|
|
12, _frmidx, _asrx, _asry, _interlace, _cp)
|
||
|
|
#define TUD_VIDEO_DESC_CS_VS_FMT_I420(_fmtidx, _numfmtdesc, _frmidx, _asrx, \
|
||
|
|
_asry, _interlace, _cp) \
|
||
|
|
TUD_VIDEO_DESC_CS_VS_FMT_UNCOMPR(_fmtidx, _numfmtdesc, TUD_VIDEO_GUID_I420, \
|
||
|
|
12, _frmidx, _asrx, _asry, _interlace, _cp)
|
||
|
|
|
||
|
|
#define TUD_VIDEO_CAPTURE_DESCRIPTOR(_stridx, _epin, _width, _height, _fps, \
|
||
|
|
_epsize) \
|
||
|
|
TUD_VIDEO_DESC_IAD(ITF_NUM_VIDEO_CONTROL, ITF_NUM_TOTAL, \
|
||
|
|
_stridx), /* Video control 0 */ \
|
||
|
|
TUD_VIDEO_DESC_STD_VC(ITF_NUM_VIDEO_CONTROL, 0, _stridx), \
|
||
|
|
TUD_VIDEO_DESC_CS_VC(/* UVC 1.5*/ 0x0150, /* wTotalLength - bLength */ \
|
||
|
|
TUD_VIDEO_DESC_CAMERA_TERM_LEN + \
|
||
|
|
TUD_VIDEO_DESC_OUTPUT_TERM_LEN, \
|
||
|
|
UVC_CLOCK_FREQUENCY, 1), \
|
||
|
|
TUD_VIDEO_DESC_CAMERA_TERM( \
|
||
|
|
UVC_ENTITY_CAP_INPUT_TERMINAL, 0, 0, /*wObjectiveFocalLengthMin*/ 0, \
|
||
|
|
/*wObjectiveFocalLengthMax*/ 0, /*wObjectiveFocalLength*/ 0, \
|
||
|
|
/*bmControls*/ 0), \
|
||
|
|
TUD_VIDEO_DESC_OUTPUT_TERM(UVC_ENTITY_CAP_OUTPUT_TERMINAL, \
|
||
|
|
VIDEO_TT_STREAMING, 0, 1, \
|
||
|
|
0), /* Video stream alt. 0 */ \
|
||
|
|
TUD_VIDEO_DESC_STD_VS( \
|
||
|
|
1, 0, 0, \
|
||
|
|
0), /* Video stream header for without still image capture */ \
|
||
|
|
TUD_VIDEO_DESC_CS_VS_INPUT( \
|
||
|
|
/*bNumFormats*/ 1, /*wTotalLength - bLength */ \
|
||
|
|
TUD_VIDEO_DESC_CS_VS_FMT_UNCOMPR_LEN + \
|
||
|
|
TUD_VIDEO_DESC_CS_VS_FRM_UNCOMPR_CONT_LEN + \
|
||
|
|
TUD_VIDEO_DESC_CS_VS_COLOR_MATCHING_LEN, \
|
||
|
|
_epin, /*bmInfo*/ 0, \
|
||
|
|
/*bTerminalLink*/ UVC_ENTITY_CAP_OUTPUT_TERMINAL, \
|
||
|
|
/*bStillCaptureMethod*/ 0, /*bTriggerSupport*/ 0, \
|
||
|
|
/*bTriggerUsage*/ 0, \
|
||
|
|
/*bmaControls(1)*/ 0), /* Video stream format */ \
|
||
|
|
TUD_VIDEO_DESC_CS_VS_FMT_YUY2( \
|
||
|
|
/*bFormatIndex*/ 1, /*bNumFrameDescriptors*/ 1, \
|
||
|
|
/*bDefaultFrameIndex*/ 1, 0, 0, 0, \
|
||
|
|
/*bCopyProtect*/ 0), /* Video stream frame format */ \
|
||
|
|
TUD_VIDEO_DESC_CS_VS_FRM_UNCOMPR_CONT( \
|
||
|
|
/*bFrameIndex */ 1, 0, _width, _height, _width *_height * 16, \
|
||
|
|
_width * _height * 16 * _fps, _width * _height * 16, \
|
||
|
|
(10000000 / _fps), (10000000 / _fps), (10000000 / _fps) * _fps, \
|
||
|
|
(10000000 / _fps)), \
|
||
|
|
TUD_VIDEO_DESC_CS_VS_COLOR_MATCHING( \
|
||
|
|
VIDEO_COLOR_PRIMARIES_BT709, VIDEO_COLOR_XFER_CH_BT709, \
|
||
|
|
VIDEO_COLOR_COEF_SMPTE170M), /* VS alt 1 */ \
|
||
|
|
TUD_VIDEO_DESC_STD_VS(1, 1, 1, 0), /* EP */ \
|
||
|
|
TUD_VIDEO_DESC_EP_ISO(_epin, _epsize, 1)
|
||
|
|
|
||
|
|
#endif
|