111 lines
5.1 KiB
C
111 lines
5.1 KiB
C
/**
|
|
* @file MSOS20Descriptors.c
|
|
* @author windowsair
|
|
* @brief Store related data of Microsoft OS 2.0 descriptor
|
|
* @change: 2021-5-12 Add support for USB 3.0
|
|
* @version 0.2
|
|
* @date 2021-5-12
|
|
*
|
|
* @copyright Copyright (c) 2021
|
|
*
|
|
*/
|
|
|
|
////TODO: refactoring into structure
|
|
|
|
#include <stdint.h>
|
|
#include "MSOS20Descriptors.h"
|
|
|
|
#define USBShort(ui16Value) ((ui16Value) & 0xff), ((ui16Value) >> 8) //((ui16Value) & 0xFF),(((ui16Value) >> 8) & 0xFF)
|
|
|
|
|
|
|
|
// Microsoft OS 2.0 descriptor set header
|
|
const uint8_t msOs20DescriptorSetHeader[kLengthOfMsOS20] =
|
|
{
|
|
// Microsoft OS 2.0 Descriptor Set header (Table 10)
|
|
0x0A, 0x00, // wLength (Shall be set to 0x0A)
|
|
MS_OS_20_SET_HEADER_DESCRIPTOR, 0x00,
|
|
0x00, 0x00, 0x03, 0x06, // dwWindowsVersion: Windows 8.1 (NTDDI_WINBLUE)
|
|
USBShort(kLengthOfMsOS20), // wTotalLength
|
|
|
|
// Support WinUSB
|
|
// See https://docs.microsoft.com/en-us/windows-hardware/drivers/usbcon/automatic-installation-of-winusb
|
|
|
|
// Microsoft OS 2.0 compatible ID descriptor (Table 13)
|
|
0x14, 0x00, // wLength
|
|
USBShort(MS_OS_20_FEATURE_COMPATIBLE_ID), // wDescriptorType
|
|
'W', 'I', 'N', 'U', 'S', 'B', 0x00, 0x00, // compatibleID
|
|
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, // subCompatibleID
|
|
|
|
// Microsoft OS 2.0 registry property descriptor (Table 14)
|
|
0x84, 0x00, // wLength
|
|
USBShort(MS_OS_20_FEATURE_REG_PROPERTY),
|
|
0x07, 0x00, // wPropertyDataType: REG_MULTI_SZ (Unicode Strings)
|
|
0x2A, 0x00, // wPropertyNameLength
|
|
'D',0,'e',0,'v',0,'i',0,'c',0,'e',0,'I',0,'n',0,'t',0,'e',0,'r',0,
|
|
'f',0,'a',0,'c',0,'e',0,'G',0,'U',0,'I',0,'D',0,'s',0,0,0,
|
|
// Set to "DeviceInterfaceGUID" to support WinUSB
|
|
0x50, 0x00, // wPropertyDataLength
|
|
// WinUSB GUID
|
|
'{',0,'C',0,'D',0,'B',0,'3',0,'B',0,'5',0,'A',0,'D',0,'-',0,
|
|
'2',0,'9',0,'3',0,'B',0,'-',0,'4',0,'6',0,'6',0,'3',0,'-',0,
|
|
'A',0,'A',0,'3',0,'6',0,'-',0,'1',0,'A',0,'A',0,'E',0,'4',0,
|
|
'6',0,'4',0,'6',0,'3',0,'7',0,'7',0,'6',0,'}',0,0,0,0,0,
|
|
// identify a CMSIS-DAP V2 configuration,
|
|
// must set to "{CDB3B5AD-293B-4663-AA36-1AAE46463776}"
|
|
|
|
};
|
|
|
|
const uint8_t bosDescriptor[kLengthOfBos] =
|
|
{
|
|
// USB 3.0 Specification, Table 9-9.
|
|
0x05, // bLength of this descriptor
|
|
USB_DESCRIPTOR_TYPE_BOS, // BOS Descriptor type(Constant)
|
|
USBShort(kLengthOfBos), // wLength
|
|
|
|
|
|
#if (USE_USB_3_0 == 1)
|
|
0x03, // bNumDeviceCaps -> USB2.0 extension & SuperSpeed USB Device & OS2.0 descriptor
|
|
#else
|
|
0x01, // bNumDeviceCaps -> only 0x01 for OS2.0 descriptor
|
|
#endif // USE_USB_3_0 == 1
|
|
|
|
#if (USE_USB_3_0 == 1)
|
|
// USB 2.0 extension, USB 3.0 Specification, Table 9-12.
|
|
0x07, // bLength of this descriptor
|
|
USB_DESCRIPTOR_TYPE_DEVICE_CAPABILITY, // DEVICE CAPABILITY Descriptor type
|
|
USB_DEVICE_CAPABILITY_TYPE_USB2_0_EXTENSION, // Capability type: USB 2.0 EXTENSION
|
|
0x02, 0x00, 0x00, 0x00, // bmAttributes -> LPM Support
|
|
|
|
// SuperSpeed USB Device, USB 3.0 Specification, Table 9-13.
|
|
0x0A, // bLength of this descriptor
|
|
USB_DESCRIPTOR_TYPE_DEVICE_CAPABILITY, // DEVICE CAPABILITY Descriptor type
|
|
USB_DEVICE_CAPABILITY_TYPE_SUPERSPEED_USB, // Capability type: SUPERSPEED_USB
|
|
0x00, // bmAttributes -> LTM Capable
|
|
0x08, 0x00, // wSpeedsSupported -> only support SuperSpeed
|
|
0x03, // bFunctionalitySupport
|
|
0x00, // bU1DevExitLat -> 0 may be ok
|
|
0x00, 0x00, // wU2DevExitLat -> 0 may be ok
|
|
#endif // USE_USB_3_0 == 1
|
|
|
|
|
|
|
|
// Microsoft OS 2.0 platform capability descriptor header (Table 4)
|
|
// See also:
|
|
// USB 3.0 Specification : Format of a Device Capability Descriptor, Table 9-10.
|
|
|
|
0x1C, // bLength of this first device capability descriptor
|
|
// bLength -> The total length of the remaining arrays containing this field
|
|
USB_DESCRIPTOR_TYPE_DEVICE_CAPABILITY, // bDescriptorType
|
|
USB_DEVICE_CAPABILITY_TYPE_PLATFORM, // bDevCapabilityType
|
|
|
|
// Capability-Dependent (See USB 3.0 Specification Table 9-10.)
|
|
0x00, // bReserved
|
|
USB_DEVICE_CAPABILITY_UUID, // MS_OS_20_Platform_Capability_ID
|
|
|
|
0x00, 0x00, 0x03, 0x06, // dwWindowsVersion: Windows 8.1 (NTDDI_WINBLUE)
|
|
USBShort(kLengthOfMsOS20), // wMSOSDescriptorSetTotalLength(length of descriptor set header)
|
|
kValueOfbMS_VendorCode, // bMS_VendorCode (0x01 will be ok)
|
|
////TODO:change this
|
|
0, // bAltEnumCode
|
|
}; |