Lefi: EFI_USB_HC_PROTOCOL is defined in EFI 1.10. I think it can be deprecated. At least, its consumer code in UsbBusDxe should be removed.
Thanks Liming > -----邮件原件----- > 发件人: [email protected] <[email protected]> 代表 Leif Lindholm > via groups.io > 发送时间: 2025年2月11日 1:02 > 收件人: [email protected] > 抄送: Kinney, Michael D <[email protected]>; Liming Gao > <[email protected]>; Ray Ni <[email protected]>; Ard Biesheuvel > <[email protected]> > 主题: [edk2-devel] Various confusing bits around USB host controller > protocols > > Spotted while looking into https://github.com/tianocore/edk2/pull/10593 > > This starts with > https://github.com/tianocore/edk2/blob/master/MdeModulePkg/Include/Ppi > /Usb2HostController.h#L244, > which states that PEI_USB2_HOST_CONTROLLER_PPI is modelled after > EFI_USB2_HOST_CONTROLLER_PROTOCOL as described by UEFI 2.3. > > The problem is that > 1) UEFI 2.3 does not describe any EFI_USB2_HOST_CONTROLLER_PROTOCOL > (it describes a EFI_USB2_HC_PROTOCOL, which thankfully is what edk2 > uses elsewhere). > 2) EFI_USB2_HC_PROTOCOL does not contain a GetRootHubPortNumber(). > 3) The specification still references GetRootHubPortNumber() in three > locations. > 4) > https://github.com/tianocore/edk2/blob/master/MdePkg/Include/Protocol/U > sbHostController.h#L464 > defines a EFI_USB_HC_PROTOCOL that is not described by the UEFI > specification version 2.0 or later. > > As far as I can tell there is one clear errata in the UEFI > speficiation: the references to GetRootHubPortNumber(). > Which presumably should be updated to reflect that the information > should be retrieved from GetCapability() instead (which UsbBusDxe > does). > Are there any other implications? > > But that leaves the support for the extra-spec EFI_USB_HC_PROTOCOL. > Why is it still there, in UsbBusDxe, and is anyone actually using it? > Relying on it? > Could we delete it? Deprecate it? > > I don't know what if anything should be done about the > PEI_USB*_HOST_CONTROLLER_PPI structs, but the comments describing > them > are actively misleading and should be updated *somehow*. > > / > Leif > > > > -=-=-=-=-=-=-=-=-=-=-=- Groups.io Links: You receive all messages sent to this group. View/Reply Online (#121115): https://edk2.groups.io/g/devel/message/121115 Mute This Topic: https://groups.io/mt/111116998/21656 Group Owner: [email protected] Unsubscribe: https://edk2.groups.io/g/devel/unsub [[email protected]] -=-=-=-=-=-=-=-=-=-=-=-
