1436aea4d5
REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3737 Apply uncrustify changes to .c/.h files in the MdeModulePkg package Cc: Andrew Fish <afish@apple.com> Cc: Leif Lindholm <leif@nuviainc.com> Cc: Michael D Kinney <michael.d.kinney@intel.com> Signed-off-by: Michael Kubacki <michael.kubacki@microsoft.com> Reviewed-by: Liming Gao <gaoliming@byosoft.com.cn>
779 lines
28 KiB
C
779 lines
28 KiB
C
/** @file
|
|
Private Include file for IdeBus PEIM.
|
|
|
|
Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>
|
|
|
|
SPDX-License-Identifier: BSD-2-Clause-Patent
|
|
|
|
**/
|
|
|
|
#ifndef _RECOVERY_ATAPI_H_
|
|
#define _RECOVERY_ATAPI_H_
|
|
|
|
#include <PiPei.h>
|
|
|
|
#include <Ppi/BlockIo.h>
|
|
#include <Ppi/BlockIo2.h>
|
|
#include <Ppi/AtaController.h>
|
|
|
|
#include <Library/DebugLib.h>
|
|
#include <Library/TimerLib.h>
|
|
#include <Library/PeimEntryPoint.h>
|
|
#include <Library/PeiServicesLib.h>
|
|
#include <Library/BaseMemoryLib.h>
|
|
#include <Library/IoLib.h>
|
|
#include <Library/PeiServicesTablePointerLib.h>
|
|
#include <Library/MemoryAllocationLib.h>
|
|
#include <Library/PcdLib.h>
|
|
|
|
#include <IndustryStandard/Atapi.h>
|
|
|
|
#define MAX_SENSE_KEY_COUNT 6
|
|
#define MAX_IDE_CHANNELS 4 // Ide and Sata Primary, Secondary Channel.
|
|
#define MAX_IDE_DEVICES 8 // Ide, Sata Primary, Secondary and Master, Slave device.
|
|
|
|
typedef enum {
|
|
IdePrimary = 0,
|
|
IdeSecondary = 1,
|
|
IdeMaxChannel = 2
|
|
} EFI_IDE_CHANNEL;
|
|
|
|
typedef enum {
|
|
IdeMaster = 0,
|
|
IdeSlave = 1,
|
|
IdeMaxDevice = 2
|
|
} EFI_IDE_DEVICE;
|
|
|
|
//
|
|
// IDE Registers
|
|
//
|
|
typedef union {
|
|
UINT16 Command; /* when write */
|
|
UINT16 Status; /* when read */
|
|
} IDE_CMD_OR_STATUS;
|
|
|
|
typedef union {
|
|
UINT16 Error; /* when read */
|
|
UINT16 Feature; /* when write */
|
|
} IDE_ERROR_OR_FEATURE;
|
|
|
|
typedef union {
|
|
UINT16 AltStatus; /* when read */
|
|
UINT16 DeviceControl; /* when write */
|
|
} IDE_ALTSTATUS_OR_DEVICECONTROL;
|
|
|
|
//
|
|
// IDE registers set
|
|
//
|
|
typedef struct {
|
|
UINT16 Data;
|
|
IDE_ERROR_OR_FEATURE Reg1;
|
|
UINT16 SectorCount;
|
|
UINT16 SectorNumber;
|
|
UINT16 CylinderLsb;
|
|
UINT16 CylinderMsb;
|
|
UINT16 Head;
|
|
IDE_CMD_OR_STATUS Reg;
|
|
|
|
IDE_ALTSTATUS_OR_DEVICECONTROL Alt;
|
|
UINT16 DriveAddress;
|
|
} IDE_BASE_REGISTERS;
|
|
|
|
typedef struct {
|
|
UINTN DevicePosition;
|
|
EFI_PEI_BLOCK_IO_MEDIA MediaInfo;
|
|
EFI_PEI_BLOCK_IO2_MEDIA MediaInfo2;
|
|
} PEI_ATAPI_DEVICE_INFO;
|
|
|
|
#define ATAPI_BLK_IO_DEV_SIGNATURE SIGNATURE_32 ('a', 'b', 'i', 'o')
|
|
typedef struct {
|
|
UINTN Signature;
|
|
|
|
EFI_PEI_RECOVERY_BLOCK_IO_PPI AtapiBlkIo;
|
|
EFI_PEI_RECOVERY_BLOCK_IO2_PPI AtapiBlkIo2;
|
|
EFI_PEI_PPI_DESCRIPTOR PpiDescriptor;
|
|
EFI_PEI_PPI_DESCRIPTOR PpiDescriptor2;
|
|
PEI_ATA_CONTROLLER_PPI *AtaControllerPpi;
|
|
|
|
UINTN DeviceCount;
|
|
PEI_ATAPI_DEVICE_INFO DeviceInfo[MAX_IDE_DEVICES]; // for max 8 device
|
|
IDE_BASE_REGISTERS IdeIoPortReg[MAX_IDE_CHANNELS]; // for max 4 channel.
|
|
} ATAPI_BLK_IO_DEV;
|
|
|
|
#define PEI_RECOVERY_ATAPI_FROM_BLKIO_THIS(a) CR (a, ATAPI_BLK_IO_DEV, AtapiBlkIo, ATAPI_BLK_IO_DEV_SIGNATURE)
|
|
#define PEI_RECOVERY_ATAPI_FROM_BLKIO2_THIS(a) CR (a, ATAPI_BLK_IO_DEV, AtapiBlkIo2, ATAPI_BLK_IO_DEV_SIGNATURE)
|
|
|
|
#define STALL_1_MILLI_SECOND 1000 // stall 1 ms
|
|
#define STALL_1_SECONDS 1000 * STALL_1_MILLI_SECOND
|
|
|
|
//
|
|
// Time Out Value For IDE Device Polling
|
|
//
|
|
// ATATIMEOUT is used for waiting time out for ATA device
|
|
//
|
|
#define ATATIMEOUT 1000 // 1 second
|
|
// ATAPITIMEOUT is used for waiting operation
|
|
// except read and write time out for ATAPI device
|
|
//
|
|
#define ATAPITIMEOUT 1000 // 1 second
|
|
// ATAPILONGTIMEOUT is used for waiting read and
|
|
// write operation timeout for ATAPI device
|
|
//
|
|
#define CDROMLONGTIMEOUT 2000 // 2 seconds
|
|
#define ATAPILONGTIMEOUT 5000 // 5 seconds
|
|
|
|
//
|
|
// PEI Recovery Block I/O PPI
|
|
//
|
|
|
|
/**
|
|
Gets the count of block I/O devices that one specific block driver detects.
|
|
|
|
This function is used for getting the count of block I/O devices that one
|
|
specific block driver detects. To the PEI ATAPI driver, it returns the number
|
|
of all the detected ATAPI devices it detects during the enumeration process.
|
|
To the PEI legacy floppy driver, it returns the number of all the legacy
|
|
devices it finds during its enumeration process. If no device is detected,
|
|
then the function will return zero.
|
|
|
|
@param[in] PeiServices General-purpose services that are available
|
|
to every PEIM.
|
|
@param[in] This Indicates the EFI_PEI_RECOVERY_BLOCK_IO_PPI
|
|
instance.
|
|
@param[out] NumberBlockDevices The number of block I/O devices discovered.
|
|
|
|
@retval EFI_SUCCESS Operation performed successfully.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
AtapiGetNumberOfBlockDevices (
|
|
IN EFI_PEI_SERVICES **PeiServices,
|
|
IN EFI_PEI_RECOVERY_BLOCK_IO_PPI *This,
|
|
OUT UINTN *NumberBlockDevices
|
|
);
|
|
|
|
/**
|
|
Gets a block device's media information.
|
|
|
|
This function will provide the caller with the specified block device's media
|
|
information. If the media changes, calling this function will update the media
|
|
information accordingly.
|
|
|
|
@param[in] PeiServices General-purpose services that are available to every
|
|
PEIM
|
|
@param[in] This Indicates the EFI_PEI_RECOVERY_BLOCK_IO_PPI instance.
|
|
@param[in] DeviceIndex Specifies the block device to which the function wants
|
|
to talk. Because the driver that implements Block I/O
|
|
PPIs will manage multiple block devices, the PPIs that
|
|
want to talk to a single device must specify the
|
|
device index that was assigned during the enumeration
|
|
process. This index is a number from one to
|
|
NumberBlockDevices.
|
|
@param[out] MediaInfo The media information of the specified block media.
|
|
The caller is responsible for the ownership of this
|
|
data structure.
|
|
|
|
@retval EFI_SUCCESS Media information about the specified block device
|
|
was obtained successfully.
|
|
@retval EFI_DEVICE_ERROR Cannot get the media information due to a hardware
|
|
error.
|
|
@retval Others Other failure occurs.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
AtapiGetBlockDeviceMediaInfo (
|
|
IN EFI_PEI_SERVICES **PeiServices,
|
|
IN EFI_PEI_RECOVERY_BLOCK_IO_PPI *This,
|
|
IN UINTN DeviceIndex,
|
|
OUT EFI_PEI_BLOCK_IO_MEDIA *MediaInfo
|
|
);
|
|
|
|
/**
|
|
Reads the requested number of blocks from the specified block device.
|
|
|
|
The function reads the requested number of blocks from the device. All the
|
|
blocks are read, or an error is returned. If there is no media in the device,
|
|
the function returns EFI_NO_MEDIA.
|
|
|
|
@param[in] PeiServices General-purpose services that are available to
|
|
every PEIM.
|
|
@param[in] This Indicates the EFI_PEI_RECOVERY_BLOCK_IO_PPI instance.
|
|
@param[in] DeviceIndex Specifies the block device to which the function wants
|
|
to talk. Because the driver that implements Block I/O
|
|
PPIs will manage multiple block devices, the PPIs that
|
|
want to talk to a single device must specify the device
|
|
index that was assigned during the enumeration process.
|
|
This index is a number from one to NumberBlockDevices.
|
|
@param[in] StartLBA The starting logical block address (LBA) to read from
|
|
on the device
|
|
@param[in] BufferSize The size of the Buffer in bytes. This number must be
|
|
a multiple of the intrinsic block size of the device.
|
|
@param[out] Buffer A pointer to the destination buffer for the data.
|
|
The caller is responsible for the ownership of the
|
|
buffer.
|
|
|
|
@retval EFI_SUCCESS The data was read correctly from the device.
|
|
@retval EFI_DEVICE_ERROR The device reported an error while attempting
|
|
to perform the read operation.
|
|
@retval EFI_INVALID_PARAMETER The read request contains LBAs that are not
|
|
valid, or the buffer is not properly aligned.
|
|
@retval EFI_NO_MEDIA There is no media in the device.
|
|
@retval EFI_BAD_BUFFER_SIZE The BufferSize parameter is not a multiple of
|
|
the intrinsic block size of the device.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
AtapiReadBlocks (
|
|
IN EFI_PEI_SERVICES **PeiServices,
|
|
IN EFI_PEI_RECOVERY_BLOCK_IO_PPI *This,
|
|
IN UINTN DeviceIndex,
|
|
IN EFI_PEI_LBA StartLBA,
|
|
IN UINTN BufferSize,
|
|
OUT VOID *Buffer
|
|
);
|
|
|
|
/**
|
|
Gets the count of block I/O devices that one specific block driver detects.
|
|
|
|
This function is used for getting the count of block I/O devices that one
|
|
specific block driver detects. To the PEI ATAPI driver, it returns the number
|
|
of all the detected ATAPI devices it detects during the enumeration process.
|
|
To the PEI legacy floppy driver, it returns the number of all the legacy
|
|
devices it finds during its enumeration process. If no device is detected,
|
|
then the function will return zero.
|
|
|
|
@param[in] PeiServices General-purpose services that are available
|
|
to every PEIM.
|
|
@param[in] This Indicates the EFI_PEI_RECOVERY_BLOCK_IO2_PPI
|
|
instance.
|
|
@param[out] NumberBlockDevices The number of block I/O devices discovered.
|
|
|
|
@retval EFI_SUCCESS Operation performed successfully.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
AtapiGetNumberOfBlockDevices2 (
|
|
IN EFI_PEI_SERVICES **PeiServices,
|
|
IN EFI_PEI_RECOVERY_BLOCK_IO2_PPI *This,
|
|
OUT UINTN *NumberBlockDevices
|
|
);
|
|
|
|
/**
|
|
Gets a block device's media information.
|
|
|
|
This function will provide the caller with the specified block device's media
|
|
information. If the media changes, calling this function will update the media
|
|
information accordingly.
|
|
|
|
@param[in] PeiServices General-purpose services that are available to every
|
|
PEIM
|
|
@param[in] This Indicates the EFI_PEI_RECOVERY_BLOCK_IO2_PPI instance.
|
|
@param[in] DeviceIndex Specifies the block device to which the function wants
|
|
to talk. Because the driver that implements Block I/O
|
|
PPIs will manage multiple block devices, the PPIs that
|
|
want to talk to a single device must specify the
|
|
device index that was assigned during the enumeration
|
|
process. This index is a number from one to
|
|
NumberBlockDevices.
|
|
@param[out] MediaInfo The media information of the specified block media.
|
|
The caller is responsible for the ownership of this
|
|
data structure.
|
|
|
|
@retval EFI_SUCCESS Media information about the specified block device
|
|
was obtained successfully.
|
|
@retval EFI_DEVICE_ERROR Cannot get the media information due to a hardware
|
|
error.
|
|
@retval Others Other failure occurs.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
AtapiGetBlockDeviceMediaInfo2 (
|
|
IN EFI_PEI_SERVICES **PeiServices,
|
|
IN EFI_PEI_RECOVERY_BLOCK_IO2_PPI *This,
|
|
IN UINTN DeviceIndex,
|
|
OUT EFI_PEI_BLOCK_IO2_MEDIA *MediaInfo
|
|
);
|
|
|
|
/**
|
|
Reads the requested number of blocks from the specified block device.
|
|
|
|
The function reads the requested number of blocks from the device. All the
|
|
blocks are read, or an error is returned. If there is no media in the device,
|
|
the function returns EFI_NO_MEDIA.
|
|
|
|
@param[in] PeiServices General-purpose services that are available to
|
|
every PEIM.
|
|
@param[in] This Indicates the EFI_PEI_RECOVERY_BLOCK_IO2_PPI instance.
|
|
@param[in] DeviceIndex Specifies the block device to which the function wants
|
|
to talk. Because the driver that implements Block I/O
|
|
PPIs will manage multiple block devices, the PPIs that
|
|
want to talk to a single device must specify the device
|
|
index that was assigned during the enumeration process.
|
|
This index is a number from one to NumberBlockDevices.
|
|
@param[in] StartLBA The starting logical block address (LBA) to read from
|
|
on the device
|
|
@param[in] BufferSize The size of the Buffer in bytes. This number must be
|
|
a multiple of the intrinsic block size of the device.
|
|
@param[out] Buffer A pointer to the destination buffer for the data.
|
|
The caller is responsible for the ownership of the
|
|
buffer.
|
|
|
|
@retval EFI_SUCCESS The data was read correctly from the device.
|
|
@retval EFI_DEVICE_ERROR The device reported an error while attempting
|
|
to perform the read operation.
|
|
@retval EFI_INVALID_PARAMETER The read request contains LBAs that are not
|
|
valid, or the buffer is not properly aligned.
|
|
@retval EFI_NO_MEDIA There is no media in the device.
|
|
@retval EFI_BAD_BUFFER_SIZE The BufferSize parameter is not a multiple of
|
|
the intrinsic block size of the device.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
AtapiReadBlocks2 (
|
|
IN EFI_PEI_SERVICES **PeiServices,
|
|
IN EFI_PEI_RECOVERY_BLOCK_IO2_PPI *This,
|
|
IN UINTN DeviceIndex,
|
|
IN EFI_PEI_LBA StartLBA,
|
|
IN UINTN BufferSize,
|
|
OUT VOID *Buffer
|
|
);
|
|
|
|
//
|
|
// Internal functions
|
|
//
|
|
|
|
/**
|
|
Enumerate Atapi devices.
|
|
|
|
This function is used to enumerate Atatpi device in Ide channel.
|
|
|
|
@param[in] AtapiBlkIoDev A pointer to atapi block IO device
|
|
|
|
**/
|
|
VOID
|
|
AtapiEnumerateDevices (
|
|
IN ATAPI_BLK_IO_DEV *AtapiBlkIoDev
|
|
);
|
|
|
|
/**
|
|
Detect Atapi devices.
|
|
|
|
@param[in] AtapiBlkIoDev A pointer to atapi block IO device.
|
|
@param[in] DevicePosition An integer to signify device position.
|
|
@param[out] MediaInfo The media information of the specified block media.
|
|
@param[out] MediaInfo2 The media information 2 of the specified block media.
|
|
|
|
@retval TRUE Atapi device exists in specified position.
|
|
@retval FALSE Atapi device does not exist in specified position.
|
|
|
|
**/
|
|
BOOLEAN
|
|
DiscoverAtapiDevice (
|
|
IN ATAPI_BLK_IO_DEV *AtapiBlkIoDev,
|
|
IN UINTN DevicePosition,
|
|
OUT EFI_PEI_BLOCK_IO_MEDIA *MediaInfo,
|
|
OUT EFI_PEI_BLOCK_IO2_MEDIA *MediaInfo2
|
|
);
|
|
|
|
/**
|
|
Detect if an IDE controller exists in specified position.
|
|
|
|
@param[in] AtapiBlkIoDev A pointer to atapi block IO device.
|
|
@param[in] DevicePosition An integer to signify device position.
|
|
|
|
@retval TRUE The Atapi device exists.
|
|
@retval FALSE The Atapi device does not present.
|
|
|
|
**/
|
|
BOOLEAN
|
|
DetectIDEController (
|
|
IN ATAPI_BLK_IO_DEV *AtapiBlkIoDev,
|
|
IN UINTN DevicePosition
|
|
);
|
|
|
|
/**
|
|
Wait specified time interval to poll for BSY bit clear in the Status Register.
|
|
|
|
@param[in] AtapiBlkIoDev A pointer to atapi block IO device.
|
|
@param[in] IdeIoRegisters A pointer to IDE IO registers.
|
|
@param[in] TimeoutInMilliSeconds Time specified in milliseconds.
|
|
|
|
@retval EFI_SUCCESS BSY bit is cleared in the specified time interval.
|
|
@retval EFI_TIMEOUT BSY bit is not cleared in the specified time interval.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
WaitForBSYClear (
|
|
IN ATAPI_BLK_IO_DEV *AtapiBlkIoDev,
|
|
IN IDE_BASE_REGISTERS *IdeIoRegisters,
|
|
IN UINTN TimeoutInMilliSeconds
|
|
);
|
|
|
|
/**
|
|
Wait specified time interval to poll for DRDY bit set in the Status register.
|
|
|
|
@param[in] AtapiBlkIoDev A pointer to atapi block IO device.
|
|
@param[in] IdeIoRegisters A pointer to IDE IO registers.
|
|
@param[in] TimeoutInMilliSeconds Time specified in milliseconds.
|
|
|
|
@retval EFI_SUCCESS DRDY bit is set in the specified time interval.
|
|
@retval EFI_TIMEOUT DRDY bit is not set in the specified time interval.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
DRDYReady (
|
|
IN ATAPI_BLK_IO_DEV *AtapiBlkIoDev,
|
|
IN IDE_BASE_REGISTERS *IdeIoRegisters,
|
|
IN UINTN TimeoutInMilliSeconds
|
|
);
|
|
|
|
/**
|
|
Wait specified time interval to poll for DRQ bit clear in the Status Register.
|
|
|
|
@param[in] AtapiBlkIoDev A pointer to atapi block IO device.
|
|
@param[in] IdeIoRegisters A pointer to IDE IO registers.
|
|
@param[in] TimeoutInMilliSeconds Time specified in milliseconds.
|
|
|
|
@retval EFI_SUCCESS DRQ bit is cleared in the specified time interval.
|
|
@retval EFI_TIMEOUT DRQ bit is not cleared in the specified time interval.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
DRQClear (
|
|
IN ATAPI_BLK_IO_DEV *AtapiBlkIoDev,
|
|
IN IDE_BASE_REGISTERS *IdeIoRegisters,
|
|
IN UINTN TimeoutInMilliSeconds
|
|
);
|
|
|
|
/**
|
|
Wait specified time interval to poll for DRQ bit clear in the Alternate Status Register.
|
|
|
|
@param[in] AtapiBlkIoDev A pointer to atapi block IO device.
|
|
@param[in] IdeIoRegisters A pointer to IDE IO registers.
|
|
@param[in] TimeoutInMilliSeconds Time specified in milliseconds.
|
|
|
|
@retval EFI_SUCCESS DRQ bit is cleared in the specified time interval.
|
|
@retval EFI_TIMEOUT DRQ bit is not cleared in the specified time interval.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
DRQClear2 (
|
|
IN ATAPI_BLK_IO_DEV *AtapiBlkIoDev,
|
|
IN IDE_BASE_REGISTERS *IdeIoRegisters,
|
|
IN UINTN TimeoutInMilliSeconds
|
|
);
|
|
|
|
/**
|
|
Wait specified time interval to poll for DRQ bit set in the Status Register.
|
|
|
|
@param[in] AtapiBlkIoDev A pointer to atapi block IO device.
|
|
@param[in] IdeIoRegisters A pointer to IDE IO registers.
|
|
@param[in] TimeoutInMilliSeconds Time specified in milliseconds.
|
|
|
|
@retval EFI_SUCCESS DRQ bit is set in the specified time interval.
|
|
@retval EFI_TIMEOUT DRQ bit is not set in the specified time interval.
|
|
@retval EFI_ABORTED Operation Aborted.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
DRQReady (
|
|
IN ATAPI_BLK_IO_DEV *AtapiBlkIoDev,
|
|
IN IDE_BASE_REGISTERS *IdeIoRegisters,
|
|
IN UINTN TimeoutInMilliSeconds
|
|
);
|
|
|
|
/**
|
|
Wait specified time interval to poll for DRQ bit set in the Alternate Status Register.
|
|
|
|
@param[in] AtapiBlkIoDev A pointer to atapi block IO device.
|
|
@param[in] IdeIoRegisters A pointer to IDE IO registers.
|
|
@param[in] TimeoutInMilliSeconds Time specified in milliseconds.
|
|
|
|
@retval EFI_SUCCESS DRQ bit is set in the specified time interval.
|
|
@retval EFI_TIMEOUT DRQ bit is not set in the specified time interval.
|
|
@retval EFI_ABORTED Operation Aborted.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
DRQReady2 (
|
|
IN ATAPI_BLK_IO_DEV *AtapiBlkIoDev,
|
|
IN IDE_BASE_REGISTERS *IdeIoRegisters,
|
|
IN UINTN TimeoutInMilliSeconds
|
|
);
|
|
|
|
/**
|
|
Check if there is an error in Status Register.
|
|
|
|
@param[in] AtapiBlkIoDev A pointer to atapi block IO device.
|
|
@param[in] StatusReg The address to IDE IO registers.
|
|
|
|
@retval EFI_SUCCESS Operation success.
|
|
@retval EFI_DEVICE_ERROR Device error.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
CheckErrorStatus (
|
|
IN ATAPI_BLK_IO_DEV *AtapiBlkIoDev,
|
|
IN UINT16 StatusReg
|
|
);
|
|
|
|
/**
|
|
Idendify Atapi devices.
|
|
|
|
@param[in] AtapiBlkIoDev A pointer to atapi block IO device.
|
|
@param[in] DevicePosition An integer to signify device position.
|
|
|
|
@retval EFI_SUCCESS Identify successfully.
|
|
@retval EFI_DEVICE_ERROR Device cannot be identified successfully.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
ATAPIIdentify (
|
|
IN ATAPI_BLK_IO_DEV *AtapiBlkIoDev,
|
|
IN UINTN DevicePosition
|
|
);
|
|
|
|
/**
|
|
Sends out ATAPI Test Unit Ready Packet Command to the specified device
|
|
to find out whether device is accessible.
|
|
|
|
@param[in] AtapiBlkIoDev A pointer to atapi block IO device.
|
|
@param[in] DevicePosition An integer to signify device position.
|
|
|
|
@retval EFI_SUCCESS TestUnit command executed successfully.
|
|
@retval EFI_DEVICE_ERROR Device cannot be executed TestUnit command successfully.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
TestUnitReady (
|
|
IN ATAPI_BLK_IO_DEV *AtapiBlkIoDev,
|
|
IN UINTN DevicePosition
|
|
);
|
|
|
|
/**
|
|
Send out ATAPI commands conforms to the Packet Command with PIO Data In Protocol.
|
|
|
|
@param[in] AtapiBlkIoDev A pointer to atapi block IO device.
|
|
@param[in] DevicePosition An integer to signify device position.
|
|
@param[in] Packet A pointer to ATAPI command packet.
|
|
@param[in] Buffer Buffer to contain requested transfer data from device.
|
|
@param[in] ByteCount Requested transfer data length.
|
|
@param[in] TimeoutInMilliSeconds Time out value, in unit of milliseconds.
|
|
|
|
@retval EFI_SUCCESS Command executed successfully.
|
|
@retval EFI_DEVICE_ERROR Device cannot be executed command successfully.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
AtapiPacketCommandIn (
|
|
IN ATAPI_BLK_IO_DEV *AtapiBlkIoDev,
|
|
IN UINTN DevicePosition,
|
|
IN ATAPI_PACKET_COMMAND *Packet,
|
|
IN UINT16 *Buffer,
|
|
IN UINT32 ByteCount,
|
|
IN UINTN TimeoutInMilliSeconds
|
|
);
|
|
|
|
/**
|
|
Sends out ATAPI Inquiry Packet Command to the specified device.
|
|
This command will return INQUIRY data of the device.
|
|
|
|
@param[in] AtapiBlkIoDev A pointer to atapi block IO device.
|
|
@param[in] DevicePosition An integer to signify device position.
|
|
@param[out] MediaInfo The media information of the specified block media.
|
|
@param[out] MediaInfo2 The media information 2 of the specified block media.
|
|
|
|
@retval EFI_SUCCESS Command executed successfully.
|
|
@retval EFI_DEVICE_ERROR Device cannot be executed command successfully.
|
|
@retval EFI_UNSUPPORTED Unsupported device type.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
Inquiry (
|
|
IN ATAPI_BLK_IO_DEV *AtapiBlkIoDev,
|
|
IN UINTN DevicePosition,
|
|
OUT EFI_PEI_BLOCK_IO_MEDIA *MediaInfo,
|
|
OUT EFI_PEI_BLOCK_IO2_MEDIA *MediaInfo2
|
|
);
|
|
|
|
/**
|
|
Used before read/write blocks from/to ATAPI device media.
|
|
Since ATAPI device media is removable, it is necessary to detect
|
|
whether media is present and get current present media's information.
|
|
|
|
@param[in] AtapiBlkIoDev A pointer to atapi block IO device.
|
|
@param[in] DevicePosition An integer to signify device position.
|
|
@param[in, out] MediaInfo The media information of the specified block media.
|
|
@param[in, out] MediaInfo2 The media information 2 of the specified block media.
|
|
|
|
@retval EFI_SUCCESS Command executed successfully.
|
|
@retval EFI_DEVICE_ERROR Some device errors happen.
|
|
@retval EFI_OUT_OF_RESOURCES Can not allocate required resources.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
DetectMedia (
|
|
IN ATAPI_BLK_IO_DEV *AtapiBlkIoDev,
|
|
IN UINTN DevicePosition,
|
|
IN OUT EFI_PEI_BLOCK_IO_MEDIA *MediaInfo,
|
|
IN OUT EFI_PEI_BLOCK_IO2_MEDIA *MediaInfo2
|
|
);
|
|
|
|
/**
|
|
Reset specified Atapi device.
|
|
|
|
@param[in] AtapiBlkIoDev A pointer to atapi block IO device.
|
|
@param[in] DevicePosition An integer to signify device position.
|
|
@param[in] Extensive If TRUE, use ATA soft reset, otherwise use Atapi soft reset.
|
|
|
|
@retval EFI_SUCCESS Command executed successfully.
|
|
@retval EFI_DEVICE_ERROR Some device errors happen.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
ResetDevice (
|
|
IN ATAPI_BLK_IO_DEV *AtapiBlkIoDev,
|
|
IN UINTN DevicePosition,
|
|
IN BOOLEAN Extensive
|
|
);
|
|
|
|
/**
|
|
Sends out ATAPI Request Sense Packet Command to the specified device.
|
|
|
|
@param[in] AtapiBlkIoDev A pointer to atapi block IO device.
|
|
@param[in] DevicePosition An integer to signify device position.
|
|
@param[in] SenseBuffers Pointer to sense buffer.
|
|
@param[in, out] SenseCounts Length of sense buffer.
|
|
|
|
@retval EFI_SUCCESS Command executed successfully.
|
|
@retval EFI_DEVICE_ERROR Some device errors happen.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
RequestSense (
|
|
IN ATAPI_BLK_IO_DEV *AtapiBlkIoDev,
|
|
IN UINTN DevicePosition,
|
|
IN ATAPI_REQUEST_SENSE_DATA *SenseBuffers,
|
|
IN OUT UINT8 *SenseCounts
|
|
);
|
|
|
|
/**
|
|
Sends out ATAPI Read Capacity Packet Command to the specified device.
|
|
This command will return the information regarding the capacity of the
|
|
media in the device.
|
|
|
|
@param[in] AtapiBlkIoDev A pointer to atapi block IO device.
|
|
@param[in] DevicePosition An integer to signify device position.
|
|
@param[in, out] MediaInfo The media information of the specified block media.
|
|
@param[in, out] MediaInfo2 The media information 2 of the specified block media.
|
|
|
|
@retval EFI_SUCCESS Command executed successfully.
|
|
@retval EFI_DEVICE_ERROR Some device errors happen.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
ReadCapacity (
|
|
IN ATAPI_BLK_IO_DEV *AtapiBlkIoDev,
|
|
IN UINTN DevicePosition,
|
|
IN OUT EFI_PEI_BLOCK_IO_MEDIA *MediaInfo,
|
|
IN OUT EFI_PEI_BLOCK_IO2_MEDIA *MediaInfo2
|
|
);
|
|
|
|
/**
|
|
Perform read from disk in block unit.
|
|
|
|
@param[in] AtapiBlkIoDev A pointer to atapi block IO device.
|
|
@param[in] DevicePosition An integer to signify device position.
|
|
@param[in] Buffer Buffer to contain read data.
|
|
@param[in] StartLba Starting LBA address.
|
|
@param[in] NumberOfBlocks Number of blocks to read.
|
|
@param[in] BlockSize Size of each block.
|
|
|
|
@retval EFI_SUCCESS Command executed successfully.
|
|
@retval EFI_DEVICE_ERROR Some device errors happen.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
ReadSectors (
|
|
IN ATAPI_BLK_IO_DEV *AtapiBlkIoDev,
|
|
IN UINTN DevicePosition,
|
|
IN VOID *Buffer,
|
|
IN EFI_PEI_LBA StartLba,
|
|
IN UINTN NumberOfBlocks,
|
|
IN UINTN BlockSize
|
|
);
|
|
|
|
/**
|
|
Check if there is media according to sense data.
|
|
|
|
@param[in] SenseData Pointer to sense data.
|
|
@param[in] SenseCounts Count of sense data.
|
|
|
|
@retval TRUE No media
|
|
@retval FALSE Media exists
|
|
|
|
**/
|
|
BOOLEAN
|
|
IsNoMedia (
|
|
IN ATAPI_REQUEST_SENSE_DATA *SenseData,
|
|
IN UINTN SenseCounts
|
|
);
|
|
|
|
/**
|
|
Check if device state is unclear according to sense data.
|
|
|
|
@param[in] SenseData Pointer to sense data.
|
|
@param[in] SenseCounts Count of sense data.
|
|
|
|
@retval TRUE Device state is unclear
|
|
@retval FALSE Device state is clear
|
|
|
|
**/
|
|
BOOLEAN
|
|
IsDeviceStateUnclear (
|
|
IN ATAPI_REQUEST_SENSE_DATA *SenseData,
|
|
IN UINTN SenseCounts
|
|
);
|
|
|
|
/**
|
|
Check if there is media error according to sense data.
|
|
|
|
@param[in] SenseData Pointer to sense data.
|
|
@param[in] SenseCounts Count of sense data.
|
|
|
|
@retval TRUE Media error
|
|
@retval FALSE No media error
|
|
|
|
**/
|
|
BOOLEAN
|
|
IsMediaError (
|
|
IN ATAPI_REQUEST_SENSE_DATA *SenseData,
|
|
IN UINTN SenseCounts
|
|
);
|
|
|
|
/**
|
|
Check if drive is ready according to sense data.
|
|
|
|
@param[in] SenseData Pointer to sense data.
|
|
@param[in] SenseCounts Count of sense data.
|
|
@param[out] NeedRetry Indicate if retry is needed.
|
|
|
|
@retval TRUE Drive ready
|
|
@retval FALSE Drive not ready
|
|
|
|
**/
|
|
BOOLEAN
|
|
IsDriveReady (
|
|
IN ATAPI_REQUEST_SENSE_DATA *SenseData,
|
|
IN UINTN SenseCounts,
|
|
OUT BOOLEAN *NeedRetry
|
|
);
|
|
|
|
#endif
|