mirror of https://github.com/acidanthera/audk.git
263 lines
12 KiB
C
263 lines
12 KiB
C
/** @file
|
|
EFI_SCSI_IO_PROTOCOL as defined in UEFI 2.0.
|
|
This protocol is used by code, typically drivers, running in the EFI boot
|
|
services environment to access SCSI devices. In particular, functions for
|
|
managing devices on SCSI buses are defined here.
|
|
|
|
Copyright (c) 2006 - 2008, 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.
|
|
|
|
**/
|
|
|
|
#ifndef __EFI_SCSI_IO_PROTOCOL_H__
|
|
#define __EFI_SCSI_IO_PROTOCOL_H__
|
|
|
|
#define EFI_SCSI_IO_PROTOCOL_GUID \
|
|
{ \
|
|
0x932f4736, 0x2362, 0x4002, {0x80, 0x3e, 0x3c, 0xd5, 0x4b, 0x13, 0x8f, 0x85 } \
|
|
}
|
|
|
|
//
|
|
// Forward reference for pure ANSI compatability
|
|
//
|
|
typedef struct _EFI_SCSI_IO_PROTOCOL EFI_SCSI_IO_PROTOCOL;
|
|
|
|
//
|
|
// SCSI Data Direction definition
|
|
//
|
|
#define EFI_SCSI_IO_DATA_DIRECTION_READ 0
|
|
#define EFI_SCSI_IO_DATA_DIRECTION_WRITE 1
|
|
#define EFI_SCSI_IO_DATA_DIRECTION_BIDIRECTIONAL 2
|
|
|
|
//
|
|
// SCSI Host Adapter Status definition
|
|
//
|
|
#define EFI_SCSI_IO_STATUS_HOST_ADAPTER_OK 0x00
|
|
#define EFI_SCSI_IO_STATUS_HOST_ADAPTER_TIMEOUT_COMMAND 0x09 // timeout when processing the command
|
|
#define EFI_SCSI_IO_STATUS_HOST_ADAPTER_TIMEOUT 0x0b // timeout when waiting for the command processing
|
|
#define EFI_SCSI_IO_STATUS_HOST_ADAPTER_MESSAGE_REJECT 0x0d // a message reject was received when processing command
|
|
#define EFI_SCSI_IO_STATUS_HOST_ADAPTER_BUS_RESET 0x0e // a bus reset was detected
|
|
#define EFI_SCSI_IO_STATUS_HOST_ADAPTER_PARITY_ERROR 0x0f
|
|
#define EFI_SCSI_IO_STATUS_HOST_ADAPTER_REQUEST_SENSE_FAILED 0x10 // the adapter failed in issuing request sense command
|
|
#define EFI_SCSI_IO_STATUS_HOST_ADAPTER_SELECTION_TIMEOUT 0x11 // selection timeout
|
|
#define EFI_SCSI_IO_STATUS_HOST_ADAPTER_DATA_OVERRUN_UNDERRUN 0x12 // data overrun or data underrun
|
|
#define EFI_SCSI_IO_STATUS_HOST_ADAPTER_BUS_FREE 0x13 // Unexepected bus free
|
|
#define EFI_SCSI_IO_STATUS_HOST_ADAPTER_PHASE_ERROR 0x14 // Target bus phase sequence failure
|
|
#define EFI_SCSI_IO_STATUS_HOST_ADAPTER_OTHER 0x7f
|
|
|
|
|
|
//
|
|
// SCSI Target Status definition
|
|
//
|
|
#define EFI_SCSI_IO_STATUS_TARGET_GOOD 0x00
|
|
#define EFI_SCSI_IO_STATUS_TARGET_CHECK_CONDITION 0x02 // check condition
|
|
#define EFI_SCSI_IO_STATUS_TARGET_CONDITION_MET 0x04 // condition met
|
|
#define EFI_SCSI_IO_STATUS_TARGET_BUSY 0x08 // busy
|
|
#define EFI_SCSI_IO_STATUS_TARGET_INTERMEDIATE 0x10 // intermediate
|
|
#define EFI_SCSI_IO_STATUS_TARGET_INTERMEDIATE_CONDITION_MET 0x14 // intermediate-condition met
|
|
#define EFI_SCSI_IO_STATUS_TARGET_RESERVATION_CONFLICT 0x18 // reservation conflict
|
|
#define EFI_SCSI_IO_STATUS_TARGET_COMMOND_TERMINATED 0x22 // command terminated
|
|
#define EFI_SCSI_IO_STATUS_TARGET_QUEUE_FULL 0x28 // queue full
|
|
|
|
typedef struct {
|
|
UINT64 Timeout;
|
|
VOID *InDataBuffer;
|
|
VOID *OutDataBuffer;
|
|
VOID *SenseData;
|
|
VOID *Cdb;
|
|
UINT32 InTransferLength;
|
|
UINT32 OutTransferLength;
|
|
UINT8 CdbLength;
|
|
UINT8 DataDirection;
|
|
UINT8 HostAdapterStatus;
|
|
UINT8 TargetStatus;
|
|
UINT8 SenseDataLength;
|
|
} EFI_SCSI_IO_SCSI_REQUEST_PACKET;
|
|
|
|
/**
|
|
Retrieves the device type information of the SCSI Controller.
|
|
|
|
@param This Protocol instance pointer.
|
|
@param DeviceType A pointer to the device type information
|
|
retrieved from the SCSI Controller.
|
|
|
|
@retval EFI_SUCCESS Retrieves the device type information successfully.
|
|
@retval EFI_INVALID_PARAMETER The DeviceType is NULL.
|
|
|
|
**/
|
|
typedef
|
|
EFI_STATUS
|
|
(EFIAPI *EFI_SCSI_IO_PROTOCOL_GET_DEVICE_TYPE)(
|
|
IN EFI_SCSI_IO_PROTOCOL *This,
|
|
OUT UINT8 *DeviceType
|
|
)
|
|
;
|
|
|
|
/**
|
|
Retrieves the device location in the SCSI channel.
|
|
|
|
@param This Protocol instance pointer.
|
|
@param Target A pointer to the Target ID of a SCSI device
|
|
on the SCSI channel.
|
|
@param Lun A pointer to the LUN of the SCSI device on
|
|
the SCSI channel.
|
|
|
|
@retval EFI_SUCCESS Retrieves the device location successfully.
|
|
@retval EFI_INVALID_PARAMETER The Target or Lun is NULL.
|
|
|
|
**/
|
|
typedef
|
|
EFI_STATUS
|
|
(EFIAPI *EFI_SCSI_IO_PROTOCOL_GET_DEVICE_LOCATION)(
|
|
IN EFI_SCSI_IO_PROTOCOL *This,
|
|
IN OUT UINT8 **Target,
|
|
OUT UINT64 *Lun
|
|
)
|
|
;
|
|
|
|
/**
|
|
Resets the SCSI Bus that the SCSI Controller is attached to.
|
|
|
|
@param This Protocol instance pointer.
|
|
|
|
@retval EFI_SUCCESS The SCSI bus is reset successfully.
|
|
@retval EFI_DEVICE_ERROR Errors encountered when resetting the SCSI bus.
|
|
@retval EFI_UNSUPPORTED The bus reset operation is not supported by the
|
|
SCSI Host Controller.
|
|
@retval EFI_TIMEOUT A timeout occurred while attempting to reset
|
|
the SCSI bus.
|
|
|
|
**/
|
|
typedef
|
|
EFI_STATUS
|
|
(EFIAPI *EFI_SCSI_IO_PROTOCOL_RESET_BUS)(
|
|
IN EFI_SCSI_IO_PROTOCOL *This
|
|
)
|
|
;
|
|
|
|
/**
|
|
Resets the SCSI Controller that the device handle specifies.
|
|
|
|
@param This Protocol instance pointer.
|
|
|
|
@retval EFI_SUCCESS Reset the SCSI controller successfully.
|
|
@retval EFI_DEVICE_ERROR Errors are encountered when resetting the
|
|
SCSI Controller.
|
|
@retval EFI_UNSUPPORTED The SCSI bus does not support a device
|
|
reset operation.
|
|
@retval EFI_TIMEOUT A timeout occurred while attempting to
|
|
reset the SCSI Controller.
|
|
|
|
**/
|
|
typedef
|
|
EFI_STATUS
|
|
(EFIAPI *EFI_SCSI_IO_PROTOCOL_RESET_DEVICE)(
|
|
IN EFI_SCSI_IO_PROTOCOL *This
|
|
)
|
|
;
|
|
|
|
|
|
/**
|
|
Sends a SCSI Request Packet to the SCSI Controller for execution.
|
|
|
|
@param This Protocol instance pointer.
|
|
@param Packet The SCSI request packet to send to the SCSI
|
|
Controller specified by the device handle.
|
|
@param Event If the SCSI bus where the SCSI device is attached
|
|
does not support non-blocking I/O, then Event is
|
|
ignored, and blocking I/O is performed.
|
|
If Event is NULL, then blocking I/O is performed.
|
|
If Event is not NULL and non-blocking I/O is
|
|
supported, then non-blocking I/O is performed,
|
|
and Event will be signaled when the SCSI Request
|
|
Packet completes.
|
|
|
|
@retval EFI_SUCCESS The SCSI Request Packet was sent by the host
|
|
successfully, and TransferLength bytes were
|
|
transferred to/from DataBuffer.See
|
|
HostAdapterStatus, TargetStatus,
|
|
SenseDataLength, and SenseData in that order
|
|
for additional status information.
|
|
@retval EFI_BAD_BUFFER_SIZE The SCSI Request Packet was executed,
|
|
but the entire DataBuffer could not be transferred.
|
|
The actual number of bytes transferred is returned
|
|
in TransferLength. See HostAdapterStatus,
|
|
TargetStatus, SenseDataLength, and SenseData in
|
|
that order for additional status information.
|
|
@retval EFI_NOT_READY The SCSI Request Packet could not be sent because
|
|
there are too many SCSI Command Packets already
|
|
queued.The caller may retry again later.
|
|
@retval EFI_DEVICE_ERROR A device error occurred while attempting to send
|
|
the SCSI Request Packet. See HostAdapterStatus,
|
|
TargetStatus, SenseDataLength, and SenseData in
|
|
that order for additional status information.
|
|
@retval EFI_INVALID_PARAMETER The contents of CommandPacket are invalid.
|
|
The SCSI Request Packet was not sent, so no
|
|
additional status information is available.
|
|
@retval EFI_UNSUPPORTED The command described by the SCSI Request Packet
|
|
is not supported by the SCSI initiator(i.e., SCSI
|
|
Host Controller). The SCSI Request Packet was not
|
|
sent, so no additional status information is
|
|
available.
|
|
@retval EFI_TIMEOUT A timeout occurred while waiting for the SCSI
|
|
Request Packet to execute. See HostAdapterStatus,
|
|
TargetStatus, SenseDataLength, and SenseData in
|
|
that order for additional status information.
|
|
|
|
**/
|
|
typedef
|
|
EFI_STATUS
|
|
(EFIAPI *EFI_SCSI_IO_PROTOCOL_EXEC_SCSI_COMMAND)(
|
|
IN EFI_SCSI_IO_PROTOCOL *This,
|
|
IN OUT EFI_SCSI_IO_SCSI_REQUEST_PACKET *Packet,
|
|
IN EFI_EVENT Event OPTIONAL
|
|
)
|
|
;
|
|
|
|
/**
|
|
@par Protocol Description:
|
|
Provides services to manage and communicate with SCSI devices.
|
|
|
|
@param GetDeviceType
|
|
Retrieves the information of the device type which the SCSI device belongs to.
|
|
|
|
@param GetDeviceLocation
|
|
Retrieves the device location information in the SCSI bus.
|
|
|
|
@param ResetBus
|
|
Resets the entire SCSI bus the SCSI device attaches to.
|
|
|
|
@param ResetDevice
|
|
Resets the SCSI Device that is specified by the device handle the SCSI I/O
|
|
protocol attaches.
|
|
|
|
@param ExecuteScsiCommand
|
|
Sends a SCSI command to the SCSI device and waits for the execution completion
|
|
until an exit condition is met, or a timeout occurs.
|
|
|
|
@param IoAlign
|
|
Supplies the alignment requirement for any buffer used in a data transfer.
|
|
IoAlign values of 0 and 1 mean that the buffer can be placed anywhere in memory.
|
|
Otherwise, IoAlign must be a power of 2, and the requirement is that the
|
|
start address of a buffer must be evenly divisible by IoAlign with no remainder.
|
|
|
|
**/
|
|
struct _EFI_SCSI_IO_PROTOCOL {
|
|
EFI_SCSI_IO_PROTOCOL_GET_DEVICE_TYPE GetDeviceType;
|
|
EFI_SCSI_IO_PROTOCOL_GET_DEVICE_LOCATION GetDeviceLocation;
|
|
EFI_SCSI_IO_PROTOCOL_RESET_BUS ResetBus;
|
|
EFI_SCSI_IO_PROTOCOL_RESET_DEVICE ResetDevice;
|
|
EFI_SCSI_IO_PROTOCOL_EXEC_SCSI_COMMAND ExecuteScsiCommand;
|
|
UINT32 IoAlign;
|
|
};
|
|
|
|
extern EFI_GUID gEfiScsiIoProtocolGuid;
|
|
|
|
#endif
|