blob: 2f302bb5b18c2aec4d07872ba5ace650f320bfa5 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
|
/** @file
MM Platform HOB Producer Library Class.
CreateMmPlatformHob() function is called by StandaloneMm IPL to create all
Platform specific HOBs that required by Standalone MM environment.
Copyright (c) 2024, Intel Corporation. All rights reserved.<BR>
SPDX-License-Identifier: BSD-2-Clause-Patent
**/
#ifndef MM_PLATFORM_HOB_PRODUCER_LIB_H_
#define MM_PLATFORM_HOB_PRODUCER_LIB_H_
/**
Create the platform specific HOBs needed by the Standalone MM environment.
The following HOBs are created by StandaloneMm IPL common logic
hence they should NOT be created by this function:
* Single EFI_HOB_TYPE_FV to describe the Firmware Volume where MM Core resides.
* Single GUIDed (gEfiSmmSmramMemoryGuid) HOB to describe the MM regions.
* Single EFI_HOB_MEMORY_ALLOCATION_MODULE to describe the MM region used by MM Core.
* Multiple EFI_HOB_RESOURCE_DESCRIPTOR to describe the non-MM regions and their access permissions.
Note: All accessible non-MM regions should be described by EFI_HOB_RESOURCE_DESCRIPTOR HOBs.
* Single GUIDed (gMmCommBufferHobGuid) HOB to identify MM Communication buffer in non-MM region.
* Multiple GUIDed (gSmmBaseHobGuid) HOB to describe the SMM base address of each processor.
* Multiple GUIDed (gMpInformation2HobGuid) HOB to describe the MP information.
* Single GUIDed (gMmCpuSyncConfigHobGuid) HOB to describe how BSP synchronizes with APs in x86 SMM.
* Single GUIDed (gMmAcpiS3EnableHobGuid) HOB to describe the ACPI S3 enable status.
* Single GUIDed (gEfiAcpiVariableGuid) HOB to identify the S3 data root region in x86.
* Single GUIDed (gMmProfileDataHobGuid) HOB to describe the MM profile data region.
@param[in] Buffer The free buffer to be used for HOB creation.
@param[in, out] BufferSize The buffer size.
On return, the expected/used size.
@retval RETURN_INVALID_PARAMETER BufferSize is NULL.
@retval RETURN_INVALID_PARAMETER Buffer is NULL and BufferSize is not 0.
@retval RETURN_BUFFER_TOO_SMALL The buffer is too small for HOB creation.
BufferSize is updated to indicate the expected buffer size.
When the input BufferSize is bigger than the expected buffer size,
the BufferSize value will be changed to the used buffer size.
@retval RETURN_SUCCESS The HOB list is created successfully.
**/
EFI_STATUS
EFIAPI
CreateMmPlatformHob (
IN VOID *Buffer,
IN OUT UINTN *BufferSize
);
#endif
|
