mirror of https://github.com/acidanthera/audk.git
228 lines
7.0 KiB
C
228 lines
7.0 KiB
C
/** @file
|
|
Private Header file for Usb Host Controller PEIM
|
|
|
|
Copyright (c) 2010, Intel Corporation. All rights reserved.<BR>
|
|
|
|
This program and the accompanying materials
|
|
are licensed and made available under the terms and conditions
|
|
of the BSD License which accompanies this distribution. The
|
|
full text of the license may be found at
|
|
http://opensource.org/licenses/bsd-license.php
|
|
|
|
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
|
|
|
|
**/
|
|
|
|
#ifndef _RECOVERY_EHC_H_
|
|
#define _RECOVERY_EHC_H_
|
|
|
|
#include <PiPei.h>
|
|
|
|
#include <Ppi/UsbController.h>
|
|
#include <Ppi/Usb2HostController.h>
|
|
|
|
#include <Library/DebugLib.h>
|
|
#include <Library/PeimEntryPoint.h>
|
|
#include <Library/PeiServicesLib.h>
|
|
#include <Library/BaseMemoryLib.h>
|
|
#include <Library/TimerLib.h>
|
|
#include <Library/IoLib.h>
|
|
|
|
typedef struct _PEI_USB2_HC_DEV PEI_USB2_HC_DEV;
|
|
|
|
#define EFI_LIST_ENTRY LIST_ENTRY
|
|
|
|
#include "UsbHcMem.h"
|
|
#include "EhciReg.h"
|
|
#include "EhciUrb.h"
|
|
#include "EhciSched.h"
|
|
|
|
#define EFI_USB_SPEED_FULL 0x0000
|
|
#define EFI_USB_SPEED_LOW 0x0001
|
|
#define EFI_USB_SPEED_HIGH 0x0002
|
|
|
|
#define PAGESIZE 4096
|
|
|
|
#define EHC_1_MICROSECOND 1
|
|
#define EHC_1_MILLISECOND (1000 * EHC_1_MICROSECOND)
|
|
#define EHC_1_SECOND (1000 * EHC_1_MILLISECOND)
|
|
|
|
//
|
|
// EHCI register operation timeout, set by experience
|
|
//
|
|
#define EHC_RESET_TIMEOUT (1 * EHC_1_SECOND)
|
|
#define EHC_GENERIC_TIMEOUT (10 * EHC_1_MILLISECOND)
|
|
|
|
|
|
//
|
|
// Wait for roothub port power stable, refers to Spec[EHCI1.0-2.3.9]
|
|
//
|
|
#define EHC_ROOT_PORT_RECOVERY_STALL (20 * EHC_1_MILLISECOND)
|
|
|
|
//
|
|
// Sync and Async transfer polling interval, set by experience,
|
|
// and the unit of Async is 100us, means 50ms as interval.
|
|
//
|
|
#define EHC_SYNC_POLL_INTERVAL (6 * EHC_1_MILLISECOND)
|
|
|
|
#define EHC_ASYNC_POLL_INTERVAL (50 * 10000U)
|
|
|
|
//
|
|
//Iterate through the doule linked list. NOT delete safe
|
|
//
|
|
#define EFI_LIST_FOR_EACH(Entry, ListHead) \
|
|
for(Entry = (ListHead)->ForwardLink; Entry != (ListHead); Entry = Entry->ForwardLink)
|
|
|
|
//
|
|
//Iterate through the doule linked list. This is delete-safe.
|
|
//Don't touch NextEntry
|
|
//
|
|
#define EFI_LIST_FOR_EACH_SAFE(Entry, NextEntry, ListHead) \
|
|
for(Entry = (ListHead)->ForwardLink, NextEntry = Entry->ForwardLink;\
|
|
Entry != (ListHead); Entry = NextEntry, NextEntry = Entry->ForwardLink)
|
|
|
|
#define EFI_LIST_CONTAINER(Entry, Type, Field) BASE_CR(Entry, Type, Field)
|
|
|
|
|
|
#define EHC_LOW_32BIT(Addr64) ((UINT32)(((UINTN)(Addr64)) & 0XFFFFFFFF))
|
|
#define EHC_HIGH_32BIT(Addr64) ((UINT32)(RShiftU64((UINTN)(Addr64), 32) & 0XFFFFFFFF))
|
|
#define EHC_BIT_IS_SET(Data, Bit) ((BOOLEAN)(((Data) & (Bit)) == (Bit)))
|
|
|
|
#define EHC_REG_BIT_IS_SET(Ehc, Offset, Bit) \
|
|
(EHC_BIT_IS_SET(EhcReadOpReg ((Ehc), (Offset)), (Bit)))
|
|
|
|
#define USB2_HC_DEV_SIGNATURE SIGNATURE_32 ('e', 'h', 'c', 'i')
|
|
|
|
struct _PEI_USB2_HC_DEV {
|
|
UINTN Signature;
|
|
PEI_USB2_HOST_CONTROLLER_PPI Usb2HostControllerPpi;
|
|
EFI_PEI_PPI_DESCRIPTOR PpiDescriptor;
|
|
UINT32 UsbHostControllerBaseAddress;
|
|
PEI_URB *Urb;
|
|
USBHC_MEM_POOL *MemPool;
|
|
|
|
//
|
|
// Schedule data shared between asynchronous and periodic
|
|
// transfers:
|
|
// ShortReadStop, as its name indicates, is used to terminate
|
|
// the short read except the control transfer. EHCI follows
|
|
// the alternative next QTD point when a short read happens.
|
|
// For control transfer, even the short read happens, try the
|
|
// status stage.
|
|
//
|
|
PEI_EHC_QTD *ShortReadStop;
|
|
EFI_EVENT PollTimer;
|
|
|
|
//
|
|
// Asynchronous(bulk and control) transfer schedule data:
|
|
// ReclaimHead is used as the head of the asynchronous transfer
|
|
// list. It acts as the reclamation header.
|
|
//
|
|
PEI_EHC_QH *ReclaimHead;
|
|
|
|
//
|
|
// Peroidic (interrupt) transfer schedule data:
|
|
//
|
|
VOID *PeriodFrame; // Mapped as common buffer
|
|
VOID *PeriodFrameHost;
|
|
VOID *PeriodFrameMap;
|
|
|
|
PEI_EHC_QH *PeriodOne;
|
|
EFI_LIST_ENTRY AsyncIntTransfers;
|
|
|
|
//
|
|
// EHCI configuration data
|
|
//
|
|
UINT32 HcStructParams; // Cache of HC structure parameter, EHC_HCSPARAMS_OFFSET
|
|
UINT32 HcCapParams; // Cache of HC capability parameter, HCCPARAMS
|
|
UINT32 CapLen; // Capability length
|
|
UINT32 High32bitAddr;
|
|
};
|
|
|
|
#define PEI_RECOVERY_USB_EHC_DEV_FROM_EHCI_THIS(a) CR (a, PEI_USB2_HC_DEV, Usb2HostControllerPpi, USB2_HC_DEV_SIGNATURE)
|
|
|
|
/**
|
|
@param EhcDev EHCI Device.
|
|
|
|
@retval EFI_SUCCESS EHCI successfully initialized.
|
|
@retval EFI_ABORTED EHCI was failed to be initialized.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
InitializeUsbHC (
|
|
IN PEI_USB2_HC_DEV *EhcDev
|
|
);
|
|
|
|
/**
|
|
Initialize the memory management pool for the host controller.
|
|
|
|
@param Ehc The EHCI device.
|
|
@param Check4G Whether the host controller requires allocated memory
|
|
from one 4G address space.
|
|
@param Which4G The 4G memory area each memory allocated should be from.
|
|
|
|
@retval EFI_SUCCESS The memory pool is initialized.
|
|
@retval EFI_OUT_OF_RESOURCE Fail to init the memory pool.
|
|
|
|
**/
|
|
USBHC_MEM_POOL *
|
|
UsbHcInitMemPool (
|
|
IN PEI_USB2_HC_DEV *Ehc,
|
|
IN BOOLEAN Check4G,
|
|
IN UINT32 Which4G
|
|
)
|
|
;
|
|
|
|
/**
|
|
Release the memory management pool.
|
|
|
|
@param Pool The USB memory pool to free.
|
|
|
|
@retval EFI_DEVICE_ERROR Fail to free the memory pool.
|
|
@retval EFI_SUCCESS The memory pool is freed.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
UsbHcFreeMemPool (
|
|
IN USBHC_MEM_POOL *Pool
|
|
)
|
|
;
|
|
|
|
/**
|
|
Allocate some memory from the host controller's memory pool
|
|
which can be used to communicate with host controller.
|
|
|
|
@param Ehc The EHCI device.
|
|
@param Pool The host controller's memory pool.
|
|
@param Size Size of the memory to allocate.
|
|
|
|
@return The allocated memory or NULL.
|
|
|
|
**/
|
|
VOID *
|
|
UsbHcAllocateMem (
|
|
IN PEI_USB2_HC_DEV *Ehc,
|
|
IN USBHC_MEM_POOL *Pool,
|
|
IN UINTN Size
|
|
)
|
|
;
|
|
|
|
/**
|
|
Free the allocated memory back to the memory pool.
|
|
|
|
@param Pool The memory pool of the host controller.
|
|
@param Mem The memory to free.
|
|
@param Size The size of the memory to free.
|
|
|
|
**/
|
|
VOID
|
|
UsbHcFreeMem (
|
|
IN USBHC_MEM_POOL *Pool,
|
|
IN VOID *Mem,
|
|
IN UINTN Size
|
|
)
|
|
;
|
|
|
|
#endif
|