📚 课程目录第4章 DRM Bridge框架

4. DRM Bridge框架：Bridge驱动模型、MIPI DSI Bridge注册与回调、panel-bridge与generic-bridge

DRM Bridge框架是连接显示控制器（CRTC/Encoder）与最终显示设备（Panel/Connector）之间的关键抽象层。在MIPI DSI场景中，Bridge负责处理链路协商、视频格式转换、时序适配以及电源序列管理。本章深入剖析Bridge驱动模型的核心机制，包括注册流程、回调函数链以及两种典型实现：panel-bridge与generic-bridge。

  核心观点： Bridge框架将显示链路拆解为可组合的“中间件”，每个Bridge节点独立处理一段信号路径，最终形成从CRTC到Panel的完整数据管道。理解Bridge模型是掌握复杂显示拓扑（如多芯片级联、DSI转eDP、MIPI转LVDS）的基础。

4.1 Bridge驱动模型架构

DRM Bridge模型基于链表式回调链设计。每个Bridge节点通过drm_bridge结构体注册到Encoder或前级Bridge上，形成单向依赖链。驱动模型的核心数据结构与操作集如下：

结构体/函数	作用	关键字段/参数
`struct drm_bridge`	Bridge节点描述符	`funcs`（操作集）、`encoder`（所属编码器）、`next`（下一级Bridge）、`type`（总线类型）
`struct drm_bridge_funcs`	Bridge回调函数集	`attach`、`detach`、`mode_valid`、`mode_set`、`enable`、`disable`、`pre_enable`、`post_disable`
`drm_bridge_attach()`	将Bridge挂载到Encoder或前级Bridge	`encoder`、`bridge`、`previous`（前级Bridge指针）
`drm_bridge_remove()`	从链中移除Bridge节点	`bridge`指针

设计要点： Bridge链的遍历方向是从Encoder到Panel。每个Bridge的next指针指向更靠近Panel的下一级Bridge。回调函数的调用顺序严格遵循链式结构：pre_enable从Encoder端向Panel端传播，enable从Panel端向Encoder端返回。

4.2 MIPI DSI Bridge注册与回调

MIPI DSI Bridge的注册遵循标准DRM Bridge流程，但需要额外处理DSI协议特有的参数协商。典型的注册步骤包括：

分配并初始化 struct drm_bridge 实例，填充 funcs 操作集。
设置Bridge类型：bridge->type = DRM_MODE_CONNECTOR_DSI。
调用 drm_bridge_attach() 将Bridge挂载到Encoder或前级Bridge。
实现DSI特定回调：在 mode_set 中配置DSI时序参数（HSA、HBP、HFP、VSA等），在 enable 中发送DCS命令初始化Panel。

以下是一个典型的MIPI DSI Bridge驱动注册代码片段：

static const struct drm_bridge_funcs dsi_bridge_funcs = {
    .attach       = dsi_bridge_attach,
    .detach       = dsi_bridge_detach,
    .mode_valid   = dsi_bridge_mode_valid,
    .mode_set     = dsi_bridge_mode_set,
    .pre_enable   = dsi_bridge_pre_enable,
    .enable       = dsi_bridge_enable,
    .disable      = dsi_bridge_disable,
    .post_disable = dsi_bridge_post_disable,
};

static int dsi_bridge_probe(struct platform_device *pdev)
{
    struct drm_bridge *bridge;
    struct mipi_dsi_device *dsi;
    int ret;

    bridge = devm_kzalloc(&pdev->dev, sizeof(*bridge), GFP_KERNEL);
    if (!bridge)
        return -ENOMEM;

    bridge->funcs = &dsi_bridge_funcs;
    bridge->type = DRM_MODE_CONNECTOR_DSI;
    bridge->of_node = pdev->dev.of_node;

    /* 初始化DSI设备 */
    dsi = mipi_dsi_device_register_full(&pdev->dev, &dsi_info);
    if (IS_ERR(dsi))
        return PTR_ERR(dsi);

    /* 注册Bridge到Encoder */
    ret = drm_bridge_attach(&pdev->dev, bridge, DRM_BRIDGE_ATTACH_NO_CONNECTOR);
    if (ret) {
        dev_err(&pdev->dev, "Failed to attach bridge\n");
        mipi_dsi_device_unregister(dsi);
        return ret;
    }

    platform_set_drvdata(pdev, bridge);
    return 0;
}

常见陷阱：

drm_bridge_attach() 的第三个参数 flags 必须正确设置。使用 DRM_BRIDGE_ATTACH_NO_CONNECTOR 表示Bridge自己管理Connector，否则框架会自动创建默认Connector。
DSI Bridge的 mode_set 回调中必须根据 drm_display_mode 计算并配置DSI链路参数（如LP/HS模式切换、时钟频率、数据通道数）。
电源序列必须严格遵循DSI规范：先使能电源轨，再发送初始化序列，最后切换至HS模式。

4.3 panel-bridge：标准Panel封装

panel-bridge 是DRM框架提供的一个通用Bridge实现，用于将 drm_panel 封装为Bridge节点。它简化了Panel驱动的集成，使Panel可以无缝接入Bridge链。核心机制如下：

自动创建：调用 drm_panel_bridge_add() 或 devm_drm_panel_bridge_add() 即可将 struct drm_panel 包装为Bridge。
回调映射：panel-bridge的 pre_enable/enable/disable/post_disable 直接映射到 drm_panel_funcs 的对应回调。
时序传递：mode_set 回调将 drm_display_mode 传递给Panel的 get_modes 回调，用于填充EDID或固定时序。
Connector管理：panel-bridge默认创建 drm_connector 实例，类型为 DRM_MODE_CONNECTOR_DSI 或 DRM_MODE_CONNECTOR_eDP。

使用panel-bridge的典型场景：

static int panel_probe(struct platform_device *pdev)
{
    struct drm_panel *panel;
    struct drm_bridge *bridge;
    int ret;

    panel = devm_kzalloc(&pdev->dev, sizeof(*panel), GFP_KERNEL);
    if (!panel)
        return -ENOMEM;

    /* 初始化Panel操作集 */
    panel->funcs = &my_panel_funcs;
    panel->dev = &pdev->dev;

    /* 注册Panel */
    ret = drm_panel_init(panel);
    if (ret)
        return ret;

    /* 将Panel封装为Bridge */
    bridge = devm_drm_panel_bridge_add(&pdev->dev, panel);
    if (IS_ERR(bridge))
        return PTR_ERR(bridge);

    platform_set_drvdata(pdev, bridge);
    return 0;
}

  优势： panel-bridge消除了手动实现Bridge回调的重复工作，特别适合标准MIPI DSI Panel。开发者只需关注Panel本身的初始化序列和电源管理，Bridge链的集成由框架自动完成。

4.4 generic-bridge：自定义协议转换

generic-bridge 并非内核中的固定实现，而是指开发者根据特定协议转换需求自定义的Bridge驱动。典型场景包括：

场景	输入协议	输出协议	Bridge职责
DSI转eDP	MIPI DSI	eDP	时序转换、AUX通道管理、链路训练
DSI转LVDS	MIPI DSI	LVDS	数据映射、时钟分频、DE信号生成
DSI转HDMI	MIPI DSI	HDMI	色彩空间转换、音频嵌入、HDCP管理
多DSI聚合	多路DSI	单路高带宽DSI	数据拆分/合并、时钟同步、帧缓冲管理

generic-bridge的实现需要开发者手动处理以下关键回调：

static int my_generic_bridge_attach(struct drm_bridge *bridge,
                                    enum drm_bridge_attach_flags flags)
{
    /* 初始化硬件接口：GPIO、I2C、SPI等 */
    /* 注册中断或DMA通道 */
    return 0;
}

static int my_generic_bridge_mode_valid(struct drm_bridge *bridge,
                                        const struct drm_display_info *info,
                                        const struct drm_display_mode *mode)
{
    /* 校验输入模式是否在转换芯片支持范围内 */
    if (mode->clock > MAX_SUPPORTED_CLK)
        return MODE_CLOCK_HIGH;
    return MODE_OK;
}

static void my_generic_bridge_mode_set(struct drm_bridge *bridge,
                                       const struct drm_display_mode *mode,
                                       const struct drm_display_mode *adjusted_mode)
{
    /* 配置转换芯片的时序寄存器 */
    /* 设置输入/输出格式、极性、时钟分频 */
}

static void my_generic_bridge_enable(struct drm_bridge *bridge)
{
    /* 启动转换芯片：释放复位、使能PLL、切换至工作模式 */
}

static void my_generic_bridge_disable(struct drm_bridge *bridge)
{
    /* 停止转换芯片：进入低功耗模式、关闭时钟 */
}

设计建议： generic-bridge应尽量复用DRM框架提供的辅助函数。例如，使用 drm_display_mode_to_videomode() 将DRM模式转换为芯片寄存器值；使用 drm_hdmi_avi_infoframe_from_display_mode() 生成HDMI InfoFrame。避免在Bridge中重复实现时序计算逻辑。

4.5 Bridge链的电源序列管理

Bridge链的电源管理是显示驱动稳定性的关键。DRM框架定义了严格的回调调用顺序，确保每级Bridge在正确的时机执行电源操作。标准序列如下：

阶段	调用顺序	典型操作
上电序列	pre_enable: Encoder → Bridge0 → Bridge1 → Panel	使能电源轨、释放复位、初始化PLL、配置时序寄存器
	enable: Panel → Bridge1 → Bridge0 → Encoder	发送DCS初始化命令、切换至HS模式、启动视频流
下电序列	disable: Encoder → Bridge0 → Bridge1 → Panel	停止视频流、切换至LP模式、发送睡眠命令
	post_disable: Panel → Bridge1 → Bridge0 → Encoder	关闭PLL、复位芯片、关闭电源轨

电源序列避坑：

严禁在 pre_enable 中发送DCS命令，此时Panel可能尚未完成初始化。DCS命令应放在 enable 回调中。
如果Bridge链中存在I2C/SPI控制的转换芯片，必须在 pre_enable 中确保通信接口已就绪。
多级Bridge场景下，后级Bridge的 pre_enable 可能依赖前级Bridge提供的时钟。此时应在前级 pre_enable 中先使能时钟输出。

4.6 本章小结

DRM Bridge框架通过链式回调模型实现了显示链路的灵活组合。panel-bridge简化了标准Panel的集成，generic-bridge则提供了协议转换的无限可能。理解Bridge的注册流程、回调顺序以及电源序列管理，是开发稳定、高性能MIPI DSI显示驱动的核心技能。在实际项目中，应根据显示设备的类型和接口需求，合理选择panel-bridge或generic-bridge方案。