豫豫言文档API ATLAS
入口包说明.html
62 模块1862 名称
← 全部模块

模块 / 20

块设备。豫

块设备。豫

45公开名称

设备配置读

公开
化「整数」而「整数」

文言:块设备之驱:现代 Virtio 块设备,用户态驱动,供文件系统用之。汉语:Virtio 块设备的用户态驱动(现代协议,单队列大小 8、一次一个请求、512 字节扇区)。执行器的线性内存会迁入动态块,设备只能经内核授予的静态窗口(用户空间静态区,设备地址 = 静态偏移 + 0x1000)做 DMA,所以队列、请求头、状态与数据缓冲都放在静态窗口内的固定偏移,用户态只经内核服务“搬入静态/搬出静态”存取。宿主提供设备配置读、设备寄存器读写、搬入静态、搬出静态五个导入。 文言:宿主之导入。汉语:宿主提供的设备访问导入(与内核服务一一对应)。

设备寄存器读

公开
化「整数」而「整数」

暂无说明。

设备寄存器写

公开
化「整数」而化「整数」而「整数」

暂无说明。

搬入静态

公开
化「整数」而化「整数」而「整数」

暂无说明。

搬出静态

公开
化「整数」而化「整数」而「整数」

暂无说明。

静_描述

公开
「整数」

文言:静态窗内之 DMA 区与暂存。汉语:静态窗口内的 DMA 区(静态偏移;设备地址再加 设备偏)与线性内存里的驱动状态格、暂存。窗参数 = 静态偏移 | (长度 << 20)。

静_可用

公开
「整数」

汉语:描述符表 8 项 × 16 B

静_已用

公开
「整数」

汉语:可用环:标志、索引、8 项环

静_头

公开
「整数」

汉语:已用环:标志、索引、8 项 × 8 B

静_状态

公开
「整数」

汉语:请求头 16 B,紧随其后的一字节是状态

静_数据

公开
「整数」

暂无说明。

静_区长

公开
「整数」

汉语:512 字节数据缓冲

设备偏

公开
「整数」

暂无说明。

状态_块态

公开
「整数」

暂无说明。

状态_块容量

公开
「整数」

汉语:0 未试 1 就绪 2 失败

状态_块只读

公开
「整数」

汉语:扇区数(高位非零时饱和)

状态_块通知

公开
「整数」

暂无说明。

状态_块序

公开
「整数」

汉语:通知寄存器字(宽 2 | 偏移)

块头暂存

公开
「整数」

汉语:已发布的可用索引(十六位)

块描暂存

公开
「整数」

汉语:请求头 16 B + 状态 1 B

块用暂存

公开
「整数」

汉语:描述符 3 项 48 B

块杂暂存

公开
「整数」

汉语:已用环副本 72 B

块初暂存

公开
「整数」

汉语:环项与索引

寄存写成

公开
化「整数」而化「整数」而「爻」

汉语:初始化时的 512 字节影像 文言:寄存与窗之小助。汉语:小助手:寄存器写成功、窗搬运成功。

窗参数

公开
化「整数」而化「整数」而「整数」

暂无说明。

搬入成

公开
化「整数」而化「整数」而化「整数」而「爻」

暂无说明。

搬出成

公开
化「整数」而化「整数」而化「整数」而「爻」

暂无说明。

通知能力有效

公开
化「整数」而化「整数」而「爻」

文言:能力链之察:有界遍历 PCI 能力链,核通知窗与设备配置窗。汉语:检查 PCI 能力链:有界遍历,要求见到通知能力(cfg_type 2,偏移 0x3000,倍数 4)与设备配置能力(cfg_type 4,偏移 0x2000)。

设备能力有效

公开
化「整数」而化「整数」而「爻」

暂无说明。

能力链

公开
化「整数」而化「整数」而化「爻」而化「爻」而「爻」

暂无说明。

读容量

公开
化「整数」而「爻」

文言:容量之读:世次前后一致乃信。汉语:读容量:配置世次前后一致才采信,至多重试 0x400 次;容量为零视为失败。

块协商步

公开
化「整数」而化「整数」而「爻」

文言:初始化之步:逐步而行,任一步败则整体败。汉语:设备初始化,逐步执行,任一步失败即整体失败:复位、协商特性(要求 VERSION_1 与 FLUSH)、核对能力链、配置队列零、读容量、划定 DMA 区、置 DRIVER_OK。特性位存在第二参数里。

块就绪

公开
化「有」而「爻」

暂无说明。

块容量

公开
化「有」而「整数」

暂无说明。

可传输

公开
化「整数」而化「整数」而化「整数」而「爻」

文言:传输:读、写、刷新各一请求。汉语:块传输:操作 0 读、1 写、4 刷新。成功返回 0,设备报告错误返回其状态字节,拒绝或超时返回 -1。请求头、三项描述符先搬入静态窗,环项先写并经寄存器读作屏障,再推进可用索引并通知,最后轮询已用环。

传输请求头

公开
化「整数」而化「整数」而「爻」

暂无说明。

传输描述符

公开
化「整数」而「爻」

暂无说明。

传输写数据

公开
化「整数」而化「整数」而「爻」

暂无说明。

传输发布

公开
化「整数」而化「整数」而「爻」

暂无说明。

轮询已用

公开
化「整数」而化「整数」而「爻」

暂无说明。

传输收尾

公开
化「整数」而化「整数」而化「整数」而化「整数」而「整数」

暂无说明。

块传输

公开
化「整数」而化「整数」而化「整数」而「整数」

暂无说明。

块读

公开
化「整数」而化「整数」而「整数」

暂无说明。

块写

公开
化「整数」而化「整数」而「整数」

暂无说明。

块刷新

公开
化「有」而「整数」

暂无说明。