4. fbdev 驱动注册流程：register_framebuffer、fbmem.c 核心机制

fbdev 驱动的核心注册入口是 register_framebuffer() 函数，它位于 drivers/video/fbdev/core/fbmem.c 中。该函数负责将开发者填充好的 fb_info 结构体注册到内核帧缓冲子系统，并完成设备文件创建、控制台关联、I/O 内存映射等关键步骤。理解这一流程是掌握 fbdev 驱动开发的基础。

4.1 核心数据结构：struct fb_info

每个 fbdev 驱动实例对应一个 struct fb_info，它包含了帧缓冲设备的所有属性和操作函数指针。驱动开发者需要填充该结构体中的关键字段，然后调用 register_framebuffer() 将其注册到系统。

4.2 register_framebuffer 注册流程

register_framebuffer() 的执行流程可以分为以下 6 个主要阶段：

1. 参数校验与编号分配：检查 fb_info 的有效性，从 registered_fb[] 数组中查找空闲槽位，分配 node 编号。
2. 设备文件创建：调用 device_create() 在 /dev 下创建 fb<node> 字符设备文件，主设备号固定为 FB_MAJOR（29）。
3. 控制台关联：如果内核启用了 CONFIG_FB_CONSOLE，则调用 fbcon_fb_registered() 将帧缓冲设备绑定到虚拟控制台。
4. sysfs 属性创建：在 /sys/class/graphics/fb<node>/ 下创建 stride、virtual_size、bits_per_pixel 等属性文件。
5. I/O 内存映射准备：设置 fb_info 的 fix.smem_start 和 fix.smem_len，为后续 mmap 系统调用做准备。
6. 通知链回调：通过 fb_notifier_call_chain() 通知其他内核模块（如 fbcon）设备已就绪。

int register_framebuffer(struct fb_info *fb_info)
{
    int i, ret;

    // 1. 检查 fb_info 完整性
    if (!fb_info->fbops || !fb_info->screen_base)
        return -EINVAL;

    // 2. 分配空闲节点编号
    for (i = 0; i < FB_MAX; i++) {
        if (!registered_fb[i]) {
            fb_info->node = i;
            break;
        }
    }
    if (i == FB_MAX)
        return -ENOSPC;

    // 3. 创建设备文件 /dev/fb<node>
    fb_info->dev = device_create(fb_class, NULL,
                    MKDEV(FB_MAJOR, i), NULL, "fb%d", i);

    // 4. 注册到全局数组
    registered_fb[i] = fb_info;

    // 5. 通知控制台子系统
    fbcon_fb_registered(fb_info);

    // 6. 触发通知链
    fb_notifier_call_chain(FB_EVENT_FB_REGISTERED, fb_info);

    return 0;
}

4.3 fbmem.c 核心机制

fbmem.c 是 fbdev 子系统的中枢文件，它实现了以下核心机制：

• 设备文件操作接口：提供 fb_open、fb_release、fb_read、fb_write、fb_mmap、fb_ioctl 等标准文件操作函数。
• 全局注册表管理：维护 registered_fb[FB_MAX] 数组，记录所有已注册的 fb_info 指针。
• I/O 控制分发：fb_ioctl 根据命令字（如 FBIOGET_VSCREENINFO、FBIOPUT_VSCREENINFO、FBIOBLANK）调用对应 fb_ops 中的回调函数。
• 内存映射处理：fb_mmap 将内核显存映射到用户空间，用户态程序可以直接读写帧缓冲。
• 通知链机制：提供 fb_register_client() / fb_unregister_client()，允许其他模块监听帧缓冲事件。

4.4 fbdev 驱动注册完整流程图

下图展示了从驱动入口到 register_framebuffer 完成的完整调用链：

4.5 关键数据结构关系图

以下 SVG 展示了 fbmem.c 中核心数据结构之间的关联：

4.6 驱动注册示例代码

以下是一个简化的 fbdev 驱动注册示例，展示了从 probe 到 register_framebuffer 的完整流程：

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. 设置固定屏幕参数
    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. 设置可变屏幕参数
    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;

    // 4. 设置操作函数集
    info->fbops = &myfb_ops;

    // 5. 分配显存（DMA 或 ioremap）
    info->screen_base = dma_alloc_coherent(&pdev->dev,
                        info->fix.smem_len,
                        &info->fix.smem_start,
                        GFP_KERNEL);
    if (!info->screen_base) {
        framebuffer_release(info);
        return -ENOMEM;
    }

    // 6. 注册帧缓冲设备
    ret = register_framebuffer(info);
    if (ret) {
        dma_free_coherent(&pdev->dev, info->fix.smem_len,
                          info->screen_base, info->fix.smem_start);
        framebuffer_release(info);
        return ret;
    }

    platform_set_drvdata(pdev, info);
    return 0;
}

4.7 注册流程中的常见错误