1 /* 2 * Copyright (C) 2021 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17 #pragma once 18 /** 19 * Idealy IComposerHal should use aidl NativeHandle not native_handle_t/buffer_handle_t. 20 * However current patten is the HWC lib does not own buffer resources (HWC lib 21 * does own the fences). 22 */ 23 #include <aidl/android/hardware/common/NativeHandle.h> 24 #include <aidl/android/hardware/graphics/common/BlendMode.h> 25 #include <aidl/android/hardware/graphics/common/ColorTransform.h> 26 #include <aidl/android/hardware/graphics/common/Dataspace.h> 27 #include <aidl/android/hardware/graphics/common/FRect.h> 28 #include <aidl/android/hardware/graphics/common/PixelFormat.h> 29 #include <aidl/android/hardware/graphics/common/Point.h> 30 #include <aidl/android/hardware/graphics/common/Rect.h> 31 #include <aidl/android/hardware/graphics/common/Transform.h> 32 #include <aidl/android/hardware/graphics/composer3/Buffer.h> 33 #include <aidl/android/hardware/graphics/composer3/Capability.h> 34 #include <aidl/android/hardware/graphics/composer3/ChangedCompositionTypes.h> 35 #include <aidl/android/hardware/graphics/composer3/ClientTarget.h> 36 #include <aidl/android/hardware/graphics/composer3/ClientTargetProperty.h> 37 #include <aidl/android/hardware/graphics/composer3/ClientTargetPropertyWithBrightness.h> 38 #include <aidl/android/hardware/graphics/composer3/Color.h> 39 #include <aidl/android/hardware/graphics/composer3/ColorMode.h> 40 #include <aidl/android/hardware/graphics/composer3/CommandError.h> 41 #include <aidl/android/hardware/graphics/composer3/CommandResultPayload.h> 42 #include <aidl/android/hardware/graphics/composer3/Composition.h> 43 #include <aidl/android/hardware/graphics/composer3/ContentType.h> 44 #include <aidl/android/hardware/graphics/composer3/DimmingStage.h> 45 #include <aidl/android/hardware/graphics/composer3/DisplayAttribute.h> 46 #include <aidl/android/hardware/graphics/composer3/DisplayBrightness.h> 47 #include <aidl/android/hardware/graphics/composer3/DisplayCapability.h> 48 #include <aidl/android/hardware/graphics/composer3/DisplayCommand.h> 49 #include <aidl/android/hardware/graphics/composer3/DisplayConnectionType.h> 50 #include <aidl/android/hardware/graphics/composer3/DisplayContentSample.h> 51 #include <aidl/android/hardware/graphics/composer3/DisplayContentSamplingAttributes.h> 52 #include <aidl/android/hardware/graphics/composer3/DisplayIdentification.h> 53 #include <aidl/android/hardware/graphics/composer3/DisplayRequest.h> 54 #include <aidl/android/hardware/graphics/composer3/FormatColorComponent.h> 55 #include <aidl/android/hardware/graphics/composer3/HdrCapabilities.h> 56 #include <aidl/android/hardware/graphics/composer3/LayerBrightness.h> 57 #include <aidl/android/hardware/graphics/composer3/LayerCommand.h> 58 #include <aidl/android/hardware/graphics/composer3/ParcelableBlendMode.h> 59 #include <aidl/android/hardware/graphics/composer3/ParcelableComposition.h> 60 #include <aidl/android/hardware/graphics/composer3/ParcelableDataspace.h> 61 #include <aidl/android/hardware/graphics/composer3/ParcelableTransform.h> 62 #include <aidl/android/hardware/graphics/composer3/PerFrameMetadata.h> 63 #include <aidl/android/hardware/graphics/composer3/PerFrameMetadataBlob.h> 64 #include <aidl/android/hardware/graphics/composer3/PerFrameMetadataKey.h> 65 #include <aidl/android/hardware/graphics/composer3/PlaneAlpha.h> 66 #include <aidl/android/hardware/graphics/composer3/PowerMode.h> 67 #include <aidl/android/hardware/graphics/composer3/PresentFence.h> 68 #include <aidl/android/hardware/graphics/composer3/PresentOrValidate.h> 69 #include <aidl/android/hardware/graphics/composer3/ReadbackBufferAttributes.h> 70 #include <aidl/android/hardware/graphics/composer3/ReleaseFences.h> 71 #include <aidl/android/hardware/graphics/composer3/RenderIntent.h> 72 #include <aidl/android/hardware/graphics/composer3/VirtualDisplay.h> 73 #include <aidl/android/hardware/graphics/composer3/VsyncPeriodChangeConstraints.h> 74 #include <aidl/android/hardware/graphics/composer3/VsyncPeriodChangeTimeline.h> 75 #include <aidl/android/hardware/graphics/composer3/ZOrder.h> 76 #include <cutils/native_handle.h> 77 78 // avoid naming conflict 79 using AidlPixelFormat = aidl::android::hardware::graphics::common::PixelFormat; 80 using AidlNativeHandle = aidl::android::hardware::common::NativeHandle; 81 82 namespace aidl::android::hardware::graphics::composer3::impl { 83 84 // Abstraction of ComposerHal. Returned error code is compatible with AIDL 85 // IComposerClient interface. 86 class IComposerHal { 87 public: 88 static std::unique_ptr<IComposerHal> create(); 89 virtual ~IComposerHal() = default; 90 91 virtual void getCapabilities(std::vector<Capability>* caps) = 0; 92 virtual void dumpDebugInfo(std::string* output) = 0; 93 virtual bool hasCapability(Capability cap) = 0; 94 95 class EventCallback { 96 public: 97 virtual ~EventCallback() = default; 98 virtual void onHotplug(int64_t display, bool connected) = 0; 99 virtual void onRefresh(int64_t display) = 0; 100 virtual void onVsync(int64_t display, int64_t timestamp, int32_t vsyncPeriodNanos) = 0; 101 virtual void onVsyncPeriodTimingChanged(int64_t display, 102 const VsyncPeriodChangeTimeline& timeline) = 0; 103 virtual void onVsyncIdle(int64_t display) = 0; 104 virtual void onSeamlessPossible(int64_t display) = 0; 105 }; 106 virtual void registerEventCallback(EventCallback* callback) = 0; 107 virtual void unregisterEventCallback() = 0; 108 109 virtual int32_t acceptDisplayChanges(int64_t display) = 0; 110 virtual int32_t createLayer(int64_t display, int64_t* outLayer) = 0; 111 virtual int32_t createVirtualDisplay(uint32_t width, uint32_t height, AidlPixelFormat format, 112 VirtualDisplay* outDisplay) = 0; 113 virtual int32_t destroyLayer(int64_t display, int64_t layer) = 0; 114 virtual int32_t destroyVirtualDisplay(int64_t display) = 0; 115 virtual int32_t flushDisplayBrightnessChange(int64_t display) = 0; 116 virtual int32_t getActiveConfig(int64_t display, int32_t* outConfig) = 0; 117 virtual int32_t getColorModes(int64_t display, std::vector<ColorMode>* outModes) = 0; 118 virtual int32_t getDataspaceSaturationMatrix(common::Dataspace dataspace, 119 std::vector<float>* matrix) = 0; 120 virtual int32_t getDisplayAttribute(int64_t display, int32_t config, 121 DisplayAttribute attribute, int32_t* outValue) = 0; 122 virtual int32_t getDisplayBrightnessSupport(int64_t display, bool& outSupport) = 0; 123 virtual int32_t getDisplayIdleTimerSupport(int64_t display, bool& outSupport) = 0; 124 125 virtual int32_t getDisplayCapabilities(int64_t display, 126 std::vector<DisplayCapability>* caps) = 0; 127 virtual int32_t getDisplayConfigs(int64_t display, std::vector<int32_t>* configs) = 0; 128 virtual int32_t getDisplayConnectionType(int64_t display, DisplayConnectionType* outType) = 0; 129 virtual int32_t getDisplayIdentificationData(int64_t display, DisplayIdentification *id) = 0; 130 virtual int32_t getDisplayName(int64_t display, std::string* outName) = 0; 131 virtual int32_t getDisplayVsyncPeriod(int64_t display, int32_t* outVsyncPeriod) = 0; 132 virtual int32_t getDisplayedContentSample(int64_t display, int64_t maxFrames, 133 int64_t timestamp, DisplayContentSample* samples) = 0; 134 virtual int32_t getDisplayedContentSamplingAttributes( 135 int64_t display, DisplayContentSamplingAttributes* attrs) = 0; 136 virtual int32_t getDisplayPhysicalOrientation(int64_t display, 137 common::Transform* orientation) = 0; 138 virtual int32_t getDozeSupport(int64_t display, bool& outSupport) = 0; 139 virtual int32_t getHdrCapabilities(int64_t display, HdrCapabilities* caps) = 0; 140 virtual int32_t getMaxVirtualDisplayCount(int32_t* count) = 0; 141 virtual int32_t getPerFrameMetadataKeys(int64_t display, 142 std::vector<PerFrameMetadataKey>* keys) = 0; 143 virtual int32_t getReadbackBufferAttributes(int64_t display, 144 ReadbackBufferAttributes* attrs) = 0; 145 virtual int32_t getReadbackBufferFence(int64_t display, 146 ndk::ScopedFileDescriptor* aqcuireFence) = 0; 147 virtual int32_t getRenderIntents(int64_t display, ColorMode mode, 148 std::vector<RenderIntent>* intents) = 0; 149 virtual int32_t getSupportedContentTypes(int64_t display, std::vector<ContentType>* types) = 0; 150 virtual int32_t presentDisplay(int64_t display, ndk::ScopedFileDescriptor& fence, 151 std::vector<int64_t>* outLayers, 152 std::vector<ndk::ScopedFileDescriptor>* outReleaseFences) = 0; 153 virtual int32_t setActiveConfig(int64_t display, int32_t config) = 0; 154 virtual int32_t setActiveConfigWithConstraints( 155 int64_t display, int32_t config, 156 const VsyncPeriodChangeConstraints& vsyncPeriodChangeConstraints, 157 VsyncPeriodChangeTimeline* timeline) = 0; 158 virtual int32_t setBootDisplayConfig(int64_t display, int32_t config) = 0; 159 virtual int32_t clearBootDisplayConfig(int64_t display) = 0; 160 virtual int32_t getPreferredBootDisplayConfig(int64_t display, int32_t* config) = 0; 161 virtual int32_t setAutoLowLatencyMode(int64_t display, bool on) = 0; 162 virtual int32_t setClientTarget(int64_t display, buffer_handle_t target, 163 const ndk::ScopedFileDescriptor& fence, 164 common::Dataspace dataspace, 165 const std::vector<common::Rect>& damage) = 0; // cmd 166 virtual int32_t setColorMode(int64_t display, ColorMode mode, RenderIntent intent) = 0; 167 virtual int32_t setColorTransform(int64_t display, const std::vector<float>& matrix) = 0; // cmd 168 virtual int32_t setContentType(int64_t display, ContentType contentType) = 0; 169 virtual int32_t setDisplayBrightness(int64_t display, float brightness) = 0; 170 virtual int32_t setDisplayedContentSamplingEnabled(int64_t display, bool enable, 171 FormatColorComponent componentMask, 172 int64_t maxFrames) = 0; 173 virtual int32_t setLayerBlendMode(int64_t display, int64_t layer, common::BlendMode mode) = 0; 174 virtual int32_t setLayerBuffer(int64_t display, int64_t layer, buffer_handle_t buffer, 175 const ndk::ScopedFileDescriptor& acquireFence) = 0; 176 virtual int32_t setLayerColor(int64_t display, int64_t layer, Color color) = 0; 177 virtual int32_t setLayerColorTransform(int64_t display, int64_t layer, 178 const std::vector<float>& matrix) = 0; 179 virtual int32_t setLayerCompositionType(int64_t display, int64_t layer, Composition type) = 0; 180 virtual int32_t setLayerCursorPosition(int64_t display, int64_t layer, int32_t x, 181 int32_t y) = 0; 182 virtual int32_t setLayerDataspace(int64_t display, int64_t layer, 183 common::Dataspace dataspace) = 0; 184 virtual int32_t setLayerDisplayFrame(int64_t display, int64_t layer, 185 const common::Rect& frame) = 0; 186 virtual int32_t setLayerPerFrameMetadata(int64_t display, int64_t layer, 187 const std::vector<std::optional<PerFrameMetadata>>& metadata) = 0; 188 virtual int32_t setLayerPerFrameMetadataBlobs(int64_t display, int64_t layer, 189 const std::vector<std::optional<PerFrameMetadataBlob>>& blobs) = 0; 190 virtual int32_t setLayerPlaneAlpha(int64_t display, int64_t layer, float alpha) = 0; 191 virtual int32_t setLayerSidebandStream(int64_t display, int64_t layer, 192 buffer_handle_t stream) = 0; 193 virtual int32_t setLayerSourceCrop(int64_t display, int64_t layer, 194 const common::FRect& crop) = 0; 195 virtual int32_t setLayerSurfaceDamage(int64_t display, int64_t layer, 196 const std::vector<std::optional<common::Rect>>& damage) = 0; 197 virtual int32_t setLayerTransform(int64_t display, int64_t layer, 198 common::Transform transform) = 0; 199 virtual int32_t setLayerVisibleRegion(int64_t display, int64_t layer, 200 const std::vector<std::optional<common::Rect>>& visible) = 0; 201 virtual int32_t setLayerBrightness(int64_t display, int64_t layer, float brightness) = 0; 202 virtual int32_t setLayerZOrder(int64_t display, int64_t layer, uint32_t z) = 0; 203 virtual int32_t setOutputBuffer(int64_t display, buffer_handle_t buffer, 204 const ndk::ScopedFileDescriptor& releaseFence) = 0; 205 virtual int32_t setPowerMode(int64_t display, PowerMode mode) = 0; 206 virtual int32_t setReadbackBuffer(int64_t display, buffer_handle_t buffer, 207 const ndk::ScopedFileDescriptor& releaseFence) = 0; 208 virtual int32_t setVsyncEnabled(int64_t display, bool enabled) = 0; 209 virtual int32_t validateDisplay(int64_t display, std::vector<int64_t>* outChangedLayers, 210 std::vector<Composition>* outCompositionTypes, 211 uint32_t* outDisplayRequestMask, 212 std::vector<int64_t>* outRequestedLayers, 213 std::vector<int32_t>* outRequestMasks, 214 ClientTargetProperty* outClientTargetProperty, 215 DimmingStage* outDimmingStage) = 0; 216 virtual int32_t setExpectedPresentTime( 217 int64_t display, const std::optional<ClockMonotonicTimestamp> expectedPresentTime) = 0; 218 virtual int32_t setIdleTimerEnabled(int64_t display, int32_t timeout) = 0; 219 virtual int32_t getRCDLayerSupport(int64_t display, bool& outSupport) = 0; 220 virtual int32_t setLayerBlockingRegion( 221 int64_t display, int64_t layer, 222 const std::vector<std::optional<common::Rect>>& blockingRegion) = 0; 223 }; 224 225 } // namespace aidl::android::hardware::graphics::composer3::detail 226