5.2.25. NVDIMM 固件接口表 (NFIT)

5.2.25.1. 概述

此可选表提供的信息允许OSPM枚举平台中存在的 NVDIMM 并关联由 NVDIMM 创建的系统物理地址范围。 NVDIMM 由ACPI命名空间中单个NVDIMM根设备下的零个或多个NVDIMM设备表示。

OSPM 仅在系统初始化期间评估NFIT。运行时对NVDIMM状态的任何更改或有关热添加 NVDIMM 的信息均使用NVDIMM根设备的 _FIT 方法（请参阅第 6.5.9 节）进行通信。

NFIT 由以下结构组成：

1. 系统物理地址 (SPA) 范围结构（请参阅第 5.2.25.2 节） – 描述 NVDIMM 占用的 SPA 范围以及 SPA 范围的类型。

2. NVDIMM 区域映射结构（参见第 5.2.25.3 节）——描述 NVDIMM 区域到 SPA 范围和 NVDIMM 区域属性的映射。

3. 交错结构（参见第 5.2.25.4 节）——描述NVDIMM区域使用的各种交错选项。

4. SMBIOS 管理信息结构（请参阅第 5.2.25.5 节） – 描述热添加 NVDIMM 的 SMBIOS 表条目。

5.NVDIMM控制区域结构（参见第 5.2.25.6 节）——描述NVDIMM功能接口及其块控制窗口（如果适用）。

6. NVDIMM块数据窗口区域结构（参见第 5.2.25.7 节）——描述具有块控制窗口的NVDIMM功能接口的块数据窗口。

7. 刷新提示地址结构（参见第 5.2.25.8 节）——描述特殊的系统物理地址，这些地址在写入时有助于实现NVDIMM区域写入的持久性。

8. 平台能力结构（参见第 5.2.25.9 节）——描述平台能力，以告知OSPM平台范围的NVDIMM能力。

下图说明了上述结构以及它们如何相互关联。

图 5.9 NVDIMM 固件接口表 (NFIT) 概述

下表定义了NFIT。

5.2.25.2. 系统物理地址 (SPA) 范围结构

该结构体描述了NVDIMM占用的系统物理地址范围及其对应的Region Type。

被描述为虚拟CD或虚拟磁盘的系统物理地址范围应在E820中被描述为“AddressRangeReserved”，在UEFIGetMemoryMap 中被描述为EFI保留内存类型。

平台允许实现此结构只是为了描述描述虚拟CD和虚拟磁盘的系统物理地址范围。对于虚拟CD区域和虚拟磁盘区域（易失性和持久性），以下字段 - 邻近域、SPA范围结构索引、标志和地址范围内存映射属性不相关，应设置为 0。

NVDIMM控制区域的默认映射应为UC内存属性，E820中包含 AddressRangeReserved 类型，UEFIGetMemoryMap 中包含 EfiMemoryMappedIO 类型。 NVDIMM块数据窗口区域的默认映射应为WB内存属性，其中E820中的 AddressRangeReserved 类型和UEFIGetMemoryMap 中的 EfiMemoryMappedIO 类型。

以下 GUID 用于描述NVDIMM区域类型。可以生成附加 GUID 来描述附加地址范围类型。

持久内存 (PM) 区域：

{ 0x66F0D379、0xB4F3、0x4074、0xAC、0x43、0x0D、0x33、0x18、0xB7、0x8C、0xDB }

NVDIMM 控制区域：

{ 0x92F701F6, 0x13B4, 0x405D, 0x91, 0x0B, 0x29, 0x93, 0x67, 0xE8, 0x23, 0x4C }

NVDIMM 块数据窗口区域：

{0x91AF0530、0x5D86、0x470E、0xA6、0xB0、0x0A、0x2D、0xB9、0x40、0x82、0x49}

RAM 支持虚拟磁盘区域的磁盘 - 易失性（包含原始磁盘格式的易失性内存区域）：

{ 0x77AB535A,0x45FC,0x624B,0x55,0x60,0xF7,0xB2,0x81,0xD1,0xF9,0x6E }

RAM 支持虚拟 CD 区域 - 易失性（包含 ISO 映像的易失性内存区域）的磁盘：

{ 0x3D5ABD30,0x4175,0x87CE,0x6D,0x64,0xD2,0xAD,0xE5,0x23,0xC4,0xBB }

RAM 支持虚拟磁盘区域的磁盘 - 持久（包含原始磁盘格式的持久内存区域）：

{ 0x5CEA02C9,0x4D07,0x69D3,0x26,0x9F,0x44,0x96,0xFB,0xE0,0x96,0xF9 }

RAM 支持虚拟 CD 区域 - 持久的磁盘（包含 ISO 映像的持久内存区域）：

{ 0x08018188,0x42CD,0xBB48,0x10,0x0F,0x53,0x87,0xD5,0x3D,0xED,0x3D }

注意事项

ACPI、NFIT中使用的地址范围类型GUID值必须与描述相同RAM磁盘类型的RAM磁盘设备路径的“磁盘类型”GUID中的相应值相匹配。详情请参阅UEFI规格。

5.2.25.3. NVDIMM 区域映射结构

NVDIMM区域映射结构描述NVDIMM区域及其到SPA范围的映射（如果有）。

NVDIMM 州旗 | 2 | 44 | 44 位[0]设置为1表示先前对包含NVDIMM区域的NVDIMM的SAVE操作失败。位[0]设置为0表示前一个SAVE成功，或者不存在前一个SAVE。位 [1] 设置为 1 表示包含 NVDIMM 区域的 NVDIMM 的最后一个 RESTORE 操作失败。位[1]设置为0表示最后一个RESTORE成功或没有最后一个RESTORE。位 [2] 设置为 1 表示平台将数据刷新到前一个SAVE之前包含NVDIMM区域的NVDIMM失败。因此，即使Bit[0]和Bit[1]没有指示失败，恢复的数据内容也可能不一致。位[2]设置为0表示平台刷新成功，或者没有平台刷新。位 [3] 设置为 1 表示包含NVDIMM区域的NVDIMM无法接受持久写入。对于能源支持的 NVDIMM 设备，如果未配备或之前的 ERASE 操作未完成，则设置位 [3]。位 [3] 设置为 0 表示包含NVDIMM区域的NVDIMM已布防。位 [4] 设置为 1 表示包含NVDIMM区域的NVDIMM在OSPM切换之前观察到SMART和运行状况事件。位 [5] 设置为 1 表示平台固件已启用，可以使用NVDIMM设备通知值中指定的通知代码来通知OSPM、SMART以及与包含NVDIMM区域的NVDIMM相关的运行状况事件。位 [6] 设置为 1 表示平台固件未将包含NVDIMM区域的NVDIMM映射到SPA范围。这可能是由于各种问题造成的，例如设备初始化错误、设备错误、映射设备的硬件资源不足或设备已禁用。实现注意事项：如果发生设备错误，位 [4] 可能会与位 [6] 一起设置。位[7]至位[15]被保留。实施注意事项：平台固件可能会报告多个设置位。 保留 | 2 | 46 | 46保留

注意事项

交错结构索引=0，交错方式！=1 允许交错的PM范围，但未描述实际交错，而仅提供构成PM区域的物理内存设备（如SMBIOS类型 17 所描述）。通常，只有块区域需要交错结构，因为软件必须消除交错的影响。

5.2.25.4. 交错结构

DIMM/NVDIMM 中的内存可以跨内存通道、内存控制器和处理器插槽交错。该结构描述了给定地址范围的内存交错。由于交错是一种重复模式，因此该结构仅描述模式开始重复之前内存交错中涉及的行。

5.2.25.5. SMBIOS 管理信息结构

此结构使平台能够将启动时SMBIOS表提供的条目之外的附加SMBIOS条目传送到OS（例如，与热添加的 NVDIMM 相对应的类型 17 条目）。

5.2.25.6. NVDIMM 控制区域结构

系统应为NVDIMM中的每个功能接口包含一个NVDIMM控制区域结构。

保留 | 2 | 22 | 22保留 序列号 | 4 | 24 | NVDIMM的序列号，由模块供应商分配。该字段应设置为NVDIMM、SPD模块序列号字段的值，其中字节 0 设置为SPD字节 325，字节 1 设置为SPD字节 326，字节 2 设置为SPD字节 327，字节 3 设置为SPD字节328. 区域格式接口代码| 2 | 28 | 28 编程接口的标识符。该字段应设置为由NVDIMM控制区域结构表示的功能接口的NVDIMM、SPD功能接口描述符 b 的值，其中：字节 0 位 7:5 设置为 000b； b.字节 0 位 4:0 设置为功能接口字段（功能接口描述符位 4:0）； c.字节 1 位 7:5 设置为 000b；和d。字节 1 位 4:0 设置为功能类字段（功能接口描述符位 9:5）。 EXAMPLE - 0x8021 的函数接口描述符表示：实现了函数接口描述符； b.没有扩展功能参数块； c.功能类是字节可寻址的能量支持（0x01）；和d。函数接口是字节可寻址能量支持函数接口 1 (0x01)d，并映射到区域格式接口代码 0x0101。 块控制窗口数量| 2 | 30|块控制窗口的数量必须与相应的块数据窗口的数量相匹配。仅当块控制窗口的数量非零时，此字段后面的字段才有效。 块控制窗口的大小| 8 | 32 | 32以字节为单位 块控制窗口中的命令寄存器偏移量 | 8 | 40|以字节为单位。逻辑偏移。请参阅注释。后续块控制窗口的开始是通过添加块控制窗口的大小来计算的。 块控制窗口中命令寄存器的大小| 8 | 48 | 48以字节为单位 块控制窗口中的状态寄存器偏移量| 8 | 56 | 56以字节为单位的逻辑偏移量。参见注1。后续块控制窗口的开始是通过添加块控制窗口的大小来计算的。 块控制窗口中状态寄存器的大小| 8 | 64 | 64以字节为单位 NVDIMM 控制区域标志 | 2 | 72 | 72位 [0] 设置为 1 表示块数据 Windows 实现已缓冲。数据窗口的内容仅在状态寄存器指示时才有效。 保留 | 6 | 74 | 74保留

上表注释：

1. 请参阅“JEDEC¤ 标准编号 21-C_固态存储器的 JEDEC 配置_”，附件 L：“DDR4¤ SDRAM 模块的串行存在检测 (SPD)”、“DDR4¤ SPD 文档版本 2”。

2. 请参阅“JEDEC¤ 标准编号 21-C_固态存储器的 JEDEC 配置_”，附件 L：“DDR4¤ SDRAM 模块的串行存在检测 (SPD)”、“DDR4¤ SPD 文档版本 3”（即将发布）。

3. 在NVDIMM中，该模块包含一个非易失性存储器子系统控制器。

4. 请参阅JEDEC 标准编号 2233-22 B yte 可寻址能量支持接口， 版本 1.0（即将推出）。

注意事项

上述结构中的“逻辑偏移”是指从NVDIMM控制区域开始的偏移。逻辑偏移量是相对于设备的，而不是相对于系统物理地址空间的。软件应在应用块控制起始偏移之前构建设备地址空间（考虑交错）。

5.2.25.7. NVDIMM 块数据窗口区域结构

仅当块数据窗口的数量非零时才应提供该结构。

注意事项

上表中的逻辑偏移是指从NVDIMM数据窗口区域开始的偏移。逻辑偏移量是相对于设备的，而不是相对于系统物理地址空间的。软件应在应用块数据窗口起始偏移之前构建设备地址空间（考虑交错）。

5.2.25.8. 刷新提示地址结构

软件在写入NVDIMM区域后需要保证持久性（即保证写入已达到目标NVDIMM）。 Flush Hint 功能是特定于平台的，如果支持，平台会通过提供 Flush Hint 地址结构向OSPM公开此持久性机制。

对于给定的NVDIMM（由刷新提示地址结构中的NFIT设备句柄指示），软件可以写入这些刷新提示地址中的任何一个，以使任何先前对NVDIMM区域的写入从中间平台缓冲区刷新到目标NVDIMM（以实现持久性）。请注意，平台缓冲区不包括处理器缓存！处理器通常包含ISA，用于将数据从处理器缓存中清除。

5.2.25.9. 平台能力结构

该结构向OSPM告知NVDIMM平台功能。

5.2.25.10. NVDIMM 表示格式

如果软件或NVDIMM制造商在标签上显示、打印或以其他方式提供NVDIMM的标识符（例如，唯一标识NVDIMM），则应使用以下十六进制格式：

• 如果制造地点和制造日期字段有效：

  C language format string: "%02x%02x-%02x-%02x%02x-%02x%02x%02x%02x"
  

格式值：

1. 供应商ID字节0（包括奇偶校验位）

2. 供应商ID字节1

3. 制造地点字节

4.制造日期字节0（即年份）

5. 制造日期字节 1（即星期）

6. 序列号字节 0

7. 序列号字节 1

8. 序列号字节 2

9. 序列号字节 3

• 如果制造地点和制造日期字段无效：

  C language format string: "%02x%02x-%02x%02x%02x%02x"
  

格式值：

1. 供应商ID字节0（包括奇偶校验位）

2. 供应商ID 字节 1

3. 序列号字节 0

4. 序列号字节 1

5. 序列号字节 2

6. 序列号字节 3

此格式与SPD字节 320 到 328 从低到高的顺序匹配（即，在左侧显示最低或第一个字节）。