audk/MdeModulePkg/Bus/Pci/EhciDxe/EhciSched.h

/** @file

Copyright (c) 2007, Intel Corporation
All rights reserved. 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.

Module Name:

  EhciSched.h

Abstract:

  This file contains the definination for host controller schedule routines

Revision History

**/

#ifndef _EFI_EHCI_SCHED_H_
#define _EFI_EHCI_SCHED_H_

EFI_STATUS
EhcInitSched (
  IN USB2_HC_DEV          *Ehc
  )
/*++

Routine Description:

  Initialize the schedule data structure such as frame list

Arguments:

  Ehc - The EHCI device to init schedule data for

Returns:

  EFI_OUT_OF_RESOURCES  - Failed to allocate resource to init schedule data
  EFI_SUCCESS           - The schedule data is initialized

--*/
;



/**
  Free the schedule data. It may be partially initialized.

  @param  Ehc            The EHCI device

  @return None

**/
VOID
EhcFreeSched (
  IN USB2_HC_DEV          *Ehc
  )
;



/**
  Link the queue head to the asynchronous schedule list.
  UEFI only supports one CTRL/BULK transfer at a time
  due to its interfaces. This simplifies the AsynList
  management: A reclamation header is always linked to
  the AsyncListAddr, the only active QH is appended to it.

  @param  Ehc            The EHCI device
  @param  Qh             The queue head to link

  @return None

**/
VOID
EhcLinkQhToAsync (
  IN USB2_HC_DEV          *Ehc,
  IN EHC_QH               *Qh
  )
;


/**
  Unlink a queue head from the asynchronous schedule list.
  Need to synchronize with hardware

  @param  Ehc            The EHCI device
  @param  Qh             The queue head to unlink

  @return None

**/
VOID
EhcUnlinkQhFromAsync (
  IN USB2_HC_DEV          *Ehc,
  IN EHC_QH               *Qh
  )
;


/**
  Link a queue head for interrupt transfer to the periodic
  schedule frame list. This code is very much the same as
  that in UHCI.

  @param  Ehc            The EHCI device
  @param  Qh             The queue head to link

  @return None

**/
VOID
EhcLinkQhToPeriod (
  IN USB2_HC_DEV          *Ehc,
  IN EHC_QH               *Qh
  )
;


/**
  Unlink an interrupt queue head from the periodic
  schedule frame list

  @param  Ehc            The EHCI device
  @param  Qh             The queue head to unlink

  @return None

**/
VOID
EhcUnlinkQhFromPeriod (
  IN USB2_HC_DEV          *Ehc,
  IN EHC_QH               *Qh
  )
;



/**
  Execute the transfer by polling the URB. This is a synchronous operation.

  @param  Ehc            The EHCI device
  @param  Urb            The URB to execute
  @param  TimeOut        The time to wait before abort, in millisecond.

  @return EFI_DEVICE_ERROR : The transfer failed due to transfer error
  @return EFI_TIMEOUT      : The transfer failed due to time out
  @return EFI_SUCCESS      : The transfer finished OK

**/
EFI_STATUS
EhcExecTransfer (
  IN  USB2_HC_DEV         *Ehc,
  IN  URB                 *Urb,
  IN  UINTN               TimeOut
  )
;


/**
  Delete a single asynchronous interrupt transfer for
  the device and endpoint

  @param  Ehc            The EHCI device
  @param  DevAddr        The address of the target device
  @param  EpNum          The endpoint of the target
  @param  DataToggle     Return the next data toggle to use

  @retval EFI_SUCCESS    An asynchronous transfer is removed
  @retval EFI_NOT_FOUND  No transfer for the device is found

**/
EFI_STATUS
EhciDelAsyncIntTransfer (
  IN  USB2_HC_DEV         *Ehc,
  IN  UINT8               DevAddr,
  IN  UINT8               EpNum,
  OUT UINT8               *DataToggle
  )
;


/**
  Remove all the asynchronous interrutp transfers

  @param  Ehc            The EHCI device

  @return None

**/
VOID
EhciDelAllAsyncIntTransfers (
  IN USB2_HC_DEV          *Ehc
  )
;



/**
  Interrupt transfer periodic check handler

  @param  Event          Interrupt event
  @param  Context        Pointer to USB2_HC_DEV

  @return None

**/
VOID
EhcMoniteAsyncRequests (
  IN EFI_EVENT            Event,
  IN VOID                 *Context
  )
;

#endif