| /* SPDX-License-Identifier: GPL-2.0-or-later */ |
| /* |
| * v4l2 uvc internal API header |
| * |
| * Some commonly needed functions for uvc drivers |
| */ |
| |
| #ifndef __LINUX_V4L2_UVC_H |
| #define __LINUX_V4L2_UVC_H |
| |
| /* ------------------------------------------------------------------------ |
| * GUIDs |
| */ |
| #define UVC_GUID_UVC_CAMERA \ |
| {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, \ |
| 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x01} |
| #define UVC_GUID_UVC_OUTPUT \ |
| {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, \ |
| 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02} |
| #define UVC_GUID_UVC_MEDIA_TRANSPORT_INPUT \ |
| {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, \ |
| 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x03} |
| #define UVC_GUID_UVC_PROCESSING \ |
| {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, \ |
| 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x01, 0x01} |
| #define UVC_GUID_UVC_SELECTOR \ |
| {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, \ |
| 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x01, 0x02} |
| #define UVC_GUID_EXT_GPIO_CONTROLLER \ |
| {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, \ |
| 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x01, 0x03} |
| |
| #define UVC_GUID_FORMAT_MJPEG \ |
| { 'M', 'J', 'P', 'G', 0x00, 0x00, 0x10, 0x00, \ |
| 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71} |
| #define UVC_GUID_FORMAT_YUY2 \ |
| { 'Y', 'U', 'Y', '2', 0x00, 0x00, 0x10, 0x00, \ |
| 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71} |
| #define UVC_GUID_FORMAT_YUY2_ISIGHT \ |
| { 'Y', 'U', 'Y', '2', 0x00, 0x00, 0x10, 0x00, \ |
| 0x80, 0x00, 0x00, 0x00, 0x00, 0x38, 0x9b, 0x71} |
| #define UVC_GUID_FORMAT_NV12 \ |
| { 'N', 'V', '1', '2', 0x00, 0x00, 0x10, 0x00, \ |
| 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71} |
| #define UVC_GUID_FORMAT_YV12 \ |
| { 'Y', 'V', '1', '2', 0x00, 0x00, 0x10, 0x00, \ |
| 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71} |
| #define UVC_GUID_FORMAT_I420 \ |
| { 'I', '4', '2', '0', 0x00, 0x00, 0x10, 0x00, \ |
| 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71} |
| #define UVC_GUID_FORMAT_UYVY \ |
| { 'U', 'Y', 'V', 'Y', 0x00, 0x00, 0x10, 0x00, \ |
| 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71} |
| #define UVC_GUID_FORMAT_Y800 \ |
| { 'Y', '8', '0', '0', 0x00, 0x00, 0x10, 0x00, \ |
| 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71} |
| #define UVC_GUID_FORMAT_Y8 \ |
| { 'Y', '8', ' ', ' ', 0x00, 0x00, 0x10, 0x00, \ |
| 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71} |
| #define UVC_GUID_FORMAT_Y10 \ |
| { 'Y', '1', '0', ' ', 0x00, 0x00, 0x10, 0x00, \ |
| 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71} |
| #define UVC_GUID_FORMAT_Y12 \ |
| { 'Y', '1', '2', ' ', 0x00, 0x00, 0x10, 0x00, \ |
| 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71} |
| #define UVC_GUID_FORMAT_Y16 \ |
| { 'Y', '1', '6', ' ', 0x00, 0x00, 0x10, 0x00, \ |
| 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71} |
| #define UVC_GUID_FORMAT_BY8 \ |
| { 'B', 'Y', '8', ' ', 0x00, 0x00, 0x10, 0x00, \ |
| 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71} |
| #define UVC_GUID_FORMAT_BA81 \ |
| { 'B', 'A', '8', '1', 0x00, 0x00, 0x10, 0x00, \ |
| 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71} |
| #define UVC_GUID_FORMAT_GBRG \ |
| { 'G', 'B', 'R', 'G', 0x00, 0x00, 0x10, 0x00, \ |
| 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71} |
| #define UVC_GUID_FORMAT_GRBG \ |
| { 'G', 'R', 'B', 'G', 0x00, 0x00, 0x10, 0x00, \ |
| 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71} |
| #define UVC_GUID_FORMAT_RGGB \ |
| { 'R', 'G', 'G', 'B', 0x00, 0x00, 0x10, 0x00, \ |
| 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71} |
| #define UVC_GUID_FORMAT_BG16 \ |
| { 'B', 'G', '1', '6', 0x00, 0x00, 0x10, 0x00, \ |
| 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71} |
| #define UVC_GUID_FORMAT_GB16 \ |
| { 'G', 'B', '1', '6', 0x00, 0x00, 0x10, 0x00, \ |
| 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71} |
| #define UVC_GUID_FORMAT_RG16 \ |
| { 'R', 'G', '1', '6', 0x00, 0x00, 0x10, 0x00, \ |
| 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71} |
| #define UVC_GUID_FORMAT_GR16 \ |
| { 'G', 'R', '1', '6', 0x00, 0x00, 0x10, 0x00, \ |
| 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71} |
| #define UVC_GUID_FORMAT_RGBP \ |
| { 'R', 'G', 'B', 'P', 0x00, 0x00, 0x10, 0x00, \ |
| 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71} |
| #define UVC_GUID_FORMAT_BGR3 \ |
| { 0x7d, 0xeb, 0x36, 0xe4, 0x4f, 0x52, 0xce, 0x11, \ |
| 0x9f, 0x53, 0x00, 0x20, 0xaf, 0x0b, 0xa7, 0x70} |
| #define UVC_GUID_FORMAT_M420 \ |
| { 'M', '4', '2', '0', 0x00, 0x00, 0x10, 0x00, \ |
| 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71} |
| |
| #define UVC_GUID_FORMAT_H264 \ |
| { 'H', '2', '6', '4', 0x00, 0x00, 0x10, 0x00, \ |
| 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71} |
| #define UVC_GUID_FORMAT_H265 \ |
| { 'H', '2', '6', '5', 0x00, 0x00, 0x10, 0x00, \ |
| 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71} |
| #define UVC_GUID_FORMAT_Y8I \ |
| { 'Y', '8', 'I', ' ', 0x00, 0x00, 0x10, 0x00, \ |
| 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71} |
| #define UVC_GUID_FORMAT_Y12I \ |
| { 'Y', '1', '2', 'I', 0x00, 0x00, 0x10, 0x00, \ |
| 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71} |
| #define UVC_GUID_FORMAT_Z16 \ |
| { 'Z', '1', '6', ' ', 0x00, 0x00, 0x10, 0x00, \ |
| 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71} |
| #define UVC_GUID_FORMAT_RW10 \ |
| { 'R', 'W', '1', '0', 0x00, 0x00, 0x10, 0x00, \ |
| 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71} |
| #define UVC_GUID_FORMAT_INVZ \ |
| { 'I', 'N', 'V', 'Z', 0x90, 0x2d, 0x58, 0x4a, \ |
| 0x92, 0x0b, 0x77, 0x3f, 0x1f, 0x2c, 0x55, 0x6b} |
| #define UVC_GUID_FORMAT_INZI \ |
| { 'I', 'N', 'Z', 'I', 0x66, 0x1a, 0x42, 0xa2, \ |
| 0x90, 0x65, 0xd0, 0x18, 0x14, 0xa8, 0xef, 0x8a} |
| #define UVC_GUID_FORMAT_INVI \ |
| { 'I', 'N', 'V', 'I', 0xdb, 0x57, 0x49, 0x5e, \ |
| 0x8e, 0x3f, 0xf4, 0x79, 0x53, 0x2b, 0x94, 0x6f} |
| #define UVC_GUID_FORMAT_CNF4 \ |
| { 'C', ' ', ' ', ' ', 0x00, 0x00, 0x10, 0x00, \ |
| 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71} |
| |
| #define UVC_GUID_FORMAT_D3DFMT_L8 \ |
| {0x32, 0x00, 0x00, 0x00, 0x00, 0x00, 0x10, 0x00, \ |
| 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71} |
| #define UVC_GUID_FORMAT_KSMEDIA_L8_IR \ |
| {0x32, 0x00, 0x00, 0x00, 0x02, 0x00, 0x10, 0x00, \ |
| 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71} |
| |
| #define UVC_GUID_FORMAT_HEVC \ |
| { 'H', 'E', 'V', 'C', 0x00, 0x00, 0x10, 0x00, \ |
| 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71} |
| |
| /* ------------------------------------------------------------------------ |
| * Video formats |
| */ |
| |
| struct uvc_format_desc { |
| char *name; |
| u8 guid[16]; |
| u32 fcc; |
| }; |
| |
| static struct uvc_format_desc uvc_fmts[] = { |
| { |
| .name = "YUV 4:2:2 (YUYV)", |
| .guid = UVC_GUID_FORMAT_YUY2, |
| .fcc = V4L2_PIX_FMT_YUYV, |
| }, |
| { |
| .name = "YUV 4:2:2 (YUYV)", |
| .guid = UVC_GUID_FORMAT_YUY2_ISIGHT, |
| .fcc = V4L2_PIX_FMT_YUYV, |
| }, |
| { |
| .name = "YUV 4:2:0 (NV12)", |
| .guid = UVC_GUID_FORMAT_NV12, |
| .fcc = V4L2_PIX_FMT_NV12, |
| }, |
| { |
| .name = "MJPEG", |
| .guid = UVC_GUID_FORMAT_MJPEG, |
| .fcc = V4L2_PIX_FMT_MJPEG, |
| }, |
| { |
| .name = "YVU 4:2:0 (YV12)", |
| .guid = UVC_GUID_FORMAT_YV12, |
| .fcc = V4L2_PIX_FMT_YVU420, |
| }, |
| { |
| .name = "YUV 4:2:0 (I420)", |
| .guid = UVC_GUID_FORMAT_I420, |
| .fcc = V4L2_PIX_FMT_YUV420, |
| }, |
| { |
| .name = "YUV 4:2:0 (M420)", |
| .guid = UVC_GUID_FORMAT_M420, |
| .fcc = V4L2_PIX_FMT_M420, |
| }, |
| { |
| .name = "YUV 4:2:2 (UYVY)", |
| .guid = UVC_GUID_FORMAT_UYVY, |
| .fcc = V4L2_PIX_FMT_UYVY, |
| }, |
| { |
| .name = "Greyscale 8-bit (Y800)", |
| .guid = UVC_GUID_FORMAT_Y800, |
| .fcc = V4L2_PIX_FMT_GREY, |
| }, |
| { |
| .name = "Greyscale 8-bit (Y8 )", |
| .guid = UVC_GUID_FORMAT_Y8, |
| .fcc = V4L2_PIX_FMT_GREY, |
| }, |
| { |
| .name = "Greyscale 8-bit (D3DFMT_L8)", |
| .guid = UVC_GUID_FORMAT_D3DFMT_L8, |
| .fcc = V4L2_PIX_FMT_GREY, |
| }, |
| { |
| .name = "IR 8-bit (L8_IR)", |
| .guid = UVC_GUID_FORMAT_KSMEDIA_L8_IR, |
| .fcc = V4L2_PIX_FMT_GREY, |
| }, |
| { |
| .name = "Greyscale 10-bit (Y10 )", |
| .guid = UVC_GUID_FORMAT_Y10, |
| .fcc = V4L2_PIX_FMT_Y10, |
| }, |
| { |
| .name = "Greyscale 12-bit (Y12 )", |
| .guid = UVC_GUID_FORMAT_Y12, |
| .fcc = V4L2_PIX_FMT_Y12, |
| }, |
| { |
| .name = "Greyscale 16-bit (Y16 )", |
| .guid = UVC_GUID_FORMAT_Y16, |
| .fcc = V4L2_PIX_FMT_Y16, |
| }, |
| { |
| .name = "BGGR Bayer (BY8 )", |
| .guid = UVC_GUID_FORMAT_BY8, |
| .fcc = V4L2_PIX_FMT_SBGGR8, |
| }, |
| { |
| .name = "BGGR Bayer (BA81)", |
| .guid = UVC_GUID_FORMAT_BA81, |
| .fcc = V4L2_PIX_FMT_SBGGR8, |
| }, |
| { |
| .name = "GBRG Bayer (GBRG)", |
| .guid = UVC_GUID_FORMAT_GBRG, |
| .fcc = V4L2_PIX_FMT_SGBRG8, |
| }, |
| { |
| .name = "GRBG Bayer (GRBG)", |
| .guid = UVC_GUID_FORMAT_GRBG, |
| .fcc = V4L2_PIX_FMT_SGRBG8, |
| }, |
| { |
| .name = "RGGB Bayer (RGGB)", |
| .guid = UVC_GUID_FORMAT_RGGB, |
| .fcc = V4L2_PIX_FMT_SRGGB8, |
| }, |
| { |
| .name = "RGB565", |
| .guid = UVC_GUID_FORMAT_RGBP, |
| .fcc = V4L2_PIX_FMT_RGB565, |
| }, |
| { |
| .name = "BGR 8:8:8 (BGR3)", |
| .guid = UVC_GUID_FORMAT_BGR3, |
| .fcc = V4L2_PIX_FMT_BGR24, |
| }, |
| { |
| .name = "H.264", |
| .guid = UVC_GUID_FORMAT_H264, |
| .fcc = V4L2_PIX_FMT_H264, |
| }, |
| { |
| .name = "H.265", |
| .guid = UVC_GUID_FORMAT_H265, |
| .fcc = V4L2_PIX_FMT_HEVC, |
| }, |
| { |
| .name = "Greyscale 8 L/R (Y8I)", |
| .guid = UVC_GUID_FORMAT_Y8I, |
| .fcc = V4L2_PIX_FMT_Y8I, |
| }, |
| { |
| .name = "Greyscale 12 L/R (Y12I)", |
| .guid = UVC_GUID_FORMAT_Y12I, |
| .fcc = V4L2_PIX_FMT_Y12I, |
| }, |
| { |
| .name = "Depth data 16-bit (Z16)", |
| .guid = UVC_GUID_FORMAT_Z16, |
| .fcc = V4L2_PIX_FMT_Z16, |
| }, |
| { |
| .name = "Bayer 10-bit (SRGGB10P)", |
| .guid = UVC_GUID_FORMAT_RW10, |
| .fcc = V4L2_PIX_FMT_SRGGB10P, |
| }, |
| { |
| .name = "Bayer 16-bit (SBGGR16)", |
| .guid = UVC_GUID_FORMAT_BG16, |
| .fcc = V4L2_PIX_FMT_SBGGR16, |
| }, |
| { |
| .name = "Bayer 16-bit (SGBRG16)", |
| .guid = UVC_GUID_FORMAT_GB16, |
| .fcc = V4L2_PIX_FMT_SGBRG16, |
| }, |
| { |
| .name = "Bayer 16-bit (SRGGB16)", |
| .guid = UVC_GUID_FORMAT_RG16, |
| .fcc = V4L2_PIX_FMT_SRGGB16, |
| }, |
| { |
| .name = "Bayer 16-bit (SGRBG16)", |
| .guid = UVC_GUID_FORMAT_GR16, |
| .fcc = V4L2_PIX_FMT_SGRBG16, |
| }, |
| { |
| .name = "Depth data 16-bit (Z16)", |
| .guid = UVC_GUID_FORMAT_INVZ, |
| .fcc = V4L2_PIX_FMT_Z16, |
| }, |
| { |
| .name = "Greyscale 10-bit (Y10 )", |
| .guid = UVC_GUID_FORMAT_INVI, |
| .fcc = V4L2_PIX_FMT_Y10, |
| }, |
| { |
| .name = "IR:Depth 26-bit (INZI)", |
| .guid = UVC_GUID_FORMAT_INZI, |
| .fcc = V4L2_PIX_FMT_INZI, |
| }, |
| { |
| .name = "4-bit Depth Confidence (Packed)", |
| .guid = UVC_GUID_FORMAT_CNF4, |
| .fcc = V4L2_PIX_FMT_CNF4, |
| }, |
| { |
| .name = "HEVC", |
| .guid = UVC_GUID_FORMAT_HEVC, |
| .fcc = V4L2_PIX_FMT_HEVC, |
| }, |
| }; |
| |
| static inline struct uvc_format_desc *uvc_format_by_guid(const u8 guid[16]) |
| { |
| unsigned int len = ARRAY_SIZE(uvc_fmts); |
| unsigned int i; |
| |
| for (i = 0; i < len; ++i) { |
| if (memcmp(guid, uvc_fmts[i].guid, 16) == 0) |
| return &uvc_fmts[i]; |
| } |
| |
| return NULL; |
| } |
| |
| #endif /* __LINUX_V4L2_UVC_H */ |
