4. fbdev 关键数据结构：驱动与应用的契约

在 Linux 帧缓冲（fbdev）驱动中，数据结构是连接硬件、内核与用户空间的桥梁。理解 struct fb_info、struct fb_var_screeninfo、struct fb_fix_screeninfo 和 struct fb_cmap 这四个核心结构体，是掌握 fbdev 驱动模型的关键。它们分别承载了设备实例、可变参数、固定参数和颜色映射表的信息，构成了帧缓冲驱动的“四梁八柱”。

4.1 struct fb_info：帧缓冲设备的核心实例

struct fb_info 是 fbdev 驱动中最重要的数据结构，它代表一个帧缓冲设备实例。每个注册到系统的帧缓冲设备（如 /dev/fb0）都对应一个 struct fb_info 结构体。它包含了设备的所有状态信息、操作函数指针、以及指向其他关键数据结构的指针。

struct fb_info {
    struct fb_var_screeninfo var;   /* 可变参数：分辨率、位深、时序 */
    struct fb_fix_screeninfo fix;   /* 固定参数：内存起始地址、步长 */
    struct fb_cmap cmap;            /* 颜色映射表 */
    struct fb_ops *fbops;           /* 驱动操作函数集 */
    struct device *device;          /* 关联的设备结构体 */
    struct fb_pixmap pixmap;        /* 像素图辅助结构 */
    struct fb_pixmap sprite;        /* 硬件光标辅助结构 */
    struct fb_videomode *mode;      /* 支持的视频模式列表 */
    char __iomem *screen_base;      /* 帧缓冲内存的虚拟地址 */
    unsigned long screen_size;      /* 帧缓冲内存的大小（字节） */
    void *par;                      /* 驱动私有数据指针 */
    /* ... 其他字段 */
};

从性能优化角度看，screen_base 和 screen_size 是直接操作显存的关键。在嵌入式系统中，screen_base 通常指向一个预分配的、连续物理内存的虚拟映射。驱动开发者应确保该内存的访问对齐，并考虑使用 dma_alloc_coherent 等接口来避免缓存一致性问题。

4.2 struct fb_var_screeninfo：可变显示参数

struct fb_var_screeninfo 描述了显示设备的可变参数，这些参数通常可以在运行时通过 FBIOPUT_VSCREENINFO ioctl 进行修改。它包含了分辨率、像素格式、时序参数等关键信息。用户空间的应用程序（如 fbset）通过读写该结构体来配置显示模式。

struct fb_var_screeninfo {
    __u32 xres;           /* 可见分辨率：水平像素数 */
    __u32 yres;           /* 可见分辨率：垂直像素数 */
    __u32 xres_virtual;   /* 虚拟分辨率：水平像素数（可大于 xres） */
    __u32 yres_virtual;   /* 虚拟分辨率：垂直像素数（可大于 yres） */
    __u32 xoffset;        /* 虚拟到可见的偏移：水平 */
    __u32 yoffset;        /* 虚拟到可见的偏移：垂直 */
    __u32 bits_per_pixel; /* 每像素位数（bpp） */
    __u32 grayscale;      /* 非零表示灰度设备 */
    struct fb_bitfield red;   /* 红色通道位域 */
    struct fb_bitfield green; /* 绿色通道位域 */
    struct fb_bitfield blue;  /* 蓝色通道位域 */
    struct fb_bitfield transp;/* 透明度通道位域 */
    __u32 pixclock;       /* 像素时钟（皮秒） */
    __u32 left_margin;    /* 行同步前沿 */
    __u32 right_margin;   /* 行同步后沿 */
    __u32 upper_margin;   /* 帧同步前沿 */
    __u32 lower_margin;   /* 帧同步后沿 */
    __u32 hsync_len;      /* 行同步脉冲长度 */
    __u32 vsync_len;      /* 帧同步脉冲长度 */
    __u32 sync;           /* 同步信号极性 */
    __u32 vmode;          /* 显示模式（隔行/逐行） */
    __u32 rotate;         /* 旋转角度 */
    /* ... 其他字段 */
};

下表列出了可变参数中与性能密切相关的字段及其影响：

4.3 struct fb_fix_screeninfo：固定显示参数

struct fb_fix_screeninfo 描述了显示设备的固定参数，这些参数在设备初始化后通常不会改变。它包含了帧缓冲内存的物理地址、内存大小、行步长（line length）等信息。用户空间通过 FBIOGET_FSCREENINFO ioctl 获取这些信息，用于 mmap 操作。

struct fb_fix_screeninfo {
    char id[16];            /* 设备标识字符串，如 "DISP3 BG" */
    unsigned long smem_start; /* 帧缓冲内存的物理起始地址 */
    __u32 smem_len;         /* 帧缓冲内存的总长度（字节） */
    __u32 type;             /* 显示类型：FB_TYPE_PACKED_PIXELS 等 */
    __u32 type_aux;         /* 辅助类型 */
    __u32 visual;           /* 视觉类型：真彩色、伪彩色、直接彩色等 */
    __u16 xpanstep;         /* 水平 pan 步长（像素） */
    __u16 ypanstep;         /* 垂直 pan 步长（像素） */
    __u16 ywrapstep;        /* 垂直 wrap 步长 */
    __u32 line_length;      /* 一行像素占用的字节数（步长） */
    unsigned long mmio_start;/* 内存映射 I/O 起始地址 */
    __u32 mmio_len;         /* 内存映射 I/O 长度 */
    __u32 accel;            /* 硬件加速类型 */
    __u16 capabilities;     /* 设备能力标志 */
    /* ... 其他字段 */
};

下表对比了 fb_var_screeninfo 和 fb_fix_screeninfo 的核心差异：

4.4 struct fb_cmap：颜色映射表

struct fb_cmap 用于管理颜色映射表（Color Map），在伪彩色（Pseudo Color）和直接彩色（Direct Color）模式下至关重要。它定义了从颜色索引到实际 RGB 值的映射关系。在真彩色模式下，该结构体通常不被使用，但驱动仍需提供支持。

struct fb_cmap {
    __u32 start;    /* 起始索引 */
    __u32 len;      /* 颜色表项数量 */
    __u16 *red;     /* 红色分量数组 */
    __u16 *green;   /* 绿色分量数组 */
    __u16 *blue;    /* 蓝色分量数组 */
    __u16 *transp;  /* 透明度分量数组（可选） */
};

下表总结了四种视觉类型与 fb_cmap 的关系：

4.5 数据结构关系总结

四个核心数据结构在 fbdev 驱动中协同工作，构成了完整的帧缓冲管理框架。它们之间的关系可以概括为：

• struct fb_info 是“总指挥”，包含所有其他结构体的实例或指针。
• struct fb_var_screeninfo 是“配置员”，管理运行时可变的显示参数。
• struct fb_fix_screeninfo 是“档案员”，记录设备固定的硬件特性。
• struct fb_cmap 是“翻译官”，在伪彩色模式下将索引转换为颜色值。

从性能优化角度看，驱动开发者应重点关注：

1. 减少 ioctl 调用次数：批量更新参数，避免频繁触发模式切换。
2. 优化内存访问：确保 line_length 对齐，使用 dma_alloc_coherent 分配显存。
3. 利用硬件特性：优先使用硬件 pan 和硬件 LUT，减少 CPU 负载。
4. 选择合适视觉类型：在性能敏感场景下，优先使用真彩色模式。