2. FrameBuffer 核心数据结构详解

FrameBuffer 子系统的核心围绕三个关键数据结构展开：fb_info（设备描述符）、fb_ops（操作函数表）、fb_var_screeninfo（可变参数）和 fb_fix_screeninfo（固定参数）。理解这些结构是掌握 FrameBuffer 驱动开发的基础，也是后续迁移到 DRM 时对比差异的关键。

2.1 整体架构关系

下图展示了四个核心数据结构在 FrameBuffer 驱动中的组织关系：

2.2 struct fb_info — 设备描述符

struct fb_info 是 FrameBuffer 驱动的核心结构体，每个 Framebuffer 设备对应一个实例。它包含了设备的所有信息：操作函数、屏幕参数、设备状态、私有数据等。

2.2.1 关键字段

2.2.2 驱动初始化示例

static struct fb_info *my_fb_info;

static int myfb_probe(struct platform_device *pdev)
{
    int ret;

    // 1. 分配 fb_info 结构
    my_fb_info = framebuffer_alloc(0, &pdev->dev);
    if (!my_fb_info)
        return -ENOMEM;

    // 2. 设置操作函数表
    my_fb_info->fbops = &myfb_ops;

    // 3. 设置固定参数
    strcpy(my_fb_info->fix.id, "myfb");
    my_fb_info->fix.smem_start = dma_alloc_coherent(...);
    my_fb_info->fix.smem_len = 800 * 600 * 4; // 32bpp
    my_fb_info->fix.line_length = 800 * 4;

    // 4. 设置可变参数
    my_fb_info->var.xres = 800;
    my_fb_info->var.yres = 600;
    my_fb_info->var.bits_per_pixel = 32;

    // 5. 设置显存地址
    my_fb_info->screen_base = ioremap(my_fb_info->fix.smem_start,
                                       my_fb_info->fix.smem_len);
    my_fb_info->screen_size = my_fb_info->fix.smem_len;

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

    return 0;
}

2.3 struct fb_ops — 操作函数表

struct fb_ops 定义了 FrameBuffer 设备的所有操作接口。驱动开发者需要根据硬件特性实现其中的回调函数。内核通过这个函数表来操作具体的显示硬件。

2.3.1 核心回调函数

2.3.2 典型实现模式

static struct fb_ops myfb_ops = {
    .owner          = THIS_MODULE,
    .fb_open        = myfb_open,
    .fb_release     = myfb_release,
    .fb_read        = myfb_read,
    .fb_write       = myfb_write,
    .fb_check_var   = myfb_check_var,
    .fb_set_par     = myfb_set_par,
    .fb_setcolreg   = myfb_setcolreg,
    .fb_blank       = myfb_blank,
    .fb_fillrect    = cfb_fillrect,   // 使用通用辅助函数
    .fb_copyarea    = cfb_copyarea,   // 使用通用辅助函数
    .fb_imageblit   = cfb_imageblit,  // 使用通用辅助函数
};

static int myfb_check_var(struct fb_var_screeninfo *var,
                          struct fb_info *info)
{
    // 检查分辨率是否在硬件支持范围内
    if (var->xres > 1920 || var->yres > 1080)
        return -EINVAL;

    // 检查位深是否支持
    if (var->bits_per_pixel != 16 && var->bits_per_pixel != 32)
        return -EINVAL;

    // 调整 xres_virtual 和 yres_virtual
    if (var->xres_virtual < var->xres)
        var->xres_virtual = var->xres;
    if (var->yres_virtual < var->yres)
        var->yres_virtual = var->yres;

    return 0;
}

2.4 struct fb_var_screeninfo — 可变屏幕参数

struct fb_var_screeninfo 描述用户空间可以通过 ioctl 修改的显示参数。应用程序通过 FBIOPUT_VSCREENINFO 和 FBIOGET_VSCREENINFO 命令来设置和获取这些参数。

2.4.1 关键字段

2.4.2 位域结构 fb_bitfield

struct fb_bitfield {
    __u32 offset;   // 颜色分量在像素中的起始位偏移
    __u32 length;   // 颜色分量的位数
    __u32 msb_right; // MSB 在右侧标志（非0表示 MSB 在最低位）
};

// 示例：32bpp RGB888 格式
// red:   offset=16, length=8, msb_right=0
// green: offset=8,  length=8, msb_right=0
// blue:  offset=0,  length=8, msb_right=0

2.5 struct fb_fix_screeninfo — 固定屏幕参数

struct fb_fix_screeninfo 描述硬件固定的参数，用户空间只能读取（通过 FBIOGET_FSCREENINFO），不能修改。这些参数在驱动初始化时设置，通常在整个生命周期内保持不变。

2.5.1 关键字段

2.5.2 常用视觉类型

2.6 数据结构对比总结

下表从多个维度对比四个核心数据结构：

2.7 用户空间交互流程

下图展示了用户空间应用程序通过 ioctl 与 FrameBuffer 核心数据结构交互的完整流程：