3. 帧缓冲可变参数获取：使用 FBIOGET_VSCREENINFO 获取可变屏幕信息

在嵌入式 Linux 帧缓冲驱动开发中，可变屏幕信息（Variable Screen Information） 描述了显示设备当前可动态调整的参数，包括分辨率、像素格式、行间距、刷新率等。与固定参数不同，这些参数可以在运行时通过 ioctl 系统调用进行查询和修改。本节将深入讲解如何使用 FBIOGET_VSCREENINFO 命令获取 struct fb_var_screeninfo 结构体，并解析其关键字段。

3.1 struct fb_var_screeninfo 结构体解析

struct fb_var_screeninfo 是 Linux 内核定义在 linux/fb.h 中的核心数据结构，它包含了帧缓冲设备所有可变的显示参数。下表列出了最常用的字段及其含义：

RGB 位域子结构（struct fb_bitfield）：

3.2 使用 FBIOGET_VSCREENINFO 获取参数

FBIOGET_VSCREENINFO 是 Linux 帧缓冲子系统提供的标准 ioctl 命令，用于从驱动中读取当前的 struct fb_var_screeninfo。其调用方式如下：

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

int main(void) {
    int fb_fd;
    struct fb_var_screeninfo var_info;

    // 1. 打开帧缓冲设备
    fb_fd = open("/dev/fb0", O_RDWR);
    if (fb_fd == -1) {
        perror("open /dev/fb0");
        exit(EXIT_FAILURE);
    }

    // 2. 使用 FBIOGET_VSCREENINFO 获取可变参数
    if (ioctl(fb_fd, FBIOGET_VSCREENINFO, &var_info) == -1) {
        perror("ioctl FBIOGET_VSCREENINFO");
        close(fb_fd);
        exit(EXIT_FAILURE);
    }

    // 3. 打印关键参数
    printf("=== 帧缓冲可变屏幕信息 ===\n");
    printf("可见分辨率: %u x %u\n", var_info.xres, var_info.yres);
    printf("虚拟分辨率: %u x %u\n", var_info.xres_virtual, var_info.yres_virtual);
    printf("颜色深度: %u bpp\n", var_info.bits_per_pixel);
    printf("像素时钟: %u ps\n", var_info.pixclock);
    printf("RGB 位域:\n");
    printf("  Red:   offset=%u, length=%u\n",
           var_info.red.offset, var_info.red.length);
    printf("  Green: offset=%u, length=%u\n",
           var_info.green.offset, var_info.green.length);
    printf("  Blue:  offset=%u, length=%u\n",
           var_info.blue.offset, var_info.blue.length);
    printf("  Alpha: offset=%u, length=%u\n",
           var_info.transp.offset, var_info.transp.length);
    printf("当前偏移: xoffset=%u, yoffset=%u\n",
           var_info.xoffset, var_info.yoffset);

    close(fb_fd);
    return 0;
}

3.3 可变参数与双缓冲的关系

在双缓冲机制中，struct fb_var_screeninfo 中的以下字段直接决定了缓冲区的布局和切换方式：

• yres_virtual：虚拟屏幕的垂直分辨率。当设置为 2 * yres 时，帧缓冲内存中包含了两个完整的页面（Page 0 和 Page 1）。
• yoffset：当前显示窗口在虚拟屏幕中的垂直偏移。切换缓冲区时，只需修改此值（例如从 0 切换到 yres），即可实现页面翻转。
• xres_virtual 和 xoffset：类似地，用于水平方向的虚拟滚动或双缓冲。

下面的 SVG 图展示了双缓冲模式下虚拟屏幕与可见窗口的关系：

3.4 常见调试场景与避坑指南

3.5 可变参数获取流程总结

以下流程图总结了使用 FBIOGET_VSCREENINFO 获取可变屏幕信息的完整步骤：

3.6 关键字段速查表

在实际调试中，以下字段是最常被查询和修改的，建议熟记：