3. mmap 系统调用原理：虚拟内存映射、物理地址与用户空间映射、页对齐要求

在嵌入式 Linux Framebuffer 编程中，mmap 是连接用户空间与物理显存的核心桥梁。理解其底层原理，是正确实现多屏同显与高效帧缓存操作的前提。本章深入剖析 mmap 的虚拟内存映射机制、物理地址到用户空间的映射过程，以及页对齐这一关键约束。

3.1 虚拟内存映射：从虚拟到物理的桥梁

现代操作系统（包括嵌入式 Linux）均采用虚拟内存管理。每个进程拥有独立的虚拟地址空间，通过 MMU（内存管理单元）将虚拟地址动态转换为物理地址。mmap 系统调用的核心作用，就是在进程的虚拟地址空间中创建一个新的映射区域，并将其与某个文件描述符（或设备文件）关联起来。

3.2 物理地址与用户空间映射：Framebuffer 实战

Framebuffer 设备驱动在初始化时，会分配一段连续的物理内存作为显存，并将其物理地址记录在 struct fb_fix_screeninfo 的 smem_start 字段中。mmap 通过以下步骤完成映射：

1. 打开设备： 用户程序通过 open("/dev/fb0", O_RDWR) 获取文件描述符 fd。
2. 获取信息： 通过 ioctl(fd, FBIOGET_FSCREENINFO, &fix) 获取显存物理地址 fix.smem_start 和长度 fix.smem_len。
3. 发起映射： 调用 mmap(NULL, fix.smem_len, PROT_READ | PROT_WRITE, MAP_SHARED, fd, 0)。
4. 内核处理： 内核在进程的虚拟地址空间中分配一块未使用的区域，建立页表，将虚拟页映射到 fix.smem_start 对应的物理页帧。
5. 返回地址： mmap 返回映射后的虚拟地址首地址，用户程序可直接通过指针访问显存。

3.3 页对齐要求：不可忽视的底层约束

MMU 以页（Page）为最小单位管理内存。在 ARM 架构中，标准页大小为 4KB（0x1000）。mmap 系统调用要求映射的 偏移量（offset） 必须是页大小的整数倍。这一约束直接来源于硬件页表机制：页表项记录的是物理页帧号（PFN），无法指向页内偏移。

3.4 多屏同显中的 mmap 应用

在多屏同显场景中，mmap 的 MAP_SHARED 特性至关重要。多个进程（或同一进程的多个线程）可以分别打开不同的 Framebuffer 设备（如 /dev/fb0、/dev/fb1），并通过 mmap 将各自的显存映射到用户空间。当这些显存物理地址指向同一块物理内存区域时（通过驱动配置或内核共享内存机制），对一个映射区的写入将立即反映到所有映射区，从而实现多屏内容同步。

3.5 代码示例：Framebuffer mmap 映射

以下代码展示了标准的 Framebuffer mmap 映射流程，包含错误处理和页对齐检查：

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

int main() {
    int fbfd = 0;
    struct fb_fix_screeninfo fix;
    struct fb_var_screeninfo var;
    char *fbp = NULL;
    long screensize = 0;

    // 1. 打开 Framebuffer 设备
    fbfd = open("/dev/fb0", O_RDWR);
    if (fbfd == -1) {
        perror("Error: cannot open framebuffer device");
        exit(1);
    }
    printf("Framebuffer device opened successfully.\n");

    // 2. 获取固定信息（含物理地址和长度）
    if (ioctl(fbfd, FBIOGET_FSCREENINFO, &fix) == -1) {
        perror("Error reading fixed information");
        close(fbfd);
        exit(1);
    }
    printf("Physical address: 0x%lx\n", fix.smem_start);
    printf("Buffer length: %u bytes\n", fix.smem_len);

    // 3. 获取可变信息（含分辨率、位深）
    if (ioctl(fbfd, FBIOGET_VSCREENINFO, &var) == -1) {
        perror("Error reading variable information");
        close(fbfd);
        exit(1);
    }
    printf("Resolution: %dx%d, %dbpp\n", var.xres, var.yres, var.bits_per_pixel);

    // 4. 计算映射大小（页对齐检查由内核自动处理）
    screensize = fix.smem_len;

    // 5. mmap 映射：offset 必须为 0
    fbp = (char *)mmap(NULL, screensize, PROT_READ | PROT_WRITE, MAP_SHARED, fbfd, 0);
    if (fbp == MAP_FAILED) {
        perror("Error: mmap failed");
        close(fbfd);
        exit(1);
    }
    printf("mmap successful, virtual address: %p\n", fbp);

    // 6. 使用映射区（示例：将屏幕清为蓝色）
    // 注意：此处省略像素格式转换，仅作演示
    memset(fbp, 0xFF, screensize);  // 填充白色

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