📚 课程目录第1章帧缓冲基础概念

1. 帧缓冲基础概念

1.1 什么是帧缓冲（Framebuffer）

帧缓冲（Framebuffer）是 Linux 内核提供的一种抽象显示设备接口，它将显存区域映射到系统内存空间，使得用户空间程序可以直接通过读写内存来操作屏幕显示内容。帧缓冲的本质是一块连续的物理内存区域，每个像素点对应内存中的若干比特位，通过修改这些比特位的值即可改变屏幕上的颜色和图像。

  核心定义：帧缓冲是内核为显示子系统提供的一块内存缓冲区，它屏蔽了底层 GPU/显示控制器的硬件差异，向上层应用程序提供统一的 mmap() 内存映射接口。

帧缓冲的工作模式可以概括为：

内存映射：用户程序通过 mmap() 将帧缓冲设备的内存映射到用户空间虚拟地址。
像素操作：直接向映射后的内存地址写入像素数据，硬件自动将数据刷新到屏幕。
双缓冲机制：支持 FBIOPAN_DISPLAY 等 ioctl 命令实现页面切换，避免撕裂。

1.2 帧缓冲设备节点（/dev/fb0）

在 Linux 系统中，帧缓冲设备以字符设备节点的形式暴露给用户空间，默认主设备号为 29，次设备号从 0 开始递增。常见的设备节点包括：

设备节点	主设备号	次设备号	典型用途
`/dev/fb0`	29	0	主显示输出（LCD / HDMI）
`/dev/fb1`	29	1	第二显示器 / 扩展屏
`/dev/fb0`（软链接）	—	—	某些系统通过 udev 创建 `/dev/fb` 软链接

调试技巧：使用 ls -l /dev/fb* 查看系统中所有帧缓冲设备节点。如果 /dev/fb0 不存在，说明内核未启用帧缓冲驱动或设备树配置错误，这是黑屏故障的常见原因之一。

帧缓冲设备节点支持的标准操作：

open/close：打开和关闭设备文件。
read/write：直接读写帧缓冲数据（效率较低，通常用于测试）。
mmap：将显存映射到用户空间，实现高性能像素操作。
ioctl：查询/设置显示参数（分辨率、位深、行宽、颜色格式等）。

// 打开帧缓冲设备的典型代码片段
int fd = open("/dev/fb0", O_RDWR);
if (fd < 0) {
    perror("open /dev/fb0 failed");
    return -1;
}

// 获取可变屏幕信息（分辨率、位深等）
struct fb_var_screeninfo vinfo;
if (ioctl(fd, FBIOGET_VSCREENINFO, &vinfo) < 0) {
    perror("ioctl FBIOGET_VSCREENINFO failed");
    close(fd);
    return -1;
}

// 计算帧缓冲大小（字节）
size_t screensize = vinfo.xres * vinfo.yres * (vinfo.bits_per_pixel / 8);

// 映射显存到用户空间
char *fbp = (char *)mmap(0, screensize, PROT_READ | PROT_WRITE,
                         MAP_SHARED, fd, 0);
if (fbp == MAP_FAILED) {
    perror("mmap failed");
    close(fd);
    return -1;
}

// 在屏幕中心画一个红色像素点
int x = vinfo.xres / 2;
int y = vinfo.yres / 2;
long location = (x + vinfo.xoffset) * (vinfo.bits_per_pixel / 8)
              + (y + vinfo.yoffset) * vinfo.line_length;
*(fbp + location + 0) = 0x00;     // 蓝色分量
*(fbp + location + 1) = 0x00;     // 绿色分量
*(fbp + location + 2) = 0xFF;     // 红色分量（RGB565 或 RGB888 视格式而定）

// 清理
munmap(fbp, screensize);
close(fd);

1.3 帧缓冲与显存的关系

帧缓冲与显存（VRAM）之间的关系可以理解为 软件抽象 与 物理硬件 的映射关系。帧缓冲是内核在系统内存中分配的一块缓冲区，而显存是 GPU 或显示控制器专用的物理存储区域。两者之间的数据流动决定了屏幕显示的内容。

对比维度	帧缓冲（Framebuffer）	显存（VRAM）
物理位置	系统内存（DDR RAM）	GPU 专用显存（GDDR / HBM / 嵌入式 SRAM）
访问方式	CPU 通过内存总线直接访问	GPU 通过专用显存控制器访问
容量	通常较小（几 MB 到几十 MB）	较大（几百 MB 到几十 GB）
刷新机制	软件触发刷新（ioctl / 定时器）	硬件自动刷新（扫描输出）
典型场景	嵌入式系统、无 GPU 设备、内核 Console	桌面 GPU、游戏、图形渲染

常见误区：帧缓冲 ≠ 显存。在嵌入式系统中，帧缓冲通常直接位于系统内存中，由 LCD 控制器通过 DMA 从内存中读取数据刷新屏幕。而在独立 GPU 系统中，帧缓冲是内核在系统内存中维护的一份拷贝，需要定期同步到显存中。如果同步机制失效，就会出现花屏或显示内容不更新的故障。

1.4 帧缓冲的像素格式与内存布局

帧缓冲中每个像素的存储格式由 fb_var_screeninfo 结构体中的 bits_per_pixel 和 red/green/blue/transp 字段定义。常见格式包括：

格式名称	位深	像素大小（字节）	颜色分量	典型应用
RGB565	16 bpp	2	R:5 G:6 B:5	嵌入式 LCD、低端设备
RGB888	24 bpp	3	R:8 G:8 B:8	通用桌面显示
ARGB8888	32 bpp	4	A:8 R:8 G:8 B:8	现代 GUI 系统（带透明度）
CLUT8	8 bpp	1	索引色（调色板）	早期 VGA、低分辨率 Console

  内存布局关键参数：
  xres / yres：可见分辨率（像素宽 × 像素高）。
line_length：每行像素占用的字节数（可能包含对齐填充）。
xoffset / yoffset：虚拟显示区域的偏移量（用于双缓冲和滚动）。
bits_per_pixel：每个像素的比特数。

  帧缓冲总大小 = line_length × yres（实际映射时建议使用 fix.smem_len）。

// 通过 ioctl 获取固定信息（包含 line_length 和 smem_len）
struct fb_fix_screeninfo finfo;
if (ioctl(fd, FBIOGET_FSCREENINFO, &finfo) < 0) {
    perror("ioctl FBIOGET_FSCREENINFO failed");
    close(fd);
    return -1;
}
printf("Line length: %d bytes\n", finfo.line_length);
printf("Total memory: %d bytes\n", finfo.smem_len);
printf("Memory start (physical): 0x%lx\n", finfo.smem_start);

1.5 帧缓冲故障排查的起点

理解帧缓冲的基础概念是排查黑屏、花屏和 Console 异常的前提。在实际调试中，以下问题往往与帧缓冲配置直接相关：

黑屏：帧缓冲设备节点不存在、mmap 失败、显存地址映射错误、电源管理未开启。
花屏：像素格式不匹配（RGB565 vs RGB888）、line_length 计算错误、行偏移设置异常。
Console 异常：fbcon 未注册、字体缓冲区冲突、虚拟终端切换时帧缓冲未正确恢复。

快速验证命令：

# 查看帧缓冲设备信息
cat /proc/fb
# 查看当前帧缓冲参数（分辨率、位深）
fbset -i
# 直接读取帧缓冲数据并检查（需要 root）
dd if=/dev/fb0 of=/tmp/fb_dump.bin bs=1024 count=1
hexdump -C /tmp/fb_dump.bin | head -20