fba96322cc
git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@4314 6f19259b-4bc3-4df7-8a09-765794883524
141 lines
3.9 KiB
C
141 lines
3.9 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:
|
|
|
|
Capsules.c
|
|
|
|
Abstract:
|
|
|
|
BDS routines to handle capsules.
|
|
|
|
--*/
|
|
|
|
#include "Bds.h"
|
|
|
|
VOID
|
|
BdsLockNonUpdatableFlash (
|
|
VOID
|
|
)
|
|
{
|
|
}
|
|
|
|
EFI_STATUS
|
|
ProcessCapsules (
|
|
EFI_BOOT_MODE BootMode
|
|
)
|
|
/*++
|
|
|
|
Routine Description:
|
|
|
|
This routine is called to see if there are any capsules we need to process.
|
|
If the boot mode is not UPDATE, then we do nothing. Otherwise find the
|
|
capsule HOBS and produce firmware volumes for them via the DXE service.
|
|
Then call the dispatcher to dispatch drivers from them. Finally, check
|
|
the status of the updates.
|
|
|
|
Arguments:
|
|
|
|
BootMode - the current boot mode
|
|
|
|
Returns:
|
|
|
|
EFI_INVALID_PARAMETER - boot mode is not correct for an update
|
|
|
|
Note:
|
|
|
|
This function should be called by BDS in case we need to do some
|
|
sort of processing even if there is no capsule to process. We
|
|
need to do this if an earlier update went awry and we need to
|
|
clear the capsule variable so on the next reset PEI does not see it and
|
|
think there is a capsule available.
|
|
|
|
--*/
|
|
{
|
|
EFI_STATUS Status;
|
|
EFI_HOB_CAPSULE_VOLUME *CvHob;
|
|
EFI_PHYSICAL_ADDRESS BaseAddress;
|
|
UINT64 Length;
|
|
EFI_FIRMWARE_VOLUME_HEADER *FwVolHeader;
|
|
EFI_HANDLE FvProtocolHandle;
|
|
|
|
//
|
|
// We don't do anything else if the boot mode is not flash-update
|
|
//
|
|
if (BootMode != BOOT_ON_FLASH_UPDATE) {
|
|
return EFI_INVALID_PARAMETER;
|
|
}
|
|
//
|
|
// Only one capsule HOB allowed.
|
|
//
|
|
CvHob = GetFirstHob (EFI_HOB_TYPE_CV);
|
|
if (CvHob == NULL) {
|
|
//
|
|
// We didn't find a hob, so had no errors.
|
|
//
|
|
BdsLockNonUpdatableFlash ();
|
|
return EFI_SUCCESS;
|
|
}
|
|
|
|
BaseAddress = CvHob->BaseAddress;
|
|
Length = CvHob->Length;
|
|
|
|
Status = EFI_SUCCESS;
|
|
//
|
|
// Now walk the capsule and call the core to process each
|
|
// firmware volume in it.
|
|
//
|
|
while (Length != 0) {
|
|
//
|
|
// Point to the next firmware volume header, and then
|
|
// call the DXE service to process it.
|
|
//
|
|
FwVolHeader = (EFI_FIRMWARE_VOLUME_HEADER *) (UINTN) BaseAddress;
|
|
if (FwVolHeader->FvLength > Length) {
|
|
//
|
|
// Notes: need to stuff this status somewhere so that the
|
|
// error can be detected at OS runtime
|
|
//
|
|
Status = EFI_VOLUME_CORRUPTED;
|
|
break;
|
|
}
|
|
|
|
Status = gDS->ProcessFirmwareVolume (
|
|
(VOID *) (UINTN) BaseAddress,
|
|
(UINTN) FwVolHeader->FvLength,
|
|
&FvProtocolHandle
|
|
);
|
|
if (EFI_ERROR (Status)) {
|
|
break;
|
|
}
|
|
//
|
|
// Call the dispatcher to dispatch any drivers from the produced firmware volume
|
|
//
|
|
gDS->Dispatch ();
|
|
//
|
|
// On to the next FV in the capsule
|
|
//
|
|
Length -= FwVolHeader->FvLength;
|
|
BaseAddress = (EFI_PHYSICAL_ADDRESS) ((UINTN) BaseAddress + FwVolHeader->FvLength);
|
|
//
|
|
// Notes: when capsule spec is finalized, if the requirement is made to
|
|
// have each FV in a capsule aligned, then we will need to align the
|
|
// BaseAddress and Length here.
|
|
//
|
|
}
|
|
|
|
|
|
BdsLockNonUpdatableFlash ();
|
|
|
|
return Status;
|
|
}
|
|
|