4. 帧缓冲关键数据结构：struct fb_info、struct fb_var_screeninfo、struct fb_fix_screeninfo 详解

在 Linux 帧缓冲驱动架构中，用户空间通过 ioctl 系统调用与内核驱动交互，而内核驱动则通过三个核心数据结构来管理和描述显示硬件。理解 struct fb_info、struct fb_var_screeninfo 和 struct fb_fix_screeninfo 是掌握帧缓冲调试与参数调优的基础。

4.1 数据结构层级关系

这三个结构体在驱动中扮演不同角色：struct fb_info 是帧缓冲设备的顶层抽象，包含设备状态、操作函数指针和两个描述屏幕参数的结构体成员。下图展示了它们之间的组织关系。

4.2 struct fb_info：帧缓冲设备核心

struct fb_info 是帧缓冲驱动的“大脑”，每个注册的帧缓冲设备对应一个 fb_info 实例。它包含设备的所有状态信息、操作函数表以及指向显存和寄存器的指针。

4.3 struct fb_var_screeninfo：可变屏幕参数

该结构体描述用户可调整的显示参数，包括分辨率、色深、时序等。通过 FBIOPUT_VSCREENINFO ioctl 修改后，驱动会重新配置硬件。这也是 fbset 工具主要操作的对象。

4.4 struct fb_fix_screeninfo：固定屏幕参数

该结构体描述由硬件决定的固定属性，用户空间通常只能读取，不能修改。它包含显存物理地址、行长度、显示类型等信息。

4.5 数据结构与用户空间交互流程

用户空间程序（如 fbset）通过 ioctl 系统调用与内核驱动交互，读取或修改上述数据结构。下图展示了典型的交互流程。

4.6 使用 fbset 查看数据结构实例

通过 fbset 命令可以直观地查看当前帧缓冲设备的 var 和 fix 参数。以下是一个实际输出示例：

# fbset -i

mode "1024x768-60"
    # D: 65.003 MHz, H: 48.365 kHz, V: 60.006 Hz
    geometry 1024 768 1024 768 32
    timings 15384 160 24 23 3 136 6
    accel true
    rgba 8/16,8/8,8/0,8/24
endmode

Frame buffer device information:
    Name        : s3c-fb
    Address     : 0xfb200000
    Size        : 3145728
    Type        : PACKED PIXELS
    Visual      : TRUECOLOR
    XPanStep    : 1
    YPanStep    : 1
    YWrapStep   : 0
    LineLength  : 4096
    Accelerator : 0

4.7 数据结构在调试中的关键作用

在帧缓冲调试过程中，这三个数据结构是定位问题的核心入口：

• 显示异常排查： 检查 var.xres 和 var.yres 是否与显示器 EDID 信息匹配；检查 var.pixclock 和时序参数是否在显示器支持范围内。
• 内存访问问题： 检查 fix.smem_len 是否足够容纳帧缓冲区（xres * yres * (bits_per_pixel / 8)）；检查 fix.line_length 是否与预期一致。
• 颜色显示异常： 检查 var.bits_per_pixel 和 var.red/green/blue/transp 位域设置是否正确；检查 fix.visual 是否为 FB_VISUAL_TRUECOLOR。
• 双缓冲调试： 检查 var.xres_virtual 和 var.yres_virtual 是否大于可见分辨率；检查 var.xoffset 和 var.yoffset 的切换是否生效。
• 硬件加速问题： 检查 fix.accel 字段是否指示硬件加速类型；检查 fb_info.fbops 中的加速函数是否被正确调用。