summaryrefslogtreecommitdiffstats
path: root/display/config/1.11/IDisplayConfig.hal
diff options
context:
space:
mode:
Diffstat (limited to 'display/config/1.11/IDisplayConfig.hal')
-rw-r--r--display/config/1.11/IDisplayConfig.hal77
1 files changed, 77 insertions, 0 deletions
diff --git a/display/config/1.11/IDisplayConfig.hal b/display/config/1.11/IDisplayConfig.hal
new file mode 100644
index 0000000..2d09aab
--- /dev/null
+++ b/display/config/1.11/IDisplayConfig.hal
@@ -0,0 +1,77 @@
+/*
+ * Copyright (c) 2019 The Linux Foundation. All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are
+ * met:
+ * * Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ * * Redistributions in binary form must reproduce the above
+ * copyright notice, this list of conditions and the following
+ * disclaimer in the documentation and/or other materials provided
+ * with the distribution.
+ * * Neither the name of The Linux Foundation. nor the names of its
+ * contributors may be used to endorse or promote products derived
+ * from this software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESS OR IMPLIED
+ * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+ * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS
+ * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
+ * BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+ * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
+ * OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ * IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+
+package vendor.display.config@1.11;
+
+import @1.10::IDisplayConfig;
+
+interface IDisplayConfig extends @1.10::IDisplayConfig {
+ enum QsyncMode : int32_t {
+ /* Clear previous qsync mode if any */
+ NONE,
+
+ /*
+ * Enable qsync only for the next frame. Qsync mode will be
+ * automatically cleared after next frame has been composed.
+ * Subsequent frames will not be affected.
+ */
+ WAIT_FOR_FENCES_ONE_FRAME,
+
+ /*
+ * Enable qsync for every frame from next cycle onwards. Vsync timelines
+ * will be extended only if a frame has been committed to HWC i.e. if
+ * HWC does not receive frames from client, vsync will be triggered at
+ * normal intervals. This is similar to setting qsync mode as
+ * WAIT_FOR_FENCES_ONE_FRAME with every commit.
+ */
+ WAIT_FOR_FENCES_EACH_FRAME,
+
+ /*
+ * Enable qsync for every vsync interrupt from next cycle onwards.
+ * Vsync timelines will be extended to maximum stretch possible in an
+ * anticipation that a frame will be commited shortly. If frames are
+ * not commited, final frame rate will eventually drop to lowest
+ * possible frame rate.
+ */
+ WAIT_FOR_COMMIT_EACH_FRAME,
+ };
+
+ /*
+ * Set the desired qsync mode which will ideally take effect from next
+ * composition cycle. Mode change may take longer than one cycle if there
+ * is a conflict with current operation mode.
+ *
+ * @param disp_id display id.
+ * @param mode desired qsync mode.
+ *
+ * @return error is NONE upon success.
+ */
+ @callflow(next="*")
+ setQsyncMode(uint32_t disp_id, QsyncMode mode) generates (int32_t error);
+};