4. struct fb_var_screeninfo 详解：核心时序与分辨率字段配置
struct fb_var_screeninfo 是帧缓冲驱动中描述显示模式可变参数的核心结构体。与固定参数的 struct fb_fix_screeninfo 不同，该结构体中的字段允许在运行时动态修改，从而支持不同分辨率、色彩深度和刷新率的切换。正确配置这些字段是驱动初始化成功的关键步骤之一。
关键认知：
fb_var_screeninfo 不仅定义了画面的“尺寸”和“颜色”，还通过时序参数（如 pixclock、left_margin）精确控制硬件扫描行为。任何字段配置错误都可能导致黑屏、画面偏移或撕裂。
4.1 分辨率与色彩深度字段
以下三个字段直接决定了帧缓冲的像素阵列大小和每个像素占用的位数：
| 字段名 | 类型 | 说明 | 典型值 |
|---|---|---|---|
xres |
__u32 | 屏幕水平方向可见像素数 | 1024, 1920 |
yres |
__u32 | 屏幕垂直方向可见像素行数 | 768, 1080 |
bits_per_pixel |
__u32 | 每个像素占用的位数（bpp） | 16, 24, 32 |
配置要点：
xres和yres必须与显示面板的物理分辨率匹配，否则画面会缩放或超出边界。bits_per_pixel决定帧缓冲中每像素的存储大小，直接影响显存占用和颜色精度。例如，32bpp 下每个像素占用 4 字节。- 驱动中通常通过
fb_alloc_cmap分配颜色映射表，其大小与bits_per_pixel相关：1 << bits_per_pixel。
// 典型配置示例：1024x768 @ 32bpp
info->var.xres = 1024;
info->var.yres = 768;
info->var.bits_per_pixel = 32;4.2 像素时钟与扫描时序字段
显示控制器通过像素时钟（pixclock）驱动每个像素的扫描输出。时序字段定义了每行和每帧中“非可见区域”的宽度，这些区域用于电子枪回扫和同步信号。
| 字段名 | 说明 | 单位 |
|---|---|---|
pixclock |
像素时钟周期，单位为皮秒（ps） | ps |
left_margin |
行同步信号（HSYNC）结束到有效像素开始之间的像素数（水平后沿） | 像素 |
right_margin |
有效像素结束到行同步信号（HSYNC）开始之间的像素数（水平前沿） | 像素 |
upper_margin |
场同步信号（VSYNC）结束到有效行开始之间的行数（垂直后沿） | 行 |
lower_margin |
有效行结束到场同步信号（VSYNC）开始之间的行数（垂直前沿） | 行 |
hsync_len |
行同步脉冲宽度 | 像素 |
vsync_len |
场同步脉冲宽度 | 行 |
常见陷阱：
pixclock 的单位是皮秒（ps），而非纳秒或赫兹。例如，25MHz 像素时钟对应的周期为 40000 ps。许多新手误将频率值直接赋值，导致时钟配置错误。
时序计算关系：
- 水平总像素 =
left_margin+xres+right_margin+hsync_len - 垂直总行数 =
upper_margin+yres+lower_margin+vsync_len - 帧率 = 1 / (水平总像素 × 垂直总行数 ×
pixclock× 10⁻¹²)
4.3 同步极性与其他控制字段
sync 字段用于配置同步信号的极性，vmode 指定扫描模式：
| 字段 | 宏定义 | 含义 |
|---|---|---|
sync |
FB_SYNC_HOR_HIGH_ACT |
行同步信号高电平有效 |
sync |
FB_SYNC_VERT_HIGH_ACT |
场同步信号高电平有效 |
vmode |
FB_VMODE_NONINTERLACED |
逐行扫描（非隔行） |
vmode |
FB_VMODE_INTERLACED |
隔行扫描 |
// 同步极性配置示例
info->var.sync = FB_SYNC_HOR_HIGH_ACT | FB_SYNC_VERT_HIGH_ACT;
info->var.vmode = FB_VMODE_NONINTERLACED;4.4 帧缓冲可变参数配置流程图
下图展示了驱动初始化时 fb_var_screeninfo 的配置流程及其与硬件时序的关系：
4.5 颜色位域配置：RGB 偏移与长度
对于真彩色模式（如 16bpp、32bpp），必须配置 fb_bitfield 结构体数组 red、green、blue 和 transp（透明度），以描述每个颜色分量在像素数据中的位偏移和位长度。
| 字段 | 说明 |
|---|---|
offset |
该颜色分量在像素值中的起始位位置（从 LSB 开始计数） |
length |
该颜色分量占用的位数 |
msb_right |
MSB 对齐标志，通常设置为 0 |
// 32bpp RGBA 8888 位域配置示例
info->var.red.offset = 16; // R 位于 bit[23:16]
info->var.red.length = 8;
info->var.green.offset = 8; // G 位于 bit[15:8]
info->var.green.length = 8;
info->var.blue.offset = 0; // B 位于 bit[7:0]
info->var.blue.length = 8;
info->var.transp.offset = 24; // A 位于 bit[31:24]
info->var.transp.length = 8;
调试建议： 如果用户空间应用程序显示颜色异常（如红蓝互换），首先检查
red、green、blue 的 offset 和 length 是否与硬件像素格式一致。常见错误是将 RGB 顺序配置为 BGR。
4.6 配置验证清单
在完成 fb_var_screeninfo 配置后，建议逐项核对以下清单：
- 分辨率匹配：
xres和yres是否与面板物理分辨率一致？ - 像素时钟正确性：
pixclock是否在显示控制器支持的范围内？计算出的帧率是否在 50-75 Hz 之间？ - 时序完整性： 所有
left_margin、right_margin、upper_margin、lower_margin、hsync_len、vsync_len是否已赋值？ - 同步极性：
sync字段是否与硬件要求的电平极性一致？ - 位域配置： 对于真彩色模式，
red/green/blue/transp的offset和length是否与硬件像素格式对应？ - 扫描模式：
vmode是否设置为FB_VMODE_NONINTERLACED（除非明确需要隔行扫描）？
通过以上步骤的系统化配置，可以确保 struct fb_var_screeninfo 为帧缓冲驱动提供正确的显示模式参数，为后续的显存映射和画面输出奠定基础。