📚 课程目录第1章 Framebuffer基础概念

1. Framebuffer 基础概念

1.1 什么是 Framebuffer

Framebuffer（帧缓冲）是 Linux 内核提供的一种底层显示抽象层，它将显示设备的显存映射到用户空间的一块连续内存区域。应用程序可以直接向这块内存写入像素数据，内核负责将内存中的内容刷新到物理显示设备上。

从本质上讲，Framebuffer 是一块包含完整一帧图像数据的缓冲区，每个像素点对应内存中的若干字节（取决于色深和像素格式）。用户程序只需按照约定的像素格式填充这块内存，即可在屏幕上看到对应的图像。

  核心要点：Framebuffer 是“显存”的软件抽象，让开发者无需关心底层 GPU 或显示控制器的具体操作，通过读写内存即可控制屏幕显示。

1.2 Framebuffer 在 Linux 图形栈中的位置

Linux 图形系统采用分层架构，Framebuffer 位于内核空间与用户空间的交界处，是图形栈中最基础的显示接口层。下表展示了各层的关系：

层次	组件	说明
应用层	Qt / GTK / SDL / 裸机程序	直接操作 /dev/fb0 或通过图形库间接使用
图形库层	DirectFB / libdrm / Mesa	封装 Framebuffer 或 DRM/KMS 接口
系统调用层	ioctl / mmap / write	用户态与内核态交互的通道
内核层	Framebuffer 驱动 (fbdev)	管理显存、显示时序、硬件寄存器
硬件层	LCD 控制器 / HDMI 发送器 / GPU	物理显示设备与接口

下面的 SVG 图展示了 Framebuffer 在 Linux 图形栈中的精确位置：

注意：在较新的嵌入式 Linux 系统中，DRM/KMS 逐渐取代传统 fbdev 成为主流显示框架。但 Framebuffer 接口因其简单、直接、兼容性好的特点，在低端嵌入式设备和快速原型开发中仍然广泛使用。

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

在 Linux 系统中，Framebuffer 以字符设备文件的形式暴露给用户空间，通常位于 /dev/fb0（主设备号 29，次设备号 0）。系统中有多个显示设备时，依次编号为 /dev/fb0、/dev/fb1……

设备文件是用户程序与 Framebuffer 驱动交互的唯一入口，通过标准的文件操作接口即可完成所有显示控制：

操作	系统调用	作用
打开设备	`open("/dev/fb0", O_RDWR)`	获取设备文件描述符
获取信息	`ioctl(fd, FBIOGET_VSCREENINFO, &vinfo)`	读取屏幕分辨率、色深、像素格式等参数
设置参数	`ioctl(fd, FBIOPUT_VSCREENINFO, &vinfo)`	修改显示模式（分辨率、刷新率等）
映射显存	`mmap(NULL, size, PROT_READ\|PROT_WRITE, MAP_SHARED, fd, 0)`	将内核显存映射到用户空间地址
直接写入	`write(fd, buf, count)`	向显存写入数据（效率低于 mmap）
关闭设备	`close(fd)`	释放文件描述符

下面的 SVG 图展示了用户程序通过 /dev/fb0 与内核 Framebuffer 驱动的交互流程：

1.4 关键数据结构

Framebuffer 驱动使用 fb_info 结构体管理所有显示信息，用户程序通过 ioctl 获取的 fb_var_screeninfo 和 fb_fix_screeninfo 是其核心子结构：

结构体	关键字段	说明
`fb_var_screeninfo`	`xres`, `yres`, `bits_per_pixel`	可变信息：分辨率、色深、时序参数
`fb_fix_screeninfo`	`smem_start`, `smem_len`, `line_length`	固定信息：显存物理地址、大小、一行的字节数
`fb_info`	`fbops`, `screen_base`, `par`	驱动核心结构，包含操作函数表和私有数据

常见误区：初学者常误以为 /dev/fb0 是一个普通文件，直接使用 read()/write() 逐像素操作。实际上，mmap() 映射显存才是高效操作方式，write() 仅适用于小数据量或调试场景。

1.5 检查系统 Framebuffer 设备

在嵌入式开发板上，可以通过以下命令快速确认 Framebuffer 设备是否存在及其参数：

# 查看 Framebuffer 设备列表
ls -l /dev/fb*

# 查看 Framebuffer 详细信息（需要 fbset 工具）
fbset -i

# 或直接读取 sysfs 信息
cat /sys/class/graphics/fb0/virtual_size
cat /sys/class/graphics/fb0/bits_per_pixel
cat /sys/class/graphics/fb0/stride

典型的输出示例：

# fbset -i 输出示例

mode "1024x768-60"
    # D: 65.000 MHz, H: 48.363 kHz, V: 60.004 Hz
    geometry 1024 768 1024 768 32
    timings 15384 160 24 29 3 136 6
    accel true
    rgba 8/16,8/8,8/0,0/0
endmode

Frame buffer device information:
    Name        : mxcfb
    Address     : 0x8e000000
    Size        : 3145728
    Type        : PACKED PIXELS
    Visual      : TRUECOLOR

调试提示：如果 /dev/fb0 不存在，可能是内核未开启 CONFIG_FB 支持，或显示驱动未正确加载。使用 dmesg | grep fb 查看内核启动时的 Framebuffer 初始化信息。