mirror of
https://github.com/AsahiLinux/u-boot
synced 2024-12-01 00:49:43 +00:00
6984077de0
Add support to dump the contents of capsule headers. This is useful as a debug feature for checking the contents of the capsule headers, and can also be used in capsule verification. Signed-off-by: Sughosh Ganu <sughosh.ganu@linaro.org> Reviewed-by: Simon Glass <sjg@chromium.org>
148 lines
3.8 KiB
C
148 lines
3.8 KiB
C
/* SPDX-License-Identifier: GPL-2.0 */
|
|
/*
|
|
* Copyright 2021 Linaro Limited
|
|
* Author: AKASHI Takahiro
|
|
*
|
|
* derived from efi.h and efi_api.h to make the file POSIX-compliant
|
|
*/
|
|
|
|
#ifndef _EFI_CAPSULE_H
|
|
#define _EFI_CAPSULE_H
|
|
|
|
#include <stdint.h>
|
|
|
|
/*
|
|
* Gcc's predefined attributes are not recognized by clang.
|
|
*/
|
|
#ifndef __packed
|
|
#define __packed __attribute__((__packed__))
|
|
#endif
|
|
|
|
#ifndef __aligned
|
|
#define __aligned(x) __attribute__((__aligned__(x)))
|
|
#endif
|
|
|
|
#define ARRAY_SIZE(x) (sizeof(x) / sizeof((x)[0]))
|
|
|
|
typedef struct {
|
|
uint8_t b[16];
|
|
} efi_guid_t __aligned(8);
|
|
|
|
#define EFI_GUID(a, b, c, d0, d1, d2, d3, d4, d5, d6, d7) \
|
|
{{ (a) & 0xff, ((a) >> 8) & 0xff, ((a) >> 16) & 0xff, \
|
|
((a) >> 24) & 0xff, \
|
|
(b) & 0xff, ((b) >> 8) & 0xff, \
|
|
(c) & 0xff, ((c) >> 8) & 0xff, \
|
|
(d0), (d1), (d2), (d3), (d4), (d5), (d6), (d7) } }
|
|
|
|
#define EFI_FIRMWARE_MANAGEMENT_CAPSULE_ID_GUID \
|
|
EFI_GUID(0x6dcbd5ed, 0xe82d, 0x4c44, 0xbd, 0xa1, \
|
|
0x71, 0x94, 0x19, 0x9a, 0xd9, 0x2a)
|
|
|
|
#define EFI_CERT_TYPE_PKCS7_GUID \
|
|
EFI_GUID(0x4aafd29d, 0x68df, 0x49ee, 0x8a, 0xa9, \
|
|
0x34, 0x7d, 0x37, 0x56, 0x65, 0xa7)
|
|
|
|
#define FW_ACCEPT_OS_GUID \
|
|
EFI_GUID(0x0c996046, 0xbcc0, 0x4d04, 0x85, 0xec, \
|
|
0xe1, 0xfc, 0xed, 0xf1, 0xc6, 0xf8)
|
|
|
|
#define FW_REVERT_OS_GUID \
|
|
EFI_GUID(0xacd58b4b, 0xc0e8, 0x475f, 0x99, 0xb5, \
|
|
0x6b, 0x3f, 0x7e, 0x07, 0xaa, 0xf0)
|
|
|
|
/* flags */
|
|
#define CAPSULE_FLAGS_PERSIST_ACROSS_RESET 0x00010000
|
|
|
|
struct efi_capsule_header {
|
|
efi_guid_t capsule_guid;
|
|
uint32_t header_size;
|
|
uint32_t flags;
|
|
uint32_t capsule_image_size;
|
|
} __packed;
|
|
|
|
struct efi_firmware_management_capsule_header {
|
|
uint32_t version;
|
|
uint16_t embedded_driver_count;
|
|
uint16_t payload_item_count;
|
|
uint64_t item_offset_list[];
|
|
} __packed;
|
|
|
|
/* image_capsule_support */
|
|
#define CAPSULE_SUPPORT_AUTHENTICATION 0x0000000000000001
|
|
|
|
struct efi_firmware_management_capsule_image_header {
|
|
uint32_t version;
|
|
efi_guid_t update_image_type_id;
|
|
uint8_t update_image_index;
|
|
uint8_t reserved[3];
|
|
uint32_t update_image_size;
|
|
uint32_t update_vendor_code_size;
|
|
uint64_t update_hardware_instance;
|
|
uint64_t image_capsule_support;
|
|
} __packed;
|
|
|
|
/**
|
|
* win_certificate_uefi_guid - A certificate that encapsulates
|
|
* a GUID-specific signature
|
|
*
|
|
* @hdr: Windows certificate header, cf. WIN_CERTIFICATE
|
|
* @cert_type: Certificate type
|
|
*/
|
|
struct win_certificate_uefi_guid {
|
|
struct {
|
|
uint32_t dwLength;
|
|
uint16_t wRevision;
|
|
uint16_t wCertificateType;
|
|
} hdr;
|
|
efi_guid_t cert_type;
|
|
} __packed;
|
|
|
|
/**
|
|
* efi_firmware_image_authentication - Capsule authentication method
|
|
* descriptor
|
|
*
|
|
* This structure describes an authentication information for
|
|
* a capsule with IMAGE_ATTRIBUTE_AUTHENTICATION_REQUIRED set
|
|
* and should be included as part of the capsule.
|
|
* Only EFI_CERT_TYPE_PKCS7_GUID is accepted.
|
|
*
|
|
* @monotonic_count: Count to prevent replay
|
|
* @auth_info: Authentication info
|
|
*/
|
|
struct efi_firmware_image_authentication {
|
|
uint64_t monotonic_count;
|
|
struct win_certificate_uefi_guid auth_info;
|
|
} __packed;
|
|
|
|
/* fmp payload header */
|
|
#define SIGNATURE_16(A, B) ((A) | ((B) << 8))
|
|
#define SIGNATURE_32(A, B, C, D) \
|
|
(SIGNATURE_16(A, B) | (SIGNATURE_16(C, D) << 16))
|
|
|
|
#define FMP_PAYLOAD_HDR_SIGNATURE SIGNATURE_32('M', 'S', 'S', '1')
|
|
|
|
/**
|
|
* struct fmp_payload_header - EDK2 header for the FMP payload
|
|
*
|
|
* This structure describes the header which is preprended to the
|
|
* FMP payload by the edk2 capsule generation scripts.
|
|
*
|
|
* @signature: Header signature used to identify the header
|
|
* @header_size: Size of the structure
|
|
* @fw_version: Firmware versions used
|
|
* @lowest_supported_version: Lowest supported version (not used)
|
|
*/
|
|
struct fmp_payload_header {
|
|
uint32_t signature;
|
|
uint32_t header_size;
|
|
uint32_t fw_version;
|
|
uint32_t lowest_supported_version;
|
|
};
|
|
|
|
struct fmp_payload_header_params {
|
|
bool have_header;
|
|
uint32_t fw_version;
|
|
};
|
|
|
|
#endif /* _EFI_CAPSULE_H */
|