MdePkg/Include/IndustryStandard/Sal.h

   1 /** @file
   2   Main SAL API's defined in Intel Itanium Processor Family System Abstraction
   3   Layer Specification Revision 3.2 (December 2003)
   4
   5   Copyright (c) 2006 - 2008, Intel Corporation
   6   All rights reserved. This program and the accompanying materials
   7   are licensed and made available under the terms and conditions of the BSD License
   8   which accompanies this distribution.  The full text of the license may be found at
   9   http://opensource.org/licenses/bsd-license.php
  10
  11   THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
  12   WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
  13
  14 **/
  15
  16 #ifndef __SAL_API_H__
  17 #define __SAL_API_H__
  18
  19 ///
  20 /// SAL return status type
  21 ///
  22 typedef UINTN EFI_SAL_STATUS;
  23
  24 ///
  25 /// Call completed without error.
  26 ///
  27 #define EFI_SAL_SUCCESS               ((EFI_SAL_STATUS) 0)
  28 ///
  29 /// Call completed without error but some information was lost due to overflow.
  30 ///
  31 #define EFI_SAL_OVERFLOW              ((EFI_SAL_STATUS) 1)
  32 ///
  33 /// Call completed without error; effect a warm boot of the system to complete the update.
  34 ///
  35 #define EFI_SAL_WARM_BOOT_NEEDED      ((EFI_SAL_STATUS) 2)
  36 ///
  37 /// More information is available for retrieval.
  38 ///
  39 #define EFI_SAL_MORE_RECORDS          ((EFI_SAL_STATUS) 3)
  40 ///
  41 /// Not implemented.
  42 ///
  43 #define EFI_SAL_NOT_IMPLEMENTED       ((EFI_SAL_STATUS) - 1)
  44 ///
  45 /// Invalid Argument.
  46 ///
  47 #define EFI_SAL_INVALID_ARGUMENT      ((EFI_SAL_STATUS) - 2)
  48 ///
  49 /// Call completed without error.
  50 ///
  51 #define EFI_SAL_ERROR                 ((EFI_SAL_STATUS) - 3)
  52 ///
  53 /// Virtual address not registered.
  54 ///
  55 #define EFI_SAL_VIRTUAL_ADDRESS_ERROR ((EFI_SAL_STATUS) - 4)
  56 ///
  57 /// No information available.
  58 ///
  59 #define EFI_SAL_NO_INFORMATION        ((EFI_SAL_STATUS) - 5)
  60 ///
  61 /// Scratch buffer required.
  62 ///
  63 #define EFI_SAL_NOT_ENOUGH_SCRATCH    ((EFI_SAL_STATUS) - 9)
  64
  65 ///
  66 /// Return registers from SAL
  67 ///
  68 typedef struct {
  69   ///
  70   /// SAL return status value in r8
  71   ///
  72   EFI_SAL_STATUS  Status;
  73   ///
  74   /// SAL returned value in r9
  75   ///
  76   UINTN           r9;
  77   ///
  78   /// SAL returned value in r10
  79   ///
  80   UINTN           r10;
  81   ///
  82   /// SAL returned value in r11
  83   ///
  84   UINTN           r11;
  85 } SAL_RETURN_REGS;
  86
  87 /**
  88   Prototype of SAL procedures.
  89
  90   @param  Arg0               Functional identifier.
  91                              The upper 32 bits are ignored and only the lower 32 bits
  92                              are used. The following functional identifiers are defined:
  93                              0x01XXXXXX - Architected SAL functional group.
  94                              0x02XXXXXX to 0x03XXXXXX - OEM SAL functional group. Each OEM is
  95                              allowed to use the entire range in the 0x02XXXXXX to 0x03XXXXXX range.
  96                              0x04XXXXXX to 0xFFFFFFFF - Reserved.
  97   @param  Arg1               The first parameter of the architected/OEM specific SAL functions.
  98   @param  Arg2               The second parameter of the architected/OEM specific SAL functions.
  99   @param  Arg3               The third parameter passed to the ESAL function based
 100   @param  Arg4               The fourth parameter passed to the ESAL function based
 101   @param  Arg5               The fifth parameter passed to the ESAL function based
 102   @param  Arg6               The sixth parameter passed to the ESAL function
 103   @param  Arg7               The seventh parameter passed to the ESAL function based
 104
 105   @return r8                 Return status: positive number indicates successful,
 106                              negative number indicates failure.
 107           r9                 Other return parameter in r9.
 108           r10                Other return parameter in r10.
 109           r11                Other return parameter in r11.
 110
 111 **/
 112 typedef
 113 SAL_RETURN_REGS
 114 (EFIAPI *SAL_PROC) (
 115   IN UINT64 FunctionId,
 116   IN UINT64 Arg2,
 117   IN UINT64 Arg3,
 118   IN UINT64 Arg4,
 119   IN UINT64 Arg5,
 120   IN UINT64 Arg6,
 121   IN UINT64 Arg7,
 122   IN UINT64 Arg8
 123   );
 124
 125 //
 126 // SAL Procedure FunctionId definition
 127 //
 128
 129 ///
 130 /// Register software code locations with SAL.
 131 ///
 132 #define EFI_SAL_SET_VECTORS             0x01000000
 133 ///
 134 /// Return Machine State information obtained by SAL.
 135 ///
 136 #define EFI_SAL_GET_STATE_INFO          0x01000001
 137 ///
 138 /// Obtain size of Machine State information.
 139 ///
 140 #define EFI_SAL_GET_STATE_INFO_SIZE     0x01000002
 141 ///
 142 /// Clear Machine State information.
 143 ///
 144 #define EFI_SAL_CLEAR_STATE_INFO        0x01000003
 145 ///
 146 /// Cause the processor to go into a spin loop within SAL.
 147 ///
 148 #define EFI_SAL_MC_RENDEZ               0x01000004
 149 ///
 150 /// Register the machine check interface layer with SAL.
 151 ///
 152 #define EFI_SAL_MC_SET_PARAMS           0x01000005
 153 ///
 154 /// Register the physical addresses of locations needed by SAL.
 155 ///
 156 #define EFI_SAL_REGISTER_PHYSICAL_ADDR  0x01000006
 157 ///
 158 /// Flush the instruction or data caches.
 159 ///
 160 #define EFI_SAL_CACHE_FLUSH             0x01000008
 161 ///
 162 /// Initialize the instruction and data caches.
 163 ///
 164 #define EFI_SAL_CACHE_INIT              0x01000009
 165 ///
 166 /// Read from the PCI configuration space.
 167 ///
 168 #define EFI_SAL_PCI_CONFIG_READ         0x01000010
 169 ///
 170 /// Write to the PCI configuration space.
 171 ///
 172 #define EFI_SAL_PCI_CONFIG_WRITE        0x01000011
 173 ///
 174 /// Return the base frequency of the platform.
 175 ///
 176 #define EFI_SAL_FREQ_BASE               0x01000012
 177 ///
 178 /// Returns information on the physical processor mapping within the platform.
 179 ///
 180 #define EFI_SAL_PHYSICAL_ID_INFO        0x01000013
 181 ///
 182 /// Update the contents of firmware blocks.
 183 ///
 184 #define EFI_SAL_UPDATE_PAL              0x01000020
 185
 186 #define EFI_SAL_FUNCTION_ID_MASK        0x0000ffff
 187 #define EFI_SAL_MAX_SAL_FUNCTION_ID     0x00000021
 188
 189 //
 190 // SAL Procedure parameter definitions
 191 // Not much point in using typedefs or enums because all params
 192 // are UINT64 and the entry point is common
 193 //
 194
 195 //
 196 // Parameter of EFI_SAL_SET_VECTORS
 197 //
 198 // Vector type
 199 //
 200 #define EFI_SAL_SET_MCA_VECTOR          0x0
 201 #define EFI_SAL_SET_INIT_VECTOR         0x1
 202 #define EFI_SAL_SET_BOOT_RENDEZ_VECTOR  0x2
 203 ///
 204 /// Format of length_cs_n argument.
 205 ///
 206 typedef struct {
 207   UINT64  Length : 32;
 208   UINT64  ChecksumValid : 1;
 209   UINT64  Reserved1 : 7;
 210   UINT64  ByteChecksum : 8;
 211   UINT64  Reserved2 : 16;
 212 } SAL_SET_VECTORS_CS_N;
 213
 214 //
 215 // Parameter of EFI_SAL_GET_STATE_INFO, EFI_SAL_GET_STATE_INFO_SIZE, and EFI_SAL_CLEAR_STATE_INFO
 216 //
 217 // Type of information
 218 //
 219 #define EFI_SAL_MCA_STATE_INFO  0x0
 220 #define EFI_SAL_INIT_STATE_INFO 0x1
 221 #define EFI_SAL_CMC_STATE_INFO  0x2
 222 #define EFI_SAL_CP_STATE_INFO   0x3
 223
 224 //
 225 // Parameter of EFI_SAL_MC_SET_PARAMS
 226 //
 227 // Unsigned 64-bit integer value for the parameter type of the machine check interface
 228 //
 229 #define EFI_SAL_MC_SET_RENDEZ_PARAM 0x1
 230 #define EFI_SAL_MC_SET_WAKEUP_PARAM 0x2
 231 #define EFI_SAL_MC_SET_CPE_PARAM    0x3
 232 //
 233 // Unsigned 64-bit integer value indicating whether interrupt vector or
 234 // memory address is specified
 235 //
 236 #define EFI_SAL_MC_SET_INTR_PARAM   0x1
 237 #define EFI_SAL_MC_SET_MEM_PARAM    0x2
 238
 239 //
 240 // Parameter of EFI_SAL_REGISTER_PAL_PHYSICAL_ADDR
 241 //
 242 // The encoded value of the entity whose physical address is registered
 243 //
 244 #define EFI_SAL_REGISTER_PAL_ADDR 0x0
 245
 246 //
 247 // Parameter of EFI_SAL_CACHE_FLUSH
 248 //
 249 // Unsigned 64-bit integer denoting type of cache flush operation
 250 //
 251 #define EFI_SAL_FLUSH_I_CACHE       0x01
 252 #define EFI_SAL_FLUSH_D_CACHE       0x02
 253 #define EFI_SAL_FLUSH_BOTH_CACHE    0x03
 254 #define EFI_SAL_FLUSH_MAKE_COHERENT 0x04
 255
 256 //
 257 // Parameter of EFI_SAL_PCI_CONFIG_READ and EFI_SAL_PCI_CONFIG_WRITE
 258 //
 259 // PCI config size
 260 //
 261 #define EFI_SAL_PCI_CONFIG_ONE_BYTE   0x1
 262 #define EFI_SAL_PCI_CONFIG_TWO_BYTES  0x2
 263 #define EFI_SAL_PCI_CONFIG_FOUR_BYTES 0x4
 264 //
 265 // The type of PCI configuration address
 266 //
 267 #define EFI_SAL_PCI_COMPATIBLE_ADDRESS         0x0
 268 #define EFI_SAL_PCI_EXTENDED_REGISTER_ADDRESS  0x1
 269 ///
 270 /// Format of PCI Compatible Address
 271 ///
 272 typedef struct {
 273   UINT64  Register : 8;
 274   UINT64  Function : 3;
 275   UINT64  Device : 5;
 276   UINT64  Bus : 8;
 277   UINT64  Segment : 8;
 278   UINT64  Reserved : 32;
 279 } SAL_PCI_ADDRESS;
 280 ///
 281 /// Format of Extended Register Address
 282 ///
 283 typedef struct {
 284   UINT64  Register : 8;
 285   UINT64  ExtendedRegister : 4;
 286   UINT64  Function : 3;
 287   UINT64  Device : 5;
 288   UINT64  Bus : 8;
 289   UINT64  Segment : 16;
 290   UINT64  Reserved : 20;
 291 } SAL_PCI_EXTENDED_REGISTER_ADDRESS;
 292
 293 //
 294 // Parameter of EFI_SAL_FREQ_BASE
 295 //
 296 // Unsigned 64-bit integer specifying the type of clock source
 297 //
 298 #define EFI_SAL_CPU_INPUT_FREQ_BASE     0x0
 299 #define EFI_SAL_PLATFORM_IT_FREQ_BASE   0x1
 300 #define EFI_SAL_PLATFORM_RTC_FREQ_BASE  0x2
 301
 302 //
 303 // Parameter and return value of EFI_SAL_UPDATE_PAL
 304 //
 305 // Return parameter provides additional information on the
 306 // failure when the status field contains a value of -3,
 307 // returned in r9.
 308 //
 309 #define EFI_SAL_UPDATE_BAD_PAL_VERSION  ((UINT64) -1)
 310 #define EFI_SAL_UPDATE_PAL_AUTH_FAIL    ((UINT64) -2)
 311 #define EFI_SAL_UPDATE_PAL_BAD_TYPE     ((UINT64) -3)
 312 #define EFI_SAL_UPDATE_PAL_READONLY     ((UINT64) -4)
 313 #define EFI_SAL_UPDATE_PAL_WRITE_FAIL   ((UINT64) -10)
 314 #define EFI_SAL_UPDATE_PAL_ERASE_FAIL   ((UINT64) -11)
 315 #define EFI_SAL_UPDATE_PAL_READ_FAIL    ((UINT64) -12)
 316 #define EFI_SAL_UPDATE_PAL_CANT_FIT     ((UINT64) -13)
 317 ///
 318 /// 64-byte header of update data block.
 319 ///
 320 typedef struct {
 321   UINT32  Size;
 322   UINT32  MmddyyyyDate;
 323   UINT16  Version;
 324   UINT8   Type;
 325   UINT8   Reserved[5];
 326   UINT64  FwVendorId;
 327 } SAL_UPDATE_PAL_DATA_BLOCK;
 328 ///
 329 /// Data structure pointed by parameter param_buf.
 330 /// It is a 16-byte aligned data structure in memory with a length of 32 bytes
 331 /// that describes the new firmware. This information is organized in the form
 332 /// of a linked list with each element describing one firmware component.
 333 ///
 334 typedef struct _SAL_UPDATE_PAL_INFO_BLOCK {
 335   struct _SAL_UPDATE_PAL_INFO_BLOCK *Next;
 336   struct SAL_UPDATE_PAL_DATA_BLOCK  *DataBlock;
 337   UINT8                             StoreChecksum;
 338   UINT8                             Reserved[15];
 339 } SAL_UPDATE_PAL_INFO_BLOCK;
 340
 341 ///
 342 /// SAL System Table Definitions
 343 ///
 344 #pragma pack(1)
 345 typedef struct {
 346   ///
 347   /// The ASCII string representation of "SST_" which confirms the presence of the table.
 348   ///
 349   UINT32  Signature;
 350   ///
 351   /// The length of the entire table in bytes, starting from offset zero and including the
 352   /// header and all entries indicated by the EntryCount field.
 353   ///
 354   UINT32  Length;
 355   ///
 356   /// The revision number of the Itanium Processor Family System Abstraction Layer
 357   /// Specification supported by the SAL implementation in binary coded decimal (BCD) format.
 358   ///
 359   UINT16  SalRevision;
 360   ///
 361   /// The number of entries in the variable portion of the table.
 362   ///
 363   UINT16  EntryCount;
 364   ///
 365   /// A modulo checksum of the entire table and the entries following this table.
 366   ///
 367   UINT8   CheckSum;
 368   ///
 369   /// Unused, must be zero.
 370   ///
 371   UINT8   Reserved[7];
 372   ///
 373   /// Version Number of the SAL_A firmware implementation in BCD format.
 374   ///
 375   UINT16  SalAVersion;
 376   ///
 377   /// Version Number of the SAL_B firmware implementation in BCD format.
 378   ///
 379   UINT16  SalBVersion;
 380   ///
 381   /// An ASCII identification string which uniquely identifies the manufacturer
 382   /// of the system hardware.
 383   ///
 384   UINT8   OemId[32];
 385   ///
 386   /// An ASCII identification string which uniquely identifies a family of
 387   /// compatible products from the manufacturer.
 388   ///
 389   UINT8   ProductId[32];
 390   ///
 391   /// Unused, must be zero.
 392   ///
 393   UINT8   Reserved2[8];
 394 } SAL_SYSTEM_TABLE_HEADER;
 395 #pragma pack()
 396
 397 #define EFI_SAL_ST_HEADER_SIGNATURE "SST_"
 398 #define EFI_SAL_REVISION            0x0320
 399 //
 400 // SAL System Types
 401 //
 402 #define EFI_SAL_ST_ENTRY_POINT        0
 403 #define EFI_SAL_ST_MEMORY_DESCRIPTOR  1
 404 #define EFI_SAL_ST_PLATFORM_FEATURES  2
 405 #define EFI_SAL_ST_TR_USAGE           3
 406 #define EFI_SAL_ST_PTC                4
 407 #define EFI_SAL_ST_AP_WAKEUP          5
 408
 409 //
 410 // SAL System Type Sizes
 411 //
 412 #define EFI_SAL_ST_ENTRY_POINT_SIZE        48
 413 #define EFI_SAL_ST_MEMORY_DESCRIPTOR_SIZE  32
 414 #define EFI_SAL_ST_PLATFORM_FEATURES_SIZE  16
 415 #define EFI_SAL_ST_TR_USAGE_SIZE           32
 416 #define EFI_SAL_ST_PTC_SIZE                16
 417 #define EFI_SAL_ST_AP_WAKEUP_SIZE          16
 418
 419 #pragma pack(1)
 420 ///
 421 /// Format Entrypoint Descriptor Entry
 422 ///
 423 typedef struct {
 424   UINT8   Type;         ///< Type here should be 0
 425   UINT8   Reserved[7];
 426   UINT64  PalProcEntry;
 427   UINT64  SalProcEntry;
 428   UINT64  SalGlobalDataPointer;
 429   UINT64  Reserved2[2];
 430 } SAL_ST_ENTRY_POINT_DESCRIPTOR;
 431
 432 #pragma pack(1)
 433 ///
 434 /// Format Platform Features Descriptor Entry
 435 ///
 436 typedef struct {
 437   UINT8 Type;           ///< Type here should be 2
 438   UINT8 PlatformFeatures;
 439   UINT8 Reserved[14];
 440 } SAL_ST_PLATFORM_FEATURES;
 441 #pragma pack()
 442 //
 443 // Value of Platform Feature List
 444 //
 445 #define SAL_PLAT_FEAT_BUS_LOCK      0x01
 446 #define SAL_PLAT_FEAT_PLAT_IPI_HINT 0x02
 447 #define SAL_PLAT_FEAT_PROC_IPI_HINT 0x04
 448
 449 #pragma pack(1)
 450 ///
 451 /// Format of Translation Register Descriptor Entry
 452 ///
 453 typedef struct {
 454   UINT8   Type;         ///< Type here should be 3
 455   UINT8   TRType;
 456   UINT8   TRNumber;
 457   UINT8   Reserved[5];
 458   UINT64  VirtualAddress;
 459   UINT64  EncodedPageSize;
 460   UINT64  Reserved1;
 461 } SAL_ST_TR_DECRIPTOR;
 462 #pragma pack()
 463 //
 464 // Type of Translation Register
 465 //
 466 #define EFI_SAL_ST_TR_USAGE_INSTRUCTION 00
 467 #define EFI_SAL_ST_TR_USAGE_DATA        01
 468
 469 #pragma pack(1)
 470 ///
 471 /// Definition of Coherence Domain Information
 472 ///
 473 typedef struct {
 474   UINT64  NumberOfProcessors;
 475   UINT64  LocalIDRegister;
 476 } SAL_COHERENCE_DOMAIN_INFO;
 477 #pragma pack()
 478
 479 #pragma pack(1)
 480 ///
 481 /// Format of Purge Translation Cache Coherence Domain Entry
 482 ///
 483 typedef struct {
 484   UINT8                     Type;       ///< Type here should be 4
 485   UINT8                     Reserved[3];
 486   UINT32                    NumberOfDomains;
 487   SAL_COHERENCE_DOMAIN_INFO *DomainInformation;
 488 } SAL_ST_CACHE_COHERENCE_DECRIPTOR;
 489 #pragma pack()
 490
 491 #pragma pack(1)
 492 ///
 493 /// Format of Application Processor Wake-Up Descriptor Entry
 494 ///
 495 typedef struct {
 496   UINT8   Type;                   ///< Type here should be 5
 497   UINT8   WakeUpType;
 498   UINT8   Reserved[6];
 499   UINT64  ExternalInterruptVector;
 500 } SAL_ST_AP_WAKEUP_DECRIPTOR;
 501 #pragma pack()
 502
 503 ///
 504 /// Format of Firmware Interface Table (FIT) Entry
 505 ///
 506 typedef struct {
 507   UINT64  Address;
 508   UINT8   Size[3];
 509   UINT8   Reserved;
 510   UINT16  Revision;
 511   UINT8   Type : 7;
 512   UINT8   CheckSumValid : 1;
 513   UINT8   CheckSum;
 514 } EFI_SAL_FIT_ENTRY;
 515 //
 516 // FIT Types
 517 //
 518 #define EFI_SAL_FIT_FIT_HEADER_TYPE                0x00
 519 #define EFI_SAL_FIT_PAL_B_TYPE                     0x01
 520 //
 521 // Type from 0x02 to 0x0D is reserved.
 522 //
 523 #define EFI_SAL_FIT_PROCESSOR_SPECIFIC_PAL_A_TYPE  0x0E
 524 #define EFI_SAL_FIT_PAL_A_TYPE                     0x0F
 525 //
 526 // OEM-defined type range is from 0x10 to 0x7E.
 527 // Here we defined the PEI_CORE type as 0x10
 528 //
 529 #define EFI_SAL_FIT_PEI_CORE_TYPE                  0x10
 530 #define EFI_SAL_FIT_UNUSED_TYPE                    0x7F
 531
 532 //
 533 // FIT Entry
 534 //
 535 #define EFI_SAL_FIT_ENTRY_PTR   (0x100000000 - 32)  // 4GB - 24
 536 #define EFI_SAL_FIT_PALA_ENTRY  (0x100000000 - 48)  // 4GB - 32
 537 #define EFI_SAL_FIT_PALB_TYPE   01
 538
 539 //
 540 // Following definitions are for Error Record Structure
 541 //
 542
 543 ///
 544 /// Format of TimeStamp field in Record Header
 545 ///
 546 typedef struct {
 547   UINT8 Seconds;
 548   UINT8 Minutes;
 549   UINT8 Hours;
 550   UINT8 Reserved;
 551   UINT8 Day;
 552   UINT8 Month;
 553   UINT8 Year;
 554   UINT8 Century;
 555 } SAL_TIME_STAMP;
 556 ///
 557 /// Definition of Record Header
 558 ///
 559 typedef struct {
 560   UINT64          RecordId;
 561   UINT16          Revision;
 562   UINT8           ErrorSeverity;
 563   UINT8           ValidationBits;
 564   UINT32          RecordLength;
 565   SAL_TIME_STAMP  TimeStamp;
 566   UINT8           OemPlatformId[16];
 567 } SAL_RECORD_HEADER;
 568 ///
 569 /// Definition of Section Header
 570 ///
 571 typedef struct {
 572   GUID      Guid;
 573   UINT16    Revision;
 574   UINT8     ErrorRecoveryInfo;
 575   UINT8     Reserved;
 576   UINT32    SectionLength;
 577 } SAL_SEC_HEADER;
 578
 579 ///
 580 /// GUID of Processor Machine Check Errors
 581 ///
 582 #define SAL_PROCESSOR_ERROR_RECORD_INFO \
 583   { \
 584     0xe429faf1, 0x3cb7, 0x11d4, {0xbc, 0xa7, 0x0, 0x80, 0xc7, 0x3c, 0x88, 0x81 } \
 585   }
 586 //
 587 // Bit masks for valid bits of MOD_ERROR_INFO
 588 //
 589 #define CHECK_INFO_VALID_BIT_MASK   0x1
 590 #define REQUESTOR_ID_VALID_BIT_MASK 0x2
 591 #define RESPONDER_ID_VALID_BIT_MASK 0x4
 592 #define TARGER_ID_VALID_BIT_MASK    0x8
 593 #define PRECISE_IP_VALID_BIT_MASK   0x10
 594 ///
 595 /// Definition of MOD_ERROR_INFO_STRUCT
 596 ///
 597 typedef struct {
 598   UINT64  InfoValid : 1;
 599   UINT64  ReqValid : 1;
 600   UINT64  RespValid : 1;
 601   UINT64  TargetValid : 1;
 602   UINT64  IpValid : 1;
 603   UINT64  Reserved : 59;
 604   UINT64  Info;
 605   UINT64  Req;
 606   UINT64  Resp;
 607   UINT64  Target;
 608   UINT64  Ip;
 609 } MOD_ERROR_INFO;
 610 ///
 611 /// Definition of CPUID_INFO_STRUCT
 612 ///
 613 typedef struct {
 614   UINT8 CpuidInfo[40];
 615   UINT8 Reserved;
 616 } CPUID_INFO;
 617
 618 typedef struct {
 619   UINT64  FrLow;
 620   UINT64  FrHigh;
 621 } FR_STRUCT;
 622 //
 623 // Bit masks for PSI_STATIC_STRUCT.ValidFieldBits
 624 //
 625 #define MIN_STATE_VALID_BIT_MASK  0x1
 626 #define BR_VALID_BIT_MASK         0x2
 627 #define CR_VALID_BIT_MASK         0x4
 628 #define AR_VALID_BIT_MASK         0x8
 629 #define RR_VALID_BIT_MASK         0x10
 630 #define FR_VALID_BIT_MASK         0x20
 631 ///
 632 /// Definition of PSI_STATIC_STRUCT
 633 ///
 634 typedef struct {
 635   UINT64    ValidFieldBits;
 636   UINT8     MinStateInfo[1024];
 637   UINT64    Br[8];
 638   UINT64    Cr[128];
 639   UINT64    Ar[128];
 640   UINT64    Rr[8];
 641   FR_STRUCT Fr[128];
 642 } PSI_STATIC_STRUCT;
 643 //
 644 // Bit masks for SAL_PROCESSOR_ERROR_RECORD.ValidationBits
 645 //
 646 #define PROC_ERROR_MAP_VALID_BIT_MASK       0x1
 647 #define PROC_STATE_PARAMETER_VALID_BIT_MASK 0x2
 648 #define PROC_CR_LID_VALID_BIT_MASK          0x4
 649 #define PROC_STATIC_STRUCT_VALID_BIT_MASK   0x8
 650 #define CPU_INFO_VALID_BIT_MASK             0x1000000
 651 ///
 652 /// Definition of Processor Machine Check Error Record
 653 ///
 654 typedef struct {
 655   SAL_SEC_HEADER    SectionHeader;
 656   UINT64            ValidationBits;
 657   UINT64            ProcErrorMap;
 658   UINT64            ProcStateParameter;
 659   UINT64            ProcCrLid;
 660   MOD_ERROR_INFO    CacheError[15];
 661   MOD_ERROR_INFO    TlbError[15];
 662   MOD_ERROR_INFO    BusError[15];
 663   MOD_ERROR_INFO    RegFileCheck[15];
 664   MOD_ERROR_INFO    MsCheck[15];
 665   CPUID_INFO        CpuInfo;
 666   PSI_STATIC_STRUCT PsiValidData;
 667 } SAL_PROCESSOR_ERROR_RECORD;
 668
 669 ///
 670 /// GUID of Platform Memory Device Error Info
 671 ///
 672 #define SAL_MEMORY_ERROR_RECORD_INFO \
 673   { \
 674     0xe429faf2, 0x3cb7, 0x11d4, {0xbc, 0xa7, 0x0, 0x80, 0xc7, 0x3c, 0x88, 0x81 } \
 675   }
 676 //
 677 // Bit masks for SAL_MEMORY_ERROR_RECORD.ValidationBits
 678 //
 679 #define MEMORY_ERROR_STATUS_VALID_BIT_MASK                0x1
 680 #define MEMORY_PHYSICAL_ADDRESS_VALID_BIT_MASK            0x2
 681 #define MEMORY_ADDR_BIT_MASK                              0x4
 682 #define MEMORY_NODE_VALID_BIT_MASK                        0x8
 683 #define MEMORY_CARD_VALID_BIT_MASK                        0x10
 684 #define MEMORY_MODULE_VALID_BIT_MASK                      0x20
 685 #define MEMORY_BANK_VALID_BIT_MASK                        0x40
 686 #define MEMORY_DEVICE_VALID_BIT_MASK                      0x80
 687 #define MEMORY_ROW_VALID_BIT_MASK                         0x100
 688 #define MEMORY_COLUMN_VALID_BIT_MASK                      0x200
 689 #define MEMORY_BIT_POSITION_VALID_BIT_MASK                0x400
 690 #define MEMORY_PLATFORM_REQUESTOR_ID_VALID_BIT_MASK       0x800
 691 #define MEMORY_PLATFORM_RESPONDER_ID_VALID_BIT_MASK       0x1000
 692 #define MEMORY_PLATFORM_TARGET_VALID_BIT_MASK             0x2000
 693 #define MEMORY_PLATFORM_BUS_SPECIFIC_DATA_VALID_BIT_MASK  0x4000
 694 #define MEMORY_PLATFORM_OEM_ID_VALID_BIT_MASK             0x8000
 695 #define MEMORY_PLATFORM_OEM_DATA_STRUCT_VALID_BIT_MASK    0x10000
 696 ///
 697 /// Definition of Platform Memory Device Error Info Record
 698 ///
 699 typedef struct {
 700   SAL_SEC_HEADER  SectionHeader;
 701   UINT64          ValidationBits;
 702   UINT64          MemErrorStatus;
 703   UINT64          MemPhysicalAddress;
 704   UINT64          MemPhysicalAddressMask;
 705   UINT16          MemNode;
 706   UINT16          MemCard;
 707   UINT16          MemModule;
 708   UINT16          MemBank;
 709   UINT16          MemDevice;
 710   UINT16          MemRow;
 711   UINT16          MemColumn;
 712   UINT16          MemBitPosition;
 713   UINT64          ModRequestorId;
 714   UINT64          ModResponderId;
 715   UINT64          ModTargetId;
 716   UINT64          BusSpecificData;
 717   UINT8           MemPlatformOemId[16];
 718 } SAL_MEMORY_ERROR_RECORD;
 719
 720 ///
 721 /// GUID of Platform PCI Bus Error Info
 722 ///
 723 #define SAL_PCI_BUS_ERROR_RECORD_INFO \
 724   { \
 725     0xe429faf4, 0x3cb7, 0x11d4, {0xbc, 0xa7, 0x0, 0x80, 0xc7, 0x3c, 0x88, 0x81 } \
 726   }
 727 //
 728 // Bit masks for SAL_PCI_BUS_ERROR_RECORD.ValidationBits
 729 //
 730 #define PCI_BUS_ERROR_STATUS_VALID_BIT_MASK     0x1
 731 #define PCI_BUS_ERROR_TYPE_VALID_BIT_MASK       0x2
 732 #define PCI_BUS_ID_VALID_BIT_MASK               0x4
 733 #define PCI_BUS_ADDRESS_VALID_BIT_MASK          0x8
 734 #define PCI_BUS_DATA_VALID_BIT_MASK             0x10
 735 #define PCI_BUS_CMD_VALID_BIT_MASK              0x20
 736 #define PCI_BUS_REQUESTOR_ID_VALID_BIT_MASK     0x40
 737 #define PCI_BUS_RESPONDER_ID_VALID_BIT_MASK     0x80
 738 #define PCI_BUS_TARGET_VALID_BIT_MASK           0x100
 739 #define PCI_BUS_OEM_ID_VALID_BIT_MASK           0x200
 740 #define PCI_BUS_OEM_DATA_STRUCT_VALID_BIT_MASK  0x400
 741
 742 typedef struct {
 743   UINT8 BusNumber;
 744   UINT8 SegmentNumber;
 745 } PCI_BUS_ID;
 746 ///
 747 /// Definition of Platform PCI Bus Error Info Record
 748 ///
 749 typedef struct {
 750   SAL_SEC_HEADER  SectionHeader;
 751   UINT64          ValidationBits;
 752   UINT64          PciBusErrorStatus;
 753   UINT16          PciBusErrorType;
 754   PCI_BUS_ID      PciBusId;
 755   UINT32          Reserved;
 756   UINT64          PciBusAddress;
 757   UINT64          PciBusData;
 758   UINT64          PciBusCommand;
 759   UINT64          PciBusRequestorId;
 760   UINT64          PciBusResponderId;
 761   UINT64          PciBusTargetId;
 762   UINT8           PciBusOemId[16];
 763 } SAL_PCI_BUS_ERROR_RECORD;
 764
 765 ///
 766 /// GUID of Platform PCI Component Error Info
 767 ///
 768 #define SAL_PCI_COMP_ERROR_RECORD_INFO \
 769   { \
 770     0xe429faf6, 0x3cb7, 0x11d4, {0xbc, 0xa7, 0x0, 0x80, 0xc7, 0x3c, 0x88, 0x81 } \
 771   }
 772 //
 773 // Bit masks for SAL_PCI_COMPONENT_ERROR_RECORD.ValidationBits
 774 //
 775 #define PCI_COMP_ERROR_STATUS_VALID_BIT_MASK    0x1
 776 #define PCI_COMP_INFO_VALID_BIT_MASK            0x2
 777 #define PCI_COMP_MEM_NUM_VALID_BIT_MASK         0x4
 778 #define PCI_COMP_IO_NUM_VALID_BIT_MASK          0x8
 779 #define PCI_COMP_REG_DATA_PAIR_VALID_BIT_MASK   0x10
 780 #define PCI_COMP_OEM_DATA_STRUCT_VALID_BIT_MASK 0x20
 781 ///
 782 /// Format of PCI Component Information to identify the device
 783 ///
 784 typedef struct {
 785   UINT16  VendorId;
 786   UINT16  DeviceId;
 787   UINT8   ClassCode[3];
 788   UINT8   FunctionNumber;
 789   UINT8   DeviceNumber;
 790   UINT8   BusNumber;
 791   UINT8   SegmentNumber;
 792   UINT8   Reserved[5];
 793 } PCI_COMP_INFO;
 794 ///
 795 /// Definition of Platform PCI Component Error Info
 796 ///
 797 typedef struct {
 798   SAL_SEC_HEADER  SectionHeader;
 799   UINT64          ValidationBits;
 800   UINT64          PciComponentErrorStatus;
 801   PCI_COMP_INFO   PciComponentInfo;
 802   UINT32          PciComponentMemNum;
 803   UINT32          PciComponentIoNum;
 804   UINT8           PciBusOemId[16];
 805 } SAL_PCI_COMPONENT_ERROR_RECORD;
 806
 807 ///
 808 /// Platform SEL Device Error Info
 809 ///
 810 #define SAL_SEL_DEVICE_ERROR_RECORD_INFO \
 811   { \
 812     0xe429faf3, 0x3cb7, 0x11d4, {0xbc, 0xa7, 0x0, 0x80, 0xc7, 0x3c, 0x88, 0x81 } \
 813   }
 814 //
 815 // Bit masks for SAL_SEL_DEVICE_ERROR_RECORD.ValidationBits
 816 //
 817 #define SEL_RECORD_ID_VALID_BIT_MASK      0x1;
 818 #define SEL_RECORD_TYPE_VALID_BIT_MASK    0x2;
 819 #define SEL_GENERATOR_ID_VALID_BIT_MASK   0x4;
 820 #define SEL_EVM_REV_VALID_BIT_MASK        0x8;
 821 #define SEL_SENSOR_TYPE_VALID_BIT_MASK    0x10;
 822 #define SEL_SENSOR_NUM_VALID_BIT_MASK     0x20;
 823 #define SEL_EVENT_DIR_TYPE_VALID_BIT_MASK 0x40;
 824 #define SEL_EVENT_DATA1_VALID_BIT_MASK    0x80;
 825 #define SEL_EVENT_DATA2_VALID_BIT_MASK    0x100;
 826 #define SEL_EVENT_DATA3_VALID_BIT_MASK    0x200;
 827 ///
 828 /// Definition of Platform SEL Device Error Info Record
 829 ///
 830 typedef struct {
 831   SAL_SEC_HEADER  SectionHeader;
 832   UINT64          ValidationBits;
 833   UINT16          SelRecordId;
 834   UINT8           SelRecordType;
 835   UINT32          TimeStamp;
 836   UINT16          GeneratorId;
 837   UINT8           EvmRevision;
 838   UINT8           SensorType;
 839   UINT8           SensorNum;
 840   UINT8           EventDirType;
 841   UINT8           Data1;
 842   UINT8           Data2;
 843   UINT8           Data3;
 844 } SAL_SEL_DEVICE_ERROR_RECORD;
 845
 846 ///
 847 /// GUID of Platform SMBIOS Device Error Info
 848 ///
 849 #define SAL_SMBIOS_ERROR_RECORD_INFO \
 850   { \
 851     0xe429faf5, 0x3cb7, 0x11d4, {0xbc, 0xa7, 0x0, 0x80, 0xc7, 0x3c, 0x88, 0x81 } \
 852   }
 853 //
 854 // Bit masks for SAL_SMBIOS_DEVICE_ERROR_RECORD.ValidationBits
 855 //
 856 #define SMBIOS_EVENT_TYPE_VALID_BIT_MASK  0x1
 857 #define SMBIOS_LENGTH_VALID_BIT_MASK      0x2
 858 #define SMBIOS_TIME_STAMP_VALID_BIT_MASK  0x4
 859 #define SMBIOS_DATA_VALID_BIT_MASK        0x8
 860 ///
 861 /// Definition of Platform SMBIOS Device Error Info Record
 862 ///
 863 typedef struct {
 864   SAL_SEC_HEADER  SectionHeader;
 865   UINT64          ValidationBits;
 866   UINT8           SmbiosEventType;
 867   UINT8           SmbiosLength;
 868   UINT8           SmbiosBcdTimeStamp[6];
 869 } SAL_SMBIOS_DEVICE_ERROR_RECORD;
 870
 871 ///
 872 /// GUID of Platform Specific Error Info
 873 ///
 874 #define SAL_PLATFORM_ERROR_RECORD_INFO \
 875   { \
 876     0xe429faf7, 0x3cb7, 0x11d4, {0xbc, 0xa7, 0x0, 0x80, 0xc7, 0x3c, 0x88, 0x81 } \
 877   }
 878 //
 879 // Bit masks for SAL_PLATFORM_SPECIFIC_ERROR_RECORD.ValidationBits
 880 //
 881 #define PLATFORM_ERROR_STATUS_VALID_BIT_MASK    0x1
 882 #define PLATFORM_REQUESTOR_ID_VALID_BIT_MASK    0x2
 883 #define PLATFORM_RESPONDER_ID_VALID_BIT_MASK    0x4
 884 #define PLATFORM_TARGET_VALID_BIT_MASK          0x8
 885 #define PLATFORM_SPECIFIC_DATA_VALID_BIT_MASK   0x10
 886 #define PLATFORM_OEM_ID_VALID_BIT_MASK          0x20
 887 #define PLATFORM_OEM_DATA_STRUCT_VALID_BIT_MASK 0x40
 888 #define PLATFORM_OEM_DEVICE_PATH_VALID_BIT_MASK 0x80
 889 ///
 890 /// Definition of Platform Specific Error Info Record
 891 ///
 892 typedef struct {
 893   SAL_SEC_HEADER  SectionHeader;
 894   UINT64          ValidationBits;
 895   UINT64          PlatformErrorStatus;
 896   UINT64          PlatformRequestorId;
 897   UINT64          PlatformResponderId;
 898   UINT64          PlatformTargetId;
 899   UINT64          PlatformBusSpecificData;
 900   UINT8           OemComponentId[16];
 901 } SAL_PLATFORM_SPECIFIC_ERROR_RECORD;
 902
 903 ///
 904 /// Union of all the possible SAL Error Record Types
 905 ///
 906 typedef union {
 907   SAL_RECORD_HEADER                   *RecordHeader;
 908   SAL_PROCESSOR_ERROR_RECORD          *SalProcessorRecord;
 909   SAL_PCI_BUS_ERROR_RECORD            *SalPciBusRecord;
 910   SAL_PCI_COMPONENT_ERROR_RECORD      *SalPciComponentRecord;
 911   SAL_SEL_DEVICE_ERROR_RECORD         *ImpiRecord;
 912   SAL_SMBIOS_DEVICE_ERROR_RECORD      *SmbiosRecord;
 913   SAL_PLATFORM_SPECIFIC_ERROR_RECORD  *PlatformRecord;
 914   SAL_MEMORY_ERROR_RECORD             *MemoryRecord;
 915   UINT8                               *Raw;
 916 } SAL_ERROR_RECORDS_POINTERS;
 917
 918 #pragma pack()
 919
 920 #endif