3. 帧缓冲设备文件：/dev/fb0 设备节点与 ioctl 操作

帧缓冲设备在 Linux 用户空间以字符设备文件的形式暴露，典型路径为 /dev/fb0（主设备号 29，次设备号 0）。应用程序通过标准的 open()、ioctl()、mmap()、close() 系统调用与之交互。本章聚焦设备节点的访问权限、ioctl 获取/设置屏幕参数的核心结构体，以及固定信息与可变信息的差异——这些是后续 mmap 参数配置的元数据基础。

3.1 设备节点与访问控制

/dev/fb0 是系统主帧缓冲设备，通常由 fbmem 内核模块创建。权限默认为 crw-rw----，属主 root:video。用户需加入 video 组或使用 sudo 才能读写。

3.2 ioctl 核心操作：获取与设置屏幕参数

帧缓冲设备通过 ioctl 命令与用户空间交换显示参数。两个最关键的 ioctl 命令是 FBIOGET_VSCREENINFO 和 FBIOPUT_VSCREENINFO，分别用于获取和设置可变屏幕信息（struct fb_var_screeninfo）。

#include <linux/fb.h>
#include <sys/ioctl.h>
#include <fcntl.h>

int fd = open("/dev/fb0", O_RDWR);
if (fd < 0) { /* 错误处理 */ }

struct fb_var_screeninfo var;
// 获取当前可变信息
if (ioctl(fd, FBIOGET_VSCREENINFO, &var) == -1) {
    perror("FBIOGET_VSCREENINFO");
    close(fd);
    return -1;
}

// 修改分辨率（示例：设置为 1024x768，32bpp）
var.xres = 1024;
var.yres = 768;
var.bits_per_pixel = 32;

// 设置新的可变信息
if (ioctl(fd, FBIOPUT_VSCREENINFO, &var) == -1) {
    perror("FBIOPUT_VSCREENINFO");
    close(fd);
    return -1;
}

3.3 固定信息 vs 可变信息

帧缓冲设备提供两套信息结构体：struct fb_fix_screeninfo（固定信息）和 struct fb_var_screeninfo（可变信息）。固定信息描述硬件不可变属性，可变信息描述可动态调整的显示参数。

3.4 可变信息关键字段详解

struct fb_var_screeninfo 包含数十个字段，以下是与 mmap 参数配置最相关的核心字段：

3.5 固定信息关键字段详解

struct fb_fix_screeninfo 提供硬件层面的固定参数，对 mmap 物理地址映射至关重要：

3.6 信息获取与 mmap 参数推导流程

下图展示了从打开设备到完成 mmap 映射的完整信息流：

3.7 常见陷阱与最佳实践

• 陷阱1： 使用 smem_len 作为 mmap 大小，但虚拟分辨率大于实际分辨率时，映射区域可能无法覆盖全部显存。应始终使用 var.xres_virtual * var.yres_virtual * (var.bits_per_pixel / 8)。
• 陷阱2： FBIOPUT_VSCREENINFO 后未重新获取 fb_fix_screeninfo，导致 line_length 或 smem_start 失效。内核可能因对齐要求调整这些值。
• 陷阱3： 多显示器系统中 /dev/fb0 可能对应主显示器，/dev/fb1 对应副显示器。mmap 前需确认目标设备。
• 最佳实践： 每次 FBIOPUT_VSCREENINFO 后，立即调用 FBIOGET_VSCREENINFO 和 FBIOGET_FSCREENINFO 读取实际生效值，再计算 mmap 参数。