2. Linux FrameBuffer 驱动架构：fbmem.c、fb_ops 结构体、注册与注销流程

FrameBuffer 驱动在 Linux 内核中并非一个孤立的字符设备，而是通过一套统一的框架来管理所有显示设备。这套框架的核心是 fbmem.c 文件，它作为 FrameBuffer 子系统的主控模块，向上提供统一的文件操作接口，向下通过 fb_ops 结构体与具体的硬件驱动交互。理解这一架构是编写高效、无残影的 FrameBuffer 驱动的第一步。

2.1 架构总览：fbmem.c 的角色

fbmem.c 位于 drivers/video/fbdev/core/ 目录下，是 FrameBuffer 子系统的核心调度器。它负责完成以下关键任务：

• 主设备号注册：向内核注册主设备号 29，并创建 /dev/fbX 系列设备节点。
• 统一文件操作接口：实现 open、release、read、write、mmap、ioctl 等标准接口，用户空间程序无需关心底层硬件差异。
• 驱动注册表管理：维护一个全局的 registered_fb 数组，用于管理所有已注册的 FrameBuffer 驱动实例。
• 事件通知：在驱动注册、注销或显示参数变更时，通过 fb_notifier_call_chain 通知其他内核模块（如控制台、DRM 兼容层）。

2.2 struct fb_info：驱动的核心数据结构

每个 FrameBuffer 驱动实例在内核中由一个 struct fb_info 结构体表示。这个结构体是驱动与 fbmem.c 之间的“契约”，包含了所有必要的描述信息。其关键成员如下：

2.3 struct fb_ops：硬件操作函数集

struct fb_ops 是驱动开发者需要实现的核心接口。fbmem.c 在收到用户空间的请求后，会调用这些回调函数来执行实际的硬件操作。以下是必须实现和常用的回调函数：

2.4 注册与注销流程

驱动模块的加载和卸载对应着 FrameBuffer 设备的注册与注销。流程必须严格遵循内核框架的规范，否则会导致系统崩溃或资源泄漏。

2.4.1 注册流程

1. 分配 fb_info：使用 framebuffer_alloc() 分配一个 struct fb_info 实例，并传入私有数据大小。
2. 填充固定信息：设置 fb_fix_screeninfo，包括 id（设备名）、smem_start（物理地址）、smem_len（长度）、line_length（行字节数）。
3. 填充可变信息：设置 fb_var_screeninfo 的默认值，如 xres、yres、bits_per_pixel。
4. 注册 fb_ops：将实现好的 struct fb_ops 赋值给 info->fbops。
5. 硬件初始化：在 info->par 中初始化硬件寄存器、分配 DMA 缓冲区、设置时钟等。
6. 注册设备：调用 register_framebuffer(struct fb_info *) 将设备注册到 fbmem.c 子系统。

// 注册流程伪代码示例
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;
    // ... 初始化 par 中的硬件上下文 ...

    // 2. 填充固定信息
    strcpy(info->fix.id, "my_fb");
    info->fix.smem_start = dma_alloc_coherent(...); // 分配显存
    info->fix.smem_len = SZ_4M;
    info->fix.line_length = 1024 * 4; // 假设 1024x768 32bpp

    // 3. 填充可变信息
    info->var.xres = 1024;
    info->var.yres = 768;
    info->var.bits_per_pixel = 32;

    // 4. 注册操作函数
    info->fbops = &myfb_ops;

    // 5. 硬件初始化
    myfb_hw_init(par);

    // 6. 注册到内核
    if (register_framebuffer(info) < 0) {
        dma_free_coherent(...);
        framebuffer_release(info);
        return -EINVAL;
    }

    platform_set_drvdata(pdev, info);
    return 0;
}

2.4.2 注销流程

1. 注销设备：调用 unregister_framebuffer(struct fb_info *)，fbmem.c 会移除设备节点并通知其他模块。
2. 硬件去初始化：关闭显示控制器时钟、禁用 DMA、释放中断。
3. 释放显存：如果显存是动态分配的，使用 dma_free_coherent 释放。
4. 释放 fb_info：调用 framebuffer_release() 释放结构体内存。

// 注销流程伪代码示例
static int myfb_remove(struct platform_device *pdev)
{
    struct fb_info *info = platform_get_drvdata(pdev);
    struct myfb_par *par = info->par;

    // 1. 注销设备
    unregister_framebuffer(info);

    // 2. 硬件去初始化
    myfb_hw_deinit(par);

    // 3. 释放显存
    dma_free_coherent(info->device, info->fix.smem_len,
                      (void *)info->screen_base, info->fix.smem_start);

    // 4. 释放 fb_info
    framebuffer_release(info);
    return 0;
}

2.5 关键数据结构关系总结

为了帮助理解，下表总结了 fbmem.c、fb_info、fb_ops 三者之间的协作关系：