3. 帧缓冲设备注册：register_framebuffer()、unregister_framebuffer()、设备号分配

帧缓冲设备（/dev/fbX）的注册与注销是显示驱动与用户空间交互的桥梁。内核通过 register_framebuffer() 将驱动创建的 fb_info 结构体注册到帧缓冲子系统，并自动分配主次设备号；unregister_framebuffer() 则完成反向清理。本章深入剖析这两个核心 API 的实现机制、设备号分配策略及调用实战要点。

3.1 设备号分配机制

帧缓冲设备的主设备号固定为 29，次设备号从 0 开始递增，每个设备对应一个独立的帧缓冲实例。内核通过 FB_MAJOR 宏定义主设备号，次设备号由帧缓冲核心层在注册时动态分配。

3.2 register_framebuffer() 核心流程

register_framebuffer() 是帧缓冲设备注册的入口函数，定义在 drivers/video/fbdev/core/fbmem.c 中。其执行流程可分为四个阶段：

1. 参数校验：检查 fb_info 指针及关键回调函数（如 fb_open、fb_release）是否为空。
2. 设备号分配：遍历全局帧缓冲设备数组 registered_fb[]，找到第一个空闲槽位，将槽位索引作为次设备号。
3. 设备注册：调用 device_create() 在 sysfs 中创建设备节点，并初始化 fb_info 内部的锁与等待队列。
4. 回调通知：通过 fb_notifier_call_chain() 通知注册到帧缓冲事件链的监听者（如控制台驱动）。

3.3 unregister_framebuffer() 注销流程

设备注销是注册的逆过程，由 unregister_framebuffer() 完成。该函数在驱动卸载或设备热插拔时被调用，执行以下操作：

• 状态检查：确认 fb_info 当前未被用户空间打开（fb_info->count 为 0），若被占用则返回 -EBUSY。
• 通知注销：调用 fb_notifier_call_chain() 发送 FB_EVENT_FB_UNREGISTER 事件，通知控制台等模块清理资源。
• 移除设备：调用 device_destroy() 删除 sysfs 设备节点。
• 释放槽位：将 registered_fb[minor] 置为 NULL，释放次设备号。

3.4 驱动实战代码模板

以下是一个典型的帧缓冲设备注册与注销代码片段，展示 fb_info 的初始化、注册及清理流程：

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

static struct fb_info *my_fb_info;

static int my_fb_probe(struct platform_device *pdev)
{
    int ret;

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

    // 2. 初始化固定和可变参数
    my_fb_info->fix = (struct fb_fix_screeninfo){
        .id          = "my_fb",
        .smem_len    = 800 * 480 * 4,  // 800x480 32bpp
        .type        = FB_TYPE_PACKED_PIXELS,
        .visual      = FB_VISUAL_TRUECOLOR,
        .line_length = 800 * 4,
    };

    my_fb_info->var = (struct fb_var_screeninfo){
        .xres        = 800,
        .yres        = 480,
        .bits_per_pixel = 32,
    };

    // 3. 设置操作回调
    my_fb_info->fbops = &my_fb_ops;
    my_fb_info->screen_base = dma_alloc_coherent(...);
    my_fb_info->screen_size = 800 * 480 * 4;

    // 4. 注册帧缓冲设备
    ret = register_framebuffer(my_fb_info);
    if (ret < 0) {
        dev_err(&pdev->dev, "register_framebuffer failed: %d\n", ret);
        framebuffer_release(my_fb_info);
        return ret;
    }

    dev_info(&pdev->dev, "fb registered as /dev/fb%d\n", my_fb_info->node);
    return 0;
}

static int my_fb_remove(struct platform_device *pdev)
{
    // 1. 注销帧缓冲设备
    unregister_framebuffer(my_fb_info);

    // 2. 释放 DMA 缓冲
    dma_free_coherent(...);

    // 3. 释放 fb_info 结构体
    framebuffer_release(my_fb_info);

    return 0;
}

3.5 设备注册状态查询

驱动开发调试阶段，可通过 /proc/fb 文件查看当前系统中所有已注册的帧缓冲设备信息：

# cat /proc/fb
0 my_fb
1 s3c-fb

每行格式为：次设备号 驱动名称。该文件由帧缓冲核心层自动维护，驱动无需额外操作。

3.6 多设备注册与次设备号管理

当系统存在多个帧缓冲设备时，内核按注册顺序依次分配次设备号。驱动可通过 fb_info->node 字段获取分配后的次设备号，用于日志输出或设备节点命名。

3.7 常见问题与避坑指南

• 重复注册：同一 fb_info 指针不可重复调用 register_framebuffer()，否则内核 panic。应在驱动 probe 中确保只注册一次。
• 设备号耗尽：当系统注册超过 32 个帧缓冲设备时，register_framebuffer() 返回 -ENOSPC。可通过内核配置 CONFIG_FB_MAX 增大上限。
• 注销顺序：必须在 unregister_framebuffer() 之后释放 screen_base 和 cmap，因为注销过程中可能还有控制台操作访问显存。
• 休眠上下文：register_framebuffer() 内部可能调用 device_create() 触发 uevent，因此不能在原子上下文或自旋锁保护区域中调用。