如何定位花屏和界面错乱等绘制异常的问题

[DESCRIPTION]

在测试手机各项功能过程中，经常会遇到概率性复现“屏幕画花了，界面画错乱了等绘制异常问题”，而且概率还非常小；
这类问题请不要直接提交eService，而是先请测试人员及工程师保留住测试现场，然后根据此条FAQ的步骤进行排查；
通常贵司提交问题的时候所提供的资料太少，无法直接定位问题，与其提交了eService之后再又去花时间复现，不如在复现问题的当下，就先按照本文的步骤做一个初步排查和分析。
如果在排查过程中，分析问题遇到困难，再将已经排查的结果以及排查过程中每一步所生成的资料和复现问题的log一并提交到eService。
这样的话我们就能获得较全面的资料并接着之前的排查结果做进一步分析，不然的话，我们还是需要贵司安排测试人员再花时间去复现，然后按照步骤抓取我们需要的资料，这大大降低了双方的工作效率，所以这个方法就是为了减少双方的工作量。
下图是显示相关的流程图：

5.13tp-4.png (352.23 KB, 下载次数: 0 )

下载附件  保存到相册

2016-5-13 10:12 上传

[SOLUTION]

在如下3个大的check步骤中，请分别按照每一步的操作来进行排查；如果贵司有定位到某一个问题
点，请在提eService时，将问题排查过程写清楚，并提供相应的资料到eService附件中，以便
MTK做进一步分析。
1.通过DDMS或GAT tool获取异常界面的屏幕截图
[Android 5.0版本之前]DDMS截图方法如下：Device-->Screencapture，点击
Screencapture，就能抓到当前刷到LCM屏上的那帧数据,或者通过Eclipse中的DDMS工具的
screen capture功能，点击操作面板上的“照相机”图标即可。
=>如果屏幕截图是ok的，那么问题点就在LCM driver或timing，具体问题要具体分析。
=>如果屏幕截图not ok，那么你需要进入第2步去获取并查看FrameBuffer中的数据。
[Android 5.0版本及以后]
Android L版本上抓取到的DDMS截图，不是ovl output，而是GPU composer之后的画面。
若要抓取ovl output，可以输入如下命令
adb shell
system/bin/lcdc_screen_cap /data/fb.bin
2.获取FrameBuffer中的数据
对于android 4.1及以后的版本，通过如下方法抓取FrameBuffer中的数据：
先做如下操作，再dumpframebuffer数据
先进入手机中Settings->Developeroptions->DisableHWoverlays
再勾选DisableHWoverlays
抓取framebuffer数据：
adbshell
cat/dev/graphics/fb0>/data/fb.bin
然后将fb.binadbpush出来，通过工具查看fb.bin
=>如果此步骤的屏幕截图是ok那说明是LCM controller做overlay时出了问题。
需要把寄存器值打出来(保存在kernel log中)，再抓kernel log做进一步分析
打印寄存器的值：
请在当前刷屏时，将LCM controller寄存器打印出来，寄存器打印命令如下：
adbshell
echoreg:lcd>sys/kernel/debug/mtkfb
这条命令会将LCMcontroller的寄存器打印到kernel log
抓kernel log的方式：要么开启mobile log，要么单独用adb命令抓取kernellog；
用adb命令抓取kernel log的方法是：adb shell cat /proc/kmsg > kernel_log.txt
如果分析问题原因是出在这一步，遇到困难时，请将抓取的资料都提供到eService附件中。
=>如果此步骤的屏幕截图not ok，那么就需要进入第3步，抓取layerdump
3、抓取layerdump
在异常界面下，手机连接usb，执行抓取layerdump，抓取的方法根据android的版本不同而不同，下面会分别列出不同版本的抓取方法：
android 4.0~4.4的版本，分别介绍在windows环境下和linux 环境下如何抓取
layerdump
在Windows系统环境下，将如下内容copy到新建文本文件中，然后保存文件为
SF_layerdump_all.bat
保持手机连接usb并且在异常界面下，在电脑端双击鼠标执行该脚本(请在Windows系统下执行)
，就会在脚本所在路径下生成一个文件SF_layerdump_all
将SF_layerdump_all和复现问题的mobile log一并提供到eService附件中。
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
SET raw=%1
SET layerdump=%2
IF "%raw%"=="" SET raw=0
IF "%layerdump%"=="" SET layerdump=-1
adb shell setprop debug.sf.layerdump.raw %raw%
adb shell setprop debug.sf.layerdump %layerdump%
adb shell dumpsys SurfaceFlinger > SF_layerdump_all.log
adb shell mkdir /data/SF_dump
adb shell mv /data/*.png /data/SF_dump
adb shell mv /data/*.i420 /data/SF_dump
adb shell mv /data/*.yv12 /data/SF_dump
adb shell mv /data/*.RGBA /data/SF_dump
adb shell mv /data/*.RGB565 /data/SF_dump
rmdir /S /Q SF_layerdump_all
md SF_layerdump_all
move SF_layerdump_all.log SF_layerdump_all
adb pull /data/SF_dump SF_layerdump_all/
adb shell rm /data/SF_dump/*
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
注意：如果异常画面是动态的，不是那种静止不动的画面，那么可以尝试多执行几次layerdump
，尽量争取能抓到发生问题时的画面的layerdump
如果不方便在Windows系统下抓取layerdump，那么就在linux系统的Terminal 下，按
照如下步骤执行下面的指令:
在复现问题前，下如下这条命令，做设置并打开layerdump的开关：
adb shell setprop debug.sf.layerdump.raw 1
adb shell setprop debug.sf.layerdump -1
在即将开始复现问题前，先将下面的指令准备好，在复现问题的画面，敲回车执行这
条命令，就是做layerdump的动作，
如果复现问题的画面是动态的，请多下几次这条命令，尽量把复现问题的画面dump下来
adb shell dumpsys SurfaceFlinger >SF_layerdump_all.log
执行了上面的第3条命令之后，会在手机的/data/SF_dump目录下生成一些xxx.png或
*.i420,*.yv12,*.RGBA,*.RGB565等文件，请把data/SF_dump这个目录pull出来提供
给我们，还有SF_layerdump_all.log文件也一并需要提供。
android 5.0及以后的版本，在windows环境下如何抓取layerdump
在Windows系统环境下
若异常画面是静态稳定的，将如下内容copy到新建文本文件中，然后保存文件为
SF_bqdump_L.bat
@echo off
adb shell rm /data/SF_dump/*
adb shell setprop debug.bq.dump "@surface"
adb shell "dumpsys SurfaceFlinger" > SF_bqdump_all.log
adb shell setprop debug.bq.dump ""
rmdir /S /Q SF_bqdump_all
md SF_bqdump_all
move SF_bqdump_all.log SF_bqdump_all
adb pull /data/SF_dump SF_bqdump_all/
adb shell rm /data/SF_dump/*
echo "Please view dump files in folder 'SF_bqdump_all'"
pause
若异常画面是一闪而过的，则需用如下脚本dump画面刷新过程的几十帧画面，下面是设置30帧
：SF_cont_bqdump_L_30.bat
复现问题后，双击执行下面的脚本，接着按命令行提示“按电脑任意键继续”，然后等几秒钟，系统会自动dump复现过程的所有帧到指定目录
@echo off
adb shell rm /data/SF_dump/*
:: Modified this line to set surface count,default is 30
adb shell setprop debug.bq.dump "@surface#30"
adb shell "dumpsys SurfaceFlinger > /dev/null"
pause
adb shell setprop debug.bq.dump "@surface"
adb shell "dumpsys SurfaceFlinger" > SF_bqdump_all.log
adb shell setprop debug.bq.dump ""
rmdir /S /Q SF_bqdump_all
md SF_bqdump_all
move SF_bqdump_all.log SF_bqdump_all
adb pull /data/SF_dump SF_bqdump_all/
adb shell rm /data/SF_dump/*
echo "Please view dump files in folder 'SF_bqdump_all'"
pause
注意：抓取到layerdump后，请将layerdump的所生成的文件SF_layerdump_all(在Linux环境下就是手机的data/SF_dump目录和SF_layerdump_all.log文件)和复现问题的mobile
log一并提交到eService上来。
抓到layerdump之后，根据layerdump的结果，再做下一步分析；
如果layerdump看到的目标画面not ok，则参考如下FAQ做进一步确认，看是app本身的问题还是UI