📚 课程目录第2章 Linux帧缓冲驱动框架

2. Linux 帧缓冲驱动框架：fbmem.c 核心、fb_ops 结构体、注册与注销流程

帧缓冲（FrameBuffer）驱动是 Linux 内核中负责管理显示缓冲区、提供统一用户空间 /dev/fb* 接口的核心组件。本章深入分析驱动框架的三个支柱：fbmem.c 核心层、fb_ops 操作结构体以及驱动的注册与注销流程。理解这些是编写高效、防撕裂帧缓冲驱动的基础。

  核心概念： fbmem.c 作为帧缓冲子系统的中枢，向上提供字符设备接口，向下通过 fb_ops 回调与具体硬件驱动交互。驱动开发者只需填充 fb_ops 并调用注册/注销 API，即可完成硬件适配。

2.1 fbmem.c 核心层：帧缓冲子系统的中枢

fbmem.c 位于内核源码 drivers/video/fbdev/core/ 目录下，是帧缓冲子系统的核心文件。它负责以下关键任务：

字符设备管理： 注册主设备号 29，创建 /dev/fb[0-31] 设备节点。
系统调用分发： 实现 open、release、read、write、mmap、ioctl 等文件操作，并将请求转发给具体驱动的 fb_ops。
全局状态维护： 管理 registered_fb[] 数组和 num_registered_fb 计数器，维护所有已注册帧缓冲设备的链表。
事件通知： 通过 fb_notifier_call_chain() 向其他内核模块（如控制台、DRM）广播帧缓冲状态变化。

关键数据结构： struct fb_info 是帧缓冲驱动的核心结构体，每个帧缓冲设备对应一个实例。它包含 fb_ops 指针、fb_var_screeninfo（可变参数）、fb_fix_screeninfo（固定参数）以及 screen_base（显存虚拟地址）等关键成员。

2.2 fb_ops 结构体：驱动与核心的契约

struct fb_ops 定义在 include/linux/fb.h 中，是帧缓冲驱动必须实现的操作集合。它定义了驱动与 fbmem.c 核心之间的标准接口契约。

回调函数	功能描述	防撕裂关联
`fb_open`	设备打开时的初始化操作	可在此分配双缓冲 DMA 缓冲区
`fb_release`	设备关闭时的清理操作	释放缓冲区、关闭 VSYNC 中断
`fb_read` / `fb_write`	帧缓冲数据的读写	写操作需考虑缓冲区切换同步
`fb_setcoloreg`	设置颜色寄存器（伪彩色模式）	—
`fb_blank`	控制显示器的空白/唤醒	空白期间可安全切换缓冲区
`fb_pan_display`	设置显示起始地址（关键！）	双缓冲切换核心，配合 VSYNC 实现防撕裂
`fb_set_par`	设置显示参数（分辨率、位深等）	参数变更时需重新计算缓冲区大小
`fb_mmap`	将显存映射到用户空间	映射双缓冲区的两个页面
`fb_ioctl`	自定义控制命令	可扩展 VSYNC 等待、缓冲区切换命令

防撕裂关键回调： fb_pan_display 是实现双缓冲和防撕裂的核心。驱动应在此回调中设置硬件显示起始地址寄存器，并确保该操作在 VSYNC 期间完成，避免屏幕撕裂。

2.3 注册与注销流程：驱动的生命周期

帧缓冲驱动的注册和注销遵循标准的 Linux 内核驱动模型。核心 API 为 register_framebuffer() 和 unregister_framebuffer()。

2.3.1 注册流程

分配 fb_info： 调用 framebuffer_alloc() 分配 struct fb_info 实例。
填充 fb_info： 设置 fb_ops、fb_var_screeninfo、fb_fix_screeninfo、screen_base 等字段。
硬件初始化： 初始化显示控制器、分配 DMA 缓冲区、设置时钟等。
注册到内核： 调用 register_framebuffer(fb_info)。
fbmem.c 处理： 分配 fb_info 索引、添加到 registered_fb[]、创建设备节点、通知控制台切换。

2.3.2 注销流程

通知上层： 调用 fb_notifier_call_chain(FB_EVENT_FB_UNREGISTER)。
注销设备： 调用 unregister_framebuffer(fb_info)。
fbmem.c 处理： 移除设备节点、从 registered_fb[] 清除、释放索引。
硬件关闭： 关闭显示控制器、释放 DMA 缓冲区、关闭时钟。
释放 fb_info： 调用 framebuffer_release() 释放内存。

2.4 关键数据结构与 API 速查表

API / 数据结构	头文件	用途
`struct fb_info`	`linux/fb.h`	帧缓冲设备核心结构体，包含所有状态和操作指针
`struct fb_ops`	`linux/fb.h`	驱动操作回调集合，必须实现 `fb_pan_display` 等
`struct fb_var_screeninfo`	`linux/fb.h`	可变显示参数（分辨率、位深、时序）
`struct fb_fix_screeninfo`	`linux/fb.h`	固定显示参数（显存地址、行长度、类型）
`framebuffer_alloc()`	`linux/fb.h`	分配并初始化 `fb_info` 实例
`framebuffer_release()`	`linux/fb.h`	释放 `fb_info` 实例
`register_framebuffer()`	`linux/fb.h`	注册帧缓冲设备到内核
`unregister_framebuffer()`	`linux/fb.h`	从内核注销帧缓冲设备

2.5 驱动框架代码示例

以下是一个简化的帧缓冲驱动注册与注销框架，展示核心流程：

#include <linux/fb.h>
#include <linux/module.h>
#include <linux/platform_device.h>

static struct fb_info *my_fb_info;
static struct fb_ops my_fb_ops = {
    .owner          = THIS_MODULE,
    .fb_open        = my_fb_open,
    .fb_release     = my_fb_release,
    .fb_setcoloreg  = my_fb_setcoloreg,
    .fb_blank       = my_fb_blank,
    .fb_pan_display = my_fb_pan_display,  /* 防撕裂关键 */
    .fb_set_par     = my_fb_set_par,
    .fb_mmap        = my_fb_mmap,
    .fb_ioctl       = my_fb_ioctl,
};

static int my_fb_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. 填充 fb_ops */
    my_fb_info->fbops = &my_fb_ops;

    /* 3. 设置固定/可变参数 */
    my_fb_info->var.xres = 800;
    my_fb_info->var.yres = 480;
    my_fb_info->var.bits_per_pixel = 32;
    my_fb_info->fix.smem_len = 800 * 480 * 4 * 2; /* 双缓冲 */

    /* 4. 硬件初始化：分配 DMA 缓冲区、初始化控制器 */
    ret = my_hardware_init(pdev);
    if (ret)
        goto err_hw_init;

    /* 5. 注册帧缓冲设备 */
    ret = register_framebuffer(my_fb_info);
    if (ret)
        goto err_register;

    dev_info(&pdev->dev, "FrameBuffer registered\n");
    return 0;

err_register:
    my_hardware_exit(pdev);
err_hw_init:
    framebuffer_release(my_fb_info);
    return ret;
}

static int my_fb_remove(struct platform_device *pdev)
{
    /* 逆序注销 */
    unregister_framebuffer(my_fb_info);
    my_hardware_exit(pdev);
    framebuffer_release(my_fb_info);
    return 0;
}

static struct platform_driver my_fb_driver = {
    .probe  = my_fb_probe,
    .remove = my_fb_remove,
    .driver = {
        .name = "my_fb",
    },
};

module_platform_driver(my_fb_driver);
MODULE_LICENSE("GPL");

实践建议： 在 fb_pan_display 回调中，应读取硬件 VSYNC 状态寄存器，确保在垂直消隐期间更新显示起始地址。对于不支持硬件 VSYNC 检测的控制器，可使用定时器轮询或等待帧中断。

2.6 本章小结

fbmem.c 是帧缓冲子系统的核心，提供字符设备接口和事件通知机制。
fb_ops 定义了驱动与核心的契约，fb_pan_display 是双缓冲和防撕裂的关键回调。
注册流程 遵循分配 → 填充 → 硬件初始化 → 注册的顺序；注销流程 严格逆序执行。
理解这些框架组件是后续实现双缓冲和 VSYNC 同步机制的基础。