blob: 43cc50f04c84da378d5b7d9576fa1153a3778ddc [file] [log] [blame]
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -08001/*
2 * Copyright (C) 2007 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
Dominik Laskowski9dab3432019-03-27 13:21:10 -070017#pragma once
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -080018
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -080019#include <sys/types.h>
20
Mathias Agopian3f844832013-08-07 21:24:32 -070021/*
22 * NOTE: Make sure this file doesn't include anything from <gl/ > or <gl2/ >
23 */
Mathias Agopian921e6ac2012-07-23 23:11:29 -070024
Dominik Laskowski83b88212018-12-11 13:34:06 -080025#include <android-base/thread_annotations.h>
Lloyd Pique6a3b4462019-03-07 20:58:12 -080026#include <compositionengine/OutputColorSetting.h>
Steven Moreland2716e112018-02-23 14:57:20 -080027#include <cutils/atomic.h>
Peiyong Lin2acb7d42019-01-14 17:22:27 -080028#include <cutils/compiler.h>
29#include <gui/BufferQueue.h>
Brian Anderson0a61b0c2016-12-07 14:55:56 -080030#include <gui/FrameTimestamps.h>
Mathias Agopian90ac7992012-02-25 18:48:35 -080031#include <gui/ISurfaceComposer.h>
32#include <gui/ISurfaceComposerClient.h>
Valerie Hau5de3ad22019-08-20 07:47:43 -070033#include <gui/ITransactionCompletedListener.h>
Robert Carr4cdc58f2017-08-23 14:22:20 -070034#include <gui/LayerState.h>
Dan Stozae77c7662016-05-13 11:37:28 -070035#include <gui/OccupancyTracker.h>
Mathias Agopian86303202012-07-24 22:46:10 -070036#include <hardware/hwcomposer_defs.h>
chaviw291d88a2019-02-14 10:33:58 -080037#include <input/ISetInputWindowsListener.h>
Peiyong Lin2acb7d42019-01-14 17:22:27 -080038#include <layerproto/LayerProtoHeader.h>
39#include <math/mat4.h>
Vishnu Nair08f6eae2019-11-26 14:01:39 -080040#include <renderengine/LayerSettings.h>
Vishnu Nair35798872017-10-06 16:00:36 -070041#include <serviceutils/PriorityDumper.h>
Michael Wright28f24d02016-07-12 13:30:53 -070042#include <system/graphics.h>
Peiyong Lin2acb7d42019-01-14 17:22:27 -080043#include <ui/FenceTime.h>
44#include <ui/PixelFormat.h>
45#include <utils/Errors.h>
46#include <utils/KeyedVector.h>
47#include <utils/RefBase.h>
48#include <utils/SortedVector.h>
49#include <utils/Trace.h>
50#include <utils/threads.h>
Michael Wright28f24d02016-07-12 13:30:53 -070051
Marissa Wall947d34e2019-03-29 14:03:53 -070052#include "ClientCache.h"
Mathias Agopian92a979a2012-08-02 18:32:23 -070053#include "DisplayDevice.h"
Peiyong Lin2acb7d42019-01-14 17:22:27 -080054#include "DisplayHardware/HWC2.h"
Peiyong Lin74ca2f42019-01-14 19:36:57 -080055#include "DisplayHardware/PowerAdvisor.h"
Peiyong Lin2acb7d42019-01-14 17:22:27 -080056#include "Effects/Daltonizer.h"
Jamie Gennis4b0eba92013-02-05 13:30:24 -080057#include "FrameTracker.h"
Robert Carr2047fae2016-11-28 14:09:09 -080058#include "LayerVector.h"
Dominik Laskowskiccf37d72019-02-01 16:47:58 -080059#include "Scheduler/RefreshRateConfigs.h"
Ana Krulecb43429d2019-01-09 14:28:51 -080060#include "Scheduler/RefreshRateStats.h"
Ana Krulec98b5b242018-08-10 15:03:23 -070061#include "Scheduler/Scheduler.h"
Ana Krulecfefcb582018-08-07 14:22:37 -070062#include "Scheduler/VSyncModulator.h"
Peiyong Lin2acb7d42019-01-14 17:22:27 -080063#include "SurfaceFlingerFactory.h"
Peiyong Lin2acb7d42019-01-14 17:22:27 -080064#include "SurfaceTracing.h"
Ady Abraham50204dd2019-07-19 15:47:11 -070065#include "TracedOrdinal.h"
Peiyong Lin2acb7d42019-01-14 17:22:27 -080066#include "TransactionCompletedThread.h"
Mathias Agopian86303202012-07-24 22:46:10 -070067
Dominik Laskowski83b88212018-12-11 13:34:06 -080068#include <atomic>
69#include <cstdint>
Dominik Laskowskic2867142019-01-21 11:33:38 -080070#include <functional>
Dan Stozae77c7662016-05-13 11:37:28 -070071#include <map>
Dominik Laskowski83b88212018-12-11 13:34:06 -080072#include <memory>
Brian Anderson0a61b0c2016-12-07 14:55:56 -080073#include <mutex>
Dominik Laskowskieddeda12019-07-19 11:54:13 -070074#include <optional>
Brian Anderson0a61b0c2016-12-07 14:55:56 -080075#include <queue>
Dominik Laskowski075d3172018-05-24 15:50:06 -070076#include <set>
Dan Stozae77c7662016-05-13 11:37:28 -070077#include <string>
Steven Thomasb02664d2017-07-26 18:48:28 -070078#include <thread>
Dominik Laskowskic2867142019-01-21 11:33:38 -080079#include <type_traits>
Dominik Laskowski075d3172018-05-24 15:50:06 -070080#include <unordered_map>
Dominik Laskowski22488f62019-03-28 09:53:04 -070081#include <unordered_set>
Brian Anderson0a61b0c2016-12-07 14:55:56 -080082#include <utility>
Dan Stozae77c7662016-05-13 11:37:28 -070083
chaviw1d044282017-09-27 12:19:28 -070084using namespace android::surfaceflinger;
85
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -080086namespace android {
87
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -080088class Client;
Lloyd Pique144e1162017-12-20 16:44:52 -080089class EventThread;
Dominik Laskowski9dab3432019-03-27 13:21:10 -070090class HWComposer;
Lloyd Pique12eb4232018-01-17 11:54:43 -080091class IGraphicBufferProducer;
Robert Carr720e5062018-07-30 17:45:14 -070092class IInputFlinger;
Lloyd Pique144e1162017-12-20 16:44:52 -080093class Layer;
Dominik Laskowski9dab3432019-03-27 13:21:10 -070094class MessageBase;
Ady Abraham03b02dd2019-03-21 15:40:11 -070095class RefreshRateOverlay;
Dominik Laskowski9dab3432019-03-27 13:21:10 -070096class RegionSamplingThread;
Yiwei Zhang7e666a52018-11-15 13:33:42 -080097class TimeStats;
Mikael Pessa90092f42019-08-26 17:22:04 -070098class FrameTracer;
Lloyd Pique144e1162017-12-20 16:44:52 -080099
Lloyd Pique542307f2018-10-19 13:24:08 -0700100namespace compositionengine {
101class DisplaySurface;
Lloyd Pique26d03fd2019-03-07 21:23:23 -0800102class OutputLayer;
Lloyd Pique6a3b4462019-03-07 20:58:12 -0800103
104struct CompositionRefreshArgs;
Lloyd Pique542307f2018-10-19 13:24:08 -0700105} // namespace compositionengine
106
Peiyong Lin833074a2018-08-28 11:53:54 -0700107namespace renderengine {
Lloyd Pique144e1162017-12-20 16:44:52 -0800108class RenderEngine;
Dominik Laskowski9dab3432019-03-27 13:21:10 -0700109} // namespace renderengine
chaviwa76b2712017-09-20 12:02:26 -0700110
Hendrik Wagenaar87670ff2017-02-01 12:10:46 -0800111namespace dvr {
112class VrFlinger;
113} // namespace dvr
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800114
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800115enum {
Marissa Walle6e3c0d2019-03-29 10:28:30 -0700116 eTransactionNeeded = 0x01,
117 eTraversalNeeded = 0x02,
Mathias Agopiane57f2922012-08-09 16:29:12 -0700118 eDisplayTransactionNeeded = 0x04,
Lloyd Piqued432a7c2018-03-23 16:05:31 -0700119 eDisplayLayerStackChanged = 0x08,
Marissa Walle6e3c0d2019-03-29 10:28:30 -0700120 eTransactionFlushNeeded = 0x10,
121 eTransactionMask = 0x1f,
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800122};
123
Lloyd Pique6a3b4462019-03-07 20:58:12 -0800124using DisplayColorSetting = compositionengine::OutputColorSetting;
Peiyong Lindd9b2ae2018-03-01 16:22:45 -0800125
David Sodman105b7dc2017-11-04 20:28:14 -0700126class SurfaceFlingerBE
127{
128public:
129 SurfaceFlingerBE();
130
David Sodmanbc815282017-11-05 18:57:52 -0800131 const std::string mHwcServiceName; // "default" for real use, something else for testing.
132
David Sodman73beded2017-11-15 11:56:06 -0800133 FenceTimeline mGlCompositionDoneTimeline;
134 FenceTimeline mDisplayTimeline;
David Sodmanbc815282017-11-05 18:57:52 -0800135
David Sodman99974d22017-11-28 12:04:33 -0800136 // protected by mCompositorTimingLock;
137 mutable std::mutex mCompositorTimingLock;
138 CompositorTiming mCompositorTiming;
Lloyd Piquefcd86612017-12-14 17:15:36 -0800139
David Sodman99974d22017-11-28 12:04:33 -0800140 // Only accessed from the main thread.
141 struct CompositePresentTime {
Dominik Laskowski9dab3432019-03-27 13:21:10 -0700142 nsecs_t composite = -1;
143 std::shared_ptr<FenceTime> display = FenceTime::NO_FENCE;
David Sodman99974d22017-11-28 12:04:33 -0800144 };
145 std::queue<CompositePresentTime> mCompositePresentTimes;
146
David Sodman4a36e932017-11-07 14:29:47 -0800147 static const size_t NUM_BUCKETS = 8; // < 1-7, 7+
Dominik Laskowski9dab3432019-03-27 13:21:10 -0700148 nsecs_t mFrameBuckets[NUM_BUCKETS] = {};
149 nsecs_t mTotalTime = 0;
150 std::atomic<nsecs_t> mLastSwapTime = 0;
David Sodman4a36e932017-11-07 14:29:47 -0800151
David Sodmancbaf0832017-11-07 14:21:36 -0800152 // Double- vs. triple-buffering stats
153 struct BufferingStats {
Dominik Laskowski9dab3432019-03-27 13:21:10 -0700154 size_t numSegments = 0;
155 nsecs_t totalTime = 0;
David Sodmancbaf0832017-11-07 14:21:36 -0800156
157 // "Two buffer" means that a third buffer was never used, whereas
158 // "double-buffered" means that on average the segment only used two
159 // buffers (though it may have used a third for some part of the
160 // segment)
Dominik Laskowski9dab3432019-03-27 13:21:10 -0700161 nsecs_t twoBufferTime = 0;
162 nsecs_t doubleBufferedTime = 0;
163 nsecs_t tripleBufferedTime = 0;
David Sodmancbaf0832017-11-07 14:21:36 -0800164 };
165 mutable Mutex mBufferingStatsMutex;
166 std::unordered_map<std::string, BufferingStats> mBufferingStats;
167
David Sodman105b7dc2017-11-04 20:28:14 -0700168 // The composer sequence id is a monotonically increasing integer that we
169 // use to differentiate callbacks from different hardware composer
170 // instances. Each hardware composer instance gets a different sequence id.
Dominik Laskowski9dab3432019-03-27 13:21:10 -0700171 int32_t mComposerSequenceId = 0;
chaviw291d88a2019-02-14 10:33:58 -0800172};
David Sodman105b7dc2017-11-04 20:28:14 -0700173
Mathias Agopian4f4f0942013-08-19 17:26:18 -0700174class SurfaceFlinger : public BnSurfaceComposer,
Vishnu Nair35798872017-10-06 16:00:36 -0700175 public PriorityDumper,
Alec Mouri4545a8a2019-08-08 20:05:32 -0700176 public ClientCache::ErasedRecipient,
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700177 private IBinder::DeathRecipient,
Ady Abraham2139f732019-11-13 18:56:40 -0800178 private HWC2::ComposerCallback,
Ady Abraham3a77a7b2019-12-02 18:46:59 -0800179 private ISchedulerCallback {
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800180public:
David Sodman105b7dc2017-11-04 20:28:14 -0700181 SurfaceFlingerBE& getBE() { return mBE; }
182 const SurfaceFlingerBE& getBE() const { return mBE; }
Fabien Sanglard0cc19382017-03-06 11:54:40 -0800183
Fabien Sanglard0cc19382017-03-06 11:54:40 -0800184 // This is the phase offset in nanoseconds of the software vsync event
185 // relative to the vsync event reported by HWComposer. The software vsync
186 // event is when SurfaceFlinger and Choreographer-based applications run each
187 // frame.
188 //
189 // This phase offset allows adjustment of the minimum latency from application
190 // wake-up time (by Choreographer) to the time at which the resulting window
191 // image is displayed. This value may be either positive (after the HW vsync)
192 // or negative (before the HW vsync). Setting it to 0 will result in a lower
193 // latency bound of two vsync periods because the app and SurfaceFlinger
194 // will run just after the HW vsync. Setting it to a positive number will
195 // result in the minimum latency being:
196 //
197 // (2 * VSYNC_PERIOD - (vsyncPhaseOffsetNs % VSYNC_PERIOD))
198 //
199 // Note that reducing this latency makes it more likely for the applications
200 // to not have their window content image ready in time. When this happens
201 // the latency will end up being an additional vsync period, and animations
202 // will hiccup. Therefore, this latency should be tuned somewhat
203 // conservatively (or at least with awareness of the trade-off being made).
204 static int64_t vsyncPhaseOffsetNs;
205 static int64_t sfVsyncPhaseOffsetNs;
206
Fabien Sanglardcbf153b2017-03-10 17:57:12 -0800207 // If fences from sync Framework are supported.
208 static bool hasSyncFramework;
209
Fabien Sanglardc45a7d92017-03-14 13:24:22 -0700210 // The offset in nanoseconds to use when DispSync timestamps present fence
211 // signaling time.
212 static int64_t dispSyncPresentTimeOffset;
213
Fabien Sanglarda34ed632017-03-14 11:43:52 -0700214 // Some hardware can do RGB->YUV conversion more efficiently in hardware
215 // controlled by HWC than in hardware controlled by the video encoder.
216 // This instruct VirtualDisplaySurface to use HWC for such conversion on
217 // GL composition.
218 static bool useHwcForRgbToYuv;
219
Fabien Sanglardc8e387e2017-03-10 10:30:28 -0800220 // Maximum dimension supported by HWC for virtual display.
221 // Equal to min(max_height, max_width).
222 static uint64_t maxVirtualDisplaySize;
223
Fabien Sanglard1971b632017-03-10 14:50:03 -0800224 // Controls the number of buffers SurfaceFlinger will allocate for use in
225 // FramebufferSurface
226 static int64_t maxFrameBufferAcquiredBuffers;
227
Peiyong Lin13effd12018-07-24 17:01:47 -0700228 // Indicate if a device has wide color gamut display. This is typically
229 // found on devices with wide color gamut (e.g. Display-P3) display.
Courtney Goeltzenleuchter5d943892017-03-22 13:46:46 -0600230 static bool hasWideColorDisplay;
231
Dominik Laskowski718f9602019-11-09 20:01:35 -0800232 static ui::Rotation internalDisplayOrientation;
Chia-I Wu304d9cd2018-08-27 14:38:14 -0700233
Peiyong Lin13effd12018-07-24 17:01:47 -0700234 // Indicate if device wants color management on its display.
235 static bool useColorManagement;
236
Peiyong Linb3839ad2018-09-05 15:37:19 -0700237 static bool useContextPriority;
238
Peiyong Lin0256f722018-08-31 15:45:10 -0700239 // The data space and pixel format that SurfaceFlinger expects hardware composer
240 // to composite efficiently. Meaning under most scenarios, hardware composer
241 // will accept layers with the data space and pixel format.
Peiyong Linc6780972018-10-28 15:24:08 -0700242 static ui::Dataspace defaultCompositionDataspace;
243 static ui::PixelFormat defaultCompositionPixelFormat;
244
245 // The data space and pixel format that SurfaceFlinger expects hardware composer
246 // to composite efficiently for wide color gamut surfaces. Meaning under most scenarios,
247 // hardware composer will accept layers with the data space and pixel format.
248 static ui::Dataspace wideColorGamutCompositionDataspace;
249 static ui::PixelFormat wideColorGamutCompositionPixelFormat;
Peiyong Lin0256f722018-08-31 15:45:10 -0700250
Mathias Agopianb6df7d02013-05-09 14:53:35 -0700251 static char const* getServiceName() ANDROID_API {
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700252 return "SurfaceFlinger";
253 }
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800254
Lloyd Piqueac648ee2018-01-17 13:42:24 -0800255 struct SkipInitializationTag {};
256 static constexpr SkipInitializationTag SkipInitialization;
Lloyd Pique90c115d2018-09-18 21:39:42 -0700257 SurfaceFlinger(surfaceflinger::Factory&, SkipInitializationTag) ANDROID_API;
258 explicit SurfaceFlinger(surfaceflinger::Factory&) ANDROID_API;
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800259
Mathias Agopian4f4f0942013-08-19 17:26:18 -0700260 // must be called before clients can connect
261 void init() ANDROID_API;
262
263 // starts SurfaceFlinger main loop in the current thread
264 void run() ANDROID_API;
265
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700266 // post an asynchronous message to the main thread
Mathias Agopian3f844832013-08-07 21:24:32 -0700267 status_t postMessageAsync(const sp<MessageBase>& msg, nsecs_t reltime = 0, uint32_t flags = 0);
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800268
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700269 // post a synchronous message to the main thread
Vishnu Nair8406fd72019-07-30 11:29:31 -0700270 status_t postMessageSync(const sp<MessageBase>& msg, nsecs_t reltime = 0, uint32_t flags = 0)
271 EXCLUDES(mStateLock);
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800272
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700273 // force full composition on all displays
274 void repaintEverything();
Mathias Agopianbf2c6a62010-12-10 16:22:31 -0800275
Lloyd Pique90c115d2018-09-18 21:39:42 -0700276 surfaceflinger::Factory& getFactory() { return mFactory; }
277
Lloyd Pique70d91362018-10-18 16:02:55 -0700278 // The CompositionEngine encapsulates all composition related interfaces and actions.
279 compositionengine::CompositionEngine& getCompositionEngine() const;
280
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700281 // returns the default Display
Dominik Laskowskidcb38bb2019-01-25 02:35:50 -0800282 sp<const DisplayDevice> getDefaultDisplayDevice() {
Stephen Kiazyk7d3dcb92017-04-05 16:46:49 -0700283 Mutex::Autolock _l(mStateLock);
284 return getDefaultDisplayDeviceLocked();
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700285 }
Mathias Agopianb60314a2012-04-10 22:09:54 -0700286
Dan Stoza436ccf32018-06-21 12:10:12 -0700287 // Obtains a name from the texture pool, or, if the pool is empty, posts a
288 // synchronous message to the main thread to obtain one on the fly
289 uint32_t getNewTexture();
290
Mathias Agopian86303202012-07-24 22:46:10 -0700291 // utility function to delete a texture on the main thread
Mathias Agopian3f844832013-08-07 21:24:32 -0700292 void deleteTextureAsync(uint32_t texture);
Mathias Agopian86303202012-07-24 22:46:10 -0700293
Mathias Agopian86303202012-07-24 22:46:10 -0700294 // enable/disable h/w composer event
295 // TODO: this should be made accessible only to EventThread
Dominik Laskowskidcb38bb2019-01-25 02:35:50 -0800296 void setPrimaryVsyncEnabled(bool enabled);
Mathias Agopian86303202012-07-24 22:46:10 -0700297
Ady Abraham9ba25122019-06-03 17:10:55 -0700298 // main thread function to enable/disable h/w composer event
299 void setPrimaryVsyncEnabledInternal(bool enabled);
Dominik Laskowskia8955dd2019-07-10 10:19:09 -0700300 void setVsyncEnabledInHWC(DisplayId displayId, HWC2::Vsync enabled);
Ady Abraham9ba25122019-06-03 17:10:55 -0700301
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700302 // called on the main thread by MessageQueue when an internal message
303 // is received
304 // TODO: this should be made accessible only to MessageQueue
305 void onMessageReceived(int32_t what);
Mathias Agopian3094df32012-06-18 18:06:45 -0700306
Lloyd Piqueb97e04f2018-10-18 17:07:05 -0700307 renderengine::RenderEngine& getRenderEngine() const;
Jesse Hall29c3f352013-05-21 15:36:55 -0700308
Robert Carr0d480722017-01-10 16:42:54 -0800309 bool authenticateSurfaceTextureLocked(
310 const sp<IGraphicBufferProducer>& bufferProducer) const;
311
Dominik Laskowski75848362019-11-11 17:57:20 -0800312 void onLayerFirstRef(Layer*);
Dominik Laskowskif7a09ed2019-10-07 13:54:18 -0700313 void onLayerDestroyed(Layer*);
Robert Carr2e102c92018-10-23 12:11:15 -0700314
Valerie Hauc5686802019-11-22 14:18:09 -0800315 void removeFromOffscreenLayers(Layer* layer);
316
Marissa Walle2ffb422018-10-12 11:33:52 -0700317 TransactionCompletedThread& getTransactionCompletedThread() {
318 return mTransactionCompletedThread;
319 }
320
Robert Carrc0df3122019-04-11 13:18:21 -0700321 sp<Layer> fromHandle(const sp<IBinder>& handle) REQUIRES(mStateLock);
322
Alec Mouri4545a8a2019-08-08 20:05:32 -0700323 // Inherit from ClientCache::ErasedRecipient
324 void bufferErased(const client_cache_t& clientCacheId) override;
325
Mathias Agopian1f339ff2011-07-01 17:08:43 -0700326private:
David Sodman0c69cad2017-08-21 12:12:51 -0700327 friend class BufferLayer;
Marissa Wallfd668622018-05-10 10:21:13 -0700328 friend class BufferQueueLayer;
Marissa Wall61c58622018-07-18 10:12:20 -0700329 friend class BufferStateLayer;
Dominik Laskowski9dab3432019-03-27 13:21:10 -0700330 friend class Client;
331 friend class Layer;
Dan Stozab9b08832014-03-13 11:55:57 -0700332 friend class MonitoredProducer;
Ady Abraham03b02dd2019-03-21 15:40:11 -0700333 friend class RefreshRateOverlay;
Dan Stozaec460082018-12-17 15:35:09 -0800334 friend class RegionSamplingThread;
Nataniel Borges2b796da2019-02-15 13:32:18 -0800335 friend class SurfaceTracing;
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800336
Lloyd Piquef58625d2017-12-19 13:22:33 -0800337 // For unit tests
338 friend class TestableSurfaceFlinger;
Valerie Haud251afb2019-03-29 14:19:02 -0700339 friend class TransactionApplicationTest;
Lloyd Piquef58625d2017-12-19 13:22:33 -0800340
Jamie Gennis6547ff42013-07-16 20:12:42 -0700341 // This value is specified in number of frames. Log frame stats at most
342 // every half hour.
343 enum { LOG_FRAME_STATS_PERIOD = 30*60*60 };
344
Dan Stoza7d89d062015-04-30 13:29:25 -0700345 static const size_t MAX_LAYERS = 4096;
Nataniel Borges2b796da2019-02-15 13:32:18 -0800346 static const int MAX_TRACING_MEMORY = 100 * 1024 * 1024; // 100MB
Dan Stoza7d89d062015-04-30 13:29:25 -0700347
Lloyd Pique58e24a32019-08-01 15:50:14 -0700348protected:
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700349 // We're reference counted, never destroy SurfaceFlinger directly
350 virtual ~SurfaceFlinger();
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800351
Lloyd Pique58e24a32019-08-01 15:50:14 -0700352private:
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700353 /* ------------------------------------------------------------------------
354 * Internal data structures
355 */
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800356
Robert Carr2047fae2016-11-28 14:09:09 -0800357 class State {
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800358 public:
chaviwfd462612018-05-31 16:11:27 -0700359 explicit State(LayerVector::StateSet set) : stateSet(set), layersSortedByZ(set) {}
Dan Stoza412903f2017-04-27 13:42:17 -0700360 State& operator=(const State& other) {
361 // We explicitly don't copy stateSet so that, e.g., mDrawingState
362 // always uses the Drawing StateSet.
363 layersSortedByZ = other.layersSortedByZ;
364 displays = other.displays;
Chia-I Wu28f320b2018-05-03 11:02:56 -0700365 colorMatrixChanged = other.colorMatrixChanged;
366 if (colorMatrixChanged) {
367 colorMatrix = other.colorMatrix;
368 }
Vishnu Nair08f6eae2019-11-26 14:01:39 -0800369 globalShadowSettings = other.globalShadowSettings;
370
Dan Stoza412903f2017-04-27 13:42:17 -0700371 return *this;
372 }
373
374 const LayerVector::StateSet stateSet = LayerVector::StateSet::Invalid;
Mathias Agopian92a979a2012-08-02 18:32:23 -0700375 LayerVector layersSortedByZ;
Mathias Agopiane57f2922012-08-09 16:29:12 -0700376 DefaultKeyedVector< wp<IBinder>, DisplayDeviceState> displays;
Robert Carr2047fae2016-11-28 14:09:09 -0800377
Chia-I Wu28f320b2018-05-03 11:02:56 -0700378 bool colorMatrixChanged = true;
379 mat4 colorMatrix;
380
Vishnu Nair08f6eae2019-11-26 14:01:39 -0800381 renderengine::ShadowSettings globalShadowSettings;
382
Edgar Arriaga844fa672020-01-16 14:21:42 -0800383 void traverse(const LayerVector::Visitor& visitor) const;
Dan Stoza412903f2017-04-27 13:42:17 -0700384 void traverseInZOrder(const LayerVector::Visitor& visitor) const;
385 void traverseInReverseZOrder(const LayerVector::Visitor& visitor) const;
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800386 };
387
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700388 /* ------------------------------------------------------------------------
389 * IBinder interface
390 */
Peiyong Lin2acb7d42019-01-14 17:22:27 -0800391 status_t onTransact(uint32_t code, const Parcel& data, Parcel* reply, uint32_t flags) override;
392 status_t dump(int fd, const Vector<String16>& args) override { return priorityDump(fd, args); }
Robert Carr14167e02019-02-13 13:50:55 -0800393 bool callingThreadHasUnscopedSurfaceFlingerAccess() EXCLUDES(mStateLock);
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800394
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700395 /* ------------------------------------------------------------------------
396 * ISurfaceComposer interface
397 */
Peiyong Lin2acb7d42019-01-14 17:22:27 -0800398 sp<ISurfaceComposerClient> createConnection() override;
399 sp<IBinder> createDisplay(const String8& displayName, bool secure) override;
400 void destroyDisplay(const sp<IBinder>& displayToken) override;
Dominik Laskowskidcb38bb2019-01-25 02:35:50 -0800401 std::vector<PhysicalDisplayId> getPhysicalDisplayIds() const override;
402 sp<IBinder> getPhysicalDisplayToken(PhysicalDisplayId displayId) const override;
Peiyong Lin2acb7d42019-01-14 17:22:27 -0800403 void setTransactionState(const Vector<ComposerState>& state,
404 const Vector<DisplayState>& displays, uint32_t flags,
405 const sp<IBinder>& applyToken,
Marissa Wall17b4e452018-12-26 16:32:34 -0800406 const InputWindowCommands& inputWindowCommands,
Marissa Wall947d34e2019-03-29 14:03:53 -0700407 int64_t desiredPresentTime, const client_cache_t& uncacheBuffer,
Valerie Hau9dab9732019-08-20 09:29:25 -0700408 bool hasListenerCallbacks,
Marissa Wall3dad52d2019-03-22 14:03:19 -0700409 const std::vector<ListenerCallbacks>& listenerCallbacks) override;
Peiyong Lin2acb7d42019-01-14 17:22:27 -0800410 void bootFinished() override;
411 bool authenticateSurfaceTexture(
412 const sp<IGraphicBufferProducer>& bufferProducer) const override;
413 status_t getSupportedFrameTimestamps(std::vector<FrameEvent>* outSupported) const override;
414 sp<IDisplayEventConnection> createDisplayEventConnection(
Ady Abraham0f4a1b12019-06-04 16:04:04 -0700415 ISurfaceComposer::VsyncSource vsyncSource = eVsyncSourceApp,
416 ISurfaceComposer::ConfigChanged configChanged =
417 ISurfaceComposer::eConfigChangedSuppress) override;
Peiyong Lin2acb7d42019-01-14 17:22:27 -0800418 status_t captureScreen(const sp<IBinder>& displayToken, sp<GraphicBuffer>* outBuffer,
Dominik Laskowski718f9602019-11-09 20:01:35 -0800419 bool& outCapturedSecureLayers, ui::Dataspace reqDataspace,
420 ui::PixelFormat reqPixelFormat, const Rect& sourceCrop,
421 uint32_t reqWidth, uint32_t reqHeight, bool useIdentityTransform,
422 ui::Rotation rotation, bool captureSecureLayers) override;
chaviw93df2ea2019-04-30 16:45:12 -0700423 status_t captureScreen(uint64_t displayOrLayerStack, ui::Dataspace* outDataspace,
424 sp<GraphicBuffer>* outBuffer) override;
Robert Carr866455f2019-04-02 16:28:26 -0700425 status_t captureLayers(
426 const sp<IBinder>& parentHandle, sp<GraphicBuffer>* outBuffer,
427 const ui::Dataspace reqDataspace, const ui::PixelFormat reqPixelFormat,
428 const Rect& sourceCrop,
429 const std::unordered_set<sp<IBinder>, ISurfaceComposer::SpHash<IBinder>>& exclude,
430 float frameScale, bool childrenOnly) override;
Robert Carr108b2c72019-04-02 16:32:58 -0700431
Peiyong Lin2acb7d42019-01-14 17:22:27 -0800432 status_t getDisplayStats(const sp<IBinder>& displayToken, DisplayStatInfo* stats) override;
433 status_t getDisplayConfigs(const sp<IBinder>& displayToken,
Dominik Laskowski22488f62019-03-28 09:53:04 -0700434 Vector<DisplayInfo>* configs) override;
Peiyong Lin2acb7d42019-01-14 17:22:27 -0800435 int getActiveConfig(const sp<IBinder>& displayToken) override;
436 status_t getDisplayColorModes(const sp<IBinder>& displayToken,
437 Vector<ui::ColorMode>* configs) override;
Daniel Solomon42d04562019-01-20 21:03:19 -0800438 status_t getDisplayNativePrimaries(const sp<IBinder>& displayToken,
439 ui::DisplayPrimaries &primaries);
Peiyong Lin2acb7d42019-01-14 17:22:27 -0800440 ui::ColorMode getActiveColorMode(const sp<IBinder>& displayToken) override;
441 status_t setActiveColorMode(const sp<IBinder>& displayToken, ui::ColorMode colorMode) override;
Galia Peycheva5492cb52019-10-30 14:13:16 +0100442 status_t getAutoLowLatencyModeSupport(const sp<IBinder>& displayToken,
443 bool* outSupported) const override;
444 void setAutoLowLatencyMode(const sp<IBinder>& displayToken, bool on) override;
445 status_t getGameContentTypeSupport(const sp<IBinder>& displayToken,
446 bool* outSupported) const override;
447 void setGameContentType(const sp<IBinder>& displayToken, bool on) override;
Peiyong Lin2acb7d42019-01-14 17:22:27 -0800448 void setPowerMode(const sp<IBinder>& displayToken, int mode) override;
Peiyong Lin2acb7d42019-01-14 17:22:27 -0800449 status_t clearAnimationFrameStats() override;
450 status_t getAnimationFrameStats(FrameStats* outStats) const override;
451 status_t getHdrCapabilities(const sp<IBinder>& displayToken,
452 HdrCapabilities* outCapabilities) const override;
453 status_t enableVSyncInjections(bool enable) override;
454 status_t injectVSync(nsecs_t when) override;
455 status_t getLayerDebugInfo(std::vector<LayerDebugInfo>* outLayers) const override;
456 status_t getColorManagement(bool* outGetColorManagement) const override;
Peiyong Linc6780972018-10-28 15:24:08 -0700457 status_t getCompositionPreference(ui::Dataspace* outDataspace, ui::PixelFormat* outPixelFormat,
458 ui::Dataspace* outWideColorGamutDataspace,
459 ui::PixelFormat* outWideColorGamutPixelFormat) const override;
Peiyong Lin2acb7d42019-01-14 17:22:27 -0800460 status_t getDisplayedContentSamplingAttributes(const sp<IBinder>& display,
461 ui::PixelFormat* outFormat,
462 ui::Dataspace* outDataspace,
463 uint8_t* outComponentMask) const override;
464 status_t setDisplayContentSamplingEnabled(const sp<IBinder>& display, bool enable,
465 uint8_t componentMask,
466 uint64_t maxFrames) const override;
467 status_t getDisplayedContentSample(const sp<IBinder>& display, uint64_t maxFrames,
468 uint64_t timestamp,
469 DisplayedFrameStats* outStats) const override;
Peiyong Lin3c2791e2019-01-14 17:05:18 -0800470 status_t getProtectedContentSupport(bool* outSupported) const override;
Peiyong Lin4f3fddf2019-01-24 17:21:24 -0800471 status_t isWideColorDisplay(const sp<IBinder>& displayToken,
472 bool* outIsWideColorDisplay) const override;
Dan Stoza84ab9372018-12-17 15:27:57 -0800473 status_t addRegionSamplingListener(const Rect& samplingArea, const sp<IBinder>& stopLayerHandle,
474 const sp<IRegionSamplingListener>& listener) override;
475 status_t removeRegionSamplingListener(const sp<IRegionSamplingListener>& listener) override;
Ana Krulec0782b882019-10-15 17:34:54 -0700476 status_t setDesiredDisplayConfigSpecs(const sp<IBinder>& displayToken, int32_t displayModeId,
477 float minRefreshRate, float maxRefreshRate) override;
Ana Krulec234bb162019-11-10 22:55:55 +0100478 status_t getDesiredDisplayConfigSpecs(const sp<IBinder>& displayToken,
Ana Kruleced3a8cc2019-11-14 00:55:07 +0100479 int32_t* outDefaultConfig, float* outMinRefreshRate,
Ana Krulec234bb162019-11-10 22:55:55 +0100480 float* outMaxRefreshRate) override;
Dan Gittik57e63c52019-01-18 16:37:54 +0000481 status_t getDisplayBrightnessSupport(const sp<IBinder>& displayToken,
482 bool* outSupport) const override;
483 status_t setDisplayBrightness(const sp<IBinder>& displayToken, float brightness) const override;
Ady Abraham8532d012019-05-08 14:50:56 -0700484 status_t notifyPowerHint(int32_t hintId) override;
Vishnu Nairb13bb952019-11-15 10:24:08 -0800485 status_t setGlobalShadowSettings(const half4& ambientColor, const half4& spotColor,
486 float lightPosY, float lightPosZ, float lightRadius) override;
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700487 /* ------------------------------------------------------------------------
488 * DeathRecipient interface
489 */
Peiyong Lin2acb7d42019-01-14 17:22:27 -0800490 void binderDied(const wp<IBinder>& who) override;
Mathias Agopian99ce5cd2012-01-31 18:24:27 -0800491
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700492 /* ------------------------------------------------------------------------
Mathias Agopian4f4f0942013-08-19 17:26:18 -0700493 * RefBase interface
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700494 */
Peiyong Lin2acb7d42019-01-14 17:22:27 -0800495 void onFirstRef() override;
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800496
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700497 /* ------------------------------------------------------------------------
Steven Thomasb02664d2017-07-26 18:48:28 -0700498 * HWC2::ComposerCallback / HWComposer::EventHandler interface
Mathias Agopian86303202012-07-24 22:46:10 -0700499 */
Ady Abraham7159f572019-10-11 11:10:18 -0700500 void onVsyncReceived(int32_t sequenceId, hwc2_display_t hwcDisplayId, int64_t timestamp,
501 std::optional<hwc2_vsync_period_t> vsyncPeriod) override;
Dominik Laskowskia2edf612018-06-01 13:15:16 -0700502 void onHotplugReceived(int32_t sequenceId, hwc2_display_t hwcDisplayId,
Lloyd Pique715a2c12017-12-14 17:18:08 -0800503 HWC2::Connection connection) override;
Dominik Laskowskia2edf612018-06-01 13:15:16 -0700504 void onRefreshReceived(int32_t sequenceId, hwc2_display_t hwcDisplayId) override;
Ady Abraham7159f572019-10-11 11:10:18 -0700505 void onVsyncPeriodTimingChangedReceived(
506 int32_t sequenceId, hwc2_display_t display,
507 const hwc_vsync_period_change_timeline_t& updatedTimeline) override;
Ady Abrahamb0433bc2020-01-08 17:31:06 -0800508 void onSeamlessPossible(int32_t sequenceId, hwc2_display_t display) override;
Mathias Agopian86303202012-07-24 22:46:10 -0700509
510 /* ------------------------------------------------------------------------
Ady Abraham3a77a7b2019-12-02 18:46:59 -0800511 * ISchedulerCallback
Ady Abraham2139f732019-11-13 18:56:40 -0800512 */
513 void changeRefreshRate(const Scheduler::RefreshRate&, Scheduler::ConfigEvent) override;
Ady Abraham3a77a7b2019-12-02 18:46:59 -0800514 // force full composition on all displays without resetting the scheduler idle timer.
515 void repaintEverythingForHWC() override;
Ady Abraham2139f732019-11-13 18:56:40 -0800516 /* ------------------------------------------------------------------------
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700517 * Message handling
518 */
519 void waitForEvent();
Steven Thomas6d8110b2017-08-31 18:24:21 -0700520 // Can only be called from the main thread or with mStateLock held
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700521 void signalTransaction();
Steven Thomas6d8110b2017-08-31 18:24:21 -0700522 // Can only be called from the main thread or with mStateLock held
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700523 void signalLayerUpdate();
524 void signalRefresh();
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800525
Ady Abraham2139f732019-11-13 18:56:40 -0800526 using RefreshRate = scheduler::RefreshRateConfigs::RefreshRate;
Dominik Laskowski9dab3432019-03-27 13:21:10 -0700527
Ady Abraham03b02dd2019-03-21 15:40:11 -0700528 struct ActiveConfigInfo {
Ady Abraham2139f732019-11-13 18:56:40 -0800529 HwcConfigIndexType configId;
Josh Gaoa0520712019-11-14 15:38:04 -0800530 Scheduler::ConfigEvent event = Scheduler::ConfigEvent::None;
Ady Abraham03b02dd2019-03-21 15:40:11 -0700531
532 bool operator!=(const ActiveConfigInfo& other) const {
Ady Abraham2139f732019-11-13 18:56:40 -0800533 return configId != other.configId || event != other.event;
Ady Abraham03b02dd2019-03-21 15:40:11 -0700534 }
535 };
536
Andy McFadden13a082e2012-08-24 10:16:42 -0700537 // called on the main thread in response to initializeDisplays()
Dominik Laskowski83b88212018-12-11 13:34:06 -0800538 void onInitializeDisplays() REQUIRES(mStateLock);
Ana Kruleca5bdd9d2019-01-29 19:00:58 -0800539 // Sets the desired active config bit. It obtains the lock, and sets mDesiredActiveConfig.
Ady Abraham03b02dd2019-03-21 15:40:11 -0700540 void setDesiredActiveConfig(const ActiveConfigInfo& info) REQUIRES(mStateLock);
Steven Thomasa87ed452020-01-03 16:10:05 -0800541 status_t setActiveConfig(const sp<IBinder>& displayToken, int id);
Ana Kruleca5bdd9d2019-01-29 19:00:58 -0800542 // Once HWC has returned the present fence, this sets the active config and a new refresh
Ady Abraham53852a52019-05-28 18:07:44 -0700543 // rate in SF.
Ana Kruleca5bdd9d2019-01-29 19:00:58 -0800544 void setActiveConfigInternal() REQUIRES(mStateLock);
545 // Active config is updated on INVALIDATE call in a state machine-like manner. When the
Ady Abrahamb838aed2019-02-12 15:30:16 -0800546 // desired config was set, HWC needs to update the panel on the next refresh, and when
Ana Kruleca5bdd9d2019-01-29 19:00:58 -0800547 // we receive the fence back, we know that the process was complete. It returns whether
Ady Abrahamb838aed2019-02-12 15:30:16 -0800548 // we need to wait for the next invalidate
Dominik Laskowski22488f62019-03-28 09:53:04 -0700549 bool performSetActiveConfig() REQUIRES(mStateLock);
Ady Abraham53852a52019-05-28 18:07:44 -0700550 // Called when active config is no longer is progress
551 void desiredActiveConfigChangeDone() REQUIRES(mStateLock);
Prashant Malani2c9b11f2014-05-25 01:36:31 -0700552 // called on the main thread in response to setPowerMode()
Dominik Laskowski83b88212018-12-11 13:34:06 -0800553 void setPowerModeInternal(const sp<DisplayDevice>& display, int mode) REQUIRES(mStateLock);
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800554
Ana Kruleced3a8cc2019-11-14 00:55:07 +0100555 // Sets the desired display configs.
556 status_t setDesiredDisplayConfigSpecsInternal(const sp<DisplayDevice>& display,
557 HwcConfigIndexType defaultConfig,
558 float minRefreshRate, float maxRefreshRate)
559 EXCLUDES(mStateLock);
Ady Abraham838de062019-02-04 10:24:03 -0800560
Galia Peycheva5492cb52019-10-30 14:13:16 +0100561 // called on the main thread in response to setAutoLowLatencyMode()
562 void setAutoLowLatencyModeInternal(const sp<IBinder>& displayToken, bool on);
563 // called on the main thread in response to setGameContentType()
564 void setGameContentTypeInternal(const sp<IBinder>& displayToken, bool on);
565
Dan Stoza6b9454d2014-11-07 16:00:59 -0800566 // Returns whether the transaction actually modified any state
567 bool handleMessageTransaction();
568
569 // Returns whether a new buffer has been latched (see handlePageFlip())
570 bool handleMessageInvalidate();
571
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700572 void handleMessageRefresh();
Mathias Agopian4fec8732012-06-29 14:12:52 -0700573
Mathias Agopian87baae12012-07-31 12:38:26 -0700574 void handleTransaction(uint32_t transactionFlags);
Vishnu Nairfa5f8df2019-02-13 17:02:51 -0800575 void handleTransactionLocked(uint32_t transactionFlags) REQUIRES(mStateLock);
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800576
Vishnu Nair6194e2e2019-02-06 12:58:39 -0800577 void updateInputFlinger();
578 void updateInputWindowInfo();
Vishnu Nairfa5f8df2019-02-13 17:02:51 -0800579 void commitInputWindowCommands() REQUIRES(mStateLock);
Dominik Laskowski9dab3432019-03-27 13:21:10 -0700580 void setInputWindowsFinished();
Riley Andrews03414a12014-07-01 14:22:59 -0700581 void updateCursorAsync();
Steven Thomas2bbaabe2019-08-28 16:08:35 -0700582 void initScheduler(DisplayId primaryDisplayId);
Riley Andrews03414a12014-07-01 14:22:59 -0700583
Dan Stoza6b9454d2014-11-07 16:00:59 -0800584 /* handlePageFlip - latch a new buffer if available and compute the dirty
585 * region. Returns whether a new buffer has been latched, i.e., whether it
586 * is necessary to perform a refresh during this vsync.
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700587 */
Dan Stoza6b9454d2014-11-07 16:00:59 -0800588 bool handlePageFlip();
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800589
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700590 /* ------------------------------------------------------------------------
591 * Transactions
592 */
Marissa Wall713b63f2018-10-17 15:42:43 -0700593 void applyTransactionState(const Vector<ComposerState>& state,
chaviw273171b2018-12-26 11:46:30 -0800594 const Vector<DisplayState>& displays, uint32_t flags,
Robert Carr14167e02019-02-13 13:50:55 -0800595 const InputWindowCommands& inputWindowCommands,
Marissa Wall78b72202019-03-15 14:58:34 -0700596 const int64_t desiredPresentTime,
Valerie Hau9dab9732019-08-20 09:29:25 -0700597 const client_cache_t& uncacheBuffer, const int64_t postTime,
598 bool privileged, bool hasListenerCallbacks,
Marissa Wall3dad52d2019-03-22 14:03:19 -0700599 const std::vector<ListenerCallbacks>& listenerCallbacks,
Valerie Hau9dab9732019-08-20 09:29:25 -0700600 bool isMainThread = false) REQUIRES(mStateLock);
Marissa Walle6e3c0d2019-03-29 10:28:30 -0700601 // Returns true if at least one transaction was flushed
Marissa Wall713b63f2018-10-17 15:42:43 -0700602 bool flushTransactionQueues();
Marissa Walle6e3c0d2019-03-29 10:28:30 -0700603 // Returns true if there is at least one transaction that needs to be flushed
604 bool transactionFlushNeeded();
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700605 uint32_t getTransactionFlags(uint32_t flags);
Fabien Sanglardc8251eb2016-12-07 13:59:48 -0800606 uint32_t peekTransactionFlags();
Steven Thomas6d8110b2017-08-31 18:24:21 -0700607 // Can only be called from the main thread or with mStateLock held
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700608 uint32_t setTransactionFlags(uint32_t flags);
Ana Krulec7ecce8c2018-10-12 13:44:41 -0700609 uint32_t setTransactionFlags(uint32_t flags, Scheduler::TransactionStart transactionStart);
Nataniel Borges2b796da2019-02-15 13:32:18 -0800610 void commitTransaction() REQUIRES(mStateLock);
chaviw74d90ad2019-04-26 14:45:26 -0700611 void commitOffscreenLayers();
Marissa Wall17b4e452018-12-26 16:32:34 -0800612 bool transactionIsReadyToBeApplied(int64_t desiredPresentTime,
Dominik Laskowskia8955dd2019-07-10 10:19:09 -0700613 bool useCachedExpectedPresentTime,
Marissa Wall17b4e452018-12-26 16:32:34 -0800614 const Vector<ComposerState>& states);
Vishnu Nairce5d0cc2019-02-28 14:38:41 -0800615 uint32_t setDisplayStateLocked(const DisplayState& s) REQUIRES(mStateLock);
Vishnu Nairfa5f8df2019-02-13 17:02:51 -0800616 uint32_t addInputWindowCommands(const InputWindowCommands& inputWindowCommands)
617 REQUIRES(mStateLock);
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800618
Lloyd Pique58e24a32019-08-01 15:50:14 -0700619protected:
620 virtual uint32_t setClientStateLocked(
621 const ComposerState& composerState, int64_t desiredPresentTime, int64_t postTime,
622 bool privileged,
623 std::unordered_set<ListenerCallbacks, ListenerCallbacksHash>& listenerCallbacks)
624 REQUIRES(mStateLock);
625 virtual void commitTransactionLocked();
626
627private:
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700628 /* ------------------------------------------------------------------------
629 * Layer management
630 */
Marissa Wall2d814fb2019-04-09 18:52:57 +0000631 status_t createLayer(const String8& name, const sp<Client>& client, uint32_t w, uint32_t h,
632 PixelFormat format, uint32_t flags, LayerMetadata metadata,
Robert Carrc0df3122019-04-11 13:18:21 -0700633 sp<IBinder>* handle, sp<IGraphicBufferProducer>* gbp,
Valerie Hau1acd6962019-10-28 16:35:48 -0700634 const sp<IBinder>& parentHandle, const sp<Layer>& parentLayer = nullptr,
635 uint32_t* outTransformHint = nullptr);
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800636
Dominik Laskowski87a07e42019-10-10 20:38:02 -0700637 status_t createBufferQueueLayer(const sp<Client>& client, std::string name, uint32_t w,
Evan Roskya1f1e152019-01-24 16:17:46 -0800638 uint32_t h, uint32_t flags, LayerMetadata metadata,
639 PixelFormat& format, sp<IBinder>* outHandle,
640 sp<IGraphicBufferProducer>* outGbp, sp<Layer>* outLayer);
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800641
Dominik Laskowski87a07e42019-10-10 20:38:02 -0700642 status_t createBufferStateLayer(const sp<Client>& client, std::string name, uint32_t w,
Evan Roskya1f1e152019-01-24 16:17:46 -0800643 uint32_t h, uint32_t flags, LayerMetadata metadata,
Valerie Hau1acd6962019-10-28 16:35:48 -0700644 sp<IBinder>* outHandle, uint32_t* outTransformHint,
645 sp<Layer>* outLayer);
Marissa Wall61c58622018-07-18 10:12:20 -0700646
Dominik Laskowski87a07e42019-10-10 20:38:02 -0700647 status_t createColorLayer(const sp<Client>& client, std::string name, uint32_t w, uint32_t h,
Evan Roskya1f1e152019-01-24 16:17:46 -0800648 uint32_t flags, LayerMetadata metadata, sp<IBinder>* outHandle,
649 sp<Layer>* outLayer);
Mathias Agopian74c40c02010-09-29 13:02:36 -0700650
Dominik Laskowski87a07e42019-10-10 20:38:02 -0700651 status_t createContainerLayer(const sp<Client>& client, std::string name, uint32_t w,
Evan Roskya1f1e152019-01-24 16:17:46 -0800652 uint32_t h, uint32_t flags, LayerMetadata metadata,
653 sp<IBinder>* outHandle, sp<Layer>* outLayer);
Robert Carr6b3f6c52018-08-13 13:05:17 -0700654
chaviwfe94a222019-08-21 13:52:59 -0700655 status_t mirrorLayer(const sp<Client>& client, const sp<IBinder>& mirrorFromHandle,
656 sp<IBinder>* outHandle);
657
Dominik Laskowski87a07e42019-10-10 20:38:02 -0700658 std::string getUniqueLayerName(const char* name);
Cody Northropbc755282017-03-31 12:00:08 -0600659
Rob Carr4bba3702018-10-08 21:53:30 +0000660 // called when all clients have released all their references to
661 // this layer meaning it is entirely safe to destroy all
662 // resources associated to this layer.
Robert Carr695d5282018-12-18 15:27:58 -0800663 void onHandleDestroyed(sp<Layer>& layer);
Robert Carr6fb1a7e2018-12-11 12:07:25 -0800664 void markLayerPendingRemovalLocked(const sp<Layer>& layer);
Mathias Agopiana4912602012-07-12 14:25:33 -0700665
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700666 // add a layer to SurfaceFlinger
Robert Carrc0df3122019-04-11 13:18:21 -0700667 status_t addClientLayer(const sp<Client>& client, const sp<IBinder>& handle,
668 const sp<IGraphicBufferProducer>& gbc, const sp<Layer>& lbc,
669 const sp<IBinder>& parentHandle, const sp<Layer>& parentLayer,
670 bool addToCurrentState);
Mathias Agopianf1d8e872009-04-20 19:39:12 -0700671
Vishnu Nair4351ad52019-02-11 14:13:02 -0800672 // Traverse through all the layers and compute and cache its bounds.
673 void computeLayerBounds();
674
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700675 /* ------------------------------------------------------------------------
676 * Boot animation, on/off animations and screen capture
677 */
Mathias Agopianbb641242010-05-18 17:06:55 -0700678
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700679 void startBootAnim();
Mathias Agopian96f08192010-06-02 23:28:45 -0700680
Dominik Laskowski9dab3432019-03-27 13:21:10 -0700681 using TraverseLayersFunction = std::function<void(const LayerVector::Visitor&)>;
682
chaviwa76b2712017-09-20 12:02:26 -0700683 void renderScreenImplLocked(const RenderArea& renderArea, TraverseLayersFunction traverseLayers,
Alec Mourie7d1d4a2019-02-05 01:13:46 +0000684 ANativeWindowBuffer* buffer, bool useIdentityTransform,
685 int* outSyncFd);
chaviwa76b2712017-09-20 12:02:26 -0700686 status_t captureScreenCommon(RenderArea& renderArea, TraverseLayersFunction traverseLayers,
Peiyong Lin0e003c92018-09-17 11:09:51 -0700687 sp<GraphicBuffer>* outBuffer, const ui::PixelFormat reqPixelFormat,
Robert Carr108b2c72019-04-02 16:32:58 -0700688 bool useIdentityTransform, bool& outCapturedSecureLayers);
Kevin DuBois7cbcc372019-02-25 14:53:28 -0800689 status_t captureScreenCommon(RenderArea& renderArea, TraverseLayersFunction traverseLayers,
Robert Carr108b2c72019-04-02 16:32:58 -0700690 const sp<GraphicBuffer>& buffer, bool useIdentityTransform,
691 bool& outCapturedSecureLayers);
chaviw93df2ea2019-04-30 16:45:12 -0700692 const sp<DisplayDevice> getDisplayByIdOrLayerStack(uint64_t displayOrLayerStack);
Vishnu Nair3a7346c2019-12-04 08:09:09 -0800693 const sp<DisplayDevice> getDisplayByLayerStack(uint64_t layerStack);
chaviwa76b2712017-09-20 12:02:26 -0700694 status_t captureScreenImplLocked(const RenderArea& renderArea,
695 TraverseLayersFunction traverseLayers,
696 ANativeWindowBuffer* buffer, bool useIdentityTransform,
Robert Carr108b2c72019-04-02 16:32:58 -0700697 bool forSystem, int* outSyncFd, bool& outCapturedSecureLayers);
chaviw0e3479f2018-09-10 16:49:30 -0700698 void traverseLayersInDisplay(const sp<const DisplayDevice>& display,
699 const LayerVector::Visitor& visitor);
Mathias Agopianabe815d2013-03-19 22:22:21 -0700700
Lloyd Pique90c115d2018-09-18 21:39:42 -0700701 sp<StartPropertySetThread> mStartPropertySetThread;
Wei Wangb254fa32017-01-31 17:43:23 -0800702
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700703 /* ------------------------------------------------------------------------
Romain Guy11d63f42017-07-20 12:47:14 -0700704 * Properties
705 */
706 void readPersistentProperties();
707
708 /* ------------------------------------------------------------------------
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700709 * EGL
710 */
Mathias Agopian875d8e12013-06-07 15:35:48 -0700711 size_t getMaxTextureSize() const;
712 size_t getMaxViewportDims() const;
Mathias Agopiana4912602012-07-12 14:25:33 -0700713
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700714 /* ------------------------------------------------------------------------
Mathias Agopian87baae12012-07-31 12:38:26 -0700715 * Display and layer stack management
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700716 */
Andy McFadden13a082e2012-08-24 10:16:42 -0700717 // called when starting, or restarting after system_server death
718 void initializeDisplays();
719
Dominik Laskowskieecd6592018-05-29 10:25:41 -0700720 sp<const DisplayDevice> getDisplayDevice(const wp<IBinder>& displayToken) const {
721 Mutex::Autolock _l(mStateLock);
722 return getDisplayDeviceLocked(displayToken);
Stephen Kiazyk7d3dcb92017-04-05 16:46:49 -0700723 }
724
Dominik Laskowskieecd6592018-05-29 10:25:41 -0700725 sp<DisplayDevice> getDisplayDevice(const wp<IBinder>& displayToken) {
726 Mutex::Autolock _l(mStateLock);
727 return getDisplayDeviceLocked(displayToken);
Stephen Kiazyk7d3dcb92017-04-05 16:46:49 -0700728 }
729
730 // NOTE: can only be called from the main thread or with mStateLock held
Dominik Laskowskieecd6592018-05-29 10:25:41 -0700731 sp<const DisplayDevice> getDisplayDeviceLocked(const wp<IBinder>& displayToken) const {
732 return const_cast<SurfaceFlinger*>(this)->getDisplayDeviceLocked(displayToken);
Mathias Agopian92a979a2012-08-02 18:32:23 -0700733 }
Mathias Agopiandb9b41f2012-10-15 16:51:41 -0700734
735 // NOTE: can only be called from the main thread or with mStateLock held
Dominik Laskowskieecd6592018-05-29 10:25:41 -0700736 sp<DisplayDevice> getDisplayDeviceLocked(const wp<IBinder>& displayToken) {
Dominik Laskowski9fae1022018-05-29 13:17:40 -0700737 const auto it = mDisplays.find(displayToken);
738 return it == mDisplays.end() ? nullptr : it->second;
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700739 }
Mathias Agopian99b49842011-06-27 16:05:52 -0700740
Stephen Kiazyk7d3dcb92017-04-05 16:46:49 -0700741 sp<const DisplayDevice> getDefaultDisplayDeviceLocked() const {
Dominik Laskowskieecd6592018-05-29 10:25:41 -0700742 return const_cast<SurfaceFlinger*>(this)->getDefaultDisplayDeviceLocked();
Stephen Kiazyk7d3dcb92017-04-05 16:46:49 -0700743 }
744
Dominik Laskowskieecd6592018-05-29 10:25:41 -0700745 sp<DisplayDevice> getDefaultDisplayDeviceLocked() {
Dominik Laskowskidcb38bb2019-01-25 02:35:50 -0800746 if (const auto token = getInternalDisplayTokenLocked()) {
Dominik Laskowski075d3172018-05-24 15:50:06 -0700747 return getDisplayDeviceLocked(token);
748 }
749 return nullptr;
Michael Wright28f24d02016-07-12 13:30:53 -0700750 }
751
Mathias Agopian87baae12012-07-31 12:38:26 -0700752 // mark a region of a layer stack dirty. this updates the dirty
753 // region of all screens presenting this layer stack.
Chia-I Wuab0c3192017-08-01 11:29:00 -0700754 void invalidateLayerStack(const sp<const Layer>& layer, const Region& dirty);
Mathias Agopian87baae12012-07-31 12:38:26 -0700755
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700756 /* ------------------------------------------------------------------------
Mathias Agopian86303202012-07-24 22:46:10 -0700757 * H/W composer
758 */
759
Lloyd Pique441d5042018-10-18 16:49:51 -0700760 // The current hardware composer interface.
761 //
762 // The following thread safety rules apply when accessing mHwc, either
763 // directly or via getHwComposer():
764 //
765 // 1. When recreating mHwc, acquire mStateLock. We currently recreate mHwc
766 // only when switching into and out of vr. Recreating mHwc must only be
767 // done on the main thread.
768 //
769 // 2. When accessing mHwc on the main thread, it's not necessary to acquire
770 // mStateLock.
771 //
772 // 3. When accessing mHwc on a thread other than the main thread, we always
773 // need to acquire mStateLock. This is because the main thread could be
774 // in the process of destroying the current mHwc instance.
775 //
776 // The above thread safety rules only apply to SurfaceFlinger.cpp. In
777 // SurfaceFlinger_hwc1.cpp we create mHwc at surface flinger init and never
778 // destroy it, so it's always safe to access mHwc from any thread without
779 // acquiring mStateLock.
780 HWComposer& getHwComposer() const;
Mathias Agopian86303202012-07-24 22:46:10 -0700781
Mathias Agopian888c8222012-08-04 21:10:38 -0700782 /* ------------------------------------------------------------------------
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700783 * Compositing
784 */
785 void invalidateHwcGeometry();
Mathias Agopiancd60f992012-08-16 16:28:27 -0700786
David Sodman2b406362017-12-15 13:33:47 -0800787 void postComposition();
Dominik Laskowskif654d572018-12-20 11:03:06 -0800788 void getCompositorTiming(CompositorTiming* compositorTiming);
Ana Krulece588e312018-09-18 12:32:24 -0700789 void updateCompositorTiming(const DisplayStatInfo& stats, nsecs_t compositeTime,
790 std::shared_ptr<FenceTime>& presentFenceTime);
791 void setCompositorTimingSnapped(const DisplayStatInfo& stats,
792 nsecs_t compositeToPresentLatency);
Courtney Goeltzenleuchter5d943892017-03-22 13:46:46 -0600793
David Sodmanfa9b2af2017-12-24 13:28:59 -0800794 void postFrame();
Mathias Agopian4da75192010-08-10 17:19:56 -0700795
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700796 /* ------------------------------------------------------------------------
Jamie Gennis0bceb842012-08-23 20:19:38 -0700797 * Display management
798 */
Lloyd Pique542307f2018-10-19 13:24:08 -0700799 sp<DisplayDevice> setupNewDisplayDeviceInternal(
800 const wp<IBinder>& displayToken, const std::optional<DisplayId>& displayId,
801 const DisplayDeviceState& state,
802 const sp<compositionengine::DisplaySurface>& dispSurface,
803 const sp<IGraphicBufferProducer>& producer);
Lloyd Pique347200f2017-12-14 17:00:15 -0800804 void processDisplayChangesLocked();
Lloyd Piqueba04e622017-12-14 17:11:26 -0800805 void processDisplayHotplugEventsLocked();
Mathias Agopian3ee454a2012-08-27 16:28:24 -0700806
Dominik Laskowskidcb38bb2019-01-25 02:35:50 -0800807 void dispatchDisplayHotplugEvent(PhysicalDisplayId displayId, bool connected);
Dominik Laskowski1eba0202019-01-24 09:14:40 -0800808
Jamie Gennisfaf77cc2013-07-30 15:10:32 -0700809 /* ------------------------------------------------------------------------
810 * VSync
811 */
Dominik Laskowski83b88212018-12-11 13:34:06 -0800812 nsecs_t getVsyncPeriod() const REQUIRES(mStateLock);
Robert Carr1f0a16a2016-10-24 16:27:39 -0700813
Dominik Laskowskiccf37d72019-02-01 16:47:58 -0800814 // Sets the refresh rate by switching active configs, if they are available for
Ana Krulec7d1d6832018-12-27 11:10:09 -0800815 // the desired refresh rate.
Ady Abraham2139f732019-11-13 18:56:40 -0800816 void changeRefreshRateLocked(const RefreshRate&, Scheduler::ConfigEvent event)
817 REQUIRES(mStateLock);
Jamie Gennis0bceb842012-08-23 20:19:38 -0700818
Ady Abraham2139f732019-11-13 18:56:40 -0800819 bool isDisplayConfigAllowed(HwcConfigIndexType configId) const REQUIRES(mStateLock);
Jamie Gennis0bceb842012-08-23 20:19:38 -0700820
Ady Abraham11579302019-09-19 12:35:58 -0700821 bool previousFrameMissed(int graceTimeMs = 0);
Dominik Laskowskia8955dd2019-07-10 10:19:09 -0700822
823 // Populates the expected present time for this frame. For negative offsets, performs a
824 // correction using the predicted vsync for the next frame instead.
825 void populateExpectedPresentTime();
826
Dominik Laskowskic2867142019-01-21 11:33:38 -0800827 /*
828 * Display identification
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700829 */
Dominik Laskowskidcb38bb2019-01-25 02:35:50 -0800830 sp<IBinder> getPhysicalDisplayTokenLocked(DisplayId displayId) const {
Dominik Laskowski075d3172018-05-24 15:50:06 -0700831 const auto it = mPhysicalDisplayTokens.find(displayId);
832 return it != mPhysicalDisplayTokens.end() ? it->second : nullptr;
833 }
834
Dominik Laskowskidcb38bb2019-01-25 02:35:50 -0800835 std::optional<DisplayId> getPhysicalDisplayIdLocked(const sp<IBinder>& displayToken) const {
Dominik Laskowski075d3172018-05-24 15:50:06 -0700836 for (const auto& [id, token] : mPhysicalDisplayTokens) {
837 if (token == displayToken) {
838 return id;
839 }
840 }
841 return {};
842 }
843
844 // TODO(b/74619554): Remove special cases for primary display.
Dominik Laskowskidcb38bb2019-01-25 02:35:50 -0800845 sp<IBinder> getInternalDisplayTokenLocked() const {
846 const auto displayId = getInternalDisplayIdLocked();
847 return displayId ? getPhysicalDisplayTokenLocked(*displayId) : nullptr;
Dominik Laskowski075d3172018-05-24 15:50:06 -0700848 }
849
Dominik Laskowskidcb38bb2019-01-25 02:35:50 -0800850 std::optional<DisplayId> getInternalDisplayIdLocked() const {
Dominik Laskowski075d3172018-05-24 15:50:06 -0700851 const auto hwcDisplayId = getHwComposer().getInternalHwcDisplayId();
852 return hwcDisplayId ? getHwComposer().toPhysicalDisplayId(*hwcDisplayId) : std::nullopt;
853 }
854
Dominik Laskowskic2867142019-01-21 11:33:38 -0800855 /*
856 * Debugging & dumpsys
857 */
Dominik Laskowskic2867142019-01-21 11:33:38 -0800858 using DumpArgs = Vector<String16>;
859 using Dumper = std::function<void(const DumpArgs&, bool asProto, std::string&)>;
860
861 template <typename F, std::enable_if_t<!std::is_member_function_pointer_v<F>>* = nullptr>
862 static Dumper dumper(F&& dump) {
863 using namespace std::placeholders;
864 return std::bind(std::forward<F>(dump), _3);
865 }
866
867 template <typename F, std::enable_if_t<std::is_member_function_pointer_v<F>>* = nullptr>
868 Dumper dumper(F dump) {
869 using namespace std::placeholders;
870 return std::bind(dump, this, _3);
871 }
872
873 template <typename F>
874 Dumper argsDumper(F dump) {
875 using namespace std::placeholders;
876 return std::bind(dump, this, _1, _3);
877 }
878
879 template <typename F>
880 Dumper protoDumper(F dump) {
881 using namespace std::placeholders;
882 return std::bind(dump, this, _1, _2, _3);
883 }
884
885 void dumpAllLocked(const DumpArgs& args, std::string& result) const REQUIRES(mStateLock);
886
887 void appendSfConfigString(std::string& result) const;
888 void listLayersLocked(std::string& result) const;
889 void dumpStatsLocked(const DumpArgs& args, std::string& result) const REQUIRES(mStateLock);
890 void clearStatsLocked(const DumpArgs& args, std::string& result);
891 void dumpTimeStats(const DumpArgs& args, bool asProto, std::string& result) const;
Jamie Gennis6547ff42013-07-16 20:12:42 -0700892 void logFrameStats();
893
Dominik Laskowskid9e4de62019-01-21 14:23:01 -0800894 void dumpVSync(std::string& result) const REQUIRES(mStateLock);
Yiwei Zhang5434a782018-12-05 18:06:32 -0800895 void dumpStaticScreenStats(std::string& result) const;
Brian Andersond6927fb2016-07-23 23:37:30 -0700896 // Not const because each Layer needs to query Fences and cache timestamps.
Yiwei Zhang5434a782018-12-05 18:06:32 -0800897 void dumpFrameEventsLocked(std::string& result);
Dan Stozab90cf072015-03-05 11:05:59 -0800898
Dominik Laskowski87a07e42019-10-10 20:38:02 -0700899 void recordBufferingStats(const std::string& layerName,
900 std::vector<OccupancyTracker::Segment>&& history);
Yiwei Zhang5434a782018-12-05 18:06:32 -0800901 void dumpBufferingStats(std::string& result) const;
902 void dumpDisplayIdentificationData(std::string& result) const;
Dominik Laskowskib6e54372019-09-04 14:06:28 -0700903 void dumpRawDisplayIdentificationData(const DumpArgs&, std::string& result) const;
Yiwei Zhang5434a782018-12-05 18:06:32 -0800904 void dumpWideColorInfo(std::string& result) const;
Vishnu Nair8406fd72019-07-30 11:29:31 -0700905 LayersProto dumpDrawingStateProto(uint32_t traceFlags = SurfaceTracing::TRACE_ALL) const;
Vishnu Nair0f085c62019-08-30 08:49:12 -0700906 void dumpOffscreenLayersProto(LayersProto& layersProto,
907 uint32_t traceFlags = SurfaceTracing::TRACE_ALL) const;
Vishnu Nair8406fd72019-07-30 11:29:31 -0700908 LayersProto dumpProtoFromMainThread(uint32_t traceFlags = SurfaceTracing::TRACE_ALL)
909 EXCLUDES(mStateLock);
Vishnu Nair0f085c62019-08-30 08:49:12 -0700910 void dumpOffscreenLayers(std::string& result) EXCLUDES(mStateLock);
Nataniel Borges2b796da2019-02-15 13:32:18 -0800911 void withTracingLock(std::function<void()> operation) REQUIRES(mStateLock);
Dan Stozae77c7662016-05-13 11:37:28 -0700912
Fabien Sanglard63a5fcd2016-12-29 15:13:07 -0800913 bool isLayerTripleBufferingDisabled() const {
914 return this->mLayerTripleBufferingDisabled;
915 }
Dominik Laskowskic2867142019-01-21 11:33:38 -0800916
917 status_t doDump(int fd, const DumpArgs& args, bool asProto);
918
Nataniel Borges8e7dc722019-02-28 15:10:28 -0800919 status_t dumpCritical(int fd, const DumpArgs&, bool asProto);
Dominik Laskowskic2867142019-01-21 11:33:38 -0800920
921 status_t dumpAll(int fd, const DumpArgs& args, bool asProto) override {
922 return doDump(fd, args, asProto);
923 }
Hendrik Wagenaar87670ff2017-02-01 12:10:46 -0800924
Hendrik Wagenaar87670ff2017-02-01 12:10:46 -0800925 /* ------------------------------------------------------------------------
926 * VrFlinger
927 */
Steven Thomasb02664d2017-07-26 18:48:28 -0700928 void resetDisplayState();
Hendrik Wagenaar87670ff2017-02-01 12:10:46 -0800929
Steven Thomas050b2c82017-03-06 11:45:16 -0800930 // Check to see if we should handoff to vr flinger.
931 void updateVrFlinger();
Hendrik Wagenaar87670ff2017-02-01 12:10:46 -0800932
Chia-I Wu28f320b2018-05-03 11:02:56 -0700933 void updateColorMatrixLocked();
934
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700935 /* ------------------------------------------------------------------------
936 * Attributes
937 */
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800938
Lloyd Pique90c115d2018-09-18 21:39:42 -0700939 surfaceflinger::Factory& mFactory;
940
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700941 // access must be protected by mStateLock
942 mutable Mutex mStateLock;
Dan Stoza412903f2017-04-27 13:42:17 -0700943 State mCurrentState{LayerVector::StateSet::Current};
Dominik Laskowski9dab3432019-03-27 13:21:10 -0700944 std::atomic<int32_t> mTransactionFlags = 0;
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700945 Condition mTransactionCV;
Dominik Laskowski9dab3432019-03-27 13:21:10 -0700946 bool mTransactionPending = false;
947 bool mAnimTransactionPending = false;
948 SortedVector<sp<Layer>> mLayersPendingRemoval;
949 bool mTraversalNeededMainThread = false;
Dan Stoza101d8dc2018-02-27 15:42:25 -0800950
Nataniel Borges2b796da2019-02-15 13:32:18 -0800951 // guards access to the mDrawing state if tracing is enabled.
952 mutable std::mutex mDrawingStateLock;
953
Chia-I Wu28f320b2018-05-03 11:02:56 -0700954 // global color transform states
955 Daltonizer mDaltonizer;
956 float mGlobalSaturationFactor = 1.0f;
957 mat4 mClientColorMatrix;
958
Dan Stoza101d8dc2018-02-27 15:42:25 -0800959 // Can't be unordered_set because wp<> isn't hashable
960 std::set<wp<IBinder>> mGraphicBufferProducerList;
Dan Stoza0a0158c2018-03-16 13:38:54 -0700961 size_t mMaxGraphicBufferProducerListSize = MAX_LAYERS;
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800962
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700963 // protected by mStateLock (but we could use another lock)
Dominik Laskowski9dab3432019-03-27 13:21:10 -0700964 bool mLayersRemoved = false;
965 bool mLayersAdded = false;
Mathias Agopianca4d3602011-05-19 15:38:14 -0700966
Dominik Laskowski9dab3432019-03-27 13:21:10 -0700967 std::atomic<bool> mRepaintEverything = false;
Mathias Agopianca4d3602011-05-19 15:38:14 -0700968
Hendrik Wagenaar87670ff2017-02-01 12:10:46 -0800969 // constant members (no synchronization needed for access)
Dominik Laskowski9dab3432019-03-27 13:21:10 -0700970 const nsecs_t mBootTime = systemTime();
971 bool mGpuToCpuSupported = false;
Mathias Agopian3094df32012-06-18 18:06:45 -0700972
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700973 // Can only accessed from the main thread, these members
974 // don't need synchronization
Dan Stoza412903f2017-04-27 13:42:17 -0700975 State mDrawingState{LayerVector::StateSet::Drawing};
Dominik Laskowski9dab3432019-03-27 13:21:10 -0700976 bool mVisibleRegionsDirty = false;
Vishnu Nair6194e2e2019-02-06 12:58:39 -0800977 // Set during transaction commit stage to track if the input info for a layer has changed.
Dominik Laskowski9dab3432019-03-27 13:21:10 -0700978 bool mInputInfoChanged = false;
979 bool mGeometryInvalid = false;
980 bool mAnimCompositionPending = false;
Dan Stoza9e56aa02015-11-02 13:00:03 -0800981 std::vector<sp<Layer>> mLayersWithQueuedFrames;
Vishnu Nair6194e2e2019-02-06 12:58:39 -0800982 // Tracks layers that need to update a display's dirty region.
983 std::vector<sp<Layer>> mLayersPendingRefresh;
Ady Abrahambe0f9482019-04-24 15:41:53 -0700984 std::array<sp<Fence>, 2> mPreviousPresentFences = {Fence::NO_FENCE, Fence::NO_FENCE};
Alec Mouricc0fc602019-02-26 21:45:19 -0800985 // True if in the previous frame at least one layer was composed via the GPU.
Dan Stoza05dacfb2016-07-01 13:33:38 -0700986 bool mHadClientComposition = false;
Alec Mouricc0fc602019-02-26 21:45:19 -0800987 // True if in the previous frame at least one layer was composed via HW Composer.
988 // Note that it is possible for a frame to be composed via both client and device
989 // composition, for example in the case of overlays.
990 bool mHadDeviceComposition = false;
Mathias Agopiandb9b41f2012-10-15 16:51:41 -0700991
Chia-I Wu14c9c7b2018-06-26 10:18:18 +0800992 enum class BootStage {
993 BOOTLOADER,
994 BOOTANIMATION,
995 FINISHED,
996 };
Dominik Laskowski9dab3432019-03-27 13:21:10 -0700997 BootStage mBootStage = BootStage::BOOTLOADER;
Chia-I Wu14c9c7b2018-06-26 10:18:18 +0800998
Lloyd Piqueba04e622017-12-14 17:11:26 -0800999 struct HotplugEvent {
Dominik Laskowskia2edf612018-06-01 13:15:16 -07001000 hwc2_display_t hwcDisplayId;
Lloyd Piqueba04e622017-12-14 17:11:26 -08001001 HWC2::Connection connection = HWC2::Connection::Invalid;
Lloyd Piqueba04e622017-12-14 17:11:26 -08001002 };
1003 // protected by mStateLock
1004 std::vector<HotplugEvent> mPendingHotplugEvents;
1005
Mathias Agopiandb9b41f2012-10-15 16:51:41 -07001006 // this may only be written from the main thread with mStateLock held
1007 // it may be read from other threads with mStateLock held
Dominik Laskowski9fae1022018-05-29 13:17:40 -07001008 std::map<wp<IBinder>, sp<DisplayDevice>> mDisplays;
Dominik Laskowskidcb38bb2019-01-25 02:35:50 -08001009 std::unordered_map<DisplayId, sp<IBinder>> mPhysicalDisplayTokens;
Mathias Agopian921e6ac2012-07-23 23:11:29 -07001010
Robert Carrc0df3122019-04-11 13:18:21 -07001011 // protected by mStateLock
1012 std::unordered_map<BBinder*, wp<Layer>> mLayersByLocalBinderToken;
1013
Mathias Agopian921e6ac2012-07-23 23:11:29 -07001014 // don't use a lock for these, we don't care
Dominik Laskowski9dab3432019-03-27 13:21:10 -07001015 int mDebugRegion = 0;
1016 bool mDebugDisableHWC = false;
1017 bool mDebugDisableTransformHint = false;
Dominik Laskowski9dab3432019-03-27 13:21:10 -07001018 volatile nsecs_t mDebugInTransaction = 0;
1019 bool mForceFullDamage = false;
Dan Stozac5da2712016-07-20 15:38:12 -07001020 bool mPropagateBackpressure = true;
Ady Abrahamadb9a992019-09-19 21:21:55 +00001021 bool mPropagateBackpressureClientComposition = false;
Dominik Laskowski9dab3432019-03-27 13:21:10 -07001022 std::unique_ptr<SurfaceInterceptor> mInterceptor;
1023 SurfaceTracing mTracing{*this};
Nataniel Borges2b796da2019-02-15 13:32:18 -08001024 bool mTracingEnabled = false;
1025 bool mTracingEnabledChanged GUARDED_BY(mStateLock) = false;
Dominik Laskowski9dab3432019-03-27 13:21:10 -07001026 const std::shared_ptr<TimeStats> mTimeStats;
Mikael Pessa90092f42019-08-26 17:22:04 -07001027 const std::unique_ptr<FrameTracer> mFrameTracer;
Fabien Sanglard642b23d2017-02-09 12:29:39 -08001028 bool mUseHwcVirtualDisplays = false;
Lucas Dupin19c8f0e2019-11-25 17:55:44 -08001029 bool mEnableBlurs = false;
Dominik Laskowski9dab3432019-03-27 13:21:10 -07001030 std::atomic<uint32_t> mFrameMissedCount = 0;
1031 std::atomic<uint32_t> mHwcFrameMissedCount = 0;
1032 std::atomic<uint32_t> mGpuFrameMissedCount = 0;
Mathias Agopian921e6ac2012-07-23 23:11:29 -07001033
Marissa Walle2ffb422018-10-12 11:33:52 -07001034 TransactionCompletedThread mTransactionCompletedThread;
1035
Fabien Sanglard63a5fcd2016-12-29 15:13:07 -08001036 // Restrict layers to use two buffers in their bufferqueues.
1037 bool mLayerTripleBufferingDisabled = false;
1038
Mathias Agopian921e6ac2012-07-23 23:11:29 -07001039 // these are thread safe
Dominik Laskowski9dab3432019-03-27 13:21:10 -07001040 std::unique_ptr<MessageQueue> mEventQueue;
Jamie Gennis4b0eba92013-02-05 13:30:24 -08001041 FrameTracker mAnimFrameTracker;
Mathias Agopian921e6ac2012-07-23 23:11:29 -07001042
1043 // protected by mDestroyedLayerLock;
1044 mutable Mutex mDestroyedLayerLock;
Mathias Agopian13127d82013-03-05 17:47:11 -08001045 Vector<Layer const *> mDestroyedLayers;
Mathias Agopian921e6ac2012-07-23 23:11:29 -07001046
Dominik Laskowski9dab3432019-03-27 13:21:10 -07001047 nsecs_t mRefreshStartTime = 0;
Jamie Gennisfaf77cc2013-07-30 15:10:32 -07001048
Dominik Laskowski9dab3432019-03-27 13:21:10 -07001049 std::atomic<bool> mRefreshPending = false;
Dan Stoza2b6d38e2017-06-01 16:40:30 -07001050
Dan Stoza436ccf32018-06-21 12:10:12 -07001051 // We maintain a pool of pre-generated texture names to hand out to avoid
1052 // layer creation needing to run on the main thread (which it would
1053 // otherwise need to do to access RenderEngine).
1054 std::mutex mTexturePoolMutex;
1055 uint32_t mTexturePoolSize = 0;
1056 std::vector<uint32_t> mTexturePool;
1057
Marissa Wall713b63f2018-10-17 15:42:43 -07001058 struct TransactionState {
1059 TransactionState(const Vector<ComposerState>& composerStates,
Marissa Wall17b4e452018-12-26 16:32:34 -08001060 const Vector<DisplayState>& displayStates, uint32_t transactionFlags,
Marissa Wall947d34e2019-03-29 14:03:53 -07001061 int64_t desiredPresentTime, const client_cache_t& uncacheBuffer,
Valerie Hau9dab9732019-08-20 09:29:25 -07001062 int64_t postTime, bool privileged, bool hasListenerCallbacks,
1063 std::vector<ListenerCallbacks> listenerCallbacks)
Marissa Wall17b4e452018-12-26 16:32:34 -08001064 : states(composerStates),
1065 displays(displayStates),
1066 flags(transactionFlags),
Valerie Haubc6ddb12019-03-08 11:10:15 -08001067 desiredPresentTime(desiredPresentTime),
Marissa Wall78b72202019-03-15 14:58:34 -07001068 buffer(uncacheBuffer),
Valerie Haubc6ddb12019-03-08 11:10:15 -08001069 postTime(postTime),
Valerie Hau9dab9732019-08-20 09:29:25 -07001070 privileged(privileged),
1071 hasListenerCallbacks(hasListenerCallbacks),
1072 listenerCallbacks(listenerCallbacks) {}
Marissa Wall713b63f2018-10-17 15:42:43 -07001073
1074 Vector<ComposerState> states;
1075 Vector<DisplayState> displays;
1076 uint32_t flags;
Valerie Haubc6ddb12019-03-08 11:10:15 -08001077 const int64_t desiredPresentTime;
Marissa Wall947d34e2019-03-29 14:03:53 -07001078 client_cache_t buffer;
Valerie Haubc6ddb12019-03-08 11:10:15 -08001079 const int64_t postTime;
Robert Carr14167e02019-02-13 13:50:55 -08001080 bool privileged;
Valerie Hau9dab9732019-08-20 09:29:25 -07001081 bool hasListenerCallbacks;
1082 std::vector<ListenerCallbacks> listenerCallbacks;
Marissa Wall713b63f2018-10-17 15:42:43 -07001083 };
Valerie Hau5de3ad22019-08-20 07:47:43 -07001084 std::unordered_map<sp<IBinder>, std::queue<TransactionState>, IListenerHash> mTransactionQueues;
Marissa Wall713b63f2018-10-17 15:42:43 -07001085
Mathias Agopian921e6ac2012-07-23 23:11:29 -07001086 /* ------------------------------------------------------------------------
1087 * Feature prototyping
1088 */
1089
Dan Stozab90cf072015-03-05 11:05:59 -08001090 // Static screen stats
Dominik Laskowski9dab3432019-03-27 13:21:10 -07001091 bool mHasPoweredOff = false;
Dan Stozae77c7662016-05-13 11:37:28 -07001092
chaviweadf0d42019-08-12 13:28:29 -07001093 std::atomic<size_t> mNumLayers = 0;
Robert Carr1f0a16a2016-10-24 16:27:39 -07001094
Fabien Sanglard6e8e98a2016-10-27 20:04:11 -07001095 // Verify that transaction is being called by an approved process:
1096 // either AID_GRAPHICS or AID_SYSTEM.
1097 status_t CheckTransactCodeCredentials(uint32_t code);
Hendrik Wagenaar87670ff2017-02-01 12:10:46 -08001098
Steven Morelanda904bb92019-07-02 17:37:23 -07001099 // to linkToDeath
1100 sp<IBinder> mWindowManager;
1101
Steven Thomasb02664d2017-07-26 18:48:28 -07001102 std::unique_ptr<dvr::VrFlinger> mVrFlinger;
Dominik Laskowski9dab3432019-03-27 13:21:10 -07001103 std::atomic<bool> mVrFlingerRequestsDisplay = false;
Steven Thomas050b2c82017-03-06 11:45:16 -08001104 static bool useVrFlinger;
Dominik Laskowski9dab3432019-03-27 13:21:10 -07001105 std::thread::id mMainThreadId = std::this_thread::get_id();
Romain Guy0147a172017-06-01 13:53:56 -07001106
Lloyd Pique6a3b4462019-03-07 20:58:12 -08001107 DisplayColorSetting mDisplayColorSetting = DisplayColorSetting::kEnhanced;
David Sodman105b7dc2017-11-04 20:28:14 -07001108
Peiyong Lina3ea5592019-02-10 14:45:00 -08001109 // Color mode forced by setting persist.sys.sf.color_mode, it must:
1110 // 1. not be NATIVE color mode, NATIVE color mode means no forced color mode;
1111 // 2. be one of the supported color modes returned by hardware composer, otherwise
1112 // it will not be respected.
1113 // persist.sys.sf.color_mode will only take effect when persist.sys.sf.native_mode
1114 // is not set to 1.
1115 // This property can be used to force SurfaceFlinger to always pick a certain color mode.
1116 ui::ColorMode mForceColorMode = ui::ColorMode::NATIVE;
1117
Peiyong Lin9d846a52018-11-05 13:18:20 -08001118 ui::Dataspace mDefaultCompositionDataspace;
1119 ui::Dataspace mWideColorGamutCompositionDataspace;
Yichi Chenda901bf2019-06-28 14:58:27 +08001120 ui::Dataspace mColorSpaceAgnosticDataspace;
Peiyong Lin9d846a52018-11-05 13:18:20 -08001121
David Sodman105b7dc2017-11-04 20:28:14 -07001122 SurfaceFlingerBE mBE;
Lloyd Pique70d91362018-10-18 16:02:55 -07001123 std::unique_ptr<compositionengine::CompositionEngine> mCompositionEngine;
Ana Krulec98b5b242018-08-10 15:03:23 -07001124
Ana Krulecb43429d2019-01-09 14:28:51 -08001125 /* ------------------------------------------------------------------------
1126 * Scheduler
1127 */
Ana Krulec98b5b242018-08-10 15:03:23 -07001128 std::unique_ptr<Scheduler> mScheduler;
Dominik Laskowski98041832019-08-01 18:35:59 -07001129 scheduler::ConnectionHandle mAppConnectionHandle;
1130 scheduler::ConnectionHandle mSfConnectionHandle;
Robert Carr720e5062018-07-30 17:45:14 -07001131
Dominik Laskowskieddeda12019-07-19 11:54:13 -07001132 // Stores phase offsets configured per refresh rate.
Ady Abraham9e16a482019-12-03 17:19:41 -08001133 std::unique_ptr<scheduler::PhaseConfiguration> mPhaseConfiguration;
Dominik Laskowskieddeda12019-07-19 11:54:13 -07001134
1135 // Optional to defer construction until scheduler connections are created.
1136 std::optional<scheduler::VSyncModulator> mVSyncModulator;
1137
Steven Thomas2bbaabe2019-08-28 16:08:35 -07001138 std::unique_ptr<scheduler::RefreshRateConfigs> mRefreshRateConfigs;
1139 std::unique_ptr<scheduler::RefreshRateStats> mRefreshRateStats;
Ady Abraham1902d072019-03-01 17:18:59 -08001140
Dominik Laskowskia8955dd2019-07-10 10:19:09 -07001141 std::atomic<nsecs_t> mExpectedPresentTime = 0;
1142
Ana Kruleca5bdd9d2019-01-29 19:00:58 -08001143 std::mutex mActiveConfigLock;
1144 // This bit is set once we start setting the config. We read from this bit during the
1145 // process. If at the end, this bit is different than mDesiredActiveConfig, we restart
1146 // the process.
1147 ActiveConfigInfo mUpcomingActiveConfig; // Always read and written on the main thread.
1148 // This bit can be set at any point in time when the system wants the new config.
1149 ActiveConfigInfo mDesiredActiveConfig GUARDED_BY(mActiveConfigLock);
1150
Ady Abrahamb838aed2019-02-12 15:30:16 -08001151 // below flags are set by main thread only
Ady Abraham50204dd2019-07-19 15:47:11 -07001152 TracedOrdinal<bool> mDesiredActiveConfigChanged
1153 GUARDED_BY(mActiveConfigLock) = {"DesiredActiveConfigChanged", false};
Ady Abrahamb838aed2019-02-12 15:30:16 -08001154 bool mCheckPendingFence = false;
1155
Kevin DuBois413287f2019-02-25 08:46:47 -08001156 bool mLumaSampling = true;
1157 sp<RegionSamplingThread> mRegionSamplingThread;
Dominik Laskowski9dab3432019-03-27 13:21:10 -07001158 ui::DisplayPrimaries mInternalDisplayPrimaries;
Kevin DuBois413287f2019-02-25 08:46:47 -08001159
Robert Carr720e5062018-07-30 17:45:14 -07001160 sp<IInputFlinger> mInputFlinger;
Vishnu Nairfa5f8df2019-02-13 17:02:51 -08001161 InputWindowCommands mPendingInputWindowCommands GUARDED_BY(mStateLock);
1162 // Should only be accessed by the main thread.
chaviw273171b2018-12-26 11:46:30 -08001163 InputWindowCommands mInputWindowCommands;
chaviw291d88a2019-02-14 10:33:58 -08001164
Dominik Laskowski9dab3432019-03-27 13:21:10 -07001165 struct SetInputWindowsListener : BnSetInputWindowsListener {
1166 explicit SetInputWindowsListener(sp<SurfaceFlinger> flinger)
1167 : mFlinger(std::move(flinger)) {}
1168
1169 void onSetInputWindowsFinished() override;
1170
1171 const sp<SurfaceFlinger> mFlinger;
1172 };
1173
1174 const sp<SetInputWindowsListener> mSetInputWindowsListener = new SetInputWindowsListener(this);
1175
chaviw95ef3c42019-02-14 10:55:09 -08001176 bool mPendingSyncInputWindows GUARDED_BY(mStateLock);
Peiyong Lin74ca2f42019-01-14 19:36:57 -08001177 Hwc2::impl::PowerAdvisor mPowerAdvisor;
Ady Abraham03b02dd2019-03-21 15:40:11 -07001178
Alec Mouri9519bf12019-11-15 16:54:44 -08001179 // This should only be accessed on the main thread.
1180 nsecs_t mFrameStartTime = 0;
1181
Ady Abraham03b02dd2019-03-21 15:40:11 -07001182 std::unique_ptr<RefreshRateOverlay> mRefreshRateOverlay;
Ady Abraham34392f72019-04-10 11:29:27 -07001183
1184 // Flag used to set override allowed display configs from backdoor
1185 bool mDebugDisplayConfigSetByBackdoor = false;
chaviw74d90ad2019-04-26 14:45:26 -07001186
1187 // A set of layers that have no parent so they are not drawn on screen.
1188 // Should only be accessed by the main thread.
1189 // The Layer pointer is removed from the set when the destructor is called so there shouldn't
1190 // be any issues with a raw pointer referencing an invalid object.
1191 std::unordered_set<Layer*> mOffscreenLayers;
Ady Abraham9ba25122019-06-03 17:10:55 -07001192
Ady Abraham27c70212019-06-11 10:52:26 -07001193 // Flags to capture the state of Vsync in HWC
1194 HWC2::Vsync mHWCVsyncState = HWC2::Vsync::Disable;
1195 HWC2::Vsync mHWCVsyncPendingState = HWC2::Vsync::Disable;
Romain Guy0147a172017-06-01 13:53:56 -07001196};
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -08001197
Dominik Laskowski9dab3432019-03-27 13:21:10 -07001198} // namespace android