如何在MCU上快速點(diǎn)亮一款LCD屏(MIPI DSI篇)？

大家好，我是痞子衡，是正經(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)用中選擇的屏五花八門(mén)（生產(chǎn) MIPI DSI 接口的 LCD 廠商非常多），如果我們拿到一款全新 LCD 屏，該如何快速點(diǎn)亮它呢？今天痞子衡教你方法：

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

磨刀不誤砍柴工，在開(kāi)始點(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.?能夠訪問(wèn)?github

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

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

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

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

SDK_2_14_0_MIMXRT1170-EVKBboardsevkbmimxrt1170driver_exampleselcdifrgbcm7iar

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

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

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

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

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

elcdif_rgb 例程會(huì)在共享函數(shù) BOARD_InitLcdPanel() 里操作 BOARD_MIPI_PANEL_BL 宏所指向的 GPIO 來(lái)打開(kāi)背光。此外 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)代碼保證編譯通過(guò)（后續(xù)再參考 ILI9806E 數(shù)據(jù)手冊(cè)修改代碼）。

SDK_2_14_0_MIMXRT1170-EVKBcomponentsvideodisplay

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

有了 fsl_ili9806e.c/h 基本源文件后，現(xiàn)在我們需要根據(jù) ILI9806E 數(shù)據(jù)手冊(cè)來(lái)修改代碼。首先是調(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)來(lái)做的延時(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è)萬(wàn)能驅(qū)動(dòng)芯片，其支持的接口很多，MIPI DSI 僅是其一，而且 2.5 節(jié)里設(shè)置的那些關(guān)于屏顯示相關(guān)參數(shù)，我們都需要設(shè)置進(jìn) ILI9806E 內(nèi)部寄存器里。

打開(kāi) ILI9806E 數(shù)據(jù)手冊(cè)（V097版），一共 328 頁(yè)，寄存器一大堆，我們難道要看著數(shù)據(jù)手冊(cè)一個(gè)個(gè)去設(shè)置嗎？當(dāng)然不是！這時(shí)候需要打開(kāi)萬(wàn)能的 github，搜索跟 ili9806e 相關(guān)的代碼，看看前人有沒(méi)有調(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)該能看到屏開(kāi)始正常工作了。

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