5.14 Get Log Page Command

5.14 Get Log Page command

“Get Log Page”命令返回一个数据缓冲区，其中包含请求的日志页。
Get Log Page命令使用Data Pointer，DWord10, DWord11, DWord12, DWord13, DWord14这几个字段。其他命令字段是保留的。
图191和图192中定义了强制和可选的日志标识符。如果Get Log Page命令指定了一个不支持的log id，controller 应该abort 该命令并返回状态Invalid Field in Command.
控制器表明支持标识控制器数据结构的日志页属性字段中的日志页偏移和扩展的数据字数，如果不支持扩展数据，则低位数据字数字段的位27:16指定要传输的数据字数。

Figure 185: Get Log Page – Data Pointer

Bits	Description
127:00	Data Pointer (DPTR): 此字段指定数据缓冲区的起始位置。该字段的定义见图105。

Figure 186: Get Log Page – Command Dword 10

Bits	Description
31:16	Number of Dwords Lower (NUMDL)：此字段指定要返回的dwords的低16位，如果Host指定的大小大于请求的日志页，则controller返回完整的日志页并对日志页末尾以外的dword返回未定义的结果。NUMDL和NUMDU的组合是 0’s based value.
15	Retain Asynchronous Event (RAE): 此位指定何时保留或清除异步事件。如果此位被清除为“0”，则在命令成功完成后将清除相应的异步事件。如果此位设置为“1”，则在命令成功完成后，将保留（即不清除）相应的异步事件。对于未与异步事件一起使用的日志页，主机软件应将此位清除为“0”。请参阅第5.2节。
14:12	Reserved
11:08	Log Specific Field (LSP): 如果未为“Log Page Identifier”字段指定的日志定义，则保留此字段。
07:00	Log Page Identifier (LID): 此字段指定要检索的日志页的标识符。

Figure 187: Get Log Page – Command Dword 11

Bits	Description
31:16	Log Specific Identifier: 此字段指定特定日志页所需的标识符。需要特定于日志的标识符的日志页如Figure 1所示。
15:00	Number of Dwords (NUMDU): 此字段指定要返回的dwords的高16位.

Figure 1

Log Page	Definition
Endurance Group Information	Endurance Group Identifier (refer to section 8.17)
Predictable Latency Per NVM Set	NVM Set Identifier (refer to section 4.9)

Figure 188: Get Log Page – Command Dword 12

Bits	Description
31:00	Log Page Offset Lower (LPOL): 日志页偏移量指定日志页中开始返回数据的位置。此字段指定日志页偏移量的低32位。偏移量应为双字对齐，由清除到00b的位1:0表示。控制器不需要检查位1:0是否被清除到00b。如果位1:0没有被清除到00b，则控制器可能报告命令中无效字段的错误。如果控制器没有报告命令中无效字段的错误，则控制器应像位1:0被清除到00b一样操作。如果主机指定的偏移量（即LPOL和LPOU）大于请求的日志页的大小（例如，从偏移量200开始请求包含100字节的日志页），则控制器应中止命令，状态为“Invalid Field in Command”。

Figure 189: Get Log Page – Command Dword 13

Bits	Description
31:00	Log Page Offset Upper (LPOU): 此字段指定日志页偏移量的高32位。请参阅LPOL定义。

如果控制器支持通过Get-Log-Page命令选择UUID（参见图191和第8.24节），则命令Dword 14用于指定UUID索引值（参见图190）

Figure 190: Get Log Page – Command Dword 14

Bits	Description
31:07	Reserved
06:00	UUID Index: Refer to Figure 498

Figure 498: UUID Index Field

Bits	Description
6:0	UUID Index: 如果该字段设置为非零值，则该字段的值是命令使用的UUID列表（参见图257）中UUID的索引。如果此字段被清除为0h，则不指定UUID索引。