LCD 常见问题

[English]

本节主要描述调试和使用LCD过程中常遇到的问题和解决方法。 异常可以分为display模块不出图，display模块输出图像但是屏幕没有刷图，出图了但是显示花屏，针对不同的异常，在此列出了一些常见的分析思路。

Q: display软件不打印帧率？

A：当模块正常刷屏，每2秒会有如下帧率显示的log打印,log示例如下：

media_ui:I(43896008):dec:15[63298], lcd:58[4], lcd_fps:0[0], lvgl:0[0]

其中 dec为解码的帧率，lcd为模块硬件刷屏的物理帧率，lcd_fps为有效帧率一般和dec帧率对应，[]中的为历史积累帧率,该问题是指lcd一直为0。 客户遇到这种问题一般是软件问题，程序没有执行到display request，这是需要检查代码流程是否跑到显示这一步。

Q：display软件打印帧率,但是LCD不亮？

A: 这种问题一般先检查硬件，从以下几个方面检查;

  • LCD子板硬件接线是否接反

  • 背光引脚是否正确，背光是否亮了

  • 对于需要SPI初始化LCD的屏幕，检查SPI引脚接线是否正确，使用逻辑分析仪检查初始化命令是否正确。

如果硬件没有问题，需要分析是否屏幕的初始化错误，导致LCD刷屏失败，这是最常见的问题， 此时需要检查屏幕参数的配置或者需要联系屏厂检查初始化代码，用户可以从以下方面考虑：

  • 该屏幕是否参与编译，是否使能

  • 该屏幕时序配置范围是否和 lcd spec对应，参数是否超过或不满足其正常工作，即：

       static const lcd_rgb_t lcd_rgb =
       {
               .clk = LCD_30M,
               .data_out_clk_edge = NEGEDGE_OUTPUT,

               .hsync_pulse_width = 2,
               .vsync_pulse_width = 2,
               .hsync_back_porch = 46,
               .hsync_front_porch = 48,
               .vsync_back_porch = 24,
               .vsync_front_porch = 24,
       };

- 屏幕设置的分辨率不能为0，如果为0,也会导致黑屏

Q： LCD显示花屏？

A:一般这个现象出现的原因有：

  • RGB的某个引脚没有使能为RGB功能，会导致颜色大块异常

  • 图像的分辨率和LCD的是否匹配，不匹配会导致显示一半，或切屏。

  • 图像的数据格式是否为RGB数据，如果为YUV数据显示异常。

  • 图象解码错误，错误的原因分析请参考 JPEG decode

Q： LCD显示有撕裂？

A：如果屏幕支持TE功能，可以配置TE，或者软件上使用双buffer显示

Q： 如何设置RGB屏的RGB666/RGB888/RGB565接口？

A：用户可以参考外设应用工程lcd_rgb565,lcd_rgb666,lcd_rgb888的工程配置

用户可以在LCD的配置源文件中修改默认的输入输出格式，比如：

const lcd_device_t lcd_device_st7701sn =
{
        .id = LCD_DEVICE_ST7701SN,
        .name = "st7701sn",
        .type = LCD_TYPE_RGB565,    /**< lcd device hw interface *LCD_TYPE_RGB=LCD_TYPE_RGB565 */
        .ppi = PPI_480X854,
        .rgb = &lcd_rgb,
        .src_fmt = PIXEL_FMT_YUYV,   /**< source data format: input to display module data format(rgb565/rgb888/yuv)*/
        .out_fmt = PIXEL_FMT_RGB888, /**< display module output data format(rgb565/rgb666/rgb888), input to lcd device,*/
        .init = lcd_st7701sn_init,
        .lcd_off = NULL,
};

即设置Display模块的输入数据源是YUYV数据，屏幕的RGB接口是RGB888，display模块内部将YUYV数据转换为RGB888，输出给LCD。

如果是如下设置：

.src_fmt = PIXEL_FMT_rgb565,   /**< source data format: input to display module data format(rgb565/rgb888/yuv)*/
.out_fmt = PIXEL_FMT_RGB565, /**< display module output data format(rgb565/rgb666/rgb888), input to lcd device,*/

即设置Display模块的输入数据源是RGB565数据，屏幕的RGB接口是RGB565，display模块直接将RGB565数据输出给LCD。

也可以是如下设置:

.src_fmt = PIXEL_FMT_RGB888,   /**< source data format: input to display module data format(rgb565/rgb888/yuv)*/
.out_fmt = PIXEL_FMT_RGB666, /**< display module output data format(rgb565/rgb666/rgb888), input to lcd device,*/

即设置Display模块的输入数据源是RGB888数据，屏幕的RGB接口是RGB666，display模块内部将RGB888数据转换为RGB666，输出给LCD。

Q： 如何设置MCU屏的数据线是8线（D0-7）还是16线（D0-15）的RGB565/666/888接口？

A:

  • RGB565只支持8线输出：out_fmt = PIXEL_FMT_RGB565;

  • RGB666只支持16线输出：out_fmt = PIXEL_FMT_RGB666

  • RGB888即支持8线也支持16线输出:out_fmt = PIXEL_FMT_RGB888 或 out_fmt = PIXEL_FMT_RGB888_16BIT

用户可以在LCD的配置源文件中修改默认的输入输出格式，比如：

const lcd_device_t lcd_device_st7796s =
{
        .id = LCD_DEVICE_ST7796S,
        .name = "st7796s",
        .type = LCD_TYPE_MCU8080,
        .ppi = PPI_320X480,
        .src_fmt = PIXEL_FMT_YUYV;
        .out_fmt = PIXEL_FMT_RGB565;
        .mcu = &lcd_mcu,
        .init = lcd_st7796s_init,
        .lcd_off = st7796s_lcd_off,
};

即设置Display模块的输入数据源是YUYV数据，MCU接口是8线RGB565，display模块内部将YUYV数据转换为RGB565，输出给MCU LCD。

这两个参数配置也可以通过API设置：

 /*
  * mcu input RGB565, rgb888. yuv dormat
  * mcu output RGB565 rgb666, rgb888
  */
void lcd_hal_mcu_set_in_out_format(pixel_format_t in_fmt, pixel_format_t out_fmt)

Q： 选择RGB565或RGB666接口时，没有使用的IO是RGB的高位还是低位，可以作为普通IO使用吗？

A：RGB565或RGB666是高位有效，即选择RGB565时R0-R2, G0-G1,B0-B2这8个引脚可以作为普通GPIO使用。

Q： 解码一直失败, 打印“jpeg_decode_err_handler” 或“jpeg_decoder_isr int status = 0x200”

A: 解码失败的原因一般有：

  • 图片头数据不完整或遭到破坏，无法解析出文件头,可以先保存图片，检查是否能正常显示。

  • 摄像头出来的jpeg格式带DRI(define restart interval)段（字节码0xFFDD）的,工程默认配置不支持DRI的图片解码，需要将支持DRI的宏打开，即在工程目录<config/bk7258_cp1/bk7558_cp1/config>文件中添加CONFIG_JPEGDEC_HW_SUPPORT_DRI=y