4. Framebuffer 核心数据结构详解

在嵌入式 Linux 系统中，Framebuffer 设备通过 /dev/fbX 暴露给用户空间。应用程序通过 ioctl() 系统调用获取或设置显示参数，这些参数封装在三个核心数据结构中：struct fb_var_screeninfo（可变信息）、struct fb_fix_screeninfo（固定信息）和 struct fb_bitfield（位域描述）。理解这三个结构体是操作 Framebuffer 的基础。

4.1 struct fb_var_screeninfo：可变显示参数

该结构体描述应用程序可以动态修改的显示参数，包括分辨率、像素格式、刷新率等。每次切换显示模式或调整图层大小时，都需要操作此结构体。

4.2 struct fb_fix_screeninfo：固定显示参数

该结构体描述硬件固定的参数，在设备初始化后不再改变。应用程序通过它获取帧缓冲区的物理地址、长度和行字节对齐信息。

4.3 struct fb_bitfield：颜色通道位域描述

该结构体描述每个颜色通道在像素数据中的位偏移和宽度。对于 TrueColor 模式，应用程序需要根据位域信息将 RGB 值编码到像素中。

struct fb_bitfield {
    __u32 offset;   /* 通道在像素中的起始位偏移 */
    __u32 length;   /* 通道占用的位数 */
    __u32 msb_right;/* 0 表示 MSB 在左侧，非 0 表示 MSB 在右侧 */
};

例如，常见的 RGB565 格式：红色 5 位（偏移 11）、绿色 6 位（偏移 5）、蓝色 5 位（偏移 0）。

4.4 数据结构关系与内存映射流程

下图展示了三个结构体在 Framebuffer 初始化与操作中的协作关系：

4.5 典型操作流程代码

以下代码展示如何获取并验证三个结构体的关键字段：

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

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

    struct fb_var_screeninfo var;
    struct fb_fix_screeninfo fix;

    // 获取可变信息
    if (ioctl(fbfd, FBIOGET_VSCREENINFO, &var)) {
        perror("FBIOGET_VSCREENINFO");
        close(fbfd);
        return -1;
    }

    // 获取固定信息
    if (ioctl(fbfd, FBIOGET_FSCREENINFO, &fix)) {
        perror("FBIOGET_FSCREENINFO");
        close(fbfd);
        return -1;
    }

    printf("分辨率: %dx%d, 位深: %d\n",
           var.xres, var.yres, var.bits_per_pixel);
    printf("行字节: %d, 总长度: %d\n",
           fix.line_length, fix.smem_len);
    printf("R: offset=%d len=%d, G: offset=%d len=%d, B: offset=%d len=%d\n",
           var.red.offset, var.red.length,
           var.green.offset, var.green.length,
           var.blue.offset, var.blue.length);

    // 计算实际像素行字节
    int expected_line = var.xres * (var.bits_per_pixel / 8);
    if (fix.line_length != expected_line) {
        printf("注意：硬件对齐，line_length=%d, 理论值=%d\n",
               fix.line_length, expected_line);
    }

    // 映射帧缓冲
    size_t screensize = var.yres_virtual * fix.line_length;
    char *fbp = (char *)mmap(NULL, screensize,
                             PROT_READ | PROT_WRITE,
                             MAP_SHARED, fbfd, 0);
    if (fbp == MAP_FAILED) {
        perror("mmap");
        close(fbfd);
        return -1;
    }

    // 使用 fbp 进行像素操作...

    munmap(fbp, screensize);
    close(fbfd);
    return 0;
}

4.6 常见像素格式与位域配置对照

4.7 结构体差异对比总结

下表从多个维度对比三个结构体的核心差异：