[置顶] Android L SurfaceFlinger dump信息全解(1)_dump哪个是楼层信息

SurfaceFlinger的dump信息详解

---

对于很多Android的显示问题,我们需要使用adb shell dumpsys SurfaceFlinger命令来获取SurfaceFlinger的dump信息,这对于我们分析问题有很大的帮助,因此我们这里来详细讲解下SurfaceFlinger的dump.

SurfaceFlinger的dump信息主要通过dumpAllLocked 函数来获取,因此我们这里就以android 5.0在主屏幕上的一份dump来详细说明下dump的作用.

1 特殊宏的打开

一般dump的第一行都是这样的:

这说明其实没有打开任何特殊的宏,实际上,如果一下特殊宏打开,第一行log会打印出来:

一般情况下,这些宏一个都不会打开.

2 Sync机制

第二行一般是这样的:

这行其实打印了目前使用的sync机制,这个值源于这段逻辑:

注意,一二是互斥的,三可以与一二共存.

3 DispSync参数

第三行是打印的是Vsync相关的参数:

这些参数我们还是比较熟悉的,有意思的是打印这些参数时候使用的语法:

PRId64的用法很独特,这是一种跨平台的打印64位整数的做法:

4 layer的dump

接下来就是很长的一段layer的dump,一般以这样一句话开始:

count的值来源于layersSortedByZ中layer的数量.
接下来就进入各个layer的dump,我们参考代码并以launcher所在的layer为例来解释下各行的意义:

0xb3f92000指向当前layer对象的值,括号中是当前layer的名称,id是创建layer时产生的序列号.

4.1 区域信息

接下来的两段是两个Region的dump,每个region可能包含多个区域,所以这里count也可能不等于1.
前两行的值来源于activeTransparentRegion,表示的是这个layer里面透明区域的大小.
后两行值来源于visibleRegion,表示可见区域的大小.

4.2 基本信息

上面这段dump源自这段代码:

• layerStack表示这个layer是保存在哪个layerstack中(不同的display是有不同的layerstack的,这点可以通过一个连接HDMI时的layerstack很容易确认).

• z表示Z轴坐标,z值越大,layer越靠上.

• pos的值是layer左上角的位置,这个值比较特殊的是ImageWallpaper这个layer的pos值,因为ImageWallpaper的大小大于屏幕大小,所以ImageWallpaper的pos值在屏幕的外面(note4是pos=(-560,0)).

• size自然是layer的大小

• crop代表裁剪区域,这点依然是对于壁纸很明显,因为壁纸layer大小大于屏幕,必须涉及到需要裁剪一部分显示在屏幕上,因此它的裁剪区域是crop=( 560, 0,2000,2560).
• isOpaque代表是否是不透明的,只有完全不透明的layer这个值才是1,比如壁纸,像状态栏和launcher他们都是0,代表不是完全不透明的
• invalidate表示这个layer的数据是失效的,这个值绝大多数情况下都是0.因为我们看到的一般都是绘制好的有效的数据.一种情况下这值特别频繁的多见为1,就是刚刚锁屏(解锁)时.因为突然锁屏,会导致绘制的内容和要显示的内容完全不同,导致layer的各种数据要重新计算,所以将layer置为失效.
• alpha表示了这张layer的透明度,这个值跟isOpaque是有区别的.isOpaque表示了这个layer可以是透明的,也就是没有显示数据的地方,可以透明;而alpha表示透明度,也即是有数据的地方也可以因为透明度而收到影响产生透明的效果.
• flag值含义丰富,它是众多flag或出来的结果,影响它值的包括:
• view plain copy to clipboard print ?

  1. enum {      eLayerHidden        = 0x01,     // SURFACE_HIDDEN in SurfaceControl.java      eLayerOpaque        = 0x02,     // SURFACE_OPAQUE      eLayerTransparent   = 0x200,     // SURFACE_TRANSPARENT}; enum {    ePositionChanged            = 0x00000001,    eLayerChanged               = 0x00000002,    eSizeChanged                = 0x00000004,    eAlphaChanged               = 0x00000008,    eMatrixChanged              = 0x00000010,    eTransparentRegionChanged   = 0x00000020,    eVisibilityChanged          = 0x00000040,    eLayerStackChanged          = 0x00000080,    eCropChanged                = 0x00000100,/* SRIB : Smg Surface Animator : State that will indicate animation change */        e3DAnimationChanged         = 0x00001000,/* SRIB : Smg Surface Animator : Change End*/        eOpacityChanged             = 0x00000200,// { SRUK-SFBLUR        eTranslucentRegionChanged   = 0x00000400,// SRUK-SFBLUR }        eTransparencyChanged        = 0x80000000,};enum { // (keep in sync with Surface.java)    eHidden             = 0x00000004,    eDestroyBackbuffer  = 0x00000020,    eSecure             = 0x00000080,    eNonPremultiplied   = 0x00000100,    eOpaque             = 0x00000400,    eProtectedByApp     = 0x00000800,    eProtectedByDRM     = 0x00001000,    eCursorWindow       = 0x00002000,    /* SISO Changes for Internal_Only - Start */    eFXInternalDisplay = 0x80000000,    /* SISO Changes for Internal_Only - End */    eFXSurfaceNormal    = 0x00000000,    eFXSurfaceDim       = 0x00020000,    eFXSurfaceMask      = 0x000F0000,    // begin of app fw : fixed orientation window    eFixedOrientation   = 0x40000000,    // end of app fw    // begin of MDM remote control    eNoRemoteControl      = 0x08000000,    // end of MDM remote control};  
  
  
  

所有的这些值都可能影响layer的状态,涉及不同模块不同功能,这里不再展开.

• 接下来的一组tr数据代表屏幕的旋转和缩放程度.大多数的layer实际上是不需要旋转和缩放的,因为他们定义的大小就是跟屏幕一致的,所以他们的这组数据是[1.00, 0.00][0.00, 1.00],实际上如果你使用这组数据来做矩阵变换的话,矩阵是不会发生变化的.
  需要旋转的比较典型的场景是照相机.横着拿相机时它的layer的变换矩阵是[-1.00, 0.00][-0.00, -1.00],也就是旋转180°.
  这个值的来源是上层调用setMatrix函数设置的.

• client含义比较简单,值的来源是创建layer时,对应的SurfaceSession中mNativeClient.这东西也是跟SurfaceSession一一对应的,也就是跟SurfaceFlinger连接时一一对应的.从这个值我们可以判断,client值相同的layer,必然来自同一个进程(因为他们是由同一个连接创建出来的).

4.3 buffer信息

4.3.1 数据格式

首先是数据的format,值的来源是layer创建时赋予的,当然我们如果追溯的话,可以追溯到WindowManagerService创建SurfaceControl的过程,值也是创建时指定的.值的定义如下:

其实只有下面的值是真实可用的,其余值在SurfaceFlinger创建时会被转换:

其实当前常见的format也就是这几种.

0代表未知格式.
常见的layer中,dimlayer一般是0,大多数layer是1,壁纸是2,照相机的预览数据是4,视频播放也是4.

4.3.2 activeBuffer

• activeBuffer的前两项表示了当前正在显示的buffer的宽和高.
• 第三项表示Stride.这个值很有意思,我们发现他有时候是等于宽的,有时候是大于宽的,我们先来看下这个值的解释.
  The number of pixels that a line in the buffer takes in memory. This may be >= width.
  我们知道内存申请使用是需要成块对齐的,也就是说不是说使我们申请多大的内存,就会给我们多大的内存,因为涉及到对齐,所以很可能这个内存实际上是大于我们的需要的.(暂时没有仔细研究,有待确认)像有些marvell型号,内存是按照64位对齐的,那么我们申请一个100宽的buffer,系统就会给我们留出128的buffer大小供我们使用.
• 第四项并没有什么特殊,表示format,跟前面的format应该是一致的.

4.3.3 queued-frames 新的帧的数量

queued-frames的含义是是否有新的帧,如果当前没有新的帧,这个值是0.
一般在画面持续变化时(照相预览,视频播放,窗口滑动,游戏),这个值会是1.表示有新的一帧.
偶尔也可以见到这个值是2(这个值应该最大就是2,因为只有三个缓冲区).

4.3.4 mRefreshPending刷新卡住了吗?

mRefreshPending几乎所有的常见情况下都是0,因为这个参数代表了一个layer执行了Invalidate却没有完成Refresh,除非发生错误这显然不可能.

4.4 SurfaceFlingerConsumer的dump

接下来开始对消费者进行dump,SurfaceFlingerConsumer是GLConsumer子类,所以这里实际上是调用了GLConsumer的dumpLocked函数.
先来看下代码:

它会对应打印出来这一段信息:

4.4.1 材质名称

mTexName的值来源是在消费者被创建时,我们知道最常见的创建消费者的时候是Layer::onFirstRef时会调用:

创建一个消费者,有两个参数,其中mTextureName是我们目前关注的,如果追溯来源你会发现mTextureName的值来源于glGenTextures,这个函数的实现依赖平台,参考ligagl,它是这样的:

还是继续回来看SurfaceFlingerConsumer的创建:

我们现在可以看出来mTexName的值来源于前面创建的材质名称.
mCurrentTexture的初始值是INVALID_BUFFER_SLOT,也就是-1,后面会在updateAndReleaseLocked时被更改,值的来源是使用的BufferItem的mBuf值,也就是mSlot,这应该是使用的buffer数组的slot值,这个变量的合理取值只有0,1,2三个值(mSlot is the slot index of this buffer ,default INVALID_BUFFER_SLOT).

4.4.2 mCurrentCrop裁剪区域

mCurrentCrop的值来源同样是updateAndReleaseLocked调用时被赋值,值的来源是BufferItem的mCrop值.这个值基本一直都是0,只有在视频播放和照相机时会被设置(值的来源有待更深入的研究, mCrop is the current crop rectangle for this buffer slot).

4.4.3 mCurrentTransform 旋转相关

mCurrentTransform的值和前面我们说过的tr值很类似. (mTransform is the current transform flags for this buffer slot. refer to NATIVE_WINDOW_TRANSFORM_* in ).
它也跟旋转有关,我们来看下window.h中的定义:

4.5 ConsumerBase(消费者)的dump

子类GLConsumer dump完毕,调用了它的父类的dump函数,基本就是调用了IGraphicBufferConsumer的dump函数.
生产者消费者这套体系我们之前以前讲过,这里我们就不再详细展开,如果不清楚看下Layer::onFirstRef这个函数就明白了,消费者这个值来自于BufferQueue::createBufferQueue的创建,其中创建了新的BufferQueueConsumer做为消费者.

当然BufferQueueConsumer的dump函数啥也没写,就调用了BufferQueueCore的dump函数.

打印出来的信息一般是这样的:

下面我们按照代码顺序详细解释一下:

4.5.1 队列中的buffer

我们之前在解释queued-frames的含义时已经说过,在画面持续变化时(照相预览,视频播放,窗口滑动,游戏),queued-frames值会是1.表示有新的一帧.
对应的,有新的frames自然需要有在队列中等待的buffer,对应这段代码会把这个队列打印出来:

对应打印出来的dump信息是这样的:

• 02是mSlot的值,crop是裁剪区域,xform是旋转,这三个我们上面已经讲过,这里不再展开.

• time是这个buffer被queue的时间(mTimestamp is the current timestamp for this buffer slot. This gets to set by queueBuffer each time this slot is queued. This value is guaranteed to be monotonically increasing for each newly acquired buffer.).

• scale是缩放模式,一般取值如下:

• view plain copy to clipboard print ?

  1. enum {    /* the window content is not updated (frozen) until a buffer of     * the window size is received (enqueued)     */    NATIVE_WINDOW_SCALING_MODE_FREEZE           = 0,    /* the buffer is scaled in both dimensions to match the window size */    NATIVE_WINDOW_SCALING_MODE_SCALE_TO_WINDOW  = 1,    /* the buffer is scaled uniformly such that the smaller dimension     * of the buffer matches the window size (cropping in the process)     */    NATIVE_WINDOW_SCALING_MODE_SCALE_CROP       = 2,    /* the window is clipped to the size of the buffer's crop rectangle; pixels     * outside the crop rectangle are treated as if they are completely     * transparent.     */    NATIVE_WINDOW_SCALING_MODE_NO_SCALE_CROP    = 3,};  
  
  
  

4.5.2 BufferQueue的基本默认信息

接下来的一段代码会打印BufferQueue的一些基本信息:

一般会打印如下:

4.5.2.1 允许同时acquire的buffer的数量

mMaxAcquiredBufferCount是允许同时acquire的buffer的数量,解释如下:

基本这个值只能是1,不再深究.

4.5.2.2 dequeueBuffer是否允许被block

mDequeueBufferCannotBlock几乎总是为0,除非一个应用同时控制了生产者和消费者,这很罕见.

4.5.2.3 buffer default-size默认buffer大小

这两个值的来源应该是BufferQueueConsumer::setDefaultBufferSize函数(不是特别确定,因为这段代码写的不好,严重破坏了封装性).

用处是这样的: mDefaultHeight holds the default height of allocated buffers. It is used in dequeueBuffer if a width and height of 0 are specified.

4.5.2.4 mDefaultBufferFormat默认格式

mDefaultBufferFormat很简单,format含义可以参考前面的解释.
mDefaultBufferFormat can be set so it will override the buffer format when it isn't specified in dequeueBuffer.

4.5.2.5 mTransformHint

同样用于旋转.
mTransformHint is the transform probably applied to buffers of this window. this is only a hint, actual transform may differ.

4.5.3 各个Buffer的信息

接下来是打印BufferSlot中各个buffer的信息,一般打印如下:

是由下面的代码打印出来的.

ACQUIRED的buffer前面会打印>,表示这是当前在显示的buffer.
state表示buffer的状态,取值包括DEQUEUED,QUEUED,FREE,ACQUIRED.我们知道ACQUIRED是在显示的,DEQUEUED是在绘制的,QUEUED绘制完成还未显示的,free是未使用的.
后面的大小,stride,和format前面都讲过了,这里不再说明.

至此,layer的dump已经说明完毕,我们继续分析Displays的dump.

5 display信息的dump

首先会打印当前display的数量,数量基于mDisplays的大小,这个容器在SurfaceFlinger初始化时会生成数据,后面根据收到不同的消息在handleTransactionLocked函数中也会调整.
正常情况下是1,也就是只有一个display(Built-in Screen),当设备连接了HDMI或者使用了屏幕共享等功能时,会有额外的display加入,比如下面这个:

这个是连接了HDMI后的数据.

5.1 设备名称

首先DisplayDevice是设备的名字,这个可以调用接口设置,但是比较常见的值一般有:Built-in Screen,HDMI Screen,Virtual Screen,wfdservice等等.

5.2 设备类型

type则是一个枚举值:

5.3 layerStack

layerStack是存储layer的容器,我们知道每个display只会有一个layerstack来存储他要显示的layer,但是不同的display可以使用同一个layerStack,也可以使用不同的layerStack.
上面我们贴的这个就是两个display使用了不同的layerstack,因为他们显示的内容不一样(电视播放幻灯片).
后续我们可以研究下什么情况下会导致layerstack切换.

5.4 屏幕方向

• orient表示屏幕方向
• 后面括号里面的type,是和我们上面说的设备类型完全不同的东西,这个值是由Transform::type算出来的.
  基本是下面这些值与或非出来的:
• view plain copy to clipboard print ?

  1. enum type_mask {                IDENTITY            = 0,                TRANSLATE           = 0x1,                ROTATE              = 0x2,                SCALE               = 0x4,                UNKNOWN             = 0x8            };  

5.5 powerMode

powerMode表示了屏幕当前的状态,它有以下取值:

常见的取值有0和2,代表屏幕熄灭和普通情况.
目前还没看到1和3的情况.

5.4 其他一些参数

• 设备大小由eglQuerySurface得来,不展开.
• ANativeWindow代表要渲染的本地窗口,这个不同的display之间应该肯定不同.
• flips代表屏幕翻页的次数,其实也就是SurfaceFlinger调用doComposition的次数,也就是屏幕画面更新的次数
• hwcId需要注意的是,如果一个设备不是HWC合成的,这个值会是负数.需要指出的是,这个值不受开关overlay的影响,也就是说如果这个设备是支持HWC的,应该就不会是负数.目前来看,只有开发者选项模拟二级显示出现的display这个会是负数.
• mIsSecure是屏幕自身的属性,mSecureLayerVisible应该会跟播放DRM之类的场景相关
• activeConfig目前看到的总是0,还不清楚作用
• numLayers是这个display上可见的layer的数量
• v,f,s分别代表三个大小:Viewport,Frame,Scissor.