--- /dev/null
+/** @file\r
+ Copyright (c) 2006, Intel Corporation \r
+ All rights reserved. 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
+ http://opensource.org/licenses/bsd-license.php \r
+\r
+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
+\r
+**/\r
+\r
+#include "AtapiPassThru.h"\r
+\r
+///\r
+/// IDE registers' fixed address\r
+///\r
+static IDE_BASE_REGISTERS gAtapiIoPortRegisters[2] = {\r
+ { 0x1f0, { 0x1f1 }, 0x1f2, 0x1f3, 0x1f4, 0x1f5, 0x1f6, { 0x1f7 }, { 0x3f6 }, 0x3f7, 0 },\r
+ { 0x170, { 0x171 }, 0x172, 0x173, 0x174, 0x175, 0x176, { 0x177 }, { 0x376 }, 0x377, 0 } \r
+};\r
+\r
+static SCSI_COMMAND_SET gEndTable = { 0xff, (DATA_DIRECTION) 0xff };\r
+\r
+///\r
+/// This table contains all the supported ATAPI commands.\r
+///\r
+static SCSI_COMMAND_SET gSupportedATAPICommands[] = {\r
+ { OP_INQUIRY, DataIn },\r
+ { OP_LOAD_UNLOAD_CD, NoData },\r
+ { OP_MECHANISM_STATUS, DataIn },\r
+ { OP_MODE_SELECT_10, DataOut },\r
+ { OP_MODE_SENSE_10, DataIn },\r
+ { OP_PAUSE_RESUME, NoData },\r
+ { OP_PLAY_AUDIO_10, DataIn },\r
+ { OP_PLAY_AUDIO_MSF, DataIn },\r
+ { OP_PLAY_CD, DataIn },\r
+ { OP_PLAY_CD_MSF, DataIn },\r
+ { OP_PREVENT_ALLOW_MEDIUM_REMOVAL,NoData },\r
+ { OP_READ_10, DataIn },\r
+ { OP_READ_12, DataIn },\r
+ { OP_READ_CAPACITY, DataIn },\r
+ { OP_READ_CD, DataIn },\r
+ { OP_READ_CD_MSF, DataIn },\r
+ { OP_READ_HEADER, DataIn },\r
+ { OP_READ_SUB_CHANNEL, DataIn },\r
+ { OP_READ_TOC, DataIn },\r
+ { OP_REQUEST_SENSE, DataIn },\r
+ { OP_SCAN, NoData },\r
+ { OP_SEEK_10, NoData },\r
+ { OP_SET_CD_SPEED, DataOut },\r
+ { OP_STOPPLAY_SCAN, NoData },\r
+ { OP_START_STOP_UNIT, NoData },\r
+ { OP_TEST_UNIT_READY, NoData },\r
+ { OP_FORMAT_UNIT, DataOut },\r
+ { OP_READ_FORMAT_CAPACITIES, DataIn },\r
+ { OP_VERIFY, DataOut },\r
+ { OP_WRITE_10, DataOut },\r
+ { OP_WRITE_12, DataOut },\r
+ { OP_WRITE_AND_VERIFY, DataOut },\r
+ { 0xff, (DATA_DIRECTION) 0xff } \r
+};\r
+\r
+static CHAR16 *gControllerNameString = (CHAR16 *) L"ATAPI Controller";\r
+static CHAR16 *gAtapiChannelString = (CHAR16 *) L"ATAPI Channel";\r
+\r
+EFI_DRIVER_BINDING_PROTOCOL gAtapiScsiPassThruDriverBinding = {\r
+ AtapiScsiPassThruDriverBindingSupported,\r
+ AtapiScsiPassThruDriverBindingStart,\r
+ AtapiScsiPassThruDriverBindingStop,\r
+ 0xa,\r
+ NULL,\r
+ NULL\r
+};\r
+\r
+/**\r
+ Supported.\r
+\r
+ (Standard DriverBinding Protocol Supported() function)\r
+\r
+ @return EFI_STATUS\r
+\r
+ @todo This - add argument and description to function comment\r
+ @todo Controller - add argument and description to function comment\r
+ @todo RemainingDevicePath - add argument and description to function comment\r
+ @todo EFI_UNSUPPORTED - add return value to function comment\r
+**/\r
+EFI_STATUS\r
+EFIAPI\r
+AtapiScsiPassThruDriverBindingSupported (\r
+ IN EFI_DRIVER_BINDING_PROTOCOL *This,\r
+ IN EFI_HANDLE Controller,\r
+ IN EFI_DEVICE_PATH_PROTOCOL *RemainingDevicePath\r
+ )\r
+{\r
+ EFI_STATUS Status;\r
+ EFI_PCI_IO_PROTOCOL *PciIo;\r
+ PCI_TYPE00 Pci;\r
+\r
+ //\r
+ // Open the IO Abstraction(s) needed to perform the supported test\r
+ //\r
+ Status = gBS->OpenProtocol (\r
+ Controller,\r
+ &gEfiPciIoProtocolGuid,\r
+ (VOID **) &PciIo,\r
+ This->DriverBindingHandle,\r
+ Controller,\r
+ EFI_OPEN_PROTOCOL_BY_DRIVER\r
+ );\r
+ if (EFI_ERROR (Status)) {\r
+ return Status;\r
+ }\r
+ //\r
+ // Use the PCI I/O Protocol to see if Controller is a IDE Controller that\r
+ // can be managed by this driver. Read the PCI Configuration Header\r
+ // for this device.\r
+ //\r
+ Status = PciIo->Pci.Read (\r
+ PciIo,\r
+ EfiPciIoWidthUint32,\r
+ 0,\r
+ sizeof (Pci) / sizeof (UINT32),\r
+ &Pci\r
+ );\r
+ if (EFI_ERROR (Status)) {\r
+ gBS->CloseProtocol (\r
+ Controller,\r
+ &gEfiPciIoProtocolGuid,\r
+ This->DriverBindingHandle,\r
+ Controller\r
+ );\r
+ return EFI_UNSUPPORTED;\r
+ }\r
+\r
+ if (Pci.Hdr.ClassCode[2] != PCI_CLASS_MASS_STORAGE || Pci.Hdr.ClassCode[1] != PCI_CLASS_IDE) {\r
+\r
+ Status = EFI_UNSUPPORTED;\r
+ }\r
+\r
+ gBS->CloseProtocol (\r
+ Controller,\r
+ &gEfiPciIoProtocolGuid,\r
+ This->DriverBindingHandle,\r
+ Controller\r
+ );\r
+\r
+ return Status;\r
+}\r
+\r
+/**\r
+ Create handles for IDE channels specified by RemainingDevicePath.\r
+ Install SCSI Pass Thru Protocol onto each created handle.\r
+\r
+ (Standard DriverBinding Protocol Start() function)\r
+\r
+ @return EFI_STATUS\r
+\r
+ @todo This - add argument and description to function comment\r
+ @todo Controller - add argument and description to function comment\r
+ @todo RemainingDevicePath - add argument and description to function comment\r
+**/\r
+EFI_STATUS\r
+EFIAPI\r
+AtapiScsiPassThruDriverBindingStart (\r
+ IN EFI_DRIVER_BINDING_PROTOCOL *This,\r
+ IN EFI_HANDLE Controller,\r
+ IN EFI_DEVICE_PATH_PROTOCOL *RemainingDevicePath\r
+ )\r
+{\r
+ EFI_STATUS Status;\r
+ EFI_PCI_IO_PROTOCOL *PciIo;\r
+\r
+ PciIo = NULL;\r
+ Status = gBS->OpenProtocol (\r
+ Controller,\r
+ &gEfiPciIoProtocolGuid,\r
+ (VOID **) &PciIo,\r
+ This->DriverBindingHandle,\r
+ Controller,\r
+ EFI_OPEN_PROTOCOL_BY_DRIVER\r
+ );\r
+ if (EFI_ERROR (Status)) {\r
+ return Status;\r
+ }\r
+\r
+ Status = PciIo->Attributes (\r
+ PciIo,\r
+ EfiPciIoAttributeOperationEnable,\r
+ EFI_PCI_IO_ATTRIBUTE_IDE_PRIMARY_IO | EFI_PCI_IO_ATTRIBUTE_IDE_SECONDARY_IO | EFI_PCI_DEVICE_ENABLE,\r
+ NULL\r
+ );\r
+ if (EFI_ERROR (Status)) {\r
+ goto Done;\r
+ }\r
+\r
+ //\r
+ // Create SCSI Pass Thru instance for the IDE channel.\r
+ //\r
+ Status = RegisterAtapiScsiPassThru (This, Controller, PciIo);\r
+\r
+Done:\r
+ if (EFI_ERROR (Status)) {\r
+ if (PciIo) {\r
+ PciIo->Attributes (\r
+ PciIo,\r
+ EfiPciIoAttributeOperationDisable,\r
+ EFI_PCI_IO_ATTRIBUTE_IDE_PRIMARY_IO | EFI_PCI_IO_ATTRIBUTE_IDE_SECONDARY_IO | EFI_PCI_DEVICE_ENABLE,\r
+ NULL\r
+ );\r
+ }\r
+\r
+ gBS->CloseProtocol (\r
+ Controller,\r
+ &gEfiPciIoProtocolGuid,\r
+ This->DriverBindingHandle,\r
+ Controller\r
+ );\r
+ }\r
+\r
+ return Status;\r
+}\r
+\r
+/**\r
+ Stop.\r
+\r
+ (Standard DriverBinding Protocol Stop() function)\r
+\r
+ @return EFI_STATUS\r
+\r
+ @todo This - add argument and description to function comment\r
+ @todo Controller - add argument and description to function comment\r
+ @todo NumberOfChildren - add argument and description to function comment\r
+ @todo ChildHandleBuffer - add argument and description to function comment\r
+ @todo EFI_SUCCESS - add return value to function comment\r
+**/\r
+EFI_STATUS\r
+EFIAPI\r
+AtapiScsiPassThruDriverBindingStop (\r
+ IN EFI_DRIVER_BINDING_PROTOCOL *This,\r
+ IN EFI_HANDLE Controller,\r
+ IN UINTN NumberOfChildren,\r
+ IN EFI_HANDLE *ChildHandleBuffer\r
+ )\r
+{\r
+ EFI_STATUS Status;\r
+ EFI_SCSI_PASS_THRU_PROTOCOL *ScsiPassThru;\r
+ ATAPI_SCSI_PASS_THRU_DEV *AtapiScsiPrivate;\r
+\r
+ Status = gBS->OpenProtocol (\r
+ Controller,\r
+ &gEfiScsiPassThruProtocolGuid,\r
+ (VOID **) &ScsiPassThru,\r
+ This->DriverBindingHandle,\r
+ Controller,\r
+ EFI_OPEN_PROTOCOL_GET_PROTOCOL\r
+ );\r
+ if (EFI_ERROR (Status)) {\r
+ return Status;\r
+ }\r
+\r
+ AtapiScsiPrivate = ATAPI_SCSI_PASS_THRU_DEV_FROM_THIS (ScsiPassThru);\r
+\r
+ Status = gBS->UninstallProtocolInterface (\r
+ Controller,\r
+ &gEfiScsiPassThruProtocolGuid,\r
+ &AtapiScsiPrivate->ScsiPassThru\r
+ );\r
+ if (EFI_ERROR (Status)) {\r
+ return Status;\r
+ }\r
+ //\r
+ // Release Pci Io protocol on the controller handle.\r
+ //\r
+ AtapiScsiPrivate->PciIo->Attributes (\r
+ AtapiScsiPrivate->PciIo,\r
+ EfiPciIoAttributeOperationDisable,\r
+ EFI_PCI_IO_ATTRIBUTE_IDE_PRIMARY_IO | EFI_PCI_IO_ATTRIBUTE_IDE_SECONDARY_IO | EFI_PCI_DEVICE_ENABLE,\r
+ NULL\r
+ );\r
+\r
+ gBS->CloseProtocol (\r
+ Controller,\r
+ &gEfiPciIoProtocolGuid,\r
+ This->DriverBindingHandle,\r
+ Controller\r
+ );\r
+\r
+ gBS->FreePool (AtapiScsiPrivate);\r
+\r
+ return EFI_SUCCESS;\r
+}\r
+\r
+/**\r
+ Attaches SCSI Pass Thru Protocol for specified IDE channel.\r
+\r
+ @param Controller: Parent device handle to the IDE channel.\r
+ @param PciIo: PCI I/O protocol attached on the "Controller".\r
+\r
+ @return EFI_SUCCESS Always returned unless installing SCSI Pass Thru Protocol failed.\r
+\r
+ @todo This - add argument and description to function comment\r
+ @todo Controller - add argument and description to function comment\r
+ @todo PciIo - add argument and description to function comment\r
+ @todo EFI_OUT_OF_RESOURCES - add return value to function comment\r
+**/\r
+EFI_STATUS\r
+RegisterAtapiScsiPassThru (\r
+ IN EFI_DRIVER_BINDING_PROTOCOL *This,\r
+ IN EFI_HANDLE Controller,\r
+ IN EFI_PCI_IO_PROTOCOL *PciIo\r
+ )\r
+{\r
+ EFI_STATUS Status;\r
+ ATAPI_SCSI_PASS_THRU_DEV *AtapiScsiPrivate;\r
+ UINT64 Attributes;\r
+\r
+ AtapiScsiPrivate = AllocateZeroPool (sizeof (ATAPI_SCSI_PASS_THRU_DEV));\r
+ if (AtapiScsiPrivate == NULL) {\r
+ return EFI_OUT_OF_RESOURCES;\r
+ }\r
+\r
+ Attributes = EFI_PCI_IO_ATTRIBUTE_IDE_PRIMARY_IO | EFI_PCI_IO_ATTRIBUTE_IDE_SECONDARY_IO | EFI_PCI_DEVICE_ENABLE;\r
+ CopyMem (AtapiScsiPrivate->ChannelName, gAtapiChannelString, sizeof (gAtapiChannelString));\r
+\r
+ //\r
+ // Enable channel\r
+ //\r
+ PciIo->Attributes (PciIo, EfiPciIoAttributeOperationSet, Attributes, NULL);\r
+\r
+ AtapiScsiPrivate->Signature = ATAPI_SCSI_PASS_THRU_DEV_SIGNATURE;\r
+ AtapiScsiPrivate->Handle = Controller;\r
+\r
+ //\r
+ // will reset the IoPort inside each API function.\r
+ //\r
+ AtapiScsiPrivate->IoPort = gAtapiIoPortRegisters;\r
+ AtapiScsiPrivate->PciIo = PciIo;\r
+\r
+ //\r
+ // initialize SCSI Pass Thru Protocol interface\r
+ //\r
+ AtapiScsiPrivate->ScsiPassThru.Mode = &AtapiScsiPrivate->ScsiPassThruMode;\r
+ AtapiScsiPrivate->ScsiPassThru.PassThru = AtapiScsiPassThruFunction;\r
+ AtapiScsiPrivate->ScsiPassThru.GetNextDevice = AtapiScsiPassThruGetNextDevice;\r
+ AtapiScsiPrivate->ScsiPassThru.BuildDevicePath = AtapiScsiPassThruBuildDevicePath;\r
+ AtapiScsiPrivate->ScsiPassThru.GetTargetLun = AtapiScsiPassThruGetTargetLun;\r
+ AtapiScsiPrivate->ScsiPassThru.ResetChannel = AtapiScsiPassThruResetChannel;\r
+ AtapiScsiPrivate->ScsiPassThru.ResetTarget = AtapiScsiPassThruResetTarget;\r
+\r
+ //\r
+ // Set Mode\r
+ //\r
+ CopyMem (AtapiScsiPrivate->ControllerName, gControllerNameString, sizeof (gControllerNameString));\r
+\r
+ AtapiScsiPrivate->ScsiPassThruMode.ControllerName = AtapiScsiPrivate->ControllerName;\r
+ AtapiScsiPrivate->ScsiPassThruMode.ChannelName = AtapiScsiPrivate->ChannelName;\r
+ AtapiScsiPrivate->ScsiPassThruMode.AdapterId = 4;\r
+ //\r
+ // non-RAID SCSI controllers should set both physical and logical attributes\r
+ //\r
+ AtapiScsiPrivate->ScsiPassThruMode.Attributes = EFI_SCSI_PASS_THRU_ATTRIBUTES_PHYSICAL | \r
+ EFI_SCSI_PASS_THRU_ATTRIBUTES_LOGICAL;\r
+ AtapiScsiPrivate->ScsiPassThruMode.IoAlign = 0;\r
+\r
+ //\r
+ // Initialize the LatestTargetId to 0xFFFFFFFF (for the GetNextDevice() call).\r
+ //\r
+ AtapiScsiPrivate->LatestTargetId = 0xFFFFFFFF;\r
+ AtapiScsiPrivate->LatestLun = 0;\r
+\r
+ Status = gBS->InstallProtocolInterface (\r
+ &Controller,\r
+ &gEfiScsiPassThruProtocolGuid,\r
+ EFI_NATIVE_INTERFACE,\r
+ &AtapiScsiPrivate->ScsiPassThru\r
+ );\r
+ return Status;\r
+}\r
+\r
+/**\r
+ Implements EFI_SCSI_PASS_THRU_PROTOCOL.PassThru() function.\r
+\r
+ @param This The EFI_SCSI_PASS_THRU_PROTOCOL instance.\r
+ @param Target The Target ID of the ATAPI device to send the SCSI\r
+ Request Packet. To ATAPI devices attached on an IDE\r
+ Channel, Target ID 0 indicates Master device;Target\r
+ ID 1 indicates Slave device.\r
+ @param Lun The LUN of the ATAPI device to send the SCSI Request\r
+ Packet. To the ATAPI device, Lun is always 0.\r
+ @param Packet The SCSI Request Packet to send to the ATAPI device\r
+ specified by Target and Lun.\r
+ @param Event If non-blocking I/O is not supported then Event is ignored,\r
+ and blocking I/O is performed.<br>\r
+ If Event is NULL, then blocking I/O is performed.<br>\r
+ If Event is not NULL and non blocking I/O is supported,\r
+ then non-blocking I/O is performed, and Event will be signaled\r
+ when the SCSI Request Packet completes.\r
+\r
+ @todo This - add argument and description to function comment\r
+ @todo EFI_INVALID_PARAMETER - add return value to function comment\r
+ @todo EFI_SUCCESS - add return value to function comment\r
+**/\r
+EFI_STATUS\r
+EFIAPI\r
+AtapiScsiPassThruFunction (\r
+ IN EFI_SCSI_PASS_THRU_PROTOCOL *This,\r
+ IN UINT32 Target,\r
+ IN UINT64 Lun,\r
+ IN OUT EFI_SCSI_PASS_THRU_SCSI_REQUEST_PACKET *Packet,\r
+ IN EFI_EVENT Event OPTIONAL\r
+ )\r
+{\r
+ ATAPI_SCSI_PASS_THRU_DEV *AtapiScsiPrivate;\r
+ EFI_STATUS Status;\r
+\r
+ AtapiScsiPrivate = ATAPI_SCSI_PASS_THRU_DEV_FROM_THIS (This);\r
+\r
+ //\r
+ // Target is not allowed beyond MAX_TARGET_ID\r
+ //\r
+ if (Target > MAX_TARGET_ID) {\r
+ return EFI_INVALID_PARAMETER;\r
+ }\r
+ \r
+ //\r
+ // check the data fields in Packet parameter.\r
+ //\r
+ Status = CheckSCSIRequestPacket (Packet);\r
+ if (EFI_ERROR (Status)) {\r
+ return Status;\r
+ }\r
+\r
+ //\r
+ // If Request Packet targets at the IDE channel itself,\r
+ // do nothing.\r
+ //\r
+ if (Target == This->Mode->AdapterId) {\r
+ Packet->TransferLength = 0;\r
+ return EFI_SUCCESS;\r
+ }\r
+ \r
+ //\r
+ // According to Target ID, reset the Atapi I/O Register mapping\r
+ // (Target Id in [0,1] area, using gAtapiIoPortRegisters[0],\r
+ // Target Id in [2,3] area, using gAtapiIoPortRegisters[1]\r
+ //\r
+ if ((Target / 2) == 0) {\r
+ AtapiScsiPrivate->IoPort = &gAtapiIoPortRegisters[0];\r
+ } else {\r
+ AtapiScsiPrivate->IoPort = &gAtapiIoPortRegisters[1];\r
+ }\r
+ \r
+ //\r
+ // the ATAPI SCSI interface does not support non-blocking I/O\r
+ // ignore the Event parameter\r
+ //\r
+ // Performs blocking I/O.\r
+ //\r
+ Status = SubmitBlockingIoCommand (AtapiScsiPrivate, Target, Packet);\r
+ return Status;\r
+}\r
+\r
+/**\r
+ Used to retrieve the list of legal Target IDs for SCSI devices \r
+ on a SCSI channel.\r
+\r
+ @param This Protocol instance pointer.\r
+ @param Target On input, a pointer to the Target ID of a SCSI\r
+ device present on the SCSI channel. On output,\r
+ a pointer to the Target ID of the next SCSI device\r
+ present on a SCSI channel. An input value of\r
+ 0xFFFFFFFF retrieves the Target ID of the first\r
+ SCSI device present on a SCSI channel.\r
+ @param Lun On input, a pointer to the LUN of a SCSI device\r
+ present on the SCSI channel. On output, a pointer\r
+ to the LUN of the next SCSI device present on\r
+ a SCSI channel.\r
+\r
+ @retval EFI_SUCCESS The Target ID and Lun of the next SCSI device\r
+ on the SCSI channel was returned in Target and Lun.\r
+ @retval EFI_NOT_FOUND There are no more SCSI devices on this SCSI channel.\r
+ @retval EFI_INVALID_PARAMETER Target is not 0xFFFFFFFF,and Target and Lun were not\r
+ returned on a previous call to GetNextDevice().\r
+\r
+**/\r
+EFI_STATUS\r
+EFIAPI\r
+AtapiScsiPassThruGetNextDevice (\r
+ IN EFI_SCSI_PASS_THRU_PROTOCOL *This,\r
+ IN OUT UINT32 *Target,\r
+ IN OUT UINT64 *Lun\r
+ )\r
+{\r
+ ATAPI_SCSI_PASS_THRU_DEV *AtapiScsiPrivate;\r
+\r
+ //\r
+ // Retrieve Device Private Data Structure.\r
+ //\r
+ AtapiScsiPrivate = ATAPI_SCSI_PASS_THRU_DEV_FROM_THIS (This);\r
+\r
+ //\r
+ // Check whether Target is valid.\r
+ //\r
+ if (Target == NULL || Lun == NULL) {\r
+ return EFI_INVALID_PARAMETER;\r
+ }\r
+\r
+ if ((*Target != 0xFFFFFFFF) &&\r
+ ((*Target != AtapiScsiPrivate->LatestTargetId) ||\r
+ (*Lun != AtapiScsiPrivate->LatestLun))) {\r
+ return EFI_INVALID_PARAMETER;\r
+ }\r
+\r
+ if (*Target == MAX_TARGET_ID) {\r
+ return EFI_NOT_FOUND;\r
+ }\r
+\r
+ if (*Target == 0xFFFFFFFF) {\r
+ *Target = 0;\r
+ } else {\r
+ *Target = AtapiScsiPrivate->LatestTargetId + 1;\r
+ }\r
+\r
+ *Lun = 0;\r
+\r
+ //\r
+ // Update the LatestTargetId.\r
+ //\r
+ AtapiScsiPrivate->LatestTargetId = *Target;\r
+ AtapiScsiPrivate->LatestLun = *Lun;\r
+\r
+ return EFI_SUCCESS;\r
+\r
+}\r
+\r
+/**\r
+ Used to allocate and build a device path node for a SCSI device \r
+ on a SCSI channel. Would not build device path for a SCSI Host Controller.\r
+\r
+ @param This Protocol instance pointer.\r
+ @param Target The Target ID of the SCSI device for which\r
+ a device path node is to be allocated and built.\r
+ @param Lun The LUN of the SCSI device for which a device\r
+ path node is to be allocated and built.\r
+ @param DevicePath A pointer to a single device path node that\r
+ describes the SCSI device specified by\r
+ Target and Lun. This function is responsible\r
+ for allocating the buffer DevicePath with the boot\r
+ service AllocatePool(). It is the caller's\r
+ responsibility to free DevicePath when the caller\r
+ is finished with DevicePath.\r
+\r
+ @retval EFI_SUCCESS The device path node that describes the SCSI device\r
+ specified by Target and Lun was allocated and\r
+ returned in DevicePath.\r
+ @retval EFI_NOT_FOUND The SCSI devices specified by Target and Lun does\r
+ not exist on the SCSI channel.\r
+ @retval EFI_INVALID_PARAMETER DevicePath is NULL.\r
+ @retval EFI_OUT_OF_RESOURCES There are not enough resources to allocate\r
+ DevicePath.\r
+\r
+**/\r
+EFI_STATUS\r
+EFIAPI\r
+AtapiScsiPassThruBuildDevicePath (\r
+ IN EFI_SCSI_PASS_THRU_PROTOCOL *This,\r
+ IN UINT32 Target,\r
+ IN UINT64 Lun,\r
+ IN OUT EFI_DEVICE_PATH_PROTOCOL **DevicePath\r
+ )\r
+{\r
+ EFI_DEV_PATH *Node;\r
+\r
+ //\r
+ // Validate parameters passed in.\r
+ //\r
+ \r
+ if (DevicePath == NULL) {\r
+ return EFI_INVALID_PARAMETER;\r
+ }\r
+ \r
+ //\r
+ // can not build device path for the SCSI Host Controller.\r
+ //\r
+ if ((Target > (MAX_TARGET_ID - 1)) || (Lun != 0)) {\r
+ return EFI_NOT_FOUND;\r
+ }\r
+\r
+ Node = AllocateZeroPool (sizeof (EFI_DEV_PATH));\r
+ if (Node == NULL) {\r
+ return EFI_OUT_OF_RESOURCES;\r
+ }\r
+\r
+ Node->DevPath.Type = MESSAGING_DEVICE_PATH;\r
+ Node->DevPath.SubType = MSG_ATAPI_DP;\r
+ SetDevicePathNodeLength (&Node->DevPath, sizeof (ATAPI_DEVICE_PATH));\r
+\r
+ Node->Atapi.PrimarySecondary = (UINT8) (Target / 2);\r
+ Node->Atapi.SlaveMaster = (UINT8) (Target % 2);\r
+ Node->Atapi.Lun = (UINT16) Lun;\r
+\r
+ *DevicePath = (EFI_DEVICE_PATH_PROTOCOL *) Node;\r
+\r
+ return EFI_SUCCESS;\r
+}\r
+\r
+/**\r
+ Used to translate a device path node to a Target ID and LUN.\r
+\r
+ @param This Protocol instance pointer.\r
+ @param DevicePath A pointer to the device path node that\r
+ describes a SCSI device on the SCSI channel.\r
+ @param Target A pointer to the Target ID of a SCSI device\r
+ on the SCSI channel.\r
+ @param Lun A pointer to the LUN of a SCSI device on\r
+ the SCSI channel.\r
+\r
+ @retval EFI_SUCCESS DevicePath was successfully translated to a\r
+ Target ID and LUN, and they were returned\r
+ in Target and Lun.\r
+ @retval EFI_INVALID_PARAMETER DevicePath is NULL.\r
+ @retval EFI_INVALID_PARAMETER Target is NULL.\r
+ @retval EFI_INVALID_PARAMETER Lun is NULL.\r
+ @retval EFI_UNSUPPORTED This driver does not support the device path\r
+ node type in DevicePath.\r
+ @retval EFI_NOT_FOUND A valid translation from DevicePath to a\r
+ Target ID and LUN does not exist.\r
+\r
+**/\r
+EFI_STATUS\r
+EFIAPI\r
+AtapiScsiPassThruGetTargetLun (\r
+ IN EFI_SCSI_PASS_THRU_PROTOCOL *This,\r
+ IN EFI_DEVICE_PATH_PROTOCOL *DevicePath,\r
+ OUT UINT32 *Target,\r
+ OUT UINT64 *Lun\r
+ )\r
+{\r
+ EFI_DEV_PATH *Node;\r
+\r
+ //\r
+ // Validate parameters passed in.\r
+ //\r
+ if (DevicePath == NULL || Target == NULL || Lun == NULL) {\r
+ return EFI_INVALID_PARAMETER;\r
+ }\r
+ \r
+ //\r
+ // Check whether the DevicePath belongs to SCSI_DEVICE_PATH\r
+ //\r
+ if ((DevicePath->Type != MESSAGING_DEVICE_PATH) ||\r
+ (DevicePath->SubType != MSG_ATAPI_DP) ||\r
+ (DevicePathNodeLength(DevicePath) != sizeof(ATAPI_DEVICE_PATH))) {\r
+ return EFI_UNSUPPORTED;\r
+ }\r
+\r
+ Node = (EFI_DEV_PATH *) DevicePath;\r
+\r
+ *Target = Node->Atapi.PrimarySecondary * 2 + Node->Atapi.SlaveMaster;\r
+ *Lun = Node->Atapi.Lun;\r
+\r
+ if (*Target > (MAX_TARGET_ID - 1) || *Lun != 0) {\r
+ return EFI_NOT_FOUND;\r
+ }\r
+\r
+ return EFI_SUCCESS;\r
+}\r
+\r
+/**\r
+ Resets a SCSI channel.This operation resets all the \r
+ SCSI devices connected to the SCSI channel.\r
+\r
+ @param This Protocol instance pointer.\r
+\r
+ @retval EFI_SUCCESS The SCSI channel was reset.\r
+ @retval EFI_UNSUPPORTED The SCSI channel does not support\r
+ a channel reset operation.\r
+ @retval EFI_DEVICE_ERROR A device error occurred while\r
+ attempting to reset the SCSI channel.\r
+ @retval EFI_TIMEOUT A timeout occurred while attempting\r
+ to reset the SCSI channel.\r
+\r
+**/\r
+EFI_STATUS\r
+EFIAPI\r
+AtapiScsiPassThruResetChannel (\r
+ IN EFI_SCSI_PASS_THRU_PROTOCOL *This\r
+ )\r
+{\r
+ UINT8 DeviceControlValue;\r
+ ATAPI_SCSI_PASS_THRU_DEV *AtapiScsiPrivate;\r
+ UINT8 Index;\r
+\r
+ AtapiScsiPrivate = ATAPI_SCSI_PASS_THRU_DEV_FROM_THIS (This);\r
+\r
+ //\r
+ // Reset both Primary channel and Secondary channel.\r
+ // so, the IoPort pointer must point to the right I/O Register group\r
+ //\r
+ for (Index = 0; Index < 2; Index++) {\r
+ //\r
+ // Reset\r
+ //\r
+ AtapiScsiPrivate->IoPort = &gAtapiIoPortRegisters[Index];\r
+\r
+ DeviceControlValue = 0;\r
+ //\r
+ // set SRST bit to initiate soft reset\r
+ //\r
+ DeviceControlValue |= SRST;\r
+ //\r
+ // disable Interrupt\r
+ //\r
+ DeviceControlValue |= bit (1);\r
+ WritePortB (\r
+ AtapiScsiPrivate->PciIo,\r
+ AtapiScsiPrivate->IoPort->Alt.DeviceControl,\r
+ DeviceControlValue\r
+ );\r
+\r
+ //\r
+ // Wait 10us\r
+ //\r
+ gBS->Stall (10);\r
+\r
+ //\r
+ // Clear SRST bit\r
+ // 0xfb:1111,1011\r
+ //\r
+ DeviceControlValue &= 0xfb;\r
+ \r
+ WritePortB (AtapiScsiPrivate->PciIo, AtapiScsiPrivate->IoPort->Alt.DeviceControl, DeviceControlValue);\r
+\r
+ //\r
+ // slave device needs at most 31s to clear BSY\r
+ //\r
+ if (StatusWaitForBSYClear (AtapiScsiPrivate, 31000) == EFI_TIMEOUT) {\r
+ return EFI_DEVICE_ERROR;\r
+ }\r
+ }\r
+\r
+ return EFI_SUCCESS;\r
+}\r
+\r
+/**\r
+ Resets a SCSI device that is connected to a SCSI channel.\r
+\r
+ @param This Protocol instance pointer.\r
+ @param Target The Target ID of the SCSI device to reset.\r
+ @param Lun The LUN of the SCSI device to reset.\r
+\r
+ @retval EFI_SUCCESS The SCSI device specified by Target and\r
+ Lun was reset.\r
+ @retval EFI_UNSUPPORTED The SCSI channel does not support a target\r
+ reset operation.\r
+ @retval EFI_INVALID_PARAMETER Target or Lun are invalid.\r
+ @retval EFI_DEVICE_ERROR A device error occurred while attempting\r
+ to reset the SCSI device specified by Target\r
+ and Lun.\r
+ @retval EFI_TIMEOUT A timeout occurred while attempting to reset\r
+ the SCSI device specified by Target and Lun.\r
+\r
+**/\r
+EFI_STATUS\r
+EFIAPI\r
+AtapiScsiPassThruResetTarget (\r
+ IN EFI_SCSI_PASS_THRU_PROTOCOL *This,\r
+ IN UINT32 Target,\r
+ IN UINT64 Lun\r
+ )\r
+{\r
+ ATAPI_SCSI_PASS_THRU_DEV *AtapiScsiPrivate;\r
+ UINT8 Command;\r
+ UINT8 DeviceSelect;\r
+\r
+ AtapiScsiPrivate = ATAPI_SCSI_PASS_THRU_DEV_FROM_THIS (This);\r
+\r
+ if (Target > MAX_TARGET_ID) {\r
+ return EFI_INVALID_PARAMETER;\r
+ }\r
+ //\r
+ // Directly return EFI_SUCCESS if want to reset the host controller\r
+ //\r
+ if (Target == This->Mode->AdapterId) {\r
+ return EFI_SUCCESS;\r
+ }\r
+ \r
+ //\r
+ // According to Target ID, reset the Atapi I/O Register mapping\r
+ // (Target Id in [0,1] area, using gAtapiIoPortRegisters[0],\r
+ // Target Id in [2,3] area, using gAtapiIoPortRegisters[1]\r
+ //\r
+ if ((Target / 2) == 0) {\r
+ AtapiScsiPrivate->IoPort = &gAtapiIoPortRegisters[0];\r
+ } else {\r
+ AtapiScsiPrivate->IoPort = &gAtapiIoPortRegisters[1];\r
+ }\r
+ \r
+ //\r
+ // for ATAPI device, no need to wait DRDY ready after device selecting.\r
+ //\r
+ // bit7 and bit5 are both set to 1 for backward compatibility\r
+ //\r
+ DeviceSelect = (UINT8) (((bit (7) | bit (5)) | (Target << 4)));\r
+ WritePortB (AtapiScsiPrivate->PciIo, AtapiScsiPrivate->IoPort->Head, DeviceSelect);\r
+\r
+ Command = ATAPI_SOFT_RESET_CMD;\r
+ WritePortB (AtapiScsiPrivate->PciIo, AtapiScsiPrivate->IoPort->Reg.Command, Command);\r
+\r
+ //\r
+ // BSY clear is the only status return to the host by the device\r
+ // when reset is complete.\r
+ // slave device needs at most 31s to clear BSY\r
+ //\r
+ if (EFI_ERROR (StatusWaitForBSYClear (AtapiScsiPrivate, 31000))) {\r
+ return EFI_DEVICE_ERROR;\r
+ }\r
+ \r
+ //\r
+ // stall 5 seconds to make the device status stable\r
+ //\r
+ gBS->Stall (5000000);\r
+\r
+ return EFI_SUCCESS;\r
+}\r
+\r
+ \r
+/**\r
+ Checks the parameters in the SCSI Request Packet to make sure\r
+ they are valid for a SCSI Pass Thru request.\r
+\r
+ @todo function comment is missing 'Routine Description:'\r
+ @todo function comment is missing 'Arguments:'\r
+ @todo function comment is missing 'Returns:'\r
+ @todo Packet - add argument and description to function comment\r
+ @todo EFI_INVALID_PARAMETER - add return value to function comment\r
+ @todo EFI_INVALID_PARAMETER - add return value to function comment\r
+ @todo EFI_INVALID_PARAMETER - add return value to function comment\r
+ @todo EFI_UNSUPPORTED - add return value to function comment\r
+ @todo EFI_SUCCESS - add return value to function comment\r
+**/\r
+EFI_STATUS\r
+CheckSCSIRequestPacket (\r
+ EFI_SCSI_PASS_THRU_SCSI_REQUEST_PACKET *Packet\r
+ )\r
+{\r
+ if (Packet == NULL) {\r
+ return EFI_INVALID_PARAMETER;\r
+ }\r
+\r
+ if (!ValidCdbLength (Packet->CdbLength)) {\r
+ return EFI_INVALID_PARAMETER;\r
+ }\r
+\r
+ if (Packet->Cdb == NULL) {\r
+ return EFI_INVALID_PARAMETER;\r
+ }\r
+ \r
+ //\r
+ // Checks whether the request command is supported.\r
+ //\r
+ if (!IsCommandValid (Packet)) {\r
+ return EFI_UNSUPPORTED;\r
+ }\r
+\r
+ return EFI_SUCCESS;\r
+}\r
+\r
+/**\r
+ Checks the requested SCSI command: \r
+ Is it supported by this driver?\r
+ Is the Data transfer direction reasonable?\r
+\r
+ @todo function comment is missing 'Routine Description:'\r
+ @todo function comment is missing 'Arguments:'\r
+ @todo function comment is missing 'Returns:'\r
+ @todo Packet - add argument and description to function comment\r
+**/\r
+BOOLEAN\r
+IsCommandValid (\r
+ EFI_SCSI_PASS_THRU_SCSI_REQUEST_PACKET *Packet\r
+ )\r
+{\r
+ UINT8 Index;\r
+ UINT8 *OpCode;\r
+\r
+ OpCode = (UINT8 *) (Packet->Cdb);\r
+\r
+ for (Index = 0; CompareMem (&gSupportedATAPICommands[Index], &gEndTable, sizeof (SCSI_COMMAND_SET)); Index++) {\r
+\r
+ if (*OpCode == gSupportedATAPICommands[Index].OpCode) {\r
+ //\r
+ // Check whether the requested Command is supported by this driver\r
+ //\r
+ if (Packet->DataDirection == DataIn) {\r
+ //\r
+ // Check whether the requested data direction conforms to\r
+ // what it should be.\r
+ //\r
+ if (gSupportedATAPICommands[Index].Direction == DataOut) {\r
+ return FALSE;\r
+ }\r
+ }\r
+\r
+ if (Packet->DataDirection == DataOut) {\r
+ //\r
+ // Check whether the requested data direction conforms to\r
+ // what it should be.\r
+ //\r
+ if (gSupportedATAPICommands[Index].Direction == DataIn) {\r
+ return FALSE;\r
+ }\r
+ }\r
+\r
+ return TRUE;\r
+ }\r
+ }\r
+\r
+ return FALSE;\r
+}\r
+\r
+/**\r
+ Performs blocking I/O request.\r
+\r
+ @param AtapiScsiPrivate Private data structure for the specified channel.\r
+ @param Target The Target ID of the ATAPI device to send the SCSI\r
+ Request Packet. To ATAPI devices attached on an IDE\r
+ Channel, Target ID 0 indicates Master device;Target\r
+ ID 1 indicates Slave device.\r
+ @param Packet The SCSI Request Packet to send to the ATAPI device\r
+ specified by Target.\r
+\r
+ @todo AtapiScsiPrivate - add argument and description to function comment\r
+**/\r
+EFI_STATUS\r
+SubmitBlockingIoCommand (\r
+ ATAPI_SCSI_PASS_THRU_DEV *AtapiScsiPrivate,\r
+ UINT32 Target,\r
+ EFI_SCSI_PASS_THRU_SCSI_REQUEST_PACKET *Packet\r
+ )\r
+{\r
+ UINT8 PacketCommand[12];\r
+ UINT64 TimeoutInMicroSeconds;\r
+ EFI_STATUS PacketCommandStatus;\r
+\r
+ //\r
+ // Fill ATAPI Command Packet according to CDB\r
+ //\r
+ ZeroMem (&PacketCommand, 12);\r
+ CopyMem (&PacketCommand, Packet->Cdb, Packet->CdbLength);\r
+\r
+ //\r
+ // Timeout is 100ns unit, convert it to 1000ns (1us) unit.\r
+ //\r
+ TimeoutInMicroSeconds = DivU64x32 (Packet->Timeout, (UINT32) 10);\r
+\r
+ //\r
+ // Submit ATAPI Command Packet\r
+ //\r
+ PacketCommandStatus = AtapiPacketCommand (\r
+ AtapiScsiPrivate,\r
+ Target,\r
+ PacketCommand,\r
+ Packet->DataBuffer,\r
+ &(Packet->TransferLength),\r
+ (DATA_DIRECTION) Packet->DataDirection,\r
+ TimeoutInMicroSeconds\r
+ );\r
+ if (!EFI_ERROR (PacketCommandStatus) || (Packet->SenseData == NULL)) {\r
+ Packet->SenseDataLength = 0;\r
+ return PacketCommandStatus;\r
+ }\r
+ //\r
+ // Return SenseData if PacketCommandStatus matches\r
+ // the following return codes.\r
+ //\r
+ if ((PacketCommandStatus == EFI_WARN_BUFFER_TOO_SMALL) ||\r
+ (PacketCommandStatus == EFI_DEVICE_ERROR) ||\r
+ (PacketCommandStatus == EFI_TIMEOUT)) {\r
+ \r
+ //\r
+ // avoid submit request sense command continuously.\r
+ //\r
+ if (PacketCommand[0] == OP_REQUEST_SENSE) {\r
+ Packet->SenseDataLength = 0;\r
+ return PacketCommandStatus;\r
+ }\r
+\r
+ RequestSenseCommand (\r
+ AtapiScsiPrivate,\r
+ Target,\r
+ Packet->Timeout,\r
+ Packet->SenseData,\r
+ &Packet->SenseDataLength\r
+ );\r
+ }\r
+\r
+ return PacketCommandStatus;\r
+}\r
+\r
+/**\r
+ RequestSenseCommand\r
+\r
+ @param AtapiScsiPrivate\r
+ @param Target\r
+ @param Timeout\r
+ @param SenseData\r
+ @param SenseDataLength\r
+\r
+ @todo Add function description\r
+ @todo AtapiScsiPrivate TODO: add argument description\r
+ @todo Target TODO: add argument description\r
+ @todo Timeout TODO: add argument description\r
+ @todo SenseData TODO: add argument description\r
+ @todo SenseDataLength TODO: add argument description\r
+ @todo add return values\r
+**/\r
+EFI_STATUS\r
+RequestSenseCommand (\r
+ ATAPI_SCSI_PASS_THRU_DEV *AtapiScsiPrivate,\r
+ UINT32 Target,\r
+ UINT64 Timeout,\r
+ VOID *SenseData,\r
+ UINT8 *SenseDataLength\r
+ )\r
+{\r
+ EFI_SCSI_PASS_THRU_SCSI_REQUEST_PACKET Packet;\r
+ UINT8 Cdb[12];\r
+ EFI_STATUS Status;\r
+\r
+ ZeroMem (&Packet, sizeof (EFI_SCSI_PASS_THRU_SCSI_REQUEST_PACKET));\r
+ ZeroMem (Cdb, 12);\r
+\r
+ Cdb[0] = OP_REQUEST_SENSE;\r
+ Cdb[4] = (UINT8) (*SenseDataLength);\r
+\r
+ Packet.Timeout = Timeout;\r
+ Packet.DataBuffer = SenseData;\r
+ Packet.SenseData = NULL;\r
+ Packet.Cdb = Cdb;\r
+ Packet.TransferLength = *SenseDataLength;\r
+ Packet.CdbLength = 12;\r
+ Packet.DataDirection = DataIn;\r
+\r
+ Status = SubmitBlockingIoCommand (AtapiScsiPrivate, Target, &Packet);\r
+ *SenseDataLength = (UINT8) (Packet.TransferLength);\r
+ return Status;\r
+}\r
+\r
+/**\r
+ Submits ATAPI command packet to the specified ATAPI device.\r
+\r
+ @param AtapiScsiPrivate: Private data structure for the specified channel.\r
+ @param Target: The Target ID of the ATAPI device to send the SCSI\r
+ Request Packet. To ATAPI devices attached on an IDE\r
+ Channel, Target ID 0 indicates Master device;Target\r
+ ID 1 indicates Slave device.\r
+ @param PacketCommand: Points to the ATAPI command packet.\r
+ @param Buffer: Points to the transferred data.\r
+ @param ByteCount: When input,indicates the buffer size; when output,\r
+ indicates the actually transferred data size.\r
+ @param Direction: Indicates the data transfer direction.\r
+ @param TimeoutInMicroSeconds: The timeout, in micro second units,\r
+ to use for the execution of this ATAPI command.\r
+ A TimeoutInMicroSeconds value of 0 means that\r
+ this function will wait indefinitely for the ATAPI\r
+ command to execute.\r
+ <P>\r
+ If TimeoutInMicroSeconds is greater than zero, then\r
+ this function will return EFI_TIMEOUT if the time\r
+ required to execute the ATAPI command is greater\r
+ than TimeoutInMicroSeconds.\r
+ </P>\r
+\r
+ @todo AtapiScsiPrivate - add argument and description to function comment\r
+ @todo PacketCommand - add argument and description to function comment\r
+ @todo Buffer - add argument and description to function comment\r
+ @todo ByteCount - add argument and description to function comment\r
+ @todo Direction - add argument and description to function comment\r
+**/\r
+EFI_STATUS\r
+AtapiPacketCommand (\r
+ ATAPI_SCSI_PASS_THRU_DEV *AtapiScsiPrivate,\r
+ UINT32 Target,\r
+ UINT8 *PacketCommand,\r
+ VOID *Buffer,\r
+ UINT32 *ByteCount,\r
+ DATA_DIRECTION Direction,\r
+ UINT64 TimeoutInMicroSeconds\r
+ )\r
+{\r
+\r
+ UINT16 *CommandIndex;\r
+ UINT8 Count;\r
+ EFI_STATUS Status;\r
+\r
+ //\r
+ // Set all the command parameters by fill related registers.\r
+ // Before write to all the following registers, BSY and DRQ must be 0.\r
+ //\r
+ Status = StatusDRQClear (AtapiScsiPrivate, TimeoutInMicroSeconds);\r
+ if (EFI_ERROR (Status)) {\r
+ if (Status == EFI_ABORTED) {\r
+ Status = EFI_DEVICE_ERROR;\r
+ }\r
+\r
+ *ByteCount = 0;\r
+ return Status;\r
+ }\r
+ //\r
+ // Select device via Device/Head Register.\r
+ // "Target = 0" indicates device 0; "Target = 1" indicates device 1\r
+ //\r
+ WritePortB (\r
+ AtapiScsiPrivate->PciIo,\r
+ AtapiScsiPrivate->IoPort->Head,\r
+ (UINT8) ((Target << 4) | DEFAULT_CMD) // DEFAULT_CMD: 0xa0 (1010,0000)\r
+ );\r
+\r
+ //\r
+ // No OVL; No DMA (by setting feature register)\r
+ //\r
+ WritePortB (\r
+ AtapiScsiPrivate->PciIo,\r
+ AtapiScsiPrivate->IoPort->Reg1.Feature,\r
+ 0x00\r
+ );\r
+\r
+ //\r
+ // set the transfersize to MAX_ATAPI_BYTE_COUNT to let the device\r
+ // determine how much data should be transfered.\r
+ //\r
+ WritePortB (\r
+ AtapiScsiPrivate->PciIo,\r
+ AtapiScsiPrivate->IoPort->CylinderLsb,\r
+ (UINT8) (MAX_ATAPI_BYTE_COUNT & 0x00ff)\r
+ );\r
+ WritePortB (\r
+ AtapiScsiPrivate->PciIo,\r
+ AtapiScsiPrivate->IoPort->CylinderMsb,\r
+ (UINT8) (MAX_ATAPI_BYTE_COUNT >> 8)\r
+ );\r
+\r
+ //\r
+ // DEFAULT_CTL:0x0a (0000,1010)\r
+ // Disable interrupt\r
+ //\r
+ WritePortB (\r
+ AtapiScsiPrivate->PciIo,\r
+ AtapiScsiPrivate->IoPort->Alt.DeviceControl,\r
+ DEFAULT_CTL\r
+ );\r
+\r
+ //\r
+ // Send Packet command to inform device\r
+ // that the following data bytes are command packet.\r
+ //\r
+ WritePortB (\r
+ AtapiScsiPrivate->PciIo,\r
+ AtapiScsiPrivate->IoPort->Reg.Command,\r
+ PACKET_CMD\r
+ );\r
+\r
+ //\r
+ // Before data transfer, BSY should be 0 and DRQ should be 1.\r
+ // if they are not in specified time frame,\r
+ // retrieve Sense Key from Error Register before return.\r
+ //\r
+ Status = StatusDRQReady (AtapiScsiPrivate, TimeoutInMicroSeconds);\r
+ if (EFI_ERROR (Status)) {\r
+ if (Status == EFI_ABORTED) {\r
+ Status = EFI_DEVICE_ERROR;\r
+ }\r
+\r
+ *ByteCount = 0;\r
+ return Status;\r
+ }\r
+\r
+ //\r
+ // Send out command packet\r
+ //\r
+ CommandIndex = (UINT16 *) PacketCommand;\r
+ for (Count = 0; Count < 6; Count++, CommandIndex++) {\r
+ WritePortW (AtapiScsiPrivate->PciIo, AtapiScsiPrivate->IoPort->Data, *CommandIndex);\r
+ }\r
+\r
+ //\r
+ // call AtapiPassThruPioReadWriteData() function to get\r
+ // requested transfer data form device.\r
+ //\r
+ return AtapiPassThruPioReadWriteData (\r
+ AtapiScsiPrivate,\r
+ Buffer,\r
+ ByteCount,\r
+ Direction,\r
+ TimeoutInMicroSeconds\r
+ );\r
+}\r
+\r
+/**\r
+ Performs data transfer between ATAPI device and host after the\r
+ ATAPI command packet is sent.\r
+\r
+ @param AtapiScsiPrivate: Private data structure for the specified channel.\r
+ @param Buffer: Points to the transferred data.\r
+ @param ByteCount: When input,indicates the buffer size; when output,\r
+ indicates the actually transferred data size.\r
+ @param Direction: Indicates the data transfer direction.\r
+ @param TimeoutInMicroSeconds: The timeout, in micro second units,\r
+ to use for the execution of this ATAPI command.\r
+ A TimeoutInMicroSeconds value of 0 means that\r
+ this function will wait indefinitely for the ATAPI\r
+ command to execute.\r
+ <P>\r
+ If TimeoutInMicroSeconds is greater than zero, then\r
+ this function will return EFI_TIMEOUT if the time\r
+ required to execute the ATAPI command is greater\r
+ than TimeoutInMicroSeconds.\r
+ </P>\r
+\r
+ @todo AtapiScsiPrivate - add argument and description to function comment\r
+ @todo Buffer - add argument and description to function comment\r
+ @todo ByteCount - add argument and description to function comment\r
+ @todo Direction - add argument and description to function comment\r
+ @todo EFI_DEVICE_ERROR - add return value to function comment\r
+ @todo EFI_DEVICE_ERROR - add return value to function comment\r
+ @todo EFI_WARN_BUFFER_TOO_SMALL - add return value to function comment\r
+**/\r
+EFI_STATUS\r
+AtapiPassThruPioReadWriteData (\r
+ ATAPI_SCSI_PASS_THRU_DEV *AtapiScsiPrivate,\r
+ UINT16 *Buffer,\r
+ UINT32 *ByteCount,\r
+ DATA_DIRECTION Direction,\r
+ UINT64 TimeoutInMicroSeconds\r
+ )\r
+{\r
+ UINT32 Index;\r
+ UINT32 RequiredWordCount;\r
+ UINT32 ActualWordCount;\r
+\r
+ UINT32 WordCount;\r
+ EFI_STATUS Status;\r
+ UINT16 *ptrBuffer;\r
+\r
+ Status = EFI_SUCCESS;\r
+\r
+ //\r
+ // Non Data transfer request is also supported.\r
+ //\r
+ if (*ByteCount == 0 || Buffer == NULL) {\r
+ *ByteCount = 0;\r
+ if (EFI_ERROR (StatusWaitForBSYClear (AtapiScsiPrivate, TimeoutInMicroSeconds))) {\r
+ return EFI_DEVICE_ERROR;\r
+ }\r
+ }\r
+\r
+ ptrBuffer = Buffer;\r
+ RequiredWordCount = *ByteCount / 2;\r
+\r
+ //\r
+ // ActuralWordCount means the word count of data really transfered.\r
+ //\r
+ ActualWordCount = 0;\r
+\r
+ while (ActualWordCount < RequiredWordCount) {\r
+ //\r
+ // before each data transfer stream, the host should poll DRQ bit ready,\r
+ // which indicates device's ready for data transfer .\r
+ //\r
+ Status = StatusDRQReady (AtapiScsiPrivate, TimeoutInMicroSeconds);\r
+ if (EFI_ERROR (Status)) {\r
+ *ByteCount = ActualWordCount * 2;\r
+\r
+ AtapiPassThruCheckErrorStatus (AtapiScsiPrivate);\r
+\r
+ if (ActualWordCount == 0) {\r
+ return EFI_DEVICE_ERROR;\r
+ }\r
+ //\r
+ // ActualWordCount > 0\r
+ //\r
+ if (ActualWordCount < RequiredWordCount) {\r
+ return EFI_WARN_BUFFER_TOO_SMALL;\r
+ }\r
+ }\r
+ //\r
+ // get current data transfer size from Cylinder Registers.\r
+ //\r
+ WordCount = ReadPortB (AtapiScsiPrivate->PciIo, AtapiScsiPrivate->IoPort->CylinderMsb) << 8;\r
+ WordCount = WordCount | ReadPortB (AtapiScsiPrivate->PciIo, AtapiScsiPrivate->IoPort->CylinderLsb);\r
+ WordCount = WordCount & 0xffff;\r
+ WordCount /= 2;\r
+\r
+ //\r
+ // perform a series data In/Out.\r
+ //\r
+ for (Index = 0; (Index < WordCount) && (ActualWordCount < RequiredWordCount); Index++, ActualWordCount++) {\r
+\r
+ if (Direction == DataIn) {\r
+\r
+ *ptrBuffer = ReadPortW (AtapiScsiPrivate->PciIo, AtapiScsiPrivate->IoPort->Data);\r
+ } else {\r
+\r
+ WritePortW (AtapiScsiPrivate->PciIo, AtapiScsiPrivate->IoPort->Data, *ptrBuffer);\r
+ }\r
+\r
+ ptrBuffer++;\r
+\r
+ }\r
+ }\r
+ //\r
+ // After data transfer is completed, normally, DRQ bit should clear.\r
+ //\r
+ StatusDRQClear (AtapiScsiPrivate, TimeoutInMicroSeconds);\r
+\r
+ //\r
+ // read status register to check whether error happens.\r
+ //\r
+ Status = AtapiPassThruCheckErrorStatus (AtapiScsiPrivate);\r
+\r
+ *ByteCount = ActualWordCount * 2;\r
+\r
+ return Status;\r
+}\r
+\r
+\r
+/**\r
+ Read one byte from a specified I/O port.\r
+\r
+ @todo function comment is missing 'Routine Description:'\r
+ @todo function comment is missing 'Arguments:'\r
+ @todo function comment is missing 'Returns:'\r
+ @todo PciIo - add argument and description to function comment\r
+ @todo Port - add argument and description to function comment\r
+**/\r
+UINT8\r
+ReadPortB (\r
+ IN EFI_PCI_IO_PROTOCOL *PciIo,\r
+ IN UINT16 Port\r
+ )\r
+{\r
+ UINT8 Data;\r
+\r
+ Data = 0;\r
+ PciIo->Io.Read (\r
+ PciIo,\r
+ EfiPciIoWidthUint8,\r
+ EFI_PCI_IO_PASS_THROUGH_BAR,\r
+ (UINT64) Port,\r
+ 1,\r
+ &Data\r
+ );\r
+ return Data;\r
+}\r
+\r
+\r
+/**\r
+ Read one word from a specified I/O port.\r
+\r
+ @todo function comment is missing 'Routine Description:'\r
+ @todo function comment is missing 'Arguments:'\r
+ @todo function comment is missing 'Returns:'\r
+ @todo PciIo - add argument and description to function comment\r
+ @todo Port - add argument and description to function comment\r
+**/\r
+UINT16\r
+ReadPortW (\r
+ IN EFI_PCI_IO_PROTOCOL *PciIo,\r
+ IN UINT16 Port\r
+ )\r
+{\r
+ UINT16 Data;\r
+\r
+ Data = 0;\r
+ PciIo->Io.Read (\r
+ PciIo,\r
+ EfiPciIoWidthUint16,\r
+ EFI_PCI_IO_PASS_THROUGH_BAR,\r
+ (UINT64) Port,\r
+ 1,\r
+ &Data\r
+ );\r
+ return Data;\r
+}\r
+\r
+\r
+/**\r
+ Write one byte to a specified I/O port.\r
+\r
+ @todo function comment is missing 'Routine Description:'\r
+ @todo function comment is missing 'Arguments:'\r
+ @todo function comment is missing 'Returns:'\r
+ @todo PciIo - add argument and description to function comment\r
+ @todo Port - add argument and description to function comment\r
+ @todo Data - add argument and description to function comment\r
+**/\r
+VOID\r
+WritePortB (\r
+ IN EFI_PCI_IO_PROTOCOL *PciIo,\r
+ IN UINT16 Port,\r
+ IN UINT8 Data\r
+ )\r
+{\r
+\r
+ PciIo->Io.Write (\r
+ PciIo,\r
+ EfiPciIoWidthUint8,\r
+ EFI_PCI_IO_PASS_THROUGH_BAR,\r
+ (UINT64) Port,\r
+ 1,\r
+ &Data\r
+ );\r
+\r
+}\r
+\r
+\r
+/**\r
+ Write one word to a specified I/O port.\r
+\r
+ @todo function comment is missing 'Routine Description:'\r
+ @todo function comment is missing 'Arguments:'\r
+ @todo function comment is missing 'Returns:'\r
+ @todo PciIo - add argument and description to function comment\r
+ @todo Port - add argument and description to function comment\r
+ @todo Data - add argument and description to function comment\r
+**/\r
+VOID\r
+WritePortW (\r
+ IN EFI_PCI_IO_PROTOCOL *PciIo,\r
+ IN UINT16 Port,\r
+ IN UINT16 Data\r
+ )\r
+{\r
+\r
+ PciIo->Io.Write (\r
+ PciIo,\r
+ EfiPciIoWidthUint16,\r
+ EFI_PCI_IO_PASS_THROUGH_BAR,\r
+ (UINT64) Port,\r
+ 1,\r
+ &Data\r
+ );\r
+}\r
+\r
+/**\r
+ Check whether DRQ is clear in the Status Register. (BSY must also be cleared)\r
+ If TimeoutInMicroSeconds is zero, this routine should wait infinitely for\r
+ DRQ clear. Otherwise, it will return EFI_TIMEOUT when specified time is \r
+ elapsed.\r
+\r
+ @todo function comment is missing 'Routine Description:'\r
+ @todo function comment is missing 'Arguments:'\r
+ @todo function comment is missing 'Returns:'\r
+ @todo AtapiScsiPrivate - add argument and description to function comment\r
+ @todo TimeoutInMicroSeconds - add argument and description to function comment\r
+ @todo EFI_ABORTED - add return value to function comment\r
+ @todo EFI_TIMEOUT - add return value to function comment\r
+ @todo EFI_SUCCESS - add return value to function comment\r
+**/\r
+EFI_STATUS\r
+StatusDRQClear (\r
+ ATAPI_SCSI_PASS_THRU_DEV *AtapiScsiPrivate,\r
+ UINT64 TimeoutInMicroSeconds\r
+ )\r
+{\r
+ UINT64 Delay;\r
+ UINT8 StatusRegister;\r
+ UINT8 ErrRegister;\r
+\r
+ if (TimeoutInMicroSeconds == 0) {\r
+ Delay = 2;\r
+ } else {\r
+ Delay = DivU64x32 (TimeoutInMicroSeconds, (UINT32) 30) + 1;\r
+ }\r
+\r
+ do {\r
+\r
+ StatusRegister = ReadPortB (\r
+ AtapiScsiPrivate->PciIo,\r
+ AtapiScsiPrivate->IoPort->Reg.Status\r
+ );\r
+\r
+ //\r
+ // wait for BSY == 0 and DRQ == 0\r
+ //\r
+ if ((StatusRegister & (DRQ | BSY)) == 0) {\r
+ break;\r
+ }\r
+ //\r
+ // check whether the command is aborted by the device\r
+ //\r
+ if ((StatusRegister & (BSY | ERR)) == ERR) {\r
+\r
+ ErrRegister = ReadPortB (\r
+ AtapiScsiPrivate->PciIo,\r
+ AtapiScsiPrivate->IoPort->Reg1.Error\r
+ );\r
+ if ((ErrRegister & ABRT_ERR) == ABRT_ERR) {\r
+\r
+ return EFI_ABORTED;\r
+ }\r
+ }\r
+ //\r
+ // Stall for 30 us\r
+ //\r
+ gBS->Stall (30);\r
+\r
+ //\r
+ // Loop infinitely if not meeting expected condition\r
+ //\r
+ if (TimeoutInMicroSeconds == 0) {\r
+ Delay = 2;\r
+ }\r
+\r
+ Delay--;\r
+ } while (Delay);\r
+\r
+ if (Delay == 0) {\r
+ return EFI_TIMEOUT;\r
+ }\r
+\r
+ return EFI_SUCCESS;\r
+}\r
+\r
+/**\r
+ Check whether DRQ is clear in the Alternate Status Register. \r
+ (BSY must also be cleared).\r
+ If TimeoutInMicroSeconds is zero, this routine should wait infinitely for\r
+ DRQ clear. Otherwise, it will return EFI_TIMEOUT when specified time is \r
+ elapsed.\r
+\r
+ @todo function comment is missing 'Routine Description:'\r
+ @todo function comment is missing 'Arguments:'\r
+ @todo function comment is missing 'Returns:'\r
+ @todo AtapiScsiPrivate - add argument and description to function comment\r
+ @todo TimeoutInMicroSeconds - add argument and description to function comment\r
+ @todo EFI_ABORTED - add return value to function comment\r
+ @todo EFI_TIMEOUT - add return value to function comment\r
+ @todo EFI_SUCCESS - add return value to function comment\r
+**/\r
+EFI_STATUS\r
+AltStatusDRQClear (\r
+ ATAPI_SCSI_PASS_THRU_DEV *AtapiScsiPrivate,\r
+ UINT64 TimeoutInMicroSeconds\r
+ )\r
+{\r
+ UINT64 Delay;\r
+ UINT8 AltStatusRegister;\r
+ UINT8 ErrRegister;\r
+\r
+ if (TimeoutInMicroSeconds == 0) {\r
+ Delay = 2;\r
+ } else {\r
+ Delay = DivU64x32 (TimeoutInMicroSeconds, (UINT32) 30) + 1;\r
+ }\r
+\r
+ do {\r
+\r
+ AltStatusRegister = ReadPortB (\r
+ AtapiScsiPrivate->PciIo,\r
+ AtapiScsiPrivate->IoPort->Alt.AltStatus\r
+ );\r
+\r
+ //\r
+ // wait for BSY == 0 and DRQ == 0\r
+ //\r
+ if ((AltStatusRegister & (DRQ | BSY)) == 0) {\r
+ break;\r
+ }\r
+\r
+ if ((AltStatusRegister & (BSY | ERR)) == ERR) {\r
+\r
+ ErrRegister = ReadPortB (\r
+ AtapiScsiPrivate->PciIo,\r
+ AtapiScsiPrivate->IoPort->Reg1.Error\r
+ );\r
+ if ((ErrRegister & ABRT_ERR) == ABRT_ERR) {\r
+\r
+ return EFI_ABORTED;\r
+ }\r
+ }\r
+ //\r
+ // Stall for 30 us\r
+ //\r
+ gBS->Stall (30);\r
+\r
+ //\r
+ // Loop infinitely if not meeting expected condition\r
+ //\r
+ if (TimeoutInMicroSeconds == 0) {\r
+ Delay = 2;\r
+ }\r
+\r
+ Delay--;\r
+ } while (Delay);\r
+\r
+ if (Delay == 0) {\r
+ return EFI_TIMEOUT;\r
+ }\r
+\r
+ return EFI_SUCCESS;\r
+}\r
+\r
+/**\r
+ Check whether DRQ is ready in the Status Register. (BSY must also be cleared)\r
+ If TimeoutInMicroSeconds is zero, this routine should wait infinitely for\r
+ DRQ ready. Otherwise, it will return EFI_TIMEOUT when specified time is \r
+ elapsed.\r
+\r
+ @todo function comment is missing 'Routine Description:'\r
+ @todo function comment is missing 'Arguments:'\r
+ @todo function comment is missing 'Returns:'\r
+ @todo AtapiScsiPrivate - add argument and description to function comment\r
+ @todo TimeoutInMicroSeconds - add argument and description to function comment\r
+ @todo EFI_ABORTED - add return value to function comment\r
+ @todo EFI_TIMEOUT - add return value to function comment\r
+ @todo EFI_SUCCESS - add return value to function comment\r
+**/\r
+EFI_STATUS\r
+StatusDRQReady (\r
+ ATAPI_SCSI_PASS_THRU_DEV *AtapiScsiPrivate,\r
+ UINT64 TimeoutInMicroSeconds\r
+ )\r
+{\r
+ UINT64 Delay;\r
+ UINT8 StatusRegister;\r
+ UINT8 ErrRegister;\r
+\r
+ if (TimeoutInMicroSeconds == 0) {\r
+ Delay = 2;\r
+ } else {\r
+ Delay = DivU64x32 (TimeoutInMicroSeconds, (UINT32) 30) + 1;\r
+ }\r
+\r
+ do {\r
+ //\r
+ // read Status Register will clear interrupt\r
+ //\r
+ StatusRegister = ReadPortB (\r
+ AtapiScsiPrivate->PciIo,\r
+ AtapiScsiPrivate->IoPort->Reg.Status\r
+ );\r
+\r
+ //\r
+ // BSY==0,DRQ==1\r
+ //\r
+ if ((StatusRegister & (BSY | DRQ)) == DRQ) {\r
+ break;\r
+ }\r
+\r
+ if ((StatusRegister & (BSY | ERR)) == ERR) {\r
+\r
+ ErrRegister = ReadPortB (\r
+ AtapiScsiPrivate->PciIo,\r
+ AtapiScsiPrivate->IoPort->Reg1.Error\r
+ );\r
+ if ((ErrRegister & ABRT_ERR) == ABRT_ERR) {\r
+ return EFI_ABORTED;\r
+ }\r
+ }\r
+\r
+ //\r
+ // Stall for 30 us\r
+ //\r
+ gBS->Stall (30);\r
+\r
+ //\r
+ // Loop infinitely if not meeting expected condition\r
+ //\r
+ if (TimeoutInMicroSeconds == 0) {\r
+ Delay = 2;\r
+ }\r
+\r
+ Delay--;\r
+ } while (Delay);\r
+\r
+ if (Delay == 0) {\r
+ return EFI_TIMEOUT;\r
+ }\r
+\r
+ return EFI_SUCCESS;\r
+}\r
+\r
+/**\r
+ Check whether DRQ is ready in the Alternate Status Register. \r
+ (BSY must also be cleared)\r
+ If TimeoutInMicroSeconds is zero, this routine should wait infinitely for\r
+ DRQ ready. Otherwise, it will return EFI_TIMEOUT when specified time is \r
+ elapsed.\r
+\r
+ @todo function comment is missing 'Routine Description:'\r
+ @todo function comment is missing 'Arguments:'\r
+ @todo function comment is missing 'Returns:'\r
+ @todo AtapiScsiPrivate - add argument and description to function comment\r
+ @todo TimeoutInMicroSeconds - add argument and description to function comment\r
+ @todo EFI_ABORTED - add return value to function comment\r
+ @todo EFI_TIMEOUT - add return value to function comment\r
+ @todo EFI_SUCCESS - add return value to function comment\r
+**/\r
+EFI_STATUS\r
+AltStatusDRQReady (\r
+ ATAPI_SCSI_PASS_THRU_DEV *AtapiScsiPrivate,\r
+ UINT64 TimeoutInMicroSeconds\r
+ )\r
+{\r
+ UINT64 Delay;\r
+ UINT8 AltStatusRegister;\r
+ UINT8 ErrRegister;\r
+\r
+ if (TimeoutInMicroSeconds == 0) {\r
+ Delay = 2;\r
+ } else {\r
+ Delay = DivU64x32 (TimeoutInMicroSeconds, (UINT32) 30) + 1;\r
+ }\r
+\r
+ do {\r
+ //\r
+ // read Status Register will clear interrupt\r
+ //\r
+ AltStatusRegister = ReadPortB (\r
+ AtapiScsiPrivate->PciIo,\r
+ AtapiScsiPrivate->IoPort->Alt.AltStatus\r
+ );\r
+ //\r
+ // BSY==0,DRQ==1\r
+ //\r
+ if ((AltStatusRegister & (BSY | DRQ)) == DRQ) {\r
+ break;\r
+ }\r
+\r
+ if ((AltStatusRegister & (BSY | ERR)) == ERR) {\r
+\r
+ ErrRegister = ReadPortB (\r
+ AtapiScsiPrivate->PciIo,\r
+ AtapiScsiPrivate->IoPort->Reg1.Error\r
+ );\r
+ if ((ErrRegister & ABRT_ERR) == ABRT_ERR) {\r
+ return EFI_ABORTED;\r
+ }\r
+ }\r
+\r
+ //\r
+ // Stall for 30 us\r
+ //\r
+ gBS->Stall (30);\r
+\r
+ //\r
+ // Loop infinitely if not meeting expected condition\r
+ //\r
+ if (TimeoutInMicroSeconds == 0) {\r
+ Delay = 2;\r
+ }\r
+\r
+ Delay--;\r
+ } while (Delay);\r
+\r
+ if (Delay == 0) {\r
+ return EFI_TIMEOUT;\r
+ }\r
+\r
+ return EFI_SUCCESS;\r
+}\r
+\r
+/**\r
+ Check whether BSY is clear in the Status Register.\r
+ If TimeoutInMicroSeconds is zero, this routine should wait infinitely for\r
+ BSY clear. Otherwise, it will return EFI_TIMEOUT when specified time is \r
+ elapsed.\r
+\r
+ @todo function comment is missing 'Routine Description:'\r
+ @todo function comment is missing 'Arguments:'\r
+ @todo function comment is missing 'Returns:'\r
+ @todo AtapiScsiPrivate - add argument and description to function comment\r
+ @todo TimeoutInMicroSeconds - add argument and description to function comment\r
+ @todo EFI_TIMEOUT - add return value to function comment\r
+ @todo EFI_SUCCESS - add return value to function comment\r
+**/\r
+EFI_STATUS\r
+StatusWaitForBSYClear (\r
+ ATAPI_SCSI_PASS_THRU_DEV *AtapiScsiPrivate,\r
+ UINT64 TimeoutInMicroSeconds\r
+ )\r
+{\r
+ UINT64 Delay;\r
+ UINT8 StatusRegister;\r
+\r
+ if (TimeoutInMicroSeconds == 0) {\r
+ Delay = 2;\r
+ } else {\r
+ Delay = DivU64x32 (TimeoutInMicroSeconds, (UINT32) 30) + 1;\r
+ }\r
+\r
+ do {\r
+\r
+ StatusRegister = ReadPortB (\r
+ AtapiScsiPrivate->PciIo,\r
+ AtapiScsiPrivate->IoPort->Reg.Status\r
+ );\r
+ if ((StatusRegister & BSY) == 0x00) {\r
+ break;\r
+ }\r
+\r
+ //\r
+ // Stall for 30 us\r
+ //\r
+ gBS->Stall (30);\r
+\r
+ //\r
+ // Loop infinitely if not meeting expected condition\r
+ //\r
+ if (TimeoutInMicroSeconds == 0) {\r
+ Delay = 2;\r
+ }\r
+\r
+ Delay--;\r
+ } while (Delay);\r
+\r
+ if (Delay == 0) {\r
+ return EFI_TIMEOUT;\r
+ }\r
+\r
+ return EFI_SUCCESS;\r
+}\r
+\r
+/**\r
+ Check whether BSY is clear in the Alternate Status Register.\r
+ If TimeoutInMicroSeconds is zero, this routine should wait infinitely for\r
+ BSY clear. Otherwise, it will return EFI_TIMEOUT when specified time is \r
+ elapsed.\r
+\r
+ @todo function comment is missing 'Routine Description:'\r
+ @todo function comment is missing 'Arguments:'\r
+ @todo function comment is missing 'Returns:'\r
+ @todo AtapiScsiPrivate - add argument and description to function comment\r
+ @todo TimeoutInMicroSeconds - add argument and description to function comment\r
+ @todo EFI_TIMEOUT - add return value to function comment\r
+ @todo EFI_SUCCESS - add return value to function comment\r
+**/\r
+EFI_STATUS\r
+AltStatusWaitForBSYClear (\r
+ ATAPI_SCSI_PASS_THRU_DEV *AtapiScsiPrivate,\r
+ UINT64 TimeoutInMicroSeconds\r
+ )\r
+{\r
+ UINT64 Delay;\r
+ UINT8 AltStatusRegister;\r
+\r
+ if (TimeoutInMicroSeconds == 0) {\r
+ Delay = 2;\r
+ } else {\r
+ Delay = DivU64x32 (TimeoutInMicroSeconds, (UINT32) 30) + 1;\r
+ }\r
+\r
+ do {\r
+\r
+ AltStatusRegister = ReadPortB (\r
+ AtapiScsiPrivate->PciIo,\r
+ AtapiScsiPrivate->IoPort->Alt.AltStatus\r
+ );\r
+ if ((AltStatusRegister & BSY) == 0x00) {\r
+ break;\r
+ }\r
+\r
+ //\r
+ // Stall for 30 us\r
+ //\r
+ gBS->Stall (30);\r
+ //\r
+ // Loop infinitely if not meeting expected condition\r
+ //\r
+ if (TimeoutInMicroSeconds == 0) {\r
+ Delay = 2;\r
+ }\r
+\r
+ Delay--;\r
+ } while (Delay);\r
+\r
+ if (Delay == 0) {\r
+ return EFI_TIMEOUT;\r
+ }\r
+\r
+ return EFI_SUCCESS;\r
+}\r
+\r
+/**\r
+ Check whether DRDY is ready in the Status Register. \r
+ (BSY must also be cleared)\r
+ If TimeoutInMicroSeconds is zero, this routine should wait infinitely for\r
+ DRDY ready. Otherwise, it will return EFI_TIMEOUT when specified time is \r
+ elapsed.\r
+\r
+ @todo function comment is missing 'Routine Description:'\r
+ @todo function comment is missing 'Arguments:'\r
+ @todo function comment is missing 'Returns:'\r
+ @todo AtapiScsiPrivate - add argument and description to function comment\r
+ @todo TimeoutInMicroSeconds - add argument and description to function comment\r
+ @todo EFI_ABORTED - add return value to function comment\r
+ @todo EFI_TIMEOUT - add return value to function comment\r
+ @todo EFI_SUCCESS - add return value to function comment\r
+**/\r
+EFI_STATUS\r
+StatusDRDYReady (\r
+ ATAPI_SCSI_PASS_THRU_DEV *AtapiScsiPrivate,\r
+ UINT64 TimeoutInMicroSeconds\r
+ )\r
+{\r
+ UINT64 Delay;\r
+ UINT8 StatusRegister;\r
+ UINT8 ErrRegister;\r
+\r
+ if (TimeoutInMicroSeconds == 0) {\r
+ Delay = 2;\r
+ } else {\r
+ Delay = DivU64x32 (TimeoutInMicroSeconds, (UINT32) 30) + 1;\r
+ }\r
+\r
+ do {\r
+ StatusRegister = ReadPortB (\r
+ AtapiScsiPrivate->PciIo,\r
+ AtapiScsiPrivate->IoPort->Reg.Status\r
+ );\r
+ //\r
+ // BSY == 0 , DRDY == 1\r
+ //\r
+ if ((StatusRegister & (DRDY | BSY)) == DRDY) {\r
+ break;\r
+ }\r
+\r
+ if ((StatusRegister & (BSY | ERR)) == ERR) {\r
+\r
+ ErrRegister = ReadPortB (\r
+ AtapiScsiPrivate->PciIo,\r
+ AtapiScsiPrivate->IoPort->Reg1.Error\r
+ );\r
+ if ((ErrRegister & ABRT_ERR) == ABRT_ERR) {\r
+ return EFI_ABORTED;\r
+ }\r
+ }\r
+ \r
+ //\r
+ // Stall for 30 us\r
+ //\r
+ gBS->Stall (30);\r
+ //\r
+ // Loop infinitely if not meeting expected condition\r
+ //\r
+ if (TimeoutInMicroSeconds == 0) {\r
+ Delay = 2;\r
+ }\r
+\r
+ Delay--;\r
+ } while (Delay);\r
+\r
+ if (Delay == 0) {\r
+ return EFI_TIMEOUT;\r
+ }\r
+\r
+ return EFI_SUCCESS;\r
+}\r
+\r
+/**\r
+ Check whether DRDY is ready in the Alternate Status Register. \r
+ (BSY must also be cleared)\r
+ If TimeoutInMicroSeconds is zero, this routine should wait infinitely for\r
+ DRDY ready. Otherwise, it will return EFI_TIMEOUT when specified time is \r
+ elapsed.\r
+\r
+ @todo function comment is missing 'Routine Description:'\r
+ @todo function comment is missing 'Arguments:'\r
+ @todo function comment is missing 'Returns:'\r
+ @todo AtapiScsiPrivate - add argument and description to function comment\r
+ @todo TimeoutInMicroSeconds - add argument and description to function comment\r
+ @todo EFI_ABORTED - add return value to function comment\r
+ @todo EFI_TIMEOUT - add return value to function comment\r
+ @todo EFI_SUCCESS - add return value to function comment\r
+**/\r
+EFI_STATUS\r
+AltStatusDRDYReady (\r
+ ATAPI_SCSI_PASS_THRU_DEV *AtapiScsiPrivate,\r
+ UINT64 TimeoutInMicroSeconds\r
+ )\r
+{\r
+ UINT64 Delay;\r
+ UINT8 AltStatusRegister;\r
+ UINT8 ErrRegister;\r
+\r
+ if (TimeoutInMicroSeconds == 0) {\r
+ Delay = 2;\r
+ } else {\r
+ Delay = DivU64x32 (TimeoutInMicroSeconds, (UINT32) 30) + 1;\r
+ }\r
+\r
+ do {\r
+ AltStatusRegister = ReadPortB (\r
+ AtapiScsiPrivate->PciIo,\r
+ AtapiScsiPrivate->IoPort->Alt.AltStatus\r
+ );\r
+ //\r
+ // BSY == 0 , DRDY == 1\r
+ //\r
+ if ((AltStatusRegister & (DRDY | BSY)) == DRDY) {\r
+ break;\r
+ }\r
+\r
+ if ((AltStatusRegister & (BSY | ERR)) == ERR) {\r
+\r
+ ErrRegister = ReadPortB (\r
+ AtapiScsiPrivate->PciIo,\r
+ AtapiScsiPrivate->IoPort->Reg1.Error\r
+ );\r
+ if ((ErrRegister & ABRT_ERR) == ABRT_ERR) {\r
+ return EFI_ABORTED;\r
+ }\r
+ }\r
+\r
+ //\r
+ // Stall for 30 us\r
+ //\r
+ gBS->Stall (30);\r
+ //\r
+ // Loop infinitely if not meeting expected condition\r
+ //\r
+ if (TimeoutInMicroSeconds == 0) {\r
+ Delay = 2;\r
+ }\r
+\r
+ Delay--;\r
+ } while (Delay);\r
+\r
+ if (Delay == 0) {\r
+ return EFI_TIMEOUT;\r
+ }\r
+\r
+ return EFI_SUCCESS;\r
+}\r
+\r
+/**\r
+ Check Error Register for Error Information. \r
+\r
+ @todo function comment is missing 'Routine Description:'\r
+ @todo function comment is missing 'Arguments:'\r
+ @todo function comment is missing 'Returns:'\r
+ @todo AtapiScsiPrivate - add argument and description to function comment\r
+ @todo EFI_SUCCESS - add return value to function comment\r
+ @todo EFI_DEVICE_ERROR - add return value to function comment\r
+**/\r
+EFI_STATUS\r
+AtapiPassThruCheckErrorStatus (\r
+ ATAPI_SCSI_PASS_THRU_DEV *AtapiScsiPrivate\r
+ )\r
+{\r
+ UINT8 StatusRegister;\r
+ UINT8 ErrorRegister;\r
+\r
+ StatusRegister = ReadPortB (\r
+ AtapiScsiPrivate->PciIo,\r
+ AtapiScsiPrivate->IoPort->Reg.Status\r
+ );\r
+ \r
+ DEBUG_CODE_BEGIN ();\r
+\r
+ if (StatusRegister & DWF) {\r
+ DEBUG (\r
+ (EFI_D_BLKIO,\r
+ "AtapiPassThruCheckErrorStatus()-- %02x : Error : Write Fault\n",\r
+ StatusRegister)\r
+ );\r
+ }\r
+\r
+ if (StatusRegister & CORR) {\r
+ DEBUG (\r
+ (EFI_D_BLKIO,\r
+ "AtapiPassThruCheckErrorStatus()-- %02x : Error : Corrected Data\n",\r
+ StatusRegister)\r
+ );\r
+ }\r
+\r
+ if (StatusRegister & ERR) {\r
+ ErrorRegister = ReadPortB (AtapiScsiPrivate->PciIo, AtapiScsiPrivate->IoPort->Reg1.Error);\r
+ \r
+\r
+ if (ErrorRegister & BBK_ERR) {\r
+ DEBUG (\r
+ (EFI_D_BLKIO,\r
+ "AtapiPassThruCheckErrorStatus()-- %02x : Error : Bad Block Detected\n",\r
+ ErrorRegister)\r
+ );\r
+ }\r
+\r
+ if (ErrorRegister & UNC_ERR) {\r
+ DEBUG (\r
+ (EFI_D_BLKIO,\r
+ "AtapiPassThruCheckErrorStatus()-- %02x : Error : Uncorrectable Data\n",\r
+ ErrorRegister)\r
+ );\r
+ }\r
+\r
+ if (ErrorRegister & MC_ERR) {\r
+ DEBUG (\r
+ (EFI_D_BLKIO,\r
+ "AtapiPassThruCheckErrorStatus()-- %02x : Error : Media Change\n",\r
+ ErrorRegister)\r
+ );\r
+ }\r
+\r
+ if (ErrorRegister & ABRT_ERR) {\r
+ DEBUG (\r
+ (EFI_D_BLKIO,\r
+ "AtapiPassThruCheckErrorStatus()-- %02x : Error : Abort\n",\r
+ ErrorRegister)\r
+ );\r
+ }\r
+\r
+ if (ErrorRegister & TK0NF_ERR) {\r
+ DEBUG (\r
+ (EFI_D_BLKIO,\r
+ "AtapiPassThruCheckErrorStatus()-- %02x : Error : Track 0 Not Found\n",\r
+ ErrorRegister)\r
+ );\r
+ }\r
+\r
+ if (ErrorRegister & AMNF_ERR) {\r
+ DEBUG (\r
+ (EFI_D_BLKIO,\r
+ "AtapiPassThruCheckErrorStatus()-- %02x : Error : Address Mark Not Found\n",\r
+ ErrorRegister)\r
+ );\r
+ }\r
+ }\r
+\r
+ DEBUG_CODE_END ();\r
+\r
+ if ((StatusRegister & (ERR | DWF | CORR)) == 0) {\r
+ return EFI_SUCCESS;\r
+ }\r
+\r
+ \r
+ return EFI_DEVICE_ERROR;\r
+}\r
+\r
+/**\r
+ The user Entry Point for module AtapiPassThru. The user code starts with this function.\r
+\r
+ @param[in] ImageHandle The firmware allocated handle for the EFI image. \r
+ @param[in] SystemTable A pointer to the EFI System Table.\r
+ \r
+ @retval EFI_SUCCESS The entry point is executed successfully.\r
+ @retval other Some error occurs when executing this entry point.\r
+\r
+**/\r
+EFI_STATUS\r
+EFIAPI\r
+InitializeAtapiPassThru(\r
+ IN EFI_HANDLE ImageHandle,\r
+ IN EFI_SYSTEM_TABLE *SystemTable\r
+ )\r
+{\r
+ EFI_STATUS Status;\r
+\r
+ //\r
+ // Install driver model protocol(s).\r
+ //\r
+ Status = EfiLibInstallAllDriverProtocols (\r
+ ImageHandle,\r
+ SystemTable,\r
+ &gAtapiScsiPassThruDriverBinding,\r
+ ImageHandle,\r
+ &gAtapiScsiPassThruComponentName,\r
+ NULL,\r
+ NULL\r
+ );\r
+ ASSERT_EFI_ERROR (Status);\r
+\r
+ return Status;\r
+}\r