1 /* 2 * Copyright 2021 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17 #pragma once 18 19 #include <android-base/thread_annotations.h> 20 #include <layerproto/LayerProtoHeader.h> 21 #include <utils/Errors.h> 22 #include <utils/StrongPointer.h> 23 #include <utils/Timers.h> 24 25 #include <memory> 26 #include <mutex> 27 28 using namespace android::surfaceflinger; 29 30 namespace android { 31 32 template <typename FileProto, typename EntryProto> 33 class RingBuffer; 34 35 class SurfaceFlinger; 36 37 /* 38 * LayerTracing records layer states during surface flinging. Manages tracing state and 39 * configuration. 40 */ 41 class LayerTracing { 42 public: 43 LayerTracing(SurfaceFlinger& flinger); 44 ~LayerTracing(); 45 bool enable(); 46 bool disable(std::string filename = FILE_NAME); 47 bool isEnabled() const; 48 status_t writeToFile(); 49 LayersTraceFileProto createTraceFileProto() const; 50 void notify(bool visibleRegionDirty, int64_t time); 51 52 enum : uint32_t { 53 TRACE_INPUT = 1 << 1, 54 TRACE_COMPOSITION = 1 << 2, 55 TRACE_EXTRA = 1 << 3, 56 TRACE_HWC = 1 << 4, 57 TRACE_BUFFERS = 1 << 5, 58 TRACE_ALL = TRACE_INPUT | TRACE_COMPOSITION | TRACE_EXTRA, 59 }; 60 void setTraceFlags(uint32_t flags); 61 bool flagIsSet(uint32_t flags) const; 62 void setBufferSize(size_t bufferSizeInBytes); 63 void dump(std::string&) const; 64 65 private: 66 static constexpr auto FILE_NAME = "/data/misc/wmtrace/layers_trace.winscope"; 67 68 SurfaceFlinger& mFlinger; 69 uint32_t mFlags = TRACE_INPUT; 70 mutable std::mutex mTraceLock; 71 bool mEnabled GUARDED_BY(mTraceLock) = false; 72 std::unique_ptr<RingBuffer<LayersTraceFileProto, LayersTraceProto>> mBuffer 73 GUARDED_BY(mTraceLock); 74 size_t mBufferSizeInBytes GUARDED_BY(mTraceLock) = 20 * 1024 * 1024; 75 }; 76 77 } // namespace android 78