2. fbdev 框架详解：核心数据结构、操作接口与生命周期

fbdev（Framebuffer Device）是 Linux 内核中历史最悠久的显示子系统框架，其核心设计围绕 fb_info 结构体、fb_ops 回调函数以及标准的字符设备注册/注销流程展开。理解这三部分，是掌握 fbdev 工作原理以及后续迁移到 DRM KMS 的基础。

2.1 fb_info 结构体：帧缓冲设备的核心描述符

fb_info 是 fbdev 框架中最重要的数据结构，每个帧缓冲设备在内存中对应一个 fb_info 实例。它包含了设备的所有硬件信息、状态、操作函数指针以及内存映射信息。

2.1.1 核心字段解析

2.1.2 fb_info 结构体关系图

2.2 fb_ops 回调函数：驱动与内核的契约

fb_ops 结构体定义了帧缓冲设备驱动必须实现或可选实现的回调函数集合。内核在用户空间发起系统调用（如 open、ioctl、mmap）时，通过 fb_info.fbops 指针调用对应的驱动函数。

2.2.1 核心回调函数分类

2.2.2 fb_ops 回调调用流程

2.3 注册与注销流程：设备生命周期管理

fbdev 驱动的注册和注销遵循标准的 Linux 设备模型，核心函数为 register_framebuffer 和 unregister_framebuffer。驱动开发者需要理解这两个函数背后的完整流程，以避免资源泄漏和设备冲突。

2.3.1 注册流程 (register_framebuffer)

1. 分配 fb_info： 使用 framebuffer_alloc 分配 fb_info 结构体，并设置 screen_base、screen_size、var、fix 等字段。
2. 填充 fb_ops： 将驱动实现的回调函数赋值给 fb_info.fbops。
3. 设置私有数据： 通过 fb_info.par 指向驱动私有数据结构（如寄存器基址、时钟配置）。
4. 调用 register_framebuffer： 内核执行以下操作：
   • 检查 fb_info 合法性（fbops 不能为 NULL）。
   • 分配设备节点编号 node，创建 /dev/fb<N> 设备文件。
   • 调用 fb_set_par 初始化硬件时序和分辨率。
   • 将 fb_info 加入全局链表 registered_fb。
   • 注册 sysfs 属性，允许用户空间通过 /sys/class/graphics/fb<N> 访问设备信息。
5. 初始化完成： 设备进入 FBINFO_STATE_RUNNING 状态，用户空间可以打开设备。

2.3.2 注销流程 (unregister_framebuffer)

1. 调用 unregister_framebuffer： 传入要注销的 fb_info 指针。
2. 内核执行：
   • 从全局链表 registered_fb 中移除该设备。
   • 删除 /dev/fb<N> 设备文件和 sysfs 属性。
   • 等待所有用户空间文件描述符关闭（通过引用计数）。
   • 调用 fb_blank（如果实现）关闭显示面板。
3. 释放资源： 驱动调用 framebuffer_release 释放 fb_info 结构体及其关联内存。

2.3.3 注册与注销流程状态图

2.4 典型驱动代码骨架

以下是一个简化的 fbdev 驱动注册与注销代码示例，展示了 fb_info 的分配、fb_ops 的填充以及注册/注销函数的调用顺序。

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

static struct fb_info *my_fb_info;

static int my_fb_check_var(struct fb_var_screeninfo *var, struct fb_info *info)
{
    /* 校验并修正分辨率、位深等参数 */
    if (var->xres > 1920 || var->yres > 1080)
        return -EINVAL;
    return 0;
}

static int my_fb_set_par(struct fb_info *info)
{
    /* 根据 info->var 配置硬件时序寄存器 */
    /* 更新 info->fix.line_length */
    info->fix.line_length = info->var.xres * info->var.bits_per_pixel / 8;
    return 0;
}

static struct fb_ops my_fb_ops = {
    .owner          = THIS_MODULE,
    .fb_check_var   = my_fb_check_var,
    .fb_set_par     = my_fb_set_par,
    .fb_setcolreg   = NULL,  /* 真彩色模式不需要 */
    .fb_fillrect    = sys_fillrect,
    .fb_copyarea    = sys_copyarea,
    .fb_imageblit   = sys_imageblit,
};

static int my_fb_probe(struct platform_device *pdev)
{
    /* 1. 分配 fb_info */
    my_fb_info = framebuffer_alloc(0, &pdev->dev);
    if (!my_fb_info)
        return -ENOMEM;

    /* 2. 设置固定参数 */
    strcpy(my_fb_info->fix.id, "my_fb");
    my_fb_info->fix.smem_start = 0x10000000;  /* 物理地址 */
    my_fb_info->fix.smem_len   = 8 * 1024 * 1024;  /* 8MB */

    /* 3. 设置可变参数默认值 */
    my_fb_info->var.xres = 1024;
    my_fb_info->var.yres = 768;
    my_fb_info->var.bits_per_pixel = 32;

    /* 4. 映射显存 */
    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;

    /* 5. 挂载 fb_ops */
    my_fb_info->fbops = &my_fb_ops;

    /* 6. 注册帧缓冲设备 */
    if (register_framebuffer(my_fb_info) < 0) {
        iounmap(my_fb_info->screen_base);
        framebuffer_release(my_fb_info);
        return -EINVAL;
    }

    return 0;
}

static int my_fb_remove(struct platform_device *pdev)
{
    /* 1. 注销帧缓冲设备 */
    unregister_framebuffer(my_fb_info);

    /* 2. 取消显存映射 */
    iounmap(my_fb_info->screen_base);

    /* 3. 释放 fb_info */
    framebuffer_release(my_fb_info);

    return 0;
}

2.5 fbdev 框架的局限性

虽然 fbdev 框架简单易用，但在现代嵌入式系统中存在明显不足，这也是推动迁移到 DRM KMS 的主要原因：