domx/omx_core/inc/OMX_Debug.h

/*
 * 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