3. FrameBuffer驱动框架：从架构到实战

说到嵌入式Linux显示，FrameBuffer是绕不开的基础设施。它就像一个画布，应用程序往上面画东西，驱动负责把画布内容送到屏幕。今天我们就把它拆开看看，到底怎么工作的。

3.1 Linux FrameBuffer架构分析

FrameBuffer的架构其实不复杂。我画了张图，你先有个整体印象：

从图上你能看到，FrameBuffer分了三层：用户空间、内核VFS层、硬件驱动层。中间那个fbmem.c是核心，它管理着所有注册的fb设备。

我个人习惯把FrameBuffer理解成一个「内存映射的显示缓冲区」。说白了，就是内核给你一块内存，你往里面写像素数据，驱动自动刷到屏幕上。不需要你管I2C、SPI那些底层协议。

3.2 fb_info结构体详解

每个FrameBuffer设备在内核里对应一个fb_info结构体。这是驱动开发者的核心数据结构，我当年刚接触时被它几十个字段搞得头晕。其实关键的就那么几个：

字段	类型	说明
fb_info->fbops	struct fb_ops *	操作函数集，驱动必须实现
fb_info->fix	struct fb_fix_screeninfo	固定参数：显存地址、行长、类型等
fb_info->var	struct fb_var_screeninfo	可变参数：分辨率、位深、时序等
fb_info->screen_base	char __iomem *	显存虚拟地址，用户mmap的目标
fb_info->screen_size	size_t	显存大小（字节）
fb_info->device	struct device *	关联的硬件设备

嗯，这里要注意screen_base。它指向的是内核映射后的虚拟地址，不是物理地址。用户程序通过mmap拿到的是这块内存的用户空间映射。我曾经踩过一个坑：在某个ARM平台上，screen_base用了ioremap，但显存是DMA缓冲区，应该用dma_alloc_coherent。结果屏幕显示全是花屏，排查了两天才发现是缓存一致性问题。

3.3 关键操作函数实现

驱动注册时，需要填充fb_ops结构体。这里我挑三个最常用的函数讲讲。

3.3.1 fb_open

用户执行open("/dev/fb0", ...)时触发。大部分驱动不需要特殊处理，直接返回0就行。但有些场景需要：

static int myfb_open(struct fb_info *info, int user)
{
    // 增加模块引用计数
    try_module_get(info->fbops->owner);
    
    // 如果是第一个打开，初始化硬件
    if (atomic_inc_return(&info->count) == 1) {
        myfb_hw_init(info);
    }
    
    dev_dbg(info->device, "fb opened, count=%d\n", 
            atomic_read(&info->count));
    return 0;
}

为什么要有user参数？它表示是用户空间调用还是内核内部调用。有些驱动对内核调用跳过权限检查。我记得在某个项目中，内核线程直接调用fb操作，结果因为权限检查失败导致系统卡死。从那以后我习惯在open里加个判断：

if (!user)
    return 0;  // 内核调用直接放行

3.3.2 fb_write

用户调用write(fd, buf, count)时触发。默认实现是fb_sys_write，它会从用户缓冲区拷贝数据到显存。但如果你有特殊需求，可以自己实现：

static ssize_t myfb_write(struct fb_info *info, const char __user *buf,
                          size_t count, loff_t *ppos)
{
    unsigned long p = *ppos;
    unsigned long total_size = info->screen_size;
    
    // 边界检查
    if (p >= total_size)
        return 0;
    if (count > total_size - p)
        count = total_size - p;
    
    // 拷贝数据到显存
    if (copy_from_user(info->screen_base + p, buf, count))
        return -EFAULT;
    
    *ppos += count;
    return count;
}

3.3.3 fb_ioctl

这是最复杂的函数。用户通过ioctl查询和设置显示参数。常用的命令有：

命令	功能	数据
FBIOGET_VSCREENINFO	获取当前可变参数	struct fb_var_screeninfo
FBIOPUT_VSCREENINFO	设置可变参数	struct fb_var_screeninfo
FBIOGET_FSCREENINFO	获取固定参数	struct fb_fix_screeninfo
FBIOBLANK	开关显示（亮屏/灭屏）	int
FBIOGET_CON2FBMAP	获取控制台映射	struct fb_con2fbmap

实现ioctl时，核心是处理FBIOPUT_VSCREENINFO。用户改了分辨率或位深，驱动要重新配置硬件：

static int myfb_ioctl(struct fb_info *info, unsigned int cmd,
                      unsigned long arg)
{
    struct fb_var_screeninfo var;
    
    switch (cmd) {
    case FBIOPUT_VSCREENINFO:
        if (copy_from_user(&var, (void __user *)arg, sizeof(var)))
            return -EFAULT;
        
        // 校验参数合法性
        if (var.xres > 1024 || var.yres > 600)
            return -EINVAL;
        
        // 更新info->var
        memcpy(&info->var, &var, sizeof(var));
        
        // 重新配置硬件时序
        myfb_set_timing(info);
        return 0;
        
    case FBIOBLANK:
        // 亮屏/灭屏
        myfb_blank(info, (int)arg);
        return 0;
    }
    
    return -ENOTTY;  // 不支持的命令
}

3.4 用户态操作示例

理论说完了，来点实战。下面是一个完整的用户态程序，演示如何操作FrameBuffer：

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <fcntl.h>
#include <unistd.h>
#include <sys/ioctl.h>
#include <sys/mman.h>
#include <linux/fb.h>

int main(int argc, char *argv[])
{
    int fb_fd;
    struct fb_var_screeninfo var;
    struct fb_fix_screeninfo fix;
    char *fb_mem;
    long screensize;
    
    // 1. 打开设备
    fb_fd = open("/dev/fb0", O_RDWR);
    if (fb_fd < 0) {
        perror("open /dev/fb0 failed");
        return -1;
    }
    printf("FrameBuffer opened successfully\n");
    
    // 2. 获取固定参数
    if (ioctl(fb_fd, FBIOGET_FSCREENINFO, &fix)) {
        perror("get fix info failed");
        close(fb_fd);
        return -1;
    }
    printf("Display: %dx%d, %dbpp\n", 
           fix.line_length * 8 / (var.bits_per_pixel),
           var.yres, var.bits_per_pixel);
    
    // 3. 获取可变参数
    if (ioctl(fb_fd, FBIOGET_VSCREENINFO, &var)) {
        perror("get var info failed");
        close(fb_fd);
        return -1;
    }
    printf("Resolution: %dx%d, %dbpp\n", 
           var.xres, var.yres, var.bits_per_pixel);
    
    // 4. 计算显存大小并mmap
    screensize = var.xres * var.yres * var.bits_per_pixel / 8;
    fb_mem = (char *)mmap(NULL, screensize, 
                          PROT_READ | PROT_WRITE,
                          MAP_SHARED, fb_fd, 0);
    if (fb_mem == MAP_FAILED) {
        perror("mmap failed");
        close(fb_fd);
        return -1;
    }
    printf("Framebuffer mapped at %p, size %ld bytes\n", 
           fb_mem, screensize);
    
    // 5. 画一个红色全屏（假设32bpp: ARGB）
    memset(fb_mem, 0, screensize);  // 先清黑屏
    for (int y = 0; y < var.yres / 2; y++) {
        for (int x = 0; x < var.xres; x++) {
            long offset = (y * var.xres + x) * 4;
            fb_mem[offset + 0] = 0x00;      // B
            fb_mem[offset + 1] = 0x00;      // G
            fb_mem[offset + 2] = 0xFF;      // R
            fb_mem[offset + 3] = 0x00;      // A (保留)
        }
    }
    printf("Painted red rectangle on top half\n");
    
    // 6. 清理退出
    munmap(fb_mem, screensize);
    close(fb_fd);
    return 0;
}

这个程序做了六件事：打开设备、获取参数、mmap映射、画图、清理退出。你编译运行后，屏幕上半部分应该变成红色。

你想想看，整个流程其实就三步：打开设备、映射显存、写像素。驱动框架帮你处理了所有硬件细节。但正是这个「简单」，让很多人忽略了底层原理。一旦遇到花屏、闪屏、分辨率不对的问题，就得回来啃fb_info和fb_ops。