带有MS OS 2.0描述符的复合RNDIS HID

时间:2018-08-06 18:59:07

标签: windows usb rndis

我正在开发USB RNDIS和HID复合设备。对于RNDIS设备,我正在使用日期为2017年4月的Microsoft文档“ Microsoft OS 2.0描述符规范”(链接在https://docs.microsoft.com/en-us/windows-hardware/drivers/usbcon/microsoft-defined-usb-descriptors底部)中描述的MS OS 2.0描述符。我正在使用Windows 10主机。

两个设备都被识别,但是只有HID设备被正确识别; Windows将RNDIS设备分配为串行端口。

这是其中的一些相关内容。 设备描述符:

.bLength = 18
.bDescriptorType = 1
.bcdUSB = 0x0201
.bDeviceClass = 0xef
.bDeviceSubClass = 2
.bDeviceProtocol = 1
.bMaxPacketSize0 = 64
.idVendor = USB_DEVICE_VENDOR_ID,
.idProduct = USB_DEVICE_PRODUCT_ID,
.bcdDevice = (USB_DEVICE_MAJOR_VERSION << 8) | USB_DEVICE_MINOR_VERSION,
.iManufacturer = 1
.iProduct = 2
.iSerialNumber = 3
.bNumConfigurations = 1

配置描述符

Configuration Header:

    .bLength = 9
    .bDescriptorType = 2
    .wTotalLength = 100
    .bNumInterfaces = 3
    .bConfigurationValue = 1
    .iConfiguration = 0,
    .bmAttributes = 0xc0
    .bMaxPower = 0xfa

Interface Association Descritpor

    .bLength = 8
    .bDescriptorType = 11
    .bFirstInterface = 0
    .bInterfaceCount = 2
    .bFunctionClass = 2
    .bFunctionSubClass = 2
    .bFunctionProtocol = 0xff,
    .iFunction = 0

RNDIS Descriptor

    CDC IF Descriptor

        .bLength = 9
        .bDescriptorType = 4
        .bInterfaceNumber = 0
        .bAlternateSetting = 0,
        .bNumEndpoints =  1
        .bInterfaceClass = 2
        .bInterfaceSubClass = 2
        .bInterfaceProtocol = 0xff,
        .iInterface = 0

    [Remainder of RNDIS Control & Data interface]

HID Descriptor
[HID Descriptor details]

BOS描述符

Header

    .bLength = 5
    .bDescriptorType = 15
    .wTotalLength = 33
    .bNumDeviceCaps = 1

Platform Capabilities Descriptor

    .bLength = 28
    .bDescriptorType = 16
    .bDevCapability = 5
    .bReserved = 0,
    .capabilityId = {0xdf, 0x60, 0xdd, 0xd8, 0x89, 0x45, 0xc7, 0x4c, 0x9c, 0xd2, 0x65, 0x9d, 0x9e, 0x64, 0x8a, 0x9f}

Windows Descriptor Set

    .dwWindowsVersion = 0x06030000
    .wLength = 46
    .bMsVendorCode = 1
    .bAltEnumCode = 0

MS兼容性描述符:

Header

    .wLength = 10
    .wDescriptorType = 0
    .dwWindowsVersion = 0x06030000
    .wTotalLength = 46

Configuration Subset Header

    .wLength = 8
    .wDescriptorType = 1
    .bConfigurationValue = 1
    .bReserved = 0,
    .wTotalLength = 36

Function Subset Header

    .wLength = 8
    .wDescriptorType = 2
    .bFirstInterface = 0
    .bReserved = 0,
    .wSubsetLength = 28

Compatibility ID

    .wLength = 20
    .wDescriptorType =  3
    .compatibleId = {'R', 'N', 'D', 'I', 'S', 0, 0, 0},
    .subCompatibleId = {'5', '1', '6', '2', '0', '0', '1', 0}

如果我将设备构建为严格的RNDIS设备,则所有设备均可按预期工作-Windows将该设备识别为RNDIS设备;我没有安装任何驱动程序。这是我对仅适用于RNDIS的设备所做的修改的摘要(还进行了所需的尺寸更改):

  • 更改设备描述符设备类字段
  • 删除配置描述符的IAD和HID部分
  • 将配置描述符bNumInterfaces减少为2
  • 从MS兼容性描述符中删除配置子集标题和功能子集标题

请注意,如果我将配置子集标题和功能子集标题留在MS兼容性描述符中,则Windows会做出上述响应-将RNDIS设备分配为串行端口。

我尝试了各种排列,但似乎无法超越这一点。我尚未尝试为自定义设备创建INF,但这是我要避免的事情。

有什么帮助或建议吗?

谢谢。

1 个答案:

答案 0 :(得分:0)

尝试将Microsoft OS 2.0描述符(特别是配置子集标头)中的bConfigurationValue从1更改为0。实际上,它是配置数组中的 index 。它与USB 2.0规范中名为bConfigurationValue的东西不同。

我遇到了同样的问题,如下所述:

https://social.msdn.microsoft.com/Forums/windowsdesktop/en-US/ae64282c-3bc3-49af-8391-4d174479d9e7/microsoft-os-20-descriptors-not-working-on-an-interface-of-a-composite-usb-device?forum=wdk

我没有检查其余的描述符,所以很可能还有其他问题。