1 /* 2 * Copyright (c) 2015, The Linux Foundation. All rights reserved. 3 * 4 * Redistribution and use in source and binary forms, with or without 5 * modification, are permitted provided that the following conditions are 6 * met: 7 * * Redistributions of source code must retain the above copyright 8 * notice, this list of conditions and the following disclaimer. 9 * * Redistributions in binary form must reproduce the above 10 * copyright notice, this list of conditions and the following 11 * disclaimer in the documentation and/or other materials provided 12 * with the distribution. 13 * * Neither the name of The Linux Foundation nor the names of its 14 * contributors may be used to endorse or promote products derived 15 * from this software without specific prior written permission. 16 * 17 * THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESS OR IMPLIED 18 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF 19 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT 20 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS 21 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 22 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 23 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR 24 * BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, 25 * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE 26 * OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN 27 * IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 28 */ 29 30 /*! @file debug_interface.h 31 @brief This file provides the debug interface for display manager. 32 */ 33 #ifndef __DEBUG_INTERFACE_H__ 34 #define __DEBUG_INTERFACE_H__ 35 36 namespace sdm { 37 38 /*! @brief This enum represents different modules/logical unit tags that a log message may 39 be associated with. Client may use this to filter messages for dynamic logging. 40 41 @sa DebugHandler 42 */ 43 enum DebugTag { 44 kTagNone, //!< Debug log is not tagged. This type of logs should always be printed. 45 kTagResources, //!< Debug log is tagged for resource management. 46 kTagStrategy, //!< Debug log is tagged for strategy decisions. 47 kTagCompManager, //!< Debug log is tagged for composition manager. 48 kTagDriverConfig, //!< Debug log is tagged for driver config. 49 kTagRotator, //!< Debug log is tagged for rotator. 50 kTagScalar, //!< Debug log is tagged for Scalar Helper. 51 kTagQDCM, //!< Debug log is tagged for display QDCM color managing. 52 }; 53 54 /*! @brief Display debug handler class. 55 56 @details This class defines display debug handler. The handle contains methods which client 57 should implement to get different levels of logging/tracing from display manager. Display manager 58 will call into these methods at appropriate times to send logging/tracing information. 59 60 @sa CoreInterface::CreateCore 61 */ 62 class DebugHandler { 63 public: 64 /*! @brief Method to handle error messages. 65 66 @param[in] tag \link DebugTag \endlink 67 @param[in] format \link message format with variable argument list \endlink 68 */ 69 virtual void Error(DebugTag tag, const char *format, ...) = 0; 70 71 /*! @brief Method to handle warning messages. 72 73 @param[in] tag \link DebugTag \endlink 74 @param[in] format \link message format with variable argument list \endlink 75 */ 76 virtual void Warning(DebugTag tag, const char *format, ...) = 0; 77 78 /*! @brief Method to handle informative messages. 79 80 @param[in] tag \link DebugTag \endlink 81 @param[in] format \link message format with variable argument list \endlink 82 */ 83 virtual void Info(DebugTag tag, const char *format, ...) = 0; 84 85 /*! @brief Method to handle debug messages. 86 87 @param[in] tag \link DebugTag \endlink 88 @param[in] format \link message format with variable argument list \endlink 89 */ 90 virtual void Debug(DebugTag tag, const char *format, ...) = 0; 91 92 /*! @brief Method to handle verbose messages. 93 94 @param[in] tag \link DebugTag \endlink 95 @param[in] format \link message format with variable argument list \endlink 96 */ 97 virtual void Verbose(DebugTag tag, const char *format, ...) = 0; 98 99 /*! @brief Method to begin trace for a module/logical unit. 100 101 @param[in] class_name \link name of the class that the function belongs to \endlink 102 @param[in] function_name \link name of the function to be traced \endlink 103 @param[in] custom_string \link custom string for multiple traces within a function \endlink 104 */ 105 virtual void BeginTrace(const char *class_name, const char *function_name, 106 const char *custom_string) = 0; 107 108 /*! @brief Method to end trace for a module/logical unit. 109 */ 110 virtual void EndTrace() = 0; 111 112 /*! @brief Method to get property value corresponding to give string. 113 114 @param[in] property_name name of the property 115 @param[out] integer converted value corresponding to the property name 116 117 @return \link DisplayError \endlink 118 */ 119 virtual DisplayError GetProperty(const char *property_name, int *value) = 0; 120 121 /*! @brief Method to get property value corresponding to give string. 122 123 @param[in] property_name name of the property 124 @param[out] string value corresponding to the property name 125 126 @return \link DisplayError \endlink 127 */ 128 virtual DisplayError GetProperty(const char *property_name, char *value) = 0; 129 130 protected: ~DebugHandler()131 virtual ~DebugHandler() { } 132 }; 133 134 /*! @brief Scope tracer template class. 135 136 @details This class template implements the funtionality to capture the trace for function/ 137 module. It starts the trace upon object creation and ends the trace upon object destruction. 138 */ 139 template <class T> 140 class ScopeTracer { 141 public: ScopeTracer(const char * class_name,const char * function_name)142 ScopeTracer(const char *class_name, const char *function_name) { 143 T::Get()->BeginTrace(class_name, function_name, ""); 144 } 145 ~ScopeTracer()146 ~ScopeTracer() { T::Get()->EndTrace(); } 147 }; 148 149 } // namespace sdm 150 151 #endif // __DEBUG_INTERFACE_H__ 152 153 154 155