3. NVMe命令集：Admin Command Set与NVM Command Set、关键命令详解
好，咱们今天聊聊NVMe的命令集。说实话，这是整个协议里最核心的部分。你想想看，CPU和SSD之间怎么沟通？就是靠这些命令。NVMe把命令分成了两大类：管理命令集（Admin Command Set）和NVM命令集（NVM Command Set）。
我刚开始接触NVMe时，总觉得命令多、记不住。后来发现，其实真正常用的就那么几个。咱们今天就把它们掰开揉碎了讲清楚。
3.1 两大命令集：Admin与NVM
Admin命令集，顾名思义，是用来“管理”的。比如：查询设备信息、创建删除队列、设置特性等等。这些命令走的是Admin Submission Queue和Admin Completion Queue。每个NVMe控制器必须支持Admin命令集。
NVM命令集，是用来“干活”的。比如：读数据、写数据、数据管理（Trim）等等。这些命令走的是I/O Submission Queue和I/O Completion Queue。这才是真正跑业务的通道。
我个人的习惯是，把Admin命令集看作是“控制面”，NVM命令集看作是“数据面”。这样理解起来就清晰多了。
核心区别：
- Admin命令集：管理控制器、队列、命名空间
- NVM命令集：读写数据、管理数据
3.2 关键命令详解：Identify
Identify命令，说白了就是“你是谁？你有什么本事？” 这是NVMe设备上电后，主机第一个要发的命令。我当年调试一个国产SSD时，就是靠Identify命令发现它报告了一个奇怪的版本号，才定位到固件bug。
Identify命令通过CNS（Controller or Namespace Structure）字段来区分你要查什么：
| CNS值 | 描述 |
|---|---|
| 0x00 | Identify Namespace（指定命名空间） |
| 0x01 | Identify Controller（控制器信息） |
| 0x02 | List Active Namespaces（列出所有活跃命名空间） |
| 0x03 | List Namespace IDs（列出所有命名空间ID） |
返回的数据结构是4096字节。Controller信息里包含了：支持的LBA格式、最大队列深度、电源状态、特性支持等等。Namespace信息里包含了：容量、块大小、保护信息等。
避坑指南： 我曾经遇到过一块盘，Identify返回的LBA格式列表里，第一个格式的块大小是512字节，但实际写数据时发现它只支持4K对齐。后来查了协议才知道，有些盘会隐藏一些格式，需要你主动去枚举。所以，拿到Identify数据后，别只看第一个格式，把所有格式都遍历一遍。
3.3 关键命令详解：Create IO SQ/CQ
NVMe的性能优势之一，就是支持多个I/O队列。但队列不是天上掉下来的，得靠Admin命令去创建。这就是Create I/O Submission Queue和Create I/O Completion Queue。
创建顺序有讲究：必须先创建CQ，再创建SQ。为什么？因为SQ完成时，需要往CQ里放完成条目。如果CQ还没创建，SQ往哪儿放？
创建命令的参数包括：
- 队列ID（QID）：从1开始，0是Admin队列
- 队列大小（QSIZE）：必须是2的幂次方
- 中断向量（IV）：用于MSI-X中断绑定
- 中断使能（IEN）：是否允许中断
- 物理连续（PC）：队列是否物理连续
我建议你在创建队列时，把队列大小设成和你的业务深度匹配。比如你的应用一次只发32个I/O，那队列大小设64就够了，没必要设1024。浪费内存不说，还增加管理开销。
注意： 创建队列时，SQ和CQ的QID必须一一对应。比如SQ 1只能对应CQ 1。但多个SQ可以对应同一个CQ，这叫“多对一”模式，适合某些特殊场景。
3.4 关键命令详解：Read/Write
终于到了最核心的读写命令。NVM命令集里的Read和Write，是NVMe协议里最常用的命令，没有之一。
命令格式如下（简化版）：
struct nvme_rw_command {
uint8_t opcode; // 0x02 for Read, 0x01 for Write
uint8_t flags;
uint16_t command_id;
uint64_t nsid; // 命名空间ID
uint64_t slba; // 起始LBA
uint16_t nlb; // 传输的LBA数量（实际值 = nlb + 1）
// ... 其他字段
};这里有个坑：nlb字段表示的是“传输的LBA数量减1”。也就是说，如果你要读1个LBA，nlb填0；读2个LBA，nlb填1。我见过不止一个新手在这里栽跟头，读出来的数据不对，查了半天发现是nlb填错了。
读写命令的PRP（Physical Region Page）或SGL（Scatter Gather List）用来描述数据在内存中的位置。PRP是NVMe早期用的，SGL是后来引入的，更灵活。我个人更推荐用SGL，尤其是做大数据块传输时，SGL可以避免PRP的页对齐限制。
性能要点：
- 尽量使用大块传输（比如256KB以上），减少命令数量
- 确保数据缓冲区是4K对齐的，避免额外的拷贝
- 合理利用队列深度，不要一次发太多命令把队列塞满
3.5 知识体系结构图
下面这张图，是我自己总结的NVMe命令集知识体系。你看一眼，就能明白今天讲的内容在整个协议中的位置。
3.6 实战经验总结
说了这么多，我最后分享几个实战中的小经验：
- 调试时先发Identify：不管遇到什么问题，先发Identify命令看看设备返回了什么。很多问题一眼就能看出来。
- 队列数量不是越多越好：我见过有人创建了64个队列，结果每个队列深度只有2。这样反而性能更差。队列数量和深度要平衡。
- 读写命令的PRP/SGL要小心：内存地址必须物理连续，或者用SGL描述多个不连续段。我曾经因为PRP列表没对齐，导致DMA传输错误，查了整整两天。
- 善用Completion Queue的Phase Tag：这个位用来区分新旧完成条目，是轮询模式下的关键。别偷懒，每次都要检查。
我的建议： 刚开始学NVMe协议时，别急着看所有命令。先把Identify、Create IO SQ/CQ、Read/Write这4个命令吃透。它们覆盖了90%以上的日常开发场景。剩下的命令，用到时再查协议文档，完全来得及。
嗯，今天的内容就到这儿。NVMe命令集其实不复杂，关键是理解设计思路：Admin管控制，NVM管数据。把这个分清楚，后面学起来就顺了。
可可精品资料库