1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
|
##
# This file is used to document mismatches between Intel Platform Innovation Framework specification
# (http://www.intel.com/technology/framework/spec.htm) and data structures defind at IntelFrameworkPkg
# package in EdkII Open Source Project (https://edk2.tianocore.org/source/browse/edk2/trunk/edk2/IntelFrameworkPkg)
##
##
# The general consideration about keeping the mismatches in EdkII:
# 1. Some definitions defined in Framework specification may bring a little complexity on implementation. EdkII
# makes changes on them from the view of code development.
# 2. Some definitions are NOT defined in Framework specification, but introduced in Edk. EdkII chooses to keep
# them for backward-compatibility.
# 3. The name of some definitions are NOT consistent with Framework specification. If the name doesn't bring
# misunderstanding literally, EdkII chooses to keep them for backward-compatibility.
# 4. Some defintitions don't exactly match Framework specification, some new field members are introduced in EdkII
# to reflect the latest industry standard.
#
# Note:
# The IntelFrameworkPkg contains Framework specification contents that were not adopted by UEFI/PI, and names may be
# changed (such as adding "FRAMEWORK_") to avoid name collisions with approved UEFI/PI specifications.
##
##
# Mismatch with Intel Platform Innovation Framework for DataHubSubclass Specification (Version 0.90)
##
1. Guid/DataHubRecords.h
#define EFI_STRING_TOKEN UINT16
This macro named "EFI_STRING_TOKEN" is *NOT* defined in Framework specification. Keeping this inconsistency
for backward compatibility.
2. Guid/DataHubRecords.h
#pragma pack(1)
typedef struct {
UINT8 LastPciBus;
} EFI_MISC_LAST_PCI_BUS_DATA;
...
typedef struct {
EFI_SUBCLASS_TYPE1_HEADER Header;
EFI_MISC_SUBCLASS_RECORDS Record;
} EFI_MISC_SUBCLASS_DRIVER_DATA;
#pragma pack()
Section "Alignment" in DataHubSubclass specification say "Fields in a data hub record should be aligned at their
natural boundaries". But in EdkII, the data structures above are packed.
Keeping this inconsistency for backward compatibility.
3. Guid/DataHubRecords.h
#define EFI_SUBCLASS_INSTANCE_RESERVED 0
#define EFI_SUBCLASS_INSTANCE_NON_APPLICABLE 0xFFFF
The symbols above are *NOT* defined in DataHubSubclass specification. But the values are defined and are meaningful.
According to DataHubSubclass spec, value 0 means Reserved and -1 means Not Applicable. EdkII introduces these macros
to faciliate user development.
##
# Mismatch with Intel Platform Innovation Framework for CacheSubclass Specification (Version 0.90)
##
1. Guid/DataHubRecords.h
typedef EFI_EXP_BASE2_DATA EFI_MAXIMUM_CACHE_SIZE_DATA;
The definition named "EFI_MAXIMUM_CACHE_SIZE_DATA" is *NOT* consistent with CacheSubclass specification, in which
the name should be EFI_CACHE_MAXIMUM_SIZE_DATA. Keeping this inconsistency for backward compatibility.
2. Guid/DataHubRecords.h
typedef struct {
UINT32 Level :3;
UINT32 Socketed :1;
UINT32 Reserved2 :1;
UINT32 Location :2;
UINT32 Enable :1;
UINT32 OperationalMode :2;
UINT32 Reserved1 :22;
} EFI_CACHE_CONFIGURATION_DATA;
The field type of the definition is *NOT* consistent with CacheSubclass specification. Specification defines
them as UINT16, which is incorrect and should be UINT32 because the total width of bit-fields is 32bits width.
3. Guid/DataHubRecords.h
typedef enum {
CacheSizeRecordType = 1,
MaximumSizeCacheRecordType = 2,
CacheSpeedRecordType = 3,
CacheSocketRecordType = 4,
CacheSramTypeRecordType = 5,
CacheInstalledSramTypeRecordType = 6,
CacheErrorTypeRecordType = 7,
CacheTypeRecordType = 8,
CacheAssociativityRecordType = 9,
CacheConfigRecordType = 10
} EFI_CACHE_VARIABLE_RECORD_TYPE;
The data structure and all enumeration fields are *NOT* defined in CacheSubclass specification, which only
defines the following macros to specify the record number of the data record:
#define EFI_CACHE_SIZE_RECORD_NUMBER 0x00000001
#define EFI_CACHE_MAXIMUM_SIZE_RECORD_NUMBER 0x00000002
#define EFI_CACHE_SPEED_RECORD_NUMBER 0x00000003
#define EFI_CACHE_SOCKET_RECORD_NUMBER 0x00000004
#define EFI_CACHE_SRAM_SUPPORT_RECORD_NUMBER 0x00000005
#define EFI_CACHE_SRAM_INSTALL_RECORD_NUMBER 0x00000006
#define EFI_CACHE_ERROR_SUPPORT_RECORD_NUMBER 0x00000007
#define EFI_CACHE_TYPE_RECORD_NUMBER 0x00000008
#define EFI_CACHE_ASSOCIATIVITY_RECORD_NUMBER 0x00000009
#define EFI_CACHE_CONFIGURATION_RECORD_NUMBER 0x0000000A
Keeping this inconsistency for backward compatibility.
4. Guid/DataHubRecords.h
typedef union {
EFI_CACHE_SIZE_DATA CacheSize;
...
EFI_CACHE_ASSOCIATION_DATA CacheAssociation;
} EFI_CACHE_VARIABLE_RECORD;
typedef struct {
EFI_SUBCLASS_TYPE1_HEADER DataRecordHeader;
EFI_CACHE_VARIABLE_RECORD VariableRecord;
} EFI_CACHE_DATA_RECORD;
The definitions above are *NOT* defined in CacheSubclass specification. EdkII introduces them to simplify the
code logic. Therefore developer doesn't need to allocate memory dynamically to construct variable length data record.
Keeping this inconsistency for backward compatibility.
##
# Mismatch with Intel Platform Innovation Framework for ProcSubclass Specification (Version 0.90)
##
1. Guid/DataHubRecords.h
#define EFI_PROCESSOR_SUBCLASS_VERSION 0x00010000
The value of the definition is *NOT* consistent with ProcSubclass specification, in which the value is 0x0100.
Keeping this inconsistency from the perspective of binary consistency.
2. Guid/DataHubRecords.h
typedef struct {
UINT32 ProcessorBrandIndex :8;
UINT32 ProcessorClflush :8;
UINT32 ProcessorReserved :8;
UINT32 ProcessorDfltApicId :8;
} EFI_PROCESSOR_MISC_INFO;
The definition is *NOT* consistent with ProcSubclass specification, in which the name of third field is defined
as "LogicalProcessorCount" rather than "ProcessorReserved".
Keeping this inconsistency for backward compatibility.
3. Guid/DataHubRecords.h
typedef enum {
...
EfiProcessorFamilyUltraSparcIIIi = 0x58,
...
EfiProcessorFamilyIntelPentiumM = 0xB9,
EfiProcessorFamilyIntelCeleronD = 0xBA,
EfiProcessorFamilyIntelPentiumD = 0xBB,
EfiProcessorFamilyIntelPentiumEx = 0xBC,
EfiProcessorFamilyIntelCoreSolo = 0xBD,
EfiProcessorFamilyReserved = 0xBE,
EfiProcessorFamilyIntelCore2 = 0xBF,
...
EfiProcessorFamilyG6 = 0xCB,
EfiProcessorFamilyzArchitectur = 0xCC,
EfiProcessorFamilyViaC7M = 0xD2,
EfiProcessorFamilyViaC7D = 0xD3,
EfiProcessorFamilyViaC7 = 0xD4,
EfiProcessorFamilyViaEden = 0xD5,
...
EfiProcessorFamilyIndicatorFamily2 = 0xFE,
EfiProcessorFamilyReserved1 = 0xFF
} EFI_PROCESSOR_FAMILY_DATA;
a. In ProcSubclass specification 0.9, the field name whose value equals to 0x58 is "EfiProcessorFamilyUltraSparcIIi".
Due to the name has been defined in previous field, changing it to "EfiProcessorFamilyUltraSparcIIIi" to avoid
build break.
b. The other fields listed here are *NOT* defined in ProcSubclass specification 0.9. They are introduced to
support new processor family (type 4) defined in SmBios 2.6 specification.
Keeping this inconsistency to reflect the latest industry standard.
4. Guid/DataHubRecords.h
typedef enum {
...
EfiProcessorSocket939 = 0x12,
EfiProcessorSocketmPGA604 = 0x13,
EfiProcessorSocketLGA771 = 0x14,
EfiProcessorSocketLGA775 = 0x15
} EFI_PROCESSOR_SOCKET_TYPE_DATA;
The fields listed here are *NOT* defined in ProcSubclass specification 0.9. They are introduced to support
new processor upgrade (type 4 offset 19h) defined in SmBios 2.6 specification.
Keeping this inconsistency to reflect the latest industry standard.
5. Guid/DataHubRecords.h
typedef EFI_INTER_LINK_DATA EFI_CACHE_ASSOCIATION_DATA;
The definition name "EFI_CACHE_ASSOCIATION_DATA" is *NOT* consistent with ProcSubclass specification 0.9, in which
the name should be "EFI_PROCESSOR_CACHE_ASSOCIATION_DATA". Keeping this inconsistency for backward compatibility.
6. Guid/DataHubRecords.h
typedef enum {
EfiProcessorHealthy = 1,
EfiProcessorPerfRestricted = 2,
EfiProcessorFuncRestricted = 3
} EFI_PROCESSOR_HEALTH_STATUS;
The structure name "EFI_PROCESSOR_HEALTH_STATUS" is *NOT* consistent with ProcSubclass specification 0.9, in which
the name should be "EFI_PROCESSOR_HEALTH_STATUS_DATA". Keeping this inconsistency for backward compatibility.
7. Guid/DataHubRecords.h
typedef enum {
ProcessorCoreFrequencyRecordType = 1,
ProcessorFsbFrequencyRecordType = 2,
ProcessorVersionRecordType = 3,
ProcessorManufacturerRecordType = 4,
ProcessorSerialNumberRecordType = 5,
ProcessorIdRecordType = 6,
ProcessorTypeRecordType = 7,
ProcessorFamilyRecordType = 8,
ProcessorVoltageRecordType = 9,
ProcessorApicBaseAddressRecordType = 10,
ProcessorApicIdRecordType = 11,
ProcessorApicVersionNumberRecordType = 12,
CpuUcodeRevisionDataRecordType = 13,
ProcessorStatusRecordType = 14,
ProcessorSocketTypeRecordType = 15,
ProcessorSocketNameRecordType = 16,
CacheAssociationRecordType = 17,
ProcessorMaxCoreFrequencyRecordType = 18,
ProcessorAssetTagRecordType = 19,
ProcessorMaxFsbFrequencyRecordType = 20,
ProcessorPackageNumberRecordType = 21,
ProcessorCoreFrequencyListRecordType = 22,
ProcessorFsbFrequencyListRecordType = 23,
ProcessorHealthStatusRecordType = 24
} EFI_CPU_VARIABLE_RECORD_TYPE;
The data structure and all enumeration fields are *NOT* defined in ProcSubclass specification 0.9, which only
defines the following macros to specify the record number of the data record:
#define EFI_PROCESSOR_FREQUENCY_RECORD_NUMBER 0x00000001
#define EFI_PROCESSOR_BUS_FREQUENCY_RECORD_NUMBER 0x00000002
#define EFI_PROCESSOR_VERSION_RECORD_NUMBER 0x00000003
#define EFI_PROCESSOR_MANUFACTURER_RECORD_NUMBER 0x00000004
#define EFI_PROCESSOR_SERIAL_NUMBER_RECORD_NUMBER 0x00000005
#define EFI_PROCESSOR_ID_RECORD_NUMBER 0x00000006
#define EFI_PROCESSOR_TYPE_RECORD_NUMBER 0x00000007
#define EFI_PROCESSOR_FAMILY_RECORD_NUMBER 0x00000008
#define EFI_PROCESSOR_VOLTAGE_RECORD_NUMBER 0x00000009
#define EFI_PROCESSOR_APIC_BASE_ADDRESS_RECORD_NUMBER 0x0000000A
#define EFI_PROCESSOR_APIC_ID_RECORD_NUMBER 0x0000000B
#define EFI_PROCESSOR_APIC_VER_NUMBER_RECORD_NUMBER 0x0000000C
#define EFI_PROCESSOR_MICROCODE_REVISION_RECORD_NUMBER 0x0000000D
#define EFI_PROCESSOR_STATUS_RECORD_NUMBER 0x0000000E
#define EFI_PROCESSOR_SOCKET_TYPE_RECORD_NUMBER 0x0000000F
#define EFI_PROCESSOR_SOCKET_NAME_RECORD_NUMBER 0x00000010
#define EFI_PROCESSOR_CACHE_ASSOCIATION_RECORD_NUMBER 0x00000011
#define EFI_PROCESSOR_MAX_FREQUENCY_RECORD_NUMBER 0x00000012
#define EFI_PROCESSOR_ASSET_TAG_RECORD_NUMBER 0x00000013
#define EFI_PROCESSOR_MAX_FSB_FREQUENCY_RECORD_NUMBER 0x00000014
#define EFI_PROCESSOR_PACKAGE_NUMBER_RECORD_NUMBER 0x00000015
#define EFI_PROCESSOR_FREQUENCY_LIST_RECORD_NUMBER 0x00000016
#define EFI_PROCESSOR_FSB_FREQUENCY_LIST_RECORD_NUMBER 0x00000017
#define EFI_PROCESSOR_HEALTH_STATUS_RECORD_NUMBER 0x00000018
Keeping this inconsistency for backward compatibility.
8. Guid/DataHubRecords.h
typedef union {
EFI_PROCESSOR_CORE_FREQUENCY_LIST_DATA ProcessorCoreFrequencyList;
...
EFI_PROCESSOR_PACKAGE_NUMBER_DATA ProcessorPackageNumber;
} EFI_CPU_VARIABLE_RECORD;
typedef struct {
EFI_SUBCLASS_TYPE1_HEADER DataRecordHeader;
EFI_CPU_VARIABLE_RECORD VariableRecord;
} EFI_CPU_DATA_RECORD;
The definitions above are *NOT* defined in ProcSubclass specification 0.9. EdkII introduces them to simplify the
code logic. Therefore developer doesn't need to allocate memory dynamically to construct variable length data record.
Keeping this inconsistency for backward compatibility.
##
# Mismatch with Intel Platform Innovation Framework for MemSubclass Specification (Version 0.90)
##
1. Guid/DataHubRecords.h
typedef enum _EFI_MEMORY_FORM_FACTOR {
...
EfiMemoryFormFactorFbDimm = 0x0F
} EFI_MEMORY_FORM_FACTOR;
typedef enum _EFI_MEMORY_ARRAY_TYPE {
...
EfiMemoryTypeDdr2 = 0x13,
EfiMemoryTypeDdr2FbDimm = 0x14
} EFI_MEMORY_ARRAY_TYPE;
typedef enum {
...
EfiMemoryStatePartial = 6
} EFI_MEMORY_STATE;
The fields listed above are *NOT* defined in MemSubclass specification 0.9. They are introduced to support
new memory device (type 17) defined in SmBios 2.6 specification.
Keeping this inconsistency to reflect the latest industry standard.
2. Guid/DataHubRecords.h
typedef struct {
...
EFI_EXP_BASE10_DATA MemorySpeed;
...
} EFI_MEMORY_ARRAY_LINK_DATA;
The field name "MemorySpeed" in the definition above is *NOT* consistent with MemSubclass specification 0.9,
in which it is defined as MemoryTypeSpeed. Keeping this inconsistency for backward compatibility.
3. Guid/DataHubRecords.h
#define EFI_MEMORY_CONTROLLER_INFORMATION_RECORD_NUMBER 0x00000008
typedef enum {
EfiErrorDetectingMethodOther = 1,
EfiErrorDetectingMethodUnknown = 2,
EfiErrorDetectingMethodNone = 3,
EfiErrorDetectingMethodParity = 4,
EfiErrorDetectingMethod32Ecc = 5,
EfiErrorDetectingMethod64Ecc = 6,
EfiErrorDetectingMethod128Ecc = 7,
EfiErrorDetectingMethodCrc = 8
} EFI_MEMORY_ERROR_DETECT_METHOD_TYPE;
typedef struct {
UINT8 Other :1;
UINT8 Unknown :1;
UINT8 None :1;
UINT8 SingleBitErrorCorrect :1;
UINT8 DoubleBitErrorCorrect :1;
UINT8 ErrorScrubbing :1;
UINT8 Reserved :2;
} EFI_MEMORY_ERROR_CORRECT_CAPABILITY;
typedef enum {
EfiMemoryInterleaveOther = 1,
EfiMemoryInterleaveUnknown = 2,
EfiMemoryInterleaveOneWay = 3,
EfiMemoryInterleaveTwoWay = 4,
EfiMemoryInterleaveFourWay = 5,
EfiMemoryInterleaveEightWay = 6,
EfiMemoryInterleaveSixteenWay = 7
} EFI_MEMORY_SUPPORT_INTERLEAVE_TYPE;
typedef struct {
UINT16 Other :1;
UINT16 Unknown :1;
UINT16 SeventyNs:1;
UINT16 SixtyNs :1;
UINT16 FiftyNs :1;
UINT16 Reserved :11;
} EFI_MEMORY_SPEED_TYPE;
typedef struct {
UINT16 Other :1;
UINT16 Unknown :1;
UINT16 Standard :1;
UINT16 FastPageMode:1;
UINT16 EDO :1;
UINT16 Parity :1;
UINT16 ECC :1;
UINT16 SIMM :1;
UINT16 DIMM :1;
UINT16 BurstEdo :1;
UINT16 SDRAM :1;
UINT16 Reserved :5;
} EFI_MEMORY_SUPPORTED_TYPE;
typedef struct {
UINT8 Five :1;
UINT8 Three :1;
UINT8 Two :1;
UINT8 Reserved:5;
} EFI_MEMORY_MODULE_VOLTAGE_TYPE;
typedef struct {
EFI_MEMORY_ERROR_DETECT_METHOD_TYPE ErrorDetectingMethod;
EFI_MEMORY_ERROR_CORRECT_CAPABILITY ErrorCorrectingCapability;
EFI_MEMORY_SUPPORT_INTERLEAVE_TYPE MemorySupportedInterleave;
EFI_MEMORY_SUPPORT_INTERLEAVE_TYPE MemoryCurrentInterleave;
UINT8 MaxMemoryModuleSize;
EFI_MEMORY_SPEED_TYPE MemorySpeedType;
EFI_MEMORY_SUPPORTED_TYPE MemorySupportedType;
EFI_MEMORY_MODULE_VOLTAGE_TYPE MemoryModuleVoltage;
UINT8 NumberofMemorySlot;
EFI_MEMORY_ERROR_CORRECT_CAPABILITY EnabledCorrectingCapability;
UINT16 *MemoryModuleConfigHandles;
} EFI_MEMORY_CONTROLLER_INFORMATION;
typedef struct {
EFI_MEMORY_ERROR_DETECT_METHOD_TYPE ErrorDetectingMethod;
EFI_MEMORY_ERROR_CORRECT_CAPABILITY ErrorCorrectingCapability;
EFI_MEMORY_SUPPORT_INTERLEAVE_TYPE MemorySupportedInterleave;
EFI_MEMORY_SUPPORT_INTERLEAVE_TYPE MemoryCurrentInterleave;
UINT8 MaxMemoryModuleSize;
EFI_MEMORY_SPEED_TYPE MemorySpeedType;
EFI_MEMORY_SUPPORTED_TYPE MemorySupportedType;
EFI_MEMORY_MODULE_VOLTAGE_TYPE MemoryModuleVoltage;
UINT8 NumberofMemorySlot;
EFI_MEMORY_ERROR_CORRECT_CAPABILITY EnabledCorrectingCapability;
EFI_INTER_LINK_DATA MemoryModuleConfig[1];
} EFI_MEMORY_CONTROLLER_INFORMATION_DATA;
The definitions above are *NOT* defined in MemSubclass specification 0.9. They are introduced to support
new memory controller information (type 5) defined in SmBios 2.6 specification.
Keeping this inconsistency to reflect the latest industry standard.
4. Guid/DataHubRecords.h
#define EFI_MEMORY_32BIT_ERROR_INFORMATION_RECORD_NUMBER 0x00000009
typedef enum {
EfiMemoryErrorOther = 1,
EfiMemoryErrorUnknown = 2,
EfiMemoryErrorOk = 3,
EfiMemoryErrorBadRead = 4,
EfiMemoryErrorParity = 5,
EfiMemoryErrorSigleBit = 6,
EfiMemoryErrorDoubleBit = 7,
EfiMemoryErrorMultiBit = 8,
EfiMemoryErrorNibble = 9,
EfiMemoryErrorChecksum = 10,
EfiMemoryErrorCrc = 11,
EfiMemoryErrorCorrectSingleBit = 12,
EfiMemoryErrorCorrected = 13,
EfiMemoryErrorUnCorrectable = 14
} EFI_MEMORY_ERROR_TYPE;
typedef enum {
EfiMemoryGranularityOther = 1,
EfiMemoryGranularityOtherUnknown = 2,
EfiMemoryGranularityDeviceLevel = 3,
EfiMemoryGranularityMemPartitionLevel = 4
} EFI_MEMORY_ERROR_GRANULARITY_TYPE;
typedef enum {
EfiMemoryErrorOperationOther = 1,
EfiMemoryErrorOperationUnknown = 2,
EfiMemoryErrorOperationRead = 3,
EfiMemoryErrorOperationWrite = 4,
EfiMemoryErrorOperationPartialWrite = 5
} EFI_MEMORY_ERROR_OPERATION_TYPE;
typedef struct {
EFI_MEMORY_ERROR_TYPE MemoryErrorType;
EFI_MEMORY_ERROR_GRANULARITY_TYPE MemoryErrorGranularity;
EFI_MEMORY_ERROR_OPERATION_TYPE MemoryErrorOperation;
UINT32 VendorSyndrome;
UINT32 MemoryArrayErrorAddress;
UINT32 DeviceErrorAddress;
UINT32 DeviceErrorResolution;
} EFI_MEMORY_32BIT_ERROR_INFORMATION;
The definitions above are *NOT* defined in MemSubclass specification 0.9. They are introduced to support
new 32-bit memory error information (type 18) defined in SmBios 2.6 specification.
Keeping this inconsistency to reflect the latest industry standard.
5. Guid/DataHubRecords.h
#define EFI_MEMORY_64BIT_ERROR_INFORMATION_RECORD_NUMBER 0x0000000A
typedef struct {
EFI_MEMORY_ERROR_TYPE MemoryErrorType;
EFI_MEMORY_ERROR_GRANULARITY_TYPE MemoryErrorGranularity;
EFI_MEMORY_ERROR_OPERATION_TYPE MemoryErrorOperation;
UINT32 VendorSyndrome;
UINT64 MemoryArrayErrorAddress;
UINT64 DeviceErrorAddress;
UINT32 DeviceErrorResolution;
} EFI_MEMORY_64BIT_ERROR_INFORMATION;
The definitions above are *NOT* defined in MemSubclass specification 0.9. They are introduced to support
new 64-bit memory error information (type 33) defined in SmBios 2.6 specification.
Keeping this inconsistency to reflect the latest industry standard.
6. Guid/DataHubRecords.h
typedef union _EFI_MEMORY_SUBCLASS_RECORDS {
EFI_MEMORY_SIZE_DATA SizeData;
...
EFI_MEMORY_64BIT_ERROR_INFORMATION Memory64bitErrorInfo;
} EFI_MEMORY_SUBCLASS_RECORDS;
typedef struct {
EFI_SUBCLASS_TYPE1_HEADER Header;
EFI_MEMORY_SUBCLASS_RECORDS Record;
} EFI_MEMORY_SUBCLASS_DRIVER_DATA;
The definitions above are *NOT* defined in MemSubclass specification 0.9. EdkII introduces them to simplify the
code logic. Therefore developer doesn't need to allocate memory dynamically to construct variable length data record.
Keeping this inconsistency for backward compatibility.
##
# Mismatch with Intel Platform Innovation Framework for MiscSubclass Specification (Version 0.90)
##
1. Guid/DataHubRecords.h
#pragma pack(1)
typedef struct _USB_PORT_DEVICE_PATH {
ACPI_HID_DEVICE_PATH PciRootBridgeDevicePath;
PCI_DEVICE_PATH PciBusDevicePath;
EFI_DEVICE_PATH_PROTOCOL EndDevicePath;
} USB_PORT_DEVICE_PATH;
typedef struct _IDE_DEVICE_PATH {
ACPI_HID_DEVICE_PATH PciRootBridgeDevicePath;
PCI_DEVICE_PATH PciBusDevicePath;
EFI_DEVICE_PATH_PROTOCOL EndDevicePath;
} IDE_DEVICE_PATH;
typedef struct _RMC_CONN_DEVICE_PATH {
ACPI_HID_DEVICE_PATH PciRootBridgeDevicePath;
PCI_DEVICE_PATH PciBridgeDevicePath;
PCI_DEVICE_PATH PciBusDevicePath;
EFI_DEVICE_PATH_PROTOCOL EndDevicePath;
} RMC_CONN_DEVICE_PATH;
typedef struct _RIDE_DEVICE_PATH {
ACPI_HID_DEVICE_PATH PciRootBridgeDevicePath;
PCI_DEVICE_PATH PciBridgeDevicePath;
PCI_DEVICE_PATH PciBusDevicePath;
EFI_DEVICE_PATH_PROTOCOL EndDevicePath;
} RIDE_DEVICE_PATH;
typedef struct _GB_NIC_DEVICE_PATH {
ACPI_HID_DEVICE_PATH PciRootBridgeDevicePath;
PCI_DEVICE_PATH PciBridgeDevicePath;
PCI_DEVICE_PATH PciXBridgeDevicePath;
PCI_DEVICE_PATH PciXBusDevicePath;
EFI_DEVICE_PATH_PROTOCOL EndDevicePath;
} GB_NIC_DEVICE_PATH;
typedef struct _PS2_CONN_DEVICE_PATH {
ACPI_HID_DEVICE_PATH PciRootBridgeDevicePath;
PCI_DEVICE_PATH LpcBridgeDevicePath;
ACPI_HID_DEVICE_PATH LpcBusDevicePath;
EFI_DEVICE_PATH_PROTOCOL EndDevicePath;
} PS2_CONN_DEVICE_PATH;
typedef struct _SERIAL_CONN_DEVICE_PATH {
ACPI_HID_DEVICE_PATH PciRootBridgeDevicePath;
PCI_DEVICE_PATH LpcBridgeDevicePath;
ACPI_HID_DEVICE_PATH LpcBusDevicePath;
EFI_DEVICE_PATH_PROTOCOL EndDevicePath;
} SERIAL_CONN_DEVICE_PATH;
typedef struct _PARALLEL_CONN_DEVICE_PATH {
ACPI_HID_DEVICE_PATH PciRootBridgeDevicePath;
PCI_DEVICE_PATH LpcBridgeDevicePath;
ACPI_HID_DEVICE_PATH LpcBusDevicePath;
EFI_DEVICE_PATH_PROTOCOL EndDevicePath;
} PARALLEL_CONN_DEVICE_PATH;
typedef struct _FLOOPY_CONN_DEVICE_PATH {
ACPI_HID_DEVICE_PATH PciRootBridgeDevicePath;
PCI_DEVICE_PATH LpcBridgeDevicePath;
ACPI_HID_DEVICE_PATH LpcBusDevicePath;
EFI_DEVICE_PATH_PROTOCOL EndDevicePath;
} FLOOPY_CONN_DEVICE_PATH;
typedef union _EFI_MISC_PORT_DEVICE_PATH {
USB_PORT_DEVICE_PATH UsbDevicePath;
IDE_DEVICE_PATH IdeDevicePath;
RMC_CONN_DEVICE_PATH RmcConnDevicePath;
RIDE_DEVICE_PATH RideDevicePath;
GB_NIC_DEVICE_PATH GbNicDevicePath;
PS2_CONN_DEVICE_PATH Ps2ConnDevicePath;
SERIAL_CONN_DEVICE_PATH SerialConnDevicePath;
PARALLEL_CONN_DEVICE_PATH ParallelConnDevicePath;
FLOOPY_CONN_DEVICE_PATH FloppyConnDevicePath;
} EFI_MISC_PORT_DEVICE_PATH;
#pragma pack()
a. The definitions above are *NOT* defined in MiscSubclass specifications 0.9. EdkII introduces them to simplify the
code logic. Therefore developer doesn't need to allocate memory dynamically to construct variable length device
path for various device.
Keeping this inconsistency for backward compatibility.
b. The definitions above are packed. This way violates the rule of alignment defined in DataHubSubclass specification.
Section "Alignment" in DataHubSubclass specification say "Fields in a data hub record should be aligned at their
natural boundaries". Keeping this inconsistency for backward compatibility.
2. Guid/DataHubRecords.h
typedef struct {
...
EFI_MISC_PORT_DEVICE_PATH PortPath;
} EFI_MISC_PORT_INTERNAL_CONNECTOR_DESIGNATOR_DATA;
The definition is *NOT* consistent with MiscSubclass specification, in which the type of last field is defined as
"EFI_DEVICE_PATH_PROTOCOL". The definition in Specification may bring a little complexity on implementation. User
have to allocate variable length memory to contain device path info and free them finially.
EdkII introduced an union type named EFI_MISC_PORT_DEVICE_PATH to avoid the logic above.
3. Guid/DataHubRecords.h
typedef struct {
...
UINT8 BiosMajorRelease;
UINT8 BiosMinorRelease;
UINT8 BiosEmbeddedFirmwareMajorRelease;
UINT8 BiosEmbeddedFirmwareMinorRelease;
} EFI_MISC_BIOS_VENDOR_DATA;
The fields listed above are *NOT* defined in MiscSubclass specification 0.9. They are introduced to support
new bios information (type 0) defined in SmBios 2.6 specification.
Keeping this inconsistency to reflect the latest industry standard.
4. Guid/DataHubRecords.h
typedef struct {
...
STRING_REF SystemSKUNumber;
STRING_REF SystemFamily;
} EFI_MISC_SYSTEM_MANUFACTURER_DATA;
The fields listed above are *NOT* defined in MiscSubclass specification 0.9. They are introduced to support
new system information (type 1) defined in SmBios 2.6 specification.
Keeping this inconsistency to reflect the latest industry standard.
5. Guid/DataHubRecords.h
typedef struct {
...
EFI_INTER_LINK_DATA ManagementDeviceThresholdLink;
} EFI_MISC_MANAGEMENT_DEVICE_COMPONENT_DESCRIPTION_DATA;
The field listed above is *NOT* defined in MiscSubclass specification 0.9. It is introduced to support
new management device component (type 35) defined in SmBios 2.6 specification.
Keeping this inconsistency to reflect the latest industry standard.
6. Guid/DataHubRecords.h
typedef struct {
UINT32 ChassisType :16;
UINT32 ChassisLockPresent:1;
UINT32 Reserved :15;
} EFI_MISC_CHASSIS_STATUS;
The definition is *NOT* consistent with MiscSubclass specification 0.9, in which the first field is assigned a wrong field
name "EFI_MISC_CHASSIS_TYPE". Due to EFI_MISC_CHASSIS_TYPE has been declared as a data type, it can not be used as a
field name again. EdkII changes its name to "ChassisType" to pass build.
7. Guid/DataHubRecords.h
typedef enum {
...
EfiSlotTypeAgp2X = 0x10,
...
EfiSlotTypePciExpress = 0xA5
} EFI_MISC_SLOT_TYPE;
a. The field name "EfiSlotTypeAgp2X" is *NOT* consistent with MiscSubclass specification 0.9, in which it is named
"EfiSlotTypeApg2X".
From its literal sense, this field represents a AGP type display card, so it should be named as "EfiSlotTypeAgp2X".
b. The "EfiSlotTypePciExpress" field is *NOT* defined in MiscSubclass specification 0.9. It isintroduced to support
new system slots (type 9) defined in SmBios 2.6 specification.
Keeping this inconsistency to reflect the latest industry standard.
8. Guid/DataHubRecords.h
typedef struct {
...
EFI_MISC_ONBOARD_DEVICE_STATUS OnBoardDeviceStatus;
...
} EFI_MISC_ONBOARD_DEVICE_DATA;
The definition is *NOT* consistent with MiscSubclass specification 0.9, in which the field "OnBoardDeviceStatus" is
named as "OnBoardDeviceType". Keeping this inconsistency for backward compatibility.
9. Guid/DataHubRecords.h
#define EFI_MISC_PORTABLE_BATTERY_RECORD_NUMBER 0x00000010
The name of the definition is *NOT* consistent with MiscSubclass specification 0.9, in which it is defined as
"EFI_MISC_BATTERY_LOCATION_RECORD_NUMBER". Keeping this inconsistency for backward compatibility.
10. Guid/DataHubRecords.h
typedef enum {
EfiPortableBatteryDeviceChemistryOther = 1,
EfiPortableBatteryDeviceChemistryUnknown = 2,
EfiPortableBatteryDeviceChemistryLeadAcid = 3,
EfiPortableBatteryDeviceChemistryNickelCadmium = 4,
EfiPortableBatteryDeviceChemistryNickelMetalHydride = 5,
EfiPortableBatteryDeviceChemistryLithiumIon = 6,
EfiPortableBatteryDeviceChemistryZincAir = 7,
EfiPortableBatteryDeviceChemistryLithiumPolymer = 8
} EFI_MISC_PORTABLE_BATTERY_DEVICE_CHEMISTRY;
The name of the definition is *NOT* consistent with MiscSubclass specification, in which it is defined as
"EFI_MISC_BATTERY_DEVICE_CHEMISTRY". And all field names have a redundant "Portable" string compared with MisSubclass
specification 0.9.
Keeping this inconsistency for backward compatibility.
11. Guid/DataHubRecords.h
typedef struct {
STRING_REF Location;
STRING_REF Manufacturer;
STRING_REF ManufactureDate;
STRING_REF SerialNumber;
STRING_REF DeviceName;
EFI_MISC_PORTABLE_BATTERY_DEVICE_CHEMISTRY DeviceChemistry;
UINT16 DesignCapacity;
UINT16 DesignVoltage;
STRING_REF SBDSVersionNumber;
UINT8 MaximumError;
UINT16 SBDSSerialNumber;
UINT16 SBDSManufactureDate;
STRING_REF SBDSDeviceChemistry;
UINT8 DesignCapacityMultiplier;
UINT32 OEMSpecific;
UINT8 BatteryNumber;
BOOLEAN Valid;
} EFI_MISC_PORTABLE_BATTERY;
The definition is *NOT* consistent with MiscSubclass specification 0.9, in which the structure name is defined as
"EFI_MISC_BATTERY_LOCATION_DATA". Moreover, the name and the order of all fields are also different with MiscSubclass
specification 0.9. Keeping this inconsistency for backward compatibility.
12. Guid/DataHubRecords.h
typedef enum {
...
} EFI_MISC_BOOT_INFORMATION_STATUS_DATA_TYPE;
The name of the definition is *NOT* consistent with MiscSubclass specification 0.9, in which it is defined as
"EFI_MISC_BOOT_INFORMATION_STATUS_TYPE". Keeping this inconsistency for backward compatibility.
13. Guid/DataHubRecords.h
typedef struct {
EFI_MISC_BOOT_INFORMATION_STATUS_DATA_TYPE BootInformationStatus;
...
} EFI_MISC_BOOT_INFORMATION_STATUS_DATA;
The definition is *NOT* consistent with MiscSubclass specification 0.9, in which the type of the first field is
"EFI_MISC_BOOT_INFORMATION_STATUS_TYPE". Keeping this inconsistency for backward compatibility.
14. Guid/DataHubRecords.h
typedef struct {
...
} EFI_MISC_SYSTEM_POWER_SUPPLY_DATA;
The name of the definition is *NOT* consistent with MiscSubclass specification 0.9, in which it is defined as
"EFI_MISC_POWER_SUPPLY_UNIT_GROUP_DATA". Keeping this inconsistency for backward compatibility.
15. Guid/DataHubRecords.h
typedef struct {
...
} SMBIOS_STRUCTURE_HDR;
The name of the definition is *NOT* consistent with MiscSubclass specification 0.9, in which the structure name
is defined as "EFI_SMBIOS_STRUCTURE_HDR". Due to this structure is commonly used by vendor to construct SmBios
type 0x80~0xFF table, Keeping this inconsistency for backward compatibility.
16. Guid/DataHubRecords.h
typedef struct {
SMBIOS_STRUCTURE_HDR Header;
...
} EFI_MISC_SMBIOS_STRUCT_ENCAPSULATION_DATA;
The definition is *NOT* consistent with MiscSubclass specification 0.9, in which the type of the first field is
"EFI_SMBIOS_STRUCTURE_HDR". Keeping this inconsistency for backward compatibility.
17. Guid/DataHubRecords.h
typedef struct {
UINT16 PowerSupplyHotReplaceable:1;
UINT16 PowerSupplyPresent :1;
UINT16 PowerSupplyUnplugged :1;
UINT16 InputVoltageRangeSwitch :4;
UINT16 PowerSupplyStatus :3;
UINT16 PowerSupplyType :4;
UINT16 Reserved :2;
} EFI_MISC_POWER_SUPPLY_CHARACTERISTICS;
all field type in the definition are *NOT* consistent with MiscSubclass specification 0.9, in which it is defined as
"UINT32" and the total width of bit-fields is 32bits width.
Keeping this inconsistency for backward compatibility.
18. Guid/DataHubRecords.h
#define EFI_MISC_SYSTEM_EVENT_LOG_RECORD_NUMBER 0x00000020
typedef struct {
UINT16 LogAreaLength;
UINT16 LogHeaderStartOffset;
UINT16 LogDataStartOffset;
UINT8 AccessMethod;
UINT8 LogStatus;
UINT32 LogChangeToken;
UINT32 AccessMethodAddress;
UINT8 LogHeaderFormat;
UINT8 NumberOfSupportedLogType;
UINT8 LengthOfLogDescriptor;
} EFI_MISC_SYSTEM_EVENT_LOG_DATA;
#define ACCESS_INDEXIO_1INDEX8BIT_DATA8BIT 0x00
#define ACCESS_INDEXIO_2INDEX8BIT_DATA8BIT 0X01
#define ACCESS_INDEXIO_1INDEX16BIT_DATA8BIT 0X02
#define ACCESS_MEMORY_MAPPED 0x03
#define ACCESS_GPNV 0x04
The definitions listed above are *NOT* defined in MiscSubclass specification 0.9. It is introduced to support
new system event log (type 15) defined in SmBios 2.6 specification.
Keeping this inconsistency to reflect the latest industry standard.
19. Guid/DataHubRecords.h
#define EFI_MISC_MANAGEMENT_DEVICE_THRESHOLD_RECORD_NUMBER 0x00000021
typedef struct {
UINT16 LowerThresNonCritical;
UINT16 UpperThresNonCritical;
UINT16 LowerThresCritical;
UINT16 UpperThresCritical;
UINT16 LowerThresNonRecover;
UINT16 UpperThresNonRecover;
} EFI_MISC_MANAGEMENT_DEVICE_THRESHOLD;
The definitions listed above are *NOT* defined in MiscSubclass specification 0.9. It is introduced to support
new management device threshold data (type 36) defined in SmBios 2.6 specification.
Keeping this inconsistency to reflect the latest industry standard.
20. Guid/DataHubRecords.h
typedef union {
EFI_MISC_LAST_PCI_BUS_DATA LastPciBus;
...
EFI_MISC_MANAGEMENT_DEVICE_THRESHOLD MiscManagementDeviceThreshold;
} EFI_MISC_SUBCLASS_RECORDS;
typedef struct {
EFI_SUBCLASS_TYPE1_HEADER Header;
EFI_MISC_SUBCLASS_RECORDS Record;
} EFI_MISC_SUBCLASS_DRIVER_DATA;
The definitions above are *NOT* defined in MemSubclass specification 0.9. EdkII introduces them to simplify the
code logic. Therefore developer doesn't need to allocate memory dynamically to construct variable length data record.
Keeping this inconsistency for backward compatibility.
##
# Mismatch with Intel Platform Innovation Framework for Status Codes Specification (Version 0.92)
##
1. Include/Framework/StatusCode.h
#define EFI_IOB_ATA_BUS_SMART_ENABLE (EFI_SUBCLASS_SPECIFIC | 0x00000000)
#define EFI_IOB_ATA_BUS_SMART_DISABLE (EFI_SUBCLASS_SPECIFIC | 0x00000001)
#define EFI_IOB_ATA_BUS_SMART_OVERTHRESHOLD (EFI_SUBCLASS_SPECIFIC | 0x00000002)
#define EFI_IOB_ATA_BUS_SMART_UNDERTHRESHOLD (EFI_SUBCLASS_SPECIFIC | 0x00000003)
#define EFI_IOB_ATA_BUS_SMART_NOTSUPPORTED (EFI_SUBCLASS_SPECIFIC | 0x00000000)
#define EFI_IOB_ATA_BUS_SMART_DISABLED (EFI_SUBCLASS_SPECIFIC | 0x00000001)
#define EFI_SW_DXE_BS_PC_BEGIN_CONNECTING_DRIVERS (EFI_SUBCLASS_SPECIFIC | 0x00000005)
#define EFI_SW_DXE_BS_PC_VERIFYING_PASSWORD (EFI_SUBCLASS_SPECIFIC | 0x00000006)
#define EFI_SW_DXE_RT_PC_S0 (EFI_SUBCLASS_SPECIFIC | 0x00000000)
#define EFI_SW_DXE_RT_PC_S1 (EFI_SUBCLASS_SPECIFIC | 0x00000001)
#define EFI_SW_DXE_RT_PC_S2 (EFI_SUBCLASS_SPECIFIC | 0x00000002)
#define EFI_SW_DXE_RT_PC_S3 (EFI_SUBCLASS_SPECIFIC | 0x00000003)
#define EFI_SW_DXE_RT_PC_S4 (EFI_SUBCLASS_SPECIFIC | 0x00000004)
#define EFI_SW_DXE_RT_PC_S5 (EFI_SUBCLASS_SPECIFIC | 0x00000005)
#define EFI_SW_CSM_LEGACY_ROM_INIT (EFI_SUBCLASS_SPECIFIC | 0x00000000)
The definitions above are *NOT* defined in Framework StatusCodes specification 0.92. But these subclass-specific error code
operations are needed for EdkII implementation.
Keeping this inconsistency for backward compatibility.
2. Include/Framework/StatusCode.h
typedef union {
CHAR8 *Ascii;
CHAR16 *Unicode;
...
} EFI_STATUS_CODE_STRING;
The definition is *NOT* consistent with Framework SatausCodes specification 0.92, in which the first field is defined as "CHAR8 Ascii[]"
and the second field is defined as "CHAR16 Unicode[]". Keeping this inconsistency for backward compatibility.
3. Include/Framework/StatusCode.h
#define EFI_SW_EC_X64_DIVIDE_ERROR EXCEPT_X64_DIVIDE_ERROR
#define EFI_SW_EC_X64_DEBUG EXCEPT_X64_DEBUG
#define EFI_SW_EC_X64_NMI EXCEPT_X64_NMI
#define EFI_SW_EC_X64_BREAKPOINT EXCEPT_X64_BREAKPOINT
#define EFI_SW_EC_X64_OVERFLOW EXCEPT_X64_OVERFLOW
#define EFI_SW_EC_X64_BOUND EXCEPT_X64_BOUND
#define EFI_SW_EC_X64_INVALID_OPCODE EXCEPT_X64_INVALID_OPCODE
#define EFI_SW_EC_X64_DOUBLE_FAULT EXCEPT_X64_DOUBLE_FAULT
#define EFI_SW_EC_X64_INVALID_TSS EXCEPT_X64_INVALID_TSS
#define EFI_SW_EC_X64_SEG_NOT_PRESENT EXCEPT_X64_SEG_NOT_PRESENT
#define EFI_SW_EC_X64_STACK_FAULT EXCEPT_X64_STACK_FAULT
#define EFI_SW_EC_X64_GP_FAULT EXCEPT_X64_GP_FAULT
#define EFI_SW_EC_X64_PAGE_FAULT EXCEPT_X64_PAGE_FAULT
#define EFI_SW_EC_X64_FP_ERROR EXCEPT_X64_FP_ERROR
#define EFI_SW_EC_X64_ALIGNMENT_CHECK EXCEPT_X64_ALIGNMENT_CHECK
#define EFI_SW_EC_X64_MACHINE_CHECK EXCEPT_X64_MACHINE_CHECK
#define EFI_SW_EC_X64_SIMD EXCEPT_X64_SIMD
The definitions are *NOT* defined in Framework StatusCodes specification 0.92, in which IA32 and IPF exception subclass error code definitions
are defined but omit the corresponding definitions for X64. EdkII introduce these definitions for implementation.
##
# Mismatch with Intel Platform Innovation Framework for EFI Boot Script Specification (Version 0.91)
##
1. Include/Protocol/BootScriptSave.h
#define EFI_BOOT_SCRIPT_SAVE_PROTOCOL_GUID \
{ \
0x470e1529, 0xb79e, 0x4e32, {0xa0, 0xfe, 0x6a, 0x15, 0x6d, 0x29, 0xf9, 0xb2 } \
}
The macro name "EFI_BOOT_SCRIPT_SAVE_PROTOCOL_GUID" is *NOT* consistent with Framework BootScript specification 0.91,
in which it's defined as "EFI_BOOT_SCRIPT_SAVE_GUID". Keeping this inconsistency for backward compatibility.
2. Include/Protocol/BootScriptSave.h
EFI_STATUS
EFI_BOOTSERVICE
(EFIAPI *EFI_BOOT_SCRIPT_WRITE) (
IN EFI_BOOT_SCRIPT_SAVE_PROTOCOL *This,
...
);
The first parameter's type is *NOT* consistent with Framework BootScript specification 0.91, in which it's defined as
"struct _EFI_BOOT_SCRIPT_SAVE_PROTOCOL". Keeping this inconsistency for backward compatibility.
3. Include/Framework/BootScript.h
#define EFI_BOOT_SCRIPT_MEM_POLL_OPCODE 0x09
#define EFI_BOOT_SCRIPT_INFORMATION_OPCODE 0x0A
#define EFI_BOOT_SCRIPT_PCI_CONFIG2_WRITE_OPCODE 0x0B
#define EFI_BOOT_SCRIPT_PCI_CONFIG2_READ_WRITE_OPCODE 0x0C
#define EFI_BOOT_SCRIPT_DISPATCH_2_OPCODE 0x0D
The OPCODEs above are not defined in Framework BootScript Specification 0.91, but adopted by PI 1.0 Spec. And they
are needed for EdkII implementation.
4. Include/Framework/BootScript.h
#define EFI_BOOT_SCRIPT_TABLE_OPCODE 0xAA
#define EFI_BOOT_SCRIPT_TERMINATE_OPCODE 0xFF
The two OPCODEs are *NOT* defined in Framework BootScript specification 0.91. EdkII introduces them to indicate the start
or end of the boot script table.
Keeping this inconsistency for backward compatibility.
5. Include/Protocol/BootScriptSave.h
typedef
EFI_STATUS
(EFIAPI *EFI_BOOT_SCRIPT_CLOSE_TABLE) (
IN EFI_BOOT_SCRIPT_SAVE_PROTOCOL *This,
...
);
The first parameter's type is *NOT* consistent with BootScript specification, in which it's defined as
"struct _EFI_BOOT_SCRIPT_SAVE_PROTOCOL". Keeping this inconsistency for backward compatibility.
6. Include/Include/BootScriptExecuter.h
typedef
EFI_STATUS
(EFIAPI *EFI_PEI_BOOT_SCRIPT_EXECUTE)(
IN EFI_PEI_SERVICES **PeiServices,
IN EFI_PEI_BOOT_SCRIPT_EXECUTER_PPI *This,
...
);
The second parameter's type is *NOT* consistent with BootScript specification, in which it's defined as
"struct _EFI_PEI_BOOT_SCRIPT_EXECUTER_PPI". Keeping this inconsistency for backward compatibility.
##
# Mismatch with Intel Platform Innovation Framework for EFI DXE CIS (Version 0.91)
##
1. Include/Framework/DxeCis.h
EFI_STATUS_CODE_ARCH_PROTOCOL is removed.
EdkII doesn't provide EFI_STATUS_CODE_ARCH_PROTOCOL definition due to ReportStatusCode() field has been
removed from EFI Runtime Service Table of PI specification. EFI_STATUS_CODE_ARCH_PROTOCOL is *NOT* required,
and is replaced with EFI_STATUS_CODE_RUNTIME_PROTOCOL.
##
# Mismatch with Intel Platform Innovation Framework for EFI Firmware Volume Specification (Version 0.9)
##
1. Include/Framework/FirmwareVolumeImageFormat.h
#define EFI_AGGREGATE_AUTH_STATUS_ALL 0x00000f
#define EFI_LOCAL_AUTH_STATUS_ALL 0x0f0000
The two macros are *NOT* defined in Framework FV specification 0.9. EdkII introduces them as a mask to calculate the
value of authentication status.
##
# Mismatch with Intel Platform Innovation Framework for EFI Human Interface Infrastructure Specification (Version 0.92)
##
1. Include/Protocol/FrameworkHii.h
#define EFI_HII_PROTOCOL_GUID \
{ \
0xd7ad636e, 0xb997, 0x459b, {0xbf, 0x3f, 0x88, 0x46, 0x89, 0x79, 0x80, 0xe1} \
}
The Framework HII specification 0.92 changed part of HII interfaces but did not update the protocol GUID.
This change should cause a change of GUID in both of code and HII spec. EdkII updates the GUID in code,
but the Framework HII specification 0.92 is not updated. This is a known issue.
2. Include/Protocol/FrameworkHii.h
typedef struct {
...
EFI_HANDLE COBExportHandle;
} EFI_HII_HANDLE_PACK;
The last field "COBExportHandle" of EFI_HII_HANDLE_PACK is *NOT* defined in the Framework HII specification
0.92. Keeping this inconsistency for backward compatibility.
3. Include/Protocol/FrameworkHii.h
typedef struct {
UINTN NumberOfPackages;
EFI_GUID *GuidId;
} EFI_HII_PACKAGES;
The definition is *NOT* consistent with Framework HII specification 0.92, in which a field "HandlePack" is defined.
EdkII changes the EFI_HII_PACKAGES to contain various number of packages of different types just after the structure
as inline data, which will bring the flexibility on development.
4. Include/Protocol/FrameworkHii.h
struct _EFI_HII_PROTOCOL {
...
EFI_HII_RESET_STRINGS ResetStrings;
...
};
The field listed above is *NOT* defined in Framework HII specification 0.92. EdkII adds this field to provide
an ability of removing any new strings that were added after the initial string export for this handle.
5. Include/Protocol/FrameworkHii.h
typedef
EFI_STATUS
(EFIAPI *EFI_HII_GLYPH_TO_BLT)(
...
IN EFI_GRAPHICS_OUTPUT_BLT_PIXEL Foreground,
IN EFI_GRAPHICS_OUTPUT_BLT_PIXEL Background,
...
IN OUT EFI_GRAPHICS_OUTPUT_BLT_PIXEL *BltBuffer
);
The type of the parameters listed above are *NOT* consistent with Framework HII specification 0.92, in which
the type of these parameters is EFI_UGA_PIXEL. Here the definition uses the EFI_GRAPHICS_OUTPUT_BLT_PIXEL which
defined in UEFI2.1 spec. Keeping this inconsistency for backward compatibility.
6. Include/Protocol/FrameworkHii.h
typedef struct {
FRAMEWORK_EFI_IFR_OP_HEADER Header;
UINT8 Flags;
} EFI_IFR_SUPPRESS;
typedef struct {
FRAMEWORK_EFI_IFR_OP_HEADER Header;
UINT8 Flags;
} EFI_IFR_GRAY_OUT;
typedef struct {
FRAMEWORK_EFI_IFR_OP_HEADER Header;
STRING_REF Popup;
UINT8 Flags;
} EFI_IFR_INCONSISTENT;
typedef struct {
FRAMEWORK_EFI_IFR_OP_HEADER Header;
UINT16 QuestionId;
UINT8 Width;
UINT16 Value;
} FRAMEWORK_EFI_IFR_EQ_ID_VAL;
typedef struct {
FRAMEWORK_EFI_IFR_OP_HEADER Header;
UINT16 QuestionId;
UINT8 Width;
UINT16 ListLength;
UINT16 ValueList[1];
} FRAMEWORK_EFI_IFR_EQ_ID_LIST;
typedef struct {
FRAMEWORK_EFI_IFR_OP_HEADER Header;
UINT16 QuestionId1;
UINT8 Width;
UINT16 QuestionId2;
} FRAMEWORK_EFI_IFR_EQ_ID_ID;
typedef struct {
FRAMEWORK_EFI_IFR_OP_HEADER Header;
UINT16 VariableId;
UINT16 Value;
} EFI_IFR_EQ_VAR_VAL;
The defintions are not complied with Framework HII spec 0.92. Keeping the inconsistent for implementation needed.
7. Include/Protocol/FrameworkFormCallback.h
#define RESET_REQUIRED 1
#define EXIT_REQUIRED 2
#define SAVE_REQUIRED 4
#define NV_CHANGED 8
#define NV_NOT_CHANGED 16
These macros are *NOT* defined in the Framework HII specification 0.92. These Flags are introduced to describe
the standard behavior of the browser after the callback.
Keeping this inconsistency for backward compatibility.
8. Include/Protocol/FrameworkFormCallback.h
typedef
EFI_STATUS
(EFIAPI *EFI_NV_WRITE)(
...
IN UINT32 Attributes,
...
);
The definition is *NOT* consistent with Framework HII specification 0.92, in which the type of Attributes
parameter is defined as "UINT32 *". EdkII changes the type of Attributes from UINT32 * to UINT32 because
the input paramter is not necessary to use pointer date type.
##
# Mismatch with Intel Platform Innovation Framework for PEI CIS Specification (Version 0.91)
##
1. Include/Ppi/ReadOnlyVariable.h
#define EFI_VARIABLE_READ_ONLY 0x00000008
In Framework PeiCis specification 0.91, neither the macro or its value is defined.
Keeping this inconsistency for backward compatibility.
2. Include/Ppi/FindFv.h
typedef
EFI_STATUS
(EFIAPI *EFI_PEI_FIND_FV_FINDFV)(
IN EFI_PEI_FIND_FV_PPI *This,
IN EFI_PEI_SERVICES **PeiServices,
IN UINT8 *FvNumber,
IN OUT EFI_FIRMWARE_VOLUME_HEADER **FVAddress
);
The definition is *NOT* consistent with Framework PeiCis specification 0.91. Compared with spec, the order
of the first and second parameters is reversed. Keeping this inconsistency for backward compatibility.
##
# Mismatch with Intel Platform Innovation Framework for EFI SMM CIS (Version 0.91)
##
1. Include/Guid/SmramMemoryReserve.h
typedef struct {
UINT32 NumberOfSmmReservedRegions;
...
} EFI_SMRAM_HOB_DESCRIPTOR_BLOCK;
1) The name of the definition is *NOT* consistent with Framework SmmCis specification 0.91, in which it's
defined as "EFI_HOB_SMRAM_DESCRIPTOR_BLOCK" rather than "EFI_SMRAM_HOB_DESCRIPTOR_BLOCK".
Keeping this inconsistency for backward compatibility.
2) The definition of NumberOfSmmReservedRegions is *NOT* consistent with Framework SmmCis specification 0.91,
in which the type of this field is defined as UINTN. However, HOBs are supposed to be CPU neutral, so UINTN
is incorrect and UINT32 should be used.
2. Include/Guid/SmramMemoryReserve.h
typedef enum {
...
IchnIoTrap3,
IchnIoTrap2,
IchnIoTrap1,
IchnIoTrap0,
IchnPciExpress,
IchnMonitor,
IchnSpi,
IchnQRT,
IchnGpioUnlock,
...
} EFI_SMM_ICHN_SMI_TYPE;
The enumeration fields listed above are *NOT* defined in Framework SmmCis specification 0.91. EdkII introduces
these fields to support new SMI types.
##
# Mismatch with Intel Platform Innovation Framework for EFI S3 Resume Boot Path Specification (Version 0.9)
##
1. Include/Protocol/AcpiS3Save.h
typedef
EFI_STATUS
EFI_BOOTSERVICE
(EFIAPI *EFI_ACPI_GET_LEGACY_MEMORY_SIZE) (
IN EFI_ACPI_S3_SAVE_PROTOCOL *This,
OUT UINTN *Size
);
The first parameter's type is *NOT* consistent with Framework S3Resume specification, in which it's defined as
"struct _EFI_ACPI_S3_SAVE_PROTOCOL". Keeping this inconsistency for backward compatibility.
2. Include/Protocol/AcpiS3Save.h
typedef
EFI_STATUS
(EFIAPI *EFI_ACPI_S3_SAVE) (
IN EFI_ACPI_S3_SAVE_PROTOCOL *This,
IN VOID *LegacyMemoryAddress
);
The first parameter's type is *NOT* consistent with Framework S3Resume specification, in which it's defined as
"struct _EFI_ACPI_S3_SAVE_PROTOCOL". Also the EFI_BOOTSERVICE modifier is removed from the function declaration.
3. Include/Protocol/AcpiS3Save.h
typedef
EFI_STATUS
(EFIAPI *EFI_ACPI_GET_LEGACY_MEMORY_SIZE)(
IN EFI_ACPI_S3_SAVE_PROTOCOL *This,
OUT UINTN *Size
);
The first parameter's type is *NOT* consistent with Framework S3Resume specification, in which it's defined as
"struct _EFI_ACPI_S3_SAVE_PROTOCOL". Also the EFI_BOOTSERVICE modifier is removed from the function declaration.
##
# Mismatch with Intel Platform Innovation Framework for EFI ACPI Specification (Version 0.91)
##
1. Include/Protocol/AcpiSupport.h
typedef
EFI_STATUS
(EFIAPI *EFI_ACPI_GET_ACPI_TABLE)(
...
);
The function modifier is *NOT* consistent with Framework Acpi specification. The EFI_BOOTSERVICE modifier
is removed from the function declaration.
2. Include/Protocol/AcpiSupport.h
typedef
EFI_STATUS
(EFIAPI *EFI_ACPI_SET_ACPI_TABLE)(
...
);
The function modifier is *NOT* consistent with Framework Acpi specification. The EFI_BOOTSERVICE modifier
is removed from the function declaration.
3. Include/Protocol/AcpiSupport.h
typedef
EFI_STATUS
(EFIAPI *EFI_ACPI_PUBLISH_TABLES)(
...
);
The function modifier is *NOT* consistent with Framework Acpi specification. The EFI_BOOTSERVICE modifier
is removed from the function declaration.
|