3. struct fb_fix_screeninfo 详解：id、smem_start、smem_len、type、visual 等字段配置

struct fb_fix_screeninfo 是帧缓冲驱动中描述“固定硬件特性”的核心结构体。与可变参数结构体 fb_var_screeninfo 不同，fb_fix_screeninfo 中的字段在硬件初始化后通常不再改变，它向用户空间暴露了帧缓冲设备的内存映射地址、长度、显示类型等底层物理属性。正确配置该结构体是驱动能够被 fbmem.c 核心层正确注册、用户空间能够通过 mmap 直接操作显存的前提。

3.1 结构体全景与关键字段速查

该结构体定义在 include/uapi/linux/fb.h 中。以下表格列出了驱动初始化时必须关注的字段及其配置要点：

3.2 字段深度解析与配置场景

3.2.1 id：设备标识的“身份证”

id 字段在用户空间通过 FBIOGET_FSCREENINFO 读取，用于识别具体硬件驱动。它不参与内核逻辑判断，但影响调试与用户态工具（如 fbset -i）的输出。配置时需注意：

• 必须使用 strncpy 或 snprintf 确保不超过 15 个字符。
• 建议与驱动名称或设备树 compatible 属性对应，便于故障定位。
• 示例：strncpy(fix->id, "mylcd_drv", sizeof(fix->id) - 1);

3.2.2 smem_start 与 smem_len：显存映射的基石

这两个字段是帧缓冲驱动最关键的配置项。smem_start 必须是物理地址，用户空间通过 mmap 将该物理地址映射到进程虚拟空间。配置流程如下：

1. 在 probe 函数中分配 DMA 缓冲区：dma_alloc_coherent(dev, size, &dma_phys, GFP_KERNEL)。
2. 将返回的物理地址赋值给 smem_start：fix->smem_start = dma_phys。
3. 将分配的大小赋值给 smem_len：fix->smem_len = size。
4. 将虚拟地址保存到 info->screen_base，供驱动内部操作。

3.2.3 type：像素排列方式

type 字段定义了帧缓冲中像素数据的组织格式。最常用的枚举值如下：

对于现代嵌入式 LCD 控制器，几乎总是配置为 FB_TYPE_PACKED_PIXELS。

3.2.4 visual：颜色视觉模型

visual 字段决定了颜色映射方式，直接影响用户空间如何解释像素值。常见配置：

• FB_VISUAL_TRUECOLOR：每个像素直接包含 RGB 分量，无需查色表。适用于 16/24/32 bpp 的 LCD。
• FB_VISUAL_PSEUDOCOLOR：像素值是查色表索引，需要设置 fb_cmap。适用于 8 bpp 及以下的显示设备。
• FB_VISUAL_MONO01 / FB_VISUAL_MONO10：单色显示，0 代表黑或白取决于具体值。
• FB_VISUAL_DIRECTCOLOR：每个像素的 R/G/B 分量各自独立查表，较少使用。

3.3 字段配置关系与初始化流程 SVG

下图展示了在驱动 probe 函数中，fb_fix_screeninfo 各字段的配置顺序与依赖关系：

3.4 完整配置代码示例

以下代码片段展示了在 probe 函数中配置 fb_fix_screeninfo 的典型实现：

static int myfb_probe(struct platform_device *pdev)
{
    struct fb_info *info;
    struct fb_fix_screeninfo *fix;
    struct resource *res;
    dma_addr_t dma_phys;
    void __iomem *vaddr;
    size_t screen_size;

    // 1. 分配 fb_info
    info = framebuffer_alloc(0, &pdev->dev);
    if (!info)
        return -ENOMEM;

    fix = &info->fix;

    // 2. 分配 DMA 显存（物理连续）
    screen_size = 800 * 480 * 32 / 8;  // 800x480, 32bpp
    vaddr = dma_alloc_coherent(&pdev->dev, screen_size,
                               &dma_phys, GFP_KERNEL);
    if (!vaddr) {
        framebuffer_release(info);
        return -ENOMEM;
    }
    info->screen_base = vaddr;
    info->screen_size = screen_size;

    // 3. 配置 fix 固定信息
    strncpy(fix->id, "my800x480", sizeof(fix->id) - 1);
    fix->smem_start  = (unsigned long)dma_phys;
    fix->smem_len    = screen_size;
    fix->type        = FB_TYPE_PACKED_PIXELS;
    fix->visual      = FB_VISUAL_TRUECOLOR;
    fix->line_length = 800 * 32 / 8;  // 3200 bytes per line
    fix->accel       = FB_ACCEL_NONE;

    // 4. 可选：MMIO 寄存器区域
    res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
    if (res) {
        fix->mmio_start = res->start;
        fix->mmio_len   = resource_size(res);
    }

    // 5. 配置可变参数与操作函数（略）
    info->var = myfb_default_var;
    info->fbops = &myfb_ops;
    info->flags = FBINFO_DEFAULT;

    // 6. 注册帧缓冲
    if (register_framebuffer(info) < 0) {
        dma_free_coherent(&pdev->dev, screen_size,
                          vaddr, dma_phys);
        framebuffer_release(info);
        return -EINVAL;
    }

    platform_set_drvdata(pdev, info);
    return 0;
}

3.5 字段配置检查清单

在提交驱动代码前，建议逐项核对以下配置项：