📚 课程目录第2章 Linux帧缓冲子系统架构

2. Linux 帧缓冲子系统架构：fbdev框架层次、fb_ops结构体、fb_info结构体、注册与注销流程

Linux 帧缓冲（fbdev）子系统是内核中负责管理显示帧缓冲的核心模块。它为上层应用程序提供了一个统一的、与硬件无关的显示接口，使得开发者无需关心底层具体的显示控制器细节。本章将深入剖析 fbdev 的框架层次、核心数据结构以及设备的生命周期管理。

2.1 fbdev 框架层次

fbdev 子系统采用分层架构设计，从上到下依次为：用户空间接口层、核心框架层、硬件驱动层。这种分层设计实现了接口与实现的解耦，便于驱动开发和系统维护。

    架构核心思想： 用户空间通过 /dev/fbX 设备节点进行 mmap、ioctl 等操作，核心框架层负责解析这些请求并调用驱动层提供的回调函数，驱动层则直接操作显示控制器硬件。

各层职责清晰，核心框架层（fbmem.c）是连接用户空间与硬件驱动的桥梁。它维护着系统中所有已注册的 fb_info 结构体，并根据用户空间的操作类型，调用对应驱动实现的 fb_ops 回调函数。

2.2 核心数据结构：fb_info

struct fb_info 是 fbdev 子系统中最重要的数据结构，它代表一个帧缓冲设备实例。每个注册到系统的帧缓冲设备都对应一个 fb_info 结构体，其中包含了设备的所有状态信息、操作函数指针以及底层硬件参数。

成员变量	类型	描述
`fbops`	`struct fb_ops *`	指向硬件操作函数集的指针，驱动必须实现
`fb_fix_screeninfo`	`struct fb_fix_screeninfo`	固定屏幕信息，如显存物理地址、长度、行宽等
`fb_var_screeninfo`	`struct fb_var_screeninfo`	可变屏幕信息，如分辨率、位深、时序参数等
`screen_base`	`char __iomem *`	显存在内核空间的虚拟基地址
`screen_size`	`unsigned long`	显存大小（字节）
`device`	`struct device *`	关联的 Linux 设备模型结构体
`par`	`void *`	驱动私有数据指针，用于存放硬件特定信息
`state`	`int`	设备状态标志（如是否挂起）

实战要点： par 成员是驱动开发者最常用的扩展点。通常将自定义的硬件控制结构体（如寄存器基址、时钟句柄、GPIO 描述符等）通过 par 指针与 fb_info 关联，在 fb_ops 回调中通过 container_of 或直接转换获取。

2.3 核心数据结构：fb_ops

struct fb_ops 定义了帧缓冲设备需要实现的操作函数集。驱动开发者通过填充这个结构体，向核心框架层提供硬件访问能力。核心框架层在接收到用户空间的请求后，会调用对应的回调函数。

以下是 fb_ops 结构体中部分关键成员的定义及说明：

回调函数	原型	触发时机
`fb_open`	`int (fb_open)(struct fb_info , int user)`	用户空间打开 `/dev/fbX` 时
`fb_release`	`int (fb_release)(struct fb_info , int user)`	用户空间关闭 `/dev/fbX` 时
`fb_set_par`	`int (fb_set_par)(struct fb_info )`	调用 `FBIOPUT_VSCREENINFO` ioctl 时
`fb_blank`	`int (fb_blank)(int blank_mode, struct fb_info )`	调用 `FBIOBLANK` ioctl 时
`fb_pan_display`	`int (fb_pan_display)(struct fb_var_screeninfo , struct fb_info *)`	调用 `FBIOPAN_DISPLAY` ioctl 时
`fb_mmap`	`int (fb_mmap)(struct fb_info , struct vm_area_struct *)`	用户空间调用 `mmap()` 时

驱动开发注意事项： fb_set_par 是驱动中最关键的实现点。当用户空间修改分辨率或位深时，此回调被调用。驱动需要在此函数中重新配置显示控制器的时序寄存器、更新 fb_var_screeninfo 和 fb_fix_screeninfo 中的相关字段，并确保显存缓冲区足够大。如果实现不当，可能导致显示花屏或系统崩溃。

2.4 注册与注销流程

帧缓冲设备的生命周期由注册和注销两个核心操作管理。驱动在探测（probe）阶段注册设备，在移除（remove）阶段注销设备。核心 API 为 register_framebuffer() 和 unregister_framebuffer()。

2.4.1 注册流程

注册一个帧缓冲设备通常遵循以下步骤：

分配 fb_info 结构体： 使用 framebuffer_alloc() 分配并初始化 fb_info，同时分配驱动私有数据空间。
填充固定信息： 设置 fb_fix_screeninfo，包括显存物理地址、长度、行宽、类型等。
填充可变信息： 设置 fb_var_screeninfo 的默认值，如分辨率、位深、像素格式等。
设置 fb_ops： 将驱动实现的回调函数集赋值给 fb_info->fbops。
分配显存： 使用 dma_alloc_coherent() 或 ioremap() 分配/映射显存，并设置 screen_base 和 screen_size。
注册设备： 调用 register_framebuffer() 将设备注册到系统。

2.4.2 注销流程

注销流程是注册的逆过程，确保资源被正确释放：

注销设备： 调用 unregister_framebuffer() 从系统中移除设备，该函数会销毁 /dev/fbX 节点并等待所有用户空间引用关闭。
释放显存： 使用 dma_free_coherent() 或 iounmap() 释放之前分配的显存。
释放 fb_info： 调用 framebuffer_release() 释放 fb_info 结构体及其关联的私有数据。

关键 API 原型：

// 分配 fb_info（size 为私有数据大小）
struct fb_info *framebuffer_alloc(size_t size, struct device *dev);

// 注册帧缓冲设备
int register_framebuffer(struct fb_info *fb_info);

// 注销帧缓冲设备
int unregister_framebuffer(struct fb_info *fb_info);

// 释放 fb_info
void framebuffer_release(struct fb_info *fb_info);

2.4.3 注册与注销对比

阶段	核心函数	主要操作	注意事项
注册	`register_framebuffer()`	分配 fb_info → 填充参数 → 分配显存 → 注册	确保 `fb_ops` 所有必要回调已实现；显存地址必须正确映射
注销	`unregister_framebuffer()`	注销设备 → 释放显存 → 释放 fb_info	必须在进程上下文调用；确保没有用户空间进程正在使用设备

2.5 实战示例：驱动模板代码片段

以下是一个简化的帧缓冲驱动注册与注销模板，展示了核心流程：

#include <linux/fb.h>
#include <linux/platform_device.h>

struct myfb_par {
    void __iomem *regs;
    /* 其他硬件特定成员 */
};

static int myfb_probe(struct platform_device *pdev)
{
    struct fb_info *info;
    struct myfb_par *par;
    int ret;

    /* 1. 分配 fb_info 和私有数据 */
    info = framebuffer_alloc(sizeof(struct myfb_par), &pdev->dev);
    if (!info)
        return -ENOMEM;
    par = info->par;

    /* 2. 填充 fb_fix_screeninfo */
    strcpy(info->fix.id, "myfb");
    info->fix.smem_len = 800 * 600 * 4; /* 800x600x32bpp */
    info->fix.type = FB_TYPE_PACKED_PIXELS;
    info->fix.visual = FB_VISUAL_TRUECOLOR;
    info->fix.line_length = 800 * 4;

    /* 3. 填充 fb_var_screeninfo 默认值 */
    info->var.xres = 800;
    info->var.yres = 600;
    info->var.bits_per_pixel = 32;
    info->var.red.offset = 16;
    info->var.red.length = 8;
    info->var.green.offset = 8;
    info->var.green.length = 8;
    info->var.blue.offset = 0;
    info->var.blue.length = 8;
    info->var.transp.offset = 24;
    info->var.transp.length = 8;

    /* 4. 设置 fb_ops */
    info->fbops = &myfb_ops;

    /* 5. 分配显存 */
    info->screen_base = dma_alloc_coherent(info->device,
                        info->fix.smem_len,
                        (dma_addr_t *)&info->fix.smem_start,
                        GFP_KERNEL);
    if (!info->screen_base) {
        ret = -ENOMEM;
        goto err_release;
    }
    info->screen_size = info->fix.smem_len;

    /* 6. 注册帧缓冲设备 */
    ret = register_framebuffer(info);
    if (ret) {
        dev_err(&pdev->dev, "register_framebuffer failed\n");
        goto err_free_dma;
    }

    platform_set_drvdata(pdev, info);
    return 0;

err_free_dma:
    dma_free_coherent(info->device, info->fix.smem_len,
                      info->screen_base, info->fix.smem_start);
err_release:
    framebuffer_release(info);
    return ret;
}

static int myfb_remove(struct platform_device *pdev)
{
    struct fb_info *info = platform_get_drvdata(pdev);

    unregister_framebuffer(info);
    dma_free_coherent(info->device, info->fix.smem_len,
                      info->screen_base, info->fix.smem_start);
    framebuffer_release(info);
    return 0;
}

调试建议： 在注册成功后，可以通过 cat /proc/fb 查看当前系统已注册的帧缓冲设备列表。使用 fbset -i 命令可以查看指定 /dev/fbX 的详细信息，包括分辨率、位深、显存地址等，这是验证驱动注册是否正确的第一步。

2.6 本章小结

本章详细介绍了 Linux fbdev 子系统的核心架构：

框架层次： 用户空间接口层、核心框架层、硬件驱动层的三层架构设计。
fb_info 结构体： 帧缓冲设备的完整描述，包含固定/可变信息、显存地址、操作函数集和私有数据。
fb_ops 结构体： 驱动需要实现的回调函数集，是核心框架与硬件交互的桥梁。
注册与注销流程： 从分配 fb_info 到注册设备，再到注销和资源释放的完整生命周期管理。