大家好，我是痞子衡，是正經(jīng)搞技術(shù)的痞子。今天痞子衡給大家分享的是在i.MXRT1170上快速點(diǎn)亮一款全新LCD屏的方法與步驟。

我們知道 LCD 屏的接口有很多：DPI-RGB、MIPI DSI、DBI/MCU（I8080）、LVDS、SPI 等等，接口不同，對(duì)應(yīng)的軟件驅(qū)動(dòng)也不同。RT1170 片內(nèi)外設(shè)對(duì)以上接口都能很好地支持，今天我們主要聊最近比較火的 MIPI DSI 接口。

在恩智浦官方 SDK (v2.14) 里目前支持的 MIPI DSI 接口的 LCD 屏主要有如下四款，但客戶在實(shí)際應(yīng)用中選擇的屏五花八門（生產(chǎn) MIPI DSI 接口的 LCD 廠商非常多），如果我們拿到一款全新 LCD 屏，該如何快速點(diǎn)亮它呢？今天痞子衡教你方法：

一、點(diǎn)屏準(zhǔn)備工作

磨刀不誤砍柴工，在開始點(diǎn)屏之前我們需要準(zhǔn)備如下材料，這在后續(xù)修改和調(diào)試 LCD 屏相關(guān)代碼時(shí)非常重要。其中 LCD 屏數(shù)據(jù)手冊(cè)一般需要向屏廠獲取，有了屏數(shù)據(jù)手冊(cè)我們就能知道其相應(yīng)驅(qū)動(dòng) IC，從而下載這個(gè)驅(qū)動(dòng) IC 的數(shù)據(jù)手冊(cè)。

1. LCD 屏配套的數(shù)據(jù)手冊(cè)

2. LCD 屏內(nèi)置驅(qū)動(dòng) IC 的數(shù)據(jù)手冊(cè)

3. RT1170 板卡連接 LCD 屏的原理圖

4. 恩智浦 SDK_2_14_0_MIMXRT1170-EVKB

5. 能夠訪問 github

痞子衡就以深圳柯達(dá)科電子生產(chǎn)的 KD050FWFIA019-C019A 屏為例，這款 MIPI DSI 屏分辨率是 480x854，其驅(qū)動(dòng) IC 是來自奕力科技的 ILI9806E。

二、點(diǎn)屏標(biāo)準(zhǔn)步驟

2.1 熟悉SDK標(biāo)準(zhǔn)例程

恩智浦 SDK 里的 elcdif_rgb 例程是一個(gè)很好的基礎(chǔ)工程，我們可以基于這個(gè)工程來修改代碼做調(diào)試。工程里我們主要關(guān)注 elcdif_support.c/h 文件，在這個(gè)文件里，恩智浦已經(jīng)把不同屏之間的差異做了抽離處理，你搜索 MIPI_PANEL_ 宏就能找到那些差異，這些差異的地方就是我們需要改動(dòng)的地方。

\SDK_2_14_0_MIMXRT1170-EVKB\boards\evkbmimxrt1170\driver_examples\elcdif\rgb\cm7\iar

這個(gè) elcdif_rgb 例程里沒有看到 G1120B0MIPI 身影，因?yàn)樾》直媛实膱A屏不太適合這個(gè) example，其驅(qū)動(dòng)可在 RT595_SDK\boards\evkmimxrt595\vglite_examples 里找到。

2.2 調(diào)整屏控制I/O腳（Power_en、Reset、Backlight）

先來關(guān)注硬件上需要注意的改動(dòng)，RT1170 上 MIPI DSI 這個(gè)外設(shè)（2 Lane）不同于其它外設(shè)有很多 pinmux 選項(xiàng)，其就一組固定的引腳（并且是專用的），所以這組引腳我們不需要做任何代碼上的配置。

但是 LCD 屏除了 MIPI DSI 相關(guān)信號(hào)以及電源、地之外，通常還有三個(gè)控制信號(hào)，即 Power_en（電源使能-可選）、Reset（硬復(fù)位）、Backlight（背光控制），這三個(gè)信號(hào)一般是通過普通 GPIO 來控制的。

所以我們需要打開板卡原理圖，找到 LCD 相關(guān)連接把這三個(gè)信號(hào)所用的 GPIO 找出來，并在代碼里如下地方做相應(yīng)改動(dòng)：

elcdif_rgb 例程會(huì)在共享函數(shù) BOARD_InitLcdPanel() 里操作 BOARD_MIPI_PANEL_BL 宏所指向的 GPIO 來打開背光。此外 BOARD_MIPI_PANEL_RST 和 BOARD_MIPI_PANEL_POWER 宏所指向的 GPIO 操作已經(jīng)被封裝在如下函數(shù)里，這個(gè)函數(shù)被進(jìn)一步封裝進(jìn) display_handle_t 里供后續(xù)驅(qū)動(dòng)靈活使用：

static void PANEL_PullResetPin(bool pullUp);
static void PANEL_PullPowerPin(bool pullUp);

2.3 創(chuàng)建LCD驅(qū)動(dòng)IC源文件

現(xiàn)在我們需要在如下目錄下，創(chuàng)建 ILI9806E 的驅(qū)動(dòng)文件，可以先直接拷貝 hx8394 文件夾下的文件并將其改名后添加進(jìn)工程，并且在 elcdif_support.c/h 里也復(fù)制添加相應(yīng)代碼保證編譯通過（后續(xù)再參考 ILI9806E 數(shù)據(jù)手冊(cè)修改代碼）。

\SDK_2_14_0_MIMXRT1170-EVKB\components\video\display

2.4 調(diào)整屏上電復(fù)位延時(shí)（Power_en、Reset）

有了 fsl_ili9806e.c/h 基本源文件后，現(xiàn)在我們需要根據(jù) ILI9806E 數(shù)據(jù)手冊(cè)來修改代碼。首先是調(diào)整屏上電以及復(fù)位延時(shí)時(shí)間，這個(gè)延時(shí)一般既可以在 KD050FWFIA019-C019A 屏的數(shù)據(jù)手冊(cè)也可以在 ILI9806E 的數(shù)據(jù)手冊(cè)里找到。

有了延時(shí)數(shù)值之后，在 ILI9806E_Init() 函數(shù)里做相應(yīng)設(shè)置即可：

status_t ILI9806E_Init(display_handle_t *handle, const display_config_t *config)
{
    const ili9806e_resource_t *resource = (const ili9806e_resource_t *)(handle->resource);
    /* Only support 480 * 854 */
    if (config->resolution != FSL_VIDEO_RESOLUTION(480, 854))
    {
        return kStatus_InvalidArgument;
    }
    /* Power on. */
    resource->pullPowerPin(true);
    ILI9806E_DelayMs(1U);
    /* 根據(jù)屏數(shù)據(jù)手冊(cè)調(diào)整復(fù)位延時(shí)時(shí)間. */
    resource->pullResetPin(true);
    ILI9806E_DelayMs(10U);
    resource->pullResetPin(false);
    ILI9806E_DelayMs(10U);
    resource->pullResetPin(true);
    ILI9806E_DelayMs(120U);
    
    /* 代碼省略 */
}

2.5 調(diào)整屏顯示相關(guān)參數(shù)

現(xiàn)在我們需要在 elcdif_support.h 里根據(jù) KD050FWFIA019-C019A 屏的數(shù)據(jù)手冊(cè)修改如下定義包含：屏分辨率、六個(gè)行列掃描參數(shù)、四個(gè)信號(hào)極性(APP_POL_FLAGS)、數(shù)據(jù)位寬，這些都是屏本身的特性。

#if (USE_MIPI_PANEL == MIPI_PANEL_KD050FWFIA019)
#define APP_PANEL_HEIGHT 854
#define APP_PANEL_WIDTH  480
#define APP_HSW          4
#define APP_HFP          18
#define APP_HBP          30
#define APP_VSW          4
#define APP_VFP          20
#define APP_VBP          30
#endif
#define APP_POL_FLAGS \
    (kELCDIF_DataEnableActiveHigh | kELCDIF_VsyncActiveLow | kELCDIF_HsyncActiveLow | kELCDIF_DriveDataOnFallingClkEdge)

#define APP_DATA_BUS       24
#define APP_LCDIF_DATA_BUS kELCDIF_DataBus24Bit

關(guān)于六個(gè)行列掃描參數(shù)（HSW/HFP/HBP/VSW/VFP/VBP）稍稍科普一下，這些信號(hào)是以行列同步信號(hào)(VSYNC/HSYNC)為時(shí)間起點(diǎn)來做的延時(shí)，相當(dāng)于在實(shí)際顯示的圖像寬高基礎(chǔ)上做了外圍擴(kuò)大，從而提高圖像有效區(qū)域顯示的可靠性（實(shí)際上是等待面板做好每行數(shù)據(jù)刷新前的準(zhǔn)備工作）。

分辨率和行列掃描參數(shù)均設(shè)置正確了之后，別忘了根據(jù)想要的刷新率（比如 60Hz）計(jì)算得出所需的 pixel clock，在 BOARD_InitLcdifClock() 函數(shù)里做相應(yīng)設(shè)置。

void BOARD_InitLcdifClock(void)
{
    /*
     * The pixel clock is (height + VSW + VFP + VBP) * (width + HSW + HFP + HBP) * frame rate.
     * Use PLL_528 as clock source.
     * For 60Hz frame rate, the KD050FWFIA019 pixel clock should be 29MHz.
     */
    const clock_root_config_t lcdifClockConfig = {
        .clockOff = false,
        .mux      = 4, /*!< PLL_528. */
#if (USE_MIPI_PANEL == MIPI_PANEL_RK055AHD091) || (USE_MIPI_PANEL == MIPI_PANEL_RK055MHD091)
        .div = 9,
#elif (USE_MIPI_PANEL == MIPI_PANEL_RK055IQH091)
        .div = 15,
#elif (USE_MIPI_PANEL == MIPI_PANEL_KD050FWFIA019)
        // 我們需要設(shè)置 29MHz 的 pixel clock
        .div = 18,
#endif
    };
    CLOCK_SetRootClock(kCLOCK_Root_Lcdif, &lcdifClockConfig);
    mipiDsiDpiClkFreq_Hz = CLOCK_GetRootClockFreq(kCLOCK_Root_Lcdif);
}

2.6 配置LCD驅(qū)動(dòng)芯片

現(xiàn)在到了最難也是最重要的環(huán)節(jié)了，KD050FWFIA019-C019A 面板主要是由 ILI9806E 芯片驅(qū)動(dòng)的，ILI9806E 本身是個(gè)萬能驅(qū)動(dòng)芯片，其支持的接口很多，MIPI DSI 僅是其一，而且 2.5 節(jié)里設(shè)置的那些關(guān)于屏顯示相關(guān)參數(shù)，我們都需要設(shè)置進(jìn) ILI9806E 內(nèi)部寄存器里。

打開 ILI9806E 數(shù)據(jù)手冊(cè)（V097版），一共 328 頁(yè)，寄存器一大堆，我們難道要看著數(shù)據(jù)手冊(cè)一個(gè)個(gè)去設(shè)置嗎？當(dāng)然不是！這時(shí)候需要打開萬能的 github，搜索跟 ili9806e 相關(guān)的代碼，看看前人有沒有調(diào)試好的現(xiàn)成代碼。

其實(shí)關(guān)于屏的支持，Linux 里做得比較多，痞子衡找了個(gè) RaspberryPI 移植的分支，里面有 ili9806e 參數(shù)初始化表，注意這個(gè)表不一定完全適用 KD050FWFIA019-C019A（因?yàn)橛?ILI9806E 芯片驅(qū)動(dòng)的面板非常多），我們需要在這個(gè)參數(shù)表基礎(chǔ)之上做一些調(diào)整。

https://github.com/raspberrypi/linux/blob/rpi-6.1.y/drivers/gpu/drm/panel/panel-ilitek-ili9806e.c

把 RaspberryPI 倉(cāng)庫(kù)里的參數(shù)表移植進(jìn)我們的 fsl_ili9806e.c 文件里后，粗粗看了一下注釋，其配置的是 480x800 的屏，極性設(shè)置相關(guān)也都和 KD050FWFIA019-C019A 有差異。

最后我們?cè)賹?duì)照 ILI9806E 數(shù)據(jù)手冊(cè)里的寄存器定義做一些參數(shù)上的微調(diào)，如下四個(gè)寄存器需要重點(diǎn)關(guān)注。這些微調(diào)做完之后，把代碼下載進(jìn)板卡運(yùn)行，這時(shí)候你應(yīng)該能看到屏開始正常工作了。

至此，在i.MXRT1170上快速點(diǎn)亮一款全新LCD屏的方法與步驟痞子衡便介紹完畢了，掌聲在哪里~~~