📚 课程目录第4章帧缓冲设备文件

4. 帧缓冲设备文件：/dev/fb0 设备节点、mmap 映射机制、ioctl 控制命令、文件操作接口

帧缓冲（Framebuffer）设备在 Linux 用户空间以 /dev/fbX 设备节点呈现，是驱动与应用程序之间的核心桥梁。本章深入剖析设备节点的创建规则、内存映射（mmap）机制、标准 ioctl 控制命令以及文件操作接口的实现细节，帮助开发者掌握从用户态操控 LCD 显示的关键技术。

  核心要点：帧缓冲设备文件是用户态直接操作显存的“窗口”，mmap 实现零拷贝显示，ioctl 提供控制能力，文件操作接口则定义了驱动与 VFS 的交互契约。

4.1 /dev/fb0 设备节点与主次设备号

帧缓冲设备在 Linux 内核中注册为主设备号 29，次设备号从 0 开始递增。系统启动时，内核自动创建 /dev/fb0、/dev/fb1 等节点，分别对应不同的显示设备（如 LCD、HDMI、VGA）。

设备节点	主设备号	次设备号	典型用途
`/dev/fb0`	29	0	主 LCD 显示屏
`/dev/fb1`	29	1	第二显示屏 / HDMI 输出
`/dev/fb2`	29	2	叠加层 / 视频输出

设备节点的创建由 device_create() 或 mknod 命令完成。在驱动初始化时，通常使用以下代码注册帧缓冲设备：

/* 帧缓冲设备注册示例 */
static int __init fb_driver_init(void)
{
    int ret;
    struct fb_info *fbi;

    /* 分配 fb_info 结构体 */
    fbi = framebuffer_alloc(0, NULL);
    if (!fbi)
        return -ENOMEM;

    /* 设置 fb_ops 和 var/fix 参数 */
    fbi->fbops = &myfb_ops;
    fbi->var = myfb_var;
    fbi->fix = myfb_fix;

    /* 注册帧缓冲设备，次设备号 0 */
    ret = register_framebuffer(fbi);
    if (ret) {
        framebuffer_free(fbi);
        return ret;
    }

    printk(KERN_INFO "myfb: /dev/fb0 registered\n");
    return 0;
}

提示：在嵌入式系统中，如果只有一个 LCD 屏，通常固定使用 /dev/fb0。多屏系统需要根据硬件连接顺序分配次设备号。

4.2 mmap 映射机制：零拷贝显存访问

mmap 是帧缓冲驱动性能优化的核心机制。它允许应用程序将内核空间的显存直接映射到用户空间，避免 read/write 的系统调用开销，实现真正的零拷贝显示。

4.2.1 mmap 工作原理

4.2.2 驱动中的 mmap 实现

帧缓冲驱动的 mmap 回调函数需要完成物理地址到用户空间的映射。核心代码如下：

/* 帧缓冲 mmap 实现 */
static int myfb_mmap(struct fb_info *fbi, struct vm_area_struct *vma)
{
    unsigned long size = vma->vm_end - vma->vm_start;
    unsigned long pfn;

    /* 获取显存物理页帧号 */
    pfn = virt_to_phys(fbi->screen_base) >> PAGE_SHIFT;

    /* 设置内存属性：非缓存、可写、共享 */
    vma->vm_page_prot = pgprot_writecombine(vma->vm_page_prot);
    vma->vm_flags |= VM_IO | VM_SHARED;

    /* 建立物理地址到用户空间的映射 */
    if (remap_pfn_range(vma, vma->vm_start, pfn,
                        size, vma->vm_page_prot))
        return -EAGAIN;

    return 0;
}

注意事项：

必须使用 pgprot_writecombine() 或 pgprot_noncached() 设置内存属性，避免 CPU 缓存导致显示不一致。
显存物理地址必须按页对齐（PAGE_SIZE），否则 remap_pfn_range 会失败。
多进程同时 mmap 同一帧缓冲时，需通过 VM_SHARED 标志实现共享。

4.2.3 用户态 mmap 使用示例

/* 用户态应用程序 mmap 帧缓冲 */
#include <stdio.h>
#include <stdlib.h>
#include <fcntl.h>
#include <sys/mman.h>
#include <linux/fb.h>

int main()
{
    int fbfd;
    struct fb_var_screeninfo vinfo;
    struct fb_fix_screeninfo finfo;
    char *fbp;
    long screensize;

    /* 打开帧缓冲设备 */
    fbfd = open("/dev/fb0", O_RDWR);
    if (fbfd == -1) {
        perror("open /dev/fb0");
        exit(1);
    }

    /* 获取固定信息 */
    ioctl(fbfd, FBIOGET_FSCREENINFO, &finfo);
    /* 获取可变信息 */
    ioctl(fbfd, FBIOGET_VSCREENINFO, &vinfo);

    /* 计算显存大小 */
    screensize = vinfo.xres * vinfo.yres * vinfo.bits_per_pixel / 8;

    /* mmap 映射显存 */
    fbp = (char *)mmap(0, screensize, PROT_READ | PROT_WRITE,
                       MAP_SHARED, fbfd, 0);
    if (fbp == MAP_FAILED) {
        perror("mmap");
        exit(1);
    }

    /* 直接操作显存：将屏幕填充为红色 */
    memset(fbp, 0xFF, screensize);  /* 假设 32bpp，0xFF 为蓝色 */

    /* 清理 */
    munmap(fbp, screensize);
    close(fbfd);
    return 0;
}

4.3 ioctl 控制命令：显示参数动态配置

ioctl 是用户态与帧缓冲驱动交互控制命令的主要通道。Linux 内核定义了标准的帧缓冲 ioctl 命令集，涵盖屏幕参数获取/设置、颜色映射、空白控制等功能。

4.3.1 标准 ioctl 命令列表

命令宏	方向	数据结构	功能描述
`FBIOGET_VSCREENINFO`	读	`struct fb_var_screeninfo`	获取当前可变显示参数（分辨率、位深、时序）
`FBIOPUT_VSCREENINFO`	写	`struct fb_var_screeninfo`	设置新的可变显示参数（触发模式切换）
`FBIOGET_FSCREENINFO`	读	`struct fb_fix_screeninfo`	获取固定信息（显存地址、行长、类型）
`FBIOGETCMAP`	读	`struct fb_cmap`	获取颜色查找表（8bpp 模式）
`FBIOPUTCMAP`	写	`struct fb_cmap`	设置颜色查找表
`FBIOBLANK`	写	`int`	控制屏幕空白/唤醒（省电模式）
`FBIO_WAITFORVSYNC`	写	`int`	等待垂直同步信号（防撕裂）

4.3.2 驱动中的 ioctl 实现

/* 帧缓冲 ioctl 回调实现 */
static int myfb_ioctl(struct fb_info *fbi, unsigned int cmd,
                      unsigned long arg)
{
    struct fb_var_screeninfo var;
    struct fb_cmap cmap;
    int blank;

    switch (cmd) {
    case FBIOGET_VSCREENINFO:
        /* 返回当前可变参数 */
        if (copy_to_user((void __user *)arg, &fbi->var,
                         sizeof(struct fb_var_screeninfo)))
            return -EFAULT;
        break;

    case FBIOPUT_VSCREENINFO:
        /* 接收用户设置的新参数 */
        if (copy_from_user(&var, (void __user *)arg,
                           sizeof(struct fb_var_screeninfo)))
            return -EFAULT;
        /* 验证参数合法性 */
        if (var.xres > MYFB_MAX_XRES || var.yres > MYFB_MAX_YRES)
            return -EINVAL;
        /* 更新显示参数并重新配置硬件 */
        memcpy(&fbi->var, &var, sizeof(var));
        myfb_set_par(fbi);
        break;

    case FBIOBLANK:
        /* 屏幕空白控制 */
        if (copy_from_user(&blank, (void __user *)arg, sizeof(int)))
            return -EFAULT;
        myfb_blank(blank, fbi);
        break;

    case FBIO_WAITFORVSYNC:
        /* 等待垂直同步 */
        wait_event_interruptible(fbi->vsync_wait,
                                 fbi->vsync_flag);
        fbi->vsync_flag = 0;
        break;

    default:
        return -ENOTTY;
    }
    return 0;
}

性能建议：在 FBIOPUT_VSCREENINFO 处理中，应尽量减少不必要的硬件重配置。如果分辨率未变，仅修改颜色深度或时序，可以只更新部分寄存器，避免全屏闪烁。

4.4 文件操作接口：驱动与 VFS 的交互契约

帧缓冲驱动通过 struct fb_ops 结构体向 VFS 注册文件操作接口。这些接口定义了用户态程序如何通过 open、read、write、mmap、ioctl 等系统调用与驱动交互。

4.4.1 fb_ops 结构体核心成员

4.4.2 完整 fb_ops 实现示例

/* 帧缓冲文件操作接口完整实现 */
static struct fb_ops myfb_ops = {
    .owner          = THIS_MODULE,
    .fb_open        = myfb_open,
    .fb_release     = myfb_release,
    .fb_read        = myfb_read,
    .fb_write       = myfb_write,
    .fb_mmap        = myfb_mmap,
    .fb_ioctl       = myfb_ioctl,
    .fb_blank       = myfb_blank,
    .fb_set_par     = myfb_set_par,
    .fb_setcolreg   = myfb_setcolreg,
    .fb_pan_display = myfb_pan_display,
    .fb_fillrect    = cfb_fillrect,   /* 使用通用加速函数 */
    .fb_copyarea    = cfb_copyarea,
    .fb_imageblit   = cfb_imageblit,
};

/* open 回调：增加引用计数，初始化硬件 */
static int myfb_open(struct fb_info *fbi, int user)
{
    if (atomic_inc_return(&fbi->count) == 1) {
        /* 首次打开，初始化 LCD 控制器 */
        myfb_hw_init(fbi);
    }
    return 0;
}

/* release 回调：减少引用计数，可关闭硬件 */
static int myfb_release(struct fb_info *fbi, int user)
{
    if (atomic_dec_return(&fbi->count) == 0) {
        /* 最后一个进程关闭，可进入低功耗模式 */
        myfb_hw_suspend(fbi);
    }
    return 0;
}

/* read 回调：从显存读取数据到用户缓冲区 */
static ssize_t myfb_read(struct fb_info *fbi, char __user *buf,
                         size_t count, loff_t *ppos)
{
    unsigned long p = *ppos;
    void *src;

    if (p >= fbi->fix.smem_len)
        return 0;

    if (count > fbi->fix.smem_len - p)
        count = fbi->fix.smem_len - p;

    src = fbi->screen_base + p;
    if (copy_to_user(buf, src, count))
        return -EFAULT;

    *ppos += count;
    return count;
}

/* write 回调：从用户缓冲区写入显存 */
static ssize_t myfb_write(struct fb_info *fbi, const char __user *buf,
                          size_t count, loff_t *ppos)
{
    unsigned long p = *ppos;
    void *dst;

    if (p >= fbi->fix.smem_len)
        return 0;

    if (count > fbi->fix.smem_len - p)
        count = fbi->fix.smem_len - p;

    dst = fbi->screen_base + p;
    if (copy_from_user(dst, buf, count))
        return -EFAULT;

    *ppos += count;
    return count;
}

4.4.3 文件操作接口设计要点

接口	设计要点	常见错误
`fb_open`	支持多进程同时打开；首次打开时初始化硬件	未处理并发打开导致硬件重复初始化
`fb_release`	引用计数归零时关闭硬件或进入省电模式	直接关闭硬件导致其他进程访问异常
`fb_read/fb_write`	处理偏移量边界；使用 `copy_to/from_user` 保证安全	直接使用 `memcpy` 导致内核崩溃
`fb_mmap`	设置非缓存属性；物理地址页对齐	未设置 `pgprot_writecombine` 导致显示异常
`fb_ioctl`	验证用户传入参数合法性；使用 `copy_from_user`	未校验参数导致硬件配置越界

  性能对比：使用 mmap 直接访问显存比通过 read/write 系统调用快 10~50 倍（取决于显存大小和系统调用次数）。在帧率要求高的场景（如视频播放、游戏），必须使用 mmap 方式。

4.5 本章小结

设备节点：/dev/fbX 主设备号 29，次设备号标识不同显示设备。
mmap 映射：实现零拷贝显存访问，驱动中通过 remap_pfn_range 建立物理到虚拟地址映射。
ioctl 命令：标准命令集覆盖显示参数获取/设置、颜色映射、空白控制、VSYNC 等待等。
文件操作接口：struct fb_ops 定义了驱动与 VFS 的完整交互契约，需注意并发安全和参数校验。