3. fbdev 注册与注销：register_framebuffer() 与 unregister_framebuffer() 的调用流程与内核接口

在 Linux 内核显示子系统中，register_framebuffer() 与 unregister_framebuffer() 是 fbdev 兼容层最核心的两个接口函数。它们负责将帧缓冲设备注册到内核框架，并在驱动卸载时完成资源回收。本章将深入分析这两个函数的调用流程、内核接口交互以及关键数据结构的变化。

3.1 register_framebuffer() 注册流程

register_framebuffer() 函数位于 drivers/video/fbdev/core/fbmem.c，其核心任务是将一个 struct fb_info 实例注册到系统，并创建对应的字符设备节点 /dev/fbX。整个注册流程分为三个阶段：前置检查、设备注册、用户空间通知。

3.2 注册流程关键步骤详解

下表列出了 register_framebuffer() 内部调用的核心子函数及其作用：

3.3 unregister_framebuffer() 注销流程

unregister_framebuffer() 是注册的逆操作，负责从系统中移除帧缓冲设备，释放编号并通知用户空间。其流程与注册对称，但顺序相反。

3.4 注册与注销的内核接口对比

3.5 驱动中的典型调用模式

以下代码展示了 fbdev 驱动中注册与注销的标准实现模式：

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

    // 1. 分配 fb_info 结构体
    info = framebuffer_alloc(0, &pdev->dev);
    if (!info)
        return -ENOMEM;

    // 2. 初始化 fb_info 字段
    info->var = myfb_var;          // 可变参数
    info->fix = myfb_fix;          // 固定参数
    info->fbops = &myfb_ops;      // 操作函数表
    info->screen_base = dma_alloc_coherent(...);
    info->screen_size = MYFB_SIZE;
    fb_alloc_cmap(&info->cmap, 256, 0);

    // 3. 注册帧缓冲设备
    ret = register_framebuffer(info);
    if (ret) {
        dev_err(&pdev->dev, "register_framebuffer failed: %d\n", ret);
        goto err_free_cmap;
    }

    platform_set_drvdata(pdev, info);
    return 0;

err_free_cmap:
    fb_dealloc_cmap(&info->cmap);
err_free_info:
    framebuffer_release(info);
    return ret;
}

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

    // 1. 注销帧缓冲设备
    unregister_framebuffer(info);

    // 2. 清理资源
    fb_dealloc_cmap(&info->cmap);
    dma_free_coherent(info->device, info->screen_size,
                      info->screen_base, info->screen_dma);
    framebuffer_release(info);

    return 0;
}

3.6 全局数据结构与编号管理

内核维护了一个全局数组 registered_fb[FB_MAX] 来管理所有已注册的帧缓冲设备。FB_MAX 默认为 32，意味着系统最多支持 32 个帧缓冲设备。编号分配采用线性扫描策略：

// fbmem.c 中的核心全局变量
struct fb_info *registered_fb[FB_MAX];  // 已注册设备指针数组
int num_registered_fb;                   // 已注册设备数量
struct mutex registration_lock;          // 注册/注销互斥锁

// 编号分配逻辑（简化）
static int fb_find_next_free_index(void)
{
    int i;
    for (i = 0; i < FB_MAX; i++) {
        if (!registered_fb[i])
            return i;
    }
    return -ENOSPC;  // 无可用编号
}

3.7 兼容层迁移注意事项

当从原生 fbdev 驱动迁移到 DRM 兼容层时，register_framebuffer() 和 unregister_framebuffer() 的调用模式需要调整：