Admin 命令集详解：Identify、Create I/O Completion Queue、Create I/O Submission Queue、Get Log Page
Admin 命令集是 NVMe 协议的“控制面板”。你用它的频率可能没读写高，但一旦出问题，排查起来最头疼。我个人习惯是把这四个核心命令吃透，再去做互操作测试——底子打牢了，后面跑用例才不会懵。
知识点脑图
3.1 Identify 命令
Identify 是你拿到一个 NVMe 设备后，第一个要发的命令。它返回控制器的能力、命名空间信息、特性支持等。说白了，就是设备的“身份证”。
我记得有一次在做兼容性测试时，某款 SSD 对 Identify 的 CNS（Controller or Namespace Structure）字段处理有 bug。你发 CNS=0x00 取控制器数据，它能正常返回；但换成 CNS=0x02 取所有活动命名空间列表，它直接返回全零。嗯，这种问题不跑一遍根本不知道。
| 字段 | 值 | 含义 |
|---|---|---|
| OPC | 0x06 | Identify 命令的操作码 |
| CNS | 0x00 ~ 0x1F | 指定返回的数据结构类型 |
| 数据缓冲区 | 4096 字节对齐 | PRP1 / PRP2 指向缓冲区 |
使用经验：我个人习惯先发 CNS=0x00 拿到控制器基本信息，再发 CNS=0x02 枚举所有命名空间。如果第二步失败，不一定是硬件问题——有些老固件对 CNS 0x02 支持并不完整，这时候降级到逐个发 CNS=0x01 遍历命名空间，往往能绕过。
3.2 Create I/O Submission Queue
Create I/O SQ 命令用来创建一条 I/O 提交队列。NVMe 协议允许你创建多达 65535 个 SQ，但实际中你一般只需要几个就够用。
这个命令的关键参数是 QID（Queue ID）和 QSIZE（队列深度）。它还需要关联一个完成队列——这就是下面要讲的 Create I/O CQ。
// 伪代码：构造 Create I/O SQ 命令
cmd.opc = 0x01; // Create I/O Submission Queue
cmd.cdw10 = (qid & 0xFFFF) | ((qsize - 1) << 16);
cmd.cdw11 = (pc_flag << 0) | (cqid << 16); // 关联的 CQ ID
// PRP1 指向 SQ 的内存基址
cmd.prp1 = sq_phys_addr;避坑指南：我曾经遇到过因为 QID 重复导致创建失败的情况。你要注意 QID 不能为 0（0 是 Admin SQ），而且不能和已存在的 SQ 冲突。另外，队列深度要减 1 再写入 CDW10 的高 16 位——这是协议规范里容易漏掉的地方。
3.3 Create I/O Completion Queue
Create I/O CQ 和 Create I/O SQ 是成对出现的。一个 I/O CQ 可以对应多个 I/O SQ，但每个 SQ 只能关联一个 CQ。创建 CQ 时，你指定中断向量和中断使能位。
我记得有一次我在移植驱动时，忘记将 CQ 的物理地址按页对齐，结果硬件一直超时。后来查协议才知道，Completion Queue 的基址必须 4KB 对齐。你想想看，这种低级错误排查起来多费时间。
| 命令 | OPC | 关键参数 | 返回 |
|---|---|---|---|
| Create I/O CQ | 0x05 | QID、QSIZE、IV、IEN | 完成状态 |
| Create I/O SQ | 0x01 | QID、QSIZE、CQID | 完成状态 |
3.4 Get Log Page
Get Log Page 命令用于获取日志信息。比如错误日志、健康信息、固件槽位信息等。它在调试和监控中非常重要。
这个命令需要指定 LID（Log Page Identifier）以及偏移量。数据量可能很大（例如 Error Information Log 支持 64 条记录），所以你需要循环读取。
// 读取 Error Information Log 第 0 条
cmd.opc = 0x02; // Get Log Page
cmd.cdw10 = (0x01 << 0) | (0 << 8); // LID=0x01, NUMD=0
cmd.cdw11 = 0; // 偏移低 32 位
cmd.cdw12 = 0; // 偏移高 32 位
// 数据缓冲区 4096 字节，PRP1 指向它互操作测试要点：不同厂商对 Get Log Page 的 NUMD（Number of Dwords）字段处理方式不同。有的要求严格按协议用 0-based 值，有的则直接写实际 Dword 数。我建议你的测试用例覆盖 NUMD=0 和 NUMD=实际大小减 1 两种场景。
3.5 命令执行流程与注意事项
上面四个命令的执行流程是类似的：Host 将命令写入 Admin Submission Queue，然后写 Doorbell 通知控制器。控制器处理完毕，将完成项写入 Admin Completion Queue，再发送中断（如果用中断的话）。
这里有个容易忽略的点：创建 I/O SQ 和 I/O CQ 的顺序。必须先创建 CQ，再创建 SQ。因为创建 SQ 时需要指定关联的 CQ ID，如果 CQ 还没创建，控制器会报错。
- Identify：数据量大（4KB），注意 PRP 对齐。
- Create I/O SQ：QID 非零，QSIZE-1 写入 CDW10。
- Create I/O CQ：物理地址 4KB 对齐，中断向量有效。
- Get Log Page：循环读取时注意偏移计算，NUMD 字段是 0-based。
我的小技巧：在测试脚本里，每发一个 Admin 命令，都检查一下 Completion Queue 的状态字段。如果返回 Generic Command Status 之外的值，立刻打印出来。这样能快速定位互操作问题——以前我在做 SSD 兼容性测试时，靠这个抓到了好几个固件对 PRP 边界处理不合理的 bug。
好了，Admin 命令集的核心四个命令就这些。能把这四个命令的每一个 bit 都理解透，NVMe 控制器的交互你就掌握了一半。剩下的就是多跑测试，多用不同的队列深度和中断配置去压一压——嗯，实践出真知。