- Generated on Fri Nov 15 2024 18:01:35 for TianoCore EDK2 by
1.9.6
|
TianoCore EDK2 master
|
Go to the source code of this file.
Data Structures | |
| struct | EFI_FIRMWARE_IMAGE_DEP |
| struct | EFI_FIRMWARE_IMAGE_DESCRIPTOR |
| struct | EFI_FIRMWARE_IMAGE_AUTHENTICATION |
| struct | _EFI_FIRMWARE_MANAGEMENT_PROTOCOL |
Variables | |
| EFI_GUID | gEfiFirmwareManagementProtocolGuid |
UEFI Firmware Management Protocol definition Firmware Management Protocol provides an abstraction for device to provide firmware management support. The base requirements for managing device firmware images include identifying firmware image revision level and programming the image into the device.
GetImageInfo() is the only required function. GetImage(), SetImage(), CheckImage(), GetPackageInfo(), and SetPackageInfo() shall return EFI_UNSUPPORTED if not supported by the driver.
Copyright (c) 2009 - 2020, Intel Corporation. All rights reserved.
Copyright (c) 2013 - 2014, Hewlett-Packard Development Company, L.P.
SPDX-License-Identifier: BSD-2-Clause-Patent
Definition in file FirmwareManagement.h.
| #define EFI_FIRMWARE_IMAGE_DESCRIPTOR_VERSION 4 |
Descriptor Version exposed by GetImageInfo() function
Definition at line 190 of file FirmwareManagement.h.
| #define EFI_FIRMWARE_MANAGEMENT_PROTOCOL_GUID |
Definition at line 23 of file FirmwareManagement.h.
| #define EFI_FMP_DEP_AND 0x03 |
Definition at line 36 of file FirmwareManagement.h.
| #define EFI_FMP_DEP_DECLARE_LENGTH 0x0E |
Definition at line 47 of file FirmwareManagement.h.
| #define EFI_FMP_DEP_END 0x0D |
Definition at line 46 of file FirmwareManagement.h.
| #define EFI_FMP_DEP_EQ 0x08 |
Definition at line 41 of file FirmwareManagement.h.
| #define EFI_FMP_DEP_FALSE 0x07 |
Definition at line 40 of file FirmwareManagement.h.
| #define EFI_FMP_DEP_GT 0x09 |
Definition at line 42 of file FirmwareManagement.h.
| #define EFI_FMP_DEP_GTE 0x0A |
Definition at line 43 of file FirmwareManagement.h.
| #define EFI_FMP_DEP_LT 0x0B |
Definition at line 44 of file FirmwareManagement.h.
| #define EFI_FMP_DEP_LTE 0x0C |
Definition at line 45 of file FirmwareManagement.h.
| #define EFI_FMP_DEP_NOT 0x05 |
Definition at line 38 of file FirmwareManagement.h.
| #define EFI_FMP_DEP_OR 0x04 |
Definition at line 37 of file FirmwareManagement.h.
| #define EFI_FMP_DEP_PUSH_GUID 0x00 |
Dependency Expression Opcode
Definition at line 33 of file FirmwareManagement.h.
| #define EFI_FMP_DEP_PUSH_VERSION 0x01 |
Definition at line 34 of file FirmwareManagement.h.
| #define EFI_FMP_DEP_TRUE 0x06 |
Definition at line 39 of file FirmwareManagement.h.
| #define EFI_FMP_DEP_VERSION_STR 0x02 |
Definition at line 35 of file FirmwareManagement.h.
| #define IMAGE_ATTRIBUTE_AUTHENTICATION_REQUIRED 0x0000000000000004 |
The attribute IMAGE_ATTRIBUTE_AUTHENTICATION_REQUIRED indicates authentication is required to perform the following image operations: GetImage(), SetImage(), and CheckImage(). See 'Image Attribute - Authentication'.
Definition at line 161 of file FirmwareManagement.h.
| #define IMAGE_ATTRIBUTE_DEPENDENCY 0x0000000000000020 |
The attribute IMAGE_ATTRIBUTE_DEPENDENCY indicates that there is an EFI_FIRMWARE_IMAGE_DEP section associated with the image.
Definition at line 175 of file FirmwareManagement.h.
| #define IMAGE_ATTRIBUTE_IMAGE_UPDATABLE 0x0000000000000001 |
The attribute IMAGE_ATTRIBUTE_IMAGE_UPDATABLE indicates this device supports firmware image update.
Definition at line 149 of file FirmwareManagement.h.
| #define IMAGE_ATTRIBUTE_IN_USE 0x0000000000000008 |
The attribute IMAGE_ATTRIBUTE_IN_USE indicates the current state of the firmware image. This distinguishes firmware images in a device that supports redundant images.
Definition at line 166 of file FirmwareManagement.h.
| #define IMAGE_ATTRIBUTE_RESET_REQUIRED 0x0000000000000002 |
The attribute IMAGE_ATTRIBUTE_RESET_REQUIRED indicates a reset of the device is required for the new firmware image to take effect after a firmware update. The device is the device hosting the firmware image.
Definition at line 155 of file FirmwareManagement.h.
| #define IMAGE_ATTRIBUTE_UEFI_IMAGE 0x0000000000000010 |
The attribute IMAGE_ATTRIBUTE_UEFI_IMAGE indicates that this image is an EFI compatible image.
Definition at line 170 of file FirmwareManagement.h.
| #define IMAGE_COMPATIBILITY_CHECK_SUPPORTED 0x0000000000000001 |
Values from 0x0000000000000002 thru 0x000000000000FFFF are reserved for future assignments. Values from 0x0000000000010000 thru 0xFFFFFFFFFFFFFFFF are used by firmware vendor for compatibility check.
Definition at line 185 of file FirmwareManagement.h.
| #define IMAGE_UPDATABLE_INVALID 0x0000000000000002 |
IMAGE_UPDATABLE_INVALID indicates SetImage() will reject the new image. No additional information is provided for the rejection.
Definition at line 225 of file FirmwareManagement.h.
| #define IMAGE_UPDATABLE_INVALID_OLD 0x0000000000000008 |
IMAGE_UPDATABLE_INVALID_OLD indicates SetImage() will reject the new image. The rejection is due to the new image version is older than the current firmware image version in the device. The device firmware update policy does not support firmware version downgrade.
Definition at line 237 of file FirmwareManagement.h.
| #define IMAGE_UPDATABLE_INVALID_TYPE 0x0000000000000004 |
IMAGE_UPDATABLE_INVALID_TYPE indicates SetImage() will reject the new image. The rejection is due to the new image is not a firmware image recognized for this device.
Definition at line 230 of file FirmwareManagement.h.
| #define IMAGE_UPDATABLE_VALID 0x0000000000000001 |
IMAGE_UPDATABLE_VALID indicates SetImage() will accept the new image and update the device with the new image. The version of the new image could be higher or lower than the current image. SetImage VendorCode is optional but can be used for vendor specific action.
Definition at line 220 of file FirmwareManagement.h.
| #define IMAGE_UPDATABLE_VALID_WITH_VENDOR_CODE 0x0000000000000010 |
IMAGE_UPDATABLE_VALID_WITH_VENDOR_CODE indicates SetImage() will accept and update the new image only if a correct VendorCode is provided or else image would be rejected and SetImage will return appropriate error.
Definition at line 243 of file FirmwareManagement.h.
| #define PACKAGE_ATTRIBUTE_AUTHENTICATION_REQUIRED 0x0000000000000004 |
The attribute PACKAGE_ATTRIBUTE_AUTHENTICATION_REQUIRED indicates authentication is required to update the package info.
Definition at line 262 of file FirmwareManagement.h.
| #define PACKAGE_ATTRIBUTE_RESET_REQUIRED 0x0000000000000002 |
The attribute PACKAGE_ATTRIBUTE_RESET_REQUIRED indicates a reset of the device is required for the new package info to take effect after an update.
Definition at line 257 of file FirmwareManagement.h.
| #define PACKAGE_ATTRIBUTE_VERSION_UPDATABLE 0x0000000000000001 |
The attribute PACKAGE_ATTRIBUTE_VERSION_UPDATABLE indicates this device supports the update of the firmware package version.
Definition at line 252 of file FirmwareManagement.h.
Definition at line 28 of file FirmwareManagement.h.
| typedef EFI_STATUS(EFIAPI * EFI_FIRMWARE_MANAGEMENT_PROTOCOL_CHECK_IMAGE) (IN EFI_FIRMWARE_MANAGEMENT_PROTOCOL *This, IN UINT8 ImageIndex, IN CONST VOID *Image, IN UINTN ImageSize, OUT UINT32 *ImageUpdatable) |
Checks if the firmware image is valid for the device.
This function allows firmware update application to validate the firmware image without invoking the SetImage() first.
| [in] | This | A pointer to the EFI_FIRMWARE_MANAGEMENT_PROTOCOL instance. |
| [in] | ImageIndex | A unique number identifying the firmware image(s) within the device. The number is between 1 and DescriptorCount. |
| [in] | Image | Points to the new image. |
| [in] | ImageSize | Size of the new image in bytes. |
| [out] | ImageUpdatable | Indicates if the new image is valid for update. It also provides, if available, additional information if the image is invalid. |
| EFI_SUCCESS | The image was successfully checked. |
| EFI_INVALID_PARAMETER | The Image was NULL. |
| EFI_UNSUPPORTED | The operation is not supported. |
| EFI_SECURITY_VIOLATION | The operation could not be performed due to an authentication failure. |
Definition at line 445 of file FirmwareManagement.h.
| typedef EFI_STATUS(EFIAPI * EFI_FIRMWARE_MANAGEMENT_PROTOCOL_GET_IMAGE) (IN EFI_FIRMWARE_MANAGEMENT_PROTOCOL *This, IN UINT8 ImageIndex, OUT VOID *Image, IN OUT UINTN *ImageSize) |
Retrieves a copy of the current firmware image of the device.
This function allows a copy of the current firmware image to be created and saved. The saved copy could later been used, for example, in firmware image recovery or rollback.
| [in] | This | A pointer to the EFI_FIRMWARE_MANAGEMENT_PROTOCOL instance. |
| [in] | ImageIndex | A unique number identifying the firmware image(s) within the device. The number is between 1 and DescriptorCount. |
| [out] | Image | Points to the buffer where the current image is copied to. |
| [in,out] | ImageSize | On entry, points to the size of the buffer pointed to by Image, in bytes. On return, points to the length of the image, in bytes. |
| EFI_SUCCESS | The device was successfully updated with the new image. |
| EFI_BUFFER_TOO_SMALL | The buffer specified by ImageSize is too small to hold the image. The current buffer size needed to hold the image is returned in ImageSize. |
| EFI_INVALID_PARAMETER | The Image was NULL. |
| EFI_NOT_FOUND | The current image is not copied to the buffer. |
| EFI_UNSUPPORTED | The operation is not supported. |
| EFI_SECURITY_VIOLATION | The operation could not be performed due to an authentication failure. |
Definition at line 358 of file FirmwareManagement.h.
| typedef EFI_STATUS(EFIAPI * EFI_FIRMWARE_MANAGEMENT_PROTOCOL_GET_IMAGE_INFO) (IN EFI_FIRMWARE_MANAGEMENT_PROTOCOL *This, IN OUT UINTN *ImageInfoSize, IN OUT EFI_FIRMWARE_IMAGE_DESCRIPTOR *ImageInfo, OUT UINT32 *DescriptorVersion, OUT UINT8 *DescriptorCount, OUT UINTN *DescriptorSize, OUT UINT32 *PackageVersion, OUT CHAR16 **PackageVersionName) |
Returns information about the current firmware image(s) of the device.
This function allows a copy of the current firmware image to be created and saved. The saved copy could later been used, for example, in firmware image recovery or rollback.
| [in] | This | A pointer to the EFI_FIRMWARE_MANAGEMENT_PROTOCOL instance. |
| [in,out] | ImageInfoSize | A pointer to the size, in bytes, of the ImageInfo buffer. On input, this is the size of the buffer allocated by the caller. On output, it is the size of the buffer returned by the firmware if the buffer was large enough, or the size of the buffer needed to contain the image(s) information if the buffer was too small. |
| [in,out] | ImageInfo | A pointer to the buffer in which firmware places the current image(s) information. The information is an array of EFI_FIRMWARE_IMAGE_DESCRIPTORs. |
| [out] | DescriptorVersion | A pointer to the location in which firmware returns the version number associated with the EFI_FIRMWARE_IMAGE_DESCRIPTOR. |
| [out] | DescriptorCount | A pointer to the location in which firmware returns the number of descriptors or firmware images within this device. |
| [out] | DescriptorSize | A pointer to the location in which firmware returns the size, in bytes, of an individual EFI_FIRMWARE_IMAGE_DESCRIPTOR. |
| [out] | PackageVersion | A version number that represents all the firmware images in the device. The format is vendor specific and new version must have a greater value than the old version. If PackageVersion is not supported, the value is 0xFFFFFFFF. A value of 0xFFFFFFFE indicates that package version comparison is to be performed using PackageVersionName. A value of 0xFFFFFFFD indicates that package version update is in progress. |
| [out] | PackageVersionName | A pointer to a pointer to a null-terminated string representing the package version name. The buffer is allocated by this function with AllocatePool(), and it is the caller's responsibility to free it with a call to FreePool(). |
| EFI_SUCCESS | The device was successfully updated with the new image. |
| EFI_BUFFER_TOO_SMALL | The ImageInfo buffer was too small. The current buffer size needed to hold the image(s) information is returned in ImageInfoSize. |
| EFI_INVALID_PARAMETER | ImageInfoSize is NULL. |
| EFI_DEVICE_ERROR | Valid information could not be returned. Possible corrupted image. |
Definition at line 322 of file FirmwareManagement.h.
| typedef EFI_STATUS(EFIAPI * EFI_FIRMWARE_MANAGEMENT_PROTOCOL_GET_PACKAGE_INFO) (IN EFI_FIRMWARE_MANAGEMENT_PROTOCOL *This, OUT UINT32 *PackageVersion, OUT CHAR16 **PackageVersionName, OUT UINT32 *PackageVersionNameMaxLen, OUT UINT64 *AttributesSupported, OUT UINT64 *AttributesSetting) |
Returns information about the firmware package.
This function returns package information.
| [in] | This | A pointer to the EFI_FIRMWARE_MANAGEMENT_PROTOCOL instance. |
| [out] | PackageVersion | A version number that represents all the firmware images in the device. The format is vendor specific and new version must have a greater value than the old version. If PackageVersion is not supported, the value is 0xFFFFFFFF. A value of 0xFFFFFFFE indicates that package version comparison is to be performed using PackageVersionName. A value of 0xFFFFFFFD indicates that package version update is in progress. |
| [out] | PackageVersionName | A pointer to a pointer to a null-terminated string representing the package version name. The buffer is allocated by this function with AllocatePool(), and it is the caller's responsibility to free it with a call to FreePool(). |
| [out] | PackageVersionNameMaxLen | The maximum length of package version name if device supports update of package version name. A value of 0 indicates the device does not support update of package version name. Length is the number of Unicode characters, including the terminating null character. |
| [out] | AttributesSupported | Package attributes that are supported by this device. See 'Package Attribute Definitions' for possible returned values of this parameter. A value of 1 indicates the attribute is supported and the current setting value is indicated in AttributesSetting. A value of 0 indicates the attribute is not supported and the current setting value in AttributesSetting is meaningless. |
| [out] | AttributesSetting | Package attributes. See 'Package Attribute Definitions' for possible returned values of this parameter |
| EFI_SUCCESS | The package information was successfully returned. |
| EFI_UNSUPPORTED | The operation is not supported. |
Definition at line 487 of file FirmwareManagement.h.
| typedef EFI_STATUS(EFIAPI * EFI_FIRMWARE_MANAGEMENT_PROTOCOL_SET_IMAGE) (IN EFI_FIRMWARE_MANAGEMENT_PROTOCOL *This, IN UINT8 ImageIndex, IN CONST VOID *Image, IN UINTN ImageSize, IN CONST VOID *VendorCode, IN EFI_FIRMWARE_MANAGEMENT_UPDATE_IMAGE_PROGRESS Progress, OUT CHAR16 **AbortReason) |
Updates the firmware image of the device.
This function updates the hardware with the new firmware image. This function returns EFI_UNSUPPORTED if the firmware image is not updatable. If the firmware image is updatable, the function should perform the following minimal validations before proceeding to do the firmware image update.
VendorCode enables vendor to implement vendor-specific firmware image update policy. Null if the caller did not specify the policy or use the default policy. As an example, vendor can implement a policy to allow an option to force a firmware image update when the abort reason is due to the new firmware image version is older than the current firmware image version or bad image checksum. Sensitive operations such as those wiping the entire firmware image and render the device to be non-functional should be encoded in the image itself rather than passed with the VendorCode. AbortReason enables vendor to have the option to provide a more detailed description of the abort reason to the caller.
| [in] | This | A pointer to the EFI_FIRMWARE_MANAGEMENT_PROTOCOL instance. |
| [in] | ImageIndex | A unique number identifying the firmware image(s) within the device. The number is between 1 and DescriptorCount. |
| [in] | Image | Points to the new image. |
| [in] | ImageSize | Size of the new image in bytes. |
| [in] | VendorCode | This enables vendor to implement vendor-specific firmware image update policy. Null indicates the caller did not specify the policy or use the default policy. |
| [in] | Progress | A function used by the driver to report the progress of the firmware update. |
| [out] | AbortReason | A pointer to a pointer to a null-terminated string providing more details for the aborted operation. The buffer is allocated by this function with AllocatePool(), and it is the caller's responsibility to free it with a call to FreePool(). |
| EFI_SUCCESS | The device was successfully updated with the new image. |
| EFI_ABORTED | The operation is aborted. |
| EFI_INVALID_PARAMETER | The Image was NULL. |
| EFI_UNSUPPORTED | The operation is not supported. |
| EFI_SECURITY_VIOLATION | The operation could not be performed due to an authentication failure. |
Definition at line 413 of file FirmwareManagement.h.
| typedef EFI_STATUS(EFIAPI * EFI_FIRMWARE_MANAGEMENT_PROTOCOL_SET_PACKAGE_INFO) (IN EFI_FIRMWARE_MANAGEMENT_PROTOCOL *This, IN CONST VOID *Image, IN UINTN ImageSize, IN CONST VOID *VendorCode, IN UINT32 PackageVersion, IN CONST CHAR16 *PackageVersionName) |
Updates information about the firmware package.
This function updates package information. This function returns EFI_UNSUPPORTED if the package information is not updatable. VendorCode enables vendor to implement vendor-specific package information update policy. Null if the caller did not specify this policy or use the default policy.
| [in] | This | A pointer to the EFI_FIRMWARE_MANAGEMENT_PROTOCOL instance. |
| [in] | Image | Points to the authentication image. Null if authentication is not required. |
| [in] | ImageSize | Size of the authentication image in bytes. 0 if authentication is not required. |
| [in] | VendorCode | This enables vendor to implement vendor-specific firmware image update policy. Null indicates the caller did not specify this policy or use the default policy. |
| [in] | PackageVersion | The new package version. |
| [in] | PackageVersionName | A pointer to the new null-terminated Unicode string representing the package version name. The string length is equal to or less than the value returned in PackageVersionNameMaxLen. |
| EFI_SUCCESS | The device was successfully updated with the new package information. |
| EFI_INVALID_PARAMETER | The PackageVersionName length is longer than the value returned in PackageVersionNameMaxLen. |
| EFI_UNSUPPORTED | The operation is not supported. |
| EFI_SECURITY_VIOLATION | The operation could not be performed due to an authentication failure. |
Definition at line 529 of file FirmwareManagement.h.
| typedef EFI_STATUS(EFIAPI * EFI_FIRMWARE_MANAGEMENT_UPDATE_IMAGE_PROGRESS) (IN UINTN Completion) |
Callback function to report the process of the firmware updating.
| [in] | Completion | A value between 1 and 100 indicating the current completion progress of the firmware update. Completion progress is reported as from 1 to 100 percent. A value of 0 is used by the driver to indicate that progress reporting is not supported. |
| EFI_SUCCESS | SetImage() continues to do the callback if supported. |
| other | SetImage() discontinues the callback and completes the update and returns. |
Definition at line 278 of file FirmwareManagement.h.
1.9.6