SCSI驱动与 UFS 驱动交互概况
SCSI子系统概况
SCSI（Small Computer System Interface）子系统是 Linux 中的一个模块化框架，用于提供与存储设备的通用接口。通过 SCSI 子系统，可以支持不同类型的存储协议（如 UFS、SATA、SAS），使操作系统能够通过相同的命令集与这些设备交互。
驱动的分工
- UFS 驱动：负责与 UFS 主控直接交互，包括初始化、配置和电源管理。UFS 驱动会解析设备树（DTS）中的信息，启动并配置硬件，使其进入工作状态。
- SCSI 子系统：提供一个上层的抽象层，将对存储设备的访问抽象为标准 SCSI 命令（如读、写、格式化）。应用程序和文件系统通过 SCSI 子系统向存储设备发出 I/O 请求，而 SCSI 子系统负责将请求传递给对应的驱动。
初始化阶段
UFS 驱动注册到SCSI系统
- UFS驱动会等待调用，调用的话他就是接收或者发送通用SCSI的命令，处理这些操作就需要一个主机，所以首先scsi_host_alloc 会分配一个主机适配器scsi host。 代码在**/** drivers / scsi / hosts.c
- scsi_add_host 注册主机适配器，使得SCSI 子系统得知有一个新的 SCSI 主机适配器（即 UFS 设备）已经上线并准备接受命令。
设备扫描和初始化
- 代码在drivers / scsi / scsi_scan.c
- 一旦确认设备在线，SCSI 子系统会为每个检测到的 UFS 存储设备分配一个
struct scsi_device结构体。这一结构体包含设备的基本信息和状态，使系统可以通过这个结构体与 UFS 设备进行读写操作。 - 发现到 UFS 设备后，SCSI 子系统会为其分配 SCSI 设备结构（
struct scsi_device），并准备好用于与操作系统和文件系统交互，抽象成操作系统或文件系统能够交互的设备。
void scsi_scan_host(struct Scsi_Host *shost)
{
struct async_scan_data *data;
if (strncmp(scsi_scan_type, "none", 4) == 0 ||
strncmp(scsi_scan_type, "manual", 6) == 0)
return;
if (scsi_autopm_get_host(shost) < 0)
return;
data = scsi_prep_async_scan(shost);
if (!data) {
do_scsi_scan_host(shost);
scsi_autopm_put_host(shost);
return;
}
/* register with the async subsystem so wait_for_device_probe()
* will flush this work
*/
async_schedule(do_scan_async, data);
/* scsi_autopm_put_host(shost) is called in scsi_finish_async_scan() */
}
EXPORT_SYMBOL(scsi_scan_host);
文件IO的处理流程
系统发起读写请求时，SCSI子系统和UFS 驱动协同合作，将请求传递到UFS 设备。
- 请求创建：系统通过读写命令的系统调用来调用虚拟文件系统，虚拟文件进一步调用具体的文件系统例如F2FS, F2FS的读写操作进一步传达到SCSI 子系统，SCSI最终调用 UFS子系统，所以请求在SCSI这块生成SCSI命令描述块。
请求处理：SCSI 子系统封装命令描述块为SCSI命令，并调用ufshcd_queuecommand函数
static int ufshcd_queuecommand(struct Scsi_Host *host, struct scsi_cmnd *cmd)
{
// 获取 UFS 主控（Host Bus Adapter, HBA）的私有数据
struct ufs_hba *hba = shost_priv(host);
// 从 SCSI 命令提取请求的 tag，用于定位 UFS 请求块（LUN/队列标识）
int tag = scsi_cmd_to_rq(cmd)->tag;
struct ufshcd_lrb *lrbp;
int err = 0;
struct ufs_hw_queue *hwq = NULL;
// 检查 UFS 主控当前的状态
switch (hba->ufshcd_state) {
case UFSHCD_STATE_OPERATIONAL:
// 如果 UFS 处于正常操作状态，则继续处理命令
break;
case UFSHCD_STATE_EH_SCHEDULED_NON_FATAL:
/*
* SCSI 错误处理程序可能在 UFS 错误处理中调用此命令队列函数。
* 当错误处理中状态从 RESET 转到 EH_SCHEDULED_NON_FATAL 时，防止
* 在此情况下发出新的请求。
*/
if (ufshcd_eh_in_progress(hba)) {
err = SCSI_MLQUEUE_HOST_BUSY; // 主机忙碌，暂时无法处理命令
goto out;
}
break;
case UFSHCD_STATE_EH_SCHEDULED_FATAL:
/*
* 在错误处理准备阶段会调用 pm_runtime_get_sync()。
* 若从 HBA 的电源管理操作发送 SCSI 命令（如 SSU 命令），
* 如果 UFS 状态不佳而允许命令通过，可能导致超时阻塞。
* 因此直接返回错误，以便错误处理程序恢复 PM 错误。
*/
if (hba->pm_op_in_progress) {
hba->force_reset = true;
set_host_byte(cmd, DID_BAD_TARGET); // 设置命令目标状态为 BAD
scsi_done(cmd); // 完成命令
goto out;
}
fallthrough; // 继续往下执行到 RESET
case UFSHCD_STATE_RESET:
err = SCSI_MLQUEUE_HOST_BUSY; // 主机忙碌
goto out;
case UFSHCD_STATE_ERROR:
set_host_byte(cmd, DID_ERROR); // 设置错误状态
scsi_done(cmd); // 结束命令
goto out;
}
// 重置请求的中止计数
hba->req_abort_count = 0;
// 保持 UFS 资源
ufshcd_hold(hba);
// 初始化逻辑请求块（Logical Request Block, LRB）信息
lrbp = &hba->lrb[tag];
lrbp->cmd = cmd; // 设置 SCSI 命令
lrbp->task_tag = tag; // 任务标识
lrbp->lun = ufshcd_scsi_to_upiu_lun(cmd->device->lun); // 逻辑单元号转换
lrbp->intr_cmd = !ufshcd_is_intr_aggr_allowed(hba); // 检查是否允许中断聚合
// 准备加密信息
ufshcd_prepare_lrbp_crypto(scsi_cmd_to_rq(cmd), lrbp);
// 标记该请求不跳过中止
lrbp->req_abort_skip = false;
// 构建 SCSI UPIU（UFS 协议单元）数据包
ufshcd_comp_scsi_upiu(hba, lrbp);
// 映射 Scatter-Gather 列表，准备传输数据
err = ufshcd_map_sg(hba, lrbp);
if (err) {
// 如果映射失败，释放 UFS 资源并退出
ufshcd_release(hba);
goto out;
}
// 如果启用了多队列 (MCQ)，则将请求映射到硬件队列
if (is_mcq_enabled(hba))
hwq = ufshcd_mcq_req_to_hwq(hba, scsi_cmd_to_rq(cmd));
// 发送 UFS 命令，执行传输
ufshcd_send_command(hba, tag, hwq);
out:
// 如果需要触发错误处理程序，进行调度
if (ufs_trigger_eh(hba)) {
unsigned long flags;
// 锁定主机的自旋锁以安全调度错误处理程序
spin_lock_irqsave(hba->host->host_lock, flags);
ufshcd_schedule_eh_work(hba); // 调度错误处理工作
spin_unlock_irqrestore(hba->host->host_lock, flags);
}
// 返回错误代码（如果有）
return err;
}
主控与UFS驱动的交互
- 传入的SCSI 命令会写入到 UFS 主控寄存器中。
- 存储命令后进一步执行命令，与存储介质通信，执行具体的读写操作。
- **状态反馈：**操作完成时，UFS 主控会通过中断或者状态寄存器通知UFS操作结果。
数据返回和错误处理
数据返回：如果命令执行成功，数据会通过UFS 主控返回 ufs驱动，驱动则将数据放到缓冲区，通知SCSI 子系统完成。
**错误处理：**设备没有空闲空间，UFS 报告错误状态，SCSI子系统重新执行或终止请求。
SCSI 子系统传递到上层
其中的过程应该是 块设备—>文件系统—>**应用程序，**类似U型锁一样往复从底层到上层。
详细文件构造过程
用户空间：open()** 系统调用**
在用户空间，应用程序调用 open("filename", O_CREAT | O_RDWR, 0644)。这里的 O_CREAT 标志告诉系统要创建文件。此调用通过 glibc 传递到内核，进入 VFS 层处理。
VFS 层：调用 open() 方法
VFS 层解析路径，并在目标目录中检查文件是否存在：
- 如果文件不存在，则调用文件系统特定的
create方法（如 EXT4 文件系统的ext4_create）来创建文件。 - 如果文件系统支持 journaling（如 EXT4），会在
journal中记录创建文件的元数据操作。
- 文件系统驱动层：更新元数据
具体文件系统驱动（如 EXT4）负责管理和更新文件元数据，包括文件的 inode、目录项等：
- 分配 inode：调用
inode分配函数分配一个新的 inode。 - 更新目录项：在父目录的目录表中添加一个新的条目，指向新创建的文件 inode。
- 提交元数据更新：如果文件系统使用 journaling，则会将元数据变更提交到 journal 中，并在适当时写入磁盘。
块层：分配并写入数据块
文件系统驱动调用块层，将分配给文件的 inode 及数据块标记为已使用。然后数据写入请求被传递到块层，由块设备驱动负责分配块并将数据写入存储设备。
SCSI 子系统：封装请求并调度
块层的请求被传递到 SCSI 子系统。在这里，块 I/O 请求会被封装为 SCSI 命令。SCSI 子系统负责：
- 命令封装：将 I/O 请求转换成合适的 SCSI 命令，如
WRITE。 - 命令调度：根据 I/O 调度算法（如 CFQ、Deadline 等）安排命令的执行顺序。
- 错误处理：如果命令执行失败，SCSI 子系统可以重试请求或返回错误。
UFS 驱动**：处理 SCSI 命令
SCSI 子系统将封装好的 SCSI 命令传递给 UFS 驱动层。UFS 驱动会执行以下步骤：
- 解析命令：UFS 驱动解析 SCSI 命令，将其转换为 UFS 协议（UPIU）命令。
- 发送命令：UFS 驱动将 UPIU 命令通过寄存器写入 UFS 主控（Host Controller），启动数据传输。
- 等待传输完成：UFS 主控完成操作后会通过中断通知 UFS 驱动。
- 状态返回：UFS 驱动解析状态并将结果返回给 SCSI 子系统。
UFS 存储设备：执行写入操作
最终，UFS 主控接收并处理 UPIU 命令，UFS 存储设备执行数据写入操作，并返回状态信息（成功或错误），将结果返回给 UFS 驱动。
返回结果
- UFS 驱动将操作结果返回给 SCSI 子系统。
- SCSI 子系统通知块层请求已完成，或者进行错误重试。
- 块层通知文件系统写入成功，文件系统驱动层更新状态。
- VFS 层完成文件创建过程，将成功结果返回给用户空间应用。
小结
我们再回顾一下创建文件的整体流程吧，从用户态到硬件层起始并没有我们想象的哪么简单，需要涉及到用户端—>系统调用（open or write）—>文件系统（vfs)—>实际文件系统（f2fs_open or f2fs_write）—>块设备处理-封装IO请求（封装 IO）—>SCSI—> UFS ,真的再一次感受代码改变世界。
