1. Framebuffer 基础概念

Framebuffer（帧缓冲）是 Linux 内核为显示设备提供的最基础、最直接的驱动接口。它本质上是一块内存区域，用于存储屏幕每个像素的颜色数据。应用程序通过操作这块内存，即可控制显示内容，无需关心底层 GPU 或显示控制器的具体实现。本章将深入剖析 Framebuffer 的设备驱动模型、mmap 映射原理以及显存与系统内存的关系。

1.1 Framebuffer 设备驱动模型

在 Linux 系统中，Framebuffer 被抽象为一个字符设备，通常位于 /dev/fb0、/dev/fb1 等路径。其驱动模型遵循标准的 Linux 设备驱动架构，核心结构体为 fb_info，它包含了显示设备的全部信息与控制函数指针。

驱动模型的主要层次如下：

驱动注册流程的关键步骤：

1. 分配 fb_info： 使用 framebuffer_alloc() 分配并初始化 fb_info 结构体。
2. 填充固定/可变参数： 设置分辨率（xres, yres）、位深（bits_per_pixel）、行宽（line_length）、显存物理地址（smem_start）等。
3. 实现 fb_ops： 必须实现 fb_fillrect、fb_copyarea、fb_imageblit 等加速函数，以及 fb_mmap 用于内存映射。
4. 注册设备： 调用 register_framebuffer() 将设备加入内核 Framebuffer 子系统。

1.2 mmap 映射原理

Framebuffer 的核心优势在于允许用户空间通过 mmap 系统调用直接映射显存到进程地址空间，从而避免每次像素操作都经过 read/write 系统调用，大幅提升性能。

mmap 映射的完整流程：

mmap 映射的关键代码示例：

/* 用户空间应用程序通过 mmap 映射 Framebuffer */
int fb_fd = open("/dev/fb0", O_RDWR);
if (fb_fd < 0) {
    perror("open /dev/fb0 failed");
    return -1;
}

/* 获取固定信息，得到显存大小 */
struct fb_fix_screeninfo fix;
ioctl(fb_fd, FBIOGET_FSCREENINFO, &fix);

/* 获取可变信息，得到分辨率与位深 */
struct fb_var_screeninfo var;
ioctl(fb_fd, FBIOGET_VSCREENINFO, &var);

/* mmap 映射显存到用户空间 */
size_t screensize = var.xres * var.yres * (var.bits_per_pixel / 8);
void *fb_ptr = mmap(NULL, screensize, PROT_READ | PROT_WRITE,
                    MAP_SHARED, fb_fd, 0);
if (fb_ptr == MAP_FAILED) {
    perror("mmap failed");
    close(fb_fd);
    return -1;
}

/* 直接通过指针操作像素：将屏幕左上角像素设为红色 */
unsigned int *pixel = (unsigned int *)fb_ptr;
*pixel = 0x00FF0000;  /* ARGB 格式，红色通道 */

/* 解除映射 */
munmap(fb_ptr, screensize);
close(fb_fd);

1.3 显存与系统内存的关系

在嵌入式系统中，显存（VRAM）与系统内存（DRAM）的关系取决于硬件架构和驱动实现方式。理解两者的关系对于性能优化和内存管理至关重要。

共享显存架构是嵌入式系统中最常见的模式。显存通常通过内核的 DMA 内存分配器（如 dma_alloc_coherent）在系统内存中分配一块连续的物理内存区域。这块区域既被显示控制器（LCDC/HDMI）通过硬件总线直接读取，也被 CPU 通过 mmap 映射后访问。

在驱动初始化时，显存的分配与注册流程如下：

/* Framebuffer 驱动中显存分配与注册示例 */
static int myfb_probe(struct platform_device *pdev)
{
    struct fb_info *fbi;
    struct myfb_par *par;
    unsigned long mem_size;
    dma_addr_t dma_handle;
    void *screen_base;

    /* 1. 分配 fb_info */
    fbi = framebuffer_alloc(sizeof(struct myfb_par), &pdev->dev);
    if (!fbi)
        return -ENOMEM;
    par = fbi->par;

    /* 2. 计算显存大小：1920x1080x32bpp = 8MB */
    mem_size = 1920 * 1080 * 4;

    /* 3. 分配 DMA 连续内存（写合并模式，提高 CPU 写入性能） */
    screen_base = dma_alloc_writecombine(&pdev->dev, mem_size,
                                         &dma_handle, GFP_KERNEL);
    if (!screen_base) {
        framebuffer_release(fbi);
        return -ENOMEM;
    }

    /* 4. 填充 fb_fix_screeninfo */
    fbi->fix.smem_start = dma_handle;   /* 显存物理地址 */
    fbi->fix.smem_len   = mem_size;     /* 显存大小 */
    fbi->screen_base    = screen_base;  /* CPU 虚拟地址 */

    /* 5. 填充 fb_var_screeninfo */
    fbi->var.xres           = 1920;
    fbi->var.yres           = 1080;
    fbi->var.bits_per_pixel = 32;
    fbi->var.xres_virtual   = 1920;
    fbi->var.yres_virtual   = 1080;

    /* 6. 设置 fb_ops（包含 fb_mmap 回调） */
    fbi->fbops = &myfb_ops;

    /* 7. 注册 Framebuffer 设备 */
    if (register_framebuffer(fbi) < 0) {
        dma_free_writecombine(&pdev->dev, mem_size,
                              screen_base, dma_handle);
        framebuffer_release(fbi);
        return -EINVAL;
    }

    dev_info(&pdev->dev, "Framebuffer registered: %dx%d %dbpp\n",
             fbi->var.xres, fbi->var.yres, fbi->var.bits_per_pixel);
    return 0;
}