/* * Copyright (c) 2014-2021, 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. */ /* * Changes from Qualcomm Innovation Center are provided under the following license: * * Copyright (c) 2022 Qualcomm Innovation Center, Inc. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted (subject to the limitations in the * disclaimer below) 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 Qualcomm Innovation Center, Inc. nor the names of its * contributors may be used to endorse or promote products derived * from this software without specific prior written permission. * * NO EXPRESS OR IMPLIED LICENSES TO ANY PARTY'S PATENT RIGHTS ARE * GRANTED BY THIS LICENSE. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT * HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. * IN NO EVENT SHALL THE COPYRIGHT HOLDER 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. */ #ifndef __HW_INTERFACE_H__ #define __HW_INTERFACE_H__ #include #include #include #include #include #include #include #include "hw_info_interface.h" namespace sdm { enum HWScanSupport { kScanNotSupported, kScanAlwaysOverscanned, kScanAlwaysUnderscanned, kScanBoth, }; struct HWScanInfo { HWScanSupport pt_scan_support; // Scan support for preferred timing HWScanSupport it_scan_support; // Scan support for digital monitor or industry timings HWScanSupport cea_scan_support; // Scan support for CEA resolution timings HWScanInfo() : pt_scan_support(kScanNotSupported), it_scan_support(kScanNotSupported), cea_scan_support(kScanNotSupported) { } }; // HWEventHandler - Implemented in DisplayBase and HWInterface implementation class HWEventHandler { public: virtual DisplayError VSync(int64_t timestamp) = 0; virtual DisplayError Blank(bool blank) = 0; virtual void IdleTimeout() = 0; virtual void ThermalEvent(int64_t thermal_level) = 0; virtual void CECMessage(char *message) = 0; virtual void IdlePowerCollapse() = 0; virtual void PingPongTimeout() = 0; virtual void PanelDead() = 0; virtual void HwRecovery(const HWRecoveryEvent sdm_event_code) = 0; virtual void Histogram(int histogram_fd, uint32_t blob_id) = 0; protected: virtual ~HWEventHandler() { } }; class HWInterface { public: static DisplayError Create(int32_t display_id, DisplayType type, HWInfoInterface *hw_info_intf, BufferAllocator *buffer_allocator, HWInterface **intf); static DisplayError Destroy(HWInterface *intf); virtual DisplayError Init() = 0; virtual DisplayError Deinit() = 0; virtual DisplayError GetDisplayId(int32_t *display_id) = 0; virtual DisplayError GetActiveConfig(uint32_t *active_config) = 0; virtual DisplayError GetDefaultConfig(uint32_t *default_config) = 0; virtual DisplayError GetNumDisplayAttributes(uint32_t *count) = 0; virtual DisplayError GetDisplayAttributes(uint32_t index, HWDisplayAttributes *display_attributes) = 0; virtual DisplayError GetHWPanelInfo(HWPanelInfo *panel_info) = 0; virtual DisplayError SetDisplayAttributes(uint32_t index) = 0; virtual DisplayError SetDisplayAttributes(const HWDisplayAttributes &display_attributes) = 0; virtual DisplayError GetConfigIndex(char *mode, uint32_t *index) = 0; virtual DisplayError PowerOn(const HWQosData &qos_data, shared_ptr *release_fence) = 0; virtual DisplayError PowerOff(bool teardown) = 0; virtual DisplayError Doze(const HWQosData &qos_data, shared_ptr *release_fence) = 0; virtual DisplayError DozeSuspend(const HWQosData &qos_data, shared_ptr *release_fence) = 0; virtual DisplayError Standby() = 0; virtual DisplayError Validate(HWLayers *hw_layers) = 0; virtual DisplayError Commit(HWLayers *hw_layers) = 0; virtual DisplayError Flush(HWLayers *hw_layers) = 0; virtual DisplayError GetPPFeaturesVersion(PPFeatureVersion *vers) = 0; virtual DisplayError SetPPFeatures(PPFeaturesConfig *feature_list) = 0; virtual DisplayError SetVSyncState(bool enable) = 0; virtual void SetIdleTimeoutMs(uint32_t timeout_ms) = 0; virtual DisplayError SetDisplayMode(const HWDisplayMode hw_display_mode) = 0; virtual DisplayError SetRefreshRate(uint32_t refresh_rate) = 0; virtual DisplayError SetPanelBrightness(int level) = 0; virtual DisplayError GetHWScanInfo(HWScanInfo *scan_info) = 0; virtual DisplayError GetVideoFormat(uint32_t config_index, uint32_t *video_format) = 0; virtual DisplayError GetMaxCEAFormat(uint32_t *max_cea_format) = 0; virtual DisplayError SetCursorPosition(HWLayers *hw_layers, int x, int y) = 0; virtual DisplayError OnMinHdcpEncryptionLevelChange(uint32_t min_enc_level) = 0; virtual DisplayError GetPanelBrightness(int *level) = 0; virtual DisplayError SetAutoRefresh(bool enable) = 0; virtual DisplayError SetScaleLutConfig(HWScaleLutInfo *lut_info) = 0; virtual DisplayError UnsetScaleLutConfig() = 0; virtual DisplayError SetMixerAttributes(const HWMixerAttributes &mixer_attributes) = 0; virtual DisplayError GetMixerAttributes(HWMixerAttributes *mixer_attributes) = 0; virtual DisplayError DumpDebugData() = 0; virtual DisplayError SetDppsFeature(void *payload, size_t size) = 0; virtual DisplayError GetDppsFeatureInfo(void *payload, size_t size) = 0; virtual DisplayError HandleSecureEvent(SecureEvent secure_event, HWLayers *hw_layers) = 0; virtual DisplayError ControlIdlePowerCollapse(bool enable, bool synchronous) = 0; virtual DisplayError SetDisplayDppsAdROI(void *payload) = 0; virtual DisplayError SetDynamicDSIClock(uint64_t bit_clk_rate) = 0; virtual DisplayError GetDynamicDSIClock(uint64_t *bit_clk_rate) = 0; virtual DisplayError TeardownConcurrentWriteback(void) = 0; virtual DisplayError GetDisplayIdentificationData(uint8_t *out_port, uint32_t *out_data_size, uint8_t *out_data) = 0; virtual DisplayError SetFrameTrigger(FrameTriggerMode mode) = 0; virtual DisplayError SetBLScale(uint32_t level) = 0; virtual DisplayError GetPanelBrightnessBasePath(std::string *base_path) = 0; virtual DisplayError SetBlendSpace(const PrimariesTransfer &blend_space) = 0; virtual PanelFeaturePropertyIntf *GetPanelFeaturePropertyIntf() = 0; virtual DisplayError DelayFirstCommit() = 0; protected: virtual ~HWInterface() { } }; } // namespace sdm #endif // __HW_INTERFACE_H__