PeiRegisterCpuFeaturesLib.c File Reference

#include <PiPei.h>
#include <Library/HobLib.h>
#include <Library/PeiServicesLib.h>
#include <Library/PeiServicesTablePointerLib.h>
#include <Ppi/MpServices2.h>
#include "RegisterCpuFeatures.h"

Go to the source code of this file.

Macros
#define	REGISTER_CPU_FEATURES_GUID

Functions
CPU_FEATURES_DATA *	GetCpuFeaturesData (VOID)
MP_SERVICES	GetMpService (VOID)
UINTN	GetProcessorIndex (IN CPU_FEATURES_DATA *CpuFeaturesData)
EFI_STATUS	GetProcessorInformation (IN UINTN ProcessorNumber, OUT EFI_PROCESSOR_INFORMATION *ProcessorInfoBuffer)
VOID	StartupAllAPsWorker (IN EFI_AP_PROCEDURE Procedure, IN EFI_EVENT MpEvent)
VOID	StartupAllCPUsWorker (IN EFI_AP_PROCEDURE Procedure)
VOID	SwitchNewBsp (IN UINTN ProcessorNumber)
VOID	GetNumberOfProcessor (OUT UINTN *NumberOfCpus, OUT UINTN *NumberOfEnabledProcessors)
VOID EFIAPI	CpuFeaturesInitialize (VOID)

Variables
EFI_GUID	mRegisterCpuFeaturesHobGuid = REGISTER_CPU_FEATURES_GUID

Detailed Description

CPU Register Table Library functions.

Copyright (c) 2016 - 2024, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent

Definition in file PeiRegisterCpuFeaturesLib.c.

Macro Definition Documentation

REGISTER_CPU_FEATURES_GUID

#define REGISTER_CPU_FEATURES_GUID

Value:

  { \
    0xa694c467, 0x697a, 0x446b, { 0xb9, 0x29, 0x5b, 0x14, 0xa0, 0xcf, 0x39, 0xf } \
  }

Definition at line 18 of file PeiRegisterCpuFeaturesLib.c.

Function Documentation

CpuFeaturesInitialize()

VOID EFIAPI CpuFeaturesInitialize

(

VOID

)

Performs CPU features Initialization.

This service will invoke MP service to perform CPU features initialization on BSP/APs per user configuration.

Note

This service could be called by BSP only.

Definition at line 285 of file PeiRegisterCpuFeaturesLib.c.

GetCpuFeaturesData()

CPU_FEATURES_DATA * GetCpuFeaturesData

(

VOID

)

Worker function to get CPU_FEATURES_DATA pointer.

Returns

Pointer to CPU_FEATURES_DATA.

Definition at line 31 of file PeiRegisterCpuFeaturesLib.c.

GetMpService()

MP_SERVICES GetMpService

(

VOID

)

Worker function to get MP PPI service pointer.

Returns

MP_SERVICES variable.

Definition at line 69 of file PeiRegisterCpuFeaturesLib.c.

GetNumberOfProcessor()

VOID GetNumberOfProcessor	(	OUT UINTN *	NumberOfCpus,
		OUT UINTN *	NumberOfEnabledProcessors
	)

Worker function to retrieve the number of logical processor in the platform.

Parameters

[out]	NumberOfCpus	Pointer to the total number of logical processors in the system, including the BSP and disabled APs.
[out]	NumberOfEnabledProcessors	Pointer to the number of enabled logical processors that exist in system, including the BSP.

Definition at line 252 of file PeiRegisterCpuFeaturesLib.c.

GetProcessorIndex()

UINTN GetProcessorIndex

(

IN CPU_FEATURES_DATA *

CpuFeaturesData

)

Worker function to return processor index.

Parameters

CpuFeaturesData

Cpu Feature Data structure.

Returns

The processor index.

Definition at line 97 of file PeiRegisterCpuFeaturesLib.c.

GetProcessorInformation()

EFI_STATUS GetProcessorInformation	(	IN UINTN	ProcessorNumber,
		OUT EFI_PROCESSOR_INFORMATION *	ProcessorInfoBuffer
	)

Worker function to MP-related information on the requested processor at the instant this call is made.

Parameters

[in]	ProcessorNumber	The handle number of processor.
[out]	ProcessorInfoBuffer	A pointer to the buffer where information for the requested processor is deposited.

Returns

Status of MpServices->GetProcessorInfo().

Definition at line 128 of file PeiRegisterCpuFeaturesLib.c.

StartupAllAPsWorker()

VOID StartupAllAPsWorker	(	IN EFI_AP_PROCEDURE	Procedure,
		IN EFI_EVENT	MpEvent
	)

Worker function to execute a caller provided function on all enabled APs.

Parameters

[in]	Procedure	A pointer to the function to be run on enabled APs of the system.
[in]	MpEvent	The Event used to sync the result.

Definition at line 157 of file PeiRegisterCpuFeaturesLib.c.

StartupAllCPUsWorker()

VOID StartupAllCPUsWorker

(

IN EFI_AP_PROCEDURE

Procedure

)

Worker function to execute a caller provided function on all enabled CPUs.

Parameters

[in]

Procedure

A pointer to the function to be run on enabled CPUs of the system.

Definition at line 190 of file PeiRegisterCpuFeaturesLib.c.

SwitchNewBsp()

VOID SwitchNewBsp

(

IN UINTN

ProcessorNumber

)

Worker function to switch the requested AP to be the BSP from that point onward.

Parameters

[in]

ProcessorNumber

The handle number of AP that is to become the new BSP.

Definition at line 219 of file PeiRegisterCpuFeaturesLib.c.

Variable Documentation

mRegisterCpuFeaturesHobGuid

EFI_GUID mRegisterCpuFeaturesHobGuid = REGISTER_CPU_FEATURES_GUID

Definition at line 23 of file PeiRegisterCpuFeaturesLib.c.