高通lk階段mipi 代碼解析以及新屏幕添加

參考：https://www.cnblogs.com/linhaostudy/p/9237526.html

背景

前段時間做了這塊的工作，但總結完以后領導說我的認識還是過於膚淺，因此重新再看了一下。

確實是有一些當時不知道的部分。

代碼分析

以 MIPI屏幕中的VIDEO類型為例。

函數入口

aboot_init()來到target_display_init()；

然后根據target中的不同，來判斷是否進入哪一個函數來處理（見附錄）：

target_display_init() 函數里有很重要函數就是gcdb_display_init();

void target_display_init(const char *panel_name)
{
    uint32_t panel_loop = 0;
    uint32_t ret = 0;

    panel_name += strspn(panel_name, " ");
    if (!strcmp(panel_name, NO_PANEL_CONFIG)
        || !strcmp(panel_name, SIM_VIDEO_PANEL)
        || !strcmp(panel_name, SIM_CMD_PANEL)) {
        dprintf(INFO, "Selected %s: Skip panel configuration\n",
                panel_name);
        return;
    }

    do {
        target_force_cont_splash_disable(false);
        ret = gcdb_display_init(panel_name, MDP_REV_305, MIPI_FB_ADDR);
        if (!ret || ret == ERR_NOT_SUPPORTED) {
            break;
        } else {
            target_force_cont_splash_disable(true);
            msm_display_off();
        }
    } while (++panel_loop <= oem_panel_max_auto_detect_panels());    
}

這就是高通原生lk LCD 兼容的關鍵所在。

有關的兼容文檔：高通平台 在lk階段通過讀取屏的ID實現多LCD屏兼容

gcdb_display_init

GCDB：Global Component Database全局組件數據庫

gcdb_display_init會根據不同的PANEL類型（由oem_panel_select的返回值決定，類似多態）初始化不同的參數

1、決定pan的行為（以函數指針的形式）：

• pll_clk_func（如果有）
• power_func
• bl_func

2、設置對應的pan屬性

• 寬高
• 數據類型

int gcdb_display_init(const char *panel_name, uint32_t rev, void *base)
{
    int ret = NO_ERROR;
    int pan_type;

    pan_type = oem_panel_select(panel_name, &panelstruct, &(panel.panel_info),
                                &dsi_video_mode_phy_db);
    // DSI
    if (pan_type == PANEL_TYPE_DSI) {
        init_platform_data();
        if (dsi_panel_init(&(panel.panel_info), &panelstruct)) {
            dprintf(CRITICAL, "DSI panel init failed!\n");
            ret = ERROR;
            goto error_gcdb_display_init;
        }

        panel.panel_info.mipi.mdss_dsi_phy_db = &dsi_video_mode_phy_db;
        
        panel.pll_clk_func = mdss_dsi_panel_clock;
        panel.power_func = mdss_dsi_panel_power;
        panel.pre_init_func = mdss_dsi_panel_pre_init;
        panel.bl_func = mdss_dsi_bl_enable;
        
        panel.fb.base = base;
        panel.fb.width =  panel.panel_info.xres;
        panel.fb.height =  panel.panel_info.yres;
        panel.fb.stride =  panel.panel_info.xres;
        panel.fb.bpp =  panel.panel_info.bpp;
        panel.fb.format = panel.panel_info.mipi.dst_format;
    // EDP
    } else if (pan_type == PANEL_TYPE_EDP) {
        mdss_edp_panel_init(&(panel.panel_info));
        
        /* prepare func is set up at edp_panel_init */
        panel.clk_func = mdss_edp_panel_clock;
        panel.power_func = mdss_edp_panel_power;
        panel.bl_func = mdss_edp_bl_enable;
        
        panel.fb.format = FB_FORMAT_RGB888;
        
    // SPI
    } else if (pan_type == PANEL_TYPE_SPI) {
        dprintf(CRITICAL, "add the spi panel init config data!\n");
        panel.panel_info.xres = panelstruct.panelres->panel_width;
        panel.panel_info.yres = panelstruct.panelres->panel_height;
        panel.panel_info.bpp  = panelstruct.color->color_format;
        
        panel.power_func = mdss_spi_panel_power;
        panel.bl_func = mdss_spi_bl_enable;
        
        panel.fb.base = base;
        panel.fb.width =  panel.panel_info.xres;
        panel.fb.height =  panel.panel_info.yres;
        panel.fb.bpp =  panel.panel_info.bpp;
        panel.fb.format = FB_FORMAT_RGB565;
        panel.panel_info.type = SPI_PANEL;
    } else {
        dprintf(CRITICAL, "Target panel init not found!\n");
        ret = ERR_NOT_SUPPORTED;
        goto error_gcdb_display_init;

    }

    panel.fb.base = base;
    panel.mdp_rev = rev;

    ret = msm_display_init(&panel);

error_gcdb_display_init:
    display_enable = ret ? 0 : 1;
    return ret;
}

初始化好之后就調用msm_display_init()函數。

msm_display_init

剛剛執行的東西會在這里調用：

在msm_display_init()里先Turn on panel，再Turn on backlight；

所有的行為都在上面進行了初始化。

int msm_display_init(struct msm_fb_panel_data *pdata)
{
    int ret = NO_ERROR;

    panel = pdata;
    if (!panel) {
        ret = ERR_INVALID_ARGS;
        goto msm_display_init_out;
    }

    /* Turn on panel */
    if (pdata->power_func)
        ret = pdata->power_func(1, &(panel->panel_info));

    /* Enable clock */
    if (pdata->clk_func)
        ret = pdata->clk_func(1);

    /* Only enabled for auto PLL calculation */
    if (pdata->pll_clk_func)
        ret = pdata->pll_clk_func(1, &(panel->panel_info));


    /* pinfo prepare  */
    if (pdata->panel_info.prepare) {
        /* this is for edp which pinfo derived from edid */
        ret = pdata->panel_info.prepare();
        panel->fb.width =  panel->panel_info.xres;
        panel->fb.height =  panel->panel_info.yres;
        panel->fb.stride =  panel->panel_info.xres;
        panel->fb.bpp =  panel->panel_info.bpp;
    }

    ret = msm_fb_alloc(&(panel->fb));

    ret = msm_display_config();

    fbcon_setup(&(panel->fb));
    display_image_on_screen();
    ret = msm_display_on();

    if (pdata->post_power_func)
        ret = pdata->post_power_func(1);

    mdelay(100);
    
    /* Turn on backlight */
    if (pdata->bl_func)
        ret = pdata->bl_func(1);

msm_display_init_out:
    return ret;
}

給L2、L6、L17供電

/* Turn on panel */
    if (pdata->power_func)
        ret = pdata->power_func(1, &(panel->panel_info));


mdss_dsi_panel_power
    ret = target_ldo_ctrl(enable, pinfo);
        regulator_enable();     /* L2, L6, and L17 */

配置時鍾

調用calculate_clock_config(pinfo)計算時鍾配置

調用target_panel_clock(enable, pinfo)配置目標panel的時鍾。

    /* Enable clock */
    if (pdata->clk_func)
        ret = pdata->clk_func(1);

mdss_dsi_panel_clock
    ret = calculate_clock_config(pinfo);
    ret = target_panel_clock(enable, pinfo);

分配並設置幀緩存

dev/gcdb/display/gcdb_display.c

msm_fb_alloc(&(panel->fb))分配幀緩沖器(frame buffer)所需的內存

和fbcon_setup(&(panel->fb))為分配內存。

msm_display_config根據細分panel的類型進行配置

ret = msm_fb_alloc(&(panel->fb));

ret = msm_display_config();

fbcon_setup(&(panel->fb));
/**********************************************/
int msm_display_config()
{
    int ret = NO_ERROR;
    int mdp_rev;
    struct msm_panel_info *pinfo;

    pinfo = &(panel->panel_info);

    /* Set MDP revision */
    mdp_set_revision(panel->mdp_rev);

    switch (pinfo->type) {
    case LVDS_PANEL:
        dprintf(INFO, "Config LVDS_PANEL.\n");
        ret = mdp_lcdc_config(pinfo, &(panel->fb));

        break;
    case MIPI_VIDEO_PANEL:
        dprintf(INFO, "Config MIPI_VIDEO_PANEL.\n");
        mdp_rev = mdp_get_revision();
        if (mdp_rev == MDP_REV_50 || mdp_rev == MDP_REV_304 ||
                        mdp_rev == MDP_REV_305)
            ret = mdss_dsi_config(panel); // 看下面
        else
            ret = mipi_config(panel);
        ret = mdp_dsi_video_config(pinfo, &(panel->fb));
        break;
    case MIPI_CMD_PANEL:
        dprintf(INFO, "Config MIPI_CMD_PANEL.\n");
        //...

        ret = mdp_dsi_cmd_config(pinfo, &(panel->fb));
        if (ret)
            goto msm_display_config_out;
        break;

    default:
        return ERR_INVALID_ARGS;
    };

    if (pinfo->config)
        ret = pinfo->config((void *)pinfo);

msm_display_config_out:
    return ret;
}

配置控制器

int mdss_dsi_config(struct msm_fb_panel_data *panel)
{
    int ret = NO_ERROR;
    struct msm_panel_info *pinfo;
    struct mipi_dsi_panel_config mipi_pinfo;

#if (DISPLAY_TYPE_MDSS == 1)
    if (!panel)
        return ERR_INVALID_ARGS;

    memset(&mipi_pinfo, 0, sizeof(mipi_pinfo));

    pinfo = &(panel->panel_info);
    mipi_pinfo.mode = pinfo->mipi.mode;
    mipi_pinfo.num_of_lanes = pinfo->mipi.num_of_lanes;
    mipi_pinfo.mdss_dsi_phy_config = pinfo->mipi.mdss_dsi_phy_db;
    mipi_pinfo.panel_cmds = pinfo->mipi.panel_cmds;
    mipi_pinfo.num_of_panel_cmds = pinfo->mipi.num_of_panel_cmds;
    mipi_pinfo.lane_swap = pinfo->mipi.lane_swap;
    mipi_pinfo.pack = 0;
    mipi_pinfo.t_clk_pre = pinfo->mipi.t_clk_pre;
    mipi_pinfo.t_clk_post = pinfo->mipi.t_clk_post;
    mipi_pinfo.signature = pinfo->mipi.signature;
    mipi_pinfo.force_clk_lane_hs = pinfo->mipi.force_clk_lane_hs;
    mipi_pinfo.cmds_post_tg = pinfo->mipi.cmds_post_tg;
    mipi_pinfo.panel_read_cmds = pinfo->mipi.panel_read_cmds;
    
    // 如果有兩個MIPI DSI接口MIPI_DSI0和MIPI_DSI1就調用兩次mdss_dsi_phy_init()，msm8909只有MIPI_DSI0，MSM8994等有兩個DSI接口。
    mdss_dsi_phy_init(&mipi_pinfo, MIPI_DSI0_BASE, DSI0_PHY_BASE);
    if (pinfo->mipi.dual_dsi)
        mdss_dsi_phy_init(&mipi_pinfo, MIPI_DSI1_BASE, DSI1_PHY_BASE);
    
    //初始化DSI接口的host控制器。
    ret = mdss_dsi_host_init(&mipi_pinfo, pinfo->mipi.dual_dsi,
                        pinfo->mipi.broadcast);
    if (ret) {
        dprintf(CRITICAL, "dsi host init error\n");
        goto error;
    }

    mdss_dsi_phy_contention_detection(&mipi_pinfo, DSI0_PHY_BASE);
    // 看下面
    if (panel->pre_init_func) {
        ret = panel->pre_init_func();
        if (ret) {
            dprintf(CRITICAL, "pre_init_func error\n");
            goto error;
        }
    }

    if (mipi_pinfo.force_clk_lane_hs)
        mdss_dsi_force_clk_lane_hs(pinfo->mipi.dual_dsi);

    if (!mipi_pinfo.cmds_post_tg) {
        ret = mdss_dsi_panel_initialize(&mipi_pinfo, pinfo->mipi.broadcast);
        if (ret) {
            dprintf(CRITICAL, "dsi panel init error\n");
            goto error;
        }
    }

    if (pinfo->rotate && panel->rotate)
        pinfo->rotate();
#endif

error:
    return ret;
}

調用if (panel->pre_init_func) {}函數：

因為panelstruct.paneldata->panel_lp11_init在init_panel_data()函數賦值為1，

所以調用mdss_dsi_panel_reset()根據reset時序來復位panel。

static int mdss_dsi_panel_pre_init(void)
{
    intret = NO_ERROR;
    if(panelstruct.paneldata->panel_lp11_init) {
        ret= mdss_dsi_panel_reset(1);
        if(ret) {
            dprintf(CRITICAL,"panel reset failed\n");
            return ret;
        }
    }

    if(panelstruct.paneldata->panel_init_delay)
        udelay(panelstruct.paneldata->panel_init_delay);

    dprintf(SPEW,"Panel pre init done\n");
    return ret;
}

顯示logo

display_image_on_screen調用fetch_image_from_partition()從splash分區獲取lk logo圖片，如果splash分區沒有滿足要求的數據，就顯示默認的logo。

display_image_on_screen
    fetch_image_from_partition

初始化panel

主要部分見注釋：

int msm_display_on()
{
    int ret = NO_ERROR;
    int mdp_rev;
    struct msm_panel_info *pinfo;

    bs_set_timestamp(BS_SPLASH_SCREEN_DISPLAY);

    pinfo = &(panel->panel_info);

    if (pinfo->pre_on) {
        ret = pinfo->pre_on();
    }

    switch (pinfo->type) {
    //...
    case MIPI_VIDEO_PANEL:
        dprintf(INFO, "Turn on MIPI_VIDEO_PANEL.\n");
        ret = mdp_dsi_video_on(pinfo); // 使能DSI VIDEO
    
        ret = mdss_dsi_post_on(panel); // 使用初始化命令來初始化panel，包括識別屏幕（兼容有關）

        ret = mipi_dsi_on();
        break;
    case MIPI_CMD_PANEL:
        dprintf(INFO, "Turn on MIPI_CMD_PANEL.\n");
        ret = mdp_dma_on(pinfo);
        mdp_rev = mdp_get_revision();
        if (mdp_rev...) {
            ret = mipi_cmd_trigger();
        }

        ret = mdss_dsi_post_on(panel);

        break;
    default:
        return ERR_INVALID_ARGS;
    };

    if (pinfo->on)
        ret = pinfo->on();

msm_display_on_out:
    return ret;
}

打開背光

/* Turn on backlight */
if (pdata->bl_func)
    ret = pdata->bl_func(1);

在gcdb_display_init()函數中有一個函數指針mdss_dsi_bl_enable：

這個函數是用來調整背光的和使能背光的，通過PWM來作用：（具體要看原理圖）

static int mdss_dsi_bl_enable(uint8_t enable)
{
    int ret = NO_ERROR;

    ret = panel_backlight_ctrl(enable);
    if (ret)
        dprintf(CRITICAL, "Backlight %s failed\n", enable ? "enable" :
                            "disable");
    return ret;
}

static uint32_t panel_backlight_ctrl(uint8_t enable)
{
    uint32_t ret = NO_ERROR;
    if (panelstruct.backlightinfo)
        ret = target_backlight_ctrl(panelstruct.backlightinfo, enable);
    return ret;
}

所以bootloader的背光是通過target_backlight_ctrl()控制的。

int target_backlight_ctrl(struct backlight *bl, uint8_t enable)
{
    struct pm8x41_mpp mpp;
    uint32_t hw_id = board_hardware_id();
    struct board_pmic_data pmic_info;
    int rc;

    if (bl->bl_interface_type == BL_DCS)
        return 0;

    board_pmic_info(&pmic_info, 1);
    if (pmic_info.pmic_version == PM8916_VER)
        mpp.base = PM8x41_MMP4_BASE;
    else
        mpp.base = PM8x41_MMP2_BASE;

    mpp.vin = MPP_VIN0;
    if (enable) {
        pm_pwm_enable(false);
        rc = pm_pwm_config(PWM_DUTY_US, PWM_PERIOD_US);
        if (rc < 0)
            mpp.mode = MPP_HIGH;
        else {
            mpp.mode = MPP_DTEST1;
            pm_pwm_enable(true);
        }
        pm8x41_config_output_mpp(&mpp);
        pm8x41_enable_mpp(&mpp, MPP_ENABLE);
    } else {
        pm_pwm_enable(false);
        pm8x41_enable_mpp(&mpp, MPP_DISABLE);
    }
    mdelay(20);

    if (board_hardware_subtype() == HW_PLATFORM_SUBTYPE_IOE)
        bkl_gpio.pin_id = 99;

    if (enable) {
        if (hw_id == HW_PLATFORM_SURF || (hw_id == HW_PLATFORM_MTP)) {
            /* configure backlight gpio for CDP and MTP */

            gpio_tlmm_config(bkl_gpio.pin_id, 0,
                bkl_gpio.pin_direction, bkl_gpio.pin_pull,
                bkl_gpio.pin_strength, bkl_gpio.pin_state);
                gpio_set(bkl_gpio.pin_id, 2);
        }
    }

    return 0;
}

如何增加一個panel

以 video類型的 xxx 為例。

聲明panel枚舉

在oem_panel.c中添加一個panel枚舉

enum {
    ILI9881D_720P_VIDEO_PANEL,
    HX8394D_480P_VIDEO_PANEL,
    HX8394D_720P_VIDEO_PANEL,
    SHARP_QHD_VIDEO_PANEL,
    TRULY_WVGA_CMD_PANEL,
    HX8379A_FWVGA_SKUA_VIDEO_PANEL,
    ILI9806E_FWVGA_VIDEO_PANEL,
    HX8394D_QHD_VIDEO_PANEL,
    HX8379C_FWVGA_VIDEO_PANEL,
    FL10802_FWVGA_VIDEO_PANEL,
    AUO_QVGA_CMD_PANEL,
    AUO_CX_QVGA_CMD_PANEL,
    HX8394F_720P_VIDEO_PANEL,
    ILI9881C_720P_VIDEO_PANEL,
    GC9306_QVGA_SPI_CMD_PANEL,
    XXX_VIDEO_PANEL, // 舉個例子
    UNKNOWN_PANEL
};

綁定panel枚舉與具體的panel屬性

1、增加相應的頭文件#include "include/xxx_video.h"

頭文件可以通過GCDB工具配置生成、懶得做也可以找供應商要。

頭文件放在：bootable/bootloader/lk/dev/gcdb/display/include中

2、在supp_panels中添加綁定

3、照貓畫虎添加對應的屬性。對應的屬性來自xx_panel.h（具體由GCDB生成）

#include "include/xxx_video.h"

// 如果要增加一個panel就需要在這里增加一個supp_panels
static struct panel_list supp_panels[] = {
    {"truly_1080p_video", TRULY_1080P_VIDEO_PANEL},
    {"truly_1080p_cmd", TRULY_1080P_CMD_PANEL},
    {"r69006_1080p_video", R69006_1080P_VIDEO_PANEL},
    {"r69006_1080p_cmd", R69006_1080P_CMD_PANEL},
    {"truly_wuxga_video", TRULY_WUXGA_VIDEO_PANEL},
    {"nt35523_720p_video", NT35523_720P_VIDEO_PANEL},
    {"xxx_video", XXX_VIDEO_PANEL}, // 新增綁定
};


static int init_panel_data(struct panel_struct *panelstruct,
            struct msm_panel_info *pinfo,
            struct mdss_dsi_phy_ctrl *phy_db)
{
    int pan_type = PANEL_TYPE_DSI;

    switch (panel_id) {
    case GC9306_QVGA_SPI_CMD_PANEL:
        panelstruct->paneldata    = &gc9306_qvga_cmd_panel_data;
        panelstruct->panelres     = &gc9306_qvga_cmd_panel_res;
        panelstruct->color        = &gc9306_qvga_cmd_color;
        panelstruct->panelresetseq
                    = &gc9306_qvga_cmd_reset_seq;
        panelstruct->backlightinfo = &gc9306_qvga_cmd_backlight;
        pinfo->spi.panel_cmds
                    = gc9306_qvga_cmd_on_command;
        pinfo->spi.num_of_panel_cmds
                    = GC9306_QVGA_CMD_ON_COMMAND;
        pan_type = PANEL_TYPE_SPI;
        break;
    // 添加 屬性
    case XXX_VIDEO_PANEL:
        // 照貓畫虎添加對應的屬性。
    case UNKNOWN_PANEL:
    default:
        memset(panelstruct, 0, sizeof(struct panel_struct));
        memset(pinfo->mipi.panel_cmds, 0, sizeof(struct mipi_dsi_cmd));
        pinfo->mipi.num_of_panel_cmds = 0;
        memset(phy_db->timing, 0, TIMING_SIZE);
        pan_type = PANEL_TYPE_UNKNOWN;
        break;
    }
    return pan_type;
}

為平台指定Panel枚舉

在oem_panel_select()函數中指定對應平台的panel_id = XXX_VIDEO_PANEL;：

這個函數需要做的工作是：主要是識別不同IC，賦值給參數panel_id，panel_id的使用在同一文件中的 init_panel_data()函數中。

int oem_panel_select(const char *panel_name, struct panel_struct *panelstruct,
            struct msm_panel_info *pinfo,
            struct mdss_dsi_phy_ctrl *phy_db)
{
    //...
    switch (hw_id) {
    case xx:
        panel_id = XXX_VIDEO_PANEL;
        break;
            
    default:
        dprintf(CRITICAL, "Display not enabled for %d HW type\n",
            hw_id);
        return PANEL_TYPE_UNKNOWN;
    }
    //...
}

附錄：LCD參數說明

VBPD(verticalback porch)：表示在一幀圖像開始時，垂直同步信號以后的無效的行數。

VFPD(verticalfront porch)：表示在一幀圖像結束后，垂直同步信號以前的無效的行數。

VSPW(verticalsync pulse width)：表示垂直同步脈沖的寬度，用行數計算。

HBPD(horizontal back porch)：表示從水平同步信號開始到一行的有效數據開始之間的VCL的個數。

HFPD(horizontal front porch)：表示一行的有效數據結束到下一個水平同步信號開始 之間的VCLK的個數。

HSPW(horizontalsync pulse width)：表示水平同步信號的寬度，用VCLK計算

附錄：根據target選擇不同的target_display

不同的平台有相同的target_display.c，例如：

 bootable/bootloader/lk/target/msm8909/target_display.c
 bootable/bootloader/lk/target/target_display.c
 bootable/bootloader/lk/target/msm8974/target_display.c
 bootable/bootloader/lk/target/msm8994/target_display.c
 bootable/bootloader/lk/target/apq8084/target_display.c
 bootable/bootloader/lk/target/msm8610/target_display.c
 bootable/bootloader/lk/target/msm7627a/target_display.c
 bootable/bootloader/lk/target/msm8960/target_display.c
 bootable/bootloader/lk/target/msm8226/target_display.c
 bootable/bootloader/lk/target/msm8916/target_display.c

實際上根據編譯系統，很容易找到對應的文件是怎么編譯的。

• bootable/bootloader/lk/makefile:134:include target/$(TARGET)/rules.mk

• bootable/bootloader/lk/target/rules.mk

LOCAL_DIR := $(GET_LOCAL_DIR)

OBJS += \
    $(LOCAL_DIR)/init.o \
    $(LOCAL_DIR)/target_display.o

最終由lunch的項目來決定：

project/apq8084.mk:9:ifeq ($(TARGET_BUILD_VARIANT),user)
project/msm7627a.mk:5:TARGET := msm7627a
project/msm8909.mk:5:TARGET := msm8909
project/msm8909.mk:9:ifeq ($(TARGET_BUILD_VARIANT),user)
project/msm8960.mk:5:TARGET := msm8960
project/msm8960.mk:9:ifeq ($(TARGET_BUILD_VARIANT),user)
project/qsd8250_surf.mk:5:TARGET := qsd8250_surf
project/msm8226.mk:5:TARGET := msm8226
project/msm8226.mk:9:ifeq ($(TARGET_BUILD_VARIANT),user)
project/aboot-surf7k.mk:5:TARGET := surf-msm7k
project/fsm9010.mk:5:TARGET := fsm9010
project/fsm9010.mk:9:ifeq ($(TARGET_BUILD_VARIANT),user)
project/msm8660_surf.mk:5:TARGET := msm8660_surf