NVMe Read Recovery Level：讀取復原、作用範圍與設定

先把「復原」放回讀取流程

01.02.主機送出讀取後，控制器需要從媒體取得正確資料。當資料不容易讀出時，額外的復原工作會占用時間。RRL 讓主機選擇控制器要投入多少復原，而不是直接指定要讀哪個位置、回傳多少 bytes，或把媒體內容改成另一份資料。

數字描述的是復原量的順序

01.03.規格定義 0～15 共 16 個可能的等級，數字往上走，復原量往下走。0 是最多復原，4 是一般程度且為預設，15 是最少復原。中間等級的差距不是固定比例：不能把 8 解讀成 4 的兩倍速度，也不能把等級當作重試次數。

先確認有功能，再談必備等級

01.04.RRL 本身不是每個控制器都必須具備的功能。一旦支援，subsystem 與所有控制器就必須支援 4、15，宣告能力與等級清單，並支援 FID 12h。0、1～3、5～14 是選用等級；表上列有這些數字，不代表手上的裝置全部能選。

FID

Feature Identifier；指定要讀取或設定哪一項 Feature 的編號。

Fast Fail 沒有定義一個毫秒數

01.05.Fast Fail 指最少的復原量。這兩節沒有替它指定 1 ms、10 ms 等上限，也沒有規定完全不做復原。它調整的是讀取困難時的處理策略；正常讀取可能根本用不到較深入的復原，因此不能承諾每筆 Read 都會變快。

不要替 LR 發明優先順序

01.06.I/O 命令中的 Limited Retry（LR）也是與復原有關的控制資訊，但 §8.1.23 明確把 LR 與 RRL 的互動留給實作。即使已選 Level 15，又送出帶 LR 的命令，仍不能由本規格推導成「一定零次重試」或「LR 一定蓋過 RRL」。兩者的共同效果需要對應實作資訊。

先分清 namespace 與 NVM Set

02.04.namespace 是主機存取的邏輯儲存空間；NVM Set 則是可包含一個或多個 namespace 的儲存集合。具有已格式化儲存空間的 namespace 完整位於一個 NVM Set 內，不橫跨多個 Set。RRL 是集合的屬性，所以要沿 namespace 的歸屬往上找，才知道它共用誰的設定。

共享設定不代表共享每一個欄位

02.05.例子裡 A、B 可以是不同大小、不同用途的 namespace，但兩者在同一個 Set，因此共用 RRL。這個關係只說明讀取復原策略的範圍，不表示 A 的資料會被複製到 B，或兩者的每一項設定都完全相同。

新增 namespace 也沿用 Set 的等級

02.06.假設 Set 7 已經設為 15，之後又在其中建立 namespace D，D 繼承的是 Set 7 的 RRL。不能因為 D 是新建的，就推論它一定單獨回到預設 4；預設等級與目前 Set 正在使用的等級是不同概念。

沒有 NVM Sets 時，不能靠編號隔離影響

02.07.若裝置不支援 NVM Sets，所有 namespace 使用 subsystem 的同一個 RRL。此時 FID 12h 不用 NVMSETID 選範圍；送入 7 並不會創造 Set 7。主機依 NVM Set 共通規則把 NVMSETID 填 0，控制器在本 Feature 忽略該欄。

變更策略與變更資料分開理解

02.08.從 4 改到 15 不會清除、格式化或重寫 namespace 中的資料。它可能改變後續遇到困難的讀取如何處理，不能當作修復既有資料的命令。主機也不能透過本 Feature 指定只改某一個 LBA 的策略。

先確認整體支援

03.02.在 Identify Controller 資料結構 bytes 99:96 的 CTRATT 內，bit 3 是 RRLVLS。它為 1 才表示控制器支援 RRL；bit 2 的 NSETS 則是另一件事，說明有沒有 NVM Sets。RRLVLS=1、NSETS=0 是可以理解的組合：功能存在，但設定由整個 subsystem 共用。

bitmap 中，每一個 bit 都是一個答案

03.03.RRLS 位於 bytes 101:100。要判斷等級 n 是否支援，計算 (RRLS >> n) & 1；結果 1 表示支援，0 表示不支援。範例 8011h 的 bit 8 是 0，因此即使 8 在 0～15 範圍內，也不能當成可選值。這個檢查與欄位放不放得下 8 是兩回事。

想選的等級	檢查 RRLS=8011h 的哪個 bit	送進 RRL 的值
0	bit 0 = 1，支援	0h
4	bit 4 = 1，支援	4h
8	bit 8 = 0，不支援	不選此值
15	bit 15 = 1，支援	Fh

不要把 bitmap 與 RRL 欄位互換

03.04.RRLS 用 16 個 bits 同時列出可用集合；設定命令的 RRL 只用 4 個 bits 放一個等級。選 15 時，RRLS 中應檢查的是 bit 15，也就是遮罩 8000h；實際送進 RRL 的卻是 Fh，不能把 8000h 塞進該欄。

再確認查詢與保存的擴充能力

03.05.ONCS 位於 bytes 521:520，其中 bit 4 是 SSFS。若為 0，不使用非零 SEL 或 SV，仍可以用 SEL=0 讀目前值。若為 1，可用 SEL=3 查本 Feature 是否可變更、是否可保存；這裡回的是另一組能力 bits，並不是 RRLS 支援等級清單。

先選 Feature，再解讀後面的參數

04.04.CDW10 bits 7:0 的 FID=12h 選本篇功能；bit 31 的 SV 控制是否提出保存要求。先用 SV=0 理解目前值的修改，得到 CDW10=00000012h。是否需要保存、是否支援保存，以及重設後如何處理，會在後面的生命週期單元分開說明。

NVMSETID 不是 namespace 編號

04.05.CDW11 bits 15:0 是 16-bit NVM Set Identifier，高 16 bits 保留。已支援 NVM Sets 時要填既有 Set 的識別碼，0 是保留值，不是「全部 Set」。本篇例子用已知有效的 7；不把 namespace A 的 NSID 放到此欄。命令本身的 NSID 則依共通規則填 0，非零會被中止。

RRL 是一個 4-bit 代碼

04.06.CDW12 bits 3:0 直接保存等級，bits 31:4 保留。15 的十六進位是 Fh，所以整個 CDW12 是 0000000Fh。這不是數量減 1 的欄位，選 Level 15 就填 15；填 14 會選到另一個等級。送出前先確認 RRLS 的對應 bit 為 1。

只有參數，沒有另外一包設定資料

04.07.本 Feature 的屬性就在 CDW11、CDW12，不需要另外準備一份 data buffer。Set 的 DPTR 在此沒有用途，Get 的 DPTR 也會被忽略。其餘沒有供本 Feature 使用的命令專用欄位屬保留區；示例將保留位清 0，不自行塞入額外控制資訊。

DPTR

Data Pointer；命令中的資料指標，本 Feature 不用它傳遞設定。

看懂索引與位移，才能讀欄位圖

04.08.Dword 是 4 bytes；命令的 CDW11 表示從 0 起算的第 11 個 Dword，起點是 byte offset 44，CDW12 起點則是 48。NVMSETID=7 是識別值，並不是 byte offset 7。命令欄位位置、欄位中的 Set 編號、欄位中的等級，各有不同用途。

byte offset

相對資料結構起點、以 byte 計算的距離；和項目索引或識別值不同。

offset

offset；從指定起點算出的位移。它回答「離起點多遠」，不等於 index。

Dword

Dword（Double word）；32 bits，也就是 4 bytes。對比 word=16 bits；例如 zero-based dword count=3 代表 4 個 Dwords，也就是 16 bytes。

讀目前值，沿用相同的目標 Set

05.03.Get Features 的 CDW10 bits 10:8 是 SEL，bits 7:0 是 FID。查目前值用 SEL=0，因此 CDW10=00000012h；查 Set 7 仍用 CDW11=00000007h、NSID=0。Set 命令放新等級的 CDW12，不是 Get 命令拿來要求回傳等級的位置；Get 的未使用命令專用欄位保留。

成功完成之後，從回覆而非命令抽出等級

05.04.確認 Get 命令成功，再讀完成項目的 DW0，取 bits 3:0 就得到 RRL。若 DW0=0000000Fh，讀回的是 Level 15。Figure 485 雖然以 Command Dword 12 為標題，§5.2.30.1.12 另明確指定：Get 成功且 SEL≠3 時，同一個格式放到 CQE DW0。

有支援時，再比較目前、預設與已保存

05.05.SSFS=1 時，SEL=1 查 default，SEL=2 查 saved，SEL=3 查 supported capabilities；4～7 保留。預設 RRL 為 4，但目前值可以是 15。若功能不可保存，或還沒有已保存值，SEL=2 依 Get 共通規則回預設；不能只因查到 4，就說主機曾把 4 保存過。

能力回覆要換一種欄位解讀

05.06.SEL=3 的 DW0 bit 2 是 CHANG，bit 1 是 NSSPEC，bit 0 是 SVBL，bits 31:3 保留。NSSPEC=1 才表示 namespace 範圍；為 0 時，這個 bit 不會告訴你其他範圍是哪一種。本篇應再看 NSETS 與 FID 12h 的定義，判定為 NVM Set 或 NVM subsystem，不能自行推成只影響一個控制器。

用同一個例子串起三種查詢

05.07.假設 SSFS=1，先用 CDW10=00000312h 查能力；能力允許後設定 Set 7。接著用 00000012h 查 current，預期讀回要求的 15；若改用 00000112h 查 default，回答的仍是 4。這三次是在問能力、目前值與預設值，不是控制器自相矛盾。

current

目前值；控制器現在使用的 Feature 設定。

「送出設定」與「設定成功」中間還有處理時間

06.03.主機把 Set Features 提交到佇列，只代表控制器可以開始處理它。不能在此刻就宣稱新的 RRL 已適用於之後所有命令；規格用成功完成作為後續提交命令的保證界線。設定失敗時，也不能把要求值當作有效的 current。

已在途的讀取沒有統一的新舊保證

06.04.Read A 若在 Set 成功前就已提交，設定變更時它可能仍在執行。共通規則允許它套用或不套用新設定。教材中的時間圖因此把 A 標為不保證採新值，而不是擅自指定它一定用舊值。

需要清楚分界時，主機可先整理提交順序

06.05.先暫緩新的讀取，等已提交命令完成，再送 Set，等成功後才提交下一批。這樣做的目的，是讓每一批使用哪個 RRL 可被明確說明；不是說 RRL 會改寫舊資料。完成設定後，也宜重新確認與該 Feature 有關的能力及狀態。

共用 Set 時，還要協調其他主機

06.06.RRL 不屬於單一控制器私有的設定。多個主機若同時管理同一 Set 或 subsystem，一個主機剛讀回 15，另一個主機仍可能隨後改成 4。Base 要求這類共享 Feature 存取有某種主機間協調，但沒有指定協調協定；不能把一次讀回當成永遠鎖住該值。

先分開「目前值」與「已保存值」

07.03.current 是正在使用的設定，saved 是主機要求保存後留下的設定。SSFS 支援不代表每一項 Feature 都可保存，還要看該 FID 的 SVBL。只有本 Feature 可保存時，成功的 SV=1 設定才同時更新 current 與 saved；SV=0 的成功設定只更新 current。

不可保存，不等於斷電一定遺失

07.04.Figure 466 的 FID 12h 列為 Yes，註腳 2 說明這個持續性欄只用在不可保存時。因此不可保存的 RRL 目前值仍必須跨 power cycle 與 reset 保留。SV=0 的意義是沒有提出保存要求，不能直接翻成「這個設定斷電就沒了」。

power cycle

斷電再供電的電源循環，與單純重設某個控制器分開。

Feature 能力與原值	這次事件的判斷條件	之後的 current
不可保存；current=15	Power cycle 或 reset：FID12h 具持續性	15
可保存；current=15、saved=4	Figure126 的全體範圍重設	4：取 saved
可保存；current=15、沒有 saved	Figure126 的全體範圍重設	4：取 default
可保存；current=15、saved=4	Figure127 的局部範圍重設；Set／subsystem scope	15：維持目前值

可保存時，看這次重設覆蓋的範圍

07.05.Figure 126 適用於只有單一控制器的 subsystem 發生 Controller Level Reset，或多控制器且無多 domain 的 NVM Subsystem Reset，或確實重設全部 domain 的 NVM Subsystem Reset。可保存的 Feature 在這些情況用 saved 恢復 current；沒有 saved 時用 default，本篇為 4。

domain

subsystem 內的劃分單位；此處只用來判斷一次重設是否涵蓋整個 subsystem。

局部重設不應重設仍被其他控制器共用的值

07.06.Figure 127 適用於可支援多控制器的 subsystem 發生 Controller Level Reset，以及多 domain 的 NVM Subsystem Reset 未覆蓋整個 subsystem 的情況。對 NVM Set／NVM subsystem 範圍而言，表中結果是維持不變，除非另有規定。要用這張表，先確認配置與實際重設範圍，不能只看事件名稱裡有 Reset。

把保存要求寫成具體數值

07.07.若已確認 SSFS=1、SVBL=1，Set 的 CDW10 加上 bit 31，得到 80000012h；NVMSETID 與 RRL 仍各放 CDW11、CDW12。若 Feature 不可保存卻送 SV=1，控制器必須以 Feature Identifier Not Saveable 中止，不能把該失敗當成已成功修改 current。

讀能力、讀保存值、讀目前值各有用途

07.08.SVBL 告訴你能不能要求保存，SEL=2 告訴你保存查詢回什麼，SEL=0 才告訴你現在用什麼。判斷一次重設的結果時，把裝置能力、重設覆蓋範圍及前後值列在一起，才不會把 Figure 466 的一個 Yes 解讀成所有情境都永遠使用最後一次要求值。