4. Admin Submission Queue与Completion Queue：Admin SQ/CQ的创建与管理、Admin命令提交流程
Admin队列，说白了就是主机和SSD控制器之间的「控制通道」。我刚开始接触NVMe协议时，总觉得Admin队列就是个普通的命令队列，后来踩了不少坑才明白——它其实是整个SSD的「大脑神经中枢」。没有它，你连读个设备信息都做不到。
4.1 Admin SQ/CQ的创建机制
Admin队列的创建，是NVMe设备初始化的第一步。你想想看，控制器上电后，主机怎么跟它说话？总得先有个「信箱」吧。这个信箱就是Admin Submission Queue和Admin Completion Queue。
创建过程其实不复杂，但细节很关键。我个人习惯把整个过程拆成三步：
- 主机分配内存：在主机内存中分配两块连续区域，分别给Admin SQ和Admin CQ用
- 配置寄存器：通过PCIe BAR空间的寄存器，告诉控制器队列的基地址和大小
- 使能控制器：设置CC.EN位为1，控制器开始工作
这里有个坑，我遇到过好几次——Admin队列必须是物理连续的。为什么？因为控制器访问主机内存用的是DMA，它可不懂虚拟地址。你给它一个不连续的物理地址，它直接就懵了。
关键寄存器一览：
- ASQ（Admin Submission Queue）：BAR0偏移0x1C，存放Admin SQ的物理基地址
- ACQ（Admin Completion Queue）：BAR0偏移0x28，存放Admin CQ的物理基地址
- AQA（Admin Queue Attributes）：BAR0偏移0x24，配置队列大小（条目数）
4.2 队列大小的玄机
Admin队列的大小，协议规定最小为2个条目，最大为4096个条目。但实际项目中，我建议你设成16或32就够了。
为什么？因为Admin命令本来就不多。你想想看，设备枚举、创建I/O队列、设置特性……这些操作都是偶尔才做一次。设太大反而浪费内存。我曾经在一个项目中看到有人设了1024个条目，结果内存碎片化严重，差点翻车。
我的经验：Admin队列大小设成16，基本够用。如果遇到队列满的情况，可以适当增大到32。别贪多，够用就行。
4.3 Admin命令提交流程
好，队列创建好了，怎么提交命令？流程其实很清晰，我画了个图帮你理解：
流程其实就六步，我帮你拆开讲：
- 主机写命令到SQ：把命令结构体写入Admin SQ的当前生产者位置
- 更新SQ门铃：写SQ Tail Doorbell寄存器，告诉控制器「有新命令了」
- 控制器DMA取命令：控制器看到门铃更新，从SQ中DMA读取命令
- 控制器执行命令：处理命令，比如获取日志、创建I/O队列等
- 控制器写完成项：把完成状态写入Admin CQ，更新CQ Head Pointer
- 触发中断：如果启用了中断，控制器发MSI-X中断通知主机
注意：门铃寄存器的写入顺序很重要。必须先写命令到SQ，再更新门铃。反过来操作的话，控制器可能读到不完整的命令，直接报错。我曾经见过一个团队因为这个bug排查了整整两天。
4.4 完成项的处理
完成项（Completion Queue Entry）是控制器给主机的「回执」。每个完成项16字节，包含命令状态、命令ID等信息。
主机怎么知道命令完成了？两种方式：
- 轮询（Polling）：主机不断检查CQ的Phase Tag位，看有没有新完成项
- 中断（Interrupt）：控制器写完成项后发中断，主机在中断处理函数中处理
我个人更推荐用中断方式。轮询虽然简单，但浪费CPU。你想想看，Admin命令本来就不频繁，让CPU一直轮询多不划算。
4.5 避坑指南
做Admin队列开发，有几个坑我帮你提前踩了：
常见问题：
- 队列对齐：Admin队列基地址必须4KB对齐。不对齐的话，控制器直接报错
- Phase Tag：完成项的Phase Tag位用来区分新旧完成项。每次CQ翻转时，Phase Tag也要翻转
- 命令超时：Admin命令一般几毫秒内完成。如果超过5秒还没完成，建议做超时处理
- 队列满：SQ满时不能再提交命令。我习惯在驱动层维护一个队列状态，满了就返回忙
嗯，这里要注意一点——Admin队列的创建是NVMe初始化的第一步。没有Admin队列，你连创建I/O队列都做不到。所以这部分代码一定要稳，容错要做好。
4.6 代码示例
最后，给你看一段创建Admin队列的伪代码。实际项目中会复杂一些，但核心逻辑就是这样：
// 1. 分配物理连续内存
void* sq_mem = alloc_phys_contiguous(16 * 64); // 16个条目，每个64字节
void* cq_mem = alloc_phys_contiguous(16 * 16); // 16个条目，每个16字节
// 2. 获取物理地址
uint64_t sq_phys = get_phys_addr(sq_mem);
uint64_t cq_phys = get_phys_addr(cq_mem);
// 3. 配置寄存器
write_reg(BAR0 + ASQ, sq_phys); // 设置SQ基地址
write_reg(BAR0 + ACQ, cq_phys); // 设置CQ基地址
write_reg(BAR0 + AQA, (15 << 16) | 15); // SQ和CQ各16个条目
// 4. 使能控制器
uint32_t cc = read_reg(BAR0 + CC);
cc |= (1 << 0); // 设置EN位
write_reg(BAR0 + CC, cc);
// 5. 等待控制器就绪
while (!(read_reg(BAR0 + CSTS) & (1 << 0))); // 等待RDY位这段代码看起来简单，但实际调试时可能会遇到各种问题。比如内存分配失败、物理地址不对齐、寄存器写入顺序错误……我建议你每步都加个检查，别偷懒。
调试技巧：如果控制器不响应，先检查CSTS.RDY位。如果一直不置位，八成是队列配置有问题。我一般会先读回ASQ和ACQ寄存器，确认写入的物理地址是否正确。
好了，Admin队列的创建和管理就讲到这里。这部分内容虽然基础，但非常重要。后面的I/O队列创建、命令提交，都是基于这个机制。搞懂了Admin队列，NVMe协议你就入门了一半。
公众号:蓝海资料掘金营，微信deep3321