Header file for IDE Bus Driver, containing the helper functions'\r
prototype.\r
\r
- Copyright (c) 2006 - 2007, Intel Corporation. All rights reserved.<BR>\r
+ Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>\r
This program and the accompanying materials\r
are licensed and made available under the terms and conditions of the BSD License\r
which accompanies this distribution. The full text of the license may be found at\r
read a one-byte data from a IDE port.\r
\r
@param PciIo The PCI IO protocol instance\r
- @param Port the IDE Port number \r
+ @param Port the IDE Port number\r
\r
return the one-byte data read from IDE port\r
**/\r
@param PciIo Pointer to the EFI_PCI_IO_PROTOCOL instance\r
@param IdeRegsBaseAddr Pointer to IDE_REGISTERS_BASE_ADDR to\r
receive IDE IO port registers' base addresses\r
- \r
+\r
@retval EFI_UNSUPPORTED return this value when the BARs is not IO type\r
@retval EFI_SUCCESS Get the Base address successfully\r
@retval other read the pci configureation data error\r
Detect if there is disk attached to this port.\r
\r
@param IdeDev The BLK_IO private data which specifies the IDE device.\r
- \r
+\r
@retval EFI_NOT_FOUND The device or channel is not found\r
@retval EFI_SUCCESS The device is found\r
\r
Register. DRQ is cleared when the device is finished transferring data.\r
So this function is called after data transfer is finished.\r
\r
- @param IdeDev pointer pointing to IDE_BLK_IO_DEV data structure, used \r
+ @param IdeDev pointer pointing to IDE_BLK_IO_DEV data structure, used\r
to record all the information of the IDE device.\r
@param TimeoutInMilliSeconds used to designate the timeout for the DRQ clear.\r
\r
transferring data. So this function is called after data transfer\r
is finished.\r
\r
- @param IdeDev pointer pointing to IDE_BLK_IO_DEV data structure, used \r
+ @param IdeDev pointer pointing to IDE_BLK_IO_DEV data structure, used\r
to record all the information of the IDE device.\r
\r
@param TimeoutInMilliSeconds used to designate the timeout for the DRQ clear.\r
\r
/**\r
This function is used to poll for the DRQ bit set in the Alternate Status Register.\r
- DRQ is set when the device is ready to transfer data. So this function is called after \r
+ DRQ is set when the device is ready to transfer data. So this function is called after\r
the command is sent to the device and before required data is transferred.\r
\r
- @param IdeDev pointer pointing to IDE_BLK_IO_DEV data structure, used to \r
+ @param IdeDev pointer pointing to IDE_BLK_IO_DEV data structure, used to\r
record all the information of the IDE device.\r
\r
@param TimeoutInMilliSeconds used to designate the timeout for the DRQ ready.\r
This function is used to poll for the BSY bit clear in the Status Register. BSY\r
is clear when the device is not busy. Every command must be sent after device is not busy.\r
\r
- @param IdeDev pointer pointing to IDE_BLK_IO_DEV data structure, used \r
+ @param IdeDev pointer pointing to IDE_BLK_IO_DEV data structure, used\r
to record all the information of the IDE device.\r
@param TimeoutInMilliSeconds used to designate the timeout for the DRQ ready.\r
\r
);\r
\r
/**\r
- This function is used to poll for the BSY bit clear in the Alternate Status Register. \r
- BSY is clear when the device is not busy. Every command must be sent after device is \r
+ This function is used to poll for the BSY bit clear in the Alternate Status Register.\r
+ BSY is clear when the device is not busy. Every command must be sent after device is\r
not busy.\r
\r
- @param IdeDev pointer pointing to IDE_BLK_IO_DEV data structure, used to record \r
+ @param IdeDev pointer pointing to IDE_BLK_IO_DEV data structure, used to record\r
all the information of the IDE device.\r
@param TimeoutInMilliSeconds used to designate the timeout for the DRQ ready.\r
\r
\r
/**\r
This function is used to poll for the DRDY bit set in the Status Register. DRDY\r
- bit is set when the device is ready to accept command. Most ATA commands must be \r
+ bit is set when the device is ready to accept command. Most ATA commands must be\r
sent after DRDY set except the ATAPI Packet Command.\r
\r
@param IdeDev pointer pointing to IDE_BLK_IO_DEV data structure, used\r
);\r
\r
/**\r
- This function is used to poll for the DRDY bit set in the Alternate Status Register. \r
- DRDY bit is set when the device is ready to accept command. Most ATA commands must \r
+ This function is used to poll for the DRDY bit set in the Alternate Status Register.\r
+ DRDY bit is set when the device is ready to accept command. Most ATA commands must\r
be sent after DRDY set except the ATAPI Packet Command.\r
\r
@param IdeDev pointer pointing to IDE_BLK_IO_DEV data structure, used\r
information it needs to fill the IDE_BLK_IO_DEV data structure,\r
including device type, media block size, media capacity, and etc.\r
\r
- @param IdeDev pointer pointing to IDE_BLK_IO_DEV data structure,used to record \r
+ @param IdeDev pointer pointing to IDE_BLK_IO_DEV data structure,used to record\r
all the information of the IDE device.\r
\r
@retval EFI_SUCCESS Identify ATA device successfully.\r
/**\r
This function is used to send out ATA commands conforms to the PIO Data In Protocol.\r
\r
- @param IdeDev pointer pointing to IDE_BLK_IO_DEV data structure, used to record \r
+ @param IdeDev pointer pointing to IDE_BLK_IO_DEV data structure, used to record\r
all the information of the IDE device.\r
@param Buffer buffer contained data transferred from device to host.\r
@param ByteCount data size in byte unit of the buffer.\r
@param SectorNumber value of the Sector Number Register\r
@param CylinderLsb value of the low byte of the Cylinder Register\r
@param CylinderMsb value of the high byte of the Cylinder Register\r
- \r
+\r
@retval EFI_SUCCESS send out the ATA command and device send required data successfully.\r
@retval EFI_DEVICE_ERROR command sent failed.\r
\r
some debug information and if there is ERR bit set in the Status\r
Register, the Error Register's value is also be parsed and print out.\r
\r
- @param IdeDev pointer pointing to IDE_BLK_IO_DEV data structure, used to \r
+ @param IdeDev pointer pointing to IDE_BLK_IO_DEV data structure, used to\r
record all the information of the IDE device.\r
\r
@retval EFI_SUCCESS No err information in the Status Register.\r
\r
/**\r
This function is used to implement the Soft Reset on the specified device. But,\r
- the ATA Soft Reset mechanism is so strong a reset method that it will force \r
+ the ATA Soft Reset mechanism is so strong a reset method that it will force\r
resetting on both devices connected to the same cable.\r
\r
It is called by IdeBlkIoReset(), a interface function of Block\r
@param BufferSize The size of the Buffer in bytes. This must be a multiple\r
of the intrinsic block size of the device.\r
@param Buffer A pointer to the source buffer for the data.The caller\r
- is responsible for either having implicit or explicit \r
+ is responsible for either having implicit or explicit\r
ownership of the memory that data is written from.\r
\r
@retval EFI_SUCCESS Write Blocks successfully.\r
to fill in the Media data structure of the Block I/O Protocol interface.\r
\r
There are 5 steps to reach such objective:\r
- 1. Sends out the ATAPI Identify Command to the specified device. \r
+ 1. Sends out the ATAPI Identify Command to the specified device.\r
Only ATAPI device responses to this command. If the command succeeds,\r
- it returns the Identify data structure which filled with information \r
- about the device. Since the ATAPI device contains removable media, \r
+ it returns the Identify data structure which filled with information\r
+ about the device. Since the ATAPI device contains removable media,\r
the only meaningful information is the device module name.\r
2. Sends out ATAPI Inquiry Packet Command to the specified device.\r
This command will return inquiry data of the device, which contains\r
the device type information.\r
3. Allocate sense data space for future use. We don't detect the media\r
- presence here to improvement boot performance, especially when CD \r
+ presence here to improvement boot performance, especially when CD\r
media is present. The media detection will be performed just before\r
each BLK_IO read/write\r
- \r
+\r
@param IdeDev pointer pointing to IDE_BLK_IO_DEV data structure, used\r
to record all the information of the IDE device.\r
\r
@retval EFI_SUCCESS Identify ATAPI device successfully.\r
@retval EFI_DEVICE_ERROR ATAPI Identify Device Command failed or device type\r
is not supported by this IDE driver.\r
- @retval EFI_OUT_OF_RESOURCES Allocate memory for sense data failed \r
+ @retval EFI_OUT_OF_RESOURCES Allocate memory for sense data failed\r
\r
@note Parameter "IdeDev" will be updated in this function.\r
**/\r
condition (such as BSY bit is always set ), I think the Soft Reset\r
command should be sent without waiting for the BSY clear and DRDY\r
set.\r
- This function is called by IdeBlkIoReset(), \r
+ This function is called by IdeBlkIoReset(),\r
a interface function of Block I/O protocol.\r
\r
@param IdeDev pointer pointing to IDE_BLK_IO_DEV data structure, used\r
@param BufferSize The size of the Buffer in bytes. This must be a multiple\r
of the intrinsic block size of the device.\r
@param Buffer A pointer to the destination buffer for the data. The caller\r
- is responsible for either having implicit or explicit \r
+ is responsible for either having implicit or explicit\r
ownership of the memory that data is read into.\r
- \r
+\r
@retval EFI_SUCCESS Read Blocks successfully.\r
@retval EFI_DEVICE_ERROR Read Blocks failed.\r
@retval EFI_NO_MEDIA There is no media in the device.\r
@retval EFI_NO_MEDIA There is no media in the device.\r
@retval EFI_MEDIA_CHANGE The MediaId is not for the current media.\r
@retval EFI_BAD_BUFFER_SIZE The BufferSize parameter is not a multiple of the\r
- intrinsic block size of the device. \r
- @retval EFI_INVALID_PARAMETER The write request contains LBAs that are not valid, \r
+ intrinsic block size of the device.\r
+ @retval EFI_INVALID_PARAMETER The write request contains LBAs that are not valid,\r
or the data buffer is not valid.\r
\r
@retval EFI_WRITE_PROTECTED The write protected is enabled or the media does not support write\r
projects / mirror_edk2.git / blobdiff