]> git.proxmox.com Git - mirror_edk2.git/blame_incremental - MdeModulePkg/Universal/PCD/Dxe/Service.c
All UEFI applications in the MdeModukePkg should be placed in MdeModulePkg/Application
[mirror_edk2.git] / MdeModulePkg / Universal / PCD / Dxe / Service.c
... / ...
CommitLineData
1/** @file\r
2 Help functions used by PCD DXE driver.\r
3\r
4Copyright (c) 2006 - 2007, Intel Corporation\r
5All rights reserved. This program and the accompanying materials\r
6are licensed and made available under the terms and conditions of the BSD License\r
7which accompanies this distribution. The full text of the license may be found at\r
8http://opensource.org/licenses/bsd-license.php\r
9\r
10THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
11WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
12\r
13**/\r
14\r
15#include "Service.h"\r
16\r
17PCD_DATABASE * mPcdDatabase;\r
18\r
19LIST_ENTRY *mCallbackFnTable;\r
20\r
21/**\r
22 Get the PCD entry pointer in PCD database.\r
23 \r
24 This routine will visit PCD database to find the PCD entry according to given\r
25 token number. The given token number is autogened by build tools and it will be \r
26 translated to local token number. Local token number contains PCD's type and \r
27 offset of PCD entry in PCD database.\r
28\r
29 @param TokenNumber Token's number, it is autogened by build tools\r
30 @param GetSize The size of token's value\r
31\r
32 @return PCD entry pointer in PCD database\r
33\r
34**/\r
35VOID *\r
36GetWorker (\r
37 IN UINTN TokenNumber,\r
38 IN UINTN GetSize\r
39 )\r
40{\r
41 UINT32 *LocalTokenNumberTable;\r
42 EFI_GUID *GuidTable;\r
43 UINT16 *StringTable;\r
44 EFI_GUID *Guid;\r
45 UINT16 *Name;\r
46 VARIABLE_HEAD *VariableHead;\r
47 UINT8 *VaraiableDefaultBuffer;\r
48 UINT8 *Data;\r
49 VPD_HEAD *VpdHead;\r
50 UINT8 *PcdDb;\r
51 VOID *RetPtr;\r
52 UINTN MaxSize;\r
53 UINTN TmpTokenNumber;\r
54 UINTN DataSize;\r
55 EFI_STATUS Status;\r
56 UINT32 LocalTokenNumber;\r
57 UINT32 Offset;\r
58 UINT16 StringTableIdx; \r
59 BOOLEAN IsPeiDb;\r
60\r
61 //\r
62 // Aquire lock to prevent reentrance from TPL_CALLBACK level\r
63 //\r
64 EfiAcquireLock (&mPcdDatabaseLock);\r
65\r
66 RetPtr = NULL;\r
67 //\r
68 // TokenNumber Zero is reserved as PCD_INVALID_TOKEN_NUMBER.\r
69 // We have to decrement TokenNumber by 1 to make it usable\r
70 // as the array index.\r
71 //\r
72 TokenNumber--;\r
73\r
74 TmpTokenNumber = TokenNumber;\r
75 \r
76 //\r
77 // PCD_TOTAL_TOKEN_NUMBER is a auto-generated constant.\r
78 // It could be zero. EBC compiler is very choosy. It may\r
79 // report warning. So we add 1 in each size of the \r
80 // comparison.\r
81 //\r
82 ASSERT (TokenNumber + 1 < PCD_TOTAL_TOKEN_NUMBER + 1);\r
83\r
84 ASSERT ((GetSize == DxePcdGetSize (TokenNumber + 1)) || (GetSize == 0));\r
85\r
86 // EBC compiler is very choosy. It may report warning about comparison\r
87 // between UINTN and 0 . So we add 1 in each size of the \r
88 // comparison.\r
89 IsPeiDb = (BOOLEAN) ((TokenNumber + 1 < PEI_LOCAL_TOKEN_NUMBER + 1) ? TRUE : FALSE);\r
90\r
91 LocalTokenNumberTable = IsPeiDb ? mPcdDatabase->PeiDb.Init.LocalTokenNumberTable : \r
92 mPcdDatabase->DxeDb.Init.LocalTokenNumberTable;\r
93\r
94 TokenNumber = IsPeiDb ? TokenNumber :\r
95 TokenNumber - PEI_LOCAL_TOKEN_NUMBER;\r
96\r
97 LocalTokenNumber = LocalTokenNumberTable[TokenNumber];\r
98 \r
99 if ((LocalTokenNumber & PCD_TYPE_SKU_ENABLED) == PCD_TYPE_SKU_ENABLED) {\r
100 if (GetSize == 0) {\r
101 GetPtrTypeSize (TmpTokenNumber, &MaxSize);\r
102 } else {\r
103 MaxSize = GetSize;\r
104 }\r
105 LocalTokenNumber = GetSkuEnabledTokenNumber (LocalTokenNumber & ~PCD_TYPE_SKU_ENABLED, MaxSize, IsPeiDb);\r
106 }\r
107\r
108 PcdDb = IsPeiDb ? ((UINT8 *) &mPcdDatabase->PeiDb) : ((UINT8 *) &mPcdDatabase->DxeDb);\r
109 \r
110 if (IsPeiDb) {\r
111 StringTable = (UINT16 *) (&mPcdDatabase->PeiDb.Init.StringTable[0]);\r
112 } else {\r
113 StringTable = (UINT16 *) (&mPcdDatabase->DxeDb.Init.StringTable[0]);\r
114 }\r
115 \r
116 \r
117 Offset = LocalTokenNumber & PCD_DATABASE_OFFSET_MASK;\r
118 \r
119 switch (LocalTokenNumber & PCD_TYPE_ALL_SET) {\r
120 case PCD_TYPE_VPD:\r
121 VpdHead = (VPD_HEAD *) ((UINT8 *) PcdDb + Offset);\r
122 RetPtr = (VOID *) (UINTN) (FixedPcdGet32(PcdVpdBaseAddress) + VpdHead->Offset);\r
123 break;\r
124 \r
125 case PCD_TYPE_HII:\r
126 if (IsPeiDb) {\r
127 GuidTable = (EFI_GUID *) (&mPcdDatabase->PeiDb.Init.GuidTable[0]);\r
128 } else {\r
129 GuidTable = (EFI_GUID *) (&mPcdDatabase->DxeDb.Init.GuidTable[0]);\r
130 }\r
131 \r
132 VariableHead = (VARIABLE_HEAD *) (PcdDb + Offset);\r
133 \r
134 Guid = GuidTable + VariableHead->GuidTableIndex;\r
135 Name = StringTable + VariableHead->StringIndex;\r
136 VaraiableDefaultBuffer = (UINT8 *) PcdDb + VariableHead->DefaultValueOffset;\r
137\r
138 Status = GetHiiVariable (Guid, Name, &Data, &DataSize);\r
139 if (Status == EFI_SUCCESS) {\r
140 if (GetSize == 0) {\r
141 //\r
142 // It is a pointer type. So get the MaxSize reserved for\r
143 // this PCD entry.\r
144 //\r
145 GetPtrTypeSize (TmpTokenNumber, &GetSize);\r
146 }\r
147 CopyMem (VaraiableDefaultBuffer, Data + VariableHead->Offset, GetSize);\r
148 FreePool (Data);\r
149 }\r
150 //\r
151 // If the operation is successful, we copy the data\r
152 // to the default value buffer in the PCD Database.\r
153 // So that we can free the Data allocated in GetHiiVariable.\r
154 //\r
155 //\r
156 // If the operation is not successful, \r
157 // Return 1) either the default value specified by Platform Integrator \r
158 // 2) Or the value Set by a PCD set operation.\r
159 //\r
160 RetPtr = (VOID *) VaraiableDefaultBuffer;\r
161 break;\r
162\r
163 case PCD_TYPE_STRING:\r
164 StringTableIdx = (UINT16) *((UINT8 *) PcdDb + Offset);\r
165 RetPtr = (VOID *) (StringTable + StringTableIdx);\r
166 break;\r
167\r
168 case PCD_TYPE_DATA:\r
169 RetPtr = (VOID *) ((UINT8 *) PcdDb + Offset);\r
170 break;\r
171\r
172 default:\r
173 ASSERT (FALSE);\r
174 break;\r
175 \r
176 }\r
177\r
178 EfiReleaseLock (&mPcdDatabaseLock);\r
179 \r
180 return RetPtr;\r
181 \r
182}\r
183\r
184/**\r
185 Register the callback function for a PCD entry.\r
186\r
187 This routine will register a callback function to a PCD entry by given token number\r
188 and token space guid.\r
189 \r
190 @param TokenNumber PCD token's number, it is autogened by build tools.\r
191 @param Guid PCD token space's guid, \r
192 if not NULL, this PCD is dynamicEx type PCD.\r
193 @param CallBackFunction Callback function pointer\r
194\r
195 @return EFI_SUCCESS Always success for registering callback function.\r
196\r
197**/\r
198EFI_STATUS\r
199DxeRegisterCallBackWorker (\r
200 IN UINTN TokenNumber,\r
201 IN CONST EFI_GUID *Guid, OPTIONAL\r
202 IN PCD_PROTOCOL_CALLBACK CallBackFunction\r
203)\r
204{\r
205 CALLBACK_FN_ENTRY *FnTableEntry;\r
206 LIST_ENTRY *ListHead;\r
207 LIST_ENTRY *ListNode;\r
208\r
209 if (Guid != NULL) {\r
210 TokenNumber = GetExPcdTokenNumber (Guid, (UINT32) TokenNumber);\r
211 }\r
212\r
213 //\r
214 // TokenNumber Zero is reserved as PCD_INVALID_TOKEN_NUMBER.\r
215 // We have to decrement TokenNumber by 1 to make it usable\r
216 // as the array index.\r
217 //\r
218 TokenNumber--;\r
219\r
220 ListHead = &mCallbackFnTable[TokenNumber];\r
221 ListNode = GetFirstNode (ListHead);\r
222\r
223 while (ListNode != ListHead) {\r
224 FnTableEntry = CR_FNENTRY_FROM_LISTNODE(ListNode, CALLBACK_FN_ENTRY, Node);\r
225\r
226 if (FnTableEntry->CallbackFn == CallBackFunction) {\r
227 //\r
228 // We only allow a Callback function to be register once\r
229 // for a TokenNumber. So just return EFI_SUCCESS\r
230 //\r
231 return EFI_SUCCESS;\r
232 }\r
233 ListNode = GetNextNode (ListHead, ListNode);\r
234 }\r
235\r
236 FnTableEntry = AllocatePool (sizeof(CALLBACK_FN_ENTRY));\r
237 ASSERT (FnTableEntry != NULL);\r
238\r
239 FnTableEntry->CallbackFn = CallBackFunction;\r
240 InsertTailList (ListHead, &FnTableEntry->Node);\r
241 \r
242 return EFI_SUCCESS;\r
243}\r
244\r
245/**\r
246 UnRegister the callback function for a PCD entry.\r
247\r
248 This routine will unregister a callback function to a PCD entry by given token number\r
249 and token space guid.\r
250\r
251 @param TokenNumber PCD token's number, it is autogened by build tools.\r
252 @param Guid PCD token space's guid.\r
253 if not NULL, this PCD is dynamicEx type PCD.\r
254 @param CallBackFunction Callback function pointer\r
255\r
256 @retval EFI_SUCCESS Callback function is success to be unregister.\r
257 @retval EFI_INVALID_PARAMETER Can not find the PCD entry by given token number.\r
258**/\r
259EFI_STATUS\r
260DxeUnRegisterCallBackWorker (\r
261 IN UINTN TokenNumber,\r
262 IN CONST EFI_GUID *Guid, OPTIONAL\r
263 IN PCD_PROTOCOL_CALLBACK CallBackFunction\r
264)\r
265{\r
266 CALLBACK_FN_ENTRY *FnTableEntry;\r
267 LIST_ENTRY *ListHead;\r
268 LIST_ENTRY *ListNode;\r
269\r
270 if (Guid != NULL) {\r
271 TokenNumber = GetExPcdTokenNumber (Guid, (UINT32) TokenNumber);\r
272 }\r
273\r
274 //\r
275 // TokenNumber Zero is reserved as PCD_INVALID_TOKEN_NUMBER.\r
276 // We have to decrement TokenNumber by 1 to make it usable\r
277 // as the array index.\r
278 //\r
279 TokenNumber--;\r
280\r
281 ListHead = &mCallbackFnTable[TokenNumber];\r
282 ListNode = GetFirstNode (ListHead);\r
283\r
284 while (ListNode != ListHead) {\r
285 FnTableEntry = CR_FNENTRY_FROM_LISTNODE(ListNode, CALLBACK_FN_ENTRY, Node);\r
286\r
287 if (FnTableEntry->CallbackFn == CallBackFunction) {\r
288 //\r
289 // We only allow a Callback function to be register once\r
290 // for a TokenNumber. So we can safely remove the Node from\r
291 // the Link List and return EFI_SUCCESS.\r
292 //\r
293 RemoveEntryList (ListNode);\r
294 FreePool (FnTableEntry);\r
295 \r
296 return EFI_SUCCESS;\r
297 }\r
298 ListNode = GetNextNode (ListHead, ListNode);\r
299 }\r
300\r
301 return EFI_INVALID_PARAMETER;\r
302}\r
303\r
304/**\r
305 Get next token number in given token space.\r
306 \r
307 This routine is used for dynamicEx type PCD. It will firstly scan token space\r
308 table to get token space according to given token space guid. Then scan given \r
309 token number in found token space, if found, then return next token number in \r
310 this token space.\r
311\r
312 @param Guid Token space guid. Next token number will be scaned in \r
313 this token space.\r
314 @param TokenNumber Token number. \r
315 If PCD_INVALID_TOKEN_NUMBER, return first token number in \r
316 token space table.\r
317 If not PCD_INVALID_TOKEN_NUMBER, return next token number\r
318 in token space table.\r
319 @param GuidTable Token space guid table. It will be used for scan token space\r
320 by given token space guid.\r
321 @param SizeOfGuidTable The size of guid table.\r
322 @param ExMapTable DynamicEx token number mapping table.\r
323 @param SizeOfExMapTable The size of dynamicEx token number mapping table.\r
324\r
325 @retval EFI_NOT_FOUND Can not given token space or token number.\r
326 @retval EFI_SUCCESS Success to get next token number.\r
327\r
328**/\r
329EFI_STATUS\r
330ExGetNextTokeNumber (\r
331 IN CONST EFI_GUID *Guid,\r
332 IN OUT UINTN *TokenNumber,\r
333 IN EFI_GUID *GuidTable,\r
334 IN UINTN SizeOfGuidTable,\r
335 IN DYNAMICEX_MAPPING *ExMapTable,\r
336 IN UINTN SizeOfExMapTable\r
337 )\r
338{\r
339 EFI_GUID *MatchGuid;\r
340 UINTN Index;\r
341 UINTN GuidTableIdx;\r
342 BOOLEAN Found;\r
343\r
344 //\r
345 // Scan token space guid \r
346 // \r
347 MatchGuid = ScanGuid (GuidTable, SizeOfGuidTable, Guid);\r
348 if (MatchGuid == NULL) {\r
349 return EFI_NOT_FOUND;\r
350 }\r
351\r
352 //\r
353 // Find the token space table in dynamicEx mapping table.\r
354 //\r
355 Found = FALSE;\r
356 GuidTableIdx = MatchGuid - GuidTable;\r
357 for (Index = 0; Index < SizeOfExMapTable; Index++) {\r
358 if (ExMapTable[Index].ExGuidIndex == GuidTableIdx) {\r
359 Found = TRUE;\r
360 break;\r
361 }\r
362 }\r
363\r
364 if (Found) {\r
365 //\r
366 // If given token number is PCD_INVALID_TOKEN_NUMBER, then return the first\r
367 // token number in found token space.\r
368 //\r
369 if (*TokenNumber == PCD_INVALID_TOKEN_NUMBER) {\r
370 *TokenNumber = ExMapTable[Index].ExTokenNumber;\r
371 return EFI_SUCCESS;\r
372 }\r
373\r
374 for ( ; Index < SizeOfExMapTable; Index++) {\r
375 if (ExMapTable[Index].ExTokenNumber == *TokenNumber) {\r
376 Index ++;\r
377 if (Index == SizeOfExMapTable) {\r
378 //\r
379 // Exceed the length of ExMap Table\r
380 //\r
381 *TokenNumber = PCD_INVALID_TOKEN_NUMBER;\r
382 return EFI_SUCCESS;\r
383 } else if (ExMapTable[Index].ExGuidIndex == GuidTableIdx) {\r
384 //\r
385 // Found the next match\r
386 //\r
387 *TokenNumber = ExMapTable[Index].ExTokenNumber;\r
388 return EFI_SUCCESS;\r
389 } else {\r
390 //\r
391 // Guid has been changed. It is the next Token Space Guid.\r
392 // We should flag no more TokenNumber.\r
393 //\r
394 *TokenNumber = PCD_INVALID_TOKEN_NUMBER;\r
395 return EFI_SUCCESS;\r
396 }\r
397 }\r
398 }\r
399 }\r
400 \r
401 return EFI_NOT_FOUND;\r
402}\r
403\r
404\r
405/**\r
406 Initialize the PCD database in DXE phase.\r
407 \r
408 PCD database in DXE phase also contains PCD database in PEI phase which is copied\r
409 from GUID Hob.\r
410\r
411**/\r
412VOID\r
413BuildPcdDxeDataBase (\r
414 VOID\r
415 )\r
416{\r
417 PEI_PCD_DATABASE *PeiDatabase;\r
418 EFI_HOB_GUID_TYPE *GuidHob;\r
419 UINTN Index;\r
420\r
421 mPcdDatabase = AllocateZeroPool (sizeof(PCD_DATABASE));\r
422 ASSERT (mPcdDatabase != NULL);\r
423\r
424 GuidHob = GetFirstGuidHob (&gPcdDataBaseHobGuid);\r
425 if (GuidHob != NULL) {\r
426\r
427 //\r
428 // We will copy over the PEI phase's PCD Database.\r
429 // \r
430 // If no PEIMs use dynamic Pcd Entry, the Pcd Service PEIM\r
431 // should not be included at all. So the GuidHob could\r
432 // be NULL. If it is NULL, we just copy over the DXE Default\r
433 // Value to PCD Database.\r
434 //\r
435 \r
436 PeiDatabase = (PEI_PCD_DATABASE *) GET_GUID_HOB_DATA (GuidHob);\r
437 //\r
438 // Copy PCD Entries refereneced in PEI phase to PCD DATABASE\r
439 //\r
440 CopyMem (&mPcdDatabase->PeiDb, PeiDatabase, sizeof (PEI_PCD_DATABASE));\r
441 }\r
442\r
443 //\r
444 // Copy PCD Entries with default value to PCD DATABASE\r
445 //\r
446 CopyMem (&mPcdDatabase->DxeDb.Init, &gDXEPcdDbInit, sizeof(DXE_PCD_DATABASE_INIT));\r
447\r
448\r
449 //\r
450 // Initialized the Callback Function Table\r
451 //\r
452\r
453 mCallbackFnTable = AllocateZeroPool (PCD_TOTAL_TOKEN_NUMBER * sizeof (LIST_ENTRY));\r
454 ASSERT(mCallbackFnTable != NULL);\r
455 \r
456 // EBC compiler is very choosy. It may report warning about comparison\r
457 // between UINTN and 0 . So we add 1 in each size of the \r
458 // comparison.\r
459 for (Index = 0; Index + 1 < PCD_TOTAL_TOKEN_NUMBER + 1; Index++) {\r
460 InitializeListHead (&mCallbackFnTable[Index]);\r
461 }\r
462}\r
463\r
464/**\r
465 Get Variable which contains HII type PCD entry.\r
466\r
467 @param VariableGuid Variable's guid\r
468 @param VariableName Variable's unicode name string\r
469 @param VariableData Variable's data pointer, \r
470 @param VariableSize Variable's size.\r
471\r
472 @return the status of gRT->GetVariable\r
473**/\r
474EFI_STATUS\r
475GetHiiVariable (\r
476 IN EFI_GUID *VariableGuid,\r
477 IN UINT16 *VariableName,\r
478 OUT UINT8 **VariableData,\r
479 OUT UINTN *VariableSize\r
480 )\r
481{\r
482 UINTN Size;\r
483 EFI_STATUS Status;\r
484 UINT8 *Buffer;\r
485\r
486 Size = 0;\r
487 Buffer = NULL;\r
488 \r
489 //\r
490 // Firstly get the real size of HII variable\r
491 //\r
492 Status = gRT->GetVariable (\r
493 (UINT16 *)VariableName,\r
494 VariableGuid,\r
495 NULL,\r
496 &Size,\r
497 Buffer\r
498 );\r
499 \r
500 //\r
501 // Allocate buffer to hold whole variable data according to variable size.\r
502 //\r
503 if (Status == EFI_BUFFER_TOO_SMALL) {\r
504 Buffer = (UINT8 *) AllocatePool (Size);\r
505\r
506 ASSERT (Buffer != NULL);\r
507\r
508 Status = gRT->GetVariable (\r
509 VariableName,\r
510 VariableGuid,\r
511 NULL,\r
512 &Size,\r
513 Buffer\r
514 );\r
515\r
516 ASSERT (Status == EFI_SUCCESS);\r
517 *VariableData = Buffer;\r
518 *VariableSize = Size;\r
519 }\r
520\r
521 return Status;\r
522}\r
523\r
524/**\r
525 Find the local token number according to system SKU ID.\r
526\r
527 @param LocalTokenNumber PCD token number\r
528 @param Size The size of PCD entry.\r
529 @param IsPeiDb If TRUE, the PCD entry is initialized in PEI phase.\r
530 If False, the PCD entry is initialized in DXE phase.\r
531\r
532 @return Token number according to system SKU ID.\r
533\r
534**/\r
535UINT32\r
536GetSkuEnabledTokenNumber (\r
537 UINT32 LocalTokenNumber,\r
538 UINTN Size,\r
539 BOOLEAN IsPeiDb\r
540 ) \r
541{\r
542 SKU_HEAD *SkuHead;\r
543 SKU_ID *SkuIdTable;\r
544 INTN Index;\r
545 UINT8 *Value;\r
546 SKU_ID *PhaseSkuIdTable;\r
547 UINT8 *PcdDb;\r
548\r
549 ASSERT ((LocalTokenNumber & PCD_TYPE_SKU_ENABLED) == 0);\r
550\r
551 PcdDb = IsPeiDb ? (UINT8 *) &mPcdDatabase->PeiDb : (UINT8 *) &mPcdDatabase->DxeDb;\r
552\r
553 SkuHead = (SKU_HEAD *) (PcdDb + (LocalTokenNumber & PCD_DATABASE_OFFSET_MASK));\r
554 Value = (UINT8 *) (PcdDb + SkuHead->SkuDataStartOffset); \r
555\r
556 PhaseSkuIdTable = IsPeiDb ? mPcdDatabase->PeiDb.Init.SkuIdTable :\r
557 mPcdDatabase->DxeDb.Init.SkuIdTable;\r
558 \r
559 SkuIdTable = &PhaseSkuIdTable[SkuHead->SkuIdTableOffset];\r
560 \r
561 //\r
562 // Find the current system's SKU ID entry in SKU ID table.\r
563 //\r
564 for (Index = 0; Index < SkuIdTable[0]; Index++) {\r
565 if (mPcdDatabase->PeiDb.Init.SystemSkuId == SkuIdTable[Index + 1]) {\r
566 break;\r
567 }\r
568 }\r
569 ASSERT (Index < SkuIdTable[0]);\r
570\r
571 switch (LocalTokenNumber & PCD_TYPE_ALL_SET) {\r
572 case PCD_TYPE_VPD:\r
573 Value = (UINT8 *) &(((VPD_HEAD *) Value)[Index]);\r
574 return (UINT32) ((Value - PcdDb) | PCD_TYPE_VPD);\r
575\r
576 case PCD_TYPE_HII:\r
577 Value = (UINT8 *) &(((VARIABLE_HEAD *) Value)[Index]);\r
578 return (UINT32) ((Value - PcdDb) | PCD_TYPE_HII);\r
579\r
580 case PCD_TYPE_STRING:\r
581 Value = (UINT8 *) &(((STRING_HEAD *) Value)[Index]);\r
582 return (UINT32) ((Value - PcdDb) | PCD_TYPE_STRING);\r
583 \r
584 case PCD_TYPE_DATA:\r
585 Value += Size * Index;\r
586 return (UINT32) (Value - PcdDb);\r
587\r
588 default:\r
589 ASSERT (FALSE);\r
590 }\r
591\r
592 ASSERT (FALSE);\r
593\r
594 return 0;\r
595 \r
596}\r
597\r
598/**\r
599 Invoke the callback function when dynamic PCD entry was set, if this PCD entry \r
600 has registered callback function.\r
601\r
602 @param ExTokenNumber DynamicEx PCD's token number, if this PCD entry is dyanmicEx\r
603 type PCD.\r
604 @param Guid DynamicEx PCD's guid, if this PCD entry is dynamicEx type\r
605 PCD.\r
606 @param TokenNumber PCD token number generated by build tools.\r
607 @param Data Value want to be set for this PCD entry\r
608 @param Size The size of value\r
609\r
610**/\r
611VOID\r
612InvokeCallbackOnSet (\r
613 UINT32 ExTokenNumber,\r
614 CONST EFI_GUID *Guid, OPTIONAL\r
615 UINTN TokenNumber,\r
616 VOID *Data,\r
617 UINTN Size\r
618 )\r
619{\r
620 CALLBACK_FN_ENTRY *FnTableEntry;\r
621 LIST_ENTRY *ListHead;\r
622 LIST_ENTRY *ListNode;\r
623\r
624 //\r
625 // TokenNumber Zero is reserved as PCD_INVALID_TOKEN_NUMBER.\r
626 // We have to decrement TokenNumber by 1 to make it usable\r
627 // as the array index.\r
628 //\r
629 TokenNumber--;\r
630 \r
631 ListHead = &mCallbackFnTable[TokenNumber];\r
632 ListNode = GetFirstNode (ListHead);\r
633\r
634 while (ListNode != ListHead) {\r
635 FnTableEntry = CR_FNENTRY_FROM_LISTNODE(ListNode, CALLBACK_FN_ENTRY, Node);\r
636\r
637 FnTableEntry->CallbackFn(Guid, \r
638 (Guid == NULL) ? TokenNumber : ExTokenNumber,\r
639 Data,\r
640 Size);\r
641 \r
642 ListNode = GetNextNode (ListHead, ListNode);\r
643 }\r
644 \r
645 return;\r
646}\r
647\r
648\r
649/**\r
650 Wrapper function for setting non-pointer type value for a PCD entry.\r
651\r
652 @param TokenNumber Pcd token number autogenerated by build tools.\r
653 @param Data Value want to be set for PCD entry\r
654 @param Size Size of value.\r
655\r
656 @return status of SetWorker.\r
657\r
658**/\r
659EFI_STATUS\r
660SetValueWorker (\r
661 IN UINTN TokenNumber,\r
662 IN VOID *Data,\r
663 IN UINTN Size\r
664 )\r
665{\r
666 return SetWorker (TokenNumber, Data, &Size, FALSE);\r
667}\r
668\r
669\r
670/**\r
671 Set value for an PCD entry\r
672\r
673 @param TokenNumber Pcd token number autogenerated by build tools.\r
674 @param Data Value want to be set for PCD entry\r
675 @param Size Size of value.\r
676 @param PtrType If TRUE, the type of PCD entry's value is Pointer.\r
677 If False, the type of PCD entry's value is not Pointer.\r
678\r
679 @retval EFI_INVALID_PARAMETER If this PCD type is VPD, VPD PCD can not be set.\r
680 @retval EFI_INVALID_PARAMETER If Size can not be set to size table.\r
681 @retval EFI_NOT_FOUND If value type of PCD entry is intergrate, but not in\r
682 range of UINT8, UINT16, UINT32, UINT64\r
683 @retval EFI_NOT_FOUND Can not find the PCD type according to token number. \r
684**/\r
685EFI_STATUS\r
686SetWorker (\r
687 IN UINTN TokenNumber,\r
688 IN VOID *Data,\r
689 IN OUT UINTN *Size,\r
690 IN BOOLEAN PtrType\r
691 )\r
692{\r
693 UINT32 *LocalTokenNumberTable;\r
694 BOOLEAN IsPeiDb;\r
695 UINT32 LocalTokenNumber;\r
696 EFI_GUID *GuidTable;\r
697 UINT16 *StringTable;\r
698 EFI_GUID *Guid;\r
699 UINT16 *Name;\r
700 UINTN VariableOffset;\r
701 VOID *InternalData;\r
702 VARIABLE_HEAD *VariableHead;\r
703 UINTN Offset;\r
704 UINT8 *PcdDb;\r
705 EFI_STATUS Status;\r
706 UINTN MaxSize;\r
707 UINTN TmpTokenNumber;\r
708\r
709 //\r
710 // Aquire lock to prevent reentrance from TPL_CALLBACK level\r
711 //\r
712 EfiAcquireLock (&mPcdDatabaseLock);\r
713\r
714 //\r
715 // TokenNumber Zero is reserved as PCD_INVALID_TOKEN_NUMBER.\r
716 // We have to decrement TokenNumber by 1 to make it usable\r
717 // as the array index.\r
718 //\r
719 TokenNumber--;\r
720\r
721 TmpTokenNumber = TokenNumber;\r
722 \r
723 //\r
724 // EBC compiler is very choosy. It may report warning about comparison\r
725 // between UINTN and 0 . So we add 1 in each size of the \r
726 // comparison.\r
727 //\r
728 ASSERT (TokenNumber + 1 < PCD_TOTAL_TOKEN_NUMBER + 1);\r
729\r
730 if (!PtrType) {\r
731 ASSERT (*Size == DxePcdGetSize (TokenNumber + 1));\r
732 }\r
733 \r
734 //\r
735 // EBC compiler is very choosy. It may report warning about comparison\r
736 // between UINTN and 0 . So we add 1 in each size of the \r
737 // comparison.\r
738 //\r
739 IsPeiDb = (BOOLEAN) ((TokenNumber + 1 < PEI_LOCAL_TOKEN_NUMBER + 1) ? TRUE : FALSE);\r
740\r
741 LocalTokenNumberTable = IsPeiDb ? mPcdDatabase->PeiDb.Init.LocalTokenNumberTable : \r
742 mPcdDatabase->DxeDb.Init.LocalTokenNumberTable;\r
743\r
744 //\r
745 // EBC compiler is very choosy. It may report warning about comparison\r
746 // between UINTN and 0 . So we add 1 in each size of the \r
747 // comparison.\r
748 //\r
749 if ((TokenNumber + 1 < PEI_NEX_TOKEN_NUMBER + 1) ||\r
750 (TokenNumber + 1 >= PEI_LOCAL_TOKEN_NUMBER + 1 || TokenNumber + 1 < (PEI_LOCAL_TOKEN_NUMBER + DXE_NEX_TOKEN_NUMBER + 1))) {\r
751 InvokeCallbackOnSet (0, NULL, TokenNumber + 1, Data, *Size);\r
752 }\r
753\r
754 TokenNumber = IsPeiDb ? TokenNumber\r
755 : TokenNumber - PEI_LOCAL_TOKEN_NUMBER;\r
756\r
757 LocalTokenNumber = LocalTokenNumberTable[TokenNumber];\r
758 \r
759 if ((LocalTokenNumber & PCD_TYPE_SKU_ENABLED) == PCD_TYPE_SKU_ENABLED) {\r
760 if (PtrType) {\r
761 GetPtrTypeSize (TmpTokenNumber, &MaxSize);\r
762 } else {\r
763 MaxSize = *Size;\r
764 }\r
765 LocalTokenNumber = GetSkuEnabledTokenNumber (LocalTokenNumber & ~PCD_TYPE_SKU_ENABLED, MaxSize, IsPeiDb);\r
766 }\r
767\r
768 Offset = LocalTokenNumber & PCD_DATABASE_OFFSET_MASK;\r
769\r
770 PcdDb = IsPeiDb ? ((UINT8 *) &mPcdDatabase->PeiDb) : ((UINT8 *) &mPcdDatabase->DxeDb);\r
771\r
772 if (IsPeiDb) {\r
773 StringTable = (UINT16 *) (&mPcdDatabase->PeiDb.Init.StringTable[0]);\r
774 } else {\r
775 StringTable = (UINT16 *) (&mPcdDatabase->DxeDb.Init.StringTable[0]);\r
776 }\r
777\r
778 \r
779 InternalData = PcdDb + Offset;\r
780\r
781 switch (LocalTokenNumber & PCD_TYPE_ALL_SET) {\r
782 case PCD_TYPE_VPD:\r
783 ASSERT (FALSE);\r
784 Status = EFI_INVALID_PARAMETER;\r
785 break;\r
786 \r
787 case PCD_TYPE_STRING:\r
788 if (SetPtrTypeSize (TmpTokenNumber, Size)) {\r
789 CopyMem (StringTable + *((UINT16 *)InternalData), Data, *Size);\r
790 Status = EFI_SUCCESS;\r
791 } else {\r
792 Status = EFI_INVALID_PARAMETER;\r
793 }\r
794 break;\r
795\r
796 case PCD_TYPE_HII:\r
797 if (PtrType) {\r
798 if (!SetPtrTypeSize (TmpTokenNumber, Size)) {\r
799 Status = EFI_INVALID_PARAMETER;\r
800 break;\r
801 }\r
802 }\r
803 \r
804 if (IsPeiDb) {\r
805 GuidTable = (EFI_GUID *) (&mPcdDatabase->PeiDb.Init.GuidTable[0]);\r
806 } else {\r
807 GuidTable = (EFI_GUID *) (&mPcdDatabase->DxeDb.Init.GuidTable[0]);\r
808 }\r
809 \r
810 VariableHead = (VARIABLE_HEAD *) (PcdDb + Offset);\r
811 \r
812 Guid = GuidTable + VariableHead->GuidTableIndex;\r
813 Name = StringTable + VariableHead->StringIndex;\r
814 VariableOffset = VariableHead->Offset;\r
815\r
816 Status = SetHiiVariable (Guid, Name, Data, *Size, VariableOffset);\r
817\r
818 if (EFI_NOT_FOUND == Status) {\r
819 CopyMem (PcdDb + VariableHead->DefaultValueOffset, Data, *Size);\r
820 Status = EFI_SUCCESS;\r
821 } \r
822 break;\r
823 \r
824 case PCD_TYPE_DATA:\r
825 if (PtrType) {\r
826 if (SetPtrTypeSize (TmpTokenNumber, Size)) {\r
827 CopyMem (InternalData, Data, *Size);\r
828 Status = EFI_SUCCESS;\r
829 } else {\r
830 Status = EFI_INVALID_PARAMETER;\r
831 }\r
832 break;\r
833 }\r
834\r
835 Status = EFI_SUCCESS;\r
836 switch (*Size) {\r
837 case sizeof(UINT8):\r
838 *((UINT8 *) InternalData) = *((UINT8 *) Data);\r
839 break;\r
840\r
841 case sizeof(UINT16):\r
842 *((UINT16 *) InternalData) = *((UINT16 *) Data);\r
843 break;\r
844\r
845 case sizeof(UINT32):\r
846 *((UINT32 *) InternalData) = *((UINT32 *) Data);\r
847 break;\r
848\r
849 case sizeof(UINT64):\r
850 *((UINT64 *) InternalData) = *((UINT64 *) Data);\r
851 break;\r
852\r
853 default:\r
854 ASSERT (FALSE);\r
855 Status = EFI_NOT_FOUND;\r
856 break;\r
857 }\r
858 break;\r
859\r
860 default:\r
861 ASSERT (FALSE);\r
862 Status = EFI_NOT_FOUND;\r
863 break;\r
864 }\r
865\r
866 EfiReleaseLock (&mPcdDatabaseLock);\r
867 \r
868 return Status;\r
869}\r
870\r
871/**\r
872 Wrapper function for get PCD value for dynamic-ex PCD.\r
873\r
874 @param Guid Token space guid for dynamic-ex PCD.\r
875 @param ExTokenNumber Token number for dynamic-ex PCD.\r
876 @param GetSize The size of dynamic-ex PCD value.\r
877\r
878 @return PCD entry in PCD database.\r
879\r
880**/\r
881VOID *\r
882ExGetWorker (\r
883 IN CONST EFI_GUID *Guid,\r
884 IN UINTN ExTokenNumber,\r
885 IN UINTN GetSize\r
886 ) \r
887{\r
888 return GetWorker(GetExPcdTokenNumber (Guid, (UINT32) ExTokenNumber), GetSize);\r
889}\r
890\r
891/**\r
892 Wrapper function for set PCD value for non-Pointer type dynamic-ex PCD.\r
893\r
894 @param ExTokenNumber Token number for dynamic-ex PCD.\r
895 @param Guid Token space guid for dynamic-ex PCD.\r
896 @param Data Value want to be set.\r
897 @param SetSize The size of value.\r
898\r
899 @return status of ExSetWorker().\r
900\r
901**/\r
902EFI_STATUS\r
903ExSetValueWorker (\r
904 IN UINTN ExTokenNumber,\r
905 IN CONST EFI_GUID *Guid,\r
906 IN VOID *Data,\r
907 IN UINTN SetSize\r
908 )\r
909{\r
910 return ExSetWorker (ExTokenNumber, Guid, Data, &SetSize, FALSE);\r
911}\r
912\r
913/**\r
914 Set value for a dynamic PCD entry.\r
915 \r
916 This routine find the local token number according to dynamic-ex PCD's token \r
917 space guid and token number firstly, and invoke callback function if this PCD\r
918 entry registered callback function. Finally, invoken general SetWorker to set\r
919 PCD value.\r
920 \r
921 @param ExTokenNumber Dynamic-ex PCD token number.\r
922 @param Guid Token space guid for dynamic-ex PCD.\r
923 @param Data PCD value want to be set\r
924 @param SetSize Size of value.\r
925 @param PtrType If TRUE, this PCD entry is pointer type.\r
926 If FALSE, this PCD entry is not pointer type.\r
927\r
928 @return status of SetWorker().\r
929\r
930**/\r
931EFI_STATUS\r
932ExSetWorker (\r
933 IN UINTN ExTokenNumber,\r
934 IN CONST EFI_GUID *Guid,\r
935 IN VOID *Data,\r
936 IN OUT UINTN *SetSize,\r
937 IN BOOLEAN PtrType\r
938 )\r
939{\r
940 UINTN TokenNumber;\r
941 \r
942 TokenNumber = GetExPcdTokenNumber (Guid, (UINT32) ExTokenNumber);\r
943\r
944 InvokeCallbackOnSet ((UINT32) ExTokenNumber, Guid, TokenNumber, Data, *SetSize);\r
945\r
946 return SetWorker (TokenNumber, Data, SetSize, PtrType);\r
947\r
948}\r
949\r
950/**\r
951 Set value for HII-type PCD.\r
952\r
953 A HII-type PCD's value is stored in a variable. Setting/Getting the value of \r
954 HII-type PCD is to visit this variable.\r
955 \r
956 @param VariableGuid Guid of variable which stored value of a HII-type PCD.\r
957 @param VariableName Unicode name of variable which stored value of a HII-type PCD.\r
958 @param Data Value want to be set.\r
959 @param DataSize Size of value\r
960 @param Offset Value offset of HII-type PCD in variable.\r
961\r
962 @return status of GetVariable()/SetVariable().\r
963\r
964**/\r
965EFI_STATUS\r
966SetHiiVariable (\r
967 IN EFI_GUID *VariableGuid,\r
968 IN UINT16 *VariableName,\r
969 IN CONST VOID *Data,\r
970 IN UINTN DataSize,\r
971 IN UINTN Offset\r
972 )\r
973{\r
974 UINTN Size;\r
975 VOID *Buffer;\r
976 EFI_STATUS Status;\r
977 UINT32 Attribute;\r
978\r
979 Size = 0;\r
980\r
981 Status = gRT->GetVariable (\r
982 (UINT16 *)VariableName,\r
983 VariableGuid,\r
984 NULL,\r
985 &Size,\r
986 NULL\r
987 );\r
988\r
989 if (Status == EFI_BUFFER_TOO_SMALL) {\r
990\r
991 Buffer = AllocatePool (Size);\r
992\r
993 ASSERT (Buffer != NULL);\r
994\r
995 Status = gRT->GetVariable (\r
996 VariableName,\r
997 VariableGuid,\r
998 &Attribute,\r
999 &Size,\r
1000 Buffer\r
1001 );\r
1002 \r
1003 ASSERT_EFI_ERROR (Status);\r
1004\r
1005 CopyMem ((UINT8 *)Buffer + Offset, Data, DataSize);\r
1006\r
1007 Status = gRT->SetVariable (\r
1008 VariableName,\r
1009 VariableGuid,\r
1010 Attribute,\r
1011 Size,\r
1012 Buffer\r
1013 );\r
1014\r
1015 FreePool (Buffer);\r
1016 return Status;\r
1017\r
1018 } \r
1019 \r
1020 //\r
1021 // If we drop to here, we don't have a Variable entry in\r
1022 // the variable service yet. So, we will save the data\r
1023 // in the PCD Database's volatile area.\r
1024 //\r
1025 return Status;\r
1026}\r
1027\r
1028/**\r
1029 Get local token number according to dynamic-ex PCD's {token space guid:token number}\r
1030\r
1031 A dynamic-ex type PCD, developer must provide pair of token space guid: token number\r
1032 in DEC file. PCD database maintain a mapping table that translate pair of {token\r
1033 space guid: token number} to local token number.\r
1034 \r
1035 @param Guid Token space guid for dynamic-ex PCD entry.\r
1036 @param ExTokenNumber Dynamic-ex PCD token number.\r
1037\r
1038 @return local token number for dynamic-ex PCD.\r
1039\r
1040**/\r
1041UINTN \r
1042GetExPcdTokenNumber (\r
1043 IN CONST EFI_GUID *Guid,\r
1044 IN UINT32 ExTokenNumber\r
1045 )\r
1046{\r
1047 UINT32 Index;\r
1048 DYNAMICEX_MAPPING *ExMap;\r
1049 EFI_GUID *GuidTable;\r
1050 EFI_GUID *MatchGuid;\r
1051 UINTN MatchGuidIdx;\r
1052\r
1053 if (!PEI_DATABASE_EMPTY) {\r
1054 ExMap = mPcdDatabase->PeiDb.Init.ExMapTable;\r
1055 GuidTable = mPcdDatabase->PeiDb.Init.GuidTable;\r
1056 \r
1057 MatchGuid = ScanGuid (GuidTable, sizeof(mPcdDatabase->PeiDb.Init.GuidTable), Guid);\r
1058 \r
1059 if (MatchGuid != NULL) {\r
1060\r
1061 MatchGuidIdx = MatchGuid - GuidTable;\r
1062 \r
1063 for (Index = 0; Index < PEI_EXMAPPING_TABLE_SIZE; Index++) {\r
1064 if ((ExTokenNumber == ExMap[Index].ExTokenNumber) &&\r
1065 (MatchGuidIdx == ExMap[Index].ExGuidIndex)) {\r
1066 return ExMap[Index].LocalTokenNumber;\r
1067 }\r
1068 }\r
1069 }\r
1070 }\r
1071 \r
1072 ExMap = mPcdDatabase->DxeDb.Init.ExMapTable;\r
1073 GuidTable = mPcdDatabase->DxeDb.Init.GuidTable;\r
1074\r
1075 MatchGuid = ScanGuid (GuidTable, sizeof(mPcdDatabase->DxeDb.Init.GuidTable), Guid);\r
1076 //\r
1077 // We need to ASSERT here. If GUID can't be found in GuidTable, this is a\r
1078 // error in the BUILD system.\r
1079 //\r
1080 ASSERT (MatchGuid != NULL);\r
1081\r
1082 MatchGuidIdx = MatchGuid - GuidTable;\r
1083 \r
1084 for (Index = 0; Index < DXE_EXMAPPING_TABLE_SIZE; Index++) {\r
1085 if ((ExTokenNumber == ExMap[Index].ExTokenNumber) &&\r
1086 (MatchGuidIdx == ExMap[Index].ExGuidIndex)) {\r
1087 return ExMap[Index].LocalTokenNumber;\r
1088 }\r
1089 }\r
1090\r
1091 ASSERT (FALSE);\r
1092\r
1093 return 0;\r
1094}\r
1095\r
1096/**\r
1097 Get SKU ID table from PCD database.\r
1098\r
1099 @param LocalTokenNumberTableIdx Index of local token number in token number table.\r
1100 @param IsPeiPcd If TRUE, \r
1101\r
1102 @return Pointer to SKU ID array table\r
1103\r
1104**/\r
1105SKU_ID *\r
1106GetSkuIdArray (\r
1107 IN UINTN LocalTokenNumberTableIdx,\r
1108 IN BOOLEAN IsPeiPcd\r
1109 )\r
1110{\r
1111 SKU_HEAD *SkuHead;\r
1112 UINTN LocalTokenNumber;\r
1113 UINT8 *Database;\r
1114\r
1115 if (IsPeiPcd) {\r
1116 LocalTokenNumber = mPcdDatabase->PeiDb.Init.LocalTokenNumberTable[LocalTokenNumberTableIdx];\r
1117 Database = (UINT8 *) &mPcdDatabase->PeiDb;\r
1118 } else {\r
1119 LocalTokenNumber = mPcdDatabase->DxeDb.Init.LocalTokenNumberTable[LocalTokenNumberTableIdx - PEI_LOCAL_TOKEN_NUMBER];\r
1120 Database = (UINT8 *) &mPcdDatabase->DxeDb;\r
1121 }\r
1122\r
1123 ASSERT ((LocalTokenNumber & PCD_TYPE_SKU_ENABLED) != 0);\r
1124\r
1125 SkuHead = (SKU_HEAD *) ((UINT8 *)Database + (LocalTokenNumber & PCD_DATABASE_OFFSET_MASK));\r
1126\r
1127 return (SKU_ID *) (Database + SkuHead->SkuIdTableOffset);\r
1128 \r
1129}\r
1130\r
1131/**\r
1132 Wrapper function of getting index of PCD entry in size table.\r
1133 \r
1134 @param LocalTokenNumberTableIdx Index of this PCD in local token number table.\r
1135 @param IsPeiDb If TRUE, the pcd entry is initialized in PEI phase,\r
1136 If FALSE, the pcd entry is initialized in DXE phase.\r
1137\r
1138 @return index of PCD entry in size table.\r
1139**/\r
1140UINTN\r
1141GetSizeTableIndex (\r
1142 IN UINTN LocalTokenNumberTableIdx,\r
1143 IN BOOLEAN IsPeiDb\r
1144 )\r
1145{\r
1146 UINT32 *LocalTokenNumberTable;\r
1147 UINTN LocalTokenNumber;\r
1148 UINTN Index;\r
1149 UINTN SizeTableIdx;\r
1150 SKU_ID *SkuIdTable;\r
1151 \r
1152 if (IsPeiDb) {\r
1153 LocalTokenNumberTable = mPcdDatabase->PeiDb.Init.LocalTokenNumberTable;\r
1154 } else {\r
1155 LocalTokenNumberTable = mPcdDatabase->DxeDb.Init.LocalTokenNumberTable;\r
1156 }\r
1157\r
1158 SizeTableIdx = 0;\r
1159\r
1160 for (Index = 0; Index < LocalTokenNumberTableIdx; Index ++) {\r
1161 LocalTokenNumber = LocalTokenNumberTable[Index];\r
1162\r
1163 if ((LocalTokenNumber & PCD_DATUM_TYPE_ALL_SET) == PCD_DATUM_TYPE_POINTER) {\r
1164 //\r
1165 // SizeTable only contain record for PCD_DATUM_TYPE_POINTER type \r
1166 // PCD entry.\r
1167 //\r
1168 if ((LocalTokenNumber & PCD_TYPE_VPD) != 0) {\r
1169 //\r
1170 // We have only one entry for VPD enabled PCD entry:\r
1171 // 1) MAX Size.\r
1172 // We consider current size is equal to MAX size.\r
1173 //\r
1174 SizeTableIdx++;\r
1175 } else {\r
1176 if ((LocalTokenNumber & PCD_TYPE_SKU_ENABLED) == 0) {\r
1177 //\r
1178 // We have only two entry for Non-Sku enabled PCD entry:\r
1179 // 1) MAX SIZE\r
1180 // 2) Current Size\r
1181 //\r
1182 SizeTableIdx += 2;\r
1183 } else {\r
1184 //\r
1185 // We have these entry for SKU enabled PCD entry\r
1186 // 1) MAX SIZE\r
1187 // 2) Current Size for each SKU_ID (It is equal to MaxSku).\r
1188 //\r
1189 SkuIdTable = GetSkuIdArray (Index, IsPeiDb);\r
1190 SizeTableIdx += (UINTN)*SkuIdTable + 1;\r
1191 }\r
1192 }\r
1193 }\r
1194\r
1195 }\r
1196\r
1197 return SizeTableIdx; \r
1198}\r
1199\r
1200/**\r
1201 Get size of POINTER type PCD value.\r
1202\r
1203 @param LocalTokenNumberTableIdx Index of local token number in local token number table.\r
1204 @param MaxSize Maxmium size of POINTER type PCD value.\r
1205\r
1206 @return size of POINTER type PCD value.\r
1207\r
1208**/\r
1209UINTN\r
1210GetPtrTypeSize (\r
1211 IN UINTN LocalTokenNumberTableIdx,\r
1212 OUT UINTN *MaxSize\r
1213 )\r
1214{\r
1215 INTN SizeTableIdx;\r
1216 UINTN LocalTokenNumber;\r
1217 SKU_ID *SkuIdTable;\r
1218 SIZE_INFO *SizeTable;\r
1219 UINTN Index;\r
1220 BOOLEAN IsPeiDb;\r
1221 UINT32 *LocalTokenNumberTable;\r
1222\r
1223 // EBC compiler is very choosy. It may report warning about comparison\r
1224 // between UINTN and 0 . So we add 1 in each size of the \r
1225 // comparison.\r
1226 IsPeiDb = (BOOLEAN) (LocalTokenNumberTableIdx + 1 < PEI_LOCAL_TOKEN_NUMBER + 1);\r
1227\r
1228\r
1229 if (IsPeiDb) {\r
1230 LocalTokenNumberTable = mPcdDatabase->PeiDb.Init.LocalTokenNumberTable;\r
1231 SizeTable = mPcdDatabase->PeiDb.Init.SizeTable;\r
1232 } else {\r
1233 LocalTokenNumberTableIdx -= PEI_LOCAL_TOKEN_NUMBER;\r
1234 LocalTokenNumberTable = mPcdDatabase->DxeDb.Init.LocalTokenNumberTable;\r
1235 SizeTable = mPcdDatabase->DxeDb.Init.SizeTable;\r
1236 }\r
1237\r
1238 LocalTokenNumber = LocalTokenNumberTable[LocalTokenNumberTableIdx];\r
1239\r
1240 ASSERT ((LocalTokenNumber & PCD_DATUM_TYPE_ALL_SET) == PCD_DATUM_TYPE_POINTER);\r
1241 \r
1242 SizeTableIdx = GetSizeTableIndex (LocalTokenNumberTableIdx, IsPeiDb);\r
1243\r
1244 *MaxSize = SizeTable[SizeTableIdx];\r
1245 //\r
1246 // SizeTable only contain record for PCD_DATUM_TYPE_POINTER type \r
1247 // PCD entry.\r
1248 //\r
1249 if ((LocalTokenNumber & PCD_TYPE_VPD) != 0) {\r
1250 //\r
1251 // We have only one entry for VPD enabled PCD entry:\r
1252 // 1) MAX Size.\r
1253 // We consider current size is equal to MAX size.\r
1254 //\r
1255 return *MaxSize;\r
1256 } else {\r
1257 if ((LocalTokenNumber & PCD_TYPE_SKU_ENABLED) == 0) {\r
1258 //\r
1259 // We have only two entry for Non-Sku enabled PCD entry:\r
1260 // 1) MAX SIZE\r
1261 // 2) Current Size\r
1262 //\r
1263 return SizeTable[SizeTableIdx + 1];\r
1264 } else {\r
1265 //\r
1266 // We have these entry for SKU enabled PCD entry\r
1267 // 1) MAX SIZE\r
1268 // 2) Current Size for each SKU_ID (It is equal to MaxSku).\r
1269 //\r
1270 SkuIdTable = GetSkuIdArray (LocalTokenNumberTableIdx, IsPeiDb);\r
1271 for (Index = 0; Index < SkuIdTable[0]; Index++) {\r
1272 if (SkuIdTable[1 + Index] == mPcdDatabase->PeiDb.Init.SystemSkuId) {\r
1273 return SizeTable[SizeTableIdx + 1 + Index];\r
1274 }\r
1275 }\r
1276 return SizeTable[SizeTableIdx + 1];\r
1277 }\r
1278 }\r
1279}\r
1280\r
1281/**\r
1282 Set size of POINTER type PCD value. The size should not exceed the maximum size\r
1283 of this PCD value.\r
1284\r
1285 @param LocalTokenNumberTableIdx Index of local token number in local token number table.\r
1286 @param CurrentSize Size of POINTER type PCD value.\r
1287\r
1288 @retval TRUE Success to set size of PCD value.\r
1289 @retval FALSE Fail to set size of PCD value.\r
1290**/\r
1291BOOLEAN\r
1292SetPtrTypeSize (\r
1293 IN UINTN LocalTokenNumberTableIdx,\r
1294 IN OUT UINTN *CurrentSize\r
1295 )\r
1296{\r
1297 INTN SizeTableIdx;\r
1298 UINTN LocalTokenNumber;\r
1299 SKU_ID *SkuIdTable;\r
1300 SIZE_INFO *SizeTable;\r
1301 UINTN Index;\r
1302 UINTN MaxSize;\r
1303 BOOLEAN IsPeiDb;\r
1304 UINT32 *LocalTokenNumberTable;\r
1305\r
1306 //\r
1307 // EBC compiler is very choosy. It may report warning about comparison\r
1308 // between UINTN and 0 . So we add 1 in each size of the \r
1309 // comparison.\r
1310 //\r
1311 IsPeiDb = (BOOLEAN) (LocalTokenNumberTableIdx + 1 < PEI_LOCAL_TOKEN_NUMBER + 1);\r
1312\r
1313 if (IsPeiDb) {\r
1314 LocalTokenNumberTable = mPcdDatabase->PeiDb.Init.LocalTokenNumberTable;\r
1315 SizeTable = mPcdDatabase->PeiDb.Init.SizeTable;\r
1316 } else {\r
1317 LocalTokenNumberTableIdx -= PEI_LOCAL_TOKEN_NUMBER;\r
1318 LocalTokenNumberTable = mPcdDatabase->DxeDb.Init.LocalTokenNumberTable;\r
1319 SizeTable = mPcdDatabase->DxeDb.Init.SizeTable;\r
1320 }\r
1321\r
1322 LocalTokenNumber = LocalTokenNumberTable[LocalTokenNumberTableIdx];\r
1323\r
1324 ASSERT ((LocalTokenNumber & PCD_DATUM_TYPE_ALL_SET) == PCD_DATUM_TYPE_POINTER);\r
1325 \r
1326 SizeTableIdx = GetSizeTableIndex (LocalTokenNumberTableIdx, IsPeiDb);\r
1327\r
1328 MaxSize = SizeTable[SizeTableIdx];\r
1329 //\r
1330 // SizeTable only contain record for PCD_DATUM_TYPE_POINTER type \r
1331 // PCD entry.\r
1332 //\r
1333 if ((LocalTokenNumber & PCD_TYPE_VPD) != 0) {\r
1334 //\r
1335 // We shouldn't come here as we don't support SET for VPD\r
1336 //\r
1337 ASSERT (FALSE);\r
1338 return FALSE;\r
1339 } else {\r
1340 if ((*CurrentSize > MaxSize) ||\r
1341 (*CurrentSize == MAX_ADDRESS)) {\r
1342 *CurrentSize = MaxSize;\r
1343 return FALSE;\r
1344 } \r
1345 \r
1346 if ((LocalTokenNumber & PCD_TYPE_SKU_ENABLED) == 0) {\r
1347 //\r
1348 // We have only two entry for Non-Sku enabled PCD entry:\r
1349 // 1) MAX SIZE\r
1350 // 2) Current Size\r
1351 //\r
1352 SizeTable[SizeTableIdx + 1] = (SIZE_INFO) *CurrentSize;\r
1353 return TRUE;\r
1354 } else {\r
1355 //\r
1356 // We have these entry for SKU enabled PCD entry\r
1357 // 1) MAX SIZE\r
1358 // 2) Current Size for each SKU_ID (It is equal to MaxSku).\r
1359 //\r
1360 SkuIdTable = GetSkuIdArray (LocalTokenNumberTableIdx, IsPeiDb);\r
1361 for (Index = 0; Index < SkuIdTable[0]; Index++) {\r
1362 if (SkuIdTable[1 + Index] == mPcdDatabase->PeiDb.Init.SystemSkuId) {\r
1363 SizeTable[SizeTableIdx + 1 + Index] = (SIZE_INFO) *CurrentSize;\r
1364 return TRUE;\r
1365 }\r
1366 }\r
1367 SizeTable[SizeTableIdx + 1] = (SIZE_INFO) *CurrentSize;\r
1368 return TRUE;\r
1369 }\r
1370 }\r
1371}\r