4. 帧缓冲操作函数集：struct fb_ops、fb_open、fb_release、fb_read、fb_write

帧缓冲设备驱动通过 struct fb_ops 结构体向内核注册一组标准操作函数，用户空间的 open、release、read、write 系统调用最终会映射到这些函数。理解这组函数集是掌握帧缓冲驱动调试与图层合成的基础。

4.1 struct fb_ops 结构体总览

struct fb_ops 定义在 include/linux/fb.h 中，是帧缓冲驱动的核心接口表。驱动开发者必须实现其中部分或全部回调函数，以控制硬件行为。

4.2 fb_open 与 fb_release：设备生命周期管理

fb_open 在用户进程调用 open("/dev/fb0", ...) 时被触发。典型实现包括：

• 递增设备引用计数，防止驱动卸载时仍有打开句柄。
• 检查文件标志（如 O_RDWR）与硬件权限。
• 初始化每个打开实例的私有数据结构（如图层状态指针）。

fb_release 在 close() 或进程退出时调用，负责：

• 递减引用计数，当计数归零时释放 DMA 缓冲区。
• 恢复硬件默认状态（如关闭叠加层、重置光标位置）。
• 清理内核态分配的临时内存。

// 典型 fb_open 实现片段
static int myfb_open(struct fb_info *info, int user)
{
    struct myfb_par *par = info->par;
    
    if (!try_module_get(info->fbops->owner))
        return -ENODEV;
    
    atomic_inc(&par->open_count);
    dev_dbg(info->device, "fb_open: open_count=%d\n",
            atomic_read(&par->open_count));
    return 0;
}

static int myfb_release(struct fb_info *info, int user)
{
    struct myfb_par *par = info->par;
    
    atomic_dec(&par->open_count);
    module_put(info->fbops->owner);
    dev_dbg(info->device, "fb_release: open_count=%d\n",
            atomic_read(&par->open_count));
    return 0;
}

4.3 fb_read 与 fb_write：像素数据通路

这两个函数提供了最直接的帧缓冲数据访问方式。虽然 mmap 是高性能首选，但 fb_read/fb_write 在以下场景仍然重要：

• 小批量像素更新：如光标、OSD 文字叠加。
• 调试与诊断：通过 dd 命令直接读写帧缓冲设备。
• 非连续内存架构：某些嵌入式平台不支持 mmap，只能通过 read/write 访问。

默认实现（fb_read/fb_write 设为 NULL）由 fbmem.c 中的通用函数 fb_read/fb_write 替代，它们直接操作 info->screen_buffer。驱动开发者可以覆盖这些函数以实现：

• 硬件压缩/解压缩。
• 像素格式转换（如 RGB565 转 RGB888）。
• 访问非连续或物理地址不连续的显存。

// 自定义 fb_write 示例：写入时自动进行伽马校正
static ssize_t myfb_write(struct fb_info *info, const char __user *buf,
                          size_t count, loff_t *ppos)
{
    unsigned long total_size = info->screen_size;
    loff_t pos = *ppos;
    size_t ret;
    
    if (pos >= total_size)
        return 0;
    if (count > total_size - pos)
        count = total_size - pos;
    
    // 应用伽马校正表后再写入
    ret = gamma_corrected_copy_from_user(info->screen_buffer + pos,
                                         buf, count, info->gamma_table);
    if (ret > 0)
        *ppos += ret;
    return ret;
}

4.4 函数调用关系与数据流

下图展示了用户空间系统调用与内核 fb_ops 回调之间的映射关系，以及数据在图层合成过程中的流动路径。

4.5 调试实践：验证 fb_ops 回调是否被正确调用

在图层合成调试中，经常需要确认驱动层的回调是否被用户空间正确触发。以下是两种常用方法：

1. 添加 dev_dbg 日志：在每个回调入口处打印函数名、进程 PID 和关键参数。
2. 使用 tracepoint：内核提供了 fbmem:fbmem_read 和 fbmem:fbmem_write 跟踪点，可通过 trace-cmd 或 perf 捕获。

// 调试日志示例：在 fb_write 中记录写入位置和大小
static ssize_t myfb_write(struct fb_info *info, const char __user *buf,
                          size_t count, loff_t *ppos)
{
    dev_dbg(info->device,
            "fb_write: pid=%d pos=%lld count=%zu screen_size=%lu\n",
            current->pid, *ppos, count, info->screen_size);
    
    // ... 实际写入逻辑 ...
}

4.6 常见问题与避坑指南

掌握 struct fb_ops 中这四个基础操作函数的实现与调试方法，为后续深入图层合成中的 fb_pan_display 和 fb_mmap 打下坚实基础。