/** @file Copyright (c) 2024, Intel Corporation. All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. * Neither the name of Intel Corporation nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. This file is automatically generated. Please do NOT modify !!! **/ #ifndef _MEMORY_MAP_DATA_HOB_H_ #define _MEMORY_MAP_DATA_HOB_H_ #define MEMORY_MAP_HOB_GUID { 0xf8870015, 0x6994, 0x4b98, { 0x95, 0xa2, 0xbd, 0x56, 0xda, 0x91, 0xc0, 0x7f } } #ifndef MAX_SOCKET #define MAX_SOCKET 2 #endif #ifndef MAX_IMC #define MAX_IMC 12 // Maximum memory controllers per socket #endif #ifndef MAX_MC_CH #define MAX_MC_CH 1 // Max number of channels per MC (3 for EP) #endif #ifndef MAX_CH #define MAX_CH ((MAX_IMC)*(MAX_MC_CH)) // Max channels per socket (worst case EP * EX combination = 16) #endif #ifndef MAX_CXL_HOST_BRIDGES #define MAX_CXL_HOST_BRIDGES 0x6 // Maximum number of CXL host bridges per socket. #endif #ifndef MAX_CXL_HOST_BRIDGE_WAYS #define MAX_CXL_HOST_BRIDGE_WAYS 0x4 // Maximum interleave ways of CXL host bridges per socket. #endif // // Macro definitions for abstracted memory decoding target. The data structure is designed to // iterate iMC and CXL host bridge host decoded memory in an unified way. // definition for GNRSRF/GNRD/GRR // #define MAX_CXL_AMT MAX_CXL_HOST_BRIDGES // Max number of unique interleaves for NGN DIMM #ifndef MAX_UNIQUE_NGN_DIMM_INTERLEAVE #define MAX_UNIQUE_NGN_DIMM_INTERLEAVE 2 // Max number of unique interleaves for NGN DIMM #endif #ifndef MAX_SPARE_RANK #define MAX_SPARE_RANK 2 // Max number of spare ranks in a channel #endif #ifndef MAX_HBM_IO #define MAX_HBM_IO 4 #endif #ifndef MAX_DIMM #define MAX_DIMM 2 // Max DIMM per channel #endif #ifndef MAX_RANK_DIMM #define MAX_RANK_DIMM 2 #endif #ifndef MAX_DRAM_CLUSTERS #define MAX_DRAM_CLUSTERS 6 #endif #ifndef MAX_SAD_RULES #define MAX_SAD_RULES 16 #endif #ifndef MAX_FPGA_REMOTE_SAD_RULES #define MAX_FPGA_REMOTE_SAD_RULES 2 // Maximum FPGA sockets exists on ICX platform #endif #define MAX_SI_SOCKET 8 // Maximum silicon supported socket number #define MAX_AMT (MAX_IMC+MAX_CXL_AMT) // Max abstract memory target per socket #define AMT_MAX_NODE ((MAX_AMT)*(MAX_SOCKET)) // Max abstract memory target for all sockets // NGN #define NGN_MAX_SERIALNUMBER_STRLEN 4 #define NGN_MAX_PARTNUMBER_STRLEN 30 #define NGN_FW_VER_LEN 4 #define NGN_LOG_TYPE_NUM 2 #define NGN_LOG_LEVEL_NUM 2 /** * Memory channel index conversion macros. * * We got two types of memory channel indexes: * - socket channel - indexes 0..MAX_CH, used in [socket][channel] indexing * - IMC channel - indexes 0..MAX_MC_CH, used in [socket][IMC][channel] indexing * The below defined macros convert one channel index to the other one. */ #define MEM_SKTCH_TO_IMC(SktCh) ((SktCh) / MAX_MC_CH) #define MEM_SKTCH_TO_IMCCH(SktCh) ((SktCh) % MAX_MC_CH) #define MEM_IMCCH_TO_SKTCH(Imc, Ch) ((Imc) * MAX_MC_CH + (Ch)) #define MEM_64MB_TO_BYTES(Size64M) ((UINT64)(Size64M) << 26) #define MEM_64MB_TO_KBYTES(Size64M) ((UINT64)(Size64M) << 16) #define MEM_64MB_TO_MBYTES(Size64M) ((UINT64)(Size64M) << 6) #define MEM_64MB_TO_GBYTES(Size64M) ((Size64M) >> 4) #define MEM_BYTES_TO_64MB(SizeB) ((SizeB) >> 26) #define MEM_KBYTES_TO_64MB(SizeKB) ((SizeKB) >> 16) #define MEM_MBYTES_TO_64MB(SizeMB) ((SizeMB) >> 6) typedef UINT8 INTLV_SET_KEY; #define FSP_RESERVED1_LEN 5748 #define FSP_RESERVED2_LEN 1 #define FSP_RESERVED3_LEN 220 #define FSP_RESERVED4_LEN 10 #pragma pack(1) struct RankDevice { UINT8 enabled; // 0 = disabled, 1 = enabled UINT8 logicalRank; // Logical Rank number (0 - 7) UINT16 rankSize; // Units of 64 MB }; struct PersisentDpaMap { UINT32 perRegionDPAOffset; UINT32 SPALimit; }; typedef struct firmwareRev { UINT8 majorVersion; UINT8 minorVersion; UINT8 hotfixVersion; UINT16 buildVersion; } FIRMWARE_REV; typedef struct DimmDevice { UINT8 Present; BOOLEAN Enabled; UINT8 DcpmmPresent; // 1 - This is a DCPMM UINT8 X4Present; UINT8 DramIoWidth; // Actual DRAM IO Width (4, 8, 16) UINT8 NumRanks; // Number of ranks on dimm UINT8 NumPackageRanks; // Number of Package ranks on dimm // For DDR5 NumRanks and NumPackageRanks same // For MRDIMM NumRanks and NumPackageRanks may differ UINT8 keyByte; UINT8 actKeyByte2; // Actual module type reported by SPD UINT8 actSPDModuleOrg; // Actual number of DRAM ranks and device width UINT8 dimmTs; // Thermal sensor data. UINT16 VolCap; // Volatile capacity (AEP DIMM only) UINT16 nonVolCap; // Non-volatile capacity (AEP DIMM only) UINT16 DimmSize; UINT16 SPDMMfgId; // Module Mfg Id from SPD UINT16 VendorID; UINT16 DeviceID; UINT16 RevisionID; UINT32 perRegionDPA; // DPA of PMEM that Nfit needs struct PersisentDpaMap perDPAMap[MAX_UNIQUE_NGN_DIMM_INTERLEAVE]; // DPA map UINT8 serialNumber[NGN_MAX_SERIALNUMBER_STRLEN]; // Serial Number UINT8 PartNumber[NGN_MAX_PARTNUMBER_STRLEN]; // Part Number UINT8 FirmwareVersionStr[NGN_FW_VER_LEN]; // Used to update the SMBIOS TYPE 17 struct firmwareRev FirmwareVersion; // Firmware revision struct RankDevice rankList[MAX_RANK_DIMM]; UINT16 InterfaceFormatCode; UINT16 SubsystemVendorID; UINT16 SubsystemDeviceID; UINT16 SubsystemRevisionID; UINT16 FisVersion; // Firmware Interface Specification version UINT8 DimmSku; // Dimm SKU info UINT8 manufacturingLocation; // Manufacturing location for the NVDIMM UINT16 manufacturingDate; // Date the NVDIMM was manufactured INT32 commonTck; UINT8 EnergyType; // 0: 12V aux power; 1: dedicated backup energy source; 2: no backup energy source BOOLEAN NvDimmNPresent; // JEDEC NVDIMM-N Type Memory Present UINT8 CidBitMap; // SubRankPer CS for DIMM device UINT16 SPDRegVen; // Register Vendor ID in SPD UINT8 SPDOtherOptFeatures; // SDRAM Other Optional features BOOLEAN DimmChanged; } MEMMAP_DIMM_DEVICE_INFO_STRUCT; typedef struct ChannelDevice { UINT8 Enabled; // 0 = channel disabled, 1 = channel enabled UINT8 Features; // Bit mask of features to enable or disable UINT8 MaxDimm; // Number of DIMM UINT8 NumRanks; // Number of ranks on this channel UINT8 chFailed; UINT8 ngnChFailed; UINT8 Is4BitEccDimmPresent; // 4-bit Ecc dimm present indicator UINT8 SpareLogicalRank[MAX_SPARE_RANK]; // Logical rank, selected as Spare UINT8 SparePhysicalRank[MAX_SPARE_RANK]; // Physical rank, selected as spare UINT16 SpareRankSize[MAX_SPARE_RANK]; // spare rank size UINT8 EnabledLogicalRanks; // Bitmap of Logical ranks that are enabled UINT8 DdrPopulationMap; // Bitmap to indicate location of DDR DIMMs within the channel memory slots (BIT0: Ch.D0, BIT1: CH.D1) UINT8 PmemPopulationMap; // Bitmap to indicate location of PMem modules within the channel memory slots (BIT0: Ch.D0, BIT1: CH.D1) MEMMAP_DIMM_DEVICE_INFO_STRUCT DimmInfo[MAX_DIMM]; } CHANNEL_DEVICE; typedef struct memcontroller { UINT32 MemSize; } MEMCONTROLLER; typedef enum { MemTypeNone = 0, MemType1lmDdr, MemType1lmAppDirect, MemType1lmAppDirectReserved, MemType1lmCtrl, MemType1lmHbm, MemTypeNxm, MemType2lmDdrCacheMemoryMode, MemType2lmDdrWbCacheAppDirect, MemType2lmHbmCacheDdr, MemType2lmHbmCacheMemoryMode, MemTypeCxlAccVolatileMem, MemTypeCxlAccPersistentMem, MemTypeFpga, MemTypeCxlExpVolatileMem, MemTypeCxlExpPersistentMem, MemTypeCxl2lmDdrCacheMem, MemTypeCxlHetero, MemTypeCxlAccVolatileMemHdmDb, MemTypeCxlExpVolatileMemDcd, MemTypeMax } MEM_TYPE; typedef struct SADTable { UINT8 Enable; // Rule enable MEM_TYPE type; // Bit map of memory region types, See defines 'MEM_TYPE_???' above for bit definitions of the ranges. UINT8 granularity; // Interleave granularities for current SAD entry. Possible interleave granularity options depend on the SAD entry type. Note that SAD entry type BLK Window and CSR/Mailbox/Ctrl region do not support any granularity options UINT32 Base; // Base of the current SAD entry UINT32 Limit; // Limit of the current SAD entry UINT8 ways; // Interleave ways for SAD UINT8 channelInterBitmap[MAX_AMT]; //Bit map to denote which DDR4/NM channels are interleaved per IMC eg: 111b - Ch 2,1 & 0 are interleaved; 011b denotes Ch1 & 0 are interleaved UINT8 FMchannelInterBitmap[MAX_AMT]; //Bit map to denote which FM channels are interleaved per IMC eg: 111b - Ch 2,1 & 0 are interleaved; 011b denotes Ch1 & 0 are interleaved UINT8 NmChWays; // Channel Interleave ways for SAD. Represents channelInterBitmap ways for DDR4/NM. UINT8 FmChWays; // Channel Interleave ways for SAD. Represents FMchannelInterBitmap ways for DDRT. UINT32 imcInterBitmap; // Bit map to denote which IMCs are interleaved from this socket (based on channel ID for DMR). UINT32 NmImcInterBitmap; // Bit map to denote which IMCs are interleaved from this socket as NM. BOOLEAN local; // 0 - Remote 1- Local UINT8 IotEnabled; // To indicate if IOT is enabled UINT8 mirrored; // To Indicate the SAD is mirrored while enabling partial mirroring UINT8 Attr; UINT8 tgtGranularity; // Interleave mode for target list UINT8 Cluster; // SNC cluster, hemisphere, or quadrant index. UINT8 HostBridgeGran; // Host bridge interleaving granularity. UINT8 HostBridgeList[MAX_CXL_HOST_BRIDGE_WAYS]; // List of interleaved CXL host bridges (DMR and beyond). UINT32 HotPlugPadSize; // Memory size padded for CXL hot plug. 0 if it is not a CXL hot plug SAD. INTLV_SET_KEY CxlIntlvSetKey; // The unique key of CXL interleave set. (7nm) } SAD_TABLE; typedef struct socket { UINT8 SocketEnabled; UINT32 IioStackBitmap; BOOLEAN HbmIoEn[MAX_HBM_IO]; // Flag indicates if HBM IO is enabled. TRUE: HBM IO is Enabled, FALSE: HBM IO is disabled. UINT8 imcEnabled[MAX_IMC]; UINT8 SadIntList[MAX_DRAM_CLUSTERS * MAX_SAD_RULES][AMT_MAX_NODE]; // SAD interleave list UINT32 SktTotMemMapSPA; // Total memory mapped to SPA SAD_TABLE SAD[MAX_DRAM_CLUSTERS * MAX_SAD_RULES]; // SAD table MEMCONTROLLER imc[MAX_IMC]; CHANNEL_DEVICE ChannelInfo[MAX_CH]; } MEMMAP_SOCKET; typedef struct { UINT8 Enabled; // Indicates if this EDC is enabled UINT32 MemAsCache; // Memory used as Cache, in 64MB units UINT32 MemAsFlat; // Memory used as Flat memory, in 64MB units } EDC_INFO; typedef struct SystemMemoryMapElement { UINT16 Type; // Type of this memory element; Bit0: 1LM Bit1: 2LM Bit2: PMEM Bit3: PMEM-cache Bit4: BLK Window Bit5: CSR/Mailbox/Ctrl region UINT8 NodeId; // Node ID of the HA Owning the memory UINT8 SocketId; // Socket Id of socket that has his memory - ONLY IN NUMA UINT8 ClusterId; // Logical cluster Id of SNC cluster - only 0 in UMA clustering and all2all UINT8 SktInterBitmap; // Socket interleave bitmap, if more that on socket then ImcInterBitmap and ChInterBitmap are identical in all sockets UINT32 ImcInterBitmap; // IMC interleave bitmap for this memory UINT8 ChInterBitmap[MAX_AMT];//Bit map to denote which channels are interleaved per IMC eg: 111b - Ch 2,1 & 0 are interleaved; 011b denotes Ch1 & 0 are interleaved UINT32 BaseAddress; // Base Address of the element in 64MB chunks UINT32 ElementSize; // Size of this memory element in 64MB chunks } SYSTEM_MEMORY_MAP_ELEMENT; typedef struct SystemMemoryMapHob { // // Total Clusters. In SNC2 mode there are 2 clusters and SNC4 mode has 4 clusters. // All2All/Hex/Quad/Hemi modes can be considered as having only one cluster (i.e SNC1). // UINT8 TotalClusters; UINT32 lowMemBase; // Mem base in 64MB units for below 4GB mem. UINT32 lowMemSize; // Mem size in 64MB units for below 4GB mem. UINT32 highMemBase; // Mem base in 64MB units for above 4GB mem. UINT32 highMemSize; // Mem size in 64MB units for above 4GB mem. UINT32 memSize; // Total physical memory size UINT16 memFreq; // Mem Frequency UINT16 HbmFreq; // HBM Frequency in MHz. UINT8 memMode; // 0 - Independent, 1 - Lockstep UINT8 VolMemMode; // 0 - 1LM, 1 - 2LM UINT16 DramType; UINT8 DdrVoltage; UINT8 XMPProfilesSup; UINT8 XMPCapability; // // HBM Specific Info. // UINT16 HbmInstances[MAX_SOCKET]; // Total HBM instances UINT32 HbmFlatMemSize; // Total HBM memory size in 64MB units, if HBM used as Flat memory UINT32 HbmCacheMemSize; // Total HBM memory used as cache, if HBM used as Cache memory UINT16 HbmSpeed; // Configured HBM (i.e OPIO channel) speed in MT/s. UINT16 MaxHbmSpeed; // Max HBM (i.e OPIO channel) speed in MT/s. UINT8 SystemRasType; UINT8 RasModesEnabled; // RAS modes that are enabled UINT16 ExRasModesEnabled; // Extended RAS modes that are enabled UINT8 sncEnabled; // 0 - SNC disabled for this configuration, 1 - SNC enabled for this configuration UINT8 NumOfCluster; UINT8 NumChPerMC; UINT8 numberEntries; // Number of Memory Map Elements SYSTEM_MEMORY_MAP_ELEMENT Element[(MAX_SOCKET * MAX_DRAM_CLUSTERS * MAX_SAD_RULES) + MAX_FPGA_REMOTE_SAD_RULES]; UINT8 reserved1[FSP_RESERVED1_LEN]; // struct memSetup MemSetup; UINT8 reserved2[FSP_RESERVED2_LEN]; // MEM_DFXMEMVARS DfxMemVar; MEMMAP_SOCKET Socket[MAX_SOCKET]; UINT8 reserved3[FSP_RESERVED3_LEN]; // struct memTiming profileMemTime[XMP_MAX_PROFILES]; UINT8 reserved4[FSP_RESERVED4_LEN]; // RASMEMORYINFO RasMeminfo; UINT32 DdrCacheSize[MAX_SOCKET][MAX_CH]; // Size of DDR memory reserved for 2LM cache (64MB granularity) UINT16 BiosFisVersion; // Firmware Interface Specification version currently supported by BIOS UINT32 MmiohBase; // MMIOH base in 64MB granularity UINT8 MaxSadRules; // Maximum SAD entries supported by silicon (16 for 10nm silicon) UINT8 NumberofChaDramClusters; // Number of CHA DRAM decoder clusters BOOLEAN VirtualNumaEnable; // Enable or Disable Virtual NUMA UINT8 VirtualNumaNodes; // Number of virtual NUMA nodes per physical NUMA node (non-zero) BOOLEAN MrDimmMemFreqRangeEn; // MRDIMM Memory Frequency range enabled. } SYSTEM_MEMORY_MAP_HOB; #pragma pack() #endif // _MEMORY_MAP_DATA_H_