usb: usb3.0 ch9 definitions
Subsystems (2)
PATCH v5 1/1 usb: usb3.0 ch9 definitions
Adding SuperSpeed usb definitions as defined by ch9 of the USB3.0 spec. This patch is a preparation for adding SuperSpeed support to the gadget framework.
--- include/linux/usb/ch9.h | 58 ++++++++++++++++++++++++++++++++++++++++++++++- 1 files changed, 57 insertions(+), 1 deletions(-)
include/linux/usb/ch9.h +57 -1
@@ -123,8 +123,23 @@#define USB_DEVICE_A_ALT_HNP_SUPPORT 5/* (otg) other RH port does */ #define USB_DEVICE_DEBUG_MODE 6/* (special devices only) */ +/* +* New Feature Selectors as added by USB 3.0 +* See USB 3.0 spec Table 9-6 +*/ +#define USB_DEVICE_U1_ENABLE 48/* dev may initiate U1 transition */ +#define USB_DEVICE_U2_ENABLE 49/* dev may initiate U2 transition */ +#define USB_DEVICE_LTM_ENABLE 50/* dev may send LTM */ +#define USB_INTRF_FUNC_SUSPEND 0/* function suspend */ + +#define USB_INTR_FUNC_SUSPEND_OPT_MASK 0xFF00 +#define USB_ENDPOINT_HALT 0/* IN/OUT will STALL */ +/* Bit array elements as returned by the USB_REQ_GET_STATUS request. */ +#define USB_DEV_STAT_U1_ENABLED 2/* transition into U1 state */ +#define USB_DEV_STAT_U2_ENABLED 3/* transition into U2 state */ +#define USB_DEV_STAT_LTM_ENABLED 4/* Latency tolerance messages */ /** * struct usb_ctrlrequest - SETUP data for a USB device control request
@@ -675,6 +690,7 @@ struct usb_bos_descriptor {__u8 bNumDeviceCaps; } __attribute__((packed)); +#define USB_DT_BOS_SIZE 5/*-------------------------------------------------------------------------*/ /* USB_DT_DEVICE_CAPABILITY: grouped with BOS */
@@ -712,16 +728,56 @@ struct usb_wireless_cap_descriptor { /* Ultra Wide Band */__u8 bReserved; } __attribute__((packed)); +/* USB 2.0 Extension descriptor */ #define USB_CAP_TYPE_EXT 2struct usb_ext_cap_descriptor {/* Link Power Management */ __u8 bLength;__u8 bDescriptorType;__u8 bDevCapabilityType; -__u8 bmAttributes; +__le32 bmAttributes;#define USB_LPM_SUPPORT (1 << 1)/* supports LPM */ } __attribute__((packed)); +#define USB_DT_USB_EXT_CAP_SIZE 7 + +/* +* SuperSpeed USB Capability descriptor: Defines the set of SuperSpeed USB +* specific device level capabilities +*/ +#define USB_SS_CAP_TYPE 3 +struct usb_ss_cap_descriptor {/* Link Power Management */ +__u8 bLength; +__u8 bDescriptorType; +__u8 bDevCapabilityType; +__u8 bmAttributes; +#define USB_LTM_SUPPORT (1 << 1)/* supports LTM */ +__le16 wSpeedSupported; +#define USB_LOW_SPEED_OPERATION (1)/* Low speed operation */ +#define USB_FULL_SPEED_OPERATION (1 << 1)/* Full speed operation */ +#define USB_HIGH_SPEED_OPERATION (1 << 2)/* High speed operation */ +#define USB_5GBPS_OPERATION (1 << 3)/* Operation at 5Gbps */ +__u8 bFunctionalitySupport; +__u8 bU1devExitLat; +__le16 bU2DevExitLat; +} __attribute__((packed)); + +#define USB_DT_USB_SS_CAP_SIZE 10 + +/* +* Container ID Capability descriptor: Defines the instance unique ID used to +* identify the instance across all operating modes +*/ +#define CONTAINER_ID_TYPE 4 +struct usb_ss_container_id_descriptor { +__u8 bLength; +__u8 bDescriptorType; +__u8 bDevCapabilityType; +__u8 bReserved; +__u8 ContainerID[16 ];/* 128-bit number */ +} __attribute__((packed)); + +#define USB_DT_USB_SS_CONTN_ID_SIZE 20/*-------------------------------------------------------------------------*/ /* USB_DT_WIRELESS_ENDPOINT_COMP: companion descriptor associated with
Signature · 5 lines
1.6.3.3 -- Sent by an consultant of the Qualcomm Inovation Center, Inc. The Qualcomm Inovation Center, Inc.is a member of the Code Aurora Forum.
Quoted 12 lines · Tatyana Brokhman
include/linux/usb/ch9.h +12
-0+/* +* SuperSpeed USB Capability descriptor: Defines the set of SuperSpeed USB +* specific device level capabilities +*/ +#define USB_SS_CAP_TYPE 3 +struct usb_ss_cap_descriptor {/* Link Power Management */ +__u8 bLength; +__u8 bDescriptorType; +__u8 bDevCapabilityType; +__u8 bmAttributes; +#define USB_LTM_SUPPORT (1 << 1)/* supports LTM */ +__le16 wSpeedSupported;
include/linux/usb/ch9.h struct usb_wireless_cap_descriptor { /* Ultra Wide Band */ · line 765
Quoted 10 lines
include/linux/usb/ch9.h +10
-0+#define USB_LOW_SPEED_OPERATION (1)/* Low speed operation */ +#define USB_FULL_SPEED_OPERATION (1 << 1)/* Full speed operation */ +#define USB_HIGH_SPEED_OPERATION (1 << 2)/* High speed operation */ +#define USB_5GBPS_OPERATION (1 << 3)/* Operation at 5Gbps */ +__u8 bFunctionalitySupport; +__u8 bU1devExitLat; +__le16 bU2DevExitLat; +} __attribute__((packed)); + +#define USB_DT_USB_SS_CAP_SIZE 10
Hang on, if we're looking at page 10-57 of "USB 3 0 (11132008)-final.pdf", it's 12 bytes long with the last two bytes being wReserved. Is there an erratum that changes this? I just looked through "USB3_Errata [June 2010].pdf" and don't see any errata that look germane.
Hi Matthew
Page 10-57 you're referring to defines the SuperSpeed USB Device Capability descriptor for Hub Class. The descriptor itself is defined in ch9 section 9.6.2.2 and the wReserved is not defined there. Thus the total length of the descriptor is 10 bytes and not 12.
IMO we should follow the definition in ch9. It seems that ch 10 has a typo in it. You're right about the errata. I found no reference to this issue either.
I'll contact USB-IF regarding this issue.
Thanks for bringing this up!
Best regards
Tanya Brokhman
Quoted 31 lines · Tatyana Brokhman
Quoted 13 lines
+/*
+ * SuperSpeed USB Capability descriptor: Defines the set of SuperSpeed USB
+ * specific device level capabilities
+ */include/linux/usb/ch9.h +8
-0+#define USB_SS_CAP_TYPE 3 +struct usb_ss_cap_descriptor {/* Link Power Management */ +__u8 bLength; +__u8 bDescriptorType; +__u8 bDevCapabilityType; +__u8 bmAttributes; +#define USB_LTM_SUPPORT (1 << 1)/* supports LTM */ +__le16 wSpeedSupported;include/linux/usb/ch9.h struct usb_wireless_cap_descriptor { /* Ultra Wide Band */ · line 765
Quoted 10 lines
include/linux/usb/ch9.h +10
-0+#define USB_LOW_SPEED_OPERATION (1)/* Low speed operation */ +#define USB_FULL_SPEED_OPERATION (1 << 1)/* Full speed operation */ +#define USB_HIGH_SPEED_OPERATION (1 << 2)/* High speed operation */ +#define USB_5GBPS_OPERATION (1 << 3)/* Operation at 5Gbps */ +__u8 bFunctionalitySupport; +__u8 bU1devExitLat; +__le16 bU2DevExitLat; +} __attribute__((packed)); + +#define USB_DT_USB_SS_CAP_SIZE 10Hang on, if we're looking at page 10-57 of "USB 3 0 (11132008)-final.pdf", it's 12 bytes long with the last two bytes being wReserved. Is there an erratum that changes this? I just looked through "
USB3_Errata[June 2010].pdf" and don't see any errata that look germane.
Hi Matthew
Bellow is the reply we received from Intel regarding this issue:
"Errata 10.007 in the “Q1-09 USB3_Errata.pdf” file defines a correction of the SuperSpeed USB Device Capability structure in section 10.13.1 that changes bLength from 12 to 10 bytes, and bFunctionalitySupport from 8 to 3."
Best Regards
Tanya Brokhman
Quoted 55 lines
Hi Matthew
Page 10-57 you're referring to defines the SuperSpeed USB Device Capability descriptor for Hub Class. The descriptor itself is defined in ch9 section 9.6.2.2 and the wReserved is not defined there. Thus the total length of the descriptor is 10 bytes and not 12.
IMO we should follow the definition in ch9. It seems that ch 10 has a typo in it. You're right about the errata. I found no reference to this issue either.
I'll contact USB-IF regarding this issue.
Thanks for bringing this up!Best regards
Tanya BrokhmanQuoted 23 lines · Tatyana Brokhman
Quoted 22 lines
+/*
+ * SuperSpeed USB Capability descriptor: Defines the set of SuperSpeed USB
+ * specific device level capabilities
+ */include/linux/usb/ch9.h +17
-0+#define USB_SS_CAP_TYPE 3 +struct usb_ss_cap_descriptor {/* Link Power Management */ +__u8 bLength; +__u8 bDescriptorType; +__u8 bDevCapabilityType; +__u8 bmAttributes; +#define USB_LTM_SUPPORT (1 << 1)/* supports LTM */ +__le16 wSpeedSupported; +#define USB_LOW_SPEED_OPERATION (1)/* Low speed operation */ +#define USB_FULL_SPEED_OPERATION (1 << 1)/* Full speed operation */ +#define USB_HIGH_SPEED_OPERATION (1 << 2)/* High speed operation */ +#define USB_5GBPS_OPERATION (1 << 3)/* Operation at 5Gbps */ +__u8 bFunctionalitySupport; +__u8 bU1devExitLat; +__le16 bU2DevExitLat; +} __attribute__((packed)); +Quoted 10 lines
Quoted 1 line
+#define
USB_DT_USB_SS_CAP_SIZE10Hang on, if we're looking at page 10-57 of "USB 3 0 (11132008)-final.pdf",
it's 12 bytes long with the last two bytes being wReserved. Is there an erratum that changes this? I just looked through "USB3_Errata[June 2010].pdf" and don't see any errata that look germane.--
To unsubscribe from this list: send the line "unsubscribe linux-usb" in the body of a message to [email protected]
More majordomo info at http://vger.kernel.org/majordomo-info.html
Hello.
Quoted 13 lines · Tatyana Brokhman
Adding SuperSpeed usb definitions as defined by ch9 of the USB3.0 spec. This patch is a preparation for adding SuperSpeed support to the gadget framework.
Signed-off-by Tatyana Brokhman<[email protected]>--- include/linux/usb/ch9.h | 58 ++++++++++++++++++++++++++++++++++++++++++++++- 1 files changed, 57 insertions(+), 1 deletions(-)include/linux/usb/ch9.h +0
-0
[...]
Quoted 13 lines
include/linux/usb/ch9.h +2
-1@@ -712,16 +728,56 @@ struct usb_wireless_cap_descriptor { /* Ultra Wide Band */__u8 bReserved; } __attribute__((packed)); +/* USB 2.0 Extension descriptor */ #define USB_CAP_TYPE_EXT 2struct usb_ext_cap_descriptor {/* Link Power Management */ __u8 bLength;__u8 bDescriptorType;__u8 bDevCapabilityType; -__u8 bmAttributes; +__le32 bmAttributes;
include/linux/usb/ch9.h struct usb_wireless_cap_descriptor { /* Ultra Wide Band */ · line 748
Quoted 10 lines
include/linux/usb/ch9.h +7
-0#define USB_LPM_SUPPORT (1<< 1)/* supports LPM */ } __attribute__((packed)); +#define USB_DT_USB_EXT_CAP_SIZE 7 + +/* +* SuperSpeed USB Capability descriptor: Defines the set of SuperSpeed USB +* specific device level capabilities +*/ +#define USB_SS_CAP_TYPE 3
Too many tabs here.
include/linux/usb/ch9.h struct usb_wireless_cap_descriptor { /* Ultra Wide Band */ · line 749
Quoted 1 line
include/linux/usb/ch9.h +1
-0+struct usb_ss_cap_descriptor {/* Link Power Management */
WBR, Sergei