mirror of
				https://github.com/acidanthera/audk.git
				synced 2025-10-31 11:13:53 +01:00 
			
		
		
		
	git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@10630 6f19259b-4bc3-4df7-8a09-765794883524
		
			
				
	
	
		
			128 lines
		
	
	
		
			4.7 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			128 lines
		
	
	
		
			4.7 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
| /** @file
 | |
|   PEI memory status code worker.
 | |
| 
 | |
|   Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved.<BR>
 | |
|   This program and the accompanying materials
 | |
|   are licensed and made available under the terms and conditions of the BSD License
 | |
|   which accompanies this distribution.  The full text of the license may be found at
 | |
|   http://opensource.org/licenses/bsd-license.php
 | |
| 
 | |
|   THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
 | |
|   WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 | |
| 
 | |
| **/
 | |
| 
 | |
| #include "StatusCodeHandlerPei.h"
 | |
| 
 | |
| /**
 | |
|   Create the first memory status code GUID'ed HOB as initialization for memory status code worker.
 | |
| 
 | |
|   @retval EFI_SUCCESS  The GUID'ed HOB is created successfully.
 | |
| 
 | |
| **/
 | |
| EFI_STATUS
 | |
| MemoryStatusCodeInitializeWorker (
 | |
|   VOID
 | |
|   )
 | |
| {
 | |
|   //
 | |
|   // Create memory status code GUID'ed HOB.
 | |
|   //
 | |
|   MEMORY_STATUSCODE_PACKET_HEADER *PacketHeader;
 | |
| 
 | |
|   //
 | |
|   // Build GUID'ed HOB with PCD defined size.
 | |
|   //
 | |
|   PacketHeader = BuildGuidHob (
 | |
|                    &gMemoryStatusCodeRecordGuid,
 | |
|                    PcdGet16 (PcdStatusCodeMemorySize) * 1024 + sizeof (MEMORY_STATUSCODE_PACKET_HEADER)
 | |
|                    );
 | |
|   ASSERT (PacketHeader != NULL);
 | |
| 
 | |
|   PacketHeader->MaxRecordsNumber = (PcdGet16 (PcdStatusCodeMemorySize) * 1024) / sizeof (MEMORY_STATUSCODE_RECORD);
 | |
|   PacketHeader->PacketIndex      = 0;
 | |
|   PacketHeader->RecordIndex      = 0;
 | |
| 
 | |
|   return EFI_SUCCESS;
 | |
| }
 | |
| 
 | |
| 
 | |
| /**
 | |
|   Report status code into GUID'ed HOB.
 | |
| 
 | |
|   This function reports status code into GUID'ed HOB. If not all packets are full, then
 | |
|   write status code into available entry. Otherwise, create a new packet for it.
 | |
| 
 | |
|   @param  PeiServices      An indirect pointer to the EFI_PEI_SERVICES table published by the PEI Foundation.
 | |
|   @param  CodeType         Indicates the type of status code being reported.
 | |
|   @param  Value            Describes the current status of a hardware or
 | |
|                            software entity. This includes information about the class and
 | |
|                            subclass that is used to classify the entity as well as an operation.
 | |
|                            For progress codes, the operation is the current activity.
 | |
|                            For error codes, it is the exception.For debug codes,it is not defined at this time.
 | |
|   @param  Instance         The enumeration of a hardware or software entity within
 | |
|                            the system. A system may contain multiple entities that match a class/subclass
 | |
|                            pairing. The instance differentiates between them. An instance of 0 indicates
 | |
|                            that instance information is unavailable, not meaningful, or not relevant.
 | |
|                            Valid instance numbers start with 1.
 | |
|   @param  CallerId         This optional parameter may be used to identify the caller.
 | |
|                            This parameter allows the status code driver to apply different rules to
 | |
|                            different callers.
 | |
|   @param  Data             This optional parameter may be used to pass additional data.
 | |
| 
 | |
|   @retval EFI_SUCCESS      The function always return EFI_SUCCESS.
 | |
| 
 | |
| **/
 | |
| EFI_STATUS
 | |
| EFIAPI
 | |
| MemoryStatusCodeReportWorker (
 | |
|   IN CONST  EFI_PEI_SERVICES    **PeiServices,
 | |
|   IN EFI_STATUS_CODE_TYPE       CodeType,
 | |
|   IN EFI_STATUS_CODE_VALUE      Value,
 | |
|   IN UINT32                     Instance,
 | |
|   IN CONST EFI_GUID             *CallerId,
 | |
|   IN CONST EFI_STATUS_CODE_DATA *Data OPTIONAL
 | |
|   )
 | |
| {
 | |
| 
 | |
|   EFI_PEI_HOB_POINTERS              Hob;
 | |
|   MEMORY_STATUSCODE_PACKET_HEADER   *PacketHeader;
 | |
|   MEMORY_STATUSCODE_RECORD          *Record;
 | |
| 
 | |
|   //
 | |
|   // Find GUID'ed HOBs to locate current record buffer. 
 | |
|   //
 | |
|   Hob.Raw = GetFirstGuidHob (&gMemoryStatusCodeRecordGuid);
 | |
|   ASSERT (Hob.Raw != NULL);
 | |
| 
 | |
|   PacketHeader = (MEMORY_STATUSCODE_PACKET_HEADER *) GET_GUID_HOB_DATA (Hob.Guid);
 | |
|   Record = (MEMORY_STATUSCODE_RECORD *) (PacketHeader + 1);
 | |
|   Record = &Record[PacketHeader->RecordIndex++];
 | |
| 
 | |
|   //
 | |
|   // Save status code.
 | |
|   //
 | |
|   Record->CodeType = CodeType;
 | |
|   Record->Instance = Instance;
 | |
|   Record->Value    = Value;
 | |
| 
 | |
|   //
 | |
|   // If record index equals to max record number, then wrap around record index to zero.
 | |
|   //
 | |
|   // The reader of status code should compare the number of records with max records number,
 | |
|   // If it is equal to or larger than the max number, then the wrap-around had happened,
 | |
|   // so the first record is pointed by record index.
 | |
|   // If it is less then max number, index of the first record is zero.
 | |
|   //
 | |
|   if (PacketHeader->RecordIndex == PacketHeader->MaxRecordsNumber) {
 | |
|     //
 | |
|     // Wrap around record index.
 | |
|     //
 | |
|     PacketHeader->RecordIndex = 0;
 | |
|     PacketHeader->PacketIndex ++;
 | |
|   }
 | |
| 
 | |
|   return EFI_SUCCESS;
 | |
| }
 | |
| 
 |