命名空间管理 - 🌟 SGL 描述符类型(Figure 114) (第143页)
NVME2.0协议解读 1 min read

命名空间管理 - 🌟 SGL 描述符类型(Figure 114) (第143页)

Blog Author

我们继续对 《NVM Express® Base Specification, revision 2.0b》第132页 进行详细的中文解析,特别关注 SGL 描述符类型SGL 描述符子类型 及其在 SGL 数据块描述符 中的应用。


🌟 SGL 描述符类型(Figure 114)

SGL 描述符类型

代码 描述符类型
0h SGL 数据块描述符(SGL Data Block descriptor)
1h SGL 比特桶描述符(SGL Bit Bucket descriptor)
2h SGL 段描述符(SGL Segment descriptor)
3h SGL 最后一个段描述符(SGL Last Segment descriptor)
4h 带键的 SGL 数据块描述符(Keyed SGL Data Block descriptor)
5h 传输 SGL 数据块描述符(Transport SGL Data Block descriptor)
6hEh 保留
Fh 厂商特定(Vendor specific)

说明:

  • SGL 数据块描述符0h)用于指定数据块的地址。
  • 比特桶描述符1h)用于指示无实际数据的区域。
  • SGL 段描述符2h)用于描述一个数据块或多个数据块的连续区域。
  • SGL 最后一个段描述符3h)标志该段为最后一个段。
  • 带键的 SGL 数据块描述符4h)用于传输数据块,并包含一个密钥,适用于需要身份验证的场景。
  • 传输 SGL 数据块描述符5h)用于描述通过 NVMe 传输机制传输的数据块。

🧩 SGL 描述符子类型(Figure 115)

SGL 描述符子类型值与应用场景

  • 0h:适用于 0h2h3h4h 类型描述符,地址字段指定数据块、段或最后一个段描述符的 起始内存地址
  • 1h:适用于 0h2h3h 类型描述符,地址字段包含一个 偏移量,指示数据传输的位置偏移。
  • 1h(对于 1h 类型描述符):该字段应清除为 0h,并且所有其他值保留为预留。
  • A到F(针对 所有类型):NVMe 传输特定,具体定义由相关传输协议部分提供。

说明:

  • 地址字段(Address) 用于描述数据块的起始位置,如果描述符的子类型是 1h,则该字段包含偏移量,而非绝对地址。
  • 控制器错误处理:如果 SGL 描述符包含无效的地址格式或其他不支持的类型,控制器将中止命令并返回错误。

🧳 SGL 数据块描述符(Figure 116)

SGL 数据块描述符格式

  • 地址(Address):指定数据块的 64 位内存字节地址。如果子类型字段为 1h,则地址字段包含从数据传输位置的起点的 偏移量
  • 长度(Length):指定数据块的 字节长度。如果长度字段为 0h,表示没有数据被传输,依然是有效的 SGL 数据块描述符。

内存对齐要求

  • 如果控制器要求 dword 对齐,那么地址和长度字段的 低两位必须清除为 00b
  • 如果未清除低两位,控制器将返回 Invalid Field in Command 错误。

数据长度限制

  • 长度字段的限制:如果 地址字段加上长度字段的值大于 1_00000000_00000000h,则该 SGL 数据块描述符会被认为有 无效数据长度,并报告相应的错误。

📋 控制器处理规则

  1. 无效描述符类型:如果 SGL 描述符类型或子类型无效(如类型不支持),控制器应报告错误并中止命令。
  2. 对齐与错误处理:如果控制器要求特定的内存对齐(例如 dword 对齐),但 地址或长度字段未按要求对齐,控制器会报告错误并中止该命令。

🧠 总结与关键点

项目 说明
SGL 描述符类型 包括数据块、比特桶、段描述符等,每种描述符用于不同的数据处理场景。
SGL 描述符子类型 通过子类型进一步定义地址字段是绝对地址还是偏移量,并提供额外的传输特定信息。
SGL 数据块描述符 用于描述数据块的内存地址和长度,支持灵活的内存对齐和数据传输控制。
内存对齐要求 控制器要求 dword 对齐 时,地址和长度字段的低两位必须清除为 00b,否则会报错。
数据长度限制 地址字段与长度字段的和不能超过最大值,否则会产生 无效数据长度 错误。

🧳 教学建议与优化

  • 内存对齐与性能:内存对齐对 NVMe 设备的性能有直接影响。主机和控制器应确保数据的地址字段与长度字段在内存中按照对齐要求进行设置。
  • SGL 子类型的正确使用:根据不同的数据类型选择合适的 SGL 描述符,避免在不支持的类型下进行操作,以免导致错误和性能下降。
  • 错误处理与调试:理解描述符类型、子类型和内存对齐的要求,有助于开发人员调试命令失败和错误报告,特别是在大型数据传输时。

如果你有兴趣深入探讨 SGL 描述符的实际应用如何在控制器中优化数据传输,我可以继续详细讲解。是否继续?