2. Framebuffer 设备初始化：打开与信息获取

Framebuffer 设备初始化是显示驱动开发的第一步，也是后续所有性能优化与光标叠加操作的基础。本节将详细讲解如何通过标准 Linux 文件 I/O 接口打开 /dev/fb0 设备节点，并获取固定信息（struct fb_fix_screeninfo）与可变信息（struct fb_var_screeninfo），为后续的 mmap 映射与像素操作做好准备。

2.1 设备节点与打开方式

在 Linux 系统中，Framebuffer 设备以字符设备节点的形式暴露给用户空间，通常位于 /dev/fb0、/dev/fb1 等路径。主设备号为 29，次设备号从 0 开始递增。打开设备节点使用标准的 open() 系统调用，必须指定 O_RDWR 标志以同时获得读写权限。

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

int main() {
    int fbfd = -1;
    struct fb_fix_screeninfo finfo;
    struct fb_var_screeninfo vinfo;

    // 1. 打开 Framebuffer 设备
    fbfd = open("/dev/fb0", O_RDWR);
    if (fbfd == -1) {
        perror("Error: cannot open framebuffer device");
        exit(EXIT_FAILURE);
    }
    printf("Framebuffer device /dev/fb0 opened successfully.\n");
    // ... 后续 ioctl 操作 ...
    close(fbfd);
    return 0;
}

2.2 获取固定信息（struct fb_fix_screeninfo）

固定信息描述了 Framebuffer 的硬件固定属性，这些属性在设备生命周期内不会改变。通过 ioctl(fbfd, FBIOGET_FSCREENINFO, &finfo) 获取。核心字段如下表所示：

// 获取固定信息
if (ioctl(fbfd, FBIOGET_FSCREENINFO, &finfo) == -1) {
    perror("Error reading fixed information");
    close(fbfd);
    exit(EXIT_FAILURE);
}

printf("Driver: %s\n", finfo.id);
printf("Framebuffer physical address: 0x%lx\n", finfo.smem_start);
printf("Framebuffer length: %u bytes\n", finfo.smem_len);
printf("Line length: %u bytes\n", finfo.line_length);

2.3 获取可变信息（struct fb_var_screeninfo）

可变信息描述了当前显示模式的可调参数，包括分辨率、颜色深度、时序等。通过 ioctl(fbfd, FBIOGET_VSCREENINFO, &vinfo) 获取。核心字段如下：

// 获取可变信息
if (ioctl(fbfd, FBIOGET_VSCREENINFO, &vinfo) == -1) {
    perror("Error reading variable information");
    close(fbfd);
    exit(EXIT_FAILURE);
}

printf("Resolution: %ux%u, %u bpp\n",
       vinfo.xres, vinfo.yres, vinfo.bits_per_pixel);
printf("Virtual resolution: %ux%u\n",
       vinfo.xres_virtual, vinfo.yres_virtual);
printf("Red: offset=%u, length=%u\n",
       vinfo.red.offset, vinfo.red.length);
printf("Green: offset=%u, length=%u\n",
       vinfo.green.offset, vinfo.green.length);
printf("Blue: offset=%u, length=%u\n",
       vinfo.blue.offset, vinfo.blue.length);

2.4 初始化流程与信息依赖关系

下图展示了 Framebuffer 设备初始化的完整流程，以及固定信息与可变信息在后续 mmap 映射和像素操作中的关键作用：

2.5 常见错误与调试建议

• 权限拒绝（Permission denied）： 确保运行程序的用户属于 video 组，或使用 sudo 执行。可通过 ls -l /dev/fb0 检查权限。
• 设备不存在（No such file or directory）： 检查内核是否加载了 Framebuffer 驱动（如 modprobe fbdev），或确认设备节点路径是否正确。
• ioctl 调用失败： 最常见原因是文件描述符无效或设备未正确打开。使用 perror() 输出具体错误码。
• 显存长度异常： 如果 smem_len 为 0 或远小于预期，可能是驱动未正确初始化显存，或分辨率设置过高导致分配失败。

2.6 完整初始化代码示例

以下代码整合了打开设备、获取固定信息和可变信息的完整流程，并进行了必要的错误处理：

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

int main() {
    int fbfd = -1;
    struct fb_fix_screeninfo finfo;
    struct fb_var_screeninfo vinfo;
    char *fbp = NULL;

    // 1. 打开设备
    fbfd = open("/dev/fb0", O_RDWR);
    if (fbfd == -1) {
        perror("Error: cannot open framebuffer device");
        return 1;
    }
    printf("Device opened.\n");

    // 2. 获取固定信息
    if (ioctl(fbfd, FBIOGET_FSCREENINFO, &finfo)) {
        perror("Error reading fixed info");
        close(fbfd);
        return 1;
    }

    // 3. 获取可变信息
    if (ioctl(fbfd, FBIOGET_VSCREENINFO, &vinfo)) {
        perror("Error reading variable info");
        close(fbfd);
        return 1;
    }

    // 4. 打印关键信息
    printf("Resolution: %ux%u, %u bpp\n",
           vinfo.xres, vinfo.yres, vinfo.bits_per_pixel);
    printf("Framebuffer size: %u bytes\n", finfo.smem_len);
    printf("Line length: %u bytes\n", finfo.line_length);

    // 5. mmap 映射（后续章节详细讲解）
    fbp = (char *)mmap(0, finfo.smem_len,
                       PROT_READ | PROT_WRITE,
                       MAP_SHARED, fbfd, 0);
    if (fbp == MAP_FAILED) {
        perror("Error: mmap failed");
        close(fbfd);
        return 1;
    }

    // 6. 清理
    munmap(fbp, finfo.smem_len);
    close(fbfd);
    printf("Framebuffer initialization complete.\n");
    return 0;
}

2.7 初始化检查清单