mirror of https://github.com/acidanthera/audk.git
325 lines
9.8 KiB
C
325 lines
9.8 KiB
C
|
/*++
|
||
|
|
|
||
|
|
Copyright (c) 2006, Intel Corporation
|
||
|
|
All rights reserved. This program and the accompanying materials
|
||
|
|
are licensed and made available under the terms and conditions of the BSD License
|
||
|
|
which accompanies this distribution. The full text of the license may be found at
|
||
|
|
http://opensource.org/licenses/bsd-license.php
|
||
|
|
|
||
|
|
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
|
||
|
|
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
|
||
|
|
|
||
|
|
Module Name:
|
||
|
|
|
||
|
|
Fvb.c
|
||
|
|
|
||
|
|
Abstract:
|
||
|
|
|
||
|
|
Light weight lib to support Tiano Firmware Volume Block
|
||
|
|
protocol abstraction at runtime.
|
||
|
|
|
||
|
|
All these functions convert EFI_EXTENDED_SAL_FV_BLOCK_SERVICES_PROTOCOL_GUID
|
||
|
|
class function to the Runtime Lib function. There is a 1 to 1 mapping.
|
||
|
|
|
||
|
|
If you are using any of these lib functions.you must first call FvbInitialize ().
|
||
|
|
|
||
|
|
--*/
|
||
|
|
|
||
|
|
EFI_STATUS
|
||
|
|
FvbLibInitialize (
|
||
|
|
IN EFI_HANDLE ImageHandle,
|
||
|
|
IN EFI_SYSTEM_TABLE *SystemTable
|
||
|
|
)
|
||
|
|
/*++
|
||
|
|
|
||
|
|
Routine Description:
|
||
|
|
Initialize globals and register Fvb Protocol notification function.
|
||
|
|
|
||
|
|
Arguments:
|
||
|
|
None
|
||
|
|
|
||
|
|
Returns:
|
||
|
|
EFI_SUCCESS
|
||
|
|
|
||
|
|
--*/
|
||
|
|
{
|
||
|
|
return EFI_SUCCESS;
|
||
|
|
}
|
||
|
|
//
|
||
|
|
// The following functions wrap Fvb protocol in the Runtime Lib functions.
|
||
|
|
// The Instance translates into Fvb instance. The Fvb order defined by HOBs and
|
||
|
|
// thus the sequence of FVB protocol addition define Instance.
|
||
|
|
//
|
||
|
|
// EfiFvbInitialize () must be called before any of the following functions
|
||
|
|
// must be called.
|
||
|
|
//
|
||
|
|
EFI_STATUS
|
||
|
|
EfiFvbReadBlock (
|
||
|
|
IN UINTN Instance,
|
||
|
|
IN EFI_LBA Lba,
|
||
|
|
IN UINTN Offset,
|
||
|
|
IN OUT UINTN *NumBytes,
|
||
|
|
IN UINT8 *Buffer
|
||
|
|
)
|
||
|
|
/*++
|
||
|
|
|
||
|
|
Routine Description:
|
||
|
|
Reads specified number of bytes into a buffer from the specified block
|
||
|
|
|
||
|
|
Arguments:
|
||
|
|
Instance - The FV instance to be read from
|
||
|
|
Lba - The logical block address to be read from
|
||
|
|
Offset - Offset into the block at which to begin reading
|
||
|
|
NumBytes - Pointer that on input contains the total size of
|
||
|
|
the buffer. On output, it contains the total number
|
||
|
|
of bytes read
|
||
|
|
Buffer - Pointer to a caller allocated buffer that will be
|
||
|
|
used to hold the data read
|
||
|
|
|
||
|
|
Returns:
|
||
|
|
Status code
|
||
|
|
|
||
|
|
--*/
|
||
|
|
{
|
||
|
|
EFI_GUID Guid = EFI_EXTENDED_SAL_FV_BLOCK_SERVICES_PROTOCOL_GUID;
|
||
|
|
|
||
|
|
return EfiCallEsalService (&Guid, Read, Instance, Lba, Offset, (UINT64) NumBytes, (UINT64) Buffer, 0, 0).Status;
|
||
|
|
}
|
||
|
|
|
||
|
|
EFI_STATUS
|
||
|
|
EfiFvbWriteBlock (
|
||
|
|
IN UINTN Instance,
|
||
|
|
IN EFI_LBA Lba,
|
||
|
|
IN UINTN Offset,
|
||
|
|
IN OUT UINTN *NumBytes,
|
||
|
|
IN UINT8 *Buffer
|
||
|
|
)
|
||
|
|
/*++
|
||
|
|
|
||
|
|
Routine Description:
|
||
|
|
Writes specified number of bytes from the input buffer to the block
|
||
|
|
|
||
|
|
Arguments:
|
||
|
|
Instance - The FV instance to be written to
|
||
|
|
Lba - The starting logical block index to write to
|
||
|
|
Offset - Offset into the block at which to begin writing
|
||
|
|
NumBytes - Pointer that on input contains the total size of
|
||
|
|
the buffer. On output, it contains the total number
|
||
|
|
of bytes actually written
|
||
|
|
Buffer - Pointer to a caller allocated buffer that contains
|
||
|
|
the source for the write
|
||
|
|
|
||
|
|
Returns:
|
||
|
|
Status code
|
||
|
|
|
||
|
|
--*/
|
||
|
|
{
|
||
|
|
EFI_GUID Guid = EFI_EXTENDED_SAL_FV_BLOCK_SERVICES_PROTOCOL_GUID;
|
||
|
|
|
||
|
|
return EfiCallEsalService (&Guid, Write, Instance, Lba, Offset, (UINT64) NumBytes, (UINT64) Buffer, 0, 0).Status;
|
||
|
|
}
|
||
|
|
|
||
|
|
EFI_STATUS
|
||
|
|
EfiFvbEraseBlock (
|
||
|
|
IN UINTN Instance,
|
||
|
|
IN UINTN Lba
|
||
|
|
)
|
||
|
|
/*++
|
||
|
|
|
||
|
|
Routine Description:
|
||
|
|
Erases and initializes a firmware volume block
|
||
|
|
|
||
|
|
Arguments:
|
||
|
|
Instance - The FV instance to be erased
|
||
|
|
Lba - The logical block index to be erased
|
||
|
|
|
||
|
|
Returns:
|
||
|
|
Status code
|
||
|
|
|
||
|
|
--*/
|
||
|
|
{
|
||
|
|
EFI_GUID Guid = EFI_EXTENDED_SAL_FV_BLOCK_SERVICES_PROTOCOL_GUID;
|
||
|
|
|
||
|
|
return EfiCallEsalService (&Guid, EraseBlock, Instance, Lba, 0, 0, 0, 0, 0).Status;
|
||
|
|
}
|
||
|
|
|
||
|
|
EFI_STATUS
|
||
|
|
EfiFvbGetVolumeAttributes (
|
||
|
|
IN UINTN Instance,
|
||
|
|
OUT EFI_FVB_ATTRIBUTES *Attributes
|
||
|
|
)
|
||
|
|
/*++
|
||
|
|
|
||
|
|
Routine Description:
|
||
|
|
Retrieves attributes, insures positive polarity of attribute bits, returns
|
||
|
|
resulting attributes in output parameter
|
||
|
|
|
||
|
|
Arguments:
|
||
|
|
Instance - The FV instance whose attributes is going to be
|
||
|
|
returned
|
||
|
|
Attributes - Output buffer which contains attributes
|
||
|
|
|
||
|
|
Returns:
|
||
|
|
Status code
|
||
|
|
|
||
|
|
--*/
|
||
|
|
{
|
||
|
|
EFI_GUID Guid = EFI_EXTENDED_SAL_FV_BLOCK_SERVICES_PROTOCOL_GUID;
|
||
|
|
|
||
|
|
return EfiCallEsalService (&Guid, SetVolumeAttributes, Instance, (UINT64) Attributes, 0, 0, 0, 0, 0).Status;
|
||
|
|
}
|
||
|
|
|
||
|
|
EFI_STATUS
|
||
|
|
EfiFvbSetVolumeAttributes (
|
||
|
|
IN UINTN Instance,
|
||
|
|
IN EFI_FVB_ATTRIBUTES Attributes
|
||
|
|
)
|
||
|
|
/*++
|
||
|
|
|
||
|
|
Routine Description:
|
||
|
|
Modifies the current settings of the firmware volume according to the
|
||
|
|
input parameter, and returns the new setting of the volume
|
||
|
|
|
||
|
|
Arguments:
|
||
|
|
Instance - The FV instance whose attributes is going to be
|
||
|
|
modified
|
||
|
|
Attributes - On input, it is a pointer to EFI_FVB_ATTRIBUTES
|
||
|
|
containing the desired firmware volume settings.
|
||
|
|
On successful return, it contains the new settings
|
||
|
|
of the firmware volume
|
||
|
|
|
||
|
|
Returns:
|
||
|
|
Status code
|
||
|
|
|
||
|
|
--*/
|
||
|
|
{
|
||
|
|
EFI_GUID Guid = EFI_EXTENDED_SAL_FV_BLOCK_SERVICES_PROTOCOL_GUID;
|
||
|
|
|
||
|
|
return EfiCallEsalService (&Guid, SetVolumeAttributes, Instance, (UINT64) Attributes, 0, 0, 0, 0, 0).Status;
|
||
|
|
}
|
||
|
|
|
||
|
|
EFI_STATUS
|
||
|
|
EfiFvbGetPhysicalAddress (
|
||
|
|
IN UINTN Instance,
|
||
|
|
OUT EFI_PHYSICAL_ADDRESS *BaseAddress
|
||
|
|
)
|
||
|
|
/*++
|
||
|
|
|
||
|
|
Routine Description:
|
||
|
|
Retrieves the physical address of a memory mapped FV
|
||
|
|
|
||
|
|
Arguments:
|
||
|
|
Instance - The FV instance whose base address is going to be
|
||
|
|
returned
|
||
|
|
BaseAddress - Pointer to a caller allocated EFI_PHYSICAL_ADDRESS
|
||
|
|
that on successful return, contains the base address
|
||
|
|
of the firmware volume.
|
||
|
|
|
||
|
|
Returns:
|
||
|
|
Status code
|
||
|
|
|
||
|
|
--*/
|
||
|
|
{
|
||
|
|
EFI_GUID Guid = EFI_EXTENDED_SAL_FV_BLOCK_SERVICES_PROTOCOL_GUID;
|
||
|
|
|
||
|
|
return EfiCallEsalService (&Guid, GetPhysicalAddress, Instance, (UINT64) BaseAddress, 0, 0, 0, 0, 0).Status;
|
||
|
|
}
|
||
|
|
|
||
|
|
EFI_STATUS
|
||
|
|
EfiFvbGetBlockSize (
|
||
|
|
IN UINTN Instance,
|
||
|
|
IN EFI_LBA Lba,
|
||
|
|
OUT UINTN *BlockSize,
|
||
|
|
OUT UINTN *NumOfBlocks
|
||
|
|
)
|
||
|
|
/*++
|
||
|
|
|
||
|
|
Routine Description:
|
||
|
|
Retrieve the size of a logical block
|
||
|
|
|
||
|
|
Arguments:
|
||
|
|
Instance - The FV instance whose block size is going to be
|
||
|
|
returned
|
||
|
|
Lba - Indicates which block to return the size for.
|
||
|
|
BlockSize - A pointer to a caller allocated UINTN in which
|
||
|
|
the size of the block is returned
|
||
|
|
NumOfBlocks - a pointer to a caller allocated UINTN in which the
|
||
|
|
number of consecutive blocks starting with Lba is
|
||
|
|
returned. All blocks in this range have a size of
|
||
|
|
BlockSize
|
||
|
|
|
||
|
|
Returns:
|
||
|
|
EFI_SUCCESS - The firmware volume was read successfully and
|
||
|
|
contents are in Buffer
|
||
|
|
|
||
|
|
--*/
|
||
|
|
{
|
||
|
|
EFI_GUID Guid = EFI_EXTENDED_SAL_FV_BLOCK_SERVICES_PROTOCOL_GUID;
|
||
|
|
|
||
|
|
return EfiCallEsalService (
|
||
|
|
&Guid,
|
||
|
|
GetBlockSize,
|
||
|
|
Instance,
|
||
|
|
Lba,
|
||
|
|
(UINT64) BlockSize,
|
||
|
|
(UINT64) NumOfBlocks,
|
||
|
|
0,
|
||
|
|
0,
|
||
|
|
0
|
||
|
|
).Status;
|
||
|
|
}
|
||
|
|
|
||
|
|
EFI_STATUS
|
||
|
|
EfiFvbEraseCustomBlockRange (
|
||
|
|
IN UINTN Instance,
|
||
|
|
IN EFI_LBA StartLba,
|
||
|
|
IN UINTN OffsetStartLba,
|
||
|
|
IN EFI_LBA LastLba,
|
||
|
|
IN UINTN OffsetLastLba
|
||
|
|
)
|
||
|
|
/*++
|
||
|
|
|
||
|
|
Routine Description:
|
||
|
|
Erases and initializes a specified range of a firmware volume
|
||
|
|
|
||
|
|
Arguments:
|
||
|
|
Instance - The FV instance to be erased
|
||
|
|
StartLba - The starting logical block index to be erased
|
||
|
|
OffsetStartLba - Offset into the starting block at which to
|
||
|
|
begin erasing
|
||
|
|
LastLba - The last logical block index to be erased
|
||
|
|
OffsetLastLba - Offset into the last block at which to end erasing
|
||
|
|
|
||
|
|
Returns:
|
||
|
|
Status code
|
||
|
|
|
||
|
|
--*/
|
||
|
|
{
|
||
|
|
EFI_GUID Guid = EFI_EXTENDED_SAL_FV_BLOCK_SERVICES_PROTOCOL_GUID;
|
||
|
|
|
||
|
|
return EfiCallEsalService (
|
||
|
|
&Guid,
|
||
|
|
EraseCustomBlockRange,
|
||
|
|
Instance,
|
||
|
|
StartLba,
|
||
|
|
OffsetStartLba,
|
||
|
|
LastLba,
|
||
|
|
OffsetLastLba,
|
||
|
|
0,
|
||
|
|
0
|
||
|
|
).Status;
|
||
|
|
}
|
||
|
|
|
||
|
|
|
||
|
|
/**
|
||
|
|
BugBug: Can't turn this off in the current MSA so we need a stub
|
||
|
|
**/
|
||
|
|
VOID
|
||
|
|
EFIAPI
|
||
|
|
FvbVirtualAddressChangeNotifyEvent (
|
||
|
|
IN EFI_EVENT Event,
|
||
|
|
IN VOID *Context
|
||
|
|
)
|
||
|
|
{
|
||
|
|
}
|