2、帧缓冲设备信息获取：使用 ioctl FBIOGET_FSCREENINFO 获取固定屏幕信息

在嵌入式 Linux 帧缓冲驱动开发与调试中，获取设备能力信息是第一步。帧缓冲设备通过 ioctl 系统调用向用户空间暴露两类核心信息：固定屏幕信息（struct fb_fix_screeninfo）和可变屏幕信息（struct fb_var_screeninfo）。本章聚焦于前者——固定屏幕信息，它描述了帧缓冲设备在硬件层面不可动态改变的属性。

2.1 固定屏幕信息结构体解析

struct fb_fix_screeninfo 定义在 linux/fb.h 头文件中，是帧缓冲设备与应用程序之间的硬件能力契约。该结构体在设备打开后即可通过 FBIOGET_FSCREENINFO 命令获取，且在整个设备生命周期内保持不变。

2.2 使用 ioctl FBIOGET_FSCREENINFO 获取信息

获取固定屏幕信息的流程非常简洁：打开设备文件 → 声明结构体变量 → 调用 ioctl → 解析结果。以下代码展示了完整的获取过程：

#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_fix_screeninfo fix_info;

    /* 1. 打开帧缓冲设备 */
    fb_fd = open("/dev/fb0", O_RDWR);
    if (fb_fd < 0) {
        perror("open /dev/fb0 failed");
        return -1;
    }

    /* 2. 获取固定屏幕信息 */
    if (ioctl(fb_fd, FBIOGET_FSCREENINFO, &fix_info) == -1) {
        perror("FBIOGET_FSCREENINFO failed");
        close(fb_fd);
        return -1;
    }

    /* 3. 打印关键信息 */
    printf("Driver ID        : %s\n", fix_info.id);
    printf("Framebuffer phys : 0x%lx\n", fix_info.smem_start);
    printf("Framebuffer size : %u bytes (%.2f MiB)\n",
           fix_info.smem_len,
           fix_info.smem_len / (1024.0 * 1024.0));
    printf("Line length      : %u bytes\n", fix_info.line_length);
    printf("Visual mode      : %u\n", fix_info.visual);
    printf("Acceleration     : %u\n", fix_info.accel);

    close(fb_fd);
    return 0;
}

2.3 固定信息在双缓冲调试中的关键作用

在双缓冲机制中，固定屏幕信息提供了三个对调试至关重要的参数：

• smem_len：决定帧缓冲总容量。双缓冲需要至少 2 × 单帧大小 的空间，若 smem_len 不足，则无法实现硬件双缓冲。
• line_length：用于计算每个缓冲区的起始偏移。例如，对于 1920×1080 分辨率、32bpp 的显示，单帧大小为 line_length × 1080。
• smem_start：物理基地址。在需要与 GPU 或显示控制器共享缓冲区时，必须使用此物理地址进行 DMA 配置。

2.4 固定信息与可变信息的协作关系

固定屏幕信息描述了“硬件能做什么”，而可变屏幕信息（struct fb_var_screeninfo）描述了“当前配置是什么”。两者通过 ioctl 配合使用，构成完整的帧缓冲设备信息视图：

2.5 调试案例：验证双缓冲可行性

在实际调试中，获取固定屏幕信息后应立即验证双缓冲是否可行。以下检查清单可作为调试参考：

2.6 常见错误与调试技巧

• 错误 1：ioctl 返回 EINVAL —— 设备文件不是帧缓冲设备，或内核版本过旧不支持该命令。使用 cat /proc/devices 确认主设备号为 29。
• 错误 2：smem_start 为 0 —— 驱动未正确初始化 DMA 缓冲区。检查内核日志中 dma_alloc_coherent 是否成功。
• 错误 3：line_length 异常大 —— 可能是分辨率设置错误或驱动中 fix.line_length 计算有误。对比 var.xres * var.bits_per_pixel / 8 与 fix.line_length 的差异。