EDK II Module Writer's Guide
Search…
8.5 Communication with PEIMs
This section introduces communication channels between DXE driver and PEIM, including HOB, variable, and PCD.
8.5.1 HOB
A HOB is a one-way channel to pass data from PEI to DXE. The HOB list is provided during the PEI phase, and must be treated as a read-only data structure in the DXE phase. It conveys the state of the system at the time the DXE Foundation is started. The DXE drivers must not modify the contents of the HOB list.
HobLib provides a set of APIs to build and parse a HOB list. Since DXE drivers only read the HOB list, module writers of DXE drivers can focus on the APIs to parse HOB list.
Several typical usage types are shown in examples below:
8.5.1.1 Traversing all HOBs in the HOB list
1
EFI_HOB_GENERIC_HEADER *Hob;
2
UINT16 HobType;
3
UINT16 HobLength;
4
for (Hob = GetHobList();
5
!END_OF_HOB_LIST (Hob); Hob = GET_NEXT_HOB (Hob))
6
{
7
HobType = GET_HOB_TYPE (Hob);
8
HobLength = GET_HOB_LENGTH (Hob);
9
//
10
// Further operation on the HOB can be added
11
//
12
}
Copied!
8.5.1.2 Retrieving only the first HOB of a specific type in the HOB list
1
(CPU HOB type example)
2
EFI_HOB_CPU *CpuHob;
3
CpuHob = GetFirstHob (EFI_HOB_TYPE_CPU);
4
if (CpuHob != NULL) //
5
{
6
// Operation on the HOB can be added here.
7
//
8
}
Copied!
8.5.1.3 Traversing specific types of HOBs in the HOB list (CPU HOB type example)
1
EFI_HOB_CPU *Hob;
2
Hob = GetHobList ();
3
while ((Hob = GetNextHob (EFI_HOB_TYPE_CPU, Hob)) != NULL) //
4
{
5
// Operation on the HOB can be added here.
6
//
7
// At the end of loop, GET_NEXT_HOB must be added here.
8
// GetNextHob (
9
HobType, HobStart) does not skip the HOB passed by
10
// parameter HobStart. It returns HobStart back if HobStart itself
11
// meets the requirement. So it is required to use GET_NEXT_HOB() to
12
// skip current HOB. Otherwise, it would be in dead loop.
13
//
14
Hob = GET_NEXT_HOB (Hob
15
);
16
}
Copied!
8.5.1.4 Retrieving only the first GUIDed HOB with a specific GUID in the HOB list
1
EFI_HOB_GENERIC_HEADER *Hob;
2
VOID *HobData;
3
UINTN HobDataSize;
4
Hob = GetFirstGuidHob (&gAbcGuid);
5
if (Hob != NULL)
6
{
7
HobData = GET_GUID_HOB_DATA (Hob);
8
HobDataSize = GET_GUID_HOB_DATA_SIZE (Hob);
9
//
10
// Operation on the HOB can be added here.
11
//
12
}
Copied!
8.5.1.5 Traversing GUIDed HOBs with a specific GUID in the HOB list
1
EFI_HOB_GENERIC_HEADER *Hob;
2
VOID *HobData;
3
UINTN HobDataSize;
4
Hob = GetHobList ();
5
while ((Hob = GetNextGuidHob (&gAbcGuid, Hob)) != NULL)
6
{
7
HobData = GET_GUID_HOB_DATA (Hob);
8
HobDataSize = GET_GUID_HOB_DATA_SIZE (Hob);
9
//
10
// Operation on the HOB can be added here.
11
//
12
// At the end of loop, GET_NEXT_HOB must be added here.
13
// GetNextHob (
14
HobType, HobStart) does not skip the HOB passed by
15
// parameter HobStart. It returns HobStart back if HobStart itself
16
// meets the requirement. So it is required to use GET_NEXT_HOB() to
17
// skip current HOB. Otherwise, it would be in dead loop.
18
//
19
Hob = GET_NEXT_HOB (Hob
20
);
21
}
Copied!
8.5.2 Variable
A non-volatile variable can serve as a channel to pass data from DXE to PEI. Because only a DXE driver can write a variable, and PEIM can only read variables, this channel from DXE to PEI is also a one-way channel.
8.5.3 Dynamic PCD
A non-volatile dynamic PCD is also a high-level mechanism for communication between a DXE driver and a PEIM.
Please refer to in Appendix A.
Last modified 2yr ago
Copy link
Contents
8.5.1 HOB
8.5.1.1 Traversing all HOBs in the HOB list
8.5.1.2 Retrieving only the first HOB of a specific type in the HOB list
8.5.1.3 Traversing specific types of HOBs in the HOB list (CPU HOB type example)
8.5.1.4 Retrieving only the first GUIDed HOB with a specific GUID in the HOB list
8.5.1.5 Traversing GUIDed HOBs with a specific GUID in the HOB list
8.5.2 Variable
8.5.3 Dynamic PCD