📚 课程目录第2章帧缓冲驱动模型

2. 帧缓冲驱动模型：fbmem.c核心分析、注册与注销流程、file_operations接口实现

帧缓冲（Framebuffer）驱动模型是Linux显示子系统的基石。用户空间通过/dev/fbX设备节点直接操作显存，而这一切的核心实现都集中在drivers/video/fbdev/core/fbmem.c文件中。本章将深入剖析fbmem.c的核心数据结构、设备注册与注销流程，以及关键的file_operations接口实现。

2.1 fbmem.c核心数据结构与全局管理

fbmem.c维护了一个全局的帧缓冲设备数组，用于管理系统中所有注册的帧缓冲设备。核心数据结构是fb_info，它描述了一个帧缓冲设备的全部属性。

  核心数据结构：struct fb_info

  fb_info是帧缓冲驱动的“设备对象”，包含了硬件参数、操作函数指针、屏幕缓冲区、以及延迟写（deferred_io）所需的全部状态。

// include/linux/fb.h (简化核心字段)
struct fb_info {
    atomic_t count;             // 打开计数
    int node;                   // 设备节点号 (0, 1, 2...)
    int flags;                  // 设备标志
    struct fb_var_screeninfo var;   // 可变屏幕参数 (分辨率, 位深等)
    struct fb_fix_screeninfo fix;   // 固定屏幕参数 (内存起始地址, 行长等)
    struct fb_ops *fbops;           // 硬件操作函数集
    char __iomem *screen_base;      // 显存虚拟基地址
    unsigned long screen_size;      // 显存大小
    struct fb_deferred_io *fbdefio; // 延迟写机制结构体 (第3章详述)
    struct device *device;          // 内核设备模型指针
    // ... 其他字段
};

全局管理采用一个静态数组和注册计数：

// fbmem.c 中的全局变量
static struct fb_info *registered_fb[FB_MAX]; // FB_MAX = 32
static int num_registered_fb;                 // 已注册设备数量

设计要点： 帧缓冲设备数量上限为32个（FB_MAX）。每个设备通过node字段（0~31）索引到registered_fb数组中。这种静态数组设计简化了查找逻辑，但限制了最大设备数。

2.2 帧缓冲设备注册流程

帧缓冲设备的注册由register_framebuffer()函数完成，该函数是驱动开发者注册新设备的入口。注册流程涉及设备号分配、数据结构初始化、sysfs接口创建等关键步骤。

2.2.1 注册函数调用链

// drivers/video/fbdev/core/fbmem.c
int register_framebuffer(struct fb_info *fb_info)
{
    int ret;
    // 1. 查找空闲节点号
    // 2. 初始化 fb_info 内部字段
    // 3. 创建 /dev/fbX 设备节点
    // 4. 注册到 sysfs
    // 5. 调用 fbcon (控制台) 通知
    // 6. 更新全局状态
    return do_register_framebuffer(fb_info);
}

static int do_register_framebuffer(struct fb_info *fb_info)
{
    int i, ret;
    struct fb_videomode *mode;

    // 步骤1: 分配 node 号
    for (i = 0; i < FB_MAX; i++) {
        if (!registered_fb[i])
            break;
    }
    if (i == FB_MAX) return -ENOSPC; // 设备已满
    fb_info->node = i;

    // 步骤2: 设置默认显示模式
    fb_var_to_videomode(&mode, &fb_info->var);

    // 步骤3: 创建字符设备
    ret = fb_create_device(fb_info);
    if (ret) return ret;

    // 步骤4: 注册到 sysfs
    fb_init_device(fb_info);

    // 步骤5: 通知帧缓冲控制台
    fbcon_fb_registered(fb_info);

    // 步骤6: 加入全局数组
    registered_fb[i] = fb_info;
    num_registered_fb++;

    return 0;
}

2.2.2 注册流程步骤表

步骤	函数/操作	说明
1	查找空闲node	遍历`registered_fb[]`，找到第一个`NULL`槽位
2	初始化var/fix	根据驱动提供的默认参数填充`fb_var_screeninfo`和`fb_fix_screeninfo`
3	创建字符设备	调用`fb_create_device()`，内部使用`cdev_init()`和`cdev_add()`
4	sysfs注册	创建`/sys/class/graphics/fbX/`目录及属性文件
5	控制台通知	调用`fbcon_fb_registered()`，使帧缓冲控制台接管显示
6	全局状态更新	将`fb_info`存入`registered_fb[node]`，递增`num_registered_fb`

注意事项： 注册过程中，如果fb_create_device()失败，必须回滚之前的所有操作。fbmem.c通过goto错误处理标签实现资源清理。驱动开发者在调用register_framebuffer()前，应确保fb_info中的fbops、screen_base等关键字段已正确初始化。

2.3 帧缓冲设备注销流程

设备注销由unregister_framebuffer()函数完成，是注册的逆过程。注销时必须确保设备不再被使用，并释放所有内核资源。

// fbmem.c
int unregister_framebuffer(struct fb_info *fb_info)
{
    int ret;

    // 1. 检查设备是否正在使用 (打开计数)
    if (atomic_read(&fb_info->count))
        return -EBUSY;

    // 2. 通知控制台移除
    fbcon_fb_unregistered(fb_info);

    // 3. 从 sysfs 移除
    fb_cleanup_device(fb_info);

    // 4. 销毁字符设备
    fb_destroy_device(fb_info);

    // 5. 从全局数组移除
    registered_fb[fb_info->node] = NULL;
    num_registered_fb--;

    // 6. 释放 fb_info (由驱动负责)
    return 0;
}

  关键检查： 注销前必须检查fb_info->count是否为0。如果用户空间进程正在操作/dev/fbX（例如Xorg或Weston），注销将返回-EBUSY。驱动开发者应在模块卸载时先确保所有用户空间引用已关闭。

2.4 file_operations接口实现

帧缓冲设备通过file_operations结构体向用户空间暴露操作接口。fbmem.c中定义了全局的fb_fops，所有/dev/fbX设备共享同一套操作函数。

2.4.1 fb_fops 结构体定义

// fbmem.c
static const struct file_operations fb_fops = {
    .owner      = THIS_MODULE,
    .open       = fb_open,
    .release    = fb_release,
    .read       = fb_read,
    .write      = fb_write,
    .mmap       = fb_mmap,
    .unlocked_ioctl = fb_ioctl,
#ifdef CONFIG_COMPAT
    .compat_ioctl   = fb_compat_ioctl,
#endif
};

2.4.2 核心接口实现分析

接口	函数	核心行为	与延迟写的关系
open	fb_open()	递增`fb_info->count`，初始化延迟写（如果`fbdefio`已设置）	调用`fb_deferred_io_init()`初始化延迟写工作队列
release	fb_release()	递减`fb_info->count`，清理延迟写资源	调用`fb_deferred_io_cleanup()`销毁延迟写定时器
read	fb_read()	从`screen_base`拷贝数据到用户空间	直接读取，不触发延迟写
write	fb_write()	从用户空间拷贝数据到`screen_base`	直接写入，不触发延迟写（mmap写入才触发）
mmap	fb_mmap()	将显存映射到用户空间，设置页错误处理	如果`fbdefio`存在，注册`fb_deferred_io_mmap()`处理页错误
ioctl	fb_ioctl()	处理FBIOGET_VSCREENINFO、FBIOPUT_VSCREENINFO等控制命令	设置`var`参数时可能触发模式切换

2.4.3 fb_mmap 与延迟写的关键关联

fb_mmap()是延迟写机制的入口点。当用户空间通过mmap映射显存后，对映射区域的写操作会触发页错误，而fb_deferred_io正是通过拦截这些页错误来实现延迟刷新。

// fbmem.c - fb_mmap 简化实现
static int fb_mmap(struct file *file, struct vm_area_struct *vma)
{
    struct fb_info *info = file->private_data;
    unsigned long start;
    u32 len;

    // 计算映射大小和偏移
    start = info->fix.smem_start + (unsigned long)vma->vm_pgoff << PAGE_SHIFT;
    len = info->fix.smem_len;

    // 关键：如果设置了 fbdefio，使用延迟写的 mmap
    if (info->fbdefio) {
        // 注册页错误处理函数为 fb_deferred_io_fault
        return fb_deferred_io_mmap(info, vma);
    }

    // 普通映射：直接 remap 显存
    return vm_iomap_memory(vma, start, len);
}

性能提示： 对于触摸交互优化场景，mmap路径是核心关注点。用户空间的图形栈（如Wayland合成器）通常通过mmap直接操作显存，然后由延迟写机制决定何时将修改同步到硬件。理解fb_mmap的分支逻辑（普通映射 vs 延迟写映射）是优化触摸响应延迟的第一步。

2.5 本章小结

全局管理： fbmem.c通过registered_fb[FB_MAX]静态数组管理最多32个帧缓冲设备，fb_info是核心设备描述结构。
注册流程： register_framebuffer()完成设备号分配、字符设备创建、sysfs注册、控制台通知等6个关键步骤。
注销流程： unregister_framebuffer()是注册的逆过程，必须确保设备打开计数为0才能成功注销。
file_operations： fb_fops提供open/release/read/write/mmap/ioctl接口，其中fb_mmap是延迟写机制的入口，通过fb_deferred_io_mmap()将页错误处理委托给延迟写模块。