Chia-I Wu | aab99f5 | 2016-10-05 12:59:58 +0800 | [diff] [blame] | 1 | /* |
| 2 | * Copyright 2016 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 | #ifndef ANDROID_SF_COMPOSER_HAL_H |
| 18 | #define ANDROID_SF_COMPOSER_HAL_H |
| 19 | |
Chia-I Wu | cd8d7f0 | 2016-11-16 11:02:31 +0800 | [diff] [blame] | 20 | #include <memory> |
Chia-I Wu | aab99f5 | 2016-10-05 12:59:58 +0800 | [diff] [blame] | 21 | #include <string> |
Chia-I Wu | cd8d7f0 | 2016-11-16 11:02:31 +0800 | [diff] [blame] | 22 | #include <unordered_map> |
| 23 | #include <utility> |
Chia-I Wu | aab99f5 | 2016-10-05 12:59:58 +0800 | [diff] [blame] | 24 | #include <vector> |
| 25 | |
Ady Abraham | 8a82ba6 | 2020-01-17 12:43:17 -0800 | [diff] [blame] | 26 | // TODO(b/129481165): remove the #pragma below and fix conversion issues |
| 27 | #pragma clang diagnostic push |
| 28 | #pragma clang diagnostic ignored "-Wconversion" |
Marin Shalamanov | bed7fd3 | 2020-12-21 20:02:20 +0100 | [diff] [blame] | 29 | #pragma clang diagnostic ignored "-Wextra" |
Ady Abraham | 8a82ba6 | 2020-01-17 12:43:17 -0800 | [diff] [blame] | 30 | |
Peiyong Lin | 34beb7a | 2018-03-28 11:57:12 -0700 | [diff] [blame] | 31 | #include <android/hardware/graphics/common/1.1/types.h> |
Dominik Laskowski | 25a4e7d | 2019-09-20 14:50:10 -0700 | [diff] [blame] | 32 | #include <android/hardware/graphics/composer/2.4/IComposer.h> |
| 33 | #include <android/hardware/graphics/composer/2.4/IComposerClient.h> |
Peiyong Lin | afa0f57 | 2020-01-13 16:35:02 -0800 | [diff] [blame] | 34 | #include <composer-command-buffer/2.4/ComposerCommandBuffer.h> |
Courtney Goeltzenleuchter | f9c98e5 | 2018-02-12 07:23:17 -0700 | [diff] [blame] | 35 | #include <gui/HdrMetadata.h> |
Peiyong Lin | 0e7a791 | 2018-04-05 14:36:36 -0700 | [diff] [blame] | 36 | #include <math/mat4.h> |
Kevin DuBois | 1d4249a | 2018-08-29 10:45:14 -0700 | [diff] [blame] | 37 | #include <ui/DisplayedFrameStats.h> |
Lloyd Pique | d0094aa | 2017-12-20 16:43:28 -0800 | [diff] [blame] | 38 | #include <ui/GraphicBuffer.h> |
Chia-I Wu | aab99f5 | 2016-10-05 12:59:58 +0800 | [diff] [blame] | 39 | #include <utils/StrongPointer.h> |
| 40 | |
Ady Abraham | 8a82ba6 | 2020-01-17 12:43:17 -0800 | [diff] [blame] | 41 | // TODO(b/129481165): remove the #pragma below and fix conversion issues |
Marin Shalamanov | bed7fd3 | 2020-12-21 20:02:20 +0100 | [diff] [blame] | 42 | #pragma clang diagnostic pop // ignored "-Wconversion -Wextra" |
Ady Abraham | 8a82ba6 | 2020-01-17 12:43:17 -0800 | [diff] [blame] | 43 | |
Chia-I Wu | aab99f5 | 2016-10-05 12:59:58 +0800 | [diff] [blame] | 44 | namespace android { |
| 45 | |
| 46 | namespace Hwc2 { |
| 47 | |
Dominik Laskowski | 6231aaf | 2018-04-02 17:10:23 -0700 | [diff] [blame] | 48 | namespace types = hardware::graphics::common; |
Chia-I Wu | aab99f5 | 2016-10-05 12:59:58 +0800 | [diff] [blame] | 49 | |
Dominik Laskowski | 6231aaf | 2018-04-02 17:10:23 -0700 | [diff] [blame] | 50 | namespace V2_1 = hardware::graphics::composer::V2_1; |
| 51 | namespace V2_2 = hardware::graphics::composer::V2_2; |
Dominik Laskowski | e9ef7c4 | 2018-03-12 19:34:30 -0700 | [diff] [blame] | 52 | namespace V2_3 = hardware::graphics::composer::V2_3; |
Dominik Laskowski | 25a4e7d | 2019-09-20 14:50:10 -0700 | [diff] [blame] | 53 | namespace V2_4 = hardware::graphics::composer::V2_4; |
Chia-I Wu | aab99f5 | 2016-10-05 12:59:58 +0800 | [diff] [blame] | 54 | |
Dominik Laskowski | 6231aaf | 2018-04-02 17:10:23 -0700 | [diff] [blame] | 55 | using types::V1_0::ColorTransform; |
Dominik Laskowski | 6231aaf | 2018-04-02 17:10:23 -0700 | [diff] [blame] | 56 | using types::V1_0::Transform; |
Dominik Laskowski | 6231aaf | 2018-04-02 17:10:23 -0700 | [diff] [blame] | 57 | using types::V1_1::RenderIntent; |
Valerie Hau | 9758ae0 | 2018-10-09 16:05:09 -0700 | [diff] [blame] | 58 | using types::V1_2::ColorMode; |
| 59 | using types::V1_2::Dataspace; |
Valerie Hau | e9e843a | 2018-12-18 13:39:23 -0800 | [diff] [blame] | 60 | using types::V1_2::Hdr; |
Kevin DuBois | 73d0f48 | 2019-01-25 11:18:03 -0800 | [diff] [blame] | 61 | using types::V1_2::PixelFormat; |
Valerie Hau | e9e843a | 2018-12-18 13:39:23 -0800 | [diff] [blame] | 62 | |
Dominik Laskowski | 6231aaf | 2018-04-02 17:10:23 -0700 | [diff] [blame] | 63 | using V2_1::Config; |
| 64 | using V2_1::Display; |
| 65 | using V2_1::Error; |
Dominik Laskowski | 6231aaf | 2018-04-02 17:10:23 -0700 | [diff] [blame] | 66 | using V2_1::Layer; |
Peiyong Lin | afa0f57 | 2020-01-13 16:35:02 -0800 | [diff] [blame] | 67 | using V2_4::CommandReaderBase; |
| 68 | using V2_4::CommandWriterBase; |
Dominik Laskowski | 25a4e7d | 2019-09-20 14:50:10 -0700 | [diff] [blame] | 69 | using V2_4::IComposer; |
Ady Abraham | 7159f57 | 2019-10-11 11:10:18 -0700 | [diff] [blame] | 70 | using V2_4::IComposerCallback; |
Dominik Laskowski | 25a4e7d | 2019-09-20 14:50:10 -0700 | [diff] [blame] | 71 | using V2_4::IComposerClient; |
Ady Abraham | 7159f57 | 2019-10-11 11:10:18 -0700 | [diff] [blame] | 72 | using V2_4::VsyncPeriodChangeTimeline; |
| 73 | using V2_4::VsyncPeriodNanos; |
Peiyong Lin | ed531a3 | 2018-10-26 18:27:56 -0700 | [diff] [blame] | 74 | using DisplayCapability = IComposerClient::DisplayCapability; |
Peiyong Lin | 0ac5f4e | 2018-04-19 22:06:34 -0700 | [diff] [blame] | 75 | using PerFrameMetadata = IComposerClient::PerFrameMetadata; |
| 76 | using PerFrameMetadataKey = IComposerClient::PerFrameMetadataKey; |
Valerie Hau | e9e843a | 2018-12-18 13:39:23 -0800 | [diff] [blame] | 77 | using PerFrameMetadataBlob = IComposerClient::PerFrameMetadataBlob; |
Peiyong Lin | 0ac5f4e | 2018-04-19 22:06:34 -0700 | [diff] [blame] | 78 | |
Lloyd Pique | a822d52 | 2017-12-20 16:42:57 -0800 | [diff] [blame] | 79 | class Composer { |
| 80 | public: |
| 81 | virtual ~Composer() = 0; |
| 82 | |
| 83 | virtual std::vector<IComposer::Capability> getCapabilities() = 0; |
| 84 | virtual std::string dumpDebugInfo() = 0; |
| 85 | |
| 86 | virtual void registerCallback(const sp<IComposerCallback>& callback) = 0; |
| 87 | |
Lloyd Pique | a822d52 | 2017-12-20 16:42:57 -0800 | [diff] [blame] | 88 | // Reset all pending commands in the command buffer. Useful if you want to |
| 89 | // skip a frame but have already queued some commands. |
| 90 | virtual void resetCommands() = 0; |
| 91 | |
| 92 | // Explicitly flush all pending commands in the command buffer. |
| 93 | virtual Error executeCommands() = 0; |
| 94 | |
| 95 | virtual uint32_t getMaxVirtualDisplayCount() = 0; |
Lloyd Pique | a822d52 | 2017-12-20 16:42:57 -0800 | [diff] [blame] | 96 | virtual Error createVirtualDisplay(uint32_t width, uint32_t height, PixelFormat* format, |
| 97 | Display* outDisplay) = 0; |
| 98 | virtual Error destroyVirtualDisplay(Display display) = 0; |
| 99 | |
| 100 | virtual Error acceptDisplayChanges(Display display) = 0; |
| 101 | |
| 102 | virtual Error createLayer(Display display, Layer* outLayer) = 0; |
| 103 | virtual Error destroyLayer(Display display, Layer layer) = 0; |
| 104 | |
| 105 | virtual Error getActiveConfig(Display display, Config* outConfig) = 0; |
| 106 | virtual Error getChangedCompositionTypes( |
| 107 | Display display, std::vector<Layer>* outLayers, |
| 108 | std::vector<IComposerClient::Composition>* outTypes) = 0; |
| 109 | virtual Error getColorModes(Display display, std::vector<ColorMode>* outModes) = 0; |
| 110 | virtual Error getDisplayAttribute(Display display, Config config, |
| 111 | IComposerClient::Attribute attribute, int32_t* outValue) = 0; |
| 112 | virtual Error getDisplayConfigs(Display display, std::vector<Config>* outConfigs) = 0; |
| 113 | virtual Error getDisplayName(Display display, std::string* outName) = 0; |
| 114 | |
| 115 | virtual Error getDisplayRequests(Display display, uint32_t* outDisplayRequestMask, |
| 116 | std::vector<Layer>* outLayers, |
| 117 | std::vector<uint32_t>* outLayerRequestMasks) = 0; |
| 118 | |
Lloyd Pique | a822d52 | 2017-12-20 16:42:57 -0800 | [diff] [blame] | 119 | virtual Error getDozeSupport(Display display, bool* outSupport) = 0; |
| 120 | virtual Error getHdrCapabilities(Display display, std::vector<Hdr>* outTypes, |
| 121 | float* outMaxLuminance, float* outMaxAverageLuminance, |
| 122 | float* outMinLuminance) = 0; |
| 123 | |
| 124 | virtual Error getReleaseFences(Display display, std::vector<Layer>* outLayers, |
| 125 | std::vector<int>* outReleaseFences) = 0; |
| 126 | |
| 127 | virtual Error presentDisplay(Display display, int* outPresentFence) = 0; |
| 128 | |
| 129 | virtual Error setActiveConfig(Display display, Config config) = 0; |
| 130 | |
| 131 | /* |
| 132 | * The composer caches client targets internally. When target is nullptr, |
| 133 | * the composer uses slot to look up the client target from its cache. |
| 134 | * When target is not nullptr, the cache is updated with the new target. |
| 135 | */ |
| 136 | virtual Error setClientTarget(Display display, uint32_t slot, const sp<GraphicBuffer>& target, |
| 137 | int acquireFence, Dataspace dataspace, |
| 138 | const std::vector<IComposerClient::Rect>& damage) = 0; |
Peiyong Lin | 0e7a791 | 2018-04-05 14:36:36 -0700 | [diff] [blame] | 139 | virtual Error setColorMode(Display display, ColorMode mode, RenderIntent renderIntent) = 0; |
Lloyd Pique | a822d52 | 2017-12-20 16:42:57 -0800 | [diff] [blame] | 140 | virtual Error setColorTransform(Display display, const float* matrix, ColorTransform hint) = 0; |
| 141 | virtual Error setOutputBuffer(Display display, const native_handle_t* buffer, |
| 142 | int releaseFence) = 0; |
| 143 | virtual Error setPowerMode(Display display, IComposerClient::PowerMode mode) = 0; |
| 144 | virtual Error setVsyncEnabled(Display display, IComposerClient::Vsync enabled) = 0; |
| 145 | |
| 146 | virtual Error setClientTargetSlotCount(Display display) = 0; |
| 147 | |
| 148 | virtual Error validateDisplay(Display display, uint32_t* outNumTypes, |
| 149 | uint32_t* outNumRequests) = 0; |
| 150 | |
| 151 | virtual Error presentOrValidateDisplay(Display display, uint32_t* outNumTypes, |
| 152 | uint32_t* outNumRequests, int* outPresentFence, |
| 153 | uint32_t* state) = 0; |
| 154 | |
| 155 | virtual Error setCursorPosition(Display display, Layer layer, int32_t x, int32_t y) = 0; |
| 156 | /* see setClientTarget for the purpose of slot */ |
| 157 | virtual Error setLayerBuffer(Display display, Layer layer, uint32_t slot, |
| 158 | const sp<GraphicBuffer>& buffer, int acquireFence) = 0; |
| 159 | virtual Error setLayerSurfaceDamage(Display display, Layer layer, |
| 160 | const std::vector<IComposerClient::Rect>& damage) = 0; |
| 161 | virtual Error setLayerBlendMode(Display display, Layer layer, |
| 162 | IComposerClient::BlendMode mode) = 0; |
| 163 | virtual Error setLayerColor(Display display, Layer layer, |
| 164 | const IComposerClient::Color& color) = 0; |
| 165 | virtual Error setLayerCompositionType(Display display, Layer layer, |
| 166 | IComposerClient::Composition type) = 0; |
| 167 | virtual Error setLayerDataspace(Display display, Layer layer, Dataspace dataspace) = 0; |
| 168 | virtual Error setLayerDisplayFrame(Display display, Layer layer, |
| 169 | const IComposerClient::Rect& frame) = 0; |
| 170 | virtual Error setLayerPlaneAlpha(Display display, Layer layer, float alpha) = 0; |
| 171 | virtual Error setLayerSidebandStream(Display display, Layer layer, |
| 172 | const native_handle_t* stream) = 0; |
| 173 | virtual Error setLayerSourceCrop(Display display, Layer layer, |
| 174 | const IComposerClient::FRect& crop) = 0; |
| 175 | virtual Error setLayerTransform(Display display, Layer layer, Transform transform) = 0; |
| 176 | virtual Error setLayerVisibleRegion(Display display, Layer layer, |
| 177 | const std::vector<IComposerClient::Rect>& visible) = 0; |
| 178 | virtual Error setLayerZOrder(Display display, Layer layer, uint32_t z) = 0; |
Peiyong Lin | 0e7a791 | 2018-04-05 14:36:36 -0700 | [diff] [blame] | 179 | |
| 180 | // Composer HAL 2.2 |
Peiyong Lin | 0ac5f4e | 2018-04-19 22:06:34 -0700 | [diff] [blame] | 181 | virtual Error setLayerPerFrameMetadata( |
| 182 | Display display, Layer layer, |
| 183 | const std::vector<IComposerClient::PerFrameMetadata>& perFrameMetadatas) = 0; |
Chia-I Wu | d7e01d7 | 2018-06-21 13:39:09 +0800 | [diff] [blame] | 184 | virtual std::vector<IComposerClient::PerFrameMetadataKey> getPerFrameMetadataKeys( |
| 185 | Display display) = 0; |
Peiyong Lin | 0e7a791 | 2018-04-05 14:36:36 -0700 | [diff] [blame] | 186 | virtual Error getRenderIntents(Display display, ColorMode colorMode, |
| 187 | std::vector<RenderIntent>* outRenderIntents) = 0; |
| 188 | virtual Error getDataspaceSaturationMatrix(Dataspace dataspace, mat4* outMatrix) = 0; |
Dominik Laskowski | e9ef7c4 | 2018-03-12 19:34:30 -0700 | [diff] [blame] | 189 | |
| 190 | // Composer HAL 2.3 |
| 191 | virtual Error getDisplayIdentificationData(Display display, uint8_t* outPort, |
| 192 | std::vector<uint8_t>* outData) = 0; |
Peiyong Lin | 698147a | 2018-09-14 13:27:18 -0700 | [diff] [blame] | 193 | virtual Error setLayerColorTransform(Display display, Layer layer, |
| 194 | const float* matrix) = 0; |
Kevin DuBois | 9c0a176 | 2018-10-16 13:32:31 -0700 | [diff] [blame] | 195 | virtual Error getDisplayedContentSamplingAttributes(Display display, PixelFormat* outFormat, |
| 196 | Dataspace* outDataspace, |
| 197 | uint8_t* outComponentMask) = 0; |
Kevin DuBois | 74e5377 | 2018-11-19 10:52:38 -0800 | [diff] [blame] | 198 | virtual Error setDisplayContentSamplingEnabled(Display display, bool enabled, |
| 199 | uint8_t componentMask, uint64_t maxFrames) = 0; |
Kevin DuBois | 1d4249a | 2018-08-29 10:45:14 -0700 | [diff] [blame] | 200 | virtual Error getDisplayedContentSample(Display display, uint64_t maxFrames, uint64_t timestamp, |
| 201 | DisplayedFrameStats* outStats) = 0; |
Valerie Hau | e9e843a | 2018-12-18 13:39:23 -0800 | [diff] [blame] | 202 | virtual Error setLayerPerFrameMetadataBlobs( |
| 203 | Display display, Layer layer, const std::vector<PerFrameMetadataBlob>& metadata) = 0; |
Dan Gittik | 57e63c5 | 2019-01-18 16:37:54 +0000 | [diff] [blame] | 204 | virtual Error setDisplayBrightness(Display display, float brightness) = 0; |
Dominik Laskowski | 25a4e7d | 2019-09-20 14:50:10 -0700 | [diff] [blame] | 205 | |
| 206 | // Composer HAL 2.4 |
Ady Abraham | 7159f57 | 2019-10-11 11:10:18 -0700 | [diff] [blame] | 207 | virtual bool isVsyncPeriodSwitchSupported() = 0; |
Dominik Laskowski | 25a4e7d | 2019-09-20 14:50:10 -0700 | [diff] [blame] | 208 | virtual Error getDisplayCapabilities(Display display, |
| 209 | std::vector<DisplayCapability>* outCapabilities) = 0; |
Ady Abraham | 7159f57 | 2019-10-11 11:10:18 -0700 | [diff] [blame] | 210 | virtual V2_4::Error getDisplayConnectionType( |
| 211 | Display display, IComposerClient::DisplayConnectionType* outType) = 0; |
| 212 | virtual V2_4::Error getDisplayVsyncPeriod(Display display, |
| 213 | VsyncPeriodNanos* outVsyncPeriod) = 0; |
| 214 | virtual V2_4::Error setActiveConfigWithConstraints( |
| 215 | Display display, Config config, |
| 216 | const IComposerClient::VsyncPeriodChangeConstraints& vsyncPeriodChangeConstraints, |
| 217 | VsyncPeriodChangeTimeline* outTimeline) = 0; |
Galia Peycheva | 5492cb5 | 2019-10-30 14:13:16 +0100 | [diff] [blame] | 218 | |
| 219 | virtual V2_4::Error setAutoLowLatencyMode(Display displayId, bool on) = 0; |
| 220 | virtual V2_4::Error getSupportedContentTypes( |
| 221 | Display displayId, |
| 222 | std::vector<IComposerClient::ContentType>* outSupportedContentTypes) = 0; |
| 223 | virtual V2_4::Error setContentType(Display displayId, |
| 224 | IComposerClient::ContentType contentType) = 0; |
Dan Stoza | 18d48cb | 2019-10-21 15:39:24 -0700 | [diff] [blame] | 225 | virtual V2_4::Error setLayerGenericMetadata(Display display, Layer layer, |
| 226 | const std::string& key, bool mandatory, |
| 227 | const std::vector<uint8_t>& value) = 0; |
| 228 | virtual V2_4::Error getLayerGenericMetadataKeys( |
| 229 | std::vector<IComposerClient::LayerGenericMetadataKey>* outKeys) = 0; |
Peiyong Lin | dfc3f7c | 2020-05-07 20:15:50 -0700 | [diff] [blame] | 230 | virtual Error getClientTargetProperty( |
| 231 | Display display, IComposerClient::ClientTargetProperty* outClientTargetProperty) = 0; |
Lloyd Pique | a822d52 | 2017-12-20 16:42:57 -0800 | [diff] [blame] | 232 | }; |
| 233 | |
| 234 | namespace impl { |
| 235 | |
Chia-I Wu | cd8d7f0 | 2016-11-16 11:02:31 +0800 | [diff] [blame] | 236 | class CommandReader : public CommandReaderBase { |
| 237 | public: |
| 238 | ~CommandReader(); |
| 239 | |
| 240 | // Parse and execute commands from the command queue. The commands are |
| 241 | // actually return values from the server and will be saved in ReturnData. |
| 242 | Error parse(); |
| 243 | |
| 244 | // Get and clear saved errors. |
| 245 | struct CommandError { |
| 246 | uint32_t location; |
| 247 | Error error; |
| 248 | }; |
| 249 | std::vector<CommandError> takeErrors(); |
| 250 | |
Chia-I Wu | 67e376d | 2016-12-19 11:36:22 +0800 | [diff] [blame] | 251 | bool hasChanges(Display display, uint32_t* outNumChangedCompositionTypes, |
| 252 | uint32_t* outNumLayerRequestMasks) const; |
Chia-I Wu | cd8d7f0 | 2016-11-16 11:02:31 +0800 | [diff] [blame] | 253 | |
| 254 | // Get and clear saved changed composition types. |
| 255 | void takeChangedCompositionTypes(Display display, |
Chia-I Wu | 67e376d | 2016-12-19 11:36:22 +0800 | [diff] [blame] | 256 | std::vector<Layer>* outLayers, |
| 257 | std::vector<IComposerClient::Composition>* outTypes); |
Chia-I Wu | cd8d7f0 | 2016-11-16 11:02:31 +0800 | [diff] [blame] | 258 | |
| 259 | // Get and clear saved display requests. |
| 260 | void takeDisplayRequests(Display display, |
Chia-I Wu | 67e376d | 2016-12-19 11:36:22 +0800 | [diff] [blame] | 261 | uint32_t* outDisplayRequestMask, std::vector<Layer>* outLayers, |
| 262 | std::vector<uint32_t>* outLayerRequestMasks); |
Chia-I Wu | cd8d7f0 | 2016-11-16 11:02:31 +0800 | [diff] [blame] | 263 | |
| 264 | // Get and clear saved release fences. |
Chia-I Wu | 67e376d | 2016-12-19 11:36:22 +0800 | [diff] [blame] | 265 | void takeReleaseFences(Display display, std::vector<Layer>* outLayers, |
| 266 | std::vector<int>* outReleaseFences); |
Chia-I Wu | cd8d7f0 | 2016-11-16 11:02:31 +0800 | [diff] [blame] | 267 | |
| 268 | // Get and clear saved present fence. |
Chia-I Wu | 67e376d | 2016-12-19 11:36:22 +0800 | [diff] [blame] | 269 | void takePresentFence(Display display, int* outPresentFence); |
Chia-I Wu | cd8d7f0 | 2016-11-16 11:02:31 +0800 | [diff] [blame] | 270 | |
Fabien Sanglard | 249c0ae | 2017-06-19 19:22:36 -0700 | [diff] [blame] | 271 | // Get what stage succeeded during PresentOrValidate: Present or Validate |
| 272 | void takePresentOrValidateStage(Display display, uint32_t * state); |
| 273 | |
Peiyong Lin | dfc3f7c | 2020-05-07 20:15:50 -0700 | [diff] [blame] | 274 | // Get the client target properties requested by hardware composer. |
| 275 | void takeClientTargetProperty(Display display, |
| 276 | IComposerClient::ClientTargetProperty* outClientTargetProperty); |
| 277 | |
Chia-I Wu | cd8d7f0 | 2016-11-16 11:02:31 +0800 | [diff] [blame] | 278 | private: |
| 279 | void resetData(); |
| 280 | |
| 281 | bool parseSelectDisplay(uint16_t length); |
| 282 | bool parseSetError(uint16_t length); |
| 283 | bool parseSetChangedCompositionTypes(uint16_t length); |
| 284 | bool parseSetDisplayRequests(uint16_t length); |
| 285 | bool parseSetPresentFence(uint16_t length); |
| 286 | bool parseSetReleaseFences(uint16_t length); |
Fabien Sanglard | 249c0ae | 2017-06-19 19:22:36 -0700 | [diff] [blame] | 287 | bool parseSetPresentOrValidateDisplayResult(uint16_t length); |
Peiyong Lin | afa0f57 | 2020-01-13 16:35:02 -0800 | [diff] [blame] | 288 | bool parseSetClientTargetProperty(uint16_t length); |
Chia-I Wu | cd8d7f0 | 2016-11-16 11:02:31 +0800 | [diff] [blame] | 289 | |
| 290 | struct ReturnData { |
| 291 | uint32_t displayRequests = 0; |
| 292 | |
| 293 | std::vector<Layer> changedLayers; |
| 294 | std::vector<IComposerClient::Composition> compositionTypes; |
| 295 | |
| 296 | std::vector<Layer> requestedLayers; |
| 297 | std::vector<uint32_t> requestMasks; |
| 298 | |
| 299 | int presentFence = -1; |
| 300 | |
| 301 | std::vector<Layer> releasedLayers; |
| 302 | std::vector<int> releaseFences; |
Fabien Sanglard | 249c0ae | 2017-06-19 19:22:36 -0700 | [diff] [blame] | 303 | |
| 304 | uint32_t presentOrValidateState; |
Peiyong Lin | afa0f57 | 2020-01-13 16:35:02 -0800 | [diff] [blame] | 305 | |
| 306 | // Composer 2.4 implementation can return a client target property |
| 307 | // structure to indicate the client target properties that hardware |
| 308 | // composer requests. The composer client must change the client target |
| 309 | // properties to match this request. |
| 310 | IComposerClient::ClientTargetProperty clientTargetProperty{PixelFormat::RGBA_8888, |
| 311 | Dataspace::UNKNOWN}; |
Chia-I Wu | cd8d7f0 | 2016-11-16 11:02:31 +0800 | [diff] [blame] | 312 | }; |
| 313 | |
| 314 | std::vector<CommandError> mErrors; |
| 315 | std::unordered_map<Display, ReturnData> mReturnData; |
| 316 | |
| 317 | // When SELECT_DISPLAY is parsed, this is updated to point to the |
| 318 | // display's return data in mReturnData. We use it to avoid repeated |
| 319 | // map lookups. |
| 320 | ReturnData* mCurrentReturnData; |
| 321 | }; |
| 322 | |
Chia-I Wu | aab99f5 | 2016-10-05 12:59:58 +0800 | [diff] [blame] | 323 | // Composer is a wrapper to IComposer, a proxy to server-side composer. |
Lloyd Pique | a822d52 | 2017-12-20 16:42:57 -0800 | [diff] [blame] | 324 | class Composer final : public Hwc2::Composer { |
Chia-I Wu | aab99f5 | 2016-10-05 12:59:58 +0800 | [diff] [blame] | 325 | public: |
Chih-Hung Hsieh | 2274904 | 2018-12-20 15:50:39 -0800 | [diff] [blame] | 326 | explicit Composer(const std::string& serviceName); |
Lloyd Pique | a822d52 | 2017-12-20 16:42:57 -0800 | [diff] [blame] | 327 | ~Composer() override; |
Chia-I Wu | aab99f5 | 2016-10-05 12:59:58 +0800 | [diff] [blame] | 328 | |
Lloyd Pique | a822d52 | 2017-12-20 16:42:57 -0800 | [diff] [blame] | 329 | std::vector<IComposer::Capability> getCapabilities() override; |
| 330 | std::string dumpDebugInfo() override; |
Chia-I Wu | aab99f5 | 2016-10-05 12:59:58 +0800 | [diff] [blame] | 331 | |
Lloyd Pique | a822d52 | 2017-12-20 16:42:57 -0800 | [diff] [blame] | 332 | void registerCallback(const sp<IComposerCallback>& callback) override; |
Chia-I Wu | aab99f5 | 2016-10-05 12:59:58 +0800 | [diff] [blame] | 333 | |
Steven Thomas | 0af4b9f | 2017-04-26 14:34:01 -0700 | [diff] [blame] | 334 | // Reset all pending commands in the command buffer. Useful if you want to |
| 335 | // skip a frame but have already queued some commands. |
Lloyd Pique | a822d52 | 2017-12-20 16:42:57 -0800 | [diff] [blame] | 336 | void resetCommands() override; |
Steven Thomas | 0af4b9f | 2017-04-26 14:34:01 -0700 | [diff] [blame] | 337 | |
Chia-I Wu | ae5a6b8 | 2017-10-10 09:09:22 -0700 | [diff] [blame] | 338 | // Explicitly flush all pending commands in the command buffer. |
Lloyd Pique | a822d52 | 2017-12-20 16:42:57 -0800 | [diff] [blame] | 339 | Error executeCommands() override; |
Chia-I Wu | ae5a6b8 | 2017-10-10 09:09:22 -0700 | [diff] [blame] | 340 | |
Lloyd Pique | a822d52 | 2017-12-20 16:42:57 -0800 | [diff] [blame] | 341 | uint32_t getMaxVirtualDisplayCount() override; |
Lloyd Pique | a822d52 | 2017-12-20 16:42:57 -0800 | [diff] [blame] | 342 | Error createVirtualDisplay(uint32_t width, uint32_t height, PixelFormat* format, |
| 343 | Display* outDisplay) override; |
| 344 | Error destroyVirtualDisplay(Display display) override; |
Chia-I Wu | aab99f5 | 2016-10-05 12:59:58 +0800 | [diff] [blame] | 345 | |
Lloyd Pique | a822d52 | 2017-12-20 16:42:57 -0800 | [diff] [blame] | 346 | Error acceptDisplayChanges(Display display) override; |
Chia-I Wu | aab99f5 | 2016-10-05 12:59:58 +0800 | [diff] [blame] | 347 | |
Lloyd Pique | a822d52 | 2017-12-20 16:42:57 -0800 | [diff] [blame] | 348 | Error createLayer(Display display, Layer* outLayer) override; |
| 349 | Error destroyLayer(Display display, Layer layer) override; |
Chia-I Wu | aab99f5 | 2016-10-05 12:59:58 +0800 | [diff] [blame] | 350 | |
Lloyd Pique | a822d52 | 2017-12-20 16:42:57 -0800 | [diff] [blame] | 351 | Error getActiveConfig(Display display, Config* outConfig) override; |
| 352 | Error getChangedCompositionTypes(Display display, std::vector<Layer>* outLayers, |
| 353 | std::vector<IComposerClient::Composition>* outTypes) override; |
| 354 | Error getColorModes(Display display, std::vector<ColorMode>* outModes) override; |
| 355 | Error getDisplayAttribute(Display display, Config config, IComposerClient::Attribute attribute, |
| 356 | int32_t* outValue) override; |
Chia-I Wu | 67e376d | 2016-12-19 11:36:22 +0800 | [diff] [blame] | 357 | Error getDisplayConfigs(Display display, std::vector<Config>* outConfigs); |
Lloyd Pique | a822d52 | 2017-12-20 16:42:57 -0800 | [diff] [blame] | 358 | Error getDisplayName(Display display, std::string* outName) override; |
Chia-I Wu | aab99f5 | 2016-10-05 12:59:58 +0800 | [diff] [blame] | 359 | |
Chia-I Wu | 67e376d | 2016-12-19 11:36:22 +0800 | [diff] [blame] | 360 | Error getDisplayRequests(Display display, uint32_t* outDisplayRequestMask, |
Lloyd Pique | a822d52 | 2017-12-20 16:42:57 -0800 | [diff] [blame] | 361 | std::vector<Layer>* outLayers, |
| 362 | std::vector<uint32_t>* outLayerRequestMasks) override; |
Chia-I Wu | aab99f5 | 2016-10-05 12:59:58 +0800 | [diff] [blame] | 363 | |
Lloyd Pique | a822d52 | 2017-12-20 16:42:57 -0800 | [diff] [blame] | 364 | Error getDozeSupport(Display display, bool* outSupport) override; |
| 365 | Error getHdrCapabilities(Display display, std::vector<Hdr>* outTypes, float* outMaxLuminance, |
| 366 | float* outMaxAverageLuminance, float* outMinLuminance) override; |
Chia-I Wu | aab99f5 | 2016-10-05 12:59:58 +0800 | [diff] [blame] | 367 | |
Chia-I Wu | 67e376d | 2016-12-19 11:36:22 +0800 | [diff] [blame] | 368 | Error getReleaseFences(Display display, std::vector<Layer>* outLayers, |
Lloyd Pique | a822d52 | 2017-12-20 16:42:57 -0800 | [diff] [blame] | 369 | std::vector<int>* outReleaseFences) override; |
Chia-I Wu | aab99f5 | 2016-10-05 12:59:58 +0800 | [diff] [blame] | 370 | |
Lloyd Pique | a822d52 | 2017-12-20 16:42:57 -0800 | [diff] [blame] | 371 | Error presentDisplay(Display display, int* outPresentFence) override; |
Chia-I Wu | aab99f5 | 2016-10-05 12:59:58 +0800 | [diff] [blame] | 372 | |
Lloyd Pique | a822d52 | 2017-12-20 16:42:57 -0800 | [diff] [blame] | 373 | Error setActiveConfig(Display display, Config config) override; |
Chia-I Wu | 06d63de | 2017-01-04 14:58:51 +0800 | [diff] [blame] | 374 | |
| 375 | /* |
| 376 | * The composer caches client targets internally. When target is nullptr, |
| 377 | * the composer uses slot to look up the client target from its cache. |
| 378 | * When target is not nullptr, the cache is updated with the new target. |
| 379 | */ |
Lloyd Pique | a822d52 | 2017-12-20 16:42:57 -0800 | [diff] [blame] | 380 | Error setClientTarget(Display display, uint32_t slot, const sp<GraphicBuffer>& target, |
| 381 | int acquireFence, Dataspace dataspace, |
| 382 | const std::vector<IComposerClient::Rect>& damage) override; |
Peiyong Lin | 0e7a791 | 2018-04-05 14:36:36 -0700 | [diff] [blame] | 383 | Error setColorMode(Display display, ColorMode mode, RenderIntent renderIntent) override; |
Lloyd Pique | a822d52 | 2017-12-20 16:42:57 -0800 | [diff] [blame] | 384 | Error setColorTransform(Display display, const float* matrix, ColorTransform hint) override; |
Chia-I Wu | aab99f5 | 2016-10-05 12:59:58 +0800 | [diff] [blame] | 385 | Error setOutputBuffer(Display display, const native_handle_t* buffer, |
Lloyd Pique | a822d52 | 2017-12-20 16:42:57 -0800 | [diff] [blame] | 386 | int releaseFence) override; |
| 387 | Error setPowerMode(Display display, IComposerClient::PowerMode mode) override; |
| 388 | Error setVsyncEnabled(Display display, IComposerClient::Vsync enabled) override; |
Chia-I Wu | cd8d7f0 | 2016-11-16 11:02:31 +0800 | [diff] [blame] | 389 | |
Lloyd Pique | a822d52 | 2017-12-20 16:42:57 -0800 | [diff] [blame] | 390 | Error setClientTargetSlotCount(Display display) override; |
Chia-I Wu | aab99f5 | 2016-10-05 12:59:58 +0800 | [diff] [blame] | 391 | |
Chia-I Wu | 67e376d | 2016-12-19 11:36:22 +0800 | [diff] [blame] | 392 | Error validateDisplay(Display display, uint32_t* outNumTypes, |
Lloyd Pique | a822d52 | 2017-12-20 16:42:57 -0800 | [diff] [blame] | 393 | uint32_t* outNumRequests) override; |
Chia-I Wu | aab99f5 | 2016-10-05 12:59:58 +0800 | [diff] [blame] | 394 | |
Lloyd Pique | a822d52 | 2017-12-20 16:42:57 -0800 | [diff] [blame] | 395 | Error presentOrValidateDisplay(Display display, uint32_t* outNumTypes, uint32_t* outNumRequests, |
| 396 | int* outPresentFence, uint32_t* state) override; |
Fabien Sanglard | 249c0ae | 2017-06-19 19:22:36 -0700 | [diff] [blame] | 397 | |
Lloyd Pique | a822d52 | 2017-12-20 16:42:57 -0800 | [diff] [blame] | 398 | Error setCursorPosition(Display display, Layer layer, int32_t x, int32_t y) override; |
Chia-I Wu | 06d63de | 2017-01-04 14:58:51 +0800 | [diff] [blame] | 399 | /* see setClientTarget for the purpose of slot */ |
| 400 | Error setLayerBuffer(Display display, Layer layer, uint32_t slot, |
Lloyd Pique | a822d52 | 2017-12-20 16:42:57 -0800 | [diff] [blame] | 401 | const sp<GraphicBuffer>& buffer, int acquireFence) override; |
Chia-I Wu | aab99f5 | 2016-10-05 12:59:58 +0800 | [diff] [blame] | 402 | Error setLayerSurfaceDamage(Display display, Layer layer, |
Lloyd Pique | a822d52 | 2017-12-20 16:42:57 -0800 | [diff] [blame] | 403 | const std::vector<IComposerClient::Rect>& damage) override; |
| 404 | Error setLayerBlendMode(Display display, Layer layer, IComposerClient::BlendMode mode) override; |
| 405 | Error setLayerColor(Display display, Layer layer, const IComposerClient::Color& color) override; |
Chia-I Wu | aab99f5 | 2016-10-05 12:59:58 +0800 | [diff] [blame] | 406 | Error setLayerCompositionType(Display display, Layer layer, |
Lloyd Pique | a822d52 | 2017-12-20 16:42:57 -0800 | [diff] [blame] | 407 | IComposerClient::Composition type) override; |
| 408 | Error setLayerDataspace(Display display, Layer layer, Dataspace dataspace) override; |
Chia-I Wu | aab99f5 | 2016-10-05 12:59:58 +0800 | [diff] [blame] | 409 | Error setLayerDisplayFrame(Display display, Layer layer, |
Lloyd Pique | a822d52 | 2017-12-20 16:42:57 -0800 | [diff] [blame] | 410 | const IComposerClient::Rect& frame) override; |
| 411 | Error setLayerPlaneAlpha(Display display, Layer layer, float alpha) override; |
Chia-I Wu | aab99f5 | 2016-10-05 12:59:58 +0800 | [diff] [blame] | 412 | Error setLayerSidebandStream(Display display, Layer layer, |
Lloyd Pique | a822d52 | 2017-12-20 16:42:57 -0800 | [diff] [blame] | 413 | const native_handle_t* stream) override; |
Chia-I Wu | aab99f5 | 2016-10-05 12:59:58 +0800 | [diff] [blame] | 414 | Error setLayerSourceCrop(Display display, Layer layer, |
Lloyd Pique | a822d52 | 2017-12-20 16:42:57 -0800 | [diff] [blame] | 415 | const IComposerClient::FRect& crop) override; |
| 416 | Error setLayerTransform(Display display, Layer layer, Transform transform) override; |
Chia-I Wu | aab99f5 | 2016-10-05 12:59:58 +0800 | [diff] [blame] | 417 | Error setLayerVisibleRegion(Display display, Layer layer, |
Lloyd Pique | a822d52 | 2017-12-20 16:42:57 -0800 | [diff] [blame] | 418 | const std::vector<IComposerClient::Rect>& visible) override; |
| 419 | Error setLayerZOrder(Display display, Layer layer, uint32_t z) override; |
Lloyd Pique | a822d52 | 2017-12-20 16:42:57 -0800 | [diff] [blame] | 420 | |
Peiyong Lin | 0e7a791 | 2018-04-05 14:36:36 -0700 | [diff] [blame] | 421 | // Composer HAL 2.2 |
Peiyong Lin | 0ac5f4e | 2018-04-19 22:06:34 -0700 | [diff] [blame] | 422 | Error setLayerPerFrameMetadata( |
| 423 | Display display, Layer layer, |
| 424 | const std::vector<IComposerClient::PerFrameMetadata>& perFrameMetadatas) override; |
Chia-I Wu | d7e01d7 | 2018-06-21 13:39:09 +0800 | [diff] [blame] | 425 | std::vector<IComposerClient::PerFrameMetadataKey> getPerFrameMetadataKeys( |
| 426 | Display display) override; |
Peiyong Lin | 0e7a791 | 2018-04-05 14:36:36 -0700 | [diff] [blame] | 427 | Error getRenderIntents(Display display, ColorMode colorMode, |
| 428 | std::vector<RenderIntent>* outRenderIntents) override; |
| 429 | Error getDataspaceSaturationMatrix(Dataspace dataspace, mat4* outMatrix) override; |
| 430 | |
Dominik Laskowski | e9ef7c4 | 2018-03-12 19:34:30 -0700 | [diff] [blame] | 431 | // Composer HAL 2.3 |
| 432 | Error getDisplayIdentificationData(Display display, uint8_t* outPort, |
| 433 | std::vector<uint8_t>* outData) override; |
Peiyong Lin | 698147a | 2018-09-14 13:27:18 -0700 | [diff] [blame] | 434 | Error setLayerColorTransform(Display display, Layer layer, const float* matrix) override; |
Kevin DuBois | 9c0a176 | 2018-10-16 13:32:31 -0700 | [diff] [blame] | 435 | Error getDisplayedContentSamplingAttributes(Display display, PixelFormat* outFormat, |
| 436 | Dataspace* outDataspace, |
| 437 | uint8_t* outComponentMask) override; |
Kevin DuBois | 74e5377 | 2018-11-19 10:52:38 -0800 | [diff] [blame] | 438 | Error setDisplayContentSamplingEnabled(Display display, bool enabled, uint8_t componentMask, |
| 439 | uint64_t maxFrames) override; |
Kevin DuBois | 1d4249a | 2018-08-29 10:45:14 -0700 | [diff] [blame] | 440 | Error getDisplayedContentSample(Display display, uint64_t maxFrames, uint64_t timestamp, |
| 441 | DisplayedFrameStats* outStats) override; |
Valerie Hau | e9e843a | 2018-12-18 13:39:23 -0800 | [diff] [blame] | 442 | Error setLayerPerFrameMetadataBlobs( |
| 443 | Display display, Layer layer, |
| 444 | const std::vector<IComposerClient::PerFrameMetadataBlob>& metadata) override; |
Dan Gittik | 57e63c5 | 2019-01-18 16:37:54 +0000 | [diff] [blame] | 445 | Error setDisplayBrightness(Display display, float brightness) override; |
Dominik Laskowski | e9ef7c4 | 2018-03-12 19:34:30 -0700 | [diff] [blame] | 446 | |
Dominik Laskowski | 25a4e7d | 2019-09-20 14:50:10 -0700 | [diff] [blame] | 447 | // Composer HAL 2.4 |
Ady Abraham | 7159f57 | 2019-10-11 11:10:18 -0700 | [diff] [blame] | 448 | bool isVsyncPeriodSwitchSupported() override { return mClient_2_4 != nullptr; } |
Dominik Laskowski | 25a4e7d | 2019-09-20 14:50:10 -0700 | [diff] [blame] | 449 | Error getDisplayCapabilities(Display display, |
| 450 | std::vector<DisplayCapability>* outCapabilities) override; |
Ady Abraham | 7159f57 | 2019-10-11 11:10:18 -0700 | [diff] [blame] | 451 | V2_4::Error getDisplayConnectionType(Display display, |
| 452 | IComposerClient::DisplayConnectionType* outType) override; |
| 453 | V2_4::Error getDisplayVsyncPeriod(Display display, VsyncPeriodNanos* outVsyncPeriod) override; |
| 454 | V2_4::Error setActiveConfigWithConstraints( |
| 455 | Display display, Config config, |
| 456 | const IComposerClient::VsyncPeriodChangeConstraints& vsyncPeriodChangeConstraints, |
| 457 | VsyncPeriodChangeTimeline* outTimeline) override; |
Galia Peycheva | 5492cb5 | 2019-10-30 14:13:16 +0100 | [diff] [blame] | 458 | V2_4::Error setAutoLowLatencyMode(Display displayId, bool on) override; |
| 459 | V2_4::Error getSupportedContentTypes( |
| 460 | Display displayId, |
| 461 | std::vector<IComposerClient::ContentType>* outSupportedContentTypes) override; |
| 462 | V2_4::Error setContentType(Display displayId, |
| 463 | IComposerClient::ContentType contentType) override; |
Dan Stoza | 18d48cb | 2019-10-21 15:39:24 -0700 | [diff] [blame] | 464 | V2_4::Error setLayerGenericMetadata(Display display, Layer layer, const std::string& key, |
| 465 | bool mandatory, const std::vector<uint8_t>& value) override; |
| 466 | V2_4::Error getLayerGenericMetadataKeys( |
| 467 | std::vector<IComposerClient::LayerGenericMetadataKey>* outKeys) override; |
Peiyong Lin | dfc3f7c | 2020-05-07 20:15:50 -0700 | [diff] [blame] | 468 | Error getClientTargetProperty( |
| 469 | Display display, |
| 470 | IComposerClient::ClientTargetProperty* outClientTargetProperty) override; |
Dominik Laskowski | 25a4e7d | 2019-09-20 14:50:10 -0700 | [diff] [blame] | 471 | |
Chia-I Wu | aab99f5 | 2016-10-05 12:59:58 +0800 | [diff] [blame] | 472 | private: |
mamik | 94e91f6 | 2019-08-19 09:11:33 -0700 | [diff] [blame] | 473 | class CommandWriter : public CommandWriterBase { |
| 474 | public: |
| 475 | explicit CommandWriter(uint32_t initialMaxSize) : CommandWriterBase(initialMaxSize) {} |
| 476 | ~CommandWriter() override {} |
| 477 | }; |
Daniel Nicoara | 2f5f8a5 | 2016-12-20 16:11:58 -0500 | [diff] [blame] | 478 | |
Chia-I Wu | cd8d7f0 | 2016-11-16 11:02:31 +0800 | [diff] [blame] | 479 | // Many public functions above simply write a command into the command |
| 480 | // queue to batch the calls. validateDisplay and presentDisplay will call |
| 481 | // this function to execute the command queue. |
| 482 | Error execute(); |
| 483 | |
Dominik Laskowski | 6231aaf | 2018-04-02 17:10:23 -0700 | [diff] [blame] | 484 | sp<V2_1::IComposer> mComposer; |
| 485 | |
| 486 | sp<V2_1::IComposerClient> mClient; |
Dominik Laskowski | e9ef7c4 | 2018-03-12 19:34:30 -0700 | [diff] [blame] | 487 | sp<V2_2::IComposerClient> mClient_2_2; |
Dominik Laskowski | 25a4e7d | 2019-09-20 14:50:10 -0700 | [diff] [blame] | 488 | sp<V2_3::IComposerClient> mClient_2_3; |
| 489 | sp<IComposerClient> mClient_2_4; |
Chia-I Wu | cd8d7f0 | 2016-11-16 11:02:31 +0800 | [diff] [blame] | 490 | |
| 491 | // 64KiB minus a small space for metadata such as read/write pointers |
| 492 | static constexpr size_t kWriterInitialSize = |
| 493 | 64 * 1024 / sizeof(uint32_t) - 16; |
Daniel Nicoara | 2f5f8a5 | 2016-12-20 16:11:58 -0500 | [diff] [blame] | 494 | CommandWriter mWriter; |
Chia-I Wu | cd8d7f0 | 2016-11-16 11:02:31 +0800 | [diff] [blame] | 495 | CommandReader mReader; |
Chia-I Wu | aab99f5 | 2016-10-05 12:59:58 +0800 | [diff] [blame] | 496 | }; |
| 497 | |
Lloyd Pique | a822d52 | 2017-12-20 16:42:57 -0800 | [diff] [blame] | 498 | } // namespace impl |
| 499 | |
Chia-I Wu | aab99f5 | 2016-10-05 12:59:58 +0800 | [diff] [blame] | 500 | } // namespace Hwc2 |
| 501 | |
| 502 | } // namespace android |
| 503 | |
| 504 | #endif // ANDROID_SF_COMPOSER_HAL_H |