/** Get Local Token Number by Token Number. @param[in] Database PCD database. @param[in] TokenNumber The PCD token number. @return Local Token Number. **/ UINT32 GetLocalTokenNumber ( IN PEI_PCD_DATABASE *Database, IN UINTN TokenNumber ) { UINT32 LocalTokenNumber; UINTN Size; UINTN MaxSize; // // TokenNumber Zero is reserved as PCD_INVALID_TOKEN_NUMBER. // We have to decrement TokenNumber by 1 to make it usable // as the array index. // TokenNumber--; LocalTokenNumber = *((UINT32 *)((UINT8 *)Database + Database->LocalTokenNumberTableOffset) + TokenNumber); Size = (LocalTokenNumber & PCD_DATUM_TYPE_ALL_SET) >> PCD_DATUM_TYPE_SHIFT; if ((LocalTokenNumber & PCD_TYPE_SKU_ENABLED) == PCD_TYPE_SKU_ENABLED) { if (Size == 0) { GetPtrTypeSize (TokenNumber, &MaxSize, Database); } else { MaxSize = Size; } LocalTokenNumber = GetSkuEnabledTokenNumber (LocalTokenNumber & ~PCD_TYPE_SKU_ENABLED, MaxSize); } return LocalTokenNumber; }
/** Get the PCD entry pointer in PCD database. This routine will visit PCD database to find the PCD entry according to given token number. The given token number is autogened by build tools and it will be translated to local token number. Local token number contains PCD's type and offset of PCD entry in PCD database. @param TokenNumber Token's number, it is autogened by build tools @param GetSize The size of token's value @return PCD entry pointer in PCD database **/ VOID * GetWorker ( IN UINTN TokenNumber, IN UINTN GetSize ) { UINT32 Offset; EFI_GUID *Guid; UINT16 *Name; VARIABLE_HEAD *VariableHead; EFI_STATUS Status; UINTN DataSize; VOID *Data; UINT8 *StringTable; UINT16 StringTableIdx; PEI_PCD_DATABASE *PeiPcdDb; UINT32 LocalTokenNumber; UINTN MaxSize; // // TokenNumber Zero is reserved as PCD_INVALID_TOKEN_NUMBER. // We have to decrement TokenNumber by 1 to make it usable // as the array index. // TokenNumber--; // EBC compiler is very choosy. It may report warning about comparison // between UINTN and 0 . So we add 1 in each size of the // comparison. ASSERT (TokenNumber + 1 < PEI_LOCAL_TOKEN_NUMBER + 1); ASSERT ((GetSize == PeiPcdGetSize(TokenNumber + 1)) || (GetSize == 0)); PeiPcdDb = GetPcdDatabase (); LocalTokenNumber = PeiPcdDb->Init.LocalTokenNumberTable[TokenNumber]; if ((LocalTokenNumber & PCD_TYPE_SKU_ENABLED) == PCD_TYPE_SKU_ENABLED) { if (GetSize == 0) { MaxSize = GetPtrTypeSize (TokenNumber, &MaxSize, PeiPcdDb); } else { MaxSize = GetSize; } LocalTokenNumber = GetSkuEnabledTokenNumber (LocalTokenNumber & ~PCD_TYPE_SKU_ENABLED, MaxSize); } Offset = LocalTokenNumber & PCD_DATABASE_OFFSET_MASK; StringTable = PeiPcdDb->Init.StringTable; switch (LocalTokenNumber & PCD_TYPE_ALL_SET) { case PCD_TYPE_VPD: { VPD_HEAD *VpdHead; VpdHead = (VPD_HEAD *) ((UINT8 *)PeiPcdDb + Offset); return (VOID *) (UINTN) (PcdGet32 (PcdVpdBaseAddress) + VpdHead->Offset); } case PCD_TYPE_HII|PCD_TYPE_STRING: case PCD_TYPE_HII: { VariableHead = (VARIABLE_HEAD *) ((UINT8 *)PeiPcdDb + Offset); Guid = &(PeiPcdDb->Init.GuidTable[VariableHead->GuidTableIndex]); Name = (UINT16*)&StringTable[VariableHead->StringIndex]; Status = GetHiiVariable (Guid, Name, &Data, &DataSize); if (Status == EFI_SUCCESS) { return (VOID *) ((UINT8 *) Data + VariableHead->Offset); } else { // // Return the default value specified by Platform Integrator // if ((LocalTokenNumber & PCD_TYPE_ALL_SET) == (PCD_TYPE_HII|PCD_TYPE_STRING)) { return (VOID*)&StringTable[*(UINT16*)((UINT8*)PeiPcdDb + VariableHead->DefaultValueOffset)]; } else { return (VOID *) ((UINT8 *) PeiPcdDb + VariableHead->DefaultValueOffset); } } } case PCD_TYPE_DATA: return (VOID *) ((UINT8 *)PeiPcdDb + Offset); case PCD_TYPE_STRING: StringTableIdx = * (UINT16*) ((UINT8 *) PeiPcdDb + Offset); return (VOID *) (&StringTable[StringTableIdx]); default: ASSERT (FALSE); break; } ASSERT (FALSE); return NULL; }
/** Set value for an PCD entry @param TokenNumber Pcd token number autogenerated by build tools. @param Data Value want to be set for PCD entry @param Size Size of value. @param PtrType If TRUE, the type of PCD entry's value is Pointer. If False, the type of PCD entry's value is not Pointer. @retval EFI_INVALID_PARAMETER If this PCD type is VPD, VPD PCD can not be set. @retval EFI_INVALID_PARAMETER If Size can not be set to size table. @retval EFI_INVALID_PARAMETER If Size of non-Ptr type PCD does not match the size information in PCD database. @retval EFI_NOT_FOUND If value type of PCD entry is intergrate, but not in range of UINT8, UINT16, UINT32, UINT64 @retval EFI_NOT_FOUND Can not find the PCD type according to token number. **/ EFI_STATUS SetWorker ( IN UINTN TokenNumber, IN VOID *Data, IN OUT UINTN *Size, IN BOOLEAN PtrType ) { UINT32 LocalTokenNumber; PEI_PCD_DATABASE *PeiPcdDb; UINT16 StringTableIdx; UINTN Offset; VOID *InternalData; UINTN MaxSize; if (!FeaturePcdGet(PcdPeiFullPcdDatabaseEnable)) { return EFI_UNSUPPORTED; } // // TokenNumber Zero is reserved as PCD_INVALID_TOKEN_NUMBER. // We have to decrement TokenNumber by 1 to make it usable // as the array index. // TokenNumber--; // EBC compiler is very choosy. It may report warning about comparison // between UINTN and 0 . So we add 1 in each size of the // comparison. ASSERT (TokenNumber + 1 < PEI_LOCAL_TOKEN_NUMBER + 1); PeiPcdDb = GetPcdDatabase (); LocalTokenNumber = PeiPcdDb->Init.LocalTokenNumberTable[TokenNumber]; if ((!PtrType) && (PeiPcdGetSize(TokenNumber + 1) != *Size)) { return EFI_INVALID_PARAMETER; } // // We only invoke the callback function for Dynamic Type PCD Entry. // For Dynamic EX PCD entry, we have invoked the callback function for Dynamic EX // type PCD entry in ExSetWorker. // if (TokenNumber + 1 < PEI_NEX_TOKEN_NUMBER + 1) { InvokeCallbackOnSet (0, NULL, TokenNumber + 1, Data, *Size); } if ((LocalTokenNumber & PCD_TYPE_SKU_ENABLED) == PCD_TYPE_SKU_ENABLED) { if (PtrType) { MaxSize = GetPtrTypeSize (TokenNumber, &MaxSize, PeiPcdDb); } else { MaxSize = *Size; } LocalTokenNumber = GetSkuEnabledTokenNumber (LocalTokenNumber & ~PCD_TYPE_SKU_ENABLED, MaxSize); } Offset = LocalTokenNumber & PCD_DATABASE_OFFSET_MASK; InternalData = (VOID *) ((UINT8 *) PeiPcdDb + Offset); switch (LocalTokenNumber & PCD_TYPE_ALL_SET) { case PCD_TYPE_VPD: case PCD_TYPE_HII: case PCD_TYPE_HII|PCD_TYPE_STRING: { ASSERT (FALSE); return EFI_INVALID_PARAMETER; } case PCD_TYPE_STRING: if (SetPtrTypeSize (TokenNumber, Size, PeiPcdDb)) { StringTableIdx = *((UINT16 *)InternalData); CopyMem (&PeiPcdDb->Init.StringTable[StringTableIdx], Data, *Size); return EFI_SUCCESS; } else { return EFI_INVALID_PARAMETER; } case PCD_TYPE_DATA: { if (PtrType) { if (SetPtrTypeSize (TokenNumber, Size, PeiPcdDb)) { CopyMem (InternalData, Data, *Size); return EFI_SUCCESS; } else { return EFI_INVALID_PARAMETER; } } switch (*Size) { case sizeof(UINT8): *((UINT8 *) InternalData) = *((UINT8 *) Data); return EFI_SUCCESS; case sizeof(UINT16): *((UINT16 *) InternalData) = *((UINT16 *) Data); return EFI_SUCCESS; case sizeof(UINT32): *((UINT32 *) InternalData) = *((UINT32 *) Data); return EFI_SUCCESS; case sizeof(UINT64): *((UINT64 *) InternalData) = *((UINT64 *) Data); return EFI_SUCCESS; default: ASSERT (FALSE); return EFI_NOT_FOUND; } } } ASSERT (FALSE); return EFI_NOT_FOUND; }