NVMe Base 2.4：Device Self-test：執行、進度與結果

01 Device Self-test 的啟動與執行

01.01.Self-test 不是同步 diagnostic RPC。Host 先用 OACS.DSTS、DSTO.SDSO 與 EDSTT 決定支援、concurrency scope 與時間預期，再用 NSID 與 STC 建構 command。Admin CQE 回來時，背景 operation 才剛進入可由 LID 06h 觀察的生命週期。

OACS.DSTS

Optional Admin Command Support 的 Device Self-test Supported bit，判斷 command 是否可用。

LID 06h

Device Self-test Log Page 的 identifier 06h；同時包含 current operation 與 20 筆歷史結果。

Admin

Administrative，建立、設定、查詢或管理 controller 與 queue 的控制路徑。

EDSTT

Extended Device Self-test Time，在 power state 0 下的 extended test 名目完成分鐘數。

DSTO

Device Self-test Options，Identify Controller 中回報 refresh 與 concurrency 選項的欄位。

Host

主機；執行作業系統並送出 NVMe 命令的一端。

NSID

Namespace Identifier，controller 用來指向 namespace 的數值 handle；identifier 不等於 namespace 物件本身。

SDSO

Single Device Self-test Operation，選擇 subsystem-wide 單一 operation 或 per-controller operation 的 bit。

CQE

Completion Queue Entry，CQ 中的一筆完成結果資料結構。

LID

Log Page Identifier；指定要讀取哪一種 log page 的編號。

STC

Self-test Code 是 Device Self-test CDW10 的動作 nibble；result entry 的 STC 則是 Status Code，須依 SCVLD 判斷有效。

01.02.啟動 Device Self-test 前，先讀 Identify Controller：OACS.DSTS 判斷 command 是否支援；EDSTT 是 extended operation 在 power state 0 的名目分鐘數；DSTO.SDSO 決定同時只能有一個 subsystem-wide operation，或每個 controller 各一個。這三個欄位回答不同問題。

controller

controller，實作 NVMe 介面、取走 command 並回報 completion 的控制實體。

02 LID 06h 的目前進度與歷史結果

02.01.log header 的 DSTOS／DSTCS 回答『現在跑到哪裡』；RDS1～RDS20 回答『之前怎麼結束』。result entry 又分成 operation code、result reason、segment、validity bitmap 與 diagnostic payload。NVM Command Set 只在 FVLD=1 時賦予 FLBA 明確的 LBA 語意。

DSTCS

Device Self-test Completion Status，LID 06h 中的 0 到 100 完成百分比。

DSTOS

Device Self-test Operation Status，LID 06h 中表示目前 operation 類型的 nibble。

FLBA

Failing LBA，NVM Command Set 定義為造成 self-test failure 的其中一個 logical block address。

FVLD

Failing LBA Valid，決定 FLBA 欄位是否可解讀的 validity bit。

NVM

Non-Volatile Memory，斷電後仍能保存資料的記憶體。

02.02.讀取 LID 06h 所需的最小 Get Log Page slice 是：LID=06h、LSP=0、RAE 依事件策略選擇、NUMD 表示 564 bytes、LPOL/LPOU=0、OT=0、CSI=0、UIDX=0。564 bytes=141 dwords，因此 0's-based NUMD=140=008Ch；RAE=0 時 CDW10=008C0006h。

0's-based

0's-based encoding，以 0 表示實際數量 1；依欄位換算公式通常是欄位值加 1。

LPOL

Log Page Offset Lower，Get Log Page byte offset 的低 32 bits。

LPOU

Log Page Offset Upper，Get Log Page byte offset 的高 32 bits。

NUMD

Number of Dwords，0's-based transfer dword count；實際 bytes = (NUMD + 1) × 4。

UIDX

UUID Index，指向 UUID List 位置的 index；0 表示未指定 UUID。

CSI

I/O Command Set Identifier；選擇 I/O 命令集，NVM Command Set 使用 00h。

LSP

Log Specific Field，意義由所選 log page 定義的 command selector。

RAE

Retain Asynchronous Event，Get Log Page 是否保留相關 asynchronous event 的 selector。

DSTR

Device Self-test Result，結果 entry 中表示成功、abort 或 segment failure 的 nibble。

SEGN

Segment Number，只有 DSTR=7h 時指出第一個失敗 diagnostic segment。

POH

Power On Hours，self-test result 建立時累積的 power-on hours，不含指定 low-power 時間。