2 CollectPCDAction class.
4 This action class is to collect PCD information from MSA, SPD, FPD xml file.
5 This class will be used for wizard and build tools, So it can *not* inherit
6 from buildAction or wizardAction.
8 Copyright (c) 2006, Intel Corporation
9 All rights reserved. This program and the accompanying materials
10 are licensed and made available under the terms and conditions of the BSD License
11 which accompanies this distribution. The full text of the license may be found at
12 http://opensource.org/licenses/bsd-license.php
14 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
15 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
18 package org
.tianocore
.build
.pcd
.action
;
20 import java
.io
.BufferedReader
;
22 import java
.io
.FileReader
;
23 import java
.io
.IOException
;
24 import java
.math
.BigInteger
;
25 import java
.util
.ArrayList
;
26 import java
.util
.Collections
;
27 import java
.util
.Comparator
;
28 import java
.util
.HashMap
;
29 import java
.util
.List
;
31 import java
.util
.UUID
;
33 import org
.apache
.xmlbeans
.XmlException
;
34 import org
.apache
.xmlbeans
.XmlObject
;
35 import org
.tianocore
.DynamicPcdBuildDefinitionsDocument
;
36 import org
.tianocore
.DynamicPcdBuildDefinitionsDocument
.DynamicPcdBuildDefinitions
;
37 import org
.tianocore
.DynamicPcdBuildDefinitionsDocument
.DynamicPcdBuildDefinitions
.PcdBuildData
;
38 import org
.tianocore
.DynamicPcdBuildDefinitionsDocument
.DynamicPcdBuildDefinitions
.PcdBuildData
.SkuInfo
;
39 import org
.tianocore
.FrameworkModulesDocument
;
40 import org
.tianocore
.FrameworkPlatformDescriptionDocument
;
41 import org
.tianocore
.FrameworkPlatformDescriptionDocument
.FrameworkPlatformDescription
;
42 import org
.tianocore
.ModuleSADocument
;
43 import org
.tianocore
.ModuleSADocument
.ModuleSA
;
44 import org
.tianocore
.PackageSurfaceAreaDocument
;
45 import org
.tianocore
.PcdBuildDefinitionDocument
.PcdBuildDefinition
;
46 import org
.tianocore
.build
.global
.GlobalData
;
47 import org
.tianocore
.build
.global
.SurfaceAreaQuery
;
48 import org
.tianocore
.build
.pcd
.action
.ActionMessage
;
49 import org
.tianocore
.build
.pcd
.entity
.DynamicTokenValue
;
50 import org
.tianocore
.build
.pcd
.entity
.MemoryDatabaseManager
;
51 import org
.tianocore
.build
.pcd
.entity
.SkuInstance
;
52 import org
.tianocore
.build
.pcd
.entity
.Token
;
53 import org
.tianocore
.build
.pcd
.entity
.UsageInstance
;
54 import org
.tianocore
.build
.pcd
.exception
.EntityException
;
57 private ArrayList
<String
> al
;
58 private ArrayList
<String
> alComments
;
64 public StringTable (String phase
) {
66 al
= new ArrayList
<String
>();
67 alComments
= new ArrayList
<String
>();
73 public String
getSizeMacro () {
74 return String
.format(PcdDatabase
.StringTableSizeMacro
, phase
, getSize());
77 private int getSize () {
79 // We have at least one Unicode Character in the table.
81 return len
== 0 ?
1 : len
;
84 public int getTableLen () {
85 return al
.size() == 0 ?
1 : al
.size();
88 public String
getExistanceMacro () {
89 return String
.format(PcdDatabase
.StringTableExistenceMacro
, phase
, (al
.size() == 0)?
"TRUE":"FALSE");
92 public String
getTypeDeclaration () {
96 final String stringTable
= "StringTable";
97 final String tab
= "\t";
98 final String newLine
= ";\r\n";
100 output
= "/* StringTable */\r\n";
102 if (al
.size() == 0) {
103 output
+= tab
+ String
.format("UINT16 %s[1] /* StringTable is Empty */", stringTable
) + newLine
;
106 for (int i
= 0; i
< al
.size(); i
++) {
107 String str
= al
.get(i
);
111 // StringTable is a well-known name in the PCD DXE driver
113 output
+= tab
+ String
.format("UINT16 %s[%d] /* %s */", stringTable
, str
.length() + 1, alComments
.get(i
)) + newLine
;
115 output
+= tab
+ String
.format("UINT16 %s_%d[%d] /* %s */", stringTable
, i
, str
.length() + 1, alComments
.get(i
)) + newLine
;
123 public ArrayList
<String
> getInstantiation () {
124 ArrayList
<String
> output
= new ArrayList
<String
>();
126 output
.add("/* StringTable */");
128 if (al
.size() == 0) {
133 for (int i
= 0; i
< al
.size(); i
++) {
134 str
= String
.format("L\"%s\" /* %s */", al
.get(i
), alComments
.get(i
));
135 if (i
!= al
.size() - 1) {
145 public int add (String str
, Token token
) {
150 // Include the NULL character at the end of String
152 len
+= str
.length() + 1;
154 alComments
.add(token
.getPrimaryKeyString());
161 private ArrayList
<Integer
> al
;
162 private ArrayList
<String
> alComments
;
163 private String phase
;
165 private int bodyStart
;
166 private int bodyLineNum
;
168 public SizeTable (String phase
) {
170 al
= new ArrayList
<Integer
>();
171 alComments
= new ArrayList
<String
>();
177 public String
getTypeDeclaration () {
178 return String
.format(PcdDatabase
.SizeTableDeclaration
, phase
);
181 public ArrayList
<String
> getInstantiation () {
182 ArrayList
<String
> Output
= new ArrayList
<String
>();
184 Output
.add("/* SizeTable */");
188 if (al
.size() == 0) {
191 for (int index
= 0; index
< al
.size(); index
++) {
192 Integer n
= al
.get(index
);
193 String str
= n
.toString();
195 if (index
!= (al
.size() - 1)) {
199 str
+= " /* " + alComments
.get(index
) + " */";
210 public int getBodyStart() {
214 public int getBodyLineNum () {
218 public int add (Token token
) {
222 al
.add(token
.datumSize
);
223 alComments
.add(token
.getPrimaryKeyString());
228 private int getDatumSize(Token token
) {
230 switch (token.datumType) {
231 case Token.DATUM_TYPE.UINT8:
240 public int getTableLen () {
241 return al
.size() == 0 ?
1 : al
.size();
247 private ArrayList
<UUID
> al
;
248 private ArrayList
<String
> alComments
;
249 private String phase
;
251 private int bodyStart
;
252 private int bodyLineNum
;
254 public GuidTable (String phase
) {
256 al
= new ArrayList
<UUID
>();
257 alComments
= new ArrayList
<String
>();
263 public String
getSizeMacro () {
264 return String
.format(PcdDatabase
.GuidTableSizeMacro
, phase
, getSize());
267 private int getSize () {
268 return (al
.size() == 0)?
1 : al
.size();
271 public String
getExistanceMacro () {
272 return String
.format(PcdDatabase
.GuidTableExistenceMacro
, phase
, (al
.size() == 0)?
"TRUE":"FALSE");
275 public String
getTypeDeclaration () {
276 return String
.format(PcdDatabase
.GuidTableDeclaration
, phase
);
279 private String
getUuidCString (UUID uuid
) {
280 String
[] guidStrArray
;
282 guidStrArray
=(uuid
.toString()).split("-");
284 return String
.format("{ 0x%s, 0x%s, 0x%s, { 0x%s, 0x%s, 0x%s, 0x%s, 0x%s, 0x%s, 0x%s, 0x%s } }",
288 (guidStrArray
[3].substring(0, 2)),
289 (guidStrArray
[3].substring(2, 4)),
290 (guidStrArray
[4].substring(0, 2)),
291 (guidStrArray
[4].substring(2, 4)),
292 (guidStrArray
[4].substring(4, 6)),
293 (guidStrArray
[4].substring(6, 8)),
294 (guidStrArray
[4].substring(8, 10)),
295 (guidStrArray
[4].substring(10, 12))
299 public ArrayList
<String
> getInstantiation () {
300 ArrayList
<String
> Output
= new ArrayList
<String
>();
302 Output
.add("/* GuidTable */");
306 if (al
.size() == 0) {
307 Output
.add(getUuidCString(new UUID(0, 0)));
310 for (Object u
: al
) {
312 String str
= getUuidCString(uuid
);
314 if (al
.indexOf(u
) != (al
.size() - 1)) {
326 public int getBodyStart() {
330 public int getBodyLineNum () {
334 public int add (UUID uuid
, String name
) {
337 // Include the NULL character at the end of String
345 public int getTableLen () {
346 return al
.size() == 0 ?
0 : al
.size();
352 private ArrayList
<Integer
[]> al
;
353 private ArrayList
<String
> alComment
;
354 private String phase
;
356 private int bodyStart
;
357 private int bodyLineNum
;
359 public SkuIdTable (String phase
) {
361 al
= new ArrayList
<Integer
[]>();
362 alComment
= new ArrayList
<String
>();
368 public String
getSizeMacro () {
369 return String
.format(PcdDatabase
.SkuIdTableSizeMacro
, phase
, getSize());
372 private int getSize () {
373 return (al
.size() == 0)?
1 : al
.size();
376 public String
getExistanceMacro () {
377 return String
.format(PcdDatabase
.SkuTableExistenceMacro
, phase
, (al
.size() == 0)?
"TRUE":"FALSE");
380 public String
getTypeDeclaration () {
381 return String
.format(PcdDatabase
.SkuIdTableDeclaration
, phase
);
384 public ArrayList
<String
> getInstantiation () {
385 ArrayList
<String
> Output
= new ArrayList
<String
> ();
387 Output
.add("/* SkuIdTable */");
391 if (al
.size() == 0) {
395 for (int index
= 0; index
< al
.size(); index
++) {
398 str
= "/* " + alComment
.get(index
) + "*/ ";
399 str
+= "/* MaxSku */ ";
402 Integer
[] ia
= al
.get(index
);
404 str
+= ia
[0].toString() + ", ";
405 for (int index2
= 1; index2
< ia
.length
; index2
++) {
406 str
+= ia
[index2
].toString();
407 if (index
!= al
.size() - 1) {
422 public int add (Token token
) {
426 Integer
[] skuIds
= new Integer
[token
.skuData
.size() + 1];
427 skuIds
[0] = new Integer(token
.skuData
.size());
428 for (index
= 1; index
< skuIds
.length
; index
++) {
429 skuIds
[index
] = new Integer(token
.skuData
.get(index
- 1).id
);
434 len
+= skuIds
.length
;
436 alComment
.add(token
.getPrimaryKeyString());
441 public int getTableLen () {
442 return al
.size() == 0 ?
1 : al
.size();
447 class LocalTokenNumberTable
{
448 private ArrayList
<String
> al
;
449 private ArrayList
<String
> alComment
;
450 private String phase
;
453 public LocalTokenNumberTable (String phase
) {
455 al
= new ArrayList
<String
>();
456 alComment
= new ArrayList
<String
>();
461 public String
getSizeMacro () {
462 return String
.format(PcdDatabase
.LocalTokenNumberTableSizeMacro
, phase
, getSize())
463 + String
.format(PcdDatabase
.LocalTokenNumberSizeMacro
, phase
, al
.size());
466 public int getSize () {
467 return (al
.size() == 0)?
1 : al
.size();
470 public String
getExistanceMacro () {
471 return String
.format(PcdDatabase
.DatabaseExistenceMacro
, phase
, (al
.size() == 0)?
"TRUE":"FALSE");
474 public String
getTypeDeclaration () {
475 return String
.format(PcdDatabase
.LocalTokenNumberTableDeclaration
, phase
);
478 public ArrayList
<String
> getInstantiation () {
479 ArrayList
<String
> output
= new ArrayList
<String
>();
481 output
.add("/* LocalTokenNumberTable */");
484 if (al
.size() == 0) {
488 for (int index
= 0; index
< al
.size(); index
++) {
491 str
= (String
)al
.get(index
);
493 str
+= " /* " + alComment
.get(index
) + " */ ";
496 if (index
!= (al
.size() - 1)) {
509 public int add (Token token
) {
515 str
= String
.format(PcdDatabase
.offsetOfStrTemplate
, phase
, token
.hasDefaultValue() ?
"Init" : "Uninit", token
.getPrimaryKeyString());
517 if (token
.isUnicodeStringType()) {
518 str
+= " | PCD_TYPE_STRING";
521 if (token
.isSkuEnable()) {
522 str
+= " | PCD_TYPE_SKU_ENABLED";
525 if (token
.getDefaultSku().type
== DynamicTokenValue
.VALUE_TYPE
.HII_TYPE
) {
526 str
+= " | PCD_TYPE_HII";
529 if (token
.getDefaultSku().type
== DynamicTokenValue
.VALUE_TYPE
.VPD_TYPE
) {
530 str
+= " | PCD_TYPE_VPD";
534 alComment
.add(token
.getPrimaryKeyString());
543 public Integer guidTableIdx
;
544 public Long exTokenNumber
;
545 public Long localTokenIdx
;
547 public ExTriplet (int guidTableIdx
, long exTokenNumber
, long localTokenIdx
) {
548 this.guidTableIdx
= new Integer(guidTableIdx
);
549 this.exTokenNumber
= new Long(exTokenNumber
);
550 this.localTokenIdx
= new Long(localTokenIdx
);
554 private ArrayList
<ExTriplet
> al
;
555 private ArrayList
<String
> alComment
;
556 private String phase
;
558 private int bodyStart
;
559 private int bodyLineNum
;
562 public ExMapTable (String phase
) {
564 al
= new ArrayList
<ExTriplet
>();
565 alComment
= new ArrayList
<String
>();
571 public String
getSizeMacro () {
572 return String
.format(PcdDatabase
.ExMapTableSizeMacro
, phase
, getTableLen())
573 + String
.format(PcdDatabase
.ExTokenNumber
, phase
, al
.size());
576 private int getSize () {
577 return (al
.size() == 0)?
1 : al
.size();
580 public String
getExistanceMacro () {
581 return String
.format(PcdDatabase
.ExMapTableExistenceMacro
, phase
, (al
.size() == 0)?
"TRUE":"FALSE");
584 public String
getTypeDeclaration () {
585 return String
.format(PcdDatabase
.ExMapTableDeclaration
, phase
);
588 public ArrayList
<String
> getInstantiation () {
589 ArrayList
<String
> Output
= new ArrayList
<String
>();
591 Output
.add("/* ExMapTable */");
595 if (al
.size() == 0) {
596 Output
.add("{0, 0, 0}");
600 for (index
= 0; index
< al
.size(); index
++) {
603 ExTriplet e
= (ExTriplet
)al
.get(index
);
605 str
= "{ " + e
.exTokenNumber
.toString() + ", ";
606 str
+= e
.localTokenIdx
.toString() + ", ";
607 str
+= e
.guidTableIdx
.toString();
609 str
+= " /* " + alComment
.get(index
) + " */";
611 if (index
!= al
.size() - 1) {
625 public int add (int localTokenIdx
, long exTokenNum
, int guidTableIdx
, String name
) {
629 al
.add(new ExTriplet(guidTableIdx
, exTokenNum
, localTokenIdx
));
635 public int getTableLen () {
636 return al
.size() == 0 ?
1 : al
.size();
643 public final static String ExMapTableDeclaration
= "DYNAMICEX_MAPPING ExMapTable[%s_EXMAPPING_TABLE_SIZE];\r\n";
644 public final static String GuidTableDeclaration
= "EFI_GUID GuidTable[%s_GUID_TABLE_SIZE];\r\n";
645 public final static String LocalTokenNumberTableDeclaration
= "UINT32 LocalTokenNumberTable[%s_LOCAL_TOKEN_NUMBER_TABLE_SIZE];\r\n";
646 public final static String StringTableDeclaration
= "UINT16 StringTable[%s_STRING_TABLE_SIZE];\r\n";
647 public final static String SizeTableDeclaration
= "UINT16 SizeTable[%s_LOCAL_TOKEN_NUMBER_TABLE_SIZE];\r\n";
648 public final static String SkuIdTableDeclaration
= "UINT8 SkuIdTable[%s_SKUID_TABLE_SIZE];\r\n";
651 public final static String ExMapTableSizeMacro
= "#define %s_EXMAPPING_TABLE_SIZE %d\r\n";
652 public final static String ExTokenNumber
= "#define %s_EX_TOKEN_NUMBER %d\r\n";
653 public final static String GuidTableSizeMacro
= "#define %s_GUID_TABLE_SIZE %d\r\n";
654 public final static String LocalTokenNumberTableSizeMacro
= "#define %s_LOCAL_TOKEN_NUMBER_TABLE_SIZE %d\r\n";
655 public final static String LocalTokenNumberSizeMacro
= "#define %s_LOCAL_TOKEN_NUMBER %d\r\n";
656 public final static String StringTableSizeMacro
= "#define %s_STRING_TABLE_SIZE %d\r\n";
657 public final static String SkuIdTableSizeMacro
= "#define %s_SKUID_TABLE_SIZE %d\r\n";
660 public final static String ExMapTableExistenceMacro
= "#define %s_EXMAP_TABLE_EMPTY %s\r\n";
661 public final static String GuidTableExistenceMacro
= "#define %s_GUID_TABLE_EMPTY %s\r\n";
662 public final static String DatabaseExistenceMacro
= "#define %s_DATABASE_EMPTY %s\r\n";
663 public final static String StringTableExistenceMacro
= "#define %s_STRING_TABLE_EMPTY %s\r\n";
664 public final static String SkuTableExistenceMacro
= "#define %s_SKUID_TABLE_EMPTY %s\r\n";
666 public final static String offsetOfSkuHeadStrTemplate
= "offsetof(%s_PCD_DATABASE, %s.%s_SkuDataTable)";
667 public final static String offsetOfStrTemplate
= "offsetof(%s_PCD_DATABASE, %s.%s)";
669 private StringTable stringTable
;
670 private GuidTable guidTable
;
671 private LocalTokenNumberTable localTokenNumberTable
;
672 private SkuIdTable skuIdTable
;
673 private SizeTable sizeTable
;
674 private ExMapTable exMapTable
;
676 private ArrayList
<Token
> alTokens
;
677 private String phase
;
678 private int assignedTokenNumber
;
681 // After Major changes done to the PCD
682 // database generation class PcdDatabase
683 // Please increment the version and please
684 // also update the version number in PCD
685 // service PEIM and DXE driver accordingly.
687 private final int version
= 1;
689 private String hString
;
690 private String cString
;
693 class AlignmentSizeComp
implements Comparator
<Token
> {
694 public int compare (Token a
, Token b
) {
695 return getAlignmentSize(b
)
696 - getAlignmentSize(a
);
700 public PcdDatabase (ArrayList
<Token
> alTokens
, String exePhase
, int startLen
) {
703 stringTable
= new StringTable(phase
);
704 guidTable
= new GuidTable(phase
);
705 localTokenNumberTable
= new LocalTokenNumberTable(phase
);
706 skuIdTable
= new SkuIdTable(phase
);
707 sizeTable
= new SizeTable(phase
);
708 exMapTable
= new ExMapTable(phase
);
710 assignedTokenNumber
= startLen
;
711 this.alTokens
= alTokens
;
714 private void getTwoGroupsOfTokens (ArrayList
<Token
> alTokens
, List
<Token
> initTokens
, List
<Token
> uninitTokens
) {
715 for (int i
= 0; i
< alTokens
.size(); i
++) {
716 Token t
= (Token
)alTokens
.get(i
);
717 if (t
.hasDefaultValue()) {
727 private int getAlignmentSize (Token token
) {
728 if (token
.getDefaultSku().type
== DynamicTokenValue
.VALUE_TYPE
.HII_TYPE
) {
732 if (token
.getDefaultSku().type
== DynamicTokenValue
.VALUE_TYPE
.VPD_TYPE
) {
736 if (token
.isUnicodeStringType()) {
740 switch (token
.datumType
) {
757 public String
getCString () {
761 public String
getHString () {
765 public void genCode ()
766 throws EntityException
{
768 final String newLine
= "\r\n";
769 final String declNewLine
= ";\r\n";
770 final String tab
= "\t";
771 final String commaNewLine
= ", \r\n";
774 ArrayList
<String
> decla
;
775 ArrayList
<String
> inst
;
777 String macroStr
= "";
778 String initDeclStr
= "";
779 String initInstStr
= "";
780 String uninitDeclStr
= "";
782 List
<Token
> initTokens
= new ArrayList
<Token
> ();
783 List
<Token
> uninitTokens
= new ArrayList
<Token
> ();
785 HashMap
<String
, ArrayList
<String
>> initCode
= new HashMap
<String
, ArrayList
<String
>> ();
786 HashMap
<String
, ArrayList
<String
>> uninitCode
= new HashMap
<String
, ArrayList
<String
>> ();
788 getTwoGroupsOfTokens (alTokens
, initTokens
, uninitTokens
);
791 // Generate Structure Declaration for PcdTokens without Default Value
792 // PEI_PCD_DATABASE_INIT
794 java
.util
.Comparator
<Token
> comparator
= new AlignmentSizeComp();
795 java
.util
.Collections
.sort(initTokens
, comparator
);
796 initCode
= processTokens(initTokens
);
799 // Generate Structure Declaration for PcdTokens without Default Value
800 // PEI_PCD_DATABASE_UNINIT
802 java
.util
.Collections
.sort(uninitTokens
, comparator
);
803 uninitCode
= processTokens(uninitTokens
);
806 // Generate size info Macro for all Tables
808 macroStr
+= guidTable
.getSizeMacro();
809 macroStr
+= stringTable
.getSizeMacro();
810 macroStr
+= skuIdTable
.getSizeMacro();
811 macroStr
+= localTokenNumberTable
.getSizeMacro();
812 macroStr
+= exMapTable
.getSizeMacro();
815 // Generate existance info Macro for all Tables
817 macroStr
+= guidTable
.getExistanceMacro();
818 macroStr
+= stringTable
.getExistanceMacro();
819 macroStr
+= skuIdTable
.getExistanceMacro();
820 macroStr
+= localTokenNumberTable
.getExistanceMacro();
821 macroStr
+= exMapTable
.getExistanceMacro();
824 // Generate Structure Declaration for PcdTokens with Default Value
825 // for example PEI_PCD_DATABASE_INIT
827 initDeclStr
+= "typedef struct {" + newLine
;
829 initDeclStr
+= tab
+ exMapTable
.getTypeDeclaration();
830 initDeclStr
+= tab
+ guidTable
.getTypeDeclaration();
831 initDeclStr
+= tab
+ localTokenNumberTable
.getTypeDeclaration();
832 initDeclStr
+= tab
+ stringTable
.getTypeDeclaration();
833 initDeclStr
+= tab
+ sizeTable
.getTypeDeclaration();
834 initDeclStr
+= tab
+ skuIdTable
.getTypeDeclaration();
835 if (phase
.equalsIgnoreCase("PEI")) {
836 initDeclStr
+= tab
+ "SKU_ID SystemSkuId;" + newLine
;
839 decla
= initCode
.get(new String("Declaration"));
840 for (i
= 0; i
< decla
.size(); i
++) {
841 initDeclStr
+= tab
+ decla
.get(i
) + declNewLine
;
845 // Generate Structure Declaration for PcdToken with SkuEnabled
847 decla
= initCode
.get("DeclarationForSku");
849 for (i
= 0; i
< decla
.size(); i
++) {
850 initDeclStr
+= tab
+ decla
.get(i
) + declNewLine
;
853 initDeclStr
+= String
.format("} %s_PCD_DATABASE_INIT;\r\n\r\n", phase
);
856 // Generate MACRO for structure intialization of PCDTokens with Default Value
857 // The sequence must match the sequence of declaration of the memembers in the structure
858 String tmp
= String
.format("%s_PCD_DATABASE_INIT g%sPcdDbInit = { ", phase
.toUpperCase(), phase
.toUpperCase());
859 initInstStr
+= tmp
+ newLine
;
860 initInstStr
+= tab
+ genInstantiationStr(exMapTable
.getInstantiation()) + commaNewLine
;
861 initInstStr
+= tab
+ genInstantiationStr(guidTable
.getInstantiation()) + commaNewLine
;
862 initInstStr
+= tab
+ genInstantiationStr(localTokenNumberTable
.getInstantiation()) + commaNewLine
;
863 initInstStr
+= tab
+ genInstantiationStr(stringTable
.getInstantiation()) + commaNewLine
;
864 initInstStr
+= tab
+ genInstantiationStr(sizeTable
.getInstantiation()) + commaNewLine
;
865 initInstStr
+= tab
+ genInstantiationStr(skuIdTable
.getInstantiation()) + commaNewLine
;
869 if (phase
.equalsIgnoreCase("PEI")) {
870 initInstStr
+= tab
+ "0" + tab
+ "/* SystemSkuId */" + commaNewLine
;
873 inst
= initCode
.get("Instantiation");
874 for (i
= 0; i
< inst
.size(); i
++) {
875 initInstStr
+= tab
+ inst
.get(i
) + commaNewLine
;
878 inst
= initCode
.get("InstantiationForSku");
879 for (i
= 0; i
< inst
.size(); i
++) {
880 initInstStr
+= tab
+ inst
.get(i
);
881 if (i
!= inst
.size() - 1) {
882 initInstStr
+= commaNewLine
;
888 uninitDeclStr
+= "typedef struct {" + newLine
;
890 decla
= uninitCode
.get("Declaration");
891 if (decla
.size() == 0) {
892 uninitDeclStr
+= "UINT8 dummy /* The UINT struct is empty */" + declNewLine
;
895 for (i
= 0; i
< decla
.size(); i
++) {
896 uninitDeclStr
+= tab
+ decla
.get(i
) + declNewLine
;
899 decla
= uninitCode
.get("DeclarationForSku");
901 for (i
= 0; i
< decla
.size(); i
++) {
902 uninitDeclStr
+= tab
+ decla
.get(i
) + declNewLine
;
906 uninitDeclStr
+= String
.format("} %s_PCD_DATABASE_UNINIT;\r\n\r\n", phase
);
908 cString
= initInstStr
+ newLine
;
909 hString
= macroStr
+ newLine
910 + initDeclStr
+ newLine
911 + uninitDeclStr
+ newLine
914 hString
+= String
.format("#define PCD_%s_SERVICE_DRIVER_VERSION %d", phase
, version
);
918 private String
genInstantiationStr (ArrayList
<String
> alStr
) {
920 for (int i
= 0; i
< alStr
.size(); i
++) {
921 str
+= "\t" + alStr
.get(i
);
922 if (i
!= alStr
.size() - 1) {
930 private HashMap
<String
, ArrayList
<String
>> processTokens (List
<Token
> alToken
)
931 throws EntityException
{
933 HashMap
<String
, ArrayList
<String
>> map
= new HashMap
<String
, ArrayList
<String
>>();
935 ArrayList
<String
> decl
= new ArrayList
<String
>();
936 ArrayList
<String
> declForSkuEnableType
= new ArrayList
<String
>();
937 ArrayList
<String
> inst
= new ArrayList
<String
>();
938 ArrayList
<String
> instForSkuEnableType
= new ArrayList
<String
>();
940 for (int index
= 0; index
< alToken
.size(); index
++) {
941 Token token
= alToken
.get(index
);
943 if (token
.isSkuEnable()) {
945 // BugBug: Schema only support Data type now
949 tableIdx
= skuIdTable
.add(token
);
951 decl
.add(getSkuEnabledTypeDeclaration(token
));
952 if (token
.hasDefaultValue()) {
953 inst
.add(getSkuEnabledTypeInstantiaion(token
, tableIdx
));
956 declForSkuEnableType
.add(getDataTypeDeclarationForSkuEnabled(token
));
957 if (token
.hasDefaultValue()) {
958 instForSkuEnableType
.add(getDataTypeInstantiationForSkuEnabled(token
));
962 if (token
.getDefaultSku().type
== DynamicTokenValue
.VALUE_TYPE
.HII_TYPE
) {
963 decl
.add(getVariableEnableTypeDeclaration(token
));
964 inst
.add(getVariableEnableInstantiation(token
));
965 } else if (token
.getDefaultSku().type
== DynamicTokenValue
.VALUE_TYPE
.VPD_TYPE
) {
966 decl
.add(getVpdEnableTypeDeclaration(token
));
967 inst
.add(getVpdEnableTypeInstantiation(token
));
968 } else if (token
.isUnicodeStringType()) {
969 decl
.add(getStringTypeDeclaration(token
));
970 inst
.add(getStringTypeInstantiation(stringTable
.add(token
.getStringTypeString(), token
), token
));
973 decl
.add(getDataTypeDeclaration(token
));
974 if (token
.hasDefaultValue()) {
975 inst
.add(getDataTypeInstantiation(token
));
980 sizeTable
.add(token
);
981 localTokenNumberTable
.add(token
);
982 token
.tokenNumber
= assignedTokenNumber
++;
986 map
.put("Declaration", decl
);
987 map
.put("DeclarationForSku", declForSkuEnableType
);
988 map
.put("Instantiation", inst
);
989 map
.put("InstantiationForSku", instForSkuEnableType
);
994 private String
getSkuEnabledTypeDeclaration (Token token
) {
995 return String
.format("SKU_HEAD %s;\r\n", token
.getPrimaryKeyString());
998 private String
getSkuEnabledTypeInstantiaion (Token token
, int SkuTableIdx
) {
1000 String offsetof
= String
.format(PcdDatabase
.offsetOfSkuHeadStrTemplate
, phase
, token
.hasDefaultValue()?
"Init" : "Uninit", token
.getPrimaryKeyString());
1001 return String
.format("{ %s, %d }", offsetof
, SkuTableIdx
);
1004 private String
getDataTypeDeclarationForSkuEnabled (Token token
) {
1005 String typeStr
= "";
1007 if (token
.datumType
== Token
.DATUM_TYPE
.UINT8
) {
1008 typeStr
= "UINT8 %s_%s[%d];\r\n";
1009 } else if (token
.datumType
== Token
.DATUM_TYPE
.UINT16
) {
1010 typeStr
= "UINT16 %s_%s[%d];\r\n";
1011 } else if (token
.datumType
== Token
.DATUM_TYPE
.UINT32
) {
1012 typeStr
= "UINT32 %s_%s[%d];\r\n";
1013 } else if (token
.datumType
== Token
.DATUM_TYPE
.UINT64
) {
1014 typeStr
= "UINT64 %s_%s[%d];\r\n";
1015 } else if (token
.datumType
== Token
.DATUM_TYPE
.BOOLEAN
) {
1016 typeStr
= "BOOLEAN %s_%s[%d];\r\n";
1017 } else if (token
.datumType
== Token
.DATUM_TYPE
.POINTER
) {
1018 return String
.format("UINT8 %s_%s[%d];\r\n", token
.getPrimaryKeyString(), "SkuDataTable", token
.datumSize
* token
.skuData
.size());
1021 return String
.format(typeStr
, token
.getPrimaryKeyString(), "SkuDataTable", token
.skuData
.size());
1025 private String
getDataTypeInstantiationForSkuEnabled (Token token
) {
1028 if (token
.datumType
== Token
.DATUM_TYPE
.POINTER
) {
1029 return String
.format("UINT8 %s_%s[%d]", token
.getPrimaryKeyString(), "SkuDataTable", token
.datumSize
* token
.skuData
.size());
1032 for (int idx
= 0; idx
< token
.skuData
.size(); idx
++) {
1033 str
+= token
.skuData
.get(idx
).toString();
1034 if (idx
!= token
.skuData
.size() - 1) {
1045 private String
getDataTypeInstantiation (Token token
) {
1047 if (token
.datumType
== Token
.DATUM_TYPE
.POINTER
) {
1048 return String
.format("%s /* %s */", token
.getDefaultSku().value
, token
.getPrimaryKeyString());
1050 return String
.format("%s /* %s */", token
.getDefaultSku().value
, token
.getPrimaryKeyString());
1055 private String
getDataTypeDeclaration (Token token
) {
1057 String typeStr
= "";
1059 if (token
.datumType
== Token
.DATUM_TYPE
.UINT8
) {
1061 } else if (token
.datumType
== Token
.DATUM_TYPE
.UINT16
) {
1063 } else if (token
.datumType
== Token
.DATUM_TYPE
.UINT32
) {
1065 } else if (token
.datumType
== Token
.DATUM_TYPE
.UINT64
) {
1067 } else if (token
.datumType
== Token
.DATUM_TYPE
.BOOLEAN
) {
1068 typeStr
= "BOOLEAN";
1069 } else if (token
.datumType
== Token
.DATUM_TYPE
.POINTER
) {
1070 return String
.format("UINT8 %s[%d]", token
.getPrimaryKeyString(), token
.datumSize
);
1074 return String
.format("%s %s", typeStr
, token
.getPrimaryKeyString());
1077 private String
getVpdEnableTypeDeclaration (Token token
) {
1078 return String
.format("VPD_HEAD %s", token
.getPrimaryKeyString());
1081 private String
getVpdEnableTypeInstantiation (Token token
) {
1082 return String
.format("{ %s } /* %s */", token
.getDefaultSku().vpdOffset
,
1083 token
.getPrimaryKeyString());
1086 private String
getStringTypeDeclaration (Token token
) {
1087 return String
.format("UINT16 %s", token
.getPrimaryKeyString());
1090 private String
getStringTypeInstantiation (int StringTableIdx
, Token token
) {
1091 return String
.format ("%d /* %s */", StringTableIdx
,
1092 token
.getPrimaryKeyString());
1096 private String
getVariableEnableTypeDeclaration (Token token
) {
1097 return String
.format("VARIABLE_HEAD %s", token
.getPrimaryKeyString());
1100 private String
getVariableEnableInstantiation (Token token
)
1101 throws EntityException
{
1105 return String
.format("{ %d, %d, %s } /* %s */", guidTable
.add(token
.getDefaultSku().variableGuid
, token
.getPrimaryKeyString()),
1106 stringTable
.add(token
.getDefaultSku().getStringOfVariableName(), token
),
1107 token
.getDefaultSku().variableOffset
,
1108 token
.getPrimaryKeyString());
1111 public int getTotalTokenNumber () {
1112 return sizeTable
.getTableLen();
1115 public static String
getPcdDatabaseCommonDefinitions ()
1116 throws EntityException
{
1120 File file
= new File(GlobalData
.getWorkspacePath() + File
.separator
+
1121 "Tools" + File
.separator
+
1122 "Conf" + File
.separator
+
1123 "Pcd" + File
.separator
+
1124 "PcdDatabaseCommonDefinitions.sample");
1125 FileReader reader
= new FileReader(file
);
1126 BufferedReader in
= new BufferedReader(reader
);
1128 while ((str
= in
.readLine()) != null) {
1129 retStr
= retStr
+"\r\n" + str
;
1131 } catch (Exception ex
) {
1132 throw new EntityException("Fatal error when generating PcdDatabase Common Definitions");
1138 public static String
getPcdDxeDatabaseDefinitions ()
1139 throws EntityException
{
1143 File file
= new File(GlobalData
.getWorkspacePath() + File
.separator
+
1144 "Tools" + File
.separator
+
1145 "Conf" + File
.separator
+
1146 "Pcd" + File
.separator
+
1147 "PcdDatabaseDxeDefinitions.sample");
1148 FileReader reader
= new FileReader(file
);
1149 BufferedReader in
= new BufferedReader(reader
);
1151 while ((str
= in
.readLine()) != null) {
1152 retStr
= retStr
+"\r\n" + str
;
1154 } catch (Exception ex
) {
1155 throw new EntityException("Fatal error when generating PcdDatabase Dxe Definitions");
1161 public static String
getPcdPeiDatabaseDefinitions ()
1162 throws EntityException
{
1166 File file
= new File(GlobalData
.getWorkspacePath() + File
.separator
+
1167 "Tools" + File
.separator
+
1168 "Conf" + File
.separator
+
1169 "Pcd" + File
.separator
+
1170 "PcdDatabasePeiDefinitions.sample");
1171 FileReader reader
= new FileReader(file
);
1172 BufferedReader in
= new BufferedReader(reader
);
1174 while ((str
= in
.readLine()) != null) {
1175 retStr
= retStr
+"\r\n" + str
;
1177 } catch (Exception ex
) {
1178 throw new EntityException("Fatal error when generating PcdDatabase Pei Definitions");
1187 public ModuleSADocument
.ModuleSA module
;
1188 public UsageInstance
.MODULE_TYPE type
;
1190 public ModuleInfo (ModuleSADocument
.ModuleSA module
, UsageInstance
.MODULE_TYPE type
) {
1191 this.module
= module
;
1196 /** This action class is to collect PCD information from MSA, SPD, FPD xml file.
1197 This class will be used for wizard and build tools, So it can *not* inherit
1198 from buildAction or UIAction.
1200 public class CollectPCDAction
{
1201 /// memoryDatabase hold all PCD information collected from SPD, MSA, FPD.
1202 private MemoryDatabaseManager dbManager
;
1204 /// Workspacepath hold the workspace information.
1205 private String workspacePath
;
1207 /// FPD file is the root file.
1208 private String fpdFilePath
;
1210 /// Message level for CollectPCDAction.
1211 private int originalMessageLevel
;
1213 /// Cache the fpd docment instance for private usage.
1214 private FrameworkPlatformDescriptionDocument fpdDocInstance
;
1217 Set WorkspacePath parameter for this action class.
1219 @param workspacePath parameter for this action
1221 public void setWorkspacePath(String workspacePath
) {
1222 this.workspacePath
= workspacePath
;
1226 Set action message level for CollectPcdAction tool.
1228 The message should be restored when this action exit.
1230 @param actionMessageLevel parameter for this action
1232 public void setActionMessageLevel(int actionMessageLevel
) {
1233 originalMessageLevel
= ActionMessage
.messageLevel
;
1234 ActionMessage
.messageLevel
= actionMessageLevel
;
1238 Set FPDFileName parameter for this action class.
1240 @param fpdFilePath fpd file path
1242 public void setFPDFilePath(String fpdFilePath
) {
1243 this.fpdFilePath
= fpdFilePath
;
1247 Common function interface for outer.
1249 @param workspacePath The path of workspace of current build or analysis.
1250 @param fpdFilePath The fpd file path of current build or analysis.
1251 @param messageLevel The message level for this Action.
1253 @throws Exception The exception of this function. Because it can *not* be predict
1254 where the action class will be used. So only Exception can be throw.
1257 public void perform(String workspacePath
, String fpdFilePath
,
1258 int messageLevel
) throws Exception
{
1259 setWorkspacePath(workspacePath
);
1260 setFPDFilePath(fpdFilePath
);
1261 setActionMessageLevel(messageLevel
);
1264 ActionMessage
.messageLevel
= originalMessageLevel
;
1268 Core execution function for this action class.
1270 This function work flows will be:
1271 1) Collect and prepocess PCD information from FPD file, all PCD
1272 information will be stored into memory database.
1273 2) Generate 3 strings for
1274 a) All modules using Dynamic(Ex) PCD entry.(Token Number)
1275 b) PEI PCDDatabase (C Structure) for PCD Service PEIM.
1276 c) DXE PCD Database (C structure) for PCD Service DXE.
1279 @throws EntityException Exception indicate failed to execute this action.
1282 private void execute() throws EntityException
{
1284 // Get memoryDatabaseManager instance from GlobalData.
1285 // The memoryDatabaseManager should be initialized for whatever build
1286 // tools or wizard tools
1288 if((dbManager
= GlobalData
.getPCDMemoryDBManager()) == null) {
1289 throw new EntityException("The instance of PCD memory database manager is null");
1293 // Collect all PCD information defined in FPD file.
1294 // Evenry token defind in FPD will be created as an token into
1297 createTokenInDBFromFPD();
1300 // Call Private function genPcdDatabaseSourceCode (void); ComponentTypeBsDriver
1301 // 1) Generate for PEI, DXE PCD DATABASE's definition and initialization.
1303 genPcdDatabaseSourceCode ();
1308 This function generates source code for PCD Database.
1311 @throws EntityException If the token does *not* exist in memory database.
1314 private void genPcdDatabaseSourceCode()
1315 throws EntityException
{
1316 String PcdCommonHeaderString
= PcdDatabase
.getPcdDatabaseCommonDefinitions ();
1318 ArrayList
<Token
> alPei
= new ArrayList
<Token
> ();
1319 ArrayList
<Token
> alDxe
= new ArrayList
<Token
> ();
1321 dbManager
.getTwoPhaseDynamicRecordArray(alPei
, alDxe
);
1322 PcdDatabase pcdPeiDatabase
= new PcdDatabase (alPei
, "PEI", 0);
1323 pcdPeiDatabase
.genCode();
1324 dbManager
.PcdPeimHString
= PcdCommonHeaderString
+ pcdPeiDatabase
.getHString()
1325 + PcdDatabase
.getPcdPeiDatabaseDefinitions();
1326 dbManager
.PcdPeimCString
= pcdPeiDatabase
.getCString();
1328 PcdDatabase pcdDxeDatabase
= new PcdDatabase (alDxe
,
1332 pcdDxeDatabase
.genCode();
1333 dbManager
.PcdDxeHString
= dbManager
.PcdPeimHString
+ pcdDxeDatabase
.getHString()
1334 + PcdDatabase
.getPcdDxeDatabaseDefinitions();
1335 dbManager
.PcdDxeCString
= pcdDxeDatabase
.getCString();
1339 Get component array from FPD.
1341 This function maybe provided by some Global class.
1343 @return List<ModuleInfo> the component array.
1346 private List
<ModuleInfo
> getComponentsFromFPD()
1347 throws EntityException
{
1348 HashMap
<String
, XmlObject
> map
= new HashMap
<String
, XmlObject
>();
1349 List
<ModuleInfo
> allModules
= new ArrayList
<ModuleInfo
>();
1350 ModuleInfo current
= null;
1352 org
.tianocore
.Components components
= null;
1353 FrameworkModulesDocument
.FrameworkModules fModules
= null;
1354 java
.util
.List
<ModuleSADocument
.ModuleSA
> modules
= null;
1357 if (fpdDocInstance
== null) {
1359 fpdDocInstance
= (FrameworkPlatformDescriptionDocument
)XmlObject
.Factory
.parse(new File(fpdFilePath
));
1360 } catch(IOException ioE
) {
1361 throw new EntityException("File IO error for xml file:" + fpdFilePath
+ "\n" + ioE
.getMessage());
1362 } catch(XmlException xmlE
) {
1363 throw new EntityException("Can't parse the FPD xml fle:" + fpdFilePath
+ "\n" + xmlE
.getMessage());
1369 // Check whether FPD contians <FramworkModules>
1371 fModules
= fpdDocInstance
.getFrameworkPlatformDescription().getFrameworkModules();
1372 if (fModules
== null) {
1377 // BUGBUG: The following is work around code, the final component type should be get from
1378 // GlobalData class.
1380 components
= fModules
.getSEC();
1381 if (components
!= null) {
1382 modules
= components
.getModuleSAList();
1383 for (index
= 0; index
< modules
.size(); index
++) {
1384 allModules
.add(new ModuleInfo(modules
.get(index
), UsageInstance
.MODULE_TYPE
.SEC
));
1388 components
= fModules
.getPEICORE();
1389 if (components
!= null) {
1390 modules
= components
.getModuleSAList();
1391 for (index
= 0; index
< modules
.size(); index
++) {
1392 allModules
.add(new ModuleInfo(modules
.get(index
), UsageInstance
.MODULE_TYPE
.PEI_CORE
));
1396 components
= fModules
.getPEIM();
1397 if (components
!= null) {
1398 modules
= components
.getModuleSAList();
1399 for (index
= 0; index
< modules
.size(); index
++) {
1400 allModules
.add(new ModuleInfo(modules
.get(index
), UsageInstance
.MODULE_TYPE
.PEIM
));
1404 components
= fModules
.getDXECORE();
1405 if (components
!= null) {
1406 modules
= components
.getModuleSAList();
1407 for (index
= 0; index
< modules
.size(); index
++) {
1408 allModules
.add(new ModuleInfo(modules
.get(index
), UsageInstance
.MODULE_TYPE
.DXE_CORE
));
1412 components
= fModules
.getDXEDRIVERS();
1413 if (components
!= null) {
1414 modules
= components
.getModuleSAList();
1415 for (index
= 0; index
< modules
.size(); index
++) {
1416 allModules
.add(new ModuleInfo(modules
.get(index
), UsageInstance
.MODULE_TYPE
.DXE_DRIVERS
));
1420 components
= fModules
.getOTHERCOMPONENTS();
1421 if (components
!= null) {
1422 modules
= components
.getModuleSAList();
1423 for (index
= 0; index
< modules
.size(); index
++) {
1424 allModules
.add(new ModuleInfo(modules
.get(index
), UsageInstance
.MODULE_TYPE
.OTHER_COMPONENTS
));
1432 Create token instance object into memory database, the token information
1433 comes for FPD file. Normally, FPD file will contain all token platform
1436 @return FrameworkPlatformDescriptionDocument The FPD document instance for furture usage.
1438 @throws EntityException Failed to parse FPD xml file.
1441 private void createTokenInDBFromFPD()
1442 throws EntityException
{
1446 List
<PcdBuildDefinition
.PcdData
> pcdBuildDataArray
= new ArrayList
<PcdBuildDefinition
.PcdData
>();
1447 PcdBuildDefinition
.PcdData pcdBuildData
= null;
1449 SkuInstance skuInstance
= null;
1451 List
<ModuleInfo
> modules
= null;
1452 String primaryKey
= null;
1453 String exceptionString
= null;
1454 UsageInstance usageInstance
= null;
1455 String primaryKey1
= null;
1456 String primaryKey2
= null;
1457 boolean isDuplicate
= false;
1458 Token
.PCD_TYPE pcdType
= Token
.PCD_TYPE
.UNKNOWN
;
1459 Token
.DATUM_TYPE datumType
= Token
.DATUM_TYPE
.UNKNOWN
;
1460 int tokenNumber
= 0;
1461 String moduleName
= null;
1462 String datum
= null;
1463 int maxDatumSize
= 0;
1466 // ----------------------------------------------
1467 // 1), Get all <ModuleSA> from FPD file.
1468 // ----------------------------------------------
1470 modules
= getComponentsFromFPD();
1472 if (modules
== null) {
1473 throw new EntityException("[FPD file error] No modules in FPD file, Please check whether there are elements in <FrameworkModules> in FPD file!");
1477 // -------------------------------------------------------------------
1478 // 2), Loop all modules to process <PcdBuildDeclarations> for each module.
1479 // -------------------------------------------------------------------
1481 for (index
= 0; index
< modules
.size(); index
++) {
1482 isDuplicate
= false;
1483 for (index2
= 0; index2
< index
; index2
++) {
1485 // BUGBUG: For transition schema, we can *not* get module's version from
1486 // <ModuleSAs>, It is work around code.
1488 primaryKey1
= UsageInstance
.getPrimaryKey(modules
.get(index
).module
.getModuleName(),
1492 modules
.get(index
).module
.getArch().toString(),
1494 primaryKey2
= UsageInstance
.getPrimaryKey(modules
.get(index2
).module
.getModuleName(),
1498 modules
.get(index2
).module
.getArch().toString(),
1500 if (primaryKey1
.equalsIgnoreCase(primaryKey2
)) {
1511 // It is legal for a module does not contains ANY pcd build definitions.
1513 if (modules
.get(index
).module
.getPcdBuildDefinition() == null) {
1517 pcdBuildDataArray
= modules
.get(index
).module
.getPcdBuildDefinition().getPcdDataList();
1519 moduleName
= modules
.get(index
).module
.getModuleName();
1522 // ----------------------------------------------------------------------
1523 // 2.1), Loop all Pcd entry for a module and add it into memory database.
1524 // ----------------------------------------------------------------------
1526 for (pcdIndex
= 0; pcdIndex
< pcdBuildDataArray
.size(); pcdIndex
++) {
1527 pcdBuildData
= pcdBuildDataArray
.get(pcdIndex
);
1528 primaryKey
= Token
.getPrimaryKeyString(pcdBuildData
.getCName(),
1529 translateSchemaStringToUUID(pcdBuildData
.getTokenSpaceGuid()));
1530 pcdType
= Token
.getpcdTypeFromString(pcdBuildData
.getItemType().toString());
1531 datumType
= Token
.getdatumTypeFromString(pcdBuildData
.getDatumType().toString());
1532 tokenNumber
= Integer
.decode(pcdBuildData
.getToken().toString());
1533 datum
= pcdBuildData
.getValue();
1534 maxDatumSize
= pcdBuildData
.getMaxDatumSize();
1537 // Check <TokenSpaceGuid> is exist? In future, because all schema verification will tools
1538 // will check that, following checking code could be removed.
1540 if (pcdBuildData
.getTokenSpaceGuid() == null) {
1541 exceptionString
= String
.format("[FPD file error] There is no <TokenSpaceGuid> for PCD %s in module %s! This is required!",
1542 pcdBuildData
.getCName(),
1544 throw new EntityException(exceptionString
);
1548 // -------------------------------------------------------------------------------------------
1549 // 2.1.1), Do some necessary checking work for FixedAtBuild, FeatureFlag and PatchableInModule
1550 // -------------------------------------------------------------------------------------------
1552 if (!Token
.isDynamic(pcdType
)) {
1554 // Value is required.
1556 if (datum
== null) {
1557 exceptionString
= String
.format("[FPD file error] There is no value for PCD entry %s in module %s!",
1558 pcdBuildData
.getCName(),
1560 throw new EntityException(exceptionString
);
1564 // Check whether the datum size is matched datum type.
1566 if ((exceptionString
= verifyDatum(pcdBuildData
.getCName(),
1570 maxDatumSize
)) != null) {
1571 throw new EntityException(exceptionString
);
1576 // ---------------------------------------------------------------------------------
1577 // 2.1.2), Create token or update token information for current anaylized PCD data.
1578 // ---------------------------------------------------------------------------------
1580 if (dbManager
.isTokenInDatabase(primaryKey
)) {
1582 // If the token is already exist in database, do some necessary checking
1583 // and add a usage instance into this token in database
1585 token
= dbManager
.getTokenByKey(primaryKey
);
1588 // checking for DatumType, DatumType should be unique for one PCD used in different
1591 if (token
.datumType
!= datumType
) {
1592 exceptionString
= String
.format("[FPD file error] The datum type of PCD entry %s is %s, which is different with %s defined in before!",
1593 pcdBuildData
.getCName(),
1594 pcdBuildData
.getDatumType().toString(),
1595 Token
.getStringOfdatumType(token
.datumType
));
1596 throw new EntityException(exceptionString
);
1600 // Check token number is valid
1602 if (tokenNumber
!= token
.tokenNumber
) {
1603 exceptionString
= String
.format("[FPD file error] The token number of PCD entry %s in module %s is different with same PCD entry in other modules!",
1604 pcdBuildData
.getCName(),
1606 throw new EntityException(exceptionString
);
1610 // For same PCD used in different modules, the PCD type should all be dynamic or non-dynamic.
1612 if (token
.isDynamicPCD
!= Token
.isDynamic(pcdType
)) {
1613 exceptionString
= String
.format("[FPD file error] For PCD entry %s in module %s, you define dynamic or non-dynamic PCD type which"+
1614 "is different with others module's",
1617 throw new EntityException(exceptionString
);
1620 if (token
.isDynamicPCD
) {
1622 // Check datum is equal the datum in dynamic information.
1623 // For dynamic PCD, you can do not write <Value> in sperated every <PcdBuildDefinition> in different <ModuleSA>,
1624 // But if you write, the <Value> must be same as the value in <DynamicPcdBuildDefinitions>.
1626 if (!token
.isSkuEnable() &&
1627 (token
.getDefaultSku().type
== DynamicTokenValue
.VALUE_TYPE
.DEFAULT_TYPE
) &&
1629 if (!datum
.equalsIgnoreCase(token
.getDefaultSku().value
)) {
1630 exceptionString
= String
.format("[FPD file error] For dynamic PCD %s in module %s, the datum in <ModuleSA> is "+
1631 "not equal to the datum in <DynamicPcdBuildDefinitions>, it is "+
1632 "illega! You could no set <Value> in <ModuleSA> for a dynamic PCD!",
1635 throw new EntityException(exceptionString
);
1639 if ((maxDatumSize
!= 0) &&
1640 (maxDatumSize
!= token
.datumSize
)){
1641 exceptionString
= String
.format("[FPD file error] For dynamic PCD %s in module %s, the max datum size is %d which "+
1642 "is different with <MaxDatumSize> %d defined in <DynamicPcdBuildDefinitions>!",
1647 throw new EntityException(exceptionString
);
1653 // If the token is not in database, create a new token instance and add
1654 // a usage instance into this token in database.
1656 token
= new Token(pcdBuildData
.getCName(),
1657 translateSchemaStringToUUID(pcdBuildData
.getTokenSpaceGuid()));
1659 token
.datumType
= datumType
;
1660 token
.tokenNumber
= tokenNumber
;
1661 token
.isDynamicPCD
= Token
.isDynamic(pcdType
);
1662 token
.datumSize
= maxDatumSize
;
1664 if (token
.isDynamicPCD
) {
1666 // For Dynamic and Dynamic Ex type, need find the dynamic information
1667 // in <DynamicPcdBuildDefinition> section in FPD file.
1669 updateDynamicInformation(moduleName
,
1675 dbManager
.addTokenToDatabase(primaryKey
, token
);
1679 // -----------------------------------------------------------------------------------
1680 // 2.1.3), Add the PcdType in current module into this Pcd token's supported PCD type.
1681 // -----------------------------------------------------------------------------------
1683 token
.updateSupportPcdType(pcdType
);
1686 // ------------------------------------------------
1687 // 2.1.4), Create an usage instance for this token.
1688 // ------------------------------------------------
1690 usageInstance
= new UsageInstance(token
,
1695 modules
.get(index
).type
,
1697 modules
.get(index
).module
.getArch().toString(),
1701 token
.addUsageInstance(usageInstance
);
1707 Verify the datum value according its datum size and datum type, this
1708 function maybe moved to FPD verification tools in future.
1719 public String
verifyDatum(String cName
,
1722 Token
.DATUM_TYPE datumType
,
1724 String exceptionString
= null;
1730 if (moduleName
== null) {
1731 moduleName
= "section <DynamicPcdBuildDefinitions>";
1733 moduleName
= "module " + moduleName
;
1736 if (maxDatumSize
== 0) {
1737 exceptionString
= String
.format("[FPD file error] You maybe miss <MaxDatumSize> for PCD %s in %s",
1740 return exceptionString
;
1743 switch (datumType
) {
1745 if (maxDatumSize
!= 1) {
1746 exceptionString
= String
.format("[FPD file error] The datum type of PCD data %s in %s "+
1747 "is UINT8, but datum size is %d, they are not matched!",
1751 return exceptionString
;
1754 if (datum
!= null) {
1756 value
= Integer
.decode(datum
);
1757 } catch (NumberFormatException nfeExp
) {
1758 exceptionString
= String
.format("[FPD file error] The datum for PCD %s in %s is not valid "+
1759 "digital format of UINT8",
1762 return exceptionString
;
1765 exceptionString
= String
.format("[FPD file error] The datum for PCD %s in %s is %s exceed"+
1766 " the max size of UINT8 - 0xFF",
1770 return exceptionString
;
1775 if (maxDatumSize
!= 2) {
1776 exceptionString
= String
.format("[FPD file error] The datum type of PCD data %s in %s "+
1777 "is UINT16, but datum size is %d, they are not matched!",
1781 return exceptionString
;
1783 if (datum
!= null) {
1785 value
= Integer
.decode(datum
);
1786 } catch (NumberFormatException nfeExp
) {
1787 exceptionString
= String
.format("[FPD file error] The datum for PCD %s in %s is "+
1788 "not valid digital of UINT16",
1791 return exceptionString
;
1793 if (value
> 0xFFFF) {
1794 exceptionString
= String
.format("[FPD file error] The datum for PCD %s in %s is %s "+
1795 "which exceed the range of UINT16 - 0xFFFF",
1799 return exceptionString
;
1804 if (maxDatumSize
!= 4) {
1805 exceptionString
= String
.format("[FPD file error] The datum type of PCD data %s in %s "+
1806 "is UINT32, but datum size is %d, they are not matched!",
1810 return exceptionString
;
1813 if (datum
!= null) {
1815 if (datum
.length() > 2) {
1816 if ((datum
.charAt(0) == '0') &&
1817 ((datum
.charAt(1) == 'x') || (datum
.charAt(1) == 'X'))){
1818 subStr
= datum
.substring(2, datum
.length());
1819 value64
= new BigInteger(subStr
, 16);
1821 value64
= new BigInteger(datum
);
1824 value64
= new BigInteger(datum
);
1826 } catch (NumberFormatException nfeExp
) {
1827 exceptionString
= String
.format("[FPD file error] The datum for PCD %s in %s is not "+
1828 "valid digital of UINT32",
1831 return exceptionString
;
1834 if (value64
.bitLength() > 32) {
1835 exceptionString
= String
.format("[FPD file error] The datum for PCD %s in %s is %s which "+
1836 "exceed the range of UINT32 - 0xFFFFFFFF",
1840 return exceptionString
;
1845 if (maxDatumSize
!= 8) {
1846 exceptionString
= String
.format("[FPD file error] The datum type of PCD data %s in %s "+
1847 "is UINT64, but datum size is %d, they are not matched!",
1851 return exceptionString
;
1854 if (datum
!= null) {
1856 if (datum
.length() > 2) {
1857 if ((datum
.charAt(0) == '0') &&
1858 ((datum
.charAt(1) == 'x') || (datum
.charAt(1) == 'X'))){
1859 subStr
= datum
.substring(2, datum
.length());
1860 value64
= new BigInteger(subStr
, 16);
1862 value64
= new BigInteger(datum
);
1865 value64
= new BigInteger(datum
);
1867 } catch (NumberFormatException nfeExp
) {
1868 exceptionString
= String
.format("[FPD file error] The datum for PCD %s in %s is not valid"+
1869 " digital of UINT64",
1872 return exceptionString
;
1875 if (value64
.bitLength() > 64) {
1876 exceptionString
= String
.format("[FPD file error] The datum for PCD %s in %s is %s "+
1877 "exceed the range of UINT64 - 0xFFFFFFFFFFFFFFFF",
1881 return exceptionString
;
1886 if (maxDatumSize
!= 1) {
1887 exceptionString
= String
.format("[FPD file error] The datum type of PCD data %s in %s "+
1888 "is BOOLEAN, but datum size is %d, they are not matched!",
1892 return exceptionString
;
1895 if (datum
!= null) {
1896 if (!(datum
.equalsIgnoreCase("TRUE") ||
1897 datum
.equalsIgnoreCase("FALSE"))) {
1898 exceptionString
= String
.format("[FPD file error] The datum type of PCD data %s in %s "+
1899 "is BOOELAN, but value is not 'true'/'TRUE' or 'FALSE'/'false'",
1902 return exceptionString
;
1908 if (datum
== null) {
1912 char ch
= datum
.charAt(0);
1916 // For void* type PCD, only three datum is support:
1917 // 1) Unicode: string with start char is "L"
1918 // 2) Ansci: String start char is ""
1919 // 3) byte array: String start char "{"
1922 start
= datum
.indexOf('\"');
1923 end
= datum
.lastIndexOf('\"');
1924 if ((start
> end
) ||
1925 (end
> datum
.length())||
1926 ((start
== end
) && (datum
.length() > 0))) {
1927 exceptionString
= String
.format("[FPD file error] The datum type of PCD %s in %s is VOID* and datum is "+
1928 "a UNICODE string because start with L\", but format maybe"+
1929 "is not right, correct UNICODE string is L\"...\"!",
1932 return exceptionString
;
1935 strValue
= datum
.substring(start
+ 1, end
);
1936 if ((strValue
.length() * 2) > maxDatumSize
) {
1937 exceptionString
= String
.format("[FPD file error] The datum type of PCD %s in %s is VOID*, and datum is "+
1938 "a UNICODE string, but the datum size is %d exceed to <MaxDatumSize> : %d",
1941 strValue
.length() * 2,
1943 return exceptionString
;
1945 } else if (ch
== '\"'){
1946 start
= datum
.indexOf('\"');
1947 end
= datum
.lastIndexOf('\"');
1948 if ((start
> end
) ||
1949 (end
> datum
.length())||
1950 ((start
== end
) && (datum
.length() > 0))) {
1951 exceptionString
= String
.format("[FPD file error] The datum type of PCD %s in %s is VOID* and datum is "+
1952 "a ANSCII string because start with \", but format maybe"+
1953 "is not right, correct ANSIC string is \"...\"!",
1956 return exceptionString
;
1958 strValue
= datum
.substring(start
+ 1, end
);
1959 if ((strValue
.length()) > maxDatumSize
) {
1960 exceptionString
= String
.format("[FPD file error] The datum type of PCD %s in %s is VOID*, and datum is "+
1961 "a ANSCI string, but the datum size is %d which exceed to <MaxDatumSize> : %d",
1966 return exceptionString
;
1968 } else if (ch
=='{') {
1969 String
[] strValueArray
;
1971 start
= datum
.indexOf('{');
1972 end
= datum
.lastIndexOf('}');
1973 strValue
= datum
.substring(start
+ 1, end
);
1974 strValue
= strValue
.trim();
1975 if (strValue
.length() == 0) {
1978 strValueArray
= strValue
.split(",");
1979 for (index
= 0; index
< strValueArray
.length
; index
++) {
1981 value
= Integer
.decode(strValueArray
[index
].trim());
1982 } catch (NumberFormatException nfeEx
) {
1983 exceptionString
= String
.format("[FPD file error] The datum type of PCD %s in %s is VOID*, and "+
1984 "it is byte array in fact. For every byte in array should be a valid"+
1985 "byte digital, but element %s is not a valid byte digital!",
1988 strValueArray
[index
]);
1989 return exceptionString
;
1992 exceptionString
= String
.format("[FPD file error] The datum type of PCD %s in %s is VOID*, "+
1993 "it is byte array in fact. But the element of %s exceed the byte range",
1996 strValueArray
[index
]);
1997 return exceptionString
;
2001 if (strValueArray
.length
> maxDatumSize
) {
2002 exceptionString
= String
.format("[FPD file error] The datum type of PCD %s in %s is VOID*, and datum is byte"+
2003 "array, but the number of bytes is %d which exceed to <MaxDatumSzie> : %d!",
2006 strValueArray
.length
,
2008 return exceptionString
;
2011 exceptionString
= String
.format("[FPD file error] The datum type of PCD %s in %s is VOID*. For VOID* type, you have three format choise:\n "+
2012 "1) UNICODE string: like L\"xxxx\";\r\n"+
2013 "2) ANSIC string: like \"xxx\";\r\n"+
2014 "3) Byte array: like {0x2, 0x45, 0x23}\r\n"+
2015 "But the datum in seems does not following above format!",
2018 return exceptionString
;
2022 exceptionString
= String
.format("[FPD file error] For PCD entry %s in %s, datum type is unknown, it should be one of "+
2023 "UINT8, UINT16, UINT32, UINT64, VOID*, BOOLEAN",
2026 return exceptionString
;
2032 Get dynamic information for a dynamic PCD from <DynamicPcdBuildDefinition> seciton in FPD file.
2034 This function should be implemented in GlobalData in future.
2036 @param token The token instance which has hold module's PCD information
2037 @param moduleName The name of module who will use this Dynamic PCD.
2039 @return DynamicPcdBuildDefinitions.PcdBuildData
2042 private DynamicPcdBuildDefinitions
.PcdBuildData
getDynamicInfoFromFPD(Token token
,
2044 throws EntityException
{
2046 String exceptionString
= null;
2047 String dynamicPrimaryKey
= null;
2048 DynamicPcdBuildDefinitions dynamicPcdBuildDefinitions
= null;
2049 List
<DynamicPcdBuildDefinitions
.PcdBuildData
> dynamicPcdBuildDataArray
= null;
2052 // If FPD document is not be opened, open and initialize it.
2054 if (fpdDocInstance
== null) {
2056 fpdDocInstance
= (FrameworkPlatformDescriptionDocument
)XmlObject
.Factory
.parse(new File(fpdFilePath
));
2057 } catch(IOException ioE
) {
2058 throw new EntityException("File IO error for xml file:" + fpdFilePath
+ "\n" + ioE
.getMessage());
2059 } catch(XmlException xmlE
) {
2060 throw new EntityException("Can't parse the FPD xml fle:" + fpdFilePath
+ "\n" + xmlE
.getMessage());
2064 dynamicPcdBuildDefinitions
= fpdDocInstance
.getFrameworkPlatformDescription().getDynamicPcdBuildDefinitions();
2065 if (dynamicPcdBuildDefinitions
== null) {
2066 exceptionString
= String
.format("[FPD file error] There are no <PcdDynamicBuildDescriptions> in FPD file but contains Dynamic type "+
2067 "PCD entry %s in module %s!",
2070 throw new EntityException(exceptionString
);
2073 dynamicPcdBuildDataArray
= dynamicPcdBuildDefinitions
.getPcdBuildDataList();
2074 for (index
= 0; index
< dynamicPcdBuildDataArray
.size(); index
++) {
2076 // Check <TokenSpaceGuid> is exist? In future, because all schema verification will tools
2077 // will check that, following checking code could be removed.
2079 if (dynamicPcdBuildDataArray
.get(index
).getTokenSpaceGuid() == null) {
2080 exceptionString
= String
.format("[FPD file error] There is no <TokenSpaceGuid> for PCD %s in <DynamicPcdBuildDefinitions>! This is required!",
2081 dynamicPcdBuildDataArray
.get(index
).getCName());
2082 throw new EntityException(exceptionString
);
2085 dynamicPrimaryKey
= Token
.getPrimaryKeyString(dynamicPcdBuildDataArray
.get(index
).getCName(),
2086 translateSchemaStringToUUID(dynamicPcdBuildDataArray
.get(index
).getTokenSpaceGuid()));
2087 if (dynamicPrimaryKey
.equalsIgnoreCase(token
.getPrimaryKeyString())) {
2088 return dynamicPcdBuildDataArray
.get(index
);
2096 Update dynamic information for PCD entry.
2098 Dynamic information is retrieved from <PcdDynamicBuildDeclarations> in
2101 @param moduleName The name of the module who use this PCD
2102 @param token The token instance
2103 @param datum The <datum> in module's PCD information
2104 @param maxDatumSize The <maxDatumSize> in module's PCD information
2108 private Token
updateDynamicInformation(String moduleName
,
2112 throws EntityException
{
2115 String exceptionString
= null;
2116 DynamicTokenValue dynamicValue
;
2117 SkuInstance skuInstance
= null;
2119 boolean hasSkuId0
= false;
2120 Token
.PCD_TYPE pcdType
= Token
.PCD_TYPE
.UNKNOWN
;
2121 int tokenNumber
= 0;
2123 List
<DynamicPcdBuildDefinitions
.PcdBuildData
.SkuInfo
> skuInfoList
= null;
2124 DynamicPcdBuildDefinitions
.PcdBuildData dynamicInfo
= null;
2126 dynamicInfo
= getDynamicInfoFromFPD(token
, moduleName
);
2127 if (dynamicInfo
== null) {
2128 exceptionString
= String
.format("[FPD file error] For Dynamic PCD %s used by module %s, "+
2129 "there is no dynamic information in <DynamicPcdBuildDefinitions> "+
2130 "in FPD file, but it is required!",
2133 throw new EntityException(exceptionString
);
2136 token
.datumSize
= dynamicInfo
.getMaxDatumSize();
2138 exceptionString
= verifyDatum(token
.cName
,
2143 if (exceptionString
!= null) {
2144 throw new EntityException(exceptionString
);
2147 if ((maxDatumSize
!= 0) &&
2148 (maxDatumSize
!= token
.datumSize
)) {
2149 exceptionString
= String
.format("FPD file error] For dynamic PCD %s, the datum size in module %s is %d, but "+
2150 "the datum size in <DynamicPcdBuildDefinitions> is %d, they are not match!",
2154 dynamicInfo
.getMaxDatumSize());
2155 throw new EntityException(exceptionString
);
2157 tokenNumber
= Integer
.decode(dynamicInfo
.getToken().toString());
2158 if (tokenNumber
!= token
.tokenNumber
) {
2159 exceptionString
= String
.format("[FPD file error] For dynamic PCD %s, the token number in module %s is 0x%x, but"+
2160 "in <DynamicPcdBuildDefinictions>, the token number is 0x%x, they are not match!",
2165 throw new EntityException(exceptionString
);
2168 pcdType
= Token
.getpcdTypeFromString(dynamicInfo
.getItemType().toString());
2169 if (pcdType
== Token
.PCD_TYPE
.DYNAMIC_EX
) {
2170 token
.dynamicExTokenNumber
= tokenNumber
;
2173 skuInfoList
= dynamicInfo
.getSkuInfoList();
2176 // Loop all sku data
2178 for (index
= 0; index
< skuInfoList
.size(); index
++) {
2179 skuInstance
= new SkuInstance();
2181 // Although SkuId in schema is BigInteger, but in fact, sku id is 32 bit value.
2183 temp
= skuInfoList
.get(index
).getSkuId().toString();
2184 skuInstance
.id
= Integer
.decode(temp
);
2185 if (skuInstance
.id
== 0) {
2189 // Judge whether is DefaultGroup at first, because most case is DefautlGroup.
2191 if (skuInfoList
.get(index
).getValue() != null) {
2192 skuInstance
.value
.setValue(skuInfoList
.get(index
).getValue());
2193 if ((exceptionString
= verifyDatum(token
.cName
,
2195 skuInfoList
.get(index
).getValue(),
2197 token
.datumSize
)) != null) {
2198 throw new EntityException(exceptionString
);
2201 token
.skuData
.add(skuInstance
);
2204 // Judege wether is same of datum between module's information
2205 // and dynamic information.
2207 if (datum
!= null) {
2208 if ((skuInstance
.id
== 0) &&
2209 !datum
.equalsIgnoreCase(skuInfoList
.get(index
).getValue())) {
2210 exceptionString
= "[FPD file error] For dynamic PCD " + token
.cName
+ ", the value in module " + moduleName
+ " is " + datum
.toString() + " but the "+
2211 "value of sku 0 data in <DynamicPcdBuildDefinition> is " + skuInstance
.value
.value
+ ". They are must be same!"+
2212 " or you could not define value for a dynamic PCD in every <ModuleSA>!";
2213 throw new EntityException(exceptionString
);
2220 // Judge whether is HII group case.
2222 if (skuInfoList
.get(index
).getVariableName() != null) {
2223 exceptionString
= null;
2224 if (skuInfoList
.get(index
).getVariableGuid() == null) {
2225 exceptionString
= String
.format("[FPD file error] For dynamic PCD %s in <DynamicPcdBuildDefinitions> section in FPD "+
2226 "file, who use HII, but there is no <VariableGuid> defined for Sku %d data!",
2232 if (skuInfoList
.get(index
).getVariableOffset() == null) {
2233 exceptionString
= String
.format("[FPD file error] For dynamic PCD %s in <DynamicPcdBuildDefinitions> section in FPD "+
2234 "file, who use HII, but there is no <VariableOffset> defined for Sku %d data!",
2239 if (skuInfoList
.get(index
).getHiiDefaultValue() == null) {
2240 exceptionString
= String
.format("[FPD file error] For dynamic PCD %s in <DynamicPcdBuildDefinitions> section in FPD "+
2241 "file, who use HII, but there is no <HiiDefaultValue> defined for Sku %d data!",
2246 if (exceptionString
!= null) {
2247 throw new EntityException(exceptionString
);
2250 if ((exceptionString
= verifyDatum(token
.cName
,
2252 skuInfoList
.get(index
).getHiiDefaultValue(),
2254 token
.datumSize
)) != null) {
2255 throw new EntityException(exceptionString
);
2258 offset
= Integer
.decode(skuInfoList
.get(index
).getVariableOffset());
2259 if (offset
> 0xFFFF) {
2260 throw new EntityException(String
.format("[FPD file error] For dynamic PCD %s , the variable offset defined in sku %d data "+
2261 "exceed 64K, it is not allowed!",
2266 skuInstance
.value
.setHiiData(skuInfoList
.get(index
).getVariableName(),
2267 translateSchemaStringToUUID(skuInfoList
.get(index
).getVariableGuid().toString()),
2268 skuInfoList
.get(index
).getVariableOffset(),
2269 skuInfoList
.get(index
).getHiiDefaultValue());
2270 token
.skuData
.add(skuInstance
);
2274 if (skuInfoList
.get(index
).getVpdOffset() != null) {
2275 skuInstance
.value
.setVpdData(skuInfoList
.get(index
).getVpdOffset());
2276 token
.skuData
.add(skuInstance
);
2280 exceptionString
= String
.format("[FPD file error] For dynamic PCD %s, the dynamic info must "+
2281 "be one of 'DefaultGroup', 'HIIGroup', 'VpdGroup'.",
2283 throw new EntityException(exceptionString
);
2287 exceptionString
= String
.format("[FPD file error] For dynamic PCD %s in <DynamicPcdBuildDefinitions>, there are "+
2288 "no sku id = 0 data, which is required for every dynamic PCD",
2290 throw new EntityException(exceptionString
);
2297 Translate the schema string to UUID instance.
2299 In schema, the string of UUID is defined as following two types string:
2300 1) GuidArrayType: pattern = 0x[a-fA-F0-9]{1,8},( )*0x[a-fA-F0-9]{1,4},(
2301 )*0x[a-fA-F0-9]{1,4}(,( )*\{)?(,?( )*0x[a-fA-F0-9]{1,2}){8}( )*(\})?
2303 2) GuidNamingConvention: pattern =
2304 [a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}
2306 This function will convert string and create uuid instance.
2308 @param uuidString UUID string in XML file
2310 @return UUID UUID instance
2312 private UUID
translateSchemaStringToUUID(String uuidString
)
2313 throws EntityException
{
2315 String
[] splitStringArray
;
2320 if (uuidString
== null) {
2324 if (uuidString
.length() == 0) {
2328 if (uuidString
.equals("0") ||
2329 uuidString
.equalsIgnoreCase("0x0")) {
2330 return new UUID(0, 0);
2334 // If the UUID schema string is GuidArrayType type then need translate
2335 // to GuidNamingConvention type at first.
2337 if ((uuidString
.charAt(0) == '0') && ((uuidString
.charAt(1) == 'x') || (uuidString
.charAt(1) == 'X'))) {
2338 splitStringArray
= uuidString
.split("," );
2339 if (splitStringArray
.length
!= 11) {
2340 throw new EntityException ("[FPD file error] Wrong format for UUID string: " + uuidString
);
2344 // Remove blank space from these string and remove header string "0x"
2346 for (index
= 0; index
< 11; index
++) {
2347 splitStringArray
[index
] = splitStringArray
[index
].trim();
2348 splitStringArray
[index
] = splitStringArray
[index
].substring(2, splitStringArray
[index
].length());
2352 // Add heading '0' to normalize the string length
2354 for (index
= 3; index
< 11; index
++) {
2355 chLen
= splitStringArray
[index
].length();
2356 for (chIndex
= 0; chIndex
< 2 - chLen
; chIndex
++) {
2357 splitStringArray
[index
] = "0" + splitStringArray
[index
];
2362 // construct the final GuidNamingConvention string
2364 temp
= String
.format("%s-%s-%s-%s%s-%s%s%s%s%s%s",
2365 splitStringArray
[0],
2366 splitStringArray
[1],
2367 splitStringArray
[2],
2368 splitStringArray
[3],
2369 splitStringArray
[4],
2370 splitStringArray
[5],
2371 splitStringArray
[6],
2372 splitStringArray
[7],
2373 splitStringArray
[8],
2374 splitStringArray
[9],
2375 splitStringArray
[10]);
2379 return UUID
.fromString(uuidString
);
2383 check parameter for this action.
2385 @throws EntityException Bad parameter.
2387 private void checkParameter() throws EntityException
{
2390 if((fpdFilePath
== null) ||(workspacePath
== null)) {
2391 throw new EntityException("WorkspacePath and FPDFileName should be blank for CollectPCDAtion!");
2394 if(fpdFilePath
.length() == 0 || workspacePath
.length() == 0) {
2395 throw new EntityException("WorkspacePath and FPDFileName should be blank for CollectPCDAtion!");
2398 file
= new File(workspacePath
);
2399 if(!file
.exists()) {
2400 throw new EntityException("WorkpacePath " + workspacePath
+ " does not exist!");
2403 file
= new File(fpdFilePath
);
2405 if(!file
.exists()) {
2406 throw new EntityException("FPD File " + fpdFilePath
+ " does not exist!");
2413 @param argv parameter from command line
2415 public static void main(String argv
[]) throws EntityException
{
2416 CollectPCDAction ca
= new CollectPCDAction();
2417 ca
.setWorkspacePath("m:/tianocore_latest/edk2");
2418 ca
.setFPDFilePath("m:/tianocore_latest/edk2/EdkNt32Pkg/Nt32.fpd");
2419 ca
.setActionMessageLevel(ActionMessage
.MAX_MESSAGE_LEVEL
);
2420 GlobalData
.initInfo("Tools" + File
.separator
+ "Conf" + File
.separator
+ "FrameworkDatabase.db",
2421 "m:/tianocore_latest/edk2");