From nobody Thu May 16 19:40:55 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of groups.io designates 66.175.222.108 as permitted sender) client-ip=66.175.222.108; envelope-from=bounce+27952+90711+1787277+3901457@groups.io; helo=mail02.groups.io; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of groups.io designates 66.175.222.108 as permitted sender) smtp.mailfrom=bounce+27952+90711+1787277+3901457@groups.io; dmarc=fail(p=none dis=none) header.from=intel.com ARC-Seal: i=1; a=rsa-sha256; t=1655965314; cv=none; d=zohomail.com; s=zohoarc; b=Bv1zJD49stQg90/UErO8k8eh9LIFVc2eEUEk8PoAQNzurtqD07Z26pHdHhoXrCqqS44lwZK2xYkOw0xh8bwk6/VxDIHKd/26Kx+E1/x56DgqoRGz4zpzwJ5UBaqNTLMTqyBX+XmaiS3hIUSjxxXBy182jzhv4xvwxMuJ0NqRmeE= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1655965314; h=Content-Transfer-Encoding:Cc:Date:From:List-Subscribe:List-Id:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Reply-To:Sender:Subject:To; bh=vqh3YX3n0TNcly9dA96zoVYVlkXkGnwfASi6daifwYw=; b=mmlg5KhXb9rN/bm+aNBThwkIbm6324tv8AHfkyNvlbHACPYyqBZI2w3p8a2CV5tAajBZm/Iz51L4sKBW0nmBYRfyfcneYmrRVuID8Sh9VlMzX4OiKP+vG3D7pGy8jHLXiYF1YE6Vj21Fs4rk+e9BUOth++t0VioVaXlHq8AbzEI= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of groups.io designates 66.175.222.108 as permitted sender) smtp.mailfrom=bounce+27952+90711+1787277+3901457@groups.io; dmarc=fail header.from= (p=none dis=none) Received: from mail02.groups.io (mail02.groups.io [66.175.222.108]) by mx.zohomail.com with SMTPS id 1655965314171581.5128304907465; Wed, 22 Jun 2022 23:21:54 -0700 (PDT) Return-Path: X-Received: by 127.0.0.2 with SMTP id HUfrYY1788612xKbaS3dCDH8; Wed, 22 Jun 2022 23:21:53 -0700 X-Received: from mga05.intel.com (mga05.intel.com [192.55.52.43]) by mx.groups.io with SMTP id smtpd.web09.4361.1655965312315944364 for ; Wed, 22 Jun 2022 23:21:53 -0700 X-IronPort-AV: E=McAfee;i="6400,9594,10386"; a="366957710" X-IronPort-AV: E=Sophos;i="5.92,215,1650956400"; d="scan'208";a="366957710" X-Received: from fmsmga003.fm.intel.com ([10.253.24.29]) by fmsmga105.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 22 Jun 2022 23:21:51 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.92,215,1650956400"; d="scan'208";a="677922374" X-Received: from jliu28x-desk3.gar.corp.intel.com ([10.5.215.163]) by FMSMGA003.fm.intel.com with ESMTP; 22 Jun 2022 23:21:49 -0700 From: ian.chiu@intel.com To: devel@edk2.groups.io Cc: Ian Chiu , Jenny Huang , More Shih , Hao A Wu , Ray Ni Subject: [edk2-devel] [PATCH v4] MdeModulePkg/XhciDxe: Add access xHCI Extended Capabilities Pointer Date: Thu, 23 Jun 2022 14:21:45 +0800 Message-Id: <20220623062145.1388-1-ian.chiu@intel.com> MIME-Version: 1.0 Precedence: Bulk List-Unsubscribe: List-Subscribe: List-Help: Sender: devel@edk2.groups.io List-Id: Mailing-List: list devel@edk2.groups.io; contact devel+owner@edk2.groups.io Reply-To: devel@edk2.groups.io,ian.chiu@intel.com X-Gm-Message-State: bFDxq2pQLG1ZpuATjNJnswY1x1787277AA= Content-Transfer-Encoding: quoted-printable DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=groups.io; q=dns/txt; s=20140610; t=1655965313; bh=4dZffO4AubSI6G70rDMmhrru8z60NZEDMNcb8BZqmaM=; h=Cc:Date:From:Reply-To:Subject:To; b=PVoT7uETdwKZioSVfaKg8cPq+DXfljBniKwj03HI7w3/eXNifNFu1XWRrI0gzOJ7WfA CMR897yRDOEuazB+EpzaUUZApIElMgaH2uNOOxYFs+A1CYwmzDg9ORUICZE9g8I8n/OPh Rmzn3K/nSpuk9ifM7g4HyCTtLNHBIhOVfVg= X-ZohoMail-DKIM: pass (identity @groups.io) X-ZM-MESSAGEID: 1655965315492100001 Content-Type: text/plain; charset="utf-8" From: Ian Chiu Add support process Port Speed field value of PORTSC according to Supported Protocol Capability (define in xHCI spec 1.1) REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3D3914 The value of Port Speed field in PORTSC bit[10:13] (xHCI spec 1.1 section 5.4.8) should be change to use this value to query thru Protocol Speed ID (PSI) (xHCI spec 1.1 section 7.2.1) in xHCI Supported Protocol Capability and return the value according the Protocol Speed ID (PSIV) Dword. With this mechanism may able to detect more kind of Protocol Speed in USB3 and also compatiable with three kind of speed of USB2. Cc: Jenny Huang Cc: More Shih Cc: Hao A Wu Cc: Ray Ni Signed-off-by: Ian Chiu Reviewed-by: Hao A Wu --- MdeModulePkg/Bus/Pci/XhciDxe/Xhci.c | 39 +++-- MdeModulePkg/Bus/Pci/XhciDxe/Xhci.h | 2 + MdeModulePkg/Bus/Pci/XhciDxe/XhciReg.c | 178 ++++++++++++++++++++ MdeModulePkg/Bus/Pci/XhciDxe/XhciReg.h | 92 +++++++++- 4 files changed, 295 insertions(+), 16 deletions(-) diff --git a/MdeModulePkg/Bus/Pci/XhciDxe/Xhci.c b/MdeModulePkg/Bus/Pci/Xhc= iDxe/Xhci.c index 381d7a9536..c05431ff30 100644 --- a/MdeModulePkg/Bus/Pci/XhciDxe/Xhci.c +++ b/MdeModulePkg/Bus/Pci/XhciDxe/Xhci.c @@ -399,24 +399,31 @@ XhcGetRootHubPortStatus ( =20 // // According to XHCI 1.1 spec November 2017, - // bit 10~13 of the root port status register identifies the speed of th= e attached device. + // Section 7.2 xHCI Support Protocol Capability // - switch ((State & XHC_PORTSC_PS) >> 10) { - case 2: - PortStatus->PortStatus |=3D USB_PORT_STAT_LOW_SPEED; - break; + PortStatus->PortStatus =3D XhcCheckUsbPortSpeedUsedPsic (Xhc, ((State & = XHC_PORTSC_PS) >> 10)); + if (PortStatus->PortStatus =3D=3D 0) { + // + // According to XHCI 1.1 spec November 2017, + // bit 10~13 of the root port status register identifies the speed of = the attached device. + // + switch ((State & XHC_PORTSC_PS) >> 10) { + case 2: + PortStatus->PortStatus |=3D USB_PORT_STAT_LOW_SPEED; + break; =20 - case 3: - PortStatus->PortStatus |=3D USB_PORT_STAT_HIGH_SPEED; - break; + case 3: + PortStatus->PortStatus |=3D USB_PORT_STAT_HIGH_SPEED; + break; =20 - case 4: - case 5: - PortStatus->PortStatus |=3D USB_PORT_STAT_SUPER_SPEED; - break; + case 4: + case 5: + PortStatus->PortStatus |=3D USB_PORT_STAT_SUPER_SPEED; + break; =20 - default: - break; + default: + break; + } } =20 // @@ -1826,6 +1833,8 @@ XhcCreateUsbHc ( Xhc->ExtCapRegBase =3D ExtCapReg << 2; Xhc->UsbLegSupOffset =3D XhcGetCapabilityAddr (Xhc, XHC_CAP_USB_LEGACY= ); Xhc->DebugCapSupOffset =3D XhcGetCapabilityAddr (Xhc, XHC_CAP_USB_DEBUG); + Xhc->Usb2SupOffset =3D XhcGetSupportedProtocolCapabilityAddr (Xhc, X= HC_SUPPORTED_PROTOCOL_DW0_MAJOR_REVISION_USB2); + Xhc->Usb3SupOffset =3D XhcGetSupportedProtocolCapabilityAddr (Xhc, X= HC_SUPPORTED_PROTOCOL_DW0_MAJOR_REVISION_USB3); =20 DEBUG ((DEBUG_INFO, "XhcCreateUsb3Hc: Capability length 0x%x\n", Xhc->Ca= pLength)); DEBUG ((DEBUG_INFO, "XhcCreateUsb3Hc: HcSParams1 0x%x\n", Xhc->HcSParams= 1)); @@ -1835,6 +1844,8 @@ XhcCreateUsbHc ( DEBUG ((DEBUG_INFO, "XhcCreateUsb3Hc: RTSOff 0x%x\n", Xhc->RTSOff)); DEBUG ((DEBUG_INFO, "XhcCreateUsb3Hc: UsbLegSupOffset 0x%x\n", Xhc->UsbL= egSupOffset)); DEBUG ((DEBUG_INFO, "XhcCreateUsb3Hc: DebugCapSupOffset 0x%x\n", Xhc->De= bugCapSupOffset)); + DEBUG ((DEBUG_INFO, "XhcCreateUsb3Hc: Usb2SupOffset 0x%x\n", Xhc->Usb2Su= pOffset)); + DEBUG ((DEBUG_INFO, "XhcCreateUsb3Hc: Usb3SupOffset 0x%x\n", Xhc->Usb3Su= pOffset)); =20 // // Create AsyncRequest Polling Timer diff --git a/MdeModulePkg/Bus/Pci/XhciDxe/Xhci.h b/MdeModulePkg/Bus/Pci/Xhc= iDxe/Xhci.h index 5054d796b1..ca223bd20c 100644 --- a/MdeModulePkg/Bus/Pci/XhciDxe/Xhci.h +++ b/MdeModulePkg/Bus/Pci/XhciDxe/Xhci.h @@ -227,6 +227,8 @@ struct _USB_XHCI_INSTANCE { UINT32 ExtCapRegBase; UINT32 UsbLegSupOffset; UINT32 DebugCapSupOffset; + UINT32 Usb2SupOffset; + UINT32 Usb3SupOffset; UINT64 *DCBAA; VOID *DCBAAMap; UINT32 MaxSlotsEn; diff --git a/MdeModulePkg/Bus/Pci/XhciDxe/XhciReg.c b/MdeModulePkg/Bus/Pci/= XhciDxe/XhciReg.c index 80be3311d4..2b4a4b2444 100644 --- a/MdeModulePkg/Bus/Pci/XhciDxe/XhciReg.c +++ b/MdeModulePkg/Bus/Pci/XhciDxe/XhciReg.c @@ -575,6 +575,184 @@ XhcGetCapabilityAddr ( return 0xFFFFFFFF; } =20 +/** + Calculate the offset of the xHCI Supported Protocol Capability. + + @param Xhc The XHCI Instance. + @param MajorVersion The USB Major Version in xHCI Support Protocol Cap= ability Field + + @return The offset of xHCI Supported Protocol capability register. + +**/ +UINT32 +XhcGetSupportedProtocolCapabilityAddr ( + IN USB_XHCI_INSTANCE *Xhc, + IN UINT8 MajorVersion + ) +{ + UINT32 ExtCapOffset; + UINT8 NextExtCapReg; + UINT32 Data; + UINT32 NameString; + XHC_SUPPORTED_PROTOCOL_DW0 UsbSupportDw0; + + if (Xhc =3D=3D NULL) { + return 0; + } + + ExtCapOffset =3D 0; + + do { + // + // Check if the extended capability register's capability id is USB Le= gacy Support. + // + Data =3D XhcReadExtCapReg (Xhc, ExtCapOffset); + UsbSupportDw0.Dword =3D Data; + if ((Data & 0xFF) =3D=3D XHC_CAP_USB_SUPPORTED_PROTOCOL) { + if (UsbSupportDw0.Data.RevMajor =3D=3D MajorVersion) { + NameString =3D XhcReadExtCapReg (Xhc, ExtCapOffset + XHC_SUPPORTED= _PROTOCOL_NAME_STRING_OFFSET); + if (NameString =3D=3D XHC_SUPPORTED_PROTOCOL_NAME_STRING_VALUE) { + // + // Ensure Name String field is xHCI supported protocols in xHCI = Supported Protocol Capability Offset 04h + // + return ExtCapOffset; + } + } + } + + // + // If not, then traverse all of the ext capability registers till find= ing out it. + // + NextExtCapReg =3D (UINT8)((Data >> 8) & 0xFF); + ExtCapOffset +=3D (NextExtCapReg << 2); + } while (NextExtCapReg !=3D 0); + + return 0xFFFFFFFF; +} + +/** + Find PortSpeed value match Protocol Speed ID Value (PSIV). + + @param Xhc The XHCI Instance. + @param ExtCapOffset The USB Major Version in xHCI Support Protocol Ca= pability Field + @param PortSpeed The Port Speed Field in USB PortSc register + + @return The Protocol Speed ID (PSI) from xHCI Supported Protocol capabil= ity register. + +**/ +UINT32 +XhciPsivGetPsid ( + IN USB_XHCI_INSTANCE *Xhc, + IN UINT32 ExtCapOffset, + IN UINT8 PortSpeed + ) +{ + XHC_SUPPORTED_PROTOCOL_DW2 PortId; + XHC_SUPPORTED_PROTOCOL_PROTOCOL_SPEED_ID Reg; + UINT32 Count; + + if ((Xhc =3D=3D NULL) || (ExtCapOffset =3D=3D 0xFFFFFFFF)) { + return 0; + } + + // + // According to XHCI 1.1 spec November 2017, + // Section 7.2 xHCI Supported Protocol Capability + // 1. Get the PSIC(Protocol Speed ID Count) value. + // 2. The PSID register boundary should be Base address + PSIC * 0x04 + // + PortId.Dword =3D XhcReadExtCapReg (Xhc, ExtCapOffset + XHC_SUPPORTED_PRO= TOCOL_DW2_OFFSET); + + for (Count =3D 0; Count < PortId.Data.Psic; Count++) { + Reg.Dword =3D XhcReadExtCapReg (Xhc, ExtCapOffset + XHC_SUPPORTED_PROT= OCOL_PSI_OFFSET + (Count << 2)); + if (Reg.Data.Psiv =3D=3D PortSpeed) { + return Reg.Dword; + } + } + + return 0; +} + +/** + Find PortSpeed value match case in XHCI Supported Protocol Capability + + @param Xhc The XHCI Instance. + @param PortSpeed The Port Speed Field in USB PortSc register + + @return The USB Port Speed. + +**/ +UINT16 +XhcCheckUsbPortSpeedUsedPsic ( + IN USB_XHCI_INSTANCE *Xhc, + IN UINT8 PortSpeed + ) +{ + XHC_SUPPORTED_PROTOCOL_PROTOCOL_SPEED_ID SpField; + UINT16 UsbSpeedIdMap; + + if (Xhc =3D=3D NULL) { + return 0; + } + + SpField.Dword =3D 0; + UsbSpeedIdMap =3D 0; + + // + // Check xHCI Supported Protocol Capability, find the PSIV field to match + // PortSpeed definition when the Major Revision is 03h. + // + if (Xhc->Usb3SupOffset !=3D 0xFFFFFFFF) { + SpField.Dword =3D XhciPsivGetPsid (Xhc, Xhc->Usb3SupOffset, PortSpeed); + if (SpField.Dword !=3D 0) { + // + // Found the corresponding PORTSC value in PSIV field of USB3 offset. + // + UsbSpeedIdMap =3D USB_PORT_STAT_SUPER_SPEED; + } + } + + // + // Check xHCI Supported Protocol Capability, find the PSIV field to match + // PortSpeed definition when the Major Revision is 02h. + // + if ((UsbSpeedIdMap =3D=3D 0) && (Xhc->Usb2SupOffset !=3D 0xFFFFFFFF)) { + SpField.Dword =3D XhciPsivGetPsid (Xhc, Xhc->Usb2SupOffset, PortSpeed); + if (SpField.Dword !=3D 0) { + // + // Found the corresponding PORTSC value in PSIV field of USB2 offset. + // + if (SpField.Data.Psie =3D=3D 2) { + // + // According to XHCI 1.1 spec November 2017, + // Section 7.2.1 the Protocol Speed ID Exponent (PSIE) field defin= ition, + // PSIE value shall be applied to Protocol Speed ID Mantissa when = calculating, value 2 shall represent bit rate in Mb/s + // + if (SpField.Data.Psim =3D=3D XHC_SUPPORTED_PROTOCOL_USB2_HIGH_SPEE= D_PSIM) { + // + // PSIM shows as default High-speed protocol, apply to High-spee= d mapping + // + UsbSpeedIdMap =3D USB_PORT_STAT_HIGH_SPEED; + } + } else if (SpField.Data.Psie =3D=3D 1) { + // + // According to XHCI 1.1 spec November 2017, + // Section 7.2.1 the Protocol Speed ID Exponent (PSIE) field defin= ition, + // PSIE value shall be applied to Protocol Speed ID Mantissa when = calculating, value 1 shall represent bit rate in Kb/s + // + if (SpField.Data.Psim =3D=3D XHC_SUPPORTED_PROTOCOL_USB2_LOW_SPEED= _PSIM) { + // + // PSIM shows as default Low-speed protocol, apply to Low-speed = mapping + // + UsbSpeedIdMap =3D USB_PORT_STAT_LOW_SPEED; + } + } + } + } + + return UsbSpeedIdMap; +} + /** Whether the XHCI host controller is halted. =20 diff --git a/MdeModulePkg/Bus/Pci/XhciDxe/XhciReg.h b/MdeModulePkg/Bus/Pci/= XhciDxe/XhciReg.h index 4950eed272..94b53c8335 100644 --- a/MdeModulePkg/Bus/Pci/XhciDxe/XhciReg.h +++ b/MdeModulePkg/Bus/Pci/XhciDxe/XhciReg.h @@ -25,8 +25,9 @@ SPDX-License-Identifier: BSD-2-Clause-Patent #define USB_HUB_CLASS_CODE 0x09 #define USB_HUB_SUBCLASS_CODE 0x00 =20 -#define XHC_CAP_USB_LEGACY 0x01 -#define XHC_CAP_USB_DEBUG 0x0A +#define XHC_CAP_USB_LEGACY 0x01 +#define XHC_CAP_USB_DEBUG 0x0A +#define XHC_CAP_USB_SUPPORTED_PROTOCOL 0x02 =20 // =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D// // XHCI register offset // @@ -74,6 +75,18 @@ SPDX-License-Identifier: BSD-2-Clause-Patent #define USBLEGSP_BIOS_SEMAPHORE BIT16 // HC BIOS Owned Semaphore #define USBLEGSP_OS_SEMAPHORE BIT24 // HC OS Owned Semaphore =20 +// +// xHCI Supported Protocol Capability +// +#define XHC_SUPPORTED_PROTOCOL_DW0_MAJOR_REVISION_USB2 0x02 +#define XHC_SUPPORTED_PROTOCOL_DW0_MAJOR_REVISION_USB3 0x03 +#define XHC_SUPPORTED_PROTOCOL_NAME_STRING_OFFSET 0x04 +#define XHC_SUPPORTED_PROTOCOL_NAME_STRING_VALUE 0x20425355 +#define XHC_SUPPORTED_PROTOCOL_DW2_OFFSET 0x08 +#define XHC_SUPPORTED_PROTOCOL_PSI_OFFSET 0x10 +#define XHC_SUPPORTED_PROTOCOL_USB2_HIGH_SPEED_PSIM 480 +#define XHC_SUPPORTED_PROTOCOL_USB2_LOW_SPEED_PSIM 1500 + #pragma pack (1) typedef struct { UINT8 MaxSlots; // Number of Device Slots @@ -130,6 +143,52 @@ typedef union { HCCPARAMS Data; } XHC_HCCPARAMS; =20 +// +// xHCI Supported Protocol Cabability +// +typedef struct { + UINT8 CapId; + UINT8 NextExtCapReg; + UINT8 RevMinor; + UINT8 RevMajor; +} SUPPORTED_PROTOCOL_DW0; + +typedef union { + UINT32 Dword; + SUPPORTED_PROTOCOL_DW0 Data; +} XHC_SUPPORTED_PROTOCOL_DW0; + +typedef struct { + UINT32 NameString; +} XHC_SUPPORTED_PROTOCOL_DW1; + +typedef struct { + UINT8 CompPortOffset; + UINT8 CompPortCount; + UINT16 ProtocolDef : 12; + UINT16 Psic : 4; +} SUPPORTED_PROTOCOL_DW2; + +typedef union { + UINT32 Dword; + SUPPORTED_PROTOCOL_DW2 Data; +} XHC_SUPPORTED_PROTOCOL_DW2; + +typedef struct { + UINT16 Psiv : 4; + UINT16 Psie : 2; + UINT16 Plt : 2; + UINT16 Pfd : 1; + UINT16 RsvdP : 5; + UINT16 Lp : 2; + UINT16 Psim; +} SUPPORTED_PROTOCOL_PROTOCOL_SPEED_ID; + +typedef union { + UINT32 Dword; + SUPPORTED_PROTOCOL_PROTOCOL_SPEED_ID Data; +} XHC_SUPPORTED_PROTOCOL_PROTOCOL_SPEED_ID; + #pragma pack () =20 // @@ -546,4 +605,33 @@ XhcGetCapabilityAddr ( IN UINT8 CapId ); =20 +/** + Calculate the offset of the xHCI Supported Protocol Capability. + + @param Xhc The XHCI Instance. + @param MajorVersion The USB Major Version in xHCI Support Protocol Cap= ability Field + + @return The offset of xHCI Supported Protocol capability register. + +**/ +UINT32 +XhcGetSupportedProtocolCapabilityAddr ( + IN USB_XHCI_INSTANCE *Xhc, + IN UINT8 MajorVersion + ); + +/** + Find SpeedField value match with Port Speed ID value. + + @param Xhc The XHCI Instance. + @param Speed The Port Speed filed in USB PortSc register + + @return The USB Port Speed. + +**/ +UINT16 +XhcCheckUsbPortSpeedUsedPsic ( + IN USB_XHCI_INSTANCE *Xhc, + IN UINT8 Speed + ); #endif --=20 2.26.2.windows.1 -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D- Groups.io Links: You receive all messages sent to this group. View/Reply Online (#90711): https://edk2.groups.io/g/devel/message/90711 Mute This Topic: https://groups.io/mt/91938253/1787277 Group Owner: devel+owner@edk2.groups.io Unsubscribe: https://edk2.groups.io/g/devel/unsub [importer@patchew.org] -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-