libusb项目新增SuperSpeedPlus USB设备能力支持

背景介绍

在USB 3.1规范中，SuperSpeedPlus USB设备能力描述符(SuperSpeedPlus USB Device Capability Descriptor)是一个重要的特性描述符，它位于设备能力描述符(Device Capability Descriptor)结构中。这个描述符提供了关于设备支持的SuperSpeedPlus特性的详细信息，包括子链路速度属性等关键参数。

技术实现

libusb项目最近新增了对这一特性的支持。在实现过程中，开发团队面临了一个重要的设计决策：是直接暴露原始描述符数据，还是进行解析后提供结构化的数据。

最终决定采用解析后的结构化数据方式，主要基于以下考虑：

1. 易用性：原始描述符中包含多个需要位掩码操作的字段，如SSAC(SuperSpeedPlus Attribute Count)和SSIC(SuperSpeedPlus Isochronous Attribute Count)都存储在同一个32位属性字段中，需要开发者进行复杂的位操作。

2. 安全性：通过库内部处理这些位操作，可以减少开发者出错的可能性。

3. 一致性：虽然与libusb现有的部分描述符处理方式略有不同，但这种改进更符合现代API设计理念。

数据结构设计

新的实现提供了以下主要数据结构：

struct libusb_ssplus_usb_device_capability_descriptor {
    uint8_t ssac;  // SuperSpeedPlus Attribute Count
    uint8_t ssic;  // SuperSpeedPlus Isochronous Attribute Count
    uint8_t functionalitySupport;
    uint8_t numSublinkSpeedAttributes;
    struct libusb_ssplus_sublink_speed_attribute *sublinkSpeedAttributes;
};

其中，子链路速度属性结构体包含以下字段：

struct libusb_ssplus_sublink_speed_attribute {
    uint8_t id;
    uint8_t exponent;
    uint8_t type;
    uint8_t protocol;
    uint16_t mantissa;
};

技术细节

SuperSpeedPlus设备能力描述符包含几个关键部分：

1. 基本属性：包括SSAC和SSIC，分别表示设备支持的SuperSpeedPlus属性和同步属性的数量。

2. 功能支持：指示设备支持的各种功能特性。

3. 子链路速度属性：这是一个数组，每个元素描述一个特定的子链路速度特性，包括：

   • 速度ID
   • 指数部分(用于计算实际速度)
   • 类型(对称或非对称)
   • 协议(SuperSpeed或SuperSpeedPlus)
   • 尾数部分(用于计算实际速度)

实际应用

开发者可以通过新的API轻松获取设备的SuperSpeedPlus能力信息，而无需关心底层的位操作和解析细节。例如，要计算某个子链路的实际速度，可以使用以下公式：

速度 = (mantissa + 1) * 10^exponent * (type == 对称 ? 2 : 1) Mbps

总结

libusb对SuperSpeedPlus USB设备能力的支持为开发者提供了更便捷的方式来访问现代USB设备的先进特性。这一改进不仅简化了开发流程，还提高了代码的可靠性和可维护性。随着USB技术的不断发展，libusb项目也在持续演进，为开发者提供更好的工具和支持。