Coding style modification.
git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@5058 6f19259b-4bc3-4df7-8a09-765794883524
This commit is contained in:
klu2
@@ -1,6 +1,5 @@
|
||||
/**@file
|
||||
|
||||
|
||||
Copyright (c) 2006 - 2007, Intel Corporation.<BR>
|
||||
All rights reserved. This program and the accompanying materials
|
||||
are licensed and made available under the terms and conditions of the BSD License
|
||||
@@ -242,25 +241,17 @@ IsaFloppyComponentNameGetControllerName (
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
Add the component name for the floppy device
|
||||
|
||||
@param FdcDev - A pointer to the FDC_BLK_IO_DEV instance.
|
||||
|
||||
**/
|
||||
VOID
|
||||
AddName (
|
||||
IN FDC_BLK_IO_DEV *FdcDev
|
||||
)
|
||||
/*++
|
||||
|
||||
Routine Description:
|
||||
|
||||
Add the component name for the floppy device
|
||||
|
||||
Arguments:
|
||||
|
||||
FdcDev - A pointer to the FDC_BLK_IO_DEV instance.
|
||||
|
||||
Returns:
|
||||
|
||||
None
|
||||
|
||||
--*/
|
||||
{
|
||||
CHAR16 FloppyDriveName[FLOPPY_DRIVE_NAME_ASCII_LEN + 1];
|
||||
|
||||
@@ -282,3 +273,4 @@ AddName (
|
||||
);
|
||||
|
||||
}
|
||||
|
||||
|
||||
@@ -1,6 +1,5 @@
|
||||
/**@file
|
||||
|
||||
|
||||
Copyright (c) 2006 - 2007, Intel Corporation.<BR>
|
||||
All rights reserved. This program and the accompanying materials
|
||||
are licensed and made available under the terms and conditions of the BSD License
|
||||
@@ -156,7 +155,7 @@ VOID
|
||||
AddName (
|
||||
IN FDC_BLK_IO_DEV *FdcDev
|
||||
)
|
||||
/*++
|
||||
/**
|
||||
|
||||
Routine Description:
|
||||
|
||||
@@ -170,7 +169,7 @@ Returns:
|
||||
|
||||
GC_TODO: add return values
|
||||
|
||||
--*/
|
||||
**/
|
||||
;
|
||||
|
||||
#endif
|
||||
|
||||
@@ -73,7 +73,16 @@ InitializeIsaFloppy(
|
||||
return Status;
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
Test controller is a Floppy Disk Controller
|
||||
|
||||
@param This Pointer of EFI_DRIVER_BINDING_PROTOCOL
|
||||
@param Controller driver's controller
|
||||
@param RemainingDevicePath children device path
|
||||
|
||||
@retval EFI_UNSUPPORTED controller is not floppy disk
|
||||
@retval EFI_SUCCESS controller is floppy disk
|
||||
**/
|
||||
EFI_STATUS
|
||||
EFIAPI
|
||||
FdcControllerDriverSupported (
|
||||
@@ -81,20 +90,6 @@ FdcControllerDriverSupported (
|
||||
IN EFI_HANDLE Controller,
|
||||
IN EFI_DEVICE_PATH_PROTOCOL *RemainingDevicePath
|
||||
)
|
||||
/*++
|
||||
|
||||
Routine Description:
|
||||
|
||||
ControllerDriver Protocol Method
|
||||
|
||||
Arguments:
|
||||
|
||||
Returns:
|
||||
|
||||
--*/
|
||||
// GC_TODO: This - add argument and description to function comment
|
||||
// GC_TODO: Controller - add argument and description to function comment
|
||||
// GC_TODO: RemainingDevicePath - add argument and description to function comment
|
||||
{
|
||||
EFI_STATUS Status;
|
||||
EFI_ISA_IO_PROTOCOL *IsaIo;
|
||||
@@ -133,6 +128,15 @@ Returns:
|
||||
return Status;
|
||||
}
|
||||
|
||||
/**
|
||||
Create floppy control instance on controller.
|
||||
|
||||
@param This Pointer of EFI_DRIVER_BINDING_PROTOCOL
|
||||
@param Controller driver controller handle
|
||||
@param RemainingDevicePath Children's device path
|
||||
|
||||
@retval whether success to create floppy control instance.
|
||||
**/
|
||||
EFI_STATUS
|
||||
EFIAPI
|
||||
FdcControllerDriverStart (
|
||||
@@ -140,18 +144,6 @@ FdcControllerDriverStart (
|
||||
IN EFI_HANDLE Controller,
|
||||
IN EFI_DEVICE_PATH_PROTOCOL *RemainingDevicePath
|
||||
)
|
||||
/*++
|
||||
|
||||
Routine Description:
|
||||
|
||||
Arguments:
|
||||
|
||||
Returns:
|
||||
|
||||
--*/
|
||||
// GC_TODO: This - add argument and description to function comment
|
||||
// GC_TODO: Controller - add argument and description to function comment
|
||||
// GC_TODO: RemainingDevicePath - add argument and description to function comment
|
||||
{
|
||||
EFI_STATUS Status;
|
||||
FDC_BLK_IO_DEV *FdcDev;
|
||||
@@ -364,6 +356,20 @@ Done:
|
||||
return Status;
|
||||
}
|
||||
|
||||
/**
|
||||
Stop this driver on ControllerHandle. Support stoping any child handles
|
||||
created by this driver.
|
||||
|
||||
@param This Protocol instance pointer.
|
||||
@param ControllerHandle Handle of device to stop driver on
|
||||
@param NumberOfChildren Number of Handles in ChildHandleBuffer. If number of
|
||||
children is zero stop the entire bus driver.
|
||||
@param ChildHandleBuffer List of Child Handles to Stop.
|
||||
|
||||
@retval EFI_SUCCESS This driver is removed ControllerHandle
|
||||
@retval other This driver was not removed from this device
|
||||
|
||||
**/
|
||||
EFI_STATUS
|
||||
EFIAPI
|
||||
FdcControllerDriverStop (
|
||||
@@ -372,20 +378,6 @@ FdcControllerDriverStop (
|
||||
IN UINTN NumberOfChildren,
|
||||
IN EFI_HANDLE *ChildHandleBuffer
|
||||
)
|
||||
/*++
|
||||
|
||||
Routine Description:
|
||||
|
||||
Arguments:
|
||||
|
||||
Returns:
|
||||
|
||||
--*/
|
||||
// GC_TODO: This - add argument and description to function comment
|
||||
// GC_TODO: Controller - add argument and description to function comment
|
||||
// GC_TODO: NumberOfChildren - add argument and description to function comment
|
||||
// GC_TODO: ChildHandleBuffer - add argument and description to function comment
|
||||
// GC_TODO: EFI_SUCCESS - add return value to function comment
|
||||
{
|
||||
EFI_STATUS Status;
|
||||
EFI_BLOCK_IO_PROTOCOL *BlkIo;
|
||||
@@ -478,3 +470,4 @@ FdcControllerDriverStop (
|
||||
|
||||
return EFI_SUCCESS;
|
||||
}
|
||||
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@@ -23,29 +23,24 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
|
||||
|
||||
#include "IsaFloppy.h"
|
||||
|
||||
/**
|
||||
Reset the Floppy Logic Drive, call the FddReset function
|
||||
|
||||
@param This EFI_BLOCK_IO *: A pointer to the Block I/O protocol interface
|
||||
@param ExtendedVerification BOOLEAN: Indicate that the driver may perform a more
|
||||
exhaustive verification operation of the device during
|
||||
reset, now this par is ignored in this driver
|
||||
@retval EFI_SUCCESS: The Floppy Logic Drive is reset
|
||||
@retval EFI_DEVICE_ERROR: The Floppy Logic Drive is not functioning correctly
|
||||
and can not be reset
|
||||
|
||||
**/
|
||||
EFI_STATUS
|
||||
EFIAPI
|
||||
FdcReset (
|
||||
IN EFI_BLOCK_IO_PROTOCOL *This,
|
||||
IN BOOLEAN ExtendedVerification
|
||||
)
|
||||
/*++
|
||||
|
||||
Routine Description: Reset the Floppy Logic Drive, call the FddReset function
|
||||
Parameters:
|
||||
This EFI_BLOCK_IO *: A pointer to the Block I/O protocol interface
|
||||
ExtendedVerification BOOLEAN: Indicate that the driver may perform a more
|
||||
exhaustive verification operation of the device during
|
||||
reset, now this par is ignored in this driver
|
||||
Returns:
|
||||
EFI_SUCCESS: The Floppy Logic Drive is reset
|
||||
EFI_DEVICE_ERROR: The Floppy Logic Drive is not functioning correctly
|
||||
and can not be reset
|
||||
|
||||
--*/
|
||||
// GC_TODO: function comment is missing 'Arguments:'
|
||||
// GC_TODO: This - add argument and description to function comment
|
||||
// GC_TODO: ExtendedVerification - add argument and description to function comment
|
||||
{
|
||||
FDC_BLK_IO_DEV *FdcDev;
|
||||
|
||||
@@ -63,22 +58,18 @@ FdcReset (
|
||||
return FddReset (FdcDev);
|
||||
}
|
||||
|
||||
/**
|
||||
Flush block via fdd controller
|
||||
|
||||
@param This EFI_BLOCK_IO *: A pointer to the Block I/O protocol interface
|
||||
@return EFI_SUCCESS
|
||||
|
||||
**/
|
||||
EFI_STATUS
|
||||
EFIAPI
|
||||
FddFlushBlocks (
|
||||
IN EFI_BLOCK_IO_PROTOCOL *This
|
||||
)
|
||||
/*++
|
||||
|
||||
Routine Description:
|
||||
Parameters:
|
||||
This EFI_BLOCK_IO *: A pointer to the Block I/O protocol interface
|
||||
Returns:
|
||||
EFI_SUCCESS:
|
||||
|
||||
--*/
|
||||
// GC_TODO: function comment is missing 'Arguments:'
|
||||
// GC_TODO: This - add argument and description to function comment
|
||||
{
|
||||
//
|
||||
// Not supported yet
|
||||
@@ -86,28 +77,18 @@ FddFlushBlocks (
|
||||
return EFI_SUCCESS;
|
||||
}
|
||||
|
||||
/**
|
||||
Common report status code interface
|
||||
|
||||
@param This Pointer of FDC_BLK_IO_DEV instance
|
||||
@param Read Error type: read or write?
|
||||
**/
|
||||
STATIC
|
||||
VOID
|
||||
FddReportStatus (
|
||||
IN EFI_BLOCK_IO_PROTOCOL *This,
|
||||
IN BOOLEAN Read
|
||||
)
|
||||
/*++
|
||||
|
||||
Routine Description:
|
||||
|
||||
GC_TODO: Add function description
|
||||
|
||||
Arguments:
|
||||
|
||||
This - GC_TODO: add argument description
|
||||
Read - GC_TODO: add argument description
|
||||
|
||||
Returns:
|
||||
|
||||
GC_TODO: add return values
|
||||
|
||||
--*/
|
||||
{
|
||||
FDC_BLK_IO_DEV *FdcDev;
|
||||
|
||||
@@ -120,6 +101,26 @@ Returns:
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
Read the requested number of blocks from the device
|
||||
|
||||
@param This EFI_BLOCK_IO *: A pointer to the Block I/O protocol interface
|
||||
@param MediaId UINT32: The media id that the read request is for
|
||||
@param LBA EFI_LBA: The starting logic block address to read from on the device
|
||||
@param BufferSize UINTN: The size of the Buffer in bytes
|
||||
@param Buffer VOID *: A pointer to the destination buffer for the data
|
||||
|
||||
@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_NO_MEDIA: There is no media in the device
|
||||
@retval EFI_MEDIA_CHANGED: The MediaId is not for the current media
|
||||
@retval EFI_BAD_BUFFER_SIZE: The BufferSize parameter is not a multiple of the
|
||||
intrinsic block size of the device
|
||||
@retval EFI_INVALID_PARAMETER:The read request contains LBAs that are not valid,
|
||||
or the buffer is not on proper alignment
|
||||
|
||||
**/
|
||||
EFI_STATUS
|
||||
EFIAPI
|
||||
FddReadBlocks (
|
||||
@@ -129,33 +130,6 @@ FddReadBlocks (
|
||||
IN UINTN BufferSize,
|
||||
OUT VOID *Buffer
|
||||
)
|
||||
/*++
|
||||
|
||||
Routine Description: Read the requested number of blocks from the device
|
||||
Parameters:
|
||||
This EFI_BLOCK_IO *: A pointer to the Block I/O protocol interface
|
||||
MediaId UINT32: The media id that the read request is for
|
||||
LBA EFI_LBA: The starting logic block address to read from on the device
|
||||
BufferSize UINTN: The size of the Buffer in bytes
|
||||
Buffer VOID *: A pointer to the destination buffer for the data
|
||||
Returns:
|
||||
EFI_SUCCESS: The data was read correctly from the device
|
||||
EFI_DEVICE_ERROR:The device reported an error while attempting to perform
|
||||
the read operation
|
||||
EFI_NO_MEDIA: There is no media in the device
|
||||
EFI_MEDIA_CHANGED: The MediaId is not for the current media
|
||||
EFI_BAD_BUFFER_SIZE: The BufferSize parameter is not a multiple of the
|
||||
intrinsic block size of the device
|
||||
EFI_INVALID_PARAMETER:The read request contains LBAs that are not valid,
|
||||
or the buffer is not on proper alignment
|
||||
|
||||
--*/
|
||||
// GC_TODO: function comment is missing 'Arguments:'
|
||||
// GC_TODO: This - add argument and description to function comment
|
||||
// GC_TODO: MediaId - add argument and description to function comment
|
||||
// GC_TODO: LBA - add argument and description to function comment
|
||||
// GC_TODO: BufferSize - add argument and description to function comment
|
||||
// GC_TODO: Buffer - add argument and description to function comment
|
||||
{
|
||||
EFI_STATUS Status;
|
||||
|
||||
@@ -168,6 +142,26 @@ FddReadBlocks (
|
||||
return Status;
|
||||
}
|
||||
|
||||
/**
|
||||
Write a specified number of blocks to the device
|
||||
|
||||
@param This EFI_BLOCK_IO *: A pointer to the Block I/O protocol interface
|
||||
@param MediaId UINT32: The media id that the write request is for
|
||||
@param LBA EFI_LBA: The starting logic block address to be written
|
||||
@param BufferSize UINTN: The size in bytes in Buffer
|
||||
@param Buffer VOID *: A pointer to the source buffer for the data
|
||||
|
||||
@retval EFI_SUCCESS: The data were written correctly to the device
|
||||
@retval EFI_WRITE_PROTECTED: The device can not be written to
|
||||
@retval EFI_NO_MEDIA: There is no media in the device
|
||||
@retval EFI_MEDIA_CHANGED: The MediaId is not for the current media
|
||||
@retval EFI_DEVICE_ERROR: The device reported an error while attempting to perform
|
||||
the write operation
|
||||
@retval EFI_BAD_BUFFER_SIZE: The BufferSize parameter is not a multiple of the
|
||||
intrinsic block size of the device
|
||||
@retval EFI_INVALID_PARAMETER:The write request contains LBAs that are not valid,
|
||||
or the buffer is not on proper alignment
|
||||
**/
|
||||
EFI_STATUS
|
||||
EFIAPI
|
||||
FddWriteBlocks (
|
||||
@@ -177,35 +171,6 @@ FddWriteBlocks (
|
||||
IN UINTN BufferSize,
|
||||
IN VOID *Buffer
|
||||
)
|
||||
/*++
|
||||
|
||||
Routine Description: Write a specified number of blocks to the device
|
||||
Parameters:
|
||||
This EFI_BLOCK_IO *: A pointer to the Block I/O protocol interface
|
||||
MediaId UINT32: The media id that the write request is for
|
||||
LBA EFI_LBA: The starting logic block address to be written
|
||||
BufferSize UINTN: The size in bytes in Buffer
|
||||
Buffer VOID *: A pointer to the source buffer for the data
|
||||
Returns :
|
||||
EFI_SUCCESS: The data were written correctly to the device
|
||||
EFI_WRITE_PROTECTED: The device can not be written to
|
||||
EFI_NO_MEDIA: There is no media in the device
|
||||
EFI_MEDIA_CHANGED: The MediaId is not for the current media
|
||||
EFI_DEVICE_ERROR: The device reported an error while attempting to perform
|
||||
the write operation
|
||||
EFI_BAD_BUFFER_SIZE: The BufferSize parameter is not a multiple of the
|
||||
intrinsic block size of the device
|
||||
EFI_INVALID_PARAMETER:The write request contains LBAs that are not valid,
|
||||
or the buffer is not on proper alignment
|
||||
|
||||
--*/
|
||||
// GC_TODO: function comment is missing 'Arguments:'
|
||||
// GC_TODO: function comment is missing 'Returns:'
|
||||
// GC_TODO: This - add argument and description to function comment
|
||||
// GC_TODO: MediaId - add argument and description to function comment
|
||||
// GC_TODO: LBA - add argument and description to function comment
|
||||
// GC_TODO: BufferSize - add argument and description to function comment
|
||||
// GC_TODO: Buffer - add argument and description to function comment
|
||||
{
|
||||
EFI_STATUS Status;
|
||||
|
||||
@@ -218,6 +183,32 @@ FddWriteBlocks (
|
||||
return Status;
|
||||
}
|
||||
|
||||
/**
|
||||
Read or Write a number of blocks to floppy device
|
||||
|
||||
@param This Pointer to instance of EFI_BLOCK_IO_PROTOCOL
|
||||
@param MediaId The media id of read/write request
|
||||
@param LBA The starting logic block address to read from on the device
|
||||
@param BufferSize The size of the Buffer in bytes
|
||||
@param Operation - GC_TODO: add argument description
|
||||
Buffer - GC_TODO: add argument description
|
||||
|
||||
@retval EFI_INVALID_PARAMETER - GC_TODO: Add description for return value
|
||||
@retval EFI_SUCCESS - GC_TODO: Add description for return value
|
||||
@retval EFI_DEVICE_ERROR - GC_TODO: Add description for return value
|
||||
@retval EFI_DEVICE_ERROR - GC_TODO: Add description for return value
|
||||
@retval EFI_NO_MEDIA - GC_TODO: Add description for return value
|
||||
@retval EFI_MEDIA_CHANGED - GC_TODO: Add description for return value
|
||||
@retval EFI_WRITE_PROTECTED - GC_TODO: Add description for return value
|
||||
@retval EFI_BAD_BUFFER_SIZE - GC_TODO: Add description for return value
|
||||
@retval EFI_INVALID_PARAMETER - GC_TODO: Add description for return value
|
||||
@retval EFI_INVALID_PARAMETER - GC_TODO: Add description for return value
|
||||
@retval EFI_SUCCESS - GC_TODO: Add description for return value
|
||||
@retval EFI_DEVICE_ERROR - GC_TODO: Add description for return value
|
||||
@retval EFI_DEVICE_ERROR - GC_TODO: Add description for return value
|
||||
@retval EFI_SUCCESS - GC_TODO: Add description for return value
|
||||
|
||||
**/
|
||||
EFI_STATUS
|
||||
FddReadWriteBlocks (
|
||||
IN EFI_BLOCK_IO_PROTOCOL *This,
|
||||
@@ -227,39 +218,6 @@ FddReadWriteBlocks (
|
||||
IN BOOLEAN Operation,
|
||||
OUT VOID *Buffer
|
||||
)
|
||||
/*++
|
||||
|
||||
Routine Description:
|
||||
|
||||
GC_TODO: Add function description
|
||||
|
||||
Arguments:
|
||||
|
||||
This - GC_TODO: add argument description
|
||||
MediaId - GC_TODO: add argument description
|
||||
LBA - GC_TODO: add argument description
|
||||
BufferSize - GC_TODO: add argument description
|
||||
Operation - GC_TODO: add argument description
|
||||
Buffer - GC_TODO: add argument description
|
||||
|
||||
Returns:
|
||||
|
||||
EFI_INVALID_PARAMETER - GC_TODO: Add description for return value
|
||||
EFI_SUCCESS - GC_TODO: Add description for return value
|
||||
EFI_DEVICE_ERROR - GC_TODO: Add description for return value
|
||||
EFI_DEVICE_ERROR - GC_TODO: Add description for return value
|
||||
EFI_NO_MEDIA - GC_TODO: Add description for return value
|
||||
EFI_MEDIA_CHANGED - GC_TODO: Add description for return value
|
||||
EFI_WRITE_PROTECTED - GC_TODO: Add description for return value
|
||||
EFI_BAD_BUFFER_SIZE - GC_TODO: Add description for return value
|
||||
EFI_INVALID_PARAMETER - GC_TODO: Add description for return value
|
||||
EFI_INVALID_PARAMETER - GC_TODO: Add description for return value
|
||||
EFI_SUCCESS - GC_TODO: Add description for return value
|
||||
EFI_DEVICE_ERROR - GC_TODO: Add description for return value
|
||||
EFI_DEVICE_ERROR - GC_TODO: Add description for return value
|
||||
EFI_SUCCESS - GC_TODO: Add description for return value
|
||||
|
||||
--*/
|
||||
{
|
||||
EFI_BLOCK_IO_MEDIA *Media;
|
||||
FDC_BLK_IO_DEV *FdcDev;
|
||||
@@ -423,25 +381,16 @@ Returns:
|
||||
|
||||
}
|
||||
|
||||
/**
|
||||
Common interface for free cache
|
||||
|
||||
@param FdcDec Pointer of FDC_BLK_IO_DEV instance
|
||||
|
||||
**/
|
||||
VOID
|
||||
FdcFreeCache (
|
||||
IN FDC_BLK_IO_DEV *FdcDev
|
||||
)
|
||||
/*++
|
||||
|
||||
Routine Description:
|
||||
|
||||
GC_TODO: Add function description
|
||||
|
||||
Arguments:
|
||||
|
||||
FdcDev - GC_TODO: add argument description
|
||||
|
||||
Returns:
|
||||
|
||||
GC_TODO: add return values
|
||||
|
||||
--*/
|
||||
{
|
||||
if (FdcDev->Cache) {
|
||||
gBS->FreePool (FdcDev->Cache);
|
||||
|
||||
@@ -22,22 +22,19 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
|
||||
|
||||
#include "IsaFloppy.h"
|
||||
|
||||
/**
|
||||
|
||||
Detect the floppy drive is presented or not
|
||||
|
||||
@param FdcDev FDC_BLK_IO_DEV * : A pointer to the Data Structure FDC_BLK_IO_DEV
|
||||
@retval EFI_SUCCESS Drive is presented
|
||||
@retval EFI_NOT_FOUND Drive is not presented
|
||||
|
||||
**/
|
||||
EFI_STATUS
|
||||
DiscoverFddDevice (
|
||||
IN FDC_BLK_IO_DEV *FdcDev
|
||||
)
|
||||
/*++
|
||||
|
||||
Routine Description: Detect the floppy drive is presented or not
|
||||
Parameters:
|
||||
FdcDev FDC_BLK_IO_DEV * : A pointer to the Data Structure FDC_BLK_IO_DEV
|
||||
Returns:
|
||||
EFI_SUCCESS Drive is presented
|
||||
EFI_NOT_FOUND Drive is not presented
|
||||
|
||||
--*/
|
||||
// GC_TODO: function comment is missing 'Arguments:'
|
||||
// GC_TODO: FdcDev - add argument and description to function comment
|
||||
{
|
||||
EFI_STATUS Status;
|
||||
|
||||
@@ -61,23 +58,19 @@ DiscoverFddDevice (
|
||||
return EFI_SUCCESS;
|
||||
}
|
||||
|
||||
/**
|
||||
|
||||
Do recalibrate and see the drive is presented or not
|
||||
Set the media parameters
|
||||
|
||||
@param FdcDev FDC_BLK_IO_DEV * : A pointer to the Data Structure FDC_BLK_IO_DEV
|
||||
@return the drive is presented or not
|
||||
|
||||
**/
|
||||
EFI_STATUS
|
||||
FddIdentify (
|
||||
IN FDC_BLK_IO_DEV *FdcDev
|
||||
)
|
||||
/*++
|
||||
|
||||
Routine Description: Do recalibrate and see the drive is presented or not
|
||||
Set the media parameters
|
||||
Parameters:
|
||||
FdcDev FDC_BLK_IO_DEV * : A pointer to the Data Structure FDC_BLK_IO_DEV
|
||||
Returns:
|
||||
EFI_SUCCESS:
|
||||
EFI_DEVICE_ERROR:
|
||||
|
||||
--*/
|
||||
// GC_TODO: function comment is missing 'Arguments:'
|
||||
// GC_TODO: FdcDev - add argument and description to function comment
|
||||
{
|
||||
EFI_STATUS Status;
|
||||
|
||||
@@ -143,23 +136,21 @@ FddIdentify (
|
||||
return EFI_SUCCESS;
|
||||
}
|
||||
|
||||
/**
|
||||
|
||||
Reset the Floppy Logic Drive
|
||||
|
||||
@param FdcDev FDC_BLK_IO_DEV * : A pointer to the Data Structure FDC_BLK_IO_DEV
|
||||
|
||||
@retval EFI_SUCCESS: The Floppy Logic Drive is reset
|
||||
@retval EFI_DEVICE_ERROR: The Floppy Logic Drive is not functioning correctly and
|
||||
can not be reset
|
||||
|
||||
**/
|
||||
EFI_STATUS
|
||||
FddReset (
|
||||
IN FDC_BLK_IO_DEV *FdcDev
|
||||
)
|
||||
/*++
|
||||
|
||||
Routine Description: Reset the Floppy Logic Drive
|
||||
Parameters:
|
||||
FdcDev FDC_BLK_IO_DEV * : A pointer to the Data Structure FDC_BLK_IO_DEV
|
||||
Returns:
|
||||
EFI_SUCCESS: The Floppy Logic Drive is reset
|
||||
EFI_DEVICE_ERROR: The Floppy Logic Drive is not functioning correctly and
|
||||
can not be reset
|
||||
|
||||
--*/
|
||||
// GC_TODO: function comment is missing 'Arguments:'
|
||||
// GC_TODO: FdcDev - add argument and description to function comment
|
||||
{
|
||||
UINT8 data;
|
||||
UINT8 StatusRegister0;
|
||||
@@ -244,24 +235,22 @@ FddReset (
|
||||
return EFI_SUCCESS;
|
||||
}
|
||||
|
||||
/**
|
||||
|
||||
Turn the drive's motor on
|
||||
The drive's motor must be on before any command can be executed
|
||||
|
||||
@param FdcDev FDC_BLK_IO_DEV * : A pointer to the Data Structure FDC_BLK_IO_DEV
|
||||
|
||||
@retval EFI_SUCCESS: Turn the drive's motor on successfully
|
||||
@retval EFI_DEVICE_ERROR: The drive is busy, so can not turn motor on
|
||||
@retval EFI_INVALID_PARAMETER: Fail to Set timer(Cancel timer)
|
||||
|
||||
**/
|
||||
EFI_STATUS
|
||||
MotorOn (
|
||||
IN FDC_BLK_IO_DEV *FdcDev
|
||||
)
|
||||
/*++
|
||||
|
||||
Routine Description: Turn the drive's motor on
|
||||
The drive's motor must be on before any command can be executed
|
||||
Parameters:
|
||||
FdcDev FDC_BLK_IO_DEV * : A pointer to the Data Structure FDC_BLK_IO_DEV
|
||||
Returns:
|
||||
EFI_SUCCESS: Turn the drive's motor on successfully
|
||||
EFI_DEVICE_ERROR: The drive is busy, so can not turn motor on
|
||||
EFI_INVALID_PARAMETER: Fail to Set timer(Cancel timer)
|
||||
|
||||
--*/
|
||||
// GC_TODO: function comment is missing 'Arguments:'
|
||||
// GC_TODO: FdcDev - add argument and description to function comment
|
||||
{
|
||||
EFI_STATUS Status;
|
||||
UINT8 data;
|
||||
@@ -328,22 +317,21 @@ MotorOn (
|
||||
return EFI_SUCCESS;
|
||||
}
|
||||
|
||||
/**
|
||||
|
||||
Set a Timer and when Timer goes off, turn the motor off
|
||||
|
||||
|
||||
@param FdcDev FDC_BLK_IO_DEV * : A pointer to the Data Structure FDC_BLK_IO_DEV
|
||||
|
||||
@retval EFI_SUCCESS: Set the Timer successfully
|
||||
@retval EFI_INVALID_PARAMETER: Fail to Set the timer
|
||||
|
||||
**/
|
||||
EFI_STATUS
|
||||
MotorOff (
|
||||
IN FDC_BLK_IO_DEV *FdcDev
|
||||
)
|
||||
/*++
|
||||
|
||||
Routine Description: Set a Timer and when Timer goes off, turn the motor off
|
||||
Parameters:
|
||||
FdcDev FDC_BLK_IO_DEV * : A pointer to the Data Structure FDC_BLK_IO_DEV
|
||||
Returns:
|
||||
EFI_SUCCESS: Set the Timer successfully
|
||||
EFI_INVALID_PARAMETER: Fail to Set the timer
|
||||
|
||||
--*/
|
||||
// GC_TODO: function comment is missing 'Arguments:'
|
||||
// GC_TODO: FdcDev - add argument and description to function comment
|
||||
{
|
||||
//
|
||||
// Set the timer : 2s
|
||||
@@ -351,24 +339,21 @@ MotorOff (
|
||||
return gBS->SetTimer (FdcDev->Event, TimerRelative, 20000000);
|
||||
}
|
||||
|
||||
/**
|
||||
Detect the disk in the drive is changed or not
|
||||
|
||||
|
||||
@param FdcDev FDC_BLK_IO_DEV *: A pointer to Data Structure FDC_BLK_IO_DEV
|
||||
|
||||
@retval EFI_SUCCESS: No disk media change
|
||||
@retval EFI_DEVICE_ERROR: Fail to do the recalibrate or seek operation
|
||||
@retval EFI_NO_MEDIA: No disk in the drive
|
||||
@retval EFI_MEDIA_CHANGED: There is a new disk in the drive
|
||||
**/
|
||||
EFI_STATUS
|
||||
DisketChanged (
|
||||
IN FDC_BLK_IO_DEV *FdcDev
|
||||
)
|
||||
/*++
|
||||
|
||||
Routine Description: Detect the disk in the drive is changed or not
|
||||
Parameters:
|
||||
FdcDev FDC_BLK_IO_DEV *: A pointer to Data Structure FDC_BLK_IO_DEV
|
||||
Returns:
|
||||
EFI_SUCCESS: No disk media change
|
||||
EFI_DEVICE_ERROR: Fail to do the recalibrate or seek operation
|
||||
EFI_NO_MEDIA: No disk in the drive
|
||||
EFI_MEDIA_CHANGED: There is a new disk in the drive
|
||||
|
||||
--*/
|
||||
// GC_TODO: function comment is missing 'Arguments:'
|
||||
// GC_TODO: FdcDev - add argument and description to function comment
|
||||
{
|
||||
EFI_STATUS Status;
|
||||
UINT8 data;
|
||||
@@ -418,24 +403,21 @@ DisketChanged (
|
||||
return EFI_SUCCESS;
|
||||
}
|
||||
|
||||
/**
|
||||
Do the Specify command, this command sets DMA operation
|
||||
and the initial values for each of the three internal
|
||||
times: HUT, SRT and HLT
|
||||
|
||||
@param This Pointer to instance of FDC_BLK_IO_DEV
|
||||
|
||||
@retval EFI_SUCCESS: Execute the Specify command successfully
|
||||
@retval EFI_DEVICE_ERROR: Fail to execute the command
|
||||
|
||||
**/
|
||||
EFI_STATUS
|
||||
Specify (
|
||||
IN FDC_BLK_IO_DEV *FdcDev
|
||||
)
|
||||
/*++
|
||||
|
||||
Routine Description: Do the Specify command, this command sets DMA operation
|
||||
and the initial values for each of the three internal
|
||||
times: HUT, SRT and HLT
|
||||
Parameters:
|
||||
None
|
||||
Returns:
|
||||
EFI_SUCCESS: Execute the Specify command successfully
|
||||
EFI_DEVICE_ERROR: Fail to execute the command
|
||||
|
||||
--*/
|
||||
// GC_TODO: function comment is missing 'Arguments:'
|
||||
// GC_TODO: FdcDev - add argument and description to function comment
|
||||
{
|
||||
FDD_SPECIFY_CMD Command;
|
||||
UINTN Index;
|
||||
@@ -464,22 +446,18 @@ Specify (
|
||||
return EFI_SUCCESS;
|
||||
}
|
||||
|
||||
/**
|
||||
Set the head of floppy drive to track 0
|
||||
|
||||
@param FdcDev FDC_BLK_IO_DEV *: A pointer to Data Structure FDC_BLK_IO_DEV
|
||||
@retval EFI_SUCCESS: Execute the Recalibrate operation successfully
|
||||
@retval EFI_DEVICE_ERROR: Fail to execute the Recalibrate operation
|
||||
|
||||
**/
|
||||
EFI_STATUS
|
||||
Recalibrate (
|
||||
IN FDC_BLK_IO_DEV *FdcDev
|
||||
)
|
||||
/*++
|
||||
|
||||
Routine Description: Set the head of floppy drive to track 0
|
||||
Parameters:
|
||||
FdcDev FDC_BLK_IO_DEV *: A pointer to Data Structure FDC_BLK_IO_DEV
|
||||
Returns:
|
||||
EFI_SUCCESS: Execute the Recalibrate operation successfully
|
||||
EFI_DEVICE_ERROR: Fail to execute the Recalibrate operation
|
||||
|
||||
--*/
|
||||
// GC_TODO: function comment is missing 'Arguments:'
|
||||
// GC_TODO: FdcDev - add argument and description to function comment
|
||||
{
|
||||
FDD_COMMAND_PACKET2 Command;
|
||||
UINTN Index;
|
||||
@@ -542,25 +520,21 @@ Recalibrate (
|
||||
return EFI_SUCCESS;
|
||||
}
|
||||
|
||||
/**
|
||||
Set the head of floppy drive to the new cylinder
|
||||
|
||||
@param FdcDev FDC_BLK_IO_DEV *: A pointer to Data Structure FDC_BLK_IO_DEV
|
||||
@param Lba EFI_LBA : The logic block address want to seek
|
||||
|
||||
@retval EFI_SUCCESS: Execute the Seek operation successfully
|
||||
@retval EFI_DEVICE_ERROR: Fail to execute the Seek operation
|
||||
|
||||
**/
|
||||
EFI_STATUS
|
||||
Seek (
|
||||
IN FDC_BLK_IO_DEV *FdcDev,
|
||||
IN EFI_LBA Lba
|
||||
)
|
||||
/*++
|
||||
|
||||
Routine Description: Set the head of floppy drive to the new cylinder
|
||||
Parameters:
|
||||
FdcDev FDC_BLK_IO_DEV *: A pointer to Data Structure FDC_BLK_IO_DEV
|
||||
Lba EFI_LBA : The logic block address want to seek
|
||||
Returns:
|
||||
EFI_SUCCESS: Execute the Seek operation successfully
|
||||
EFI_DEVICE_ERROR: Fail to execute the Seek operation
|
||||
|
||||
--*/
|
||||
// GC_TODO: function comment is missing 'Arguments:'
|
||||
// GC_TODO: FdcDev - add argument and description to function comment
|
||||
// GC_TODO: Lba - add argument and description to function comment
|
||||
{
|
||||
FDD_SEEK_CMD Command;
|
||||
UINT8 EndOfTrack;
|
||||
@@ -649,29 +623,25 @@ Seek (
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
Do the Sense Interrupt Status command, this command
|
||||
resets the interrupt signal
|
||||
|
||||
|
||||
@param StatusRegister0 UINT8 *: Be used to save Status Register 0 read from FDC
|
||||
@param PresentCylinderNumber UINT8 *: Be used to save present cylinder number
|
||||
read from FDC
|
||||
|
||||
@retval EFI_SUCCESS: Execute the Sense Interrupt Status command successfully
|
||||
@retval EFI_DEVICE_ERROR: Fail to execute the command
|
||||
|
||||
**/
|
||||
EFI_STATUS
|
||||
SenseIntStatus (
|
||||
IN FDC_BLK_IO_DEV *FdcDev,
|
||||
IN OUT UINT8 *StatusRegister0,
|
||||
IN OUT UINT8 *PresentCylinderNumber
|
||||
)
|
||||
/*++
|
||||
|
||||
Routine Description: Do the Sense Interrupt Status command, this command
|
||||
resets the interrupt signal
|
||||
Parameters:
|
||||
StatusRegister0 UINT8 *: Be used to save Status Register 0 read from FDC
|
||||
PresentCylinderNumber UINT8 *: Be used to save present cylinder number
|
||||
read from FDC
|
||||
Returns:
|
||||
EFI_SUCCESS: Execute the Sense Interrupt Status command successfully
|
||||
EFI_DEVICE_ERROR: Fail to execute the command
|
||||
|
||||
--*/
|
||||
// GC_TODO: function comment is missing 'Arguments:'
|
||||
// GC_TODO: FdcDev - add argument and description to function comment
|
||||
// GC_TODO: StatusRegister0 - add argument and description to function comment
|
||||
// GC_TODO: PresentCylinderNumber - add argument and description to function comment
|
||||
{
|
||||
UINT8 command;
|
||||
|
||||
@@ -691,26 +661,22 @@ SenseIntStatus (
|
||||
return EFI_SUCCESS;
|
||||
}
|
||||
|
||||
/**
|
||||
Do the Sense Drive Status command
|
||||
|
||||
@param FdcDev FDC_BLK_IO_DEV *: A pointer to Data Structure FDC_BLK_IO_DEV
|
||||
@param Lba EFI_LBA : Logic block address
|
||||
|
||||
@retval EFI_SUCCESS: Execute the Sense Drive Status command successfully
|
||||
@retval EFI_DEVICE_ERROR: Fail to execute the command
|
||||
@retval EFI_WRITE_PROTECTED:The disk is write protected
|
||||
|
||||
**/
|
||||
EFI_STATUS
|
||||
SenseDrvStatus (
|
||||
IN FDC_BLK_IO_DEV *FdcDev,
|
||||
IN EFI_LBA Lba
|
||||
)
|
||||
/*++
|
||||
|
||||
Routine Description: Do the Sense Drive Status command
|
||||
Parameters:
|
||||
FdcDev FDC_BLK_IO_DEV *: A pointer to Data Structure FDC_BLK_IO_DEV
|
||||
Lba EFI_LBA : Logic block address
|
||||
Returns:
|
||||
EFI_SUCCESS: Execute the Sense Drive Status command successfully
|
||||
EFI_DEVICE_ERROR: Fail to execute the command
|
||||
EFI_WRITE_PROTECTED:The disk is write protected
|
||||
|
||||
--*/
|
||||
// GC_TODO: function comment is missing 'Arguments:'
|
||||
// GC_TODO: FdcDev - add argument and description to function comment
|
||||
// GC_TODO: Lba - add argument and description to function comment
|
||||
{
|
||||
FDD_COMMAND_PACKET2 Command;
|
||||
UINT8 Head;
|
||||
@@ -758,23 +724,20 @@ SenseDrvStatus (
|
||||
return CheckStatus3 (StatusRegister3);
|
||||
}
|
||||
|
||||
/**
|
||||
Update the disk media properties and if necessary
|
||||
reinstall Block I/O interface
|
||||
|
||||
@param FdcDev FDC_BLK_IO_DEV *: A pointer to Data Structure FDC_BLK_IO_DEV
|
||||
|
||||
@retval EFI_SUCCESS: Do the operation successfully
|
||||
@retval EFI_DEVICE_ERROR: Fail to the operation
|
||||
|
||||
**/
|
||||
EFI_STATUS
|
||||
DetectMedia (
|
||||
IN FDC_BLK_IO_DEV *FdcDev
|
||||
)
|
||||
/*++
|
||||
|
||||
Routine Description: Update the disk media properties and if necessary
|
||||
reinstall Block I/O interface
|
||||
Parameters:
|
||||
FdcDev FDC_BLK_IO_DEV *: A pointer to Data Structure FDC_BLK_IO_DEV
|
||||
Returns:
|
||||
EFI_SUCCESS: Do the operation successfully
|
||||
EFI_DEVICE_ERROR: Fail to the operation
|
||||
|
||||
--*/
|
||||
// GC_TODO: function comment is missing 'Arguments:'
|
||||
// GC_TODO: FdcDev - add argument and description to function comment
|
||||
{
|
||||
EFI_STATUS Status;
|
||||
BOOLEAN bReset;
|
||||
@@ -840,22 +803,17 @@ DetectMedia (
|
||||
return EFI_SUCCESS;
|
||||
}
|
||||
|
||||
/**
|
||||
Set the data rate and so on
|
||||
|
||||
@param FdcDev FDC_BLK_IO_DEV *: A pointer to Data Structure FDC_BLK_IO_DEV
|
||||
|
||||
@retval EFI_SUCCESS success to set the data rate
|
||||
**/
|
||||
EFI_STATUS
|
||||
Setup (
|
||||
IN FDC_BLK_IO_DEV *FdcDev
|
||||
)
|
||||
/*++
|
||||
|
||||
Routine Description: Set the data rate and so on
|
||||
Parameters:
|
||||
None
|
||||
Returns:
|
||||
EFI_SUCCESS:
|
||||
|
||||
--*/
|
||||
// GC_TODO: function comment is missing 'Arguments:'
|
||||
// GC_TODO: FdcDev - add argument and description to function comment
|
||||
// GC_TODO: EFI_DEVICE_ERROR - add return value to function comment
|
||||
{
|
||||
EFI_STATUS Status;
|
||||
|
||||
@@ -878,6 +836,18 @@ Setup (
|
||||
return EFI_SUCCESS;
|
||||
}
|
||||
|
||||
/**
|
||||
Read or Write a number of blocks in the same cylinder
|
||||
|
||||
@param FdcDev A pointer to Data Structure FDC_BLK_IO_DEV
|
||||
@param HostAddress device address
|
||||
@param Lba The starting logic block address to read from on the device
|
||||
@param NumberOfBlocks The number of block wanted to be read or write
|
||||
@param Read Operation type: read or write
|
||||
|
||||
@retval EFI_SUCCESS Success operate
|
||||
|
||||
**/
|
||||
EFI_STATUS
|
||||
ReadWriteDataSector (
|
||||
IN FDC_BLK_IO_DEV *FdcDev,
|
||||
@@ -886,30 +856,6 @@ ReadWriteDataSector (
|
||||
IN UINTN NumberOfBlocks,
|
||||
IN BOOLEAN Read
|
||||
)
|
||||
/*++
|
||||
|
||||
Routine Description: Read or Write a number of blocks in the same cylinder
|
||||
Parameters:
|
||||
FdcDev FDC_BLK_IO_DEV * : A pointer to Data Structure FDC_BLK_IO_DEV
|
||||
Buffer VOID *:
|
||||
Lba EFI_LBA:
|
||||
NumberOfBlocks UINTN:
|
||||
Read BOOLEAN:
|
||||
Returns:
|
||||
EFI_SUCCESS:
|
||||
|
||||
--*/
|
||||
// GC_TODO: function comment is missing 'Arguments:'
|
||||
// GC_TODO: FdcDev - add argument and description to function comment
|
||||
// GC_TODO: HostAddress - add argument and description to function comment
|
||||
// GC_TODO: Lba - add argument and description to function comment
|
||||
// GC_TODO: NumberOfBlocks - add argument and description to function comment
|
||||
// GC_TODO: Read - add argument and description to function comment
|
||||
// GC_TODO: EFI_DEVICE_ERROR - add return value to function comment
|
||||
// GC_TODO: EFI_DEVICE_ERROR - add return value to function comment
|
||||
// GC_TODO: EFI_DEVICE_ERROR - add return value to function comment
|
||||
// GC_TODO: EFI_TIMEOUT - add return value to function comment
|
||||
// GC_TODO: EFI_DEVICE_ERROR - add return value to function comment
|
||||
{
|
||||
EFI_STATUS Status;
|
||||
FDD_COMMAND_PACKET1 Command;
|
||||
@@ -1040,23 +986,20 @@ ReadWriteDataSector (
|
||||
return CheckResult (&Result, FdcDev);
|
||||
}
|
||||
|
||||
/**
|
||||
Fill in FDD command's parameter
|
||||
|
||||
@param FdcDev Pointer to instance of FDC_BLK_IO_DEV
|
||||
@param Lba The starting logic block address to read from on the device
|
||||
@param Command FDD command
|
||||
|
||||
**/
|
||||
VOID
|
||||
FillPara (
|
||||
IN FDC_BLK_IO_DEV *FdcDev,
|
||||
IN EFI_LBA Lba,
|
||||
IN FDD_COMMAND_PACKET1 *Command
|
||||
)
|
||||
/*++
|
||||
|
||||
Routine Description: Fill in Parameter
|
||||
Parameters:
|
||||
Returns:
|
||||
|
||||
--*/
|
||||
// GC_TODO: function comment is missing 'Arguments:'
|
||||
// GC_TODO: FdcDev - add argument and description to function comment
|
||||
// GC_TODO: Lba - add argument and description to function comment
|
||||
// GC_TODO: Command - add argument and description to function comment
|
||||
{
|
||||
UINT8 EndOfTrack;
|
||||
|
||||
@@ -1084,24 +1027,22 @@ FillPara (
|
||||
Command->DataLength = DISK_1440K_DTL;
|
||||
}
|
||||
|
||||
/**
|
||||
Read result byte from Data Register of FDC
|
||||
|
||||
@param FdcDev Pointer to instance of FDC_BLK_IO_DEV
|
||||
@param Pointer UINT8 *: Be used to save result byte read from FDC
|
||||
|
||||
|
||||
@retval EFI_SUCCESS: Read result byte from FDC successfully
|
||||
@retval EFI_DEVICE_ERROR: The FDC is not ready to be read
|
||||
|
||||
**/
|
||||
EFI_STATUS
|
||||
DataInByte (
|
||||
IN FDC_BLK_IO_DEV *FdcDev,
|
||||
IN OUT UINT8 *Pointer
|
||||
)
|
||||
/*++
|
||||
|
||||
Routine Description: Read result byte from Data Register of FDC
|
||||
Parameters:
|
||||
Pointer UINT8 *: Be used to save result byte read from FDC
|
||||
Returns:
|
||||
EFI_SUCCESS: Read result byte from FDC successfully
|
||||
EFI_DEVICE_ERROR: The FDC is not ready to be read
|
||||
|
||||
--*/
|
||||
// GC_TODO: function comment is missing 'Arguments:'
|
||||
// GC_TODO: FdcDev - add argument and description to function comment
|
||||
// GC_TODO: Pointer - add argument and description to function comment
|
||||
{
|
||||
UINT8 data;
|
||||
|
||||
@@ -1126,24 +1067,21 @@ DataInByte (
|
||||
return EFI_SUCCESS;
|
||||
}
|
||||
|
||||
/**
|
||||
Write command byte to Data Register of FDC
|
||||
|
||||
@param FdcDev Pointer to instance of FDC_BLK_IO_DEV
|
||||
@param Pointer Be used to save command byte written to FDC
|
||||
|
||||
@retval EFI_SUCCESS: Write command byte to FDC successfully
|
||||
@retval EFI_DEVICE_ERROR: The FDC is not ready to be written
|
||||
|
||||
**/
|
||||
EFI_STATUS
|
||||
DataOutByte (
|
||||
IN FDC_BLK_IO_DEV *FdcDev,
|
||||
IN UINT8 *Pointer
|
||||
)
|
||||
/*++
|
||||
|
||||
Routine Description: Write command byte to Data Register of FDC
|
||||
Parameters:
|
||||
Pointer UINT8 *: Be used to save command byte written to FDC
|
||||
Returns:
|
||||
EFI_SUCCESS: Write command byte to FDC successfully
|
||||
EFI_DEVICE_ERROR: The FDC is not ready to be written
|
||||
|
||||
--*/
|
||||
// GC_TODO: function comment is missing 'Arguments:'
|
||||
// GC_TODO: FdcDev - add argument and description to function comment
|
||||
// GC_TODO: Pointer - add argument and description to function comment
|
||||
{
|
||||
UINT8 data;
|
||||
|
||||
@@ -1169,27 +1107,23 @@ DataOutByte (
|
||||
return EFI_SUCCESS;
|
||||
}
|
||||
|
||||
/**
|
||||
Detect the specified floppy logic drive is busy or
|
||||
not within a period of time
|
||||
|
||||
@param Disk Indicate it is drive A or drive B
|
||||
@param TimeoutInSeconds the time period for waiting
|
||||
|
||||
@retval EFI_SUCCESS: The drive and command are not busy
|
||||
@retval EFI_TIMEOUT: The drive or command is still busy after a period time that
|
||||
set by TimeoutInSeconds
|
||||
|
||||
**/
|
||||
EFI_STATUS
|
||||
FddWaitForBSYClear (
|
||||
IN FDC_BLK_IO_DEV *FdcDev,
|
||||
IN UINTN TimeoutInSeconds
|
||||
)
|
||||
/*++
|
||||
|
||||
Routine Description: Detect the specified floppy logic drive is busy or
|
||||
not within a period of time
|
||||
Parameters:
|
||||
Disk EFI_FDC_DISK: Indicate it is drive A or drive B
|
||||
TimeoutInSeconds UINTN: the time period for waiting
|
||||
Returns:
|
||||
EFI_SUCCESS: The drive and command are not busy
|
||||
EFI_TIMEOUT: The drive or command is still busy after a period time that
|
||||
set by TimeoutInSeconds
|
||||
|
||||
--*/
|
||||
// GC_TODO: function comment is missing 'Arguments:'
|
||||
// GC_TODO: FdcDev - add argument and description to function comment
|
||||
// GC_TODO: TimeoutInSeconds - add argument and description to function comment
|
||||
{
|
||||
UINTN Delay;
|
||||
UINT8 StatusRegister;
|
||||
@@ -1228,27 +1162,24 @@ FddWaitForBSYClear (
|
||||
return EFI_SUCCESS;
|
||||
}
|
||||
|
||||
/**
|
||||
|
||||
Routine Description: Determine whether FDC is ready to write or read
|
||||
|
||||
@param FdcDev Pointer to instance of FDC_BLK_IO_DEV
|
||||
@param Dio BOOLEAN: Indicate the FDC is waiting to write or read
|
||||
@param TimeoutInSeconds UINTN: The time period for waiting
|
||||
|
||||
@retval EFI_SUCCESS: FDC is ready to write or read
|
||||
@retval EFI_NOT_READY: FDC is not ready within the specified time period
|
||||
|
||||
**/
|
||||
EFI_STATUS
|
||||
FddDRQReady (
|
||||
IN FDC_BLK_IO_DEV *FdcDev,
|
||||
IN BOOLEAN Dio,
|
||||
IN UINTN TimeoutInSeconds
|
||||
)
|
||||
/*++
|
||||
|
||||
Routine Description: Determine whether FDC is ready to write or read
|
||||
Parameters:
|
||||
Dio BOOLEAN: Indicate the FDC is waiting to write or read
|
||||
TimeoutInSeconds UINTN: The time period for waiting
|
||||
Returns:
|
||||
EFI_SUCCESS: FDC is ready to write or read
|
||||
EFI_NOT_READY: FDC is not ready within the specified time period
|
||||
|
||||
--*/
|
||||
// GC_TODO: function comment is missing 'Arguments:'
|
||||
// GC_TODO: FdcDev - add argument and description to function comment
|
||||
// GC_TODO: Dio - add argument and description to function comment
|
||||
// GC_TODO: TimeoutInSeconds - add argument and description to function comment
|
||||
{
|
||||
UINTN Delay;
|
||||
UINT8 StatusRegister;
|
||||
@@ -1294,30 +1225,24 @@ FddDRQReady (
|
||||
return EFI_SUCCESS;
|
||||
}
|
||||
|
||||
/**
|
||||
Set FDC control structure's attribute according to
|
||||
result
|
||||
|
||||
@param Result Point to result structure
|
||||
@param FdcDev FDC control structure
|
||||
|
||||
@param EFI_DEVICE_ERROR - GC_TODO: Add description for return value
|
||||
@param EFI_DEVICE_ERROR - GC_TODO: Add description for return value
|
||||
@param EFI_DEVICE_ERROR - GC_TODO: Add description for return value
|
||||
@param EFI_SUCCESS - GC_TODO: Add description for return value
|
||||
|
||||
**/
|
||||
EFI_STATUS
|
||||
CheckResult (
|
||||
IN FDD_RESULT_PACKET *Result,
|
||||
IN OUT FDC_BLK_IO_DEV *FdcDev
|
||||
)
|
||||
/*++
|
||||
|
||||
Routine Description:
|
||||
|
||||
GC_TODO: Add function description
|
||||
|
||||
Arguments:
|
||||
|
||||
Result - GC_TODO: add argument description
|
||||
FdcDev - GC_TODO: add argument description
|
||||
|
||||
Returns:
|
||||
|
||||
EFI_DEVICE_ERROR - GC_TODO: Add description for return value
|
||||
EFI_DEVICE_ERROR - GC_TODO: Add description for return value
|
||||
EFI_DEVICE_ERROR - GC_TODO: Add description for return value
|
||||
EFI_SUCCESS - GC_TODO: Add description for return value
|
||||
|
||||
--*/
|
||||
{
|
||||
//
|
||||
// Check Status Register0
|
||||
@@ -1351,22 +1276,19 @@ Returns:
|
||||
return EFI_SUCCESS;
|
||||
}
|
||||
|
||||
/**
|
||||
Check the drive status information
|
||||
|
||||
@param StatusRegister3 the value of Status Register 3
|
||||
|
||||
@retval EFI_SUCCESS The disk is not write protected
|
||||
@retval EFI_WRITE_PROTECTED: The disk is write protected
|
||||
|
||||
**/
|
||||
EFI_STATUS
|
||||
CheckStatus3 (
|
||||
IN UINT8 StatusRegister3
|
||||
)
|
||||
/*++
|
||||
|
||||
Routine Description: Check the drive status information
|
||||
Parameters:
|
||||
StatusRegister3 UINT8: the value of Status Register 3
|
||||
Returns:
|
||||
EFI_SUCCESS:
|
||||
EFI_WRITE_PROTECTED: The disk is write protected
|
||||
|
||||
--*/
|
||||
// GC_TODO: function comment is missing 'Arguments:'
|
||||
// GC_TODO: StatusRegister3 - add argument and description to function comment
|
||||
{
|
||||
if (StatusRegister3 & STS3_WP) {
|
||||
return EFI_WRITE_PROTECTED;
|
||||
@@ -1375,29 +1297,24 @@ CheckStatus3 (
|
||||
return EFI_SUCCESS;
|
||||
}
|
||||
|
||||
/**
|
||||
Calculate the number of block in the same cylinder
|
||||
according to LBA
|
||||
|
||||
@param FdcDev FDC_BLK_IO_DEV *: A pointer to Data Structure FDC_BLK_IO_DEV
|
||||
@param LBA EFI_LBA: The starting logic block address
|
||||
@param NumberOfBlocks UINTN: The number of blocks
|
||||
|
||||
@return The number of blocks in the same cylinder which the starting
|
||||
logic block address is LBA
|
||||
|
||||
**/
|
||||
UINTN
|
||||
GetTransferBlockCount (
|
||||
IN FDC_BLK_IO_DEV *FdcDev,
|
||||
IN EFI_LBA LBA,
|
||||
IN UINTN NumberOfBlocks
|
||||
)
|
||||
/*++
|
||||
|
||||
Routine Description: Calculate the number of block in the same cylinder
|
||||
according to LBA
|
||||
Parameters:
|
||||
FdcDev FDC_BLK_IO_DEV *: A pointer to Data Structure FDC_BLK_IO_DEV
|
||||
LBA EFI_LBA: The starting logic block address
|
||||
NumberOfBlocks UINTN: The number of blocks
|
||||
Returns:
|
||||
UINTN : The number of blocks in the same cylinder which the starting
|
||||
logic block address is LBA
|
||||
|
||||
--*/
|
||||
// GC_TODO: function comment is missing 'Arguments:'
|
||||
// GC_TODO: FdcDev - add argument and description to function comment
|
||||
// GC_TODO: LBA - add argument and description to function comment
|
||||
// GC_TODO: NumberOfBlocks - add argument and description to function comment
|
||||
{
|
||||
UINT8 EndOfTrack;
|
||||
UINT8 Head;
|
||||
@@ -1417,26 +1334,20 @@ GetTransferBlockCount (
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
When the Timer(2s) off, turn the drive's motor off
|
||||
|
||||
@param Event EFI_EVENT: Event(the timer) whose notification function is being
|
||||
invoked
|
||||
@param Context VOID *: Pointer to the notification function's context
|
||||
|
||||
**/
|
||||
VOID
|
||||
EFIAPI
|
||||
FddTimerProc (
|
||||
IN EFI_EVENT Event,
|
||||
IN VOID *Context
|
||||
)
|
||||
/*++
|
||||
|
||||
Routine Description: When the Timer(2s) off, turn the drive's motor off
|
||||
Parameters:
|
||||
Event EFI_EVENT: Event(the timer) whose notification function is being
|
||||
invoked
|
||||
Context VOID *: Pointer to the notification function's context
|
||||
Returns:
|
||||
VOID
|
||||
|
||||
--*/
|
||||
// GC_TODO: function comment is missing 'Arguments:'
|
||||
// GC_TODO: Event - add argument and description to function comment
|
||||
// GC_TODO: Context - add argument and description to function comment
|
||||
{
|
||||
FDC_BLK_IO_DEV *FdcDev;
|
||||
UINT8 data;
|
||||
@@ -1462,21 +1373,18 @@ FddTimerProc (
|
||||
MicroSecondDelay (500);
|
||||
}
|
||||
|
||||
/**
|
||||
Read I/O port for FDC
|
||||
|
||||
@param FdcDev FDC_BLK_IO_DEV *: A pointer to Data Structure FDC_BLK_IO_DEV
|
||||
@param Offset The offset address of port
|
||||
|
||||
**/
|
||||
UINT8
|
||||
FdcReadPort (
|
||||
IN FDC_BLK_IO_DEV *FdcDev,
|
||||
IN UINT32 Offset
|
||||
)
|
||||
/*++
|
||||
|
||||
Routine Description: Read I/O port for FDC
|
||||
Parameters:
|
||||
Returns:
|
||||
|
||||
--*/
|
||||
// GC_TODO: function comment is missing 'Arguments:'
|
||||
// GC_TODO: FdcDev - add argument and description to function comment
|
||||
// GC_TODO: Offset - add argument and description to function comment
|
||||
{
|
||||
UINT8 Data;
|
||||
|
||||
@@ -1494,23 +1402,19 @@ FdcReadPort (
|
||||
return Data;
|
||||
}
|
||||
|
||||
/**
|
||||
Write I/O port for FDC
|
||||
|
||||
@param FdcDev FDC_BLK_IO_DEV *: A pointer to Data Structure FDC_BLK_IO_DEV
|
||||
@param Offset The offset address of port
|
||||
|
||||
**/
|
||||
VOID
|
||||
FdcWritePort (
|
||||
IN FDC_BLK_IO_DEV *FdcDev,
|
||||
IN UINT32 Offset,
|
||||
IN UINT8 Data
|
||||
)
|
||||
/*++
|
||||
|
||||
Routine Description: Write I/O port for FDC
|
||||
Parameters:
|
||||
Returns:
|
||||
|
||||
--*/
|
||||
// GC_TODO: function comment is missing 'Arguments:'
|
||||
// GC_TODO: FdcDev - add argument and description to function comment
|
||||
// GC_TODO: Offset - add argument and description to function comment
|
||||
// GC_TODO: Data - add argument and description to function comment
|
||||
{
|
||||
|
||||
//
|
||||
@@ -1524,3 +1428,4 @@ FdcWritePort (
|
||||
&Data
|
||||
);
|
||||
}
|
||||
|
||||
|
||||
Reference in New Issue
Block a user