2025-10-10 16:07:00 +08:00

175 lines
6.6 KiB
ReStructuredText
Executable File
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

LCD 常见问题
=================================
:link_to_translation:`en:[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这是需要检查代码流程是否跑到显示这一步。
Qdisplay软件打印帧率,但是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 <../../video_codec/jpeg_decoding_hw/index.html>`_
Q LCD显示有撕裂
----------------------------------------
A如果屏幕支持TE功能可以配置TE或者软件上使用双buffer显示
Q 如何设置RGB屏的RGB666/RGB888/RGB565接口
----------------------------------------------
A用户可以参考外设应用工程lcd_rgb565,lcd_rgb666,lcd_rgb888的工程配置
`lcd_rgb565 <../../projects/peripheral/lcd_rgb565/index.html>`_
用户可以在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接口是RGB888display模块内部将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接口是RGB565display模块直接将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接口是RGB666display模块内部将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线RGB565display模块内部将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使用吗
--------------------------------------------------------------------------------------
ARGB565或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