2. FrameBuffer 驱动基础：Linux FrameBuffer 架构、fbdev 子系统、关键数据结构

在电子书阅读器的 EPD 显示链路中，FrameBuffer 是应用层与硬件显示控制器之间的核心抽象层。本章深入剖析 Linux FrameBuffer 架构、fbdev 子系统以及关键数据结构 struct fb_info 和 struct fb_ops，为后续 EPD 驱动调试奠定基础。

2.1 Linux FrameBuffer 架构概述

FrameBuffer 是 Linux 内核中为显示设备提供的一种统一抽象接口。它将显存映射到用户空间，应用程序可以直接读写显存，无需关心底层硬件细节。在 EPD 场景中，FrameBuffer 负责管理电子纸的像素缓冲区，并通过驱动层将数据传递给 EPD 控制器。

上图展示了 FrameBuffer 架构的四层结构：用户空间应用程序通过标准文件操作与内核交互；fbdev 核心层管理所有注册的 struct fb_info 实例；硬件驱动层实现具体的 fb_ops 回调，完成对 EPD 控制器的操作。

2.2 fbdev 子系统核心机制

fbdev 子系统是 Linux 内核中管理 FrameBuffer 设备的框架，位于 drivers/video/fbdev/ 目录。其核心文件 fbmem.c 实现了设备注册、文件操作接口、ioctl 命令处理等功能。

2.3 关键数据结构：struct fb_info

struct fb_info 是 FrameBuffer 驱动的核心数据结构，每个注册的 FrameBuffer 设备对应一个实例。它包含了设备的所有状态信息、操作函数指针、显示参数和私有数据。

struct fb_info {
    atomic_t count;                    // 打开计数
    int node;                          // 设备编号 (fbX 中的 X)
    int flags;                         // 设备标志位
    struct mutex lock;                 // 互斥锁
    struct fb_var_screeninfo var;      // 可变显示参数 (分辨率、位深、时序)
    struct fb_fix_screeninfo fix;      // 固定显示参数 (显存地址、行长)
    struct fb_cmap cmap;               // 颜色映射表 (调色板)
    struct fb_ops *fbops;              // 操作函数指针
    char __iomem *screen_base;         // 显存虚拟地址
    unsigned long screen_size;         // 显存大小 (字节)
    void *pseudo_palette;              // 伪调色板 (16 色)
    struct device *device;             // 关联的设备结构体
    struct fb_videomode *mode;         // 当前显示模式
    void *par;                         // 驱动私有数据 (关键！)
};

2.4 关键数据结构：struct fb_ops

struct fb_ops 定义了驱动必须实现的操作函数指针。fbdev 核心通过调用这些回调函数完成具体的硬件操作。对于 EPD 驱动，部分回调具有特殊实现要求。

struct fb_ops {
    struct module *owner;              // 模块所有者
    int (*fb_open)(struct fb_info *info, int user);      // 设备打开
    int (*fb_release)(struct fb_info *info, int user);   // 设备关闭
    ssize_t (*fb_read)(struct fb_info *info, char __user *buf, size_t count, loff_t *ppos);
    ssize_t (*fb_write)(struct fb_info *info, const char __user *buf, size_t count, loff_t *ppos);
    int (*fb_check_var)(struct fb_var_screeninfo *var, struct fb_info *info);  // 参数校验
    int (*fb_set_par)(struct fb_info *info);             // 设置显示参数
    int (*fb_setcolreg)(unsigned regno, unsigned red, unsigned green, unsigned blue, unsigned transp, struct fb_info *info);
    int (*fb_blank)(int blank_mode, struct fb_info *info); // 空白/唤醒
    int (*fb_pan_display)(struct fb_var_screeninfo *var, struct fb_info *info); // 画面平移
    void (*fb_fillrect)(struct fb_info *info, const struct fb_fillrect *rect);  // 矩形填充
    void (*fb_copyarea)(struct fb_info *info, const struct fb_copyarea *area);  // 区域复制
    void (*fb_imageblit)(struct fb_info *info, const struct fb_image *image);   // 位图渲染
    int (*fb_ioctl)(struct fb_info *info, unsigned int cmd, unsigned long arg); // 自定义 ioctl
    int (*fb_mmap)(struct fb_info *info, struct vm_area_struct *vma);           // 内存映射
};

2.5 显示参数结构体：var 与 fix

fb_var_screeninfo 和 fb_fix_screeninfo 分别描述可变和固定的显示参数。用户空间通过 FBIOGET_VSCREENINFO 和 FBIOPUT_VSCREENINFO ioctl 命令读写这些参数。

2.6 驱动注册与注销流程

EPD FrameBuffer 驱动的生命周期管理遵循标准的平台驱动模型。以下是一个典型的注册流程：

1. probe 函数入口：分配 struct fb_info 实例 (使用 framebuffer_alloc())，初始化 par 私有数据。
2. 硬件初始化：映射 EPD 控制器寄存器 (ioremap)、配置 GPIO、初始化 SPI 或并行接口。
3. 参数填充：设置 fb_var_screeninfo 和 fb_fix_screeninfo 的默认值，分配显存 (dma_alloc_coherent)。
4. 操作函数绑定：将 fb_ops 结构体赋值给 info->fbops，实现所有必需的回调。
5. 设备注册：调用 register_framebuffer(info)，将设备加入 fbdev 子系统。
6. remove 函数：调用 unregister_framebuffer(info)，释放显存和寄存器映射，最后调用 framebuffer_release(info)。

// EPD FrameBuffer 驱动 probe 函数示例骨架
static int epd_fb_probe(struct platform_device *pdev)
{
    struct fb_info *info;
    struct epd_priv *priv;
    int ret;

    // 1. 分配 fb_info 和私有数据
    info = framebuffer_alloc(sizeof(struct epd_priv), &pdev->dev);
    if (!info)
        return -ENOMEM;

    priv = info->par;
    priv->dev = &pdev->dev;

    // 2. 硬件初始化 (寄存器映射、GPIO、SPI)
    priv->regs = devm_platform_ioremap_resource(pdev, 0);
    if (IS_ERR(priv->regs)) {
        ret = PTR_ERR(priv->regs);
        goto err_release;
    }

    // 3. 设置显示参数
    info->var = epd_default_var;   // 默认 800x600, 1-bit
    info->fix = epd_default_fix;
    info->screen_base = dma_alloc_coherent(priv->dev, info->fix.smem_len,
                                           &priv->dma_phys, GFP_KERNEL);
    if (!info->screen_base) {
        ret = -ENOMEM;
        goto err_release;
    }

    // 4. 绑定操作函数
    info->fbops = &epd_fb_ops;

    // 5. 注册 FrameBuffer 设备
    ret = register_framebuffer(info);
    if (ret < 0)
        goto err_dma;

    platform_set_drvdata(pdev, info);
    dev_info(priv->dev, "EPD framebuffer registered\n");
    return 0;

err_dma:
    dma_free_coherent(priv->dev, info->fix.smem_len,
                      info->screen_base, priv->dma_phys);
err_release:
    framebuffer_release(info);
    return ret;
}

2.7 本章小结

本章系统梳理了 Linux FrameBuffer 驱动的基础架构：

• 架构分层：用户空间 → 系统调用 → fbdev 核心 → 硬件驱动 → EPD 硬件。
• 核心数据结构：struct fb_info 是驱动的主干，var/fix 描述显示参数，par 承载驱动私有数据。
• 操作函数表：struct fb_ops 定义了驱动与内核的交互接口，EPD 驱动需特别关注 fb_check_var、fb_set_par、fb_blank 和 fb_ioctl。
• 注册流程：遵循 probe → 初始化 → 注册 → remove → 注销的标准生命周期。