4. NVMe Admin Command Set：Admin Command概述、Create I/O SQ/CQ命令、Identify命令、Get Log Page命令

各位同学，今天我们聊聊NVMe协议里最基础、也最核心的一块——Admin Command Set。说白了，这是主机和SSD之间“打招呼”和“建通道”的指令集。你想想看，一个NVMe盘插上去，系统怎么知道它是什么型号？支持哪些特性？队列怎么建？全靠这些Admin命令。

我个人习惯把Admin命令比作“控制面”，而I/O命令是“数据面”。控制面不搞定，数据面根本跑不起来。好，我们直接进入正题。

4.1 Admin Command 概述

Admin Command是所有NVMe命令的“老祖宗”。它通过Admin Submission Queue（Admin SQ）发送，通过Admin Completion Queue（Admin CQ）返回结果。每个NVMe控制器必须支持至少一对Admin SQ/CQ。

Admin命令的通用格式，我直接贴出来：

struct nvme_admin_command {
    uint8_t     opcode;      // 命令操作码
    uint8_t     flags;       // 标志位
    uint16_t    command_id;  // 命令ID，用于匹配完成
    uint32_t    nsid;        // 命名空间ID（Admin命令通常为0）
    uint64_t    metadata;    // 元数据指针
    uint64_t    prp1;        // 物理区域页1
    uint64_t    prp2;        // 物理区域页2
    uint32_t    cdw10;       // 命令专用DW10
    uint32_t    cdw11;       // 命令专用DW11
    // ... 后续还有cdw12~cdw15
};

嗯，这里要注意：opcode字段决定了命令类型。比如0x01是Create I/O SQ，0x05是Identify，0x02是Get Log Page。我在项目中遇到过有人把opcode写错，结果命令石沉大海，连错误状态都不返回——因为控制器根本不认识这个命令。

4.2 Create I/O SQ / CQ 命令

这个命令，说白了就是“建队列”。NVMe协议支持最多64K个I/O队列对（每个队列对包含一个SQ和一个CQ）。但实际数量受控制器能力限制。

Create I/O SQ（opcode=0x01）和Create I/O CQ（opcode=0x05）是成对出现的。我建议你先建CQ，再建SQ。为什么？因为SQ需要指定它对应的CQ ID，如果CQ还没建，SQ就找不到“汇报对象”。

来看一个Create I/O CQ的CDW10字段结构：

CDW10:
  Bit 31:16  -> QID (队列ID, 从1开始)
  Bit 15:0   -> QSIZE (队列深度, 最小2)
  
CDW11:
  Bit 0      -> PC (物理连续标志)
  Bit 1      -> IEN (中断使能)
  Bit 3:2    -> IV (中断向量)

我曾经在调试一个国产SSD时，发现队列建好但I/O就是提交不上去。查了半天，原来是QSIZE设成了1。NVMe规范要求队列深度至少为2，否则控制器直接返回无效参数。这个坑，大家一定要记住。

4.3 Identify 命令

Identify命令（opcode=0x06）是NVMe调试中最常用的命令，没有之一。它用来获取控制器、命名空间的各种信息。说白了，就是让SSD“自报家门”。

Identify命令通过CNS（Controller or Namespace Structure）字段来区分查询对象：

CNS值	含义	我常用的场景
0x00	Identify Namespace	查看命名空间大小、块大小
0x01	Identify Controller	查看固件版本、支持特性
0x02	List Active Namespaces	确认盘上有几个命名空间
0x03	List Namespace IDs	调试命名空间枚举问题

举个例子，我想看一块盘的固件版本：

// 伪代码：发送Identify Controller命令
cmd.opcode = 0x06;
cmd.cdw10 = 0x01;  // CNS=1, 查询控制器
cmd.nsid = 0;      // Admin命令nsid为0
// 数据返回在prp1指向的缓冲区中
// 偏移量0x7B处是固件版本字符串（8字节）

用nvme-cli更简单：nvme id-ctrl /dev/nvme0。输出里有个字段叫“oacs”，它告诉你控制器支持哪些可选Admin命令。比如bit 0表示支持Format NVM，bit 4表示支持Device Self-test。我在项目中遇到过一块盘声称支持某个特性，但实际执行时返回错误——后来发现是固件bug，oacs字段没更新。

4.4 Get Log Page 命令

Get Log Page命令（opcode=0x02）用来读取SSD的日志信息。这些日志就像飞机的“黑匣子”，记录了错误、温度、健康度等关键数据。

常用的Log Page类型：

• Error Information Log (LID=0x01)：记录最近的错误事件。我调试时第一个查的就是它。
• Health Information Log (LID=0x02)：包含温度、使用寿命、写入量等。做耐久性测试必看。
• Firmware Slot Information Log (LID=0x03)：查看固件槽位状态。
• Commands Supported and Effects Log (LID=0x05)：查看哪些命令被支持，以及它们的影响。

Get Log Page的CDW10结构：

CDW10:
  Bit 31:16  -> NUMD (返回的DWORD数-1)
  Bit 15:8   -> LID (Log Page ID)
  Bit 7:0    -> 保留

CDW11:
  Bit 31     -> LPOL (Log Page Offset Low)
  Bit 30:0   -> 保留

嗯，这里有个细节：NUMD字段是“返回的DWORD数减1”。比如你想读64字节，NUMD应该设为15（因为64字节=16个DWORD，16-1=15）。我刚开始做NVMe驱动时，在这里栽过跟头——设成64，结果控制器返回了260字节，缓冲区直接溢出。

我个人习惯在压力测试前后各抓一次Health Log，对比温度、写入量、磨损均衡计数等指标。有一次我发现一块盘在测试后“Percentage Used”字段从5%跳到了15%，赶紧联系厂商——原来是固件有写入放大的bug。

4.5 本章小结

Admin Command Set是NVMe协议的“控制中枢”。Create I/O SQ/CQ负责建队列，Identify负责查户口，Get Log Page负责看日志。这三个命令，你调试NVMe设备时几乎天天要用。

最后送大家一句话：调试NVMe，先查Identify，再看Log Page，最后建队列。顺序搞反了，你连问题出在哪都不知道。