📚 课程目录第4章 fb_ops操作集

4. fb_ops 操作集：帧缓冲设备的核心驱动接口

fb_ops 是帧缓冲设备驱动向 fbdev 核心层注册的操作函数集合，也是用户态通过 /dev/fbX 设备文件访问帧缓冲硬件的唯一桥梁。每个帧缓冲设备实例（fb_info）都必须绑定一个 fb_ops 结构体，其中定义了打开、关闭、读写、控制命令和内存映射等关键方法。

  核心认知： fb_ops 是驱动开发者需要实现的主要接口，其实现质量直接影响帧缓冲设备的性能、兼容性和稳定性。理解每个回调函数的语义与调用时机，是掌握 fbdev 框架的关键。

4.1 fb_ops 结构体定义与成员概览

fb_ops 定义在 include/linux/fb.h 中，包含文件操作、硬件控制、电源管理等多类回调。以下列出最核心的成员：

成员名称	函数原型	功能描述	调用时机
`fb_open`	`int (fb_open)(struct fb_info info, int user)`	设备文件打开时的初始化操作	`open("/dev/fb0")`
`fb_release`	`int (fb_release)(struct fb_info info, int user)`	设备文件关闭时的清理操作	`close(fd)`
`fb_read`	`ssize_t (fb_read)(struct fb_info info, char __user buf, size_t count, loff_t ppos)`	从帧缓冲内存读取数据到用户空间	`read(fd, buf, count)`
`fb_write`	`ssize_t (fb_write)(struct fb_info info, const char __user buf, size_t count, loff_t ppos)`	从用户空间写入数据到帧缓冲内存	`write(fd, buf, count)`
`fb_ioctl`	`int (fb_ioctl)(struct fb_info info, unsigned int cmd, unsigned long arg)`	处理设备控制命令（获取/设置可变参数、固定参数、伪彩色等）	`ioctl(fd, cmd, arg)`
`fb_mmap`	`int (fb_mmap)(struct fb_info info, struct vm_area_struct *vma)`	将帧缓冲物理内存映射到用户进程地址空间	`mmap(NULL, length, PROT_READ\|PROT_WRITE, MAP_SHARED, fd, 0)`

注意： 内核 4.x 之后，fb_ops 中新增了 fb_defio 相关回调用于延迟 I/O 优化，但上述 6 个回调仍然是所有帧缓冲驱动必须实现或继承的基础操作集。

4.2 fb_open 与 fb_release：设备生命周期管理

fb_open 在用户进程调用 open("/dev/fbX") 时被触发，fb_release 在 close(fd) 或进程退出时被调用。这两个回调负责管理帧缓冲设备的引用计数、硬件加电/断电、以及独占资源的获取与释放。

// 典型的 fb_open 实现模式
static int myfb_open(struct fb_info *info, int user)
{
    struct myfb_par *par = info->par;

    if (user) {
        // 用户态打开：增加引用计数，防止模块卸载
        if (!try_module_get(info->fbops->owner))
            return -ENODEV;
        atomic_inc(&par->open_count);
    }

    // 硬件初始化：如使能时钟、复位控制器、初始化 DMA
    myfb_hw_enable(par);

    return 0;
}

// 对应的 fb_release 实现
static int myfb_release(struct fb_info *info, int user)
{
    struct myfb_par *par = info->par;

    if (user) {
        atomic_dec(&par->open_count);
        module_put(info->fbops->owner);
    }

    // 当所有用户关闭时，可关闭硬件电源
    if (atomic_read(&par->open_count) == 0)
        myfb_hw_disable(par);

    return 0;
}

避坑指南： fb_open 中必须调用 try_module_get 防止驱动模块在设备打开时被卸载；fb_release 中必须对称调用 module_put。否则会导致内核模块引用计数泄漏或系统崩溃。

4.3 fb_read 与 fb_write：帧缓冲数据存取

fb_read 和 fb_write 实现了传统的文件读写语义，允许用户程序通过 read() 和 write() 系统调用直接访问帧缓冲内存。对于大多数图形应用而言，更高效的方式是使用 mmap 直接映射，但读写回调在调试、固件升级和简单帧操作中仍然重要。

// fb_read 的默认实现（fbdev 核心提供，驱动可覆盖）
ssize_t fb_read(struct fb_info *info, char __user *buf, size_t count, loff_t *ppos)
{
    unsigned long p = *ppos;
    void *src;

    // 检查偏移是否超出屏幕内存范围
    if (p >= info->screen_size)
        return 0;

    // 计算实际可读字节数
    if (count > info->screen_size - p)
        count = info->screen_size - p;

    src = info->screen_base + p;

    // 将帧缓冲数据拷贝到用户空间
    if (copy_to_user(buf, src, count))
        return -EFAULT;

    *ppos += count;
    return count;
}

// fb_write 的默认实现（对称逻辑）
ssize_t fb_write(struct fb_info *info, const char __user *buf, size_t count, loff_t *ppos)
{
    unsigned long p = *ppos;
    void *dst;

    if (p >= info->screen_size)
        return -ENOSPC;

    if (count > info->screen_size - p)
        count = info->screen_size - p;

    dst = info->screen_base + p;

    if (copy_from_user(dst, buf, count))
        return -EFAULT;

    *ppos += count;
    return count;
}

性能提示： 对于高分辨率显示（如 1920x1080@32bpp，每帧约 8MB），频繁使用 fb_write 会导致大量用户态/内核态数据拷贝。实际图形栈（如 libdrm、fbdev 的 fbtest）几乎总是优先使用 mmap 直接操作帧缓冲。

4.4 fb_ioctl：设备控制命令中枢

fb_ioctl 是帧缓冲设备最复杂的回调，负责解析并执行用户态传入的控制命令。标准命令定义在 include/uapi/linux/fb.h 中，主要包括：

命令宏	命令码	功能	数据结构
`FBIOGET_VSCREENINFO`	`0x4600`	获取当前可变显示参数（分辨率、位深、时序）	`struct fb_var_screeninfo`
`FBIOPUT_VSCREENINFO`	`0x4601`	设置可变显示参数（触发模式切换）	`struct fb_var_screeninfo`
`FBIOGET_FSCREENINFO`	`0x4602`	获取固定显示参数（显存地址、行长度、MMIO 基址）	`struct fb_fix_screeninfo`
`FBIOPAN_DISPLAY`	`0x4606`	设置显示起始偏移（实现硬件滚动/双缓冲切换）	`struct fb_var_screeninfo`
`FBIOBLANK`	`0x4611`	控制显示空白/取消空白（电源管理）	`int`
`FBIOGET_CON2FBMAP`	`0x460F`	获取控制台到帧缓冲的映射关系	`struct fb_con2fbmap`

// fb_ioctl 典型实现框架
static int myfb_ioctl(struct fb_info *info, unsigned int cmd, unsigned long arg)
{
    struct myfb_par *par = info->par;
    void __user *argp = (void __user *)arg;

    switch (cmd) {
    case FBIOGET_VSCREENINFO: {
        struct fb_var_screeninfo var;
        myfb_get_var(info, &var);  // 从硬件寄存器读取当前参数
        if (copy_to_user(argp, &var, sizeof(var)))
            return -EFAULT;
        return 0;
    }
    case FBIOPUT_VSCREENINFO: {
        struct fb_var_screeninfo var;
        if (copy_from_user(&var, argp, sizeof(var)))
            return -EFAULT;
        // 验证参数合法性（分辨率、时钟范围等）
        if (!myfb_validate_mode(&var))
            return -EINVAL;
        // 触发硬件模式切换
        return myfb_set_par(info, &var);
    }
    case FBIOBLANK: {
        int blank_mode;
        if (get_user(blank_mode, (int __user *)argp))
            return -EFAULT;
        return myfb_blank(blank_mode, info);
    }
    default:
        // 未知命令交给 fbdev 核心默认处理
        return -ENOTTY;
    }
}

安全注意： fb_ioctl 中所有从用户空间拷贝的数据都必须经过严格的合法性校验，特别是分辨率、时钟频率和内存偏移参数。错误的参数可能导致硬件锁死、显示异常甚至物理损坏。

4.5 fb_mmap：零拷贝内存映射

fb_mmap 是帧缓冲设备性能最高的数据通路。它允许用户进程通过 mmap() 系统调用将帧缓冲的物理内存（或已分配的 DMA 缓冲区）直接映射到进程的虚拟地址空间，实现零拷贝的像素数据访问。

// fb_mmap 典型实现
static int myfb_mmap(struct fb_info *info, struct vm_area_struct *vma)
{
    unsigned long start = vma->vm_start;
    unsigned long size = vma->vm_end - vma->vm_start;
    unsigned long offset = vma->vm_pgoff << PAGE_SHIFT;
    unsigned long pfn;

    // 检查映射范围是否超出帧缓冲大小
    if (offset + size > info->screen_size)
        return -EINVAL;

    // 计算物理页帧号（screen_base 是内核虚拟地址，需转换为物理地址）
    pfn = virt_to_phys(info->screen_base) >> PAGE_SHIFT;
    pfn += offset >> PAGE_SHIFT;

    // 设置 VMA 属性：禁止交换、禁止执行、IO 内存
    vma->vm_flags |= VM_IO | VM_DONTEXPAND | VM_DONTDUMP;
    vma->vm_page_prot = pgprot_writecombine(vma->vm_page_prot);

    // 建立页表映射
    if (io_remap_pfn_range(vma, start, pfn, size, vma->vm_page_prot))
        return -EAGAIN;

    return 0;
}

  关键区别： fb_read/fb_write 需要在内核空间和用户空间之间拷贝数据（copy_to_user/copy_from_user），而 fb_mmap 通过页表直接映射，用户程序写入映射区域等同于直接写入帧缓冲物理内存，延迟和吞吐量都远优于读写接口。

4.6 操作集注册与调用链路

驱动在 probe 函数中填充 fb_info 结构体的 fbops 字段，然后调用 register_framebuffer() 将设备注册到内核。当用户态发起文件操作时，fbdev 核心层的 fb_fops（定义在 drivers/video/fbdev/core/fbmem.c）会作为 VFS 的 file_operations 代理，根据操作类型调用 fb_ops 中对应的回调。

// 驱动 probe 中的注册模式
static int myfb_probe(struct platform_device *pdev)
{
    struct fb_info *info;
    struct myfb_par *par;

    // 1. 分配 fb_info 结构体
    info = framebuffer_alloc(sizeof(struct myfb_par), &pdev->dev);
    if (!info)
        return -ENOMEM;

    par = info->par;

    // 2. 填充固定/可变参数
    info->fix = myfb_fix;
    info->var = myfb_var;

    // 3. 绑定 fb_ops 操作集
    info->fbops = &myfb_ops;

    // 4. 分配帧缓冲内存（DMA/IO 内存）
    info->screen_base = dma_alloc_coherent(...);
    info->screen_size = MYFB_MEM_SIZE;

    // 5. 注册到 fbdev 核心
    if (register_framebuffer(info) < 0) {
        framebuffer_release(info);
        return -EINVAL;
    }

    platform_set_drvdata(pdev, info);
    return 0;
}

// fb_ops 结构体实例化
static struct fb_ops myfb_ops = {
    .owner          = THIS_MODULE,
    .fb_open        = myfb_open,
    .fb_release     = myfb_release,
    .fb_read        = fb_sys_read,    // 使用通用实现
    .fb_write       = fb_sys_write,   // 使用通用实现
    .fb_ioctl       = myfb_ioctl,
    .fb_mmap        = myfb_mmap,
    .fb_fillrect    = myfb_fillrect,  // 加速矩形填充
    .fb_copyarea    = myfb_copyarea,  // 加速区域拷贝
    .fb_imageblit   = myfb_imageblit, // 加速位块传输
};

加速回调： 除了上述 6 个基本操作，fb_ops 还包含 fb_fillrect、fb_copyarea、fb_imageblit 等图形加速回调。如果硬件支持 2D 加速（如 BitBLT 引擎），驱动应实现这些回调以提升图形性能；否则 fbdev 核心会使用软件模拟（cfb_fillrect、cfb_copyarea、cfb_imageblit）。

4.7 各回调的调用频率与性能敏感度

回调	调用频率	性能敏感度