| /* |
| * Copyright (c) 2010, Texas Instruments Incorporated |
| * 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 Texas Instruments Incorporated 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 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 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. |
| */ |
| |
| #ifndef OMX_DEBUG_H |
| #define OMX_DEBUG_H |
| |
| #include "OMX_DebugMem.h" |
| |
| #define OMX_NO_MESSAGES 0x00000000 |
| #define OMX_ALL_MESSAGES 0xffff0000 |
| |
| #define OMX_MASK_FATAL 0x80000000 |
| #define OMX_MASK_ERROR 0x40000000 |
| #define OMX_MASK_WARN 0x20000000 |
| #define OMX_MASK_INFO 0x10000000 |
| #define OMX_MASK_DEBUG 0x08000000 |
| #define OMX_MASK_TRACE 0x04000000 |
| #define OMX_MASK_RESERVE1 0x02000000 |
| #define OMX_MASK_RESERVE2 0x01000000 |
| |
| #define OMX_MASK_USERMASK 0x00FF0000 |
| |
| #define OMX_OPTION_FILE 0x00000001 |
| #define OMX_OPTION_FUNC 0x00000002 |
| #define OMX_OPTION_LINE 0x00000004 |
| |
| #define OMX_MASK_HANDLES 0x0000FFFF |
| |
| |
| |
| /* |
| * ANSI escape sequences for outputing text in various colors |
| */ |
| #define DBG_TEXT_WHITE "\x1b[1;37;40m" |
| #define DBG_TEXT_YELLOW "\x1b[1;33;40m" |
| #define DBG_TEXT_MAGENTA "\x1b[1;35;40m" |
| #define DBG_TEXT_GREEN "\x1b[1;32;40m" |
| #define DBG_TEXT_CYAN "\x1b[1;36;40m" |
| #define DBG_TEXT_RED "\x1b[1;31;40m" |
| |
| |
| /* Setup log format (adds newline if no newline provided) */ |
| // do not use this one directly.... |
| #define OMX_LOG_PRINT(HANDLE, STR, ARG...) \ |
| (OMX_Log(HANDLE, __FILE__, __LINE__, __FUNCTION__, STR, ##ARG)) |
| |
| #ifdef OMX_DEBUG |
| #define OMX_DPRINT(HANDLE, STR, ARG...) OMX_LOG_PRINT(OMX_MASK_DEBUG | HANDLE, STR, ##ARG) |
| #define OMX_TPRINT(HANDLE, STR, ARG...) OMX_LOG_PRINT(OMX_MASK_TRACE | HANDLE, STR, ##ARG) |
| #else |
| #define OMX_DPRINT(HANDLE, STR, ARG...) |
| #define OMX_TPRINT(HANDLE, STR, ARG...) |
| #endif |
| |
| /* Later this will be able to be turned on/off separately as a trace */ |
| #define OMX_DENTER(handle) OMX_TPRINT((handle), "+++ENTERING") |
| #define OMX_DEXIT(handle,retVal) OMX_TPRINT((handle), "---EXITING(0x%x)", (retVal)) |
| |
| #define OMX_DBG_INT(handle, intVar) OMX_DPRINT(OMX_MASK_DEBUG | (handle), #intVar ": %d", (intVar)) |
| #define OMX_DBG_PTR(handle, ptrVar) OMX_DPRINT(OMX_MASK_DEBUG | (handle), #ptrVar ": 0x%08x", (ptrVar)) |
| #define OMX_DBG_STR(handle, strVar) OMX_DPRINT(OMX_MASK_DEBUG | (handle), #strVar ": %s", (strVar)) |
| |
| |
| /* Error/warning printing defines to be used by all sub-components */ |
| #define OMX_INFOPRINT(handle, str,arg...) (OMX_LOG_PRINT(OMX_MASK_INFO | (handle), "(INFO) "str, ##arg)) |
| #define OMX_WARNPRINT(handle, str,arg...) (OMX_LOG_PRINT(OMX_MASK_WARN | (handle), "(WARN) "str, ##arg)) |
| #define OMX_ERRPRINT(handle, str,arg...) (OMX_LOG_PRINT(OMX_MASK_ERROR | (handle), "(ERROR) "str, ##arg)) |
| #define OMX_FATALPRINT(handle, str,arg...) (OMX_LOG_PRINT(OMX_MASK_FATAL | (handle), "(FATAL) "str, ##arg)) |
| |
| /* assert macros */ |
| #ifdef OMX_DEBUG |
| #define OMX_ASSERT(COND) ((!(COND))?OMX_FATALPRINT(0,"OMX_ASSERT("#COND")"),abort():0) |
| #else |
| #define OMX_ASSERT(COND) |
| #endif |
| |
| #define OMX_LOG_ADD_MASK(HANDLE,NEW_BITS) (OMX_Log_SetMask((HANDLE), OMX_Log_GetMask(HANDLE) | (NEW_BITS))) |
| #define OMX_LOG_CLEAR_MASK(HANDLE,NEW_BITS) (OMX_Log_SetMask((HANDLE), OMX_Log_GetMask(HANDLE) & ~(NEW_BITS))) |
| |
| #define OMX_LOG_ADD_OPTIONS(HANDLE,NEW_BITS) (OMX_Log_SetOptions((HANDLE), OMX_Log_GetOptions(HANDLE) | (NEW_BITS))) |
| #define OMX_LOG_CLEAR_OPTIONS(HANDLE,NEW_BITS) (OMX_Log_SetOptions((HANDLE), OMX_Log_GetOptions(HANDLE) & ~(NEW_BITS))) |
| |
| typedef unsigned int OMX_DBG_HANDLE; |
| |
| OMX_DBG_HANDLE OMX_Log_GetDebugHandle(const char *description); |
| void OMX_Log_ReleaseDebugHandle(OMX_DBG_HANDLE hDebug); |
| unsigned int OMX_Log_GetMask(OMX_DBG_HANDLE hDebug); |
| unsigned int OMX_Log_SetMask(OMX_DBG_HANDLE hDebug, unsigned int uiNewMask); |
| |
| unsigned int OMX_Log_GetOptions(OMX_DBG_HANDLE hDebug); |
| unsigned int OMX_Log_SetOptions(OMX_DBG_HANDLE hDebug, unsigned int uiNewOptions); |
| |
| void OMX_Log(unsigned int mask, const char *szFileName, int iLineNum, |
| const char *szFunctionName, const char *strFormat, ...); |
| |
| const char *OMX_GetErrorString(OMX_ERRORTYPE error); |
| |
| OMX_ERRORTYPE OMX_Log_LoadConfigFile(char* szConfigFile); |
| |
| |
| /* |
| * The following macros are intended to make accessing a debug handle easier. |
| * |
| * For example, for the Util library, you would create a header file called |
| * OMX_Util_Private.h. This file will be included in all source files |
| * compiled into the Util library. The header file uses the 'define' macro |
| * to generate a prototype for the getDebugHandle() function: |
| * |
| * DEFINE_DEBUG_HANDLE_FN(UTIL); |
| * |
| * Now, in your private header file, define easier macros for printing: |
| * |
| * #define UTIL_DPRINT(str,args...) OMX_DPRINT(ACCESS_DEBUG_HANDLE(UTIL),str,##args) |
| * #define UTIL_WARNPRINT(str,args...) OMX_WARNPRINT(ACCESS_DEBUG_HANDLE(UTIL),str,##args) |
| * #define UTIL_ERRPRINT(str,args...) OMX_ERRPRINT(ACCESS_DEBUG_HANDLE(UTIL),str,##args) |
| * |
| * Finally, in a source file which will be compiled into the lib, for example |
| * OMX_Util_Private.c, you implement the function with the 'implement' macro: |
| * |
| * IMPLEMENT_DEBUG_HANDLE_FN(UTIL) |
| * |
| */ |
| #define DEFINE_DEBUG_HANDLE_FN(MOD) OMX_DBG_HANDLE getDebugHandle_##MOD(void); |
| |
| #define ACCESS_DEBUG_HANDLE(MOD) getDebugHandle_##MOD() |
| |
| #define IMPLMENT_DEBUG_HANDLE_FN(MOD) \ |
| OMX_DBG_HANDLE getDebugHandle_##MOD(void) \ |
| { \ |
| static OMX_DBG_HANDLE hDebug = 0; \ |
| if(!hDebug) { \ |
| hDebug = OMX_Log_GetDebugHandle(#MOD); \ |
| OMX_DPRINT(0,"Component "#MOD": hDebug %d",hDebug); \ |
| } \ |
| return hDebug; \ |
| } |
| |
| |
| |
| #endif |
| |