3. 帧缓冲(Framebuffer)驱动基础

帧缓冲（Framebuffer）是 Linux 显示子系统的核心抽象层，它为上层应用和图形栈提供统一的显存操作接口。本章深入剖析 Framebuffer 设备模型、核心操作结构体、内存映射机制以及设备的注册与注销流程，为后续显示性能优化奠定基础。

3.1 Framebuffer 设备模型

Linux 内核中的 Framebuffer 子系统采用标准的字符设备模型，通过 struct fb_info 结构体描述每一个帧缓冲设备。该结构体聚合了设备硬件信息、操作函数指针、内存管理参数以及底层驱动私有数据。

3.2 fb_ops 结构体详解

fb_ops 是驱动开发者必须实现的核心回调集合，它定义了 Framebuffer 设备的所有操作行为。下表列出最关键的成员函数及其用途：

3.3 Framebuffer 内存映射

帧缓冲驱动的核心性能优势在于允许用户空间通过 mmap 系统调用直接映射显存，避免数据在内核态与用户态之间的拷贝。映射流程涉及内核中的 fb_mmap 回调与 struct vm_area_struct 的精细控制。

3.3.1 映射流程

1. 用户调用 mmap： 应用程序通过 mmap(NULL, size, PROT_READ|PROT_WRITE, MAP_SHARED, fd, 0) 发起映射请求。
2. 内核 VFS 层： 根据文件描述符找到对应的 fb_info 实例，调用 fb_ops->fb_mmap。
3. 驱动实现： 驱动在 fb_mmap 中调用 remap_pfn_range 或 io_remap_pfn_range，将物理显存页帧号映射到用户进程的虚拟地址空间。
4. 缓存属性设置： 通过 pgprot_writecombine 或 pgprot_noncached 设置页表属性，保证显存访问的缓存一致性。

3.3.2 典型 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 pfn = info->fix.smem_start >> PAGE_SHIFT;

    /* 设置缓存属性：写合并模式，提升显示性能 */
    vma->vm_page_prot = pgprot_writecombine(vma->vm_page_prot);

    /* 将物理显存映射到用户空间 */
    if (remap_pfn_range(vma, start, pfn, size, vma->vm_page_prot))
        return -EAGAIN;

    return 0;
}

3.4 Framebuffer 注册与注销

Framebuffer 设备的生命周期管理由 register_framebuffer 和 unregister_framebuffer 两个核心函数控制。驱动必须在模块初始化/退出时正确调用它们。

3.4.1 注册流程

1. 分配 fb_info： 使用 framebuffer_alloc 分配并初始化 struct fb_info 实例。
2. 填充固定信息： 设置 fb_fix_screeninfo，包括显存起始地址、长度、行宽、类型等。
3. 填充可变信息： 设置 fb_var_screeninfo 的默认值，如分辨率、位深、像素格式。
4. 挂载 fb_ops： 将驱动实现的 fb_ops 结构体赋值给 fb_info->fbops。
5. 分配显存： 使用 dma_alloc_coherent 或 ioremap 分配/映射物理显存，赋值给 screen_base。
6. 注册设备： 调用 register_framebuffer(fb_info)，内核自动创建 /dev/fbX 设备节点。

3.4.2 注销流程

1. 注销设备： 调用 unregister_framebuffer(fb_info)，移除设备节点并通知上层。
2. 释放显存： 根据分配方式调用 dma_free_coherent 或 iounmap。
3. 释放 fb_info： 调用 framebuffer_release(fb_info) 释放内核对象。

3.4.3 注册与注销代码模板

static struct fb_info *myfb_info;

static int __init myfb_init(void)
{
    int ret;

    /* 1. 分配 fb_info */
    myfb_info = framebuffer_alloc(0, NULL);
    if (!myfb_info)
        return -ENOMEM;

    /* 2. 填充固定信息 */
    strcpy(myfb_info->fix.id, "myfb");
    myfb_info->fix.smem_start = dma_alloc_coherent(...);  /* 分配显存 */
    myfb_info->fix.smem_len = 800 * 480 * 4;              /* 800x480x32bpp */
    myfb_info->fix.line_length = 800 * 4;
    myfb_info->fix.type = FB_TYPE_PACKED_PIXELS;
    myfb_info->fix.visual = FB_VISUAL_TRUECOLOR;

    /* 3. 填充可变信息默认值 */
    myfb_info->var.xres = 800;
    myfb_info->var.yres = 480;
    myfb_info->var.bits_per_pixel = 32;
    myfb_info->var.red.offset = 16;
    myfb_info->var.green.offset = 8;
    myfb_info->var.blue.offset = 0;
    myfb_info->var.transp.offset = 24;

    /* 4. 挂载操作函数 */
    myfb_info->fbops = &myfb_ops;

    /* 5. 设置 screen_base */
    myfb_info->screen_base = (char __iomem *)phys_to_virt(myfb_info->fix.smem_start);

    /* 6. 注册设备 */
    ret = register_framebuffer(myfb_info);
    if (ret) {
        framebuffer_release(myfb_info);
        return ret;
    }

    return 0;
}

static void __exit myfb_exit(void)
{
    /* 1. 注销设备 */
    unregister_framebuffer(myfb_info);

    /* 2. 释放显存 */
    dma_free_coherent(...);

    /* 3. 释放 fb_info */
    framebuffer_release(myfb_info);
}

3.5 关键数据结构对比