2 Constants definitions for Usb Hub Peim
4 Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>
6 This program and the accompanying materials
7 are licensed and made available under the terms and conditions
8 of the BSD License which accompanies this distribution. The
9 full text of the license may be found at
10 http://opensource.org/licenses/bsd-license.php
12 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
13 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
17 #ifndef _PEI_HUB_PEIM_H_
18 #define _PEI_HUB_PEIM_H_
22 // Hub feature numbers
24 #define C_HUB_LOCAL_POWER 0
25 #define C_HUB_OVER_CURRENT 1
28 // Hub class code & sub class code
30 #define CLASS_CODE_HUB 0x09
31 #define SUB_CLASS_CODE_HUB 0
34 // Hub Status & Hub Change bit masks
36 #define HUB_STATUS_LOCAL_POWER 0x0001
37 #define HUB_STATUS_OVERCURRENT 0x0002
39 #define HUB_CHANGE_LOCAL_POWER 0x0001
40 #define HUB_CHANGE_OVERCURRENT 0x0002
43 // Hub Characteristics
45 #define HUB_CHAR_LPSM 0x0003
46 #define HUB_CHAR_COMPOUND 0x0004
47 #define HUB_CHAR_OCPM 0x0018
50 // Standard hub request and request type
51 // By [Spec-USB20/Chapter-11.24]
53 #define USB_HUB_CLEAR_FEATURE 0x01
54 #define USB_HUB_CLEAR_FEATURE_REQ_TYPE 0x20
56 #define USB_HUB_CLEAR_FEATURE_PORT 0x01
57 #define USB_HUB_CLEAR_FEATURE_PORT_REQ_TYPE 0x23
59 #define USB_HUB_GET_BUS_STATE 0x02
60 #define USB_HUB_GET_BUS_STATE_REQ_TYPE 0xA3
62 #define USB_HUB_GET_DESCRIPTOR 0x06
63 #define USB_HUB_GET_DESCRIPTOR_REQ_TYPE 0xA0
65 #define USB_HUB_GET_HUB_STATUS 0x00
66 #define USB_HUB_GET_HUB_STATUS_REQ_TYPE 0xA0
68 #define USB_HUB_GET_PORT_STATUS 0x00
69 #define USB_HUB_GET_PORT_STATUS_REQ_TYPE 0xA3
71 #define USB_HUB_SET_DESCRIPTOR 0x07
72 #define USB_HUB_SET_DESCRIPTOR_REQ_TYPE 0x20
74 #define USB_HUB_SET_HUB_FEATURE 0x03
75 #define USB_HUB_SET_HUB_FEATURE_REQ_TYPE 0x20
77 #define USB_HUB_SET_PORT_FEATURE 0x03
78 #define USB_HUB_SET_PORT_FEATURE_REQ_TYPE 0x23
80 #define USB_RT_HUB (USB_TYPE_CLASS | USB_RECIP_DEVICE)
81 #define USB_RT_PORT (USB_TYPE_CLASS | USB_RECIP_OTHER)
83 #define USB_HUB_REQ_SET_DEPTH 12
88 // Hub descriptor, the last two fields are of variable lenght.
94 UINT8 HubCharacteristics
[2];
96 UINT8 HubContrCurrent
;
97 UINT8 Filler
[MAXBYTES
];
98 } EFI_USB_HUB_DESCRIPTOR
;
102 UINT16 HubChangeStatus
;
103 } EFI_USB_HUB_STATUS
;
107 Get a given hub port status.
109 @param PeiServices General-purpose services that are available to every PEIM.
110 @param UsbIoPpi Indicates the PEI_USB_IO_PPI instance.
111 @param Port Usb hub port number (starting from 1).
112 @param PortStatus Current Hub port status and change status.
114 @retval EFI_SUCCESS Port status is obtained successfully.
115 @retval EFI_DEVICE_ERROR Cannot get the port status due to a hardware error.
116 @retval Others Other failure occurs.
120 PeiHubGetPortStatus (
121 IN EFI_PEI_SERVICES
**PeiServices
,
122 IN PEI_USB_IO_PPI
*UsbIoPpi
,
124 OUT UINT32
*PortStatus
128 Set specified feature to a given hub port.
130 @param PeiServices General-purpose services that are available to every PEIM.
131 @param UsbIoPpi Indicates the PEI_USB_IO_PPI instance.
132 @param Port Usb hub port number (starting from 1).
133 @param Value New feature value.
135 @retval EFI_SUCCESS Port feature is set successfully.
136 @retval EFI_DEVICE_ERROR Cannot set the port feature due to a hardware error.
137 @retval Others Other failure occurs.
141 PeiHubSetPortFeature (
142 IN EFI_PEI_SERVICES
**PeiServices
,
143 IN PEI_USB_IO_PPI
*UsbIoPpi
,
149 Set specified feature to a given hub.
151 @param PeiServices General-purpose services that are available to every PEIM.
152 @param UsbIoPpi Indicates the PEI_USB_IO_PPI instance.
153 @param Value New feature value.
155 @retval EFI_SUCCESS Port feature is set successfully.
156 @retval EFI_DEVICE_ERROR Cannot set the port feature due to a hardware error.
157 @retval Others Other failure occurs.
161 PeiHubSetHubFeature (
162 IN EFI_PEI_SERVICES
**PeiServices
,
163 IN PEI_USB_IO_PPI
*UsbIoPpi
,
168 Get a given hub status.
170 @param PeiServices General-purpose services that are available to every PEIM.
171 @param UsbIoPpi Indicates the PEI_USB_IO_PPI instance.
172 @param HubStatus Current Hub status and change status.
174 @retval EFI_SUCCESS Hub status is obtained successfully.
175 @retval EFI_DEVICE_ERROR Cannot get the hub status due to a hardware error.
176 @retval Others Other failure occurs.
181 IN EFI_PEI_SERVICES
**PeiServices
,
182 IN PEI_USB_IO_PPI
*UsbIoPpi
,
183 OUT UINT32
*HubStatus
187 Clear specified feature on a given hub port.
189 @param PeiServices General-purpose services that are available to every PEIM.
190 @param UsbIoPpi Indicates the PEI_USB_IO_PPI instance.
191 @param Port Usb hub port number (starting from 1).
192 @param Value Feature value that will be cleared from the hub port.
194 @retval EFI_SUCCESS Port feature is cleared successfully.
195 @retval EFI_DEVICE_ERROR Cannot clear the port feature due to a hardware error.
196 @retval Others Other failure occurs.
200 PeiHubClearPortFeature (
201 IN EFI_PEI_SERVICES
**PeiServices
,
202 IN PEI_USB_IO_PPI
*UsbIoPpi
,
208 Clear specified feature on a given hub.
210 @param PeiServices General-purpose services that are available to every PEIM.
211 @param UsbIoPpi Indicates the PEI_USB_IO_PPI instance.
212 @param Value Feature value that will be cleared from the hub port.
214 @retval EFI_SUCCESS Hub feature is cleared successfully.
215 @retval EFI_DEVICE_ERROR Cannot clear the hub feature due to a hardware error.
216 @retval Others Other failure occurs.
220 PeiHubClearHubFeature (
221 IN EFI_PEI_SERVICES
**PeiServices
,
222 IN PEI_USB_IO_PPI
*UsbIoPpi
,
227 Get a given hub descriptor.
229 @param PeiServices General-purpose services that are available to every PEIM.
230 @param PeiUsbDevice Indicates the hub controller device.
231 @param UsbIoPpi Indicates the PEI_USB_IO_PPI instance.
232 @param DescriptorSize The length of Hub Descriptor buffer.
233 @param HubDescriptor Caller allocated buffer to store the hub descriptor if
234 successfully returned.
236 @retval EFI_SUCCESS Hub descriptor is obtained successfully.
237 @retval EFI_DEVICE_ERROR Cannot get the hub descriptor due to a hardware error.
238 @retval Others Other failure occurs.
242 PeiGetHubDescriptor (
243 IN EFI_PEI_SERVICES
**PeiServices
,
244 IN PEI_USB_DEVICE
*PeiUsbDevice
,
245 IN PEI_USB_IO_PPI
*UsbIoPpi
,
246 IN UINTN DescriptorSize
,
247 OUT EFI_USB_HUB_DESCRIPTOR
*HubDescriptor
251 Configure a given hub.
253 @param PeiServices General-purpose services that are available to every PEIM.
254 @param PeiUsbDevice Indicating the hub controller device that will be configured
256 @retval EFI_SUCCESS Hub configuration is done successfully.
257 @retval EFI_DEVICE_ERROR Cannot configure the hub due to a hardware error.
262 IN EFI_PEI_SERVICES
**PeiServices
,
263 IN PEI_USB_DEVICE
*PeiUsbDevice
267 Send reset signal over the given root hub port.
269 @param PeiServices General-purpose services that are available to every PEIM.
270 @param UsbIoPpi Indicates the PEI_USB_IO_PPI instance.
271 @param PortNum Usb hub port number (starting from 1).
276 IN EFI_PEI_SERVICES
**PeiServices
,
277 IN PEI_USB_IO_PPI
*UsbIoPpi
,