📚 课程目录第1章 Framebuffer概述

1. Framebuffer 概述

Framebuffer（帧缓冲）是 Linux 内核提供的一种底层图形显示接口，它允许用户空间程序直接向显示缓冲区写入像素数据，从而在屏幕上呈现图像。对于嵌入式 Linux 开发者而言，理解 Framebuffer 是掌握图形系统底层原理的第一步。

1.1 什么是 Framebuffer

Framebuffer 本质上是一块内存区域，它映射了显示设备的像素阵列。应用程序通过向这块内存写入数据，即可控制屏幕上每个像素的颜色和亮度。与高级图形库（如 GTK、Qt）不同，Framebuffer 不提供窗口管理、事件处理或硬件加速——它只做一件事：把内存中的像素数据推送到显示器。

  核心概念：Framebuffer = 显示内存的抽象层。它屏蔽了底层显示控制器的差异，让开发者通过统一的读写操作控制屏幕。

Framebuffer 的工作流程可以概括为三个步骤：

打开设备：通过文件 I/O 操作打开 /dev/fb0 设备文件。
映射内存：使用 mmap() 系统调用将设备内存映射到用户空间。
写入像素：直接向映射后的内存地址写入像素数据，屏幕即时更新。

1.2 Framebuffer 在 Linux 系统中的位置

在 Linux 图形栈中，Framebuffer 位于内核空间与用户空间的交界处，是图形子系统的最底层接口之一。下图展示了它在完整图形栈中的层级关系：

从上图可以看出，Framebuffer 处于内核层，它直接与显示硬件交互，向上提供统一的 /dev/fb0 接口。在嵌入式系统中，Framebuffer 是轻量级图形方案的首选，因为它：

无需 X Server：不依赖 X Window 系统，节省内存和 CPU 资源。
直接内存操作：通过 mmap 直接读写显存，延迟极低。
硬件无关性：同一套代码可在不同 LCD 控制器上运行。

适用场景：嵌入式设备启动 Logo 显示、工业 HMI 界面、游戏机模拟器、轻量级 GUI 系统（如 MiniGUI、emWin）的底层驱动。

1.3 Framebuffer 设备文件 (/dev/fb0)

在 Linux 系统中，Framebuffer 以字符设备文件的形式暴露给用户空间。默认的设备文件路径为 /dev/fb0，如果有多个显示设备，则依次为 /dev/fb1、/dev/fb2 等。

设备文件属性

属性	说明	典型值
主设备号	Framebuffer 设备的主设备号固定为 29	29
次设备号	从 0 开始递增，对应不同显示设备	0, 1, 2, ...
文件权限	通常为 `crw-rw----`，属主 root，组 video	0660
设备类型	字符设备 (c)	c

常用操作命令

开发者可以通过以下命令快速验证 Framebuffer 设备是否正常工作：

# 查看 Framebuffer 设备信息
ls -l /dev/fb*

# 获取设备参数（分辨率、位深等）
fbset -i

# 测试：将屏幕填充为红色（RGB565 格式）
dd if=/dev/zero of=/dev/fb0 bs=1024 count=768

# 查看 Framebuffer 内存映射信息
cat /proc/fb

设备文件操作接口

Framebuffer 设备文件支持标准的文件 I/O 操作，以及特有的 ioctl 命令：

操作	系统调用	用途
打开设备	`open("/dev/fb0", O_RDWR)`	获取文件描述符
获取信息	`ioctl(fd, FBIOGET_VSCREENINFO, &vinfo)`	获取可变屏幕信息（分辨率、位深等）
设置信息	`ioctl(fd, FBIOPUT_VSCREENINFO, &vinfo)`	设置屏幕参数（需 root 权限）
获取固定信息	`ioctl(fd, FBIOGET_FSCREENINFO, &finfo)`	获取固定屏幕信息（显存大小、步长等）
内存映射	`mmap(NULL, size, PROT_READ\|PROT_WRITE, MAP_SHARED, fd, 0)`	将显存映射到用户空间
关闭设备	`close(fd)`	释放文件描述符

注意事项：

/dev/fb0 的访问需要 video 组权限，普通用户需加入该组。
使用 FBIOPUT_VSCREENINFO 修改分辨率可能导致系统显示异常，建议在开发板上测试。
mmap 时必须使用 MAP_SHARED 标志，否则写入不会同步到显存。

设备文件结构体

Linux 内核使用 fb_info 结构体管理每个 Framebuffer 设备，其核心字段如下：

struct fb_info {
    struct fb_var_screeninfo var;    // 可变参数：分辨率、位深、时序
    struct fb_fix_screeninfo fix;    // 固定参数：显存地址、步长、行长度
    struct fb_ops *fbops;            // 操作函数集（open/release/ioctl等）
    char __iomem *screen_base;       // 显存基地址（内核虚拟地址）
    unsigned long screen_size;       // 显存总大小（字节）
    struct device *device;           // 关联的设备结构体
};

其中 fb_var_screeninfo 和 fb_fix_screeninfo 是用户空间通过 ioctl 获取的核心数据结构：

结构体	关键字段	说明
`fb_var_screeninfo`	`xres`, `yres`	可见分辨率（宽度 x 高度，像素）
	`bits_per_pixel`	每个像素的位数（16/24/32）
	`red`, `green`, `blue`	各颜色分量的位偏移和长度
`fb_fix_screeninfo`	`smem_start`	显存的物理起始地址
	`smem_len`	显存总长度（字节）
	`line_length`	一行像素占用的字节数（含对齐填充）

  关键理解：line_length 不一定等于 xres * (bits_per_pixel / 8)。硬件可能为了对齐要求而在每行末尾填充额外字节，因此计算像素偏移时必须使用 line_length。

本章小结

通过本章的学习，你应该掌握了以下核心知识点：

Framebuffer 的本质：一块映射到用户空间的内存区域，用于直接控制屏幕像素。
在 Linux 图形栈中的位置：位于内核层，向上提供 /dev/fb0 接口，向下驱动显示硬件。
设备文件操作：通过 open/ioctl/mmap/close 标准接口与 Framebuffer 交互。
关键数据结构：fb_var_screeninfo 和 fb_fix_screeninfo 包含了屏幕的所有参数信息。