3. UVC协议规范详解：UVC 1.5标准、视频控制接口（VC）、视频流接口（VS）、描述符结构

UVC（USB Video Class）协议是USB-IF组织为USB摄像头设备定义的标准协议。本章深入解析UVC 1.5标准的核心规范，重点讲解视频控制接口（VC）与视频流接口（VS）的职责划分，以及描述符结构的组织方式。理解这些内容是开发UVC Gadget驱动的理论基础。

3.1 UVC 1.5标准概述

UVC 1.5标准于2012年发布，是当前最广泛使用的USB摄像头协议版本。它定义了摄像头设备与主机之间的通信规范，包括设备描述、控制机制、数据格式和传输方式。

UVC 1.5标准的核心改进包括：

• 多流支持：允许设备同时输出多个不同格式或分辨率的视频流。
• 帧间隔控制：支持更精细的帧率调节，通过Frame Interval Descriptor实现。
• 扩展单元（Extension Unit）：提供厂商自定义控制通道，用于实现私有功能（如自动对焦、白平衡）。
• Probe & Commit机制：标准化的流参数协商流程，确保主机与设备之间的格式、分辨率、帧率一致。

3.2 视频控制接口（VC）

视频控制接口（Video Control Interface，VC）是UVC设备的控制中心，负责处理所有与视频参数相关的控制请求。VC接口通过控制端点（Endpoint 0，默认控制管道）与主机通信，使用USB标准请求（Class-Specific Request）来读写设备属性。

VC接口通过控制选择子（Control Selector）来区分不同的控制功能。每个控制选择子对应一个特定的摄像头参数，例如：

3.3 视频流接口（VS）

视频流接口（Video Streaming Interface，VS）负责视频数据的实际传输。VS接口使用等时端点（Isochronous Endpoint）或批量端点（Bulk Endpoint）来发送视频帧数据。UVC 1.5标准推荐使用等时传输以保证实时性，但在USB Gadget场景中，批量传输更常见（兼容性更好）。

VS接口的核心机制是Probe & Commit协商流程，它确保主机和设备就视频格式达成一致：

1. PROBE_CONTROL（GET_CUR）：主机读取设备当前默认的流参数（格式、分辨率、帧率）。
2. PROBE_CONTROL（SET_CUR）：主机修改参数后发送给设备试探，设备返回实际可用的参数（可能降级）。
3. PROBE_CONTROL（GET_CUR）：主机再次读取确认设备接受的参数。
4. COMMIT_CONTROL（SET_CUR）：主机提交最终参数，设备开始按此参数发送视频流。

3.4 描述符结构

UVC设备的描述符是USB描述符体系中的核心部分，它向主机声明设备的能力和配置。UVC描述符分为标准描述符和类特定描述符两类。标准描述符（设备描述符、配置描述符、接口描述符、端点描述符）遵循USB规范，类特定描述符则定义UVC特有的信息。

在UVC Gadget驱动中，描述符通常以静态数组的形式定义在驱动代码中。以下是一个典型的UVC描述符结构示例（简化版）：

/* UVC 1.5 描述符结构示例（简化） */
static struct usb_interface_descriptor uvc_control_intf = {
    .bLength            = USB_DT_INTERFACE_SIZE,
    .bDescriptorType    = USB_DT_INTERFACE,
    .bInterfaceNumber   = 0,           /* VC接口号 */
    .bAlternateSetting  = 0,
    .bNumEndpoints      = 0,           /* VC使用端点0 */
    .bInterfaceClass    = USB_CLASS_VIDEO,
    .bInterfaceSubClass = USB_SUBCLASS_VIDEOCONTROL,
    .bInterfaceProtocol = 0x10,        /* UVC 1.5 */
};

static struct uvc_control_endpoint_descriptor uvc_control_ep = {
    .bLength            = UVC_DT_CONTROL_ENDPOINT_SIZE,
    .bDescriptorType    = USB_DT_CS_ENDPOINT,
    .bDescriptorSubType = UVC_EP_CONTROL,
    .bmAttributes       = 0x00,
    .wMaxPacketSize     = 0x0000,
};

static struct usb_interface_descriptor uvc_streaming_intf = {
    .bLength            = USB_DT_INTERFACE_SIZE,
    .bDescriptorType    = USB_DT_INTERFACE,
    .bInterfaceNumber   = 1,           /* VS接口号 */
    .bAlternateSetting  = 1,           /* 备用设置1：开启流 */
    .bNumEndpoints      = 1,
    .bInterfaceClass    = USB_CLASS_VIDEO,
    .bInterfaceSubClass = USB_SUBCLASS_VIDEOSTREAMING,
    .bInterfaceProtocol = 0x10,
};

static struct usb_endpoint_descriptor uvc_streaming_ep = {
    .bLength            = USB_DT_ENDPOINT_SIZE,
    .bDescriptorType    = USB_DT_ENDPOINT,
    .bEndpointAddress   = 0x81,        /* IN端点，地址1 */
    .bmAttributes       = USB_ENDPOINT_XFER_ISOC, /* 等时传输 */
    .wMaxPacketSize     = cpu_to_le16(1024),
    .bInterval          = 1,
};

UVC类特定描述符的详细字段说明：

3.5 本章小结