3. 帧缓冲设备节点：/dev/fb0 的创建、mmap 操作、ioctl 控制命令

帧缓冲（FrameBuffer）是 Linux 内核为显示设备提供的最基础、最直接的抽象层。在嵌入式系统中，用户空间程序通过操作 /dev/fb0 设备节点，即可实现对显存的读写与控制，无需关心底层 GPU 或 LCD 控制器的具体寄存器细节。本节将深入剖析 /dev/fb0 的创建过程、内存映射（mmap）机制以及关键的 ioctl 控制命令。

3.1 设备节点 /dev/fb0 的创建与生命周期

/dev/fb0 是帧缓冲设备的主设备号（Major Number）为 29、次设备号（Minor Number）为 0 的字符设备节点。其创建方式分为静态创建与动态创建两种，在嵌入式系统中通常由 udev 或 mdev 在系统启动时自动生成。

3.1.1 内核驱动中的设备注册流程

帧缓冲设备节点的创建始于内核驱动层的 register_framebuffer() 函数。该函数由具体的显示驱动（如 drivers/video/fbdev/ 下的驱动）在探测硬件成功后调用。其核心流程如下：

1. 分配 fb_info 结构体： 驱动为 struct fb_info 分配内存，并填充 var（可变参数）、fix（固定参数）、fbops（操作函数集）等字段。
2. 注册到内核： 调用 register_framebuffer(struct fb_info *fb_info)，该函数将 fb_info 加入全局链表 registered_fb，并分配次设备号。
3. 创建字符设备： 内核自动调用 cdev_add() 创建字符设备，设备号为 MKDEV(FB_MAJOR, minor)。
4. 通知用户空间： 通过 kobject_uevent() 发送 ADD 事件，用户空间的 udev 接收到事件后，根据规则在 /dev/ 下创建 fb0 节点。

3.1.2 设备节点与驱动的对应关系

在双缓冲实现中，通常只使用 /dev/fb0 一个节点，通过切换显存中的缓冲区地址来实现页面翻转，而非打开多个 fb 设备。

3.2 mmap 操作：将显存映射到用户空间

帧缓冲的核心优势在于允许用户空间程序通过 mmap() 系统调用，将内核空间的显存直接映射到进程的虚拟地址空间。这种方式避免了 read()/write() 系统调用的数据拷贝开销，是实现高性能图形渲染的基础。

3.2.1 mmap 的调用原型与参数

#include <sys/mman.h>
#include <fcntl.h>
#include <unistd.h>

int fd = open("/dev/fb0", O_RDWR);
if (fd < 0) {
    perror("open /dev/fb0 failed");
    return -1;
}

/* 获取固定信息以计算映射大小 */
struct fb_fix_screeninfo fix;
ioctl(fd, FBIOGET_FSCREENINFO, &fix);

/* 将显存映射到用户空间 */
void *fb_ptr = mmap(NULL,                 /* 起始地址，由内核选择 */
                    fix.smem_len,         /* 映射长度 = 显存总大小 */
                    PROT_READ | PROT_WRITE, /* 读写权限 */
                    MAP_SHARED,           /* 共享映射，其他进程可见 */
                    fd,                   /* 文件描述符 */
                    0);                   /* 偏移量，从显存起始处开始 */

if (fb_ptr == MAP_FAILED) {
    perror("mmap failed");
    close(fd);
    return -1;
}

/* 现在可以通过 fb_ptr 直接读写显存 */
/* ... 绘图操作 ... */

/* 解除映射 */
munmap(fb_ptr, fix.smem_len);
close(fd);

3.2.2 mmap 在内核中的实现路径

当用户空间调用 mmap() 时，内核会通过以下路径完成映射：

1. VFS 层： 调用文件操作集中的 mmap 方法，对应帧缓冲驱动的 fb_mmap() 函数。
2. fb_mmap() 函数： 该函数位于 drivers/video/fbdev/core/fbmem.c，它会调用 fb_info->fbops->fb_mmap（如果驱动提供了自定义实现），否则使用默认的 fb_default_mmap()。
3. 物理内存映射： 最终通过 remap_pfn_range() 将物理显存页框号（PFN）映射到用户进程的页表，建立虚拟地址到物理地址的映射关系。

3.3 ioctl 控制命令：查询与配置显示参数

ioctl（Input/Output Control）是用户空间与帧缓冲驱动进行控制交互的主要接口。通过不同的命令码，程序可以查询屏幕分辨率、色彩深度、显存布局，以及设置显示参数。帧缓冲驱动定义了丰富的 ioctl 命令，本节重点介绍最常用的几个。

3.3.1 核心 ioctl 命令一览

3.3.2 关键数据结构详解

struct fb_var_screeninfo 是可变参数结构体，用户程序通过修改其字段来配置显示模式：

struct fb_var_screeninfo {
    __u32 xres;           /* 可见分辨率：水平像素数 */
    __u32 yres;           /* 可见分辨率：垂直像素数 */
    __u32 xres_virtual;   /* 虚拟分辨率：水平像素数（≥ xres，用于双缓冲） */
    __u32 yres_virtual;   /* 虚拟分辨率：垂直像素数（≥ yres，用于双缓冲） */
    __u32 xoffset;        /* 显示起始水平偏移（用于 panning） */
    __u32 yoffset;        /* 显示起始垂直偏移（用于 panning） */
    __u32 bits_per_pixel; /* 每像素位数：16、24、32 */
    __u32 pixclock;       /* 像素时钟（皮秒），0 表示使用默认 */
    /* ... 其他时序字段 ... */
};

struct fb_fix_screeninfo 是固定参数结构体，由内核驱动填充，用户程序只能读取：

struct fb_fix_screeninfo {
    char id[16];          /* 驱动标识字符串，如 "s3cfb" */
    unsigned long smem_start; /* 物理显存起始地址 */
    __u32 smem_len;       /* 显存总大小（字节） */
    __u32 type;           /* 显示类型：FB_TYPE_PACKED_PIXELS 等 */
    __u32 visual;         /* 颜色模式：FB_VISUAL_TRUECOLOR 等 */
    __u16 line_length;    /* 一行像素的字节数（行宽） */
    /* ... 其他字段 ... */
};

3.3.3 使用 ioctl 实现页面翻转（Pan Display）

页面翻转（Page Flipping）是双缓冲机制的核心操作。以下代码展示了如何通过 FBIOPAN_DISPLAY 命令在前后缓冲之间切换：

/* 假设已通过 FBIOGET_VSCREENINFO 获取了 var */
struct fb_var_screeninfo var;
ioctl(fd, FBIOGET_VSCREENINFO, &var);

/* 设置虚拟分辨率：高度为可见高度的 2 倍 */
var.yres_virtual = var.yres * 2;

/* 应用设置 */
if (ioctl(fd, FBIOPUT_VSCREENINFO, &var) < 0) {
    perror("FBIOPUT_VSCREENINFO failed");
}

/* 当前显示的是前缓冲（yoffset = 0） */
/* 在后缓冲中绘制新帧（偏移 var.yres * var.line_length） */
draw_to_back_buffer(fb_ptr + var.yres * var.line_length);

/* 等待垂直同步，防止撕裂 */
int dummy = 0;
ioctl(fd, FBIO_WAITFORVSYNC, &dummy);

/* 翻转：设置 yoffset 为 var.yres，显示后缓冲 */
var.yoffset = var.yres;
if (ioctl(fd, FBIOPAN_DISPLAY, &var) < 0) {
    perror("FBIOPAN_DISPLAY failed");
}

/* 现在后缓冲变为前缓冲，前缓冲变为后缓冲 */
/* 下一次绘制应在新的后缓冲（偏移 0）进行 */

3.4 帧缓冲设备操作流程总览

下面的 SVG 图展示了从打开设备节点到完成页面翻转的完整操作流程，以及各步骤中使用的系统调用与 ioctl 命令。

3.5 常见问题与调试技巧

3.6 本章小结