2. fb_info 结构体成员总览：主要字段分类

帧缓冲驱动的核心数据结构是 fb_info，它位于 include/linux/fb.h 中，是驱动与内核帧缓冲层之间的唯一契约。一个完整的 fb_info 实例包含了描述硬件能力、当前显示模式、操作接口以及驱动私有状态的全部信息。本章按功能将其成员划分为四大类：固定信息、可变信息、操作函数 和 私有数据，并逐一说明每类字段的配置要点。

2.1 固定信息（fb_fix_screeninfo）

fb_fix_screeninfo 描述显示控制器的硬件固有属性，这些属性在驱动加载后不会随显示模式改变。驱动初始化时通过 fb_info.fix 字段赋值。

2.2 可变信息（fb_var_screeninfo）

fb_var_screeninfo 描述当前显示模式的可配置参数，包括分辨率、颜色深度、时序等。用户空间通过 FBIOPUT_VSCREENINFO ioctl 修改这些值，驱动需在 fb_ops.fb_set_par() 中响应变化。

2.3 操作函数（fb_ops）

fb_ops 是驱动向内核帧缓冲层注册的函数指针集合，所有与硬件交互的操作都通过这个结构体间接调用。内核帧缓冲层在 ioctl 路径中自动分发请求到对应的回调。

// 最小化 fb_ops 配置示例
static struct fb_ops myfb_ops = {
    .owner          = THIS_MODULE,
    .fb_check_var   = myfb_check_var,
    .fb_set_par     = myfb_set_par,
    .fb_setcolreg   = myfb_setcolreg,
    .fb_fillrect    = cfb_fillrect,    // 使用内核通用实现
    .fb_copyarea    = cfb_copyarea,
    .fb_imageblit   = cfb_imageblit,
};

2.4 私有数据（par / pseudo_palette / screen_base）

私有数据是驱动与硬件之间的上下文通道，帧缓冲层不解析其内容，完全由驱动自主管理。合理组织私有数据可以大幅提高代码可维护性。

// 私有数据结构体典型定义
struct myfb_par {
    void __iomem    *regs;          // 控制寄存器虚拟地址
    unsigned long   regs_phys;      // 控制寄存器物理地址
    unsigned long   regs_size;      // 寄存器空间大小
    int             irq;            // 中断号
    struct clk      *pixel_clk;     // 像素时钟
    struct regulator *power;        // 电源控制
    u32             pseudo_palette[16]; // 调色板缓存
};

2.5 字段配置优先级与常见陷阱

在初始化 fb_info 时，字段之间存在隐式依赖关系。以下列表总结了配置顺序和常见错误：

• 先 fix 后 var：smem_len 必须在设置 xres_virtual * yres_virtual * bpp / 8 之前确定，否则可能超出显存范围。
• screen_base 与 smem_start 一致：如果使用 ioremap() 映射物理显存，screen_base 必须指向映射后的虚拟地址，smem_start 保持物理地址不变。
• pseudo_palette 生命周期：该指针指向的缓存必须在 fb_info 注销前有效。推荐将其嵌入 par 结构体或使用静态数组。
• fbops 不能为 NULL：即使所有回调都使用默认实现，fbops 指针也必须指向一个有效的 fb_ops 实例，且 .owner 必须设置为 THIS_MODULE。
• node 由内核赋值：驱动不要手动修改 node 字段，register_framebuffer() 会自动分配设备号。

2.6 小结