2. Framebuffer 设备模型：核心结构与生命周期

Framebuffer 设备在 Linux 内核中通过一套统一的设备模型进行管理。其核心是 struct fb_info 结构体，它承载了帧缓冲设备的所有状态信息、操作函数指针以及底层硬件参数。理解该结构体及其配套的 fb_ops 操作集，是编写 Framebuffer 驱动的基石。本章将深入剖析这些核心数据结构，并详细阐述设备的注册与注销流程。

2.1 struct fb_info：帧缓冲设备的“身份证”

struct fb_info 是内核中表示一个帧缓冲设备的唯一结构体。每个 Framebuffer 设备实例都对应一个 fb_info 对象。它包含了设备从上层应用到底层硬件的所有必要信息。

核心地位： 在驱动开发中，fb_info 是驱动与内核 Framebuffer 核心层交互的桥梁。驱动的主要工作就是填充该结构体的各个字段，并将其注册到系统中。

下表列出了 struct fb_info 中最为关键的字段及其作用：

字段名 类型 描述
fbops struct fb_ops * 指向设备操作函数集的指针，驱动必须实现。
fb_var_screeninfo struct fb_var_screeninfo 可变屏幕信息，如分辨率、位深、时序等，可由用户态修改。
fb_fix_screeninfo struct fb_fix_screeninfo 固定屏幕信息，如帧缓冲物理地址、长度、行宽等，用户态只读。
screen_base char __iomem * 帧缓冲区的内核虚拟地址（I/O 映射后的地址）。
screen_size unsigned long 帧缓冲区的总大小（字节）。
device struct device * 指向底层硬件设备的指针，用于 DMA 和电源管理。
par void * 私有数据指针，驱动可在此存放自定义的硬件上下文。
state int 设备状态，如 FBINFO_STATE_RUNNING。
node int 设备节点号（如 /dev/fb0 中的 0）。
关键区分： fb_var_screeninfo 和 fb_fix_screeninfo 是用户态通过 ioctl 获取和设置屏幕参数的核心数据结构。驱动在 fb_ops.fb_check_var 和 fb_ops.fb_set_par 中负责验证和应用这些参数。

2.1.1 结构体关系图

下图展示了 fb_info 与内核其他组件以及用户空间的关系：

struct fb_info 核心关系图 struct fb_info 核心关系图 用户空间 (App) 系统调用 / ioctl struct fb_info fbops fb_var_screeninfo fb_fix_screeninfo screen_base / par struct fb_ops fb_open / fb_release fb_read / fb_write fb_mmap / fb_ioctl 硬件 (LCD/HDMI) DMA 控制器 / 显存 说明： 1. 用户空间通过 /dev/fbX 节点发起系统调用。 2. 内核核心层将调用转发至 fb_info 关联的 fb_ops 操作集。 3. fb_ops 中的函数最终操作底层硬件寄存器或 DMA 缓冲区。

2.2 fb_ops 操作集：驱动行为的“函数表”

struct fb_ops 定义了一组函数指针，是 Framebuffer 驱动必须实现的核心接口。内核 Framebuffer 核心层通过调用这些函数来与具体硬件交互。根据硬件的复杂程度，驱动可以选择实现其中的部分或全部函数。

以下是 fb_ops 中最重要的操作函数：

  • fb_open / fb_release：设备文件的打开和关闭回调，可用于初始化或清理硬件状态。
  • fb_read / fb_write：对帧缓冲区的直接读写操作，通常用于非 mmap 场景。
  • fb_mmap：核心函数。实现将内核中的帧缓冲区（物理内存或 DMA 缓冲区）映射到用户空间。这是实现高性能图形显示的关键。
  • fb_ioctl：处理用户空间的 ioctl 命令，如获取/设置屏幕参数（FBIOGET_VSCREENINFO、FBIOPUT_VSCREENINFO）。
  • fb_check_var：验证用户设置的 fb_var_screeninfo 参数是否合法，并进行修正。
  • fb_set_par：根据 fb_var_screeninfo 中的参数，实际配置硬件控制器（如设置分辨率、时序、位深等）。
  • fb_blank：控制屏幕的开关、休眠或唤醒。
  • fb_pan_display：实现屏幕的硬件平移（panning），常用于双缓冲或多缓冲场景。
  • fb_fillrect / fb_copyarea / fb_imageblit：硬件加速的图形操作，用于加速矩形填充、区域拷贝和位图显示。如果硬件不支持，内核会提供软件模拟。
实现注意： 对于简单的 Framebuffer 设备，至少需要实现 fb_check_var、fb_set_par 和 fb_mmap。如果硬件不支持硬件加速，fb_fillrect 等函数可以设置为 NULL，内核会自动使用 cfb_fillrect 等软件模拟函数。

2.2.1 fb_ops 操作流程

下图展示了用户空间操作如何通过 fb_ops 最终作用于硬件：

fb_ops 操作流程图 fb_ops 操作流程图 用户操作 系统调用 核心层分发 fb_ops 硬件操作 示例：设置分辨率流程 1. 用户调用 FBIOPUT_VSCREENINFO ioctl。 2. 核心层调用 fb_ops.fb_check_var 验证参数。 3. 验证通过后，调用 fb_ops.fb_set_par 配置硬件。

2.3 注册与注销流程：设备的“生”与“死”

Framebuffer 驱动的生命周期管理通过 register_framebuffer 和 unregister_framebuffer 两个核心函数完成。它们负责将 fb_info 对象接入或移出内核的 Framebuffer 子系统。

2.3.1 注册流程

注册一个 Framebuffer 设备通常遵循以下步骤：

  1. 分配 fb_info：使用 framebuffer_alloc 函数动态分配一个 fb_info 结构体，并指定私有数据 par 的大小。
  2. 填充固定信息：设置 fb_fix_screeninfo，包括 smem_start（物理地址）、smem_len（长度）、line_length（行宽）等。
  3. 填充可变信息：设置 fb_var_screeninfo 的默认值，如分辨率、位深、时序等。
  4. 设置操作集：将 fbops 指针指向一个已实现的 struct fb_ops 实例。
  5. 映射帧缓冲：将物理帧缓冲内存通过 ioremap 或 dma_alloc_coherent 映射到内核虚拟地址，并赋值给 screen_base。
  6. 注册设备：调用 register_framebuffer 将 fb_info 注册到系统中。成功后，系统会在 /dev 下创建 fbX 设备节点。
注册示例代码片段： 
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. 设置固定信息
    info->fix.smem_start = par->phys_addr;
    info->fix.smem_len = par->fb_size;
    info->fix.line_length = par->width * (par->bpp / 8);
    strcpy(info->fix.id, "my_fb");

    // 3. 设置可变信息默认值
    info->var.xres = par->width;
    info->var.yres = par->height;
    info->var.bits_per_pixel = par->bpp;
    // ... 设置其他时序参数 ...

    // 4. 设置操作集
    info->fbops = &myfb_ops;

    // 5. 映射帧缓冲
    info->screen_base = ioremap(par->phys_addr, par->fb_size);
    if (!info->screen_base) {
        framebuffer_release(info);
        return -ENOMEM;
    }

    // 6. 注册设备
    if (register_framebuffer(info) < 0) {
        iounmap(info->screen_base);
        framebuffer_release(info);
        return -EINVAL;
    }

    platform_set_drvdata(pdev, info);
    return 0;
}

2.3.2 注销流程

注销流程是注册的逆过程，通常在驱动卸载时执行：

  1. 注销设备：调用 unregister_framebuffer 将设备从系统中移除，并删除对应的 /dev/fbX 节点。
  2. 解除映射：如果之前使用了 ioremap，则调用 iounmap 解除内核虚拟地址映射。
  3. 释放结构体：调用 framebuffer_release 释放 fb_info 及其关联的私有数据内存。
注销注意事项： 在调用 unregister_framebuffer 之前，必须确保没有用户空间进程正在使用该设备（即文件引用计数为 0）。否则，注销操作可能会失败或导致内核崩溃。通常，驱动在 remove 回调中执行注销操作。

2.3.3 注册与注销状态机

下图展示了 fb_info 从分配到释放的完整状态转换：

fb_info 生命周期状态机 fb_info 生命周期状态机 未分配 已分配 已注册 已注销 framebuffer_alloc register_fb unregister_fb framebuffer_release 关键函数对应关系： framebuffer_alloc() ↔ framebuffer_release() | register_framebuffer() ↔ unregister_framebuffer()

2.4 本章小结

本章详细剖析了 Framebuffer 设备模型的三大核心要素：

  • struct fb_info：作为设备的唯一抽象，集成了可变/固定参数、操作函数指针和硬件地址。
  • struct fb_ops：定义了驱动与内核交互的标准接口，其中 fb_mmap 和 fb_set_par 是实现显示功能的关键。
  • 注册与注销流程：通过 framebuffer_alloc/register_framebuffer 和 unregister_framebuffer/framebuffer_release 管理设备生命周期。
← 上一章 📖 返回目录 下一章 →