239 lines
13 KiB
C
239 lines
13 KiB
C
/*
|
|
* The MIT License (MIT)
|
|
*
|
|
* Copyright (c) 2020 Jerzy Kasenbreg
|
|
* Copyright (c) 2021 Koji KITAYAMA
|
|
*
|
|
* 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_
|
|
|
|
#define FRAME_WIDTH 128
|
|
#define FRAME_HEIGHT 96
|
|
#define FRAME_RATE 10
|
|
|
|
// NOTE: descriptor template is not used but leave here as reference
|
|
|
|
#define TUD_VIDEO_CAPTURE_DESC_UNCOMPR_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 */\
|
|
)
|
|
|
|
#define TUD_VIDEO_CAPTURE_DESC_MJPEG_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_MJPEG_LEN\
|
|
+ TUD_VIDEO_DESC_CS_VS_FRM_MJPEG_CONT_LEN\
|
|
+ TUD_VIDEO_DESC_CS_VS_COLOR_MATCHING_LEN\
|
|
/* Interface 1, Alternate 1 */\
|
|
+ TUD_VIDEO_DESC_STD_VS_LEN\
|
|
+ 7/* Endpoint */\
|
|
)
|
|
|
|
#define TUD_VIDEO_CAPTURE_DESC_UNCOMPR_BULK_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\
|
|
+ 7/* Endpoint */\
|
|
)
|
|
|
|
#define TUD_VIDEO_CAPTURE_DESC_MJPEG_BULK_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_MJPEG_LEN\
|
|
+ TUD_VIDEO_DESC_CS_VS_FRM_MJPEG_CONT_LEN\
|
|
+ TUD_VIDEO_DESC_CS_VS_COLOR_MATCHING_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_UNCOMPR(_stridx, _epin, _width, _height, _fps, _epsize) \
|
|
TUD_VIDEO_DESC_IAD(ITF_NUM_VIDEO_CONTROL, /* 2 Interfaces */ 0x02, _stridx), \
|
|
/* Video control 0 */ \
|
|
TUD_VIDEO_DESC_STD_VC(ITF_NUM_VIDEO_CONTROL, 0, _stridx), \
|
|
/* Header: UVC 1.5, length of followed descs, clock (deprecated), streaming interfaces */ \
|
|
TUD_VIDEO_DESC_CS_VC(0x0150, TUD_VIDEO_DESC_CAMERA_TERM_LEN + TUD_VIDEO_DESC_OUTPUT_TERM_LEN, UVC_CLOCK_FREQUENCY, ITF_NUM_VIDEO_STREAMING), \
|
|
/* Camera Terminal: ID, bAssocTerminal, iTerminal, focal min, max, length, bmControl */ \
|
|
TUD_VIDEO_DESC_CAMERA_TERM(UVC_ENTITY_CAP_INPUT_TERMINAL, 0, 0, 0, 0, 0, 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(ITF_NUM_VIDEO_STREAMING, 0, 0, _stridx), \
|
|
/* 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 / 8, \
|
|
(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(ITF_NUM_VIDEO_STREAMING, 1, 1, _stridx), \
|
|
/* EP */ \
|
|
TUD_VIDEO_DESC_EP_ISO(_epin, _epsize, 1)
|
|
|
|
#define TUD_VIDEO_CAPTURE_DESCRIPTOR_MJPEG(_stridx, _epin, _width, _height, _fps, _epsize) \
|
|
TUD_VIDEO_DESC_IAD(ITF_NUM_VIDEO_CONTROL, /* 2 Interfaces */ 0x02, _stridx), \
|
|
/* Video control 0 */ \
|
|
TUD_VIDEO_DESC_STD_VC(ITF_NUM_VIDEO_CONTROL, 0, _stridx), \
|
|
/* Header: UVC 1.5, length of followed descs, clock (deprecated), streaming interfaces */ \
|
|
TUD_VIDEO_DESC_CS_VC(0x0150, TUD_VIDEO_DESC_CAMERA_TERM_LEN + TUD_VIDEO_DESC_OUTPUT_TERM_LEN, UVC_CLOCK_FREQUENCY, ITF_NUM_VIDEO_STREAMING), \
|
|
/* Camera Terminal: ID, bAssocTerminal, iTerminal, focal min, max, length, bmControl */ \
|
|
TUD_VIDEO_DESC_CAMERA_TERM(UVC_ENTITY_CAP_INPUT_TERMINAL, 0, 0, 0, 0, 0, 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(ITF_NUM_VIDEO_STREAMING, 0, 0, _stridx), \
|
|
/* Video stream header for without still image capture */ \
|
|
TUD_VIDEO_DESC_CS_VS_INPUT( /*bNumFormats*/1, \
|
|
/*wTotalLength - bLength */ TUD_VIDEO_DESC_CS_VS_FMT_MJPEG_LEN + TUD_VIDEO_DESC_CS_VS_FRM_MJPEG_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_MJPEG(/*bFormatIndex*/1, /*bNumFrameDescriptors*/1, \
|
|
/*bmFlags*/0, /*bDefaultFrameIndex*/1, 0, 0, 0, /*bCopyProtect*/0), \
|
|
/* Video stream frame format */ \
|
|
TUD_VIDEO_DESC_CS_VS_FRM_MJPEG_CONT(/*bFrameIndex */1, 0, _width, _height, \
|
|
_width * _height * 16, _width * _height * 16 * _fps, \
|
|
_width * _height * 16 / 8, \
|
|
(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(ITF_NUM_VIDEO_STREAMING, 1, 1, _stridx), \
|
|
/* EP */ \
|
|
TUD_VIDEO_DESC_EP_ISO(_epin, _epsize, 1)
|
|
|
|
|
|
#define TUD_VIDEO_CAPTURE_DESCRIPTOR_UNCOMPR_BULK(_stridx, _epin, _width, _height, _fps, _epsize) \
|
|
TUD_VIDEO_DESC_IAD(ITF_NUM_VIDEO_CONTROL, /* 2 Interfaces */ 0x02, _stridx), \
|
|
/* Video control 0 */ \
|
|
TUD_VIDEO_DESC_STD_VC(ITF_NUM_VIDEO_CONTROL, 0, _stridx), \
|
|
/* Header: UVC 1.5, length of followed descs, clock (deprecated), streaming interfaces */ \
|
|
TUD_VIDEO_DESC_CS_VC(0x0150, TUD_VIDEO_DESC_CAMERA_TERM_LEN + TUD_VIDEO_DESC_OUTPUT_TERM_LEN, UVC_CLOCK_FREQUENCY, ITF_NUM_VIDEO_STREAMING), \
|
|
/* Camera Terminal: ID, bAssocTerminal, iTerminal, focal min, max, length, bmControl */ \
|
|
TUD_VIDEO_DESC_CAMERA_TERM(UVC_ENTITY_CAP_INPUT_TERMINAL, 0, 0, 0, 0, 0, 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(ITF_NUM_VIDEO_STREAMING, 0, 1, _stridx), \
|
|
/* 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 / 8, \
|
|
(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), \
|
|
TUD_VIDEO_DESC_EP_BULK(_epin, _epsize, 1)
|
|
|
|
#define TUD_VIDEO_CAPTURE_DESCRIPTOR_MJPEG_BULK(_stridx, _epin, _width, _height, _fps, _epsize) \
|
|
TUD_VIDEO_DESC_IAD(ITF_NUM_VIDEO_CONTROL, /* 2 Interfaces */ 0x02, _stridx), \
|
|
/* Video control 0 */ \
|
|
TUD_VIDEO_DESC_STD_VC(ITF_NUM_VIDEO_CONTROL, 0, _stridx), \
|
|
/* Header: UVC 1.5, length of followed descs, clock (deprecated), streaming interfaces */ \
|
|
TUD_VIDEO_DESC_CS_VC(0x0150, TUD_VIDEO_DESC_CAMERA_TERM_LEN + TUD_VIDEO_DESC_OUTPUT_TERM_LEN, UVC_CLOCK_FREQUENCY, ITF_NUM_VIDEO_STREAMING), \
|
|
/* Camera Terminal: ID, bAssocTerminal, iTerminal, focal min, max, length, bmControl */ \
|
|
TUD_VIDEO_DESC_CAMERA_TERM(UVC_ENTITY_CAP_INPUT_TERMINAL, 0, 0, 0, 0, 0, 0), \
|
|
TUD_VIDEO_DESC_OUTPUT_TERM(UVC_ENTITY_CAP_OUTPUT_TERMINAL, VIDEO_TT_STREAMING, 0, UVC_ENTITY_CAP_INPUT_TERMINAL, 0), \
|
|
/* Video stream alt. 0 */ \
|
|
TUD_VIDEO_DESC_STD_VS(ITF_NUM_VIDEO_STREAMING, 0, 1, _stridx), \
|
|
/* Video stream header for without still image capture */ \
|
|
TUD_VIDEO_DESC_CS_VS_INPUT( /*bNumFormats*/1, \
|
|
/*wTotalLength - bLength */ TUD_VIDEO_DESC_CS_VS_FMT_MJPEG_LEN + TUD_VIDEO_DESC_CS_VS_FRM_MJPEG_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_MJPEG(/*bFormatIndex*/1, /*bNumFrameDescriptors*/1, \
|
|
/*bmFlags*/0, /*bDefaultFrameIndex*/1, 0, 0, 0, /*bCopyProtect*/0), \
|
|
/* Video stream frame format */ \
|
|
TUD_VIDEO_DESC_CS_VS_FRM_MJPEG_CONT(/*bFrameIndex */1, 0, _width, _height, \
|
|
_width * _height * 16, _width * _height * 16 * _fps, \
|
|
_width * _height * 16 / 8, \
|
|
(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), \
|
|
/* EP */ \
|
|
TUD_VIDEO_DESC_EP_BULK(_epin, _epsize, 1)
|
|
|
|
|
|
#endif
|