2. Framebuffer 驱动原理：Linux 内核 Framebuffer 子系统架构

Framebuffer 驱动是 Linux 内核中负责管理显示帧缓冲区的核心组件。它向上为用户空间提供统一的 /dev/fbX 设备文件接口，向下与具体的显示控制器硬件交互。理解其内部架构是进行图层合成与光标叠加优化的前提。

2.1 Linux 内核 Framebuffer 子系统架构

Framebuffer 子系统采用分层设计，主要分为三个层次：用户空间接口层、核心框架层 和 硬件驱动层。核心框架层（drivers/video/fbdev/core/）负责管理设备注册、文件操作回调、颜色映射和显示参数配置；硬件驱动层则实现具体的寄存器读写和显存管理。

2.2 核心数据结构：fb_info 与 fb_ops

每个 Framebuffer 设备在内核中对应一个 struct fb_info 实例，它包含了设备的所有状态信息和操作函数指针。其中最重要的成员是 fb_ops 结构体，它定义了驱动需要实现的操作回调。

2.3 fb_ops 结构体详解

struct fb_ops 是驱动与核心框架之间的契约。驱动必须实现 fb_open、fb_release、fb_check_var、fb_set_par 和 fb_fillrect 等关键回调。下面列出最常用的回调函数及其用途：

2.4 注册与注销 Framebuffer 设备

驱动加载时，需要完成以下步骤来注册一个 Framebuffer 设备：

1. 分配 fb_info 结构体：使用 framebuffer_alloc() 分配并初始化。
2. 填充固定信息 (fix)：设置显存物理地址、行长度、类型标志。
3. 填充可变信息 (var)：设置默认分辨率、位深、时序参数。
4. 设置 fb_ops：将驱动实现的回调函数指针赋值给 fb_info.fbops。
5. 注册设备：调用 register_framebuffer() 将设备加入内核。
6. 注销设备：模块卸载时调用 unregister_framebuffer() 并释放内存。

2.5 关键代码示例：注册与注销

以下是一个简化的 Framebuffer 驱动注册与注销代码片段，展示了核心流程：

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

static struct fb_info *my_fb_info;
static char *my_fb_mem;
#define MY_FB_SIZE (800 * 480 * 4)  /* 800x480 32bpp */

/* fb_ops 回调实现（简化） */
static int my_fb_open(struct fb_info *info, int user) {
    pr_info("myfb: device opened\n");
    return 0;
}

static int my_fb_release(struct fb_info *info, int user) {
    pr_info("myfb: device closed\n");
    return 0;
}

static int my_fb_check_var(struct fb_var_screeninfo *var, struct fb_info *info) {
    /* 校验分辨率、位深等参数 */
    if (var->xres > 800 || var->yres > 480)
        return -EINVAL;
    if (var->bits_per_pixel != 32)
        return -EINVAL;
    return 0;
}

static int my_fb_set_par(struct fb_info *info) {
    /* 根据 var 配置硬件寄存器 */
    pr_info("myfb: set_par called\n");
    return 0;
}

static struct fb_ops my_fb_ops = {
    .owner          = THIS_MODULE,
    .fb_open        = my_fb_open,
    .fb_release     = my_fb_release,
    .fb_check_var   = my_fb_check_var,
    .fb_set_par     = my_fb_set_par,
    .fb_fillrect    = cfb_fillrect,   /* 使用核心软件加速 */
    .fb_copyarea    = cfb_copyarea,
    .fb_imageblit   = cfb_imageblit,
};

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_mem = dma_alloc_coherent(&pdev->dev, MY_FB_SIZE,
                                   &my_fb_info->fix.smem_start, GFP_KERNEL);
    if (!my_fb_mem) {
        framebuffer_release(my_fb_info);
        return -ENOMEM;
    }

    /* 3. 填充 fix 信息 */
    strcpy(my_fb_info->fix.id, "my_fb");
    my_fb_info->fix.smem_len = MY_FB_SIZE;
    my_fb_info->fix.type     = FB_TYPE_PACKED_PIXELS;
    my_fb_info->fix.visual   = FB_VISUAL_TRUECOLOR;
    my_fb_info->fix.line_length = 800 * 4;

    /* 4. 填充 var 信息 */
    my_fb_info->var.xres = 800;
    my_fb_info->var.yres = 480;
    my_fb_info->var.bits_per_pixel = 32;
    my_fb_info->var.red.offset   = 16;
    my_fb_info->var.red.length   = 8;
    my_fb_info->var.green.offset = 8;
    my_fb_info->var.green.length = 8;
    my_fb_info->var.blue.offset  = 0;
    my_fb_info->var.blue.length  = 8;

    /* 5. 设置 fb_ops */
    my_fb_info->fbops = &my_fb_ops;
    my_fb_info->screen_base = my_fb_mem;
    my_fb_info->screen_size = MY_FB_SIZE;

    /* 6. 注册设备 */
    ret = register_framebuffer(my_fb_info);
    if (ret) {
        dma_free_coherent(&pdev->dev, MY_FB_SIZE,
                          my_fb_mem, my_fb_info->fix.smem_start);
        framebuffer_release(my_fb_info);
        return ret;
    }

    pr_info("myfb: registered successfully\n");
    return 0;
}

static int myfb_remove(struct platform_device *pdev) {
    /* 1. 注销设备 */
    unregister_framebuffer(my_fb_info);

    /* 2. 释放显存 */
    dma_free_coherent(&pdev->dev, MY_FB_SIZE,
                      my_fb_mem, my_fb_info->fix.smem_start);

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

    pr_info("myfb: removed\n");
    return 0;
}

static struct platform_driver myfb_driver = {
    .probe  = myfb_probe,
    .remove = myfb_remove,
    .driver = {
        .name = "my_fb",
    },
};

module_platform_driver(myfb_driver);
MODULE_LICENSE("GPL");
MODULE_DESCRIPTION("Simple Framebuffer Driver Example");

2.6 多缓冲与硬件平移

在图层合成场景中，经常需要双缓冲或三缓冲来避免撕裂。Framebuffer 驱动通过 fb_pan_display 回调支持硬件平移（panning），即在不改变显存物理地址的情况下，通过调整显示控制器的起始偏移地址来切换显示缓冲区。