如何在i.MXRT1170上快速点亮一款全新LCD屏？

我们知道 LCD 屏的接口有很多：DPI-RGB、MIPI DSI、DBI/MCU（I8080）、LVDS、SPI 等等，接口不同，对应的软件驱动也不同。RT1170 片内外设对以上接口都能很好地支持，今天我们主要聊最近比较火的 MIPI DSI 接口。

在恩智浦官方 SDK (v2.14) 里目前支持的 MIPI DSI 接口的 LCD 屏主要有如下四款，但客户在实际应用中选择的屏五花八门（生产 MIPI DSI 接口的 LCD 厂商非常多），如果我们拿到一款全新 LCD 屏，该如何快速点亮它呢？今天痞子衡教你方法：

LCD屏型号	LCD分辨率	LCD驱动IC
晶鸿电子 RK055AHD091	720×1280	瑞鼎科技 RM68200
晶鸿电子 RK055MHD091	720×1280	奇景光电 HX8394-F
晶鸿电子 RK055IQH091	540×960	瑞鼎科技 RM68191
定制屏 G1120B0MIPI	390×390	瑞鼎科技 RM67162

一、点屏准备工作

磨刀不误砍柴工，在开始点屏之前我们需要准备如下材料，这在后续修改和调试 LCD 屏相关代码时非常重要。其中 LCD 屏数据手册一般需要向屏厂获取，有了屏数据手册我们就能知道其相应驱动 IC，从而下载这个驱动 IC 的数据手册。

痞子衡就以深圳柯达科电子生产的 KD050FWFIA019-C019A 屏为例，这款 MIPI DSI 屏分辨率是 480×854，其驱动 IC 是来自奕力科技的 ILI9806E。

二、点屏标准步骤

2.1 熟悉SDK标准例程

恩智浦 SDK 里的 elcdif_rgb 例程是一个很好的基础工程，我们可以基于这个工程来修改代码做调试。工程里我们主要关注 elcdif_support.c/h 文件，在这个文件里，恩智浦已经把不同屏之间的差异做了抽离处理，你搜索 MIPI_PANEL_ 宏就能找到那些差异，这些差异的地方就是我们需要改动的地方。

这个 elcdif_rgb 例程里没有看到 G1120B0MIPI 身影，因为小分辨率的圆屏不太适合这个 example，其驱动可在 RT595_SDKoardsevkmimxrt595vglite_examples 里找到。

2.2 调整屏控制I/O脚（Power_en、Reset、Backlight）

先来关注硬件上需要注意的改动，RT1170 上 MIPI DSI 这个外设不同于其它外设有很多 pinmux 选项，其就一组固定的引脚（并且是专用的），所以这组引脚我们不需要做任何代码上的配置。

但是 LCD 屏除了 MIPI DSI 相关信号以及电源、地之外，通常还有三个控制信号，即 Power_en（电源使能-可选）、Reset（硬复位）、Backlight（背光控制），这三个信号一般是通过普通 GPIO 来控制的。

所以我们需要打开板卡原理图，找到 LCD 相关连接把这三个信号所用的 GPIO 找出来，并在代码里如下地方做相应改动：

elcdif_rgb 例程会在共享函数 BOARD_InitLcdPanel() 里操作 BOARD_MIPI_PANEL_BL 宏所指向的 GPIO 来打开背光。此外 BOARD_MIPI_PANEL_RST 和 BOARD_MIPI_PANEL_POWER 宏所指向的 GPIO 操作已经被封装在如下函数里，这个函数被进一步封装进 display_handle_t 里供后续驱动灵活使用：

2.3 创建LCD驱动IC源文件

现在我们需要在如下目录下，创建 ILI9806E 的驱动文件，可以先直接拷贝 hx8394 文件夹下的文件并将其改名后添加进工程，并且在 elcdif_support.c/h 里也复制添加相应代码保证编译通过（后续再参考 ILI9806E 数据手册修改代码）。

2.4 调整屏上电复位延时（Power_en、Reset）

有了 fsl_ili9806e.c/h 基本源文件后，现在我们需要根据 ILI9806E 数据手册来修改代码。首先是调整屏上电以及复位延时时间，这个延时一般既可以在 KD050FWFIA019-C019A 屏的数据手册也可以在 ILI9806E 的数据手册里找到。

有了延时数值之后，在 ILI9806E_Init() 函数里做相应设置即可：

2.5 调整屏显示相关参数

现在我们需要在 elcdif_support.h 里根据 KD050FWFIA019-C019A 屏的数据手册修改如下定义包含：屏分辨率、六个行列扫描参数、四个信号极性(APP_POL_FLAGS)、数据位宽，这些都是屏本身的特性。

关于六个行列扫描参数（HSW/HFP/HBP/VSW/VFP/VBP）稍稍科普一下，这些信号是以行列同步信号(VSYNC/HSYNC)为时间起点来做的延时，相当于在实际显示的图像宽高基础上做了外围扩大，从而提高图像有效区域显示的可靠性（实际上是等待面板做好每行数据刷新前的准备工作）。

分辨率和行列扫描参数均设置正确了之后，别忘了根据想要的刷新率（比如 60Hz）计算得出所需的 pixel clock，在 BOARD_InitLcdifClock() 函数里做相应设置。

2.6 配置LCD驱动芯片

现在到了最难也是最重要的环节了，KD050FWFIA019-C019A 面板主要是由 ILI9806E 芯片驱动的，ILI9806E 本身是个万能驱动芯片，其支持的接口很多，MIPI DSI 仅是其一，而且 2.5 节里设置的那些关于屏显示相关参数，我们都需要设置进 ILI9806E 内部寄存器里。

打开 ILI9806E 数据手册（V097版），一共 328 页，寄存器一大堆，我们难道要看着数据手册一个个去设置吗？当然不是！这时候需要打开万能的 github，搜索跟 ili9806e 相关的代码，看看前人有没有调试好的现成代码。

其实关于屏的支持，Linux 里做得比较多，痞子衡找了个 RaspberryPI 移植的分支，里面有 ili9806e 参数初始化表，注意这个表不一定完全适用 KD050FWFIA019-C019A（因为用 ILI9806E 芯片驱动的面板非常多），我们需要在这个参数表基础之上做一些调整。

把 RaspberryPI 仓库里的参数表移植进我们的 fsl_ili9806e.c 文件里后，粗粗看了一下注释，其配置的是 480×800 的屏，极性设置相关也都和 KD050FWFIA019-C019A 有差异。

最后我们再对照 ILI9806E 数据手册里的寄存器定义做一些参数上的微调，如下四个寄存器需要重点关注。这些微调做完之后，把代码下载进板卡运行，这时候你应该能看到屏开始正常工作了。